FontDescent - TPdf - PDFium Delphi Component

Componente: TPdf · Unità: PDFium

Restituisce il descent del font, cioè la distanza dalla baseline fino al discendente più basso, del font di un oggetto pagina, espressa in punti PDF e scalata a una dimensione font fornita dal chiamante

Syntax

property FontDescent[Index: Integer; FontSize: Single]: Single; // read only

Description

FontDescent riporta la metrica di descent del font referenziato dall'oggetto di pagina all'indice dato. Il descent è la distanza verticale (tipicamente negativa nelle metriche PDF) dalla baseline fino al punto più basso raggiunto dagli abbassanti come le code di 'g', 'p' o 'y'. Il valore restituito da PDFium è già scalato all'argomento FontSize, in punti user-space PDF

L'indice Index è l'indice dell'oggetto di pagina a base zero (0..ObjectCount - 1). FontSize è la dimensione a cui vuoi calcolare la metrica; passa la dimensione a cui intendi fare rendering oppure, quando riproduci testo esistente, il valore restituito da CharacterFontSize. Una pagina deve essere attiva prima della lettura della proprietà

Combinato con FontAscent, il descent dà l'altezza totale di riga di un font a una dimensione scelta: LineHeight := FontAscent - FontDescent. PDFium restituisce 0 quando il font sottostante non espone la metrica (per esempio certi font Type3) o quando l'oggetto di pagina non è testo

Parameters

Index	Indice dell'oggetto di pagina a base zero nell'intervallo 0..ObjectCount - 1
FontSize	Dimensione del font in punti PDF usata per scalare la metrica (es. `12.0`). Adattala alla dimensione di rendering reale per un valore di abbassante realistico

Remarks

Il valore restituito è normalmente negativo, in linea con la convenzione PostScript / OpenType di misurare sotto la baseline
Restituisce 0 quando l'oggetto di pagina non è testo o quando il font descriptor non ha una voce di descent
Nei documenti multilingua il descent varia fortemente tra font latini e CJK — non riutilizzare un unico descent tra run diversi
Usa Abs(FontDescent[...]) quando ti serve la discesa assoluta sotto la baseline
Per testo a dimensioni miste scegli il FontSize più grande della riga quando dimensioni una fila

Example

var
  I: Integer;
  Asc, Dsc, LineHeight: Single;
begin
  Pdf1.PageNumber := 1;
  for I := 0 to Pdf1.ObjectCount - 1 do
  begin
    Asc := Pdf1.FontAscent[I, 12.0];
    Dsc := Pdf1.FontDescent[I, 12.0];
    LineHeight := Asc - Dsc;
    if LineHeight > 0 then
      Memo1.Lines.Add(Format('Object %d: line height = %.2f pt', [I, LineHeight]));
  end;
end;

FontDescent Proprietà