AddImageFromFileOffset

Image handling

Описание

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

Например, если несколько изображений склеены в один файл, эта функция позволит извлечь отдельные изображения и добавить их в документ

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

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

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

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

Синтаксис

Delphi

Function TPDFlib.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Параметры

FileNameИмя файла с изображениями
OffsetСмещение в файле, где начинается нужное изображение; первый байт файла имеет смещение 0
DataLengthДлина данных изображения в байтах
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Изображение прочитано из файла и успешно добавлено в документ; возвращённый ID передаётся функциям рисования изображений вроде DrawImage