FPdfTextShaping - PDFium Delphi Component

Unidad: FPdfTextShaping

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

Workflow

API	Purpose
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Moldea texto con la implementación integrada de Windows Uniscribe y límites de recursos predeterminados
`TPdfTextShaper.Shape`	Contrato abstracto de moldeado 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, moldear, 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, reemplazando al integrado durante el resto del proceso; la unidad toma la propiedad de la instancia
`ClearTextShaper`	Quita un backend instalado y regresa 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 reporta el backend activo, para el registro de logs y para distinguir una implementación de otra

Public types

Type	Description
`EPdfTextShapingError`	Excepción generada por entradas inválidas, violaciones de límites de recursos, fallos de datos de fuente o errores del motor de moldeado
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` o `ptdRightToLeft`
`TPdfShapedGlyph`	Un glifo con `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` y `ClusterLength`
`TPdfShapedGlyphs`	Arreglo dinámico de registros `TPdfShapedGlyph`
`TPdfShapedRun`	Una ejecución visual con `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` y `Glyphs`
`TPdfShapedRuns`	Arreglo dinámico de registros `TPdfShapedRun` en orden visual
`TPdfShapedText`	`Text` de origen, `FontName` seleccionado, `FontSize`, `FontData` incorporado, `Runs` moldeados, `Width` total, `GlyphCount` y `LogicalCharacterCount`
`TPdfTextShapingOptions`	Límites de recursos `Direction`, `MaxCharacters`, `MaxGlyphs` y `MaxRuns`
`TPdfTextShaper`	Clase base abstracta para una implementación de moldeado proporcionada por quien llama
`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 grupo usan índices lógicos del texto de origen, mientras que Runs se devuelve 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 el moldeado deba ejecutarse en una plataforma que no sea Windows o mediante otro motor de moldeado
Uniscribe es el backend integrado en Windows y se instala automáticamente; en el resto de los 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;

Unidad FPdfTextShaping

Unidad: FPdfTextShaping

Workflow

Public types

Remarks

Example

See Also