AddImageDirectFromString

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

Описание

Създава XObject за изображение директно от вече кодирани байтове със семпли на изображението, вместо да открива контейнерен формат като PNG, TIFF или JPEG

Поведение на PDF версията: филтърът за изображения JBIG2Decode изисква PDF 1.4, докато JPXDecode, Crypt и семпли на изображения с BitsPerComponent = 16 изискват PDF 1.5. Когато документът е зададен под изискваната версия и версията за запис не е заключена, AddImageDirectFromString автоматично повишава версията на документа и записва JBIG2Decode filter, JPXDecode filter, Crypt filter или 16-bit image samples в AutoBumpedFeatures. Ако извикващият код заключи по-ниска версия за запис, проверката за съвместимост отхвърля записването с LastErrorCode 602

Синтаксис

Delphi

Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;

Параметри

SourceСурови или кодирани данни на изображението, които да се съхранят в потока на изображението
WidthШирина на изображението в пиксели
HeightВисочина на изображението в пиксели
BitsPerComponentБрой битове за компонент на семпъл. Речниците за изображения в PDF позволяват 1, 2, 4 и 8 в по-ранните версии; 16-битовите семпли са PDF 1.5
ColorSpaceИме на цветово пространство в PDF или текст на масив за речника на изображението, например /DeviceGray, /DeviceRGB или масив за индексирано цветово пространство
FilterИме на филтър за PDF поток, като FlateDecode, DCTDecode или JPXDecode. Използвайте празен низ за нефилтрирани данни
DecodeНезадължителен текст на PDF Decode масив. Подайте празен низ, когато не е необходим Decode запис
InterpolateНенулева стойност записва флага /Interpolate true

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

0Изображението не можа да бъде създадено или текущият PDF/A режим забранява заявения филтър
Ненулева стойностНовият ImageID. Създаденото изображение се избира за последващи операции с изображения

Бележки

Режимът PDF/A отхвърля LZWDecode във всяка част и отхвърля JBIG2Decode / JPXDecode в PDF/A-1. Извикващият код носи отговорност да съгласува байтовете на Source с декларираните ColorSpace, Filter, Decode, размери и дълбочина на семплите

Вижте също

AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage