AddImageFromStream

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

Περιγραφή

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

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

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

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

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

Σύνταξη

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Παράμετροι

InStream	Το αντικείμενο TStream με τα δεδομένα εικόνας. Η τρέχουσα θέση στο stream θα αγνοηθεί, τα δεδομένα εικόνας θα διαβαστούν από τη θέση 0 στο stream
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)

InStream

Το αντικείμενο TStream με τα δεδομένα εικόνας. Η τρέχουσα θέση στο stream θα αγνοηθεί, τα δεδομένα εικόνας θα διαβαστούν από τη θέση 0 στο stream

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	Παρουσιάστηκε σφάλμα κατά την ανάγνωση έγκυρων δεδομένων εικόνας από τη ροή. Η εικόνα προστέθηκε επιτυχώς στο έγγραφο. Η τιμή που επιστρέφεται είναι το ID της εικόνας, το οποίο μπορεί να χρησιμοποιηθεί με συναρτήσεις σχεδίασης εικόνων όπως η DrawImage.
Non-zero

Παρουσιάστηκε σφάλμα κατά την ανάγνωση έγκυρων δεδομένων εικόνας από τη ροή. Η εικόνα προστέθηκε επιτυχώς στο έγγραφο. Η τιμή που επιστρέφεται είναι το ID της εικόνας, το οποίο μπορεί να χρησιμοποιηθεί με συναρτήσεις σχεδίασης εικόνων όπως η DrawImage.

Non-zero