AddInkAnnotation

הערות וקישורים חמים (hotspot links)

תיאור

מוסיף הערת סימון ink‏ (PDF /Subtype /Ink) המייצגת קו אחד או יותר שצוירו ביד, סימנים חופשיים או שרטוט חופשי על הדף. כניסת המילון /InkList מכילה מערך של קווים; כל קו הוא מערך של קואורדינטות x/y לסירוגין המייצגות את המסלול שסרט מצביע בין אירועי הורדת עט להרמת עט. רכיבי הצבע והאטימות מבוטאים בסקאלה של 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 — משיחה אחת או יותר המקודדות כמחרוזת יחידה. המשיחות מופרדות באמצעות '|' או באמצעות שורה חדשה (CR / LF / CRLF). בתוך כל משיחה, זוגות הקואורדינטות משתמשים באותה מוסכמת מפרידים כמו AddPolygonAnnotation: ערכי x/y לסירוגין, מופרדים ברווחים, בפסיקים, בנקודה-פסיק או בטאבים. דוגמה: "100 100 110 105 120 110 | 200 200 210 205" מתארת שתי משיחות נפרדות. כל משיחה חייבת להכיל לפחות שני זוגות קואורדינטות (ארבעה מספרים) ומספר כולל זוגי של ערכים; אחרת הקריאה מחזירה 0

BorderWidth — רוחב הקו של ה-Ink, ביחידות הנוכחיות

InkRed, InkGreen, InkBlue — רכיבי RGB (0–1) של צבע ה-Ink, נכתבים אל /C

Title — שם המחבר הנכתב אל רשומת ה-/T של ההערה; העבירו מחרוזת ריקה כדי לדלג

Contents — גוף ה-popup המשויך להערה; העבירו מחרוזת ריקה כדי לדלג

Transparency — אטימות מבוטאת באחוזי שקיפות (0–100); הספרייה ממירה זאת אל PDF /CA = 1 - Transparency/100 ומצמצמת לטווח

ערך החזרה

1 בהצלחה, 0 אם לא נבחר מסמך, מחרוזת ה-Ink לא ניתנת לניתוח כרשימת מקורות תקפה, או שלא ניתן היה ליצור את ההערה

הערות

את ה-/Rect של ההערה מחשבים אוטומטית מההיקף המשולב של כל הקווים בתוספת ריפוד קטן יחסי לרוחב הגבול, כך שהקווים המעובדים נשארים בתוך התיבה התוחמת של ההערה

נקודת כניסה זו מתאימה גם לכתב יד שדיגיטל ממכשיר מגע / עט וגם לצורות חופשיות תוכנתיות כמו חתימות משורבבות או הערות שיובאו מכלים אחרים. כדי לדרוס את צבע ה-ink, הגבול, התוכן או המלבן אחרי היצירה, השתמשו ב-SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents, וב-SetAnnotRect.