AddImageFromStream

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

Опис

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

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

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

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

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

Синтаксис

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Параметри

InStream	Об'єкт TStream, що містить дані зображення. Поточна позиція в потоці ігнорується — дані зображення читаються з позиції 0 потоку
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)

InStream

Об'єкт TStream, що містить дані зображення. Поточна позиція в потоці ігнорується — дані зображення читаються з позиції 0 потоку

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	Сталася помилка читання чинних даних зображення з потоку Зображення успішно додано до документа. Повертається ID зображення, з яким працюють функції малювання зображень на кшталт DrawImage
Non-zero