GetFontColorGlyph

文本、字体、彩色字形

描述

通过选定的 TrueType 或 OpenType 字体映射 Unicode 码位,并返回其 COLR 绘制图、SVG 文档或嵌入式位图负载

语法

Delphi

Function TPDFlib.GetFontColorGlyph(FontID: Integer; CodePoint: Cardinal; PaletteIndex, PreferredPPEM: Integer; Out Glyph: TPDFlibColorGlyph): Integer;

参数

FontID字体创建或加载 API 返回的字体句柄
CodePoint范围从 0 到 $10FFFF 的 Unicode 标量值
PaletteIndex要解析的从零开始的 CPAL 调色板,值无效时回退到调色板零
PreferredPPEM所需的位图字形尺寸,或 0 以选择可用的最大字形尺寸
Glyph接收颜色格式、映射后的字形索引、说明和可选二进制负载

返回值

当存在受支持的颜色表示时返回 1;当字体、代码点或颜色表无法提供颜色表示时返回 0;失败时清除输出值

备注

COLR version 0 图层和 COLR version 1 绘制图包含 DescriptionJSON 中已解析的 CPAL 颜色,包括变换、渐变和合成节点

SVG-in-OpenType 会在 Data 中返回精确的 SVG 文档;gzip 压缩的文档使用 image/svg+xml+gzip,以便调用方无需猜测内容即可区分压缩字节

sbix 和 CBDT/CBLC 选择最接近请求的字级,并返回带有其 MIME 类型和每 em 像素元数据的 PNG、JPEG、TIFF 或原始 OpenType 位图数据

另请参阅

GetFontColorGlyphByIndex, TPDFlibColorGlyph, TPDFlibColorGlyphKind