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