FontAscent - TPdf - PDFium Delphi Component

Компонент: TPdf · Модуль: PDFium

Возвращает подъем шрифта, то есть расстояние от базовой линии до самого высокого выносного элемента, для шрифта объекта страницы, выраженное в точках PDF и масштабированное к заданному размеру шрифта

Syntax

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

Description

FontAscent сообщает метрику ascent (подъём) шрифта, на который ссылается объект страницы по заданному индексу. Ascent — вертикальное расстояние от базовой линии вверх до самой высокой точки, которой достигают самые высокие символы шрифта (заглавные, акценты, верхние выносные элементы вроде 'l', 'h', 'k'). Результат выражен в пунктах пользовательского пространства PDF и уже отмасштабирован под переданный FontSize

Индексатор Index — это индекс объекта страницы с нуля (0..ObjectCount - 1). Второй индексатор, FontSize, — размер в пунктах PDF, для которого считается метрика. Передавайте размер, в котором собираетесь рендерить, или используйте CharacterFontSize[n], чтобы повторить размер существующего текстового прогона. Для чтения свойства страница должна быть активна

Вместе с FontDescent это даёт полную высоту строки шрифта: LineHeight := FontAscent - FontDescent (descent обычно отрицательный). PDFium возвращает 0, если у шрифта нет такой метрики или индексированный объект не текст

Parameters

Index	Индекс объекта страницы с нуля в диапазоне 0..ObjectCount - 1
FontSize	Размер шрифта в пунктах PDF для масштабирования метрики. Обычно размер, в котором шрифт будет отрисован (например `10.0`, `12.0`)

Remarks

Возвращает положительное значение — ascent измеряется вверх от базовой линии
Для типографически честной вёрстки комбинируйте ascent и descent, а не используйте один FontSize
Возвращает 0, когда у шрифта нет записи ascent или объект не текст — всегда подстраховывайтесь
CJK-шрифты при том же размере часто выдают больший ascent, чем западные; не считайте, что латинские метрики переносятся напрямую
Первый индексатор свойства совпадает с индексом объекта страницы у FontHandle, а не с символьным индексом у Character

Example

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

FontAscent Свойство