FontDescent - TPdf - PDFium Delphi Component

컴포넌트: TPdf · 유닛: PDFium

page object의 font에 대해 font descent(기준선에서 가장 낮은 descender까지의 거리)를 반환하며, PDF point로 표현되고 호출자가 지정한 font size에 맞게 스케일됩니다

Syntax

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

Description

FontDescent는 지정한 인덱스의 페이지 객체가 참조하는 폰트의 descent 지표를 알려 줍니다. descent는 베이스라인에서 'g', 'p', 'y' 꼬리 같은 descender가 닿는 최저점까지의 수직 거리입니다(PDF 지표에서는 보통 음수). PDFium이 반환하는 값은 FontSize 인자에 맞춰 이미 스케일된 PDF 사용자 공간 포인트입니다

Index 인덱서는 0 기반 페이지 객체 인덱스입니다(0..ObjectCount - 1). FontSize는 지표를 계산할 크기로, 렌더링할 크기를 넘기거나 기존 텍스트를 재현할 때는 CharacterFontSize가 반환한 값을 넘기세요. 프로퍼티를 읽기 전에 페이지가 활성화되어 있어야 합니다

FontAscent와 조합하면 선택한 크기에서 폰트의 전체 줄 높이가 나옵니다. LineHeight := FontAscent - FontDescent 하부 폰트가 해당 지표를 노출하지 않거나(예: 일부 Type3 폰트) 페이지 객체가 텍스트가 아니면 PDFium은 0을 반환합니다

Parameters

Index	0..ObjectCount - 1 범위의 0 기반 페이지 객체 인덱스입니다
FontSize	지표를 스케일할 PDF 포인트 단위 폰트 크기입니다(예: `12.0`). 실제 descender 값에 가깝게 쓰려면 실제 렌더링 크기와 맞추세요

Remarks

반환값은 보통 음수이며, 베이스라인 아래로 잰다는 PostScript / OpenType 관례와 일치합니다
페이지 객체가 텍스트가 아니거나 폰트 디스크립터에 descent 항목이 없으면 0을 반환합니다
다국어 문서에서는 descent가 라틴과 CJK 폰트 사이에서 크게 갈립니다 — 런마다 같은 descent를 재사용하지 마세요
베이스라인 아래 절대 거리가 필요하면 Abs(FontDescent[...])를 쓰세요
크기가 섞인 텍스트에서 행 높이를 정할 때는 줄에서 가장 큰 FontSize를 고르세요

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 속성