HPDFShapeHeadlessTextOrderedSpan 函式
以段落衍生的嵌入層級、script 與視覺位置,對完整物理行 shaping 選定的樣式區段
function HPDFShapeHeadlessTextOrderedSpan(const Context: UnicodeString;
FirstUnit, UnitCount: Integer; const Order: THPDFHeadlessTextOrder;
const FontBytes: SysUtils.TBytes; MaximumGlyphs: Integer;
CancellationToken: THPDFCancellationToken;
CharacterAdvance: Double = 0; WordAdvance: Double = 0): THPDFHeadlessShapedGlyphs;
Order 必須涵蓋完整物理行 Context 的每個 UTF-16 unit;請從 HPDFResolveHeadlessTextLineOrder 或 HPDFReorderHeadlessTextLine 取得
FirstUnit 與 UnitCount 在物理行內選取完整 scalar;真實的 HarfBuzz buffer 收到周圍行文字,方向與 script 來自解析後的段落順序
回傳的 glyph 來源偏移相對於選定樣式區段;glyph ID、前進量與偏移使用實際嵌入字型,比例為每 em 1000 單位
函式驗證陣列一致、scalar 視覺排名唯一、嵌入層級、surrogate 一致性、有限間距、glyph 上限與取消;格式錯誤的順序不會悄悄退回獨立的方向偵測
字元間距對每個 shaped cluster 套用一次,僅含 Unicode 方向控制字元的 cluster 除外;單詞間距套用在空格 cluster 上;呼叫端的原始邏輯值與樣式文字獨立於視覺 glyph 順序保留