DrawShapedText

Text

תיאור

דף זה מתעד את DrawShapedText ב-PDFlibPas תחת הנושא "Text". שמות ה-API, הפרמטרים, שמות המחלקות, שמות הקבצים והערכים המילוליים נשמרים בדיוק כפי שהם מופיעים בספריית Delphi ובנקודות הכניסה של ה-DLL

עיינו בתחביר, בפרמטרים ובערכי ההחזרה לפני הקריאה לפונקציה.

תחביר

Delphi

Function TPDFlib.DrawShapedText(XPos, YPos: Double; Const FontName: WideString; Size: Double; Const Text: WideString; Options: Integer): Integer;

פרמטרים

XPos/YPos ממקמים את הטקסט ביחידות הדף. FontName מציין שם גופן מותקן (למשל Arial). Size הוא גודל הטקסט בנקודות. Text הוא המחרוזת לעיצוב וציור. Options סיבית 0 בוחרת כיוון פסקת בסיס מימין לשמאל; הגדירו אותה עבור טקסט בערבית או בעברית.

ערכי החזרה

מחזיר 1 בהצלחה; 0 כאשר מנוע העיצוב אינו זמין, הגופן אינו מותקן או Text ריק

הערות

הטקסט מעוצב באמצעות מנוע העיצוב של המערכת לפני הציור, כך שאותיות בערבית מקבלות את הצורה הנכונה שלהן (תחילית, אמצעית, סופית או מבודדת), ליגטורות חובה כמו לאם-אליף מיושמות, ורצפים מימין לשמאל יוצאים בסדר חזותי נכון. הגליפים המעוצבים נכתבים על ידי אינדקס הגליף באמצעות גופן Type0 (Identity-H) מלווה, המאפשר לצורות שאין להן קוד תו משלהן להתרנדר כראוי. גופן מלווה אחד נוצר לכל גופן ונעשה בו שימוש חוזר בקריאות מאוחרות יותר באותו מסמך. כאשר המסמך נשמר, תוכנית הגופן המוטמעת מצומצמת רק לגליפים שהמסמך מציג, עם רוחבים אמיתיים לכל גליף ומפת ToUnicode שמתרגמת כל גליף מעוצב בחזרה לתווי המקור שלו — כך שטקסט שהועתק או חולץ מהפלט מחזיר את המחרוזת המקורית, כולל הליגטורות. המיקום הוא מדויק: כל התקדמות גליף ממנוע העיצוב נכתבת לזרם התוכן, כך שהפריסה המודפסת תואמת למדידה המעוצבת מ-GetShapedTextWidth