FPdfTextShaping - PDFium Delphi Component

Unit: FPdfTextShaping

Da forma al texto Unicode bidireccional en ejecuciones visuales de glifos para TPdf.AddShapedText, con tamaños de entrada y salida acotados y una clase base de formador extensible

Workflow

API	Purpose
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Da forma al texto con la implementación integrada de Windows Uniscribe y los límites de recursos predeterminados
`TPdfTextShaper.Shape`	Contrato abstracto de formación para motores personalizados que devuelven identificadores de glifos, grupos, ejecuciones visuales, avances y datos de la fuente seleccionada
`TPdfUniscribeTextShaper.Shape`	Usa `usp10.dll` para itemizar, dar forma, colocar y reordenar visualmente las ejecuciones de texto
`TPdfTextShapingOptions.Default`	Devuelve dirección automática con límites de 1,000,000 caracteres, 2,000,000 glifos y 100,000 ejecuciones
`ConfigureTextShaper(Shaper)`	Instala el backend de shaping que usa la unidad, sustituyendo al integrado durante el resto del proceso; la unidad se queda con la propiedad de la instancia
`ClearTextShaper`	Retira un backend instalado y vuelve al valor predeterminado de la plataforma
`ActiveTextShaper`	El backend en uso en este momento, o nil cuando no hay ningún shaper disponible en esta plataforma
`ActiveTextShaperName`	Nombre que informa el backend activo, para el registro de logs y para distinguir una implementación de otra

Public types

Type	Description
`EPdfTextShapingError`	Excepción lanzada por entradas no válidas, violaciones de límites de recursos, fallos de datos de fuente o errores del motor de formación
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` o `ptdRightToLeft`
`TPdfShapedGlyph`	Un glifo con `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` y `ClusterLength`
`TPdfShapedGlyphs`	Matriz dinámica de registros `TPdfShapedGlyph`
`TPdfShapedRun`	Una ejecución visual con `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` y `Glyphs`
`TPdfShapedRuns`	Matriz dinámica de registros `TPdfShapedRun` en orden visual
`TPdfShapedText`	`Text` de origen, `FontName` seleccionado, `FontSize`, `FontData` incrustado, `Runs` resultantes de la formación, `Width` total, `GlyphCount` y `LogicalCharacterCount`
`TPdfTextShapingOptions`	Límites de recursos `Direction`, `MaxCharacters`, `MaxGlyphs` y `MaxRuns`
`TPdfTextShaper`	Clase base abstracta para una implementación de formación proporcionada por el llamador
`TPdfUniscribeTextShaper`	Implementación integrada de Windows de `TPdfTextShaper`

Remarks

ptdAuto examina el texto de origen en busca del primer carácter direccional fuerte
Las posiciones de los grupos usan índices lógicos del texto de origen, mientras que Runs se devuelven en orden visual
FontData contiene los bytes de la fuente seleccionada que TPdf.AddShapedText necesita para crear una fuente CID
Use un TPdfTextShaper personalizado cuando la formación deba ejecutarse en una plataforma distinta de Windows o a través de otro motor de formación
Uniscribe es el backend integrado en Windows y se instala automáticamente; en el resto de casos ActiveTextShaper es nil hasta que ConfigureTextShaper suministre uno, y FPdfTextShapingHb ofrece un backend HarfBuzz para ese caso

Example

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

FPdfTextShaping Unidad

Unit: FPdfTextShaping

Workflow

Public types

Remarks

Example

See Also