FPdfTextShaping - PDFium Delphi Component

Unidade: FPdfTextShaping

Realiza o shaping de texto Unicode bidirecional em execuções visuais de glifos para TPdf.AddShapedText, com tamanhos limitados de entrada e saída e uma classe base extensível de shaper

Fluxo de trabalho

API	Finalidade
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Realiza o shaping do texto com a implementação Uniscribe integrada do Windows e limites de recursos padrão
`TPdfTextShaper.Shape`	Contrato abstrato de shaping para engines personalizadas que retornam identificadores de glifos, clusters, execuções visuais, avanços e dados da fonte selecionada
`TPdfUniscribeTextShaper.Shape`	Usa `usp10.dll` para itemizar, moldar, posicionar e reordenar visualmente as execuções de texto
`TPdfTextShapingOptions.Default`	Retorna direção automática com limites de 1,000,000 caracteres, 2,000,000 glifos e 100,000 execuções
`ConfigureTextShaper(Shaper)`	Instala o backend de shaping usado pela unit, substituindo o interno pelo resto do processo; a unit assume a propriedade da instância
`ClearTextShaper`	Remove um backend instalado e volta ao padrão da plataforma
`ActiveTextShaper`	O backend em uso no momento, ou nil quando não há shaper disponível nesta plataforma
`ActiveTextShaperName`	O nome que o backend ativo informa, para logs e para distinguir uma implantação da outra

Tipos públicos

Tipo	Descrição
`EPdfTextShapingError`	Exceção lançada para entradas inválidas, violações de limites de recursos, falhas de dados de fonte ou erros do engine de shaping
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` ou `ptdRightToLeft`
`TPdfShapedGlyph`	Um glifo com `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` e `ClusterLength`
`TPdfShapedGlyphs`	Array dinâmico de records `TPdfShapedGlyph`
`TPdfShapedRun`	Uma execução visual com `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` e `Glyphs`
`TPdfShapedRuns`	Array dinâmico de records `TPdfShapedRun` em ordem visual
`TPdfShapedText`	`Text` de origem, `FontName` selecionada, `FontSize`, `FontData` incorporada, `Runs` com shaping aplicado, `Width` total, `GlyphCount` e `LogicalCharacterCount`
`TPdfTextShapingOptions`	Limites de recursos `Direction`, `MaxCharacters`, `MaxGlyphs` e `MaxRuns`
`TPdfTextShaper`	Classe base abstrata para uma implementação de shaping fornecida pelo chamador
`TPdfUniscribeTextShaper`	Implementação integrada do Windows de `TPdfTextShaper`

Observações

ptdAuto examina o texto de origem em busca do primeiro caractere direcional forte
As posições de cluster usam índices lógicos do texto de origem, enquanto Runs são retornadas em ordem visual
FontData contém os bytes da fonte selecionada exigidos por TPdf.AddShapedText para criar uma fonte CID
Use um TPdfTextShaper personalizado quando o shaping precisar executar em uma plataforma não Windows ou por meio de outro engine de shaping
O Uniscribe é o backend interno no Windows e é instalado automaticamente; nos demais casos, ActiveTextShaper permanece nil até que ConfigureTextShaper forneça um, e FPdfTextShapingHb oferece um backend HarfBuzz para esses casos

Exemplo

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

Consulte também

TPdf.AddShapedText