Картинки: AddPicture и привязка к ячейкам

Сигнатура в современных версиях: f.AddPicture принимает лист, ячейку-якорь, путь к файлу и указатель на GraphicOptions, а возвращает пару (string, error) — идентификатор вставки. Вызов f.AddPicture("Отчёт", "A1", "logo.png", opts) поставит верхний-левый угол картинки в ячейку A1: логотип встанет в угол шапки, а не по центру ячейки. Ошибка вернётся на несуществующем файле — путь проверяется при вставке, поэтому ошибка чтения диска всплывёт именно здесь, а не при SaveAs. Если картинка уже в памяти — файл из сети, из базы, из архива — вместо чтения с диска берут AddPictureFromBytes: он принимает байты и расширение и работает так же, только без промежуточного файла на диске. Список вставленного читается GetPictures: метод вернёт картинки листа с содержимым, что удобно в тестах — проверить, что логотип в файле попал, можно без открытия Excel. Запрос excelize картинка упирается в эту четвёрку: путь, ячейка, опции, идентификатор.

Размер картинки в GraphicOptions задаётся масштабом, а не шириной и высотой: ScaleX и ScaleY — множители исходного размера файла, единица оставляет как есть, ноль целых четыре десятых — сорок процентов. Отдельного поля «вставить шириной три сантиметра» нет, и когда размер в сантиметрах требуется, масштаб считают в Go: исходные пиксели картинки известны, целевые тоже, множитель — деление одного на другое. Полезно знать, что исходный размер — это пиксели файла, а не экранное впечатление: логотип на четыре тысячи пикселей и логотип на четыреста с одним множителем встанут по-разному, поэтому множитель считают от конкретного файла, а не от привычки. LockAspectRatio true связывает обе оси: при изменении одной эксель пропорционально подстроит вторую, и логотип не станет квадратным из прямоугольного. Смещение внутри ячейки задают OffsetX и OffsetY — пригодится, когда картинку нужно сдвинуть на пару пикселей от границ. Полезные флаги: PrintObject решает, попадёт ли картинка на печать — логотипу положено true, водяному знаку данных нет, AltText пишет альтернативный текст для доступности и поиска. Так addpicture excelize описывает картинку одним набором полей, и всё остальное — вычисление множителей и выбор якоря.

Картинка переезжает в файл целиком: xlsx — это zip, и xl/media получит копию вашего PNG. Три вставки одного логотипа — три копии в медиа, и никаких дедупликаций библиотека не делает. Прайс с тридцатью фотографиями по пятьсот килобайт станет тяжелее на пятнадцать мегабайт, а Excel при открытии будет раскладывать все эти медиа — на слабых машинах это заметная задержка. Лечение генераторное: готовьте картинки заранее — ужимайте, режьте миниатюры, держите в отдельной папке версии под xlsx — и вставляйте их, а не оригиналы из фотоаппарата. Тот же подход экономит и трафик: отчёт на пятнадцать мегабайт не каждый почтовый ящик примет, и вложение урежет фильтр сервера раньше, чем его увидит получатель.

Сказанное про медиа верно и в обратную сторону: GetPictures вернёт байты вставленных картинок, и их можно вынуть из файла без Excel, что удобно для миграций и аудита. По чужому файлу видно, какие изображения в нём лежат, сколько они весят и где на листе стоят — картина полезнее, чем визуальный осмотр, потому что якоря и копии видны сразу. Расширения поддерживаются распространённые — PNG, JPEG, GIF и ещё несколько графических форматов, а вот SVG excelize в xlsx не положит: вектор придётся растеризовать заранее, и это ещё один пункт в копилку подготовки медиа до генерации. Запрос excelize картинка на проде чаще всего превращается в вопрос дисциплины: кто готовит медиа, какого веса и в какой папке они хранятся.