AddImageFromString

Обробка зображень

Опис

Додає зображення з пам'яті до вибраного документа

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

Підтримувані типи файлів зображень: BMP, TIFF, JPEG, PNG, GIF, WMF, EMF і WebP, а також AVIF, HEIF, HEIC і JPEG XL, коли доступний сучасний декодер зображень

Поведінка версії PDF: імпорт даних зображення з 16 бітами на компонент вимагає PDF 1.5. Коли документ встановлено в PDF 1.4 чи нижче, а версія збереження не замкнена, AddImageFromString автоматично піднімає документ до PDF 1.5 і записує 16-bit image samples у AutoBumpedFeatures. Якщо викликач замкне нижчу версію збереження, ворота сумісності відхиляють збереження з LastErrorCode 602

Для зображень BMP і TIFF перед викликом цієї функції можна стиснути дані зображення функцією CompressImages. Інші типи зображень стискаються автоматично

Синтаксис

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

Параметри

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

Source

Рядок із даними зображення. В ActiveX-версії бібліотеки цей рядок має містити 16-бітові символи, з яких використовуються лише молодші 8 біт кожного

Options

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

Повернуті значення

0	Дані зображення були недійсними або зображення було у непідтримуваному форматі Зображення успішно додано. Повертається ImageID, з яким працюють функції на кшталт SelectImage і DrawImage
1