AddInkAnnotation

Σχολιάσεις και σύνδεσμοι hotspot

Περιγραφή

Προσθέτει σχολιασμό μελανιού (PDF /Subtype /Ink) που αναπαριστά μία ή περισσότερες χειρόγραφες πινελιές, ελεύθερα σημάδια ή σκίτσα στη σελίδα. Η εγγραφή /InkList του λεξικού περιέχει πίνακα πινελιών· κάθε πινελιά είναι πίνακας εναλλασσόμενων συντεταγμένων x/y με τη διαδρομή που χάραξε η συσκευή δείκτης μεταξύ pen-down και pen-up. Οι συνιστώσες χρώματος και η αδιαφάνεια εκφράζονται σε κλίμακα 0–1· η Transparency σε κλίμακα 0–100 (0 = πλήρως αδιαφανές, 100 = πλήρως διαφανές). Επειδή το σημείο εισόδου γράφει το κλειδί αδιαφάνειας /CA του PDF 1.4, η βιβλιοθήκη ανεβάζει τα ξεκλείδωτα χαμηλότερα έγγραφα σε PDF 1.4 πριν την αποθήκευση· κλειδωμένοι χαμηλότεροι στόχοι απορρίπτονται από την πύλη συμβατότητας. Ορίζεται στο ISO 32000-1 §12.5.6.13.

Σύνταξη

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Παράμετροι

InkPaths — Ένα ή περισσότερα strokes κωδικοποιημένα ως μία συμβολοσειρά. Τα strokes διαχωρίζονται με '|' ή με newline (CR / LF / CRLF). Μέσα σε κάθε stroke, τα ζεύγη συντεταγμένων χρησιμοποιούν την ίδια σύμβαση οριοθέτησης με το AddPolygonAnnotation: εναλλασσόμενες τιμές x/y που διαχωρίζονται με κενά, κόμματα, semicolons ή tab. Παράδειγμα: το "100 100 110 105 120 110 | 200 200 210 205" περιγράφει δύο ξεχωριστά strokes. Κάθε stroke πρέπει να περιέχει τουλάχιστον δύο ζεύγη συντεταγμένων (τέσσερις αριθμούς) και συνολικά άρτιο αριθμό τιμών, διαφορετικά η κλήση επιστρέφει 0

BorderWidth — Πλάτος πένας του ink, στις τρέχουσες μονάδες

InkRed, InkGreen, InkBlue — RGB συνιστώσες (0–1) του χρώματος μελανιού, που γράφονται στο /C

Title — Όνομα συγγραφέα που γράφεται στην εγγραφή /T του σχολίου. Δώστε κενή συμβολοσειρά για παράλειψη

Contents — Το σώμα του popup που συνδέεται με το σχόλιο. Δώστε κενή συμβολοσειρά για παράλειψη

Transparency — Η αδιαφάνεια εκφρασμένη ως ποσοστό διαφάνειας (0–100). Η βιβλιοθήκη το μετατρέπει σε PDF /CA = 1 - Transparency/100 και το περιορίζει στο εύρος

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

1 σε επιτυχία, 0 αν δεν έχει επιλεγεί έγγραφο, αν η συμβολοσειρά ink δεν αναλύεται σε έγκυρη λίστα stroke ή αν δεν μπόρεσε να δημιουργηθεί το σχόλιο

Παρατηρήσεις

Το /Rect του σχολίου υπολογίζεται αυτόματα από το συνδυασμένο εύρος όλων των strokes συν μικρό padding ανάλογο του πλάτους περιγράμματος ώστε τα αποδιδόμενα strokes να μένουν μέσα στο bounding box του σχολίου

Το σημείο εισόδου ταιριάζει τόσο για ψηφιοποιημένη χειρογραφία από συσκευή touch/pen όσο και για προγραμματιστικά ελεύθερα σχήματα, όπως σκίτσα υπογραφών ή σχολιασμούς από άλλα εργαλεία. Για αλλαγή χρώματος μελανιού, περιγράμματος, περιεχομένου ή ορθογωνίου μετά τη δημιουργία, χρησιμοποιήστε SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents και SetAnnotRect.