FPdfTextShaping - PDFium Delphi Component

Unit: FPdfTextShaping

Oblikuje dvosmjerni Unicode tekst u vizualne nizove glifova za TPdf.AddShapedText, s ograničenim veličinama ulaza i izlaza i proširivom baznom klasom shapera

Tijek rada

API	Svrha
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Oblikuje tekst ugrađenom Windows Uniscribe implementacijom sa zadanim ograničenjima resursa
`TPdfTextShaper.Shape`	Apstraktni ugovor oblikovanja za prilagođene mehanizme koji vraćaju identifikatore glifova, klastere, vizualne nizove, pomake i odabrane podatke fonta
`TPdfUniscribeTextShaper.Shape`	Koristi `usp10.dll` za razdvajanje teksta na nizove, oblikovanje, pozicioniranje i vizualno preraspoređivanje
`TPdfTextShapingOptions.Default`	Vraća automatski smjer s ograničenjima od 1,000,000 znakova, 2,000,000 glifova i 100,000 nizova
`ConfigureTextShaper(Shaper)`	Instalira pozadinski mehanizam oblikovanja koji unit koristi, zamjenjujući ugrađenog do kraja procesa; unit preuzima vlasništvo nad instancom
`ClearTextShaper`	Uklanja instalirani mehanizam i vraća se na platformski zadanog
`ActiveTextShaper`	Mehanizam koji se trenutačno koristi, ili nil kada na ovoj platformi nema dostupnog shapera
`ActiveTextShaperName`	Naziv koji aktivni mehanizam prijavljuje, za logiranje i razlikovanje jednog rasporeda od drugog

Javni tipovi

Tip	Opis
`EPdfTextShapingError`	Iznimka koja se podiže za nevažeće ulaze, prekoračenja ograničenja resursa, pogreške podataka fonta ili pogreške mehanizma oblikovanja
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` ili `ptdRightToLeft`
`TPdfShapedGlyph`	Jedan glif s `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` i `ClusterLength`
`TPdfShapedGlyphs`	Dinamičko polje zapisa `TPdfShapedGlyph`
`TPdfShapedRun`	Jedan vizualni niz s `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` i `Glyphs`
`TPdfShapedRuns`	Dinamičko polje zapisa `TPdfShapedRun` u vizualnom redoslijedu
`TPdfShapedText`	Izvorni `Text`, odabrani `FontName`, `FontSize`, ugrađeni `FontData`, oblikovani `Runs`, ukupna `Width`, `GlyphCount` i `LogicalCharacterCount`
`TPdfTextShapingOptions`	Ograničenja resursa `Direction`, `MaxCharacters`, `MaxGlyphs` i `MaxRuns`
`TPdfTextShaper`	Apstraktna bazna klasa za implementaciju oblikovanja koju dostavlja pozivatelj
`TPdfUniscribeTextShaper`	Ugrađena Windows implementacija `TPdfTextShaper`

Napomene

ptdAuto ispituje izvorni tekst tražeći prvi jak smjerni znak
Pozicije klastera koriste logičke indekse izvornog teksta dok se Runs vraćaju u vizualnom redoslijedu
FontData sadrži bajtove odabranog fonta koje TPdf.AddShapedText treba za stvaranje CID fonta
Koristite prilagođeni TPdfTextShaper kada oblikovanje mora raditi na platformi koja nije Windows ili kroz drugi mehanizam oblikovanja
Uniscribe je ugrađena pozadina na Windowsima i instalira se automatski; drugdje je ActiveTextShaper nil dok ConfigureTextShaper ne dostavi jednoga, a FPdfTextShapingHb za taj slučaj nudi HarfBuzz pozadinu

Primjer

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

Vidi također