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 |