AddImageFromFileOffset

Afbeeldingsverwerking

Beschrijving

Voegt een afbeelding uit een deel van een bestand toe aan het geselecteerde document

Als bijvoorbeeld veel afbeeldingen in één bestand zijn samengevoegd, maakt deze functie het mogelijk de afzonderlijke afbeeldingen te extraheren en aan het document toe te voegen

Zodra een afbeelding aan het document is toegevoegd, kan deze op elke pagina meerdere keren worden getekend zonder dat het PDF-bestand verder groeit

Ondersteunde afbeeldingstypen zijn: BMP, TIFF, JPEG, PNG, GIF, WMF en EMF

PDF-versiegedrag: het importeren van afbeeldingsgegevens met 16 bits per component vereist PDF 1.5. Wanneer een document is ingesteld op PDF 1.4 of lager en de opslagversie niet is vergrendeld, verhoogt AddImageFromFileOffset het document automatisch naar PDF 1.5 en registreert het 16-bit image samples in AutoBumpedFeatures. Als de caller een lagere opslagversie vergrendelt, weigert de compatibiliteitscontrole het opslaan met LastErrorCode 602

Voor BMP- en TIFF-afbeeldingen kan de functie CompressImages vóór deze functie worden aangeroepen om de afbeeldingsdata te comprimeren. Andere afbeeldingstypen worden automatisch gecomprimeerd

Syntaxis

Delphi

Function TPDFlib.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Parameters

FileName	De naam van het bestand met de afbeeldingen
Offset	De offset in het bestand waar de gevraagde afbeelding begint. De eerste byte in het bestand heeft offset 0
DataLength	De lengte van de afbeeldingsdata in bytes
Options	Voor multipage-TIFF-afbeeldingen geeft deze parameter het te laden paginanummer op. Voor PNG-afbeeldingen: 0 = De afbeelding normaal laden 1 = Het alphakanaal als grijswaardenafbeelding laden 2 = De afbeelding en het alphakanaal laden (alfa beperkt tot 8-bit) 3 = De afbeelding laden (afbeelding beperkt tot 8-bit/kanaal) 4 = Het alphakanaal laden (beperkt tot 8-bit/kanaal) 5 = De afbeelding met alphakanaal laden (beide beperkt tot 8-bit/kanaal) 6 = De afbeelding en het alphakanaal laden 7 = De afbeelding en het ICC-kleurprofiel laden Voor andere afbeeldingstypen moet deze parameter op 0 worden gezet. Als Options op -1 wordt gezet, worden TIFF-, EMF- en WMF-afbeeldingen met de GDI+ graphics library geladen. Multipage-TIFF-afbeeldingen kunnen ook met GDI+ worden geladen door de parameter Options op -PageNumber te zetten (bijvoorbeeld -3 voor pagina 3)

Retourwaarden

0	De afbeelding kon niet uit het bestand worden gelezen. Dat kan duiden op ongeldige afbeeldingsdata of een bestand dat niet is gevonden
Non-zero	De afbeelding is uit het bestand gelezen en met succes aan het document toegevoegd. De geretourneerde waarde is de ID van de afbeelding en kan worden gebruikt met de afbeeldingstekenfuncties zoals DrawImage