AddImageFromString

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

Описание

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

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

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

Поведение според версията на 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-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)

Source

Низ, съдържащ данните за изображението Във версията ActiveX на библиотеката този низ трябва да съдържа 16-битови знаци, като ще се използват само долните 8 бита на всеки знак

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	Данните за изображението са невалидни или изображението е в неподдържан формат Изображението е добавено успешно Върнатата стойност е ImageID, който може да се използва с функции като SelectImage и DrawImage
1