AddImageFromString

Χειρισμός εικόνων

Περιγραφή

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

Μόλις προστεθεί μια εικόνα στο έγγραφο, μπορεί να σχεδιαστεί σε οποιαδήποτε σελίδα όσες φορές θέλετε χωρίς περαιτέρω αύξηση του μεγέθους του αρχείου 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 ή παλαιότερη έκδοση και η έκδοση αποθήκευσης δεν είναι κλειδωμένη, το AddImageFromString αναβαθμίζει αυτόματα το έγγραφο σε PDF 1.5 και καταγράφει το 16-bit image samples στο AutoBumpedFeatures. Αν ο caller κλειδώσει χαμηλότερη έκδοση αποθήκευσης, ο μηχανισμός συμβατότητας απορρίπτει την αποθήκευση με LastErrorCode 602

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

Σύνταξη

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

Παράμετροι

Source	Συμβολοσειρά με τα δεδομένα εικόνας. Στην ActiveX έκδοση της βιβλιοθήκης αυτή η συμβολοσειρά πρέπει να περιέχει 16-bit χαρακτήρες· μόνο τα χαμηλότερα 8 bits κάθε χαρακτήρα θα χρησιμοποιηθούν
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)

Source

Συμβολοσειρά με τα δεδομένα εικόνας. Στην ActiveX έκδοση της βιβλιοθήκης αυτή η συμβολοσειρά πρέπει να περιέχει 16-bit χαρακτήρες· μόνο τα χαμηλότερα 8 bits κάθε χαρακτήρα θα χρησιμοποιηθούν

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	Τα δεδομένα εικόνας ήταν άκυρα ή η εικόνα ήταν σε μη υποστηριζόμενη μορφή Η εικόνα προστέθηκε επιτυχώς. Η επιστρεφόμενη τιμή είναι το ImageID που μπορεί να χρησιμοποιηθεί με συναρτήσεις όπως SelectImage και DrawImage
1