AddImageFromFile

Image handling

Περιγραφή

Προσθέτει εικόνα από αρχείο στο επιλεγμένο έγγραφο

Μόλις προστεθεί μια εικόνα στο έγγραφο, μπορεί να σχεδιαστεί σε οποιαδήποτε σελίδα όσες φορές θέλετε χωρίς περαιτέρω αύξηση του μεγέθους του αρχείου PDF

Οι υποστηριζόμενοι τύποι αρχείων εικόνας είναι BMP, TIFF, JPEG, PNG, GIF, WMF, EMF και WebP, συν AVIF, HEIF, HEIC και JPEG XL όταν είναι διαθέσιμος ένας σύγχρονος image decoder

Συμπεριφορά έκδοσης PDF: η εισαγωγή δεδομένων εικόνας 16-bit-per-component απαιτεί PDF 1.5. Όταν ένα έγγραφο έχει οριστεί σε PDF 1.4 ή παλαιότερη έκδοση και η έκδοση αποθήκευσης δεν είναι κλειδωμένη, το AddImageFromFile αναβαθμίζει αυτόματα το έγγραφο σε PDF 1.5 και καταγράφει το 16-bit image samples στο AutoBumpedFeatures. Αν ο caller κλειδώσει χαμηλότερη έκδοση αποθήκευσης, ο μηχανισμός συμβατότητας απορρίπτει την αποθήκευση με LastErrorCode 602

Για εικόνες BMP και TIFF, η συνάρτηση CompressImages μπορεί να κληθεί πριν από αυτή τη συνάρτηση για συμπίεση των δεδομένων εικόνας. Οι άλλοι τύποι εικόνων συμπιέζονται αυτόματα

Syntax

Delphi

Function TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parameters

FileNameΤο όνομα αρχείου της εικόνας προς προσθήκη
OptionsΓια εικόνες TIFF πολλαπλών σελίδων αυτή η παράμετρος καθορίζει τον αριθμό σελίδας προς φόρτωση. Για εικόνες PNG: 0 = Φόρτωση της εικόνας όπως συνήθως 1 = Φόρτωση του alpha channel ως εικόνα γκρι κλίμακας 2 = Φόρτωση εικόνας και alpha channel (περιορισμός alpha σε 8-bit) 3 = Φόρτωση εικόνας (περιορισμός εικόνας σε 8-bit/channel) 4 = Φόρτωση alpha channel (περιορισμός σε 8-bit/channel) 5 = Φόρτωση εικόνας με alpha channel (περιορισμός και των δύο σε 8-bit/channel) 6 = Φόρτωση εικόνας και alpha channel 7 = Φόρτωση εικόνας και ICC color profile 8 = Φόρτωση εικόνας, alpha channel και ICC color profile με διατήρηση μεγάλου βάθους bit Για άλλους τύπους εικόνων αυτή η παράμετρος πρέπει να οριστεί στο 0. Ορισμός Options σε -1 εξαναγκάζει εικόνες TIFF, EMF και WMF να φορτώνονται με τη βιβλιοθήκη γραφικών GDI+. Εικόνες TIFF πολλαπλών σελίδων μπορούν επίσης να φορτωθούν με GDI+ ορίζοντας την παράμετρο Options σε -PageNumber (για παράδειγμα -3 για σελίδα 3)

Τιμές επιστροφής

0Η εικόνα δεν μπόρεσε να προστεθεί. Είτε δεν μπόρεσε να βρεθεί είτε είναι σε μη υποστηριζόμενη μορφή
Non-zeroΗ εικόνα προστέθηκε επιτυχώς. Επιστρέφεται το ImageID που μπορεί να περαστεί σε συναρτήσεις όπως SelectImage και DrawImage