Довідник розробника PDFium Delphi Component

Unit: FPdfTextShaping

Формує двонаправлений текст Unicode у візуальні гліф-фрагменти (runs) для TPdf.AddShapedText, з обмеженими розмірами входу й виходу та розширюваним базовим класом шейпера

Workflow

API	Purpose
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Формує текст вбудованою реалізацією Windows Uniscribe з типовими лімітами ресурсів
`TPdfTextShaper.Shape`	Абстрактний контракт формування для власних рушіїв, які повертають ідентифікатори гліфів, кластери, візуальні фрагменти, ширини (advances) та дані обраного шрифту
`TPdfUniscribeTextShaper.Shape`	Використовує `usp10.dll`, щоб розбивати на елементи, формувати, розміщувати та візуально впорядковувати фрагменти тексту
`TPdfTextShapingOptions.Default`	Повертає автоматичний напрямок із лімітами 1,000,000 символів, 2,000,000 гліфів і 100,000 фрагментів
`ConfigureTextShaper(Shaper)`	Встановлює бекенд формування, який використовує модуль, замінюючи вбудований до кінця процесу; модуль бере володіння екземпляром
`ClearTextShaper`	Прибирає встановлений бекенд і повертається до платформного типового
`ActiveTextShaper`	Бекенд, що використовується зараз, або nil, коли на цій платформі немає шейпера
`ActiveTextShaperName`	Ім'я, яке звітує активний бекенд, для логування та розрізнення розгортань

Public types

Type	Description
`EPdfTextShapingError`	Виняток для некоректних входів, порушень лімітів ресурсів, збоїв даних шрифту чи помилок рушія формування
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` або `ptdRightToLeft`
`TPdfShapedGlyph`	Один гліф з `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` і `ClusterLength`
`TPdfShapedGlyphs`	Динамічний масив записів `TPdfShapedGlyph`
`TPdfShapedRun`	Один візуальний фрагмент з `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` і `Glyphs`
`TPdfShapedRuns`	Динамічний масив записів `TPdfShapedRun` у візуальному порядку
`TPdfShapedText`	Вихідний `Text`, обраний `FontName`, `FontSize`, вбудовані `FontData`, сформовані `Runs`, сумарна `Width`, `GlyphCount` і `LogicalCharacterCount`
`TPdfTextShapingOptions`	Ліміти ресурсів `Direction`, `MaxCharacters`, `MaxGlyphs` і `MaxRuns`
`TPdfTextShaper`	Абстрактний базовий клас для наданої викликачем реалізації формування
`TPdfUniscribeTextShaper`	Вбудована реалізація `TPdfTextShaper` для Windows

Remarks

ptdAuto шукає у вихідному тексті перший сильно напрямлений символ
Позиції кластерів використовують логічні індекси вихідного тексту, тоді як Runs повертаються у візуальному порядку
FontData містить байти обраного шрифту, потрібні TPdf.AddShapedText для створення CID-шрифту
Використовуйте власний TPdfTextShaper, коли формування має виконуватися на платформі, відмінній від Windows, або через інший рушій формування
Uniscribe — вбудований бекенд у Windows і встановлюється автоматично; в інших випадках ActiveTextShaper дорівнює nil, поки ConfigureTextShaper не надасть шейпер, а FPdfTextShapingHb дає бекенд HarfBuzz для цього випадку

Example

var
  Shaped: TPdfShapedText;
  MeasuredWidth: Single;
begin
  if ShapePdfText(Text, 'Segoe UI', 12, ptdAuto, Shaped) then
    MeasuredWidth := Shaped.Width;
end;

FPdfTextShaping модуль

Unit: FPdfTextShaping

Workflow

Public types

Remarks

Example

See Also