FPdfTextShaping - PDFium Delphi Component

Unidade: FPdfTextShaping

Molda texto Unicode bidirecional em sequências visuais de glifos para TPdf.AddShapedText, com tamanhos de entrada e saída limitados e uma classe base de moldador extensível

Workflow

API	Finalidade
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Molda texto com a implementação Uniscribe incorporada do Windows e limites de recursos predefinidos
`TPdfTextShaper.Shape`	Contrato abstrato de moldagem para motores personalizados que devolvem identificadores de glifos, clusters, sequências visuais, avanços e dados da fonte selecionada
`TPdfUniscribeTextShaper.Shape`	Usa `usp10.dll` para itemizar, moldar, colocar e reordenar visualmente sequências de texto
`TPdfTextShapingOptions.Default`	Devolve direção automática com limites de 1,000,000 caracteres, 2,000,000 glifos e 100,000 sequências
`ConfigureTextShaper(Shaper)`	Instala o backend de shaping usado pela unidade, substituindo o integrado pelo resto do processo; a unidade fica com a propriedade da instância
`ClearTextShaper`	Remove um backend instalado e regressa à predefinição da plataforma
`ActiveTextShaper`	O backend atualmente em uso, ou nil quando não há nenhum shaper disponível nesta plataforma
`ActiveTextShaperName`	O nome que o backend ativo comunica, para registos e para distinguir uma implementação de outra

Public types

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 motor de moldagem
`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 sequência visual com `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` e `Glyphs`
`TPdfShapedRuns`	Array dinâmico de records `TPdfShapedRun` em ordem visual
`TPdfShapedText`	Texto de origem `Text`, fonte selecionada `FontName`, `FontSize`, `FontData` incorporada, `Runs` moldadas, `Width` total, `GlyphCount` e `LogicalCharacterCount`
`TPdfTextShapingOptions`	Limites de recursos `Direction`, `MaxCharacters`, `MaxGlyphs` e `MaxRuns`
`TPdfTextShaper`	Classe base abstrata para uma implementação de moldagem fornecida pelo chamador
`TPdfUniscribeTextShaper`	Implementação incorporada do Windows de `TPdfTextShaper`

Remarks

ptdAuto examina o texto de origem à procura do primeiro carácter direcional forte
As posições dos clusters usam índices lógicos do texto de origem enquanto Runs é devolvido 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 a moldagem tiver de correr numa plataforma não Windows ou através de outro motor de moldagem
O Uniscribe é o backend integrado no Windows e é instalado automaticamente; nos restantes casos, ActiveTextShaper mantém-se nil até que ConfigureTextShaper forneça um, e FPdfTextShapingHb disponibiliza um backend HarfBuzz para esses casos

Example

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

Unidade FPdfTextShaping

Unidade: FPdfTextShaping

Workflow

Public types

Remarks

Example

See Also