THPDFHeadlessTextAppearanceOptions
Optionen in HPDFHeadlessAppearance für Unicode-Form XObjects mit gemessenem Layout und optionalem komplexen Shaping
| Feld | Default und Vertrag |
|---|---|
Width, Height | 200 mal 30 PDF-Einheiten; das Dokumentfüllen leitet diese Werte aus jedem Widget-Rechteck ab |
FontSize | 12 PDF-Einheiten; null fordert Auto-Fit mit maximal 12 an |
Padding | 2 Einheiten an jeder Kante, mit positivem innerem Clip-Rechteck |
TextColor[0..2] | Schwarze RGB-Komponenten, jeweils von null bis eins |
PaintWhiteBackground | True, malt den vollständigen Widget-Hintergrund weiß |
Alignment | htaLeft; unterstützt center und right, wobei geerbtes Feld-Q beim Dokumentfüllen Vorrang hat |
Multiline, WrapText | False und True; CR/LF-Absatzumbrüche und gemessener logischer Zeilenumbruch, wobei das Dokumentfüllen den Multiline-Modus aus den Feld-Flags ableitet |
CombCells | Null; ein positiver Wert zentriert direkte skalare Glyphen in einzelnen Zellen, abgeleitet aus MaxLen für comb-Textfelder |
Rotation | Null; Vielfache von 90 Grad normalisiert modulo 360, abgeleitet aus Widget-MK.R beim Dokumentfüllen |
LineSpacing | 1.2 mal Schriftgröße, begrenzt auf 1 bis 10 |
CharacterSpacing, WordSpacing | Null PDF-Punkte; endlicher positiver oder negativer Abstand, begrenzt auf einen Absolutwert von 1000000, wobei Wortabstand auf U+0020 angewendet wird und Zeichenabstand einmal nach jedem direkten Skalar oder geformten Cluster, einschließlich des letzten Clusters |
ShapeComplexText | True; lädt passende HarfBuzz- und FriBidi-Runtimes nur, wenn komplexer Text Shaping braucht |
FallbackFontFamilies | False; True aktiviert vollständigen Graphem-Font-Fallback über explizit gelieferte Rich-Text-Familien, mit bewahrten Originalwerten und verfassten Styles; der Single-Font-Text-Builder durchsucht keine anderen Familien |
HighlightLines | Leeres dynamisches Integer-Array; jeder nichtnegative sichtbare Zeilenindex malt einen blauen Hintergrund, mit der Zeilenzahl begrenzt durch MaxGlyphs und abgeschnittenen Offscreen-Zeilen |
HighlightLine | -1; ein nichtnegativer sichtbarer Zeilenindex malt einen blauen Auswahlhintergrund für Listenfeld-Appearances |
Border | habNone; habRectangle oder habCircle malt eine begrenzte Button-Umrandung |
MaxFontBytes | 8 MiB über ausgewählte Programme und während des Supplied-Family-Fallbacks inspizierte Kandidatenprogramme |
MaxObjectBytes | 16 MiB pro Dictionary oder Stream einschließlich Payload |
MaxGlyphs | 65535 Eingabeskalare und erzeugte Glyphen, begrenzt durch den 16-Bit-CID-Raum |
CancellationToken | Nil oder ein Token des Aufrufers, das während der gesamten Operation am Leben bleibt |
Dimensionen, Padding und Schriftgröße müssen endlich sein; Dimensionen und eine von null verschiedene Schriftgröße sind auf 0.000001 bis 1000000 Einheiten begrenzt, und das innere Clip-Rechteck muss auf jeder Achse mindestens 0.000001 Einheiten bleiben
Auto-Fit, das eine null Schriftgröße serialisieren würde, wird abgelehnt, während Text fester Größe auf das innere Widget-Rechteck beschnitten wird
Textabstand fließt in gemessene Breiten, Ausrichtung, Umbruch und Auto-Fit ein; erzeugter CID-Text nutzt absolute Glyphenpositionierung, weil PDF Tw nicht auf einen zweibytigen Identity-H-Space-Code anwendbar ist
Das Dokumentfüllen deckelt zusätzlich Objekt- und Glyphenbudgets durch Dokumentoptionen, deckelt die Schriftgröße in Bytes durch das Decoded-Stream-Budget und lässt die aggregierten neuen Objekte gegen das verbleibende Dateibudget zu