AddImageDirectFromString
Billedhåndtering
Beskrivelse
Opretter et image XObject direkte fra allerede kodede billedsamplebyte i stedet for at registrere et beholderformat såsom PNG, TIFF eller JPEG.
PDF-versionsadfærd: Billedfilteret JBIG2Decode kræver PDF 1.4, mens JPXDecode, Crypt og billedprøver med BitsPerComponent = 16 kræver PDF 1.5. Når et dokument er indstillet til en lavere version end påkrævet, og lagringsversionen ikke er låst, hæver AddImageDirectFromString automatisk dokumentversionen og registrerer JBIG2Decode filter, JPXDecode filter, Crypt filter eller 16-bit image samples i AutoBumpedFeatures. Hvis kalderen låser en lavere lagringsversion, afviser kompatibilitetskontrollen lagringen med LastErrorCode 602
Syntaks
Delphi
Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;Parametre
| Source | Rå eller kodede billeddata, der skal gemmes i billedstreamen |
|---|---|
| Width | Billedbredde i pixel. |
| Height | Billedhøjde i pixels |
| BitsPerComponent | Antal bit pr. prøvekomponent. PDF-billedordbøger tillader 1, 2, 4 og 8 i tidligere versioner; 16-bit-prøver er PDF 1.5. |
| ColorSpace | Navn på PDF-farverum eller arraytekst til billedordbogen, f.eks. /DeviceGray, /DeviceRGB eller et array for et indekseret farverum |
| Filter | PDF-streamfilternavn, f.eks. FlateDecode, DCTDecode eller JPXDecode. Brug en tom streng til ufiltrerede data. |
| Decode | Valgfri tekst til PDF Decode-arrayet. Angiv en tom streng, når en Decode-post ikke er nødvendig. |
| Interpolate | En værdi forskellig fra nul skriver flaget /Interpolate true. |
Returværdier
| 0 | Billedet kunne ikke oprettes, eller den aktuelle PDF/A-tilstand forbyder det anmodede filter |
|---|---|
| Non-zero | Det nye ImageID. Det oprettede billede vælges til efterfølgende billedhandlinger. |
Bemærkninger
PDF/A-tilstand afviser LZWDecode i alle dele og afviser JBIG2Decode / JPXDecode i PDF/A-1. Kalderen er ansvarlig for at få Source-bytes til at svare til de erklærede ColorSpace, Filter, Decode, dimensioner og sampledybde.
Se også
AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage