AddImageFromFileA

Image handling

Описание

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddImageFromFile and string arguments are interpreted using the current SetAnsiMode code page

Добавляет изображение из файла в выбранный документ

После добавления изображения в документ его можно рисовать на любой странице сколько угодно раз без дальнейшего роста размера PDF-файла

Supported image file types are: BMP, TIFF, JPEG, PNG, GIF, WMF and EMF.

Поведение версии PDF: импорт 16-битных на компонент данных изображения требует PDF 1.5. Если документ настроен на PDF 1.4 или ниже, а версия сохранения не заблокирована, AddImageFromFile автоматически повышает версию документа до PDF 1.5 и записывает 16-bit image samples в AutoBumpedFeatures. Если вызывающий код блокирует более низкую версию сохранения, шлюз совместимости отклоняет сохранение с LastErrorCode 602.

Для изображений BMP и TIFF перед этим вызовом можно сжать данные функцией CompressImages. Остальные типы изображений сжимаются автоматически

Синтаксис

Delphi

Function DLAddImageFromFileA(InstanceID: Integer; FileName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddImageFromFileA(int InstanceID, const char * FileName, int Options);

Параметры

FileName	Имя добавляемого файла изображения
Options	Для многостраничных TIFF указывает номер загружаемой страницы. Для PNG: 0 = загрузить изображение как обычно 1 = загрузить альфа-канал как полутоновое изображение 2 = загрузить изображение и альфа-канал (альфа ограничена 8 битами) 3 = загрузить изображение (8 бит на канал) 4 = загрузить альфа-канал (8 бит на канал) 5 = загрузить изображение с альфа-каналом (оба ограничены 8 битами на канал) 6 = загрузить изображение и альфа-канал 7 = загрузить изображение и ICC-профиль Для остальных типов изображений параметр должен быть 0. Значение Options = -1 заставляет загружать TIFF, EMF и WMF через графическую библиотеку GDI+. Многостраничные TIFF также можно загружать через GDI+, задав Options = -PageNumber (например, -3 для страницы 3)

FileName

Имя добавляемого файла изображения

Options

Для многостраничных TIFF указывает номер загружаемой страницы. Для PNG: 0 = загрузить изображение как обычно 1 = загрузить альфа-канал как полутоновое изображение 2 = загрузить изображение и альфа-канал (альфа ограничена 8 битами) 3 = загрузить изображение (8 бит на канал) 4 = загрузить альфа-канал (8 бит на канал) 5 = загрузить изображение с альфа-каналом (оба ограничены 8 битами на канал) 6 = загрузить изображение и альфа-канал 7 = загрузить изображение и ICC-профиль Для остальных типов изображений параметр должен быть 0. Значение Options = -1 заставляет загружать TIFF, EMF и WMF через графическую библиотеку GDI+. Многостраничные TIFF также можно загружать через GDI+, задав Options = -PageNumber (например, -3 для страницы 3)

Return values

0	Изображение добавить не удалось: либо оно не найдено, либо формат не поддерживается
Non-zero	Изображение добавлено успешно; возвращённый ImageID можно передавать функциям вроде SelectImage и DrawImage