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	Имаше грешка при четенето на валидни данни за изображението от потока. Изображението беше успешно добавено към документа. Връщаната стойност е ID-то на изображението, което може да се използва с функциите за рисуване на изображения като DrawImage
Ненулева стойност

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

Ненулева стойност