AddImageFromStream

Обработване на изображения

Описание

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

След като изображение бъде добавено към документа, то може да се рисува на всяка страница многократно без допълнително увеличаване на размера на PDF файла

Поддържаните типове файлове с изображения са: BMP, TIFF, JPEG, PNG, GIF, WMF и EMF

Поведение според версията на 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-bit) 3 = Зареждане на изображението (ограничава изображението до 8-bit/channel) 4 = Зареждане на алфа канала (ограничава до 8-bit/channel) 5 = Зареждане на изображението с алфа канал (ограничава и двете до 8-bit/channel) 6 = Зареждане на изображението и алфа канала 7 = Зареждане на изображението и ICC цветния профил За други типове изображения този параметър трябва да е 0. Задаването на Options на -1 принуждава TIFF, EMF и WMF изображенията да се заредят чрез графичната библиотека GDI+. Многостранични TIFF изображения могат също да бъдат заредени чрез GDI+, като параметърът Options се зададе на -PageNumber (например -3 за страница 3)

InStream

Обектът TStream, съдържащ данните на изображението Текущата позиция в потока ще бъде пренебрегната, а данните на изображението ще бъдат прочетени от позиция 0 в потока

Options

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

Върнати стойности

0	Възникна грешка при четене на валидни данни за изображение от потока; изображението беше добавено успешно към документа Върнатата стойност е идентификаторът на изображението, който може да се използва с функции за изчертаване на изображения като DrawImage
Non-zero

Възникна грешка при четене на валидни данни за изображение от потока; изображението беше добавено успешно към документа Върнатата стойност е идентификаторът на изображението, който може да се използва с функции за изчертаване на изображения като DrawImage

Non-zero