AddImageDirectFromString

Bildverarbeitung

Beschreibung

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

Verhalten der PDF-Version: Für den Bildfilter JBIG2Decode ist PDF 1.4 erforderlich, während JPXDecode, Crypt und Bildabtastwerte mit BitsPerComponent = 16 PDF 1.5 erfordern. Ist für ein Dokument eine niedrigere Version festgelegt und die Speicherversion nicht gesperrt, hebt AddImageDirectFromString die Dokumentversion automatisch an und trägt JBIG2Decode filter, JPXDecode filter, Crypt filter oder 16-bit image samples in AutoBumpedFeatures ein. Sperrt der Aufrufer eine niedrigere Speicherversion, lehnt die Kompatibilitätsprüfung das Speichern mit LastErrorCode 602 ab.

Syntax

Delphi

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

Parameter

SourceUnverarbeitete oder codierte Bilddaten, die im Bildstream gespeichert werden sollen.
WidthBildbreite in Pixeln.
HeightBildhöhe in Pixeln.
BitsPerComponentAnzahl der Bits pro Abtastkomponente. PDF-Bildwörterbücher erlauben in früheren Versionen 1, 2, 4 und 8; 16-Bit-Abtastwerte gehören zu PDF 1.5.
ColorSpacePDF-Farbraumname oder Arraytext für das Bildwörterbuch, beispielsweise /DeviceGray, /DeviceRGB oder ein indiziertes Farbraum-Array.
FilterName des PDF-Streamfilters, beispielsweise FlateDecode, DCTDecode oder JPXDecode. Für ungefilterte Daten ist eine leere Zeichenfolge zu verwenden.
DecodeOptionaler Text des PDF-Decode-Arrays. Übergeben Sie eine leere Zeichenfolge, wenn kein Decode-Eintrag benötigt wird.
InterpolateEin Wert ungleich null schreibt das Flag /Interpolate true.

Rückgabewerte

0Das Bild konnte nicht erstellt werden oder der aktuelle PDF/A-Modus verbietet den angeforderten Filter.
Non-zeroDie neue ImageID. Das erstellte Bild wird für nachfolgende Bildoperationen ausgewählt.

Hinweise

Der PDF/A-Modus lehnt LZWDecode in allen Teilen und JBIG2Decode / JPXDecode in PDF/A-1 ab. Der Aufrufer ist dafür verantwortlich, dass die Source-Bytes mit den deklarierten Werten für ColorSpace, Filter, Decode, den Abmessungen und der Abtasttiefe übereinstimmen.

Siehe auch

AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage