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