Python 的 Aspose.Font FOSS

API reference 用于 Aspose.Font FOSS 用于 Python v1.0.0. 139 个公开类型按模块组织。

核心 API

类	描述
`ActiveTupleSummary`	ActiveTupleSummary.to_dict() 返回一个字典，包含元组的索引、标量值、峰值坐标、起始坐标和结束坐标。
`AnimationAsset`	AnimationAsset.write_to(path) 将生成的动画数据写入给定的文件系统位置，创建缺失的父目录，并返回已写入文件的 Path。
`AnimationFramePackage`	AnimationFramePackage.write_to(path) 将故事板图像、每帧图像以及描述 fps 和帧标签的 JSON 清单写入指定目录。
`AnimationPreset`	AnimationPreset.name 存储动画预设的标识符。
`AnimationPreviewBuilder`	AnimationPreviewBuilder.available_presets 返回用于动画生成的预设名称元组。
`AnimationReviewPackage`	AnimationReviewPackage.write_to 将审查包保存到给定的文件系统路径并返回 Path。
`AnimationShowcasePackage`	AnimationShowcasePackage.write_to 将包写入给定路径并返回生成的 Path。
`AnimationStep`	AnimationStep.coordinates 存储一个将轴名称映射到浮点值的映射，用于定义字体实例。
`BinaryReader`	将字节源包装在可定位的 BytesIO 中，以进行大端序字体二进制解析。
`BinaryWriter`	累计字节以进行二进制字体序列化。
`CffSerializer`	CffSerializer 可以将一个完全填充的 CffFont 序列化为字节数组，以便写入为 CFF 或 OpenType 字体文件。
`ClosePath`	扩展 PathCommand 的类。
`CompatibilityChecker`	CompatibilityChecker.compare_fonts(before, after, before_label, after_label, codepoints, text) 生成一个 CompatibilityReport，可以通过 report.to_json(indent=2, sort_keys=True) 导出为 JSON。
`CompatibilityReport`	CompatibilityReport.to_json(indent, sort_keys) 返回报告的 JSON 字符串，且 write_json(target, indent, sort_keys) 将该 JSON 直接写入文件。
`CompletedTaskRecord`	CompletedTaskRecord.task_id 唯一标识已完成的任务。
`CompositeComponentMovement`	CompositeComponentMovement.to_dict 返回一个包含对象数值和布尔字段的字典。
`CompositeGlyphComponent`	CompositeGlyphComponent.to_dict() 返回一个包含组件数值属性的字典。
`CoverageGroup`	针对单个请求来源（例如预设、文本或范围）的覆盖率诊断。
`CurveAdapter`	CurveAdapter.quad_to_cubic 将二次贝塞尔曲线 (p0, q, p3) 转换为等效的三次贝塞尔曲线，返回四个点。
`CurveTo`	CurveTo.x1 是第一个贝塞尔控制点的 x 坐标。
`DeltaInspector`	DeltaInspector 支持详细的可变字体 delta 分析，生成 GlyphDeltaReport 和 TextDeltaReport 对象，以突出显示不同实例之间的坐标变化。
`DeltaPoint`	DeltaPoint.to_dict 返回一个包含该点数值组件的字典。
`DeltaTupleReport`	DeltaTupleReport.tuple_index 是 delta 元组的零基索引。
`EotSerializer`	EotSerializer.serialize(font) 返回准备写入文件的 EOT 字体的完整二进制表示。
`FamilyReviewExportPackage`	FamilyReviewExportPackage.write_to(directory) 为字体族创建一组 HTML、CSS 和清单文件，并返回生成的文件路径列表。
`Font`	所有字体格式实现的抽象基类。
`FontCleaner`	字体元数据及技术表清理器。
`FontConversionException`	当字体格式转换失败或不受支持时抛出。
`FontConverter`	FontConverter.convert(font, target) 会生成目标格式的新 Font 对象，如果无法执行转换则抛出 FontConversionException。
`FontEncoding`	将 Unicode 码点映射到字形 ID。
`FontException`	所有字体库异常的基类。
`FontLoader`	FontLoader.open(source, font_type, collection_index) 返回一个 Font 对象，表示请求的字体类型，但不会将整个文件完全加载到内存中。
`FontMetrics`	FontMetrics 提供关键的排版数值，例如 units_per_em、ascender、descender 和 line_gap，用于布局计算。
`FontNotSupportedException`	对有效但不支持的字体特性抛出（例如.
`FontParseException`	当二进制字体数据无法解析时抛出。
`FontPreviewBuilder`	FontPreviewBuilder.build(font, text, size, color, background, padding, antialias, file_stem, instance_coordinates, instance_name, output_format) 生成一个 PreviewImage（PNG 或 SVG），该文件是使用给定字体渲染的提供的文本。
`FontSourceInfo`	描述已加载字节的来源。
`FontSubsetter`	FontSubsetter.available_presets() 返回一个预设名称的元组，可用于面向 Web 的子集化。
`Glyph`	Glyph.glyph_id 使用其数值 GlyphId 来标识字形。
`GlyphAccessor`	根据 ID 或 Unicode 码点检索字形。
`GlyphCompatibilityIssue`	GlyphCompatibilityIssue.to_dict 返回该问题的字典表示。
`GlyphDeltaComparisonReport`	GlyphDeltaComparisonReport.moved_point_count 是前后之间移动的点的数量。
`GlyphDeltaReport`	GlyphDeltaReport.to_dict 返回报告数据的字典表示。
`GlyphId`	GlyphId.value 保存字形的整数标识符。
`GlyphInterpolationIssue`	GlyphInterpolationIssue.codepoint 是受影响字形的整数 Unicode 码点。
`GlyphLayout`	单个字形位于世界空间布局坐标中。
`GlyphNotFoundException`	当请求的字形 ID 或码点在字体中没有映射时抛出。
`GlyphOutlineStats`	GlyphOutlineStats.to_dict 返回大纲统计信息的字典表示。
`GlyphPath`	有序的 PathCommand 对象序列，表示单个字形的轮廓。
`KernPair`	KernPair.left 是字距对中左侧字形的 GlyphId。
`LanguageProfile`	LanguageProfile.to_dict 返回语言配置文件的字典表示。
`LineTo`	LineTo.x 表示线段端点的水平坐标。
`LoadedFont`	友好的加载器结果，封装了字体以及源元数据。
`LocalizationCoverage`	LocalizationCoverage.to_dict 返回覆盖数据的字典表示。
`LocalizationResolution`	LocalizationResolution.to_dict 返回分辨率状态的字典表示。
`MoveTo`	MoveTo.x 存储移动操作的水平坐标。
`PathCommand`	所有路径命令类型的抽象标记。
`PreviewImage`	PreviewImage.write_to(path) 将生成的 PNG 或 SVG 预览保存到指定的文件系统位置，并返回 Path 对象。
`QuadraticTo`	QuadraticTo.x1 表示二次贝塞尔控制点的 x 坐标。
`Rasterizer`	用于 GlyphPath 轮廓的扫描线光栅化器，支持 pure-Python PNG 导出。
`RequestedLanguageHint`	RequestedLanguageHint.to_dict 返回 hint 对象的字典表示。
`ResolvedInstance`	ResolvedInstance.label 是已解析实例的人类可读名称。
`SmartInstancer`	SmartInstancer.instantiate(coordinates, instance_name, naming_strategy, family_suffix, legacy_family_name, typographic_family_name, legacy_style_name, typographic_style_name, stat_policy) 返回一个 TtfFont 对象，表示可变字体的静态实例。
`SubsetCoverage`	聚合子集请求的 Unicode 覆盖诊断。
`SubsetResult`	子集输出与用于生成它的覆盖报告一起打包。
`TaskCompletionReceipt`	TaskCompletionReceipt.task_id 唯一标识该任务。
`TaskTokenEstimate`	TaskTokenEstimate.task_id 是任务的唯一标识符。
`TextDeltaComparisonReport`	TextDeltaComparisonReport.to_dict() 返回一个包含所有报告字段的字典。
`TextDeltaReport`	TextDeltaReport 汇总字形级别的增量信息，公开 glyph_count、active_glyph_count，以及用于 QA 检查的一组 glyph_reports。
`TextLayout`	调用 TextRenderer.layout() 的结果。
`TextRenderer`	使用字体的字形度量和可选的字距对来排版文本。
`TtfSerializer`	TtfSerializer.serialize 将给定的字体对象序列化为字节数组，可选地使用提供的 sfnt 版本。
`TupleScalarDelta`	TupleScalarDelta.to_dict() 返回一个包含 tuple_index、before_scalar 和 after_scalar 值的 dict。
`Type1Serializer`	Type1Serializer.serialize_pfb 将字体对象转换为 PFB 二进制数据.
`UnsupportedFontFormatException`	当文件的魔术字节未被识别时，由 FontLoader 抛出.
`VariableAxis`	VariableAxis.normalize(value) 根据轴的定义范围，返回原始轴坐标的归一化 (0‑1) 位置.
`VariableAxisPreset`	VariableAxisPreset.to_presentation(axis) 返回一个表示预设的呈现元数据字典，适用于 UI 渲染预设控件.
`VariableInstance`	VariableInstance.css_variation_settings(axes) 会为给定的轴集合生成一个包含 CSS `font-variation-settings` 字符串的元组。
`WebFontAsset`	WebFontAsset.filename 将原始字体文件名以字符串形式存储。
`WebFontBuilder`	WebFontBuilder 可以生成完整的网络字体系列，包括 CSS、HTML 预览页面以及可直接部署的清单文件。
`WebFontBundle`	WebFontBundle.write_to 将捆绑包写入目录，并返回已写入文件路径的列表。
`WebFontFamilyPackage`	WebFontFamilyPackage.write_to(directory) 创建一个完整的家族包，包含 CSS、HTML、清单以及针对多种样式变体的所有打包字体资源。

枚举

枚举	描述
`FontType`	FontType.TTF 表示 TrueType 字体格式。

CFF 字体处理

类	描述
`CffCharset`	CffCharset.standard(num_glyphs) 为给定的字形数量创建一个标准的 CFF 字符集，且 name_for(gid) 返回对应字形 ID 的字形名称。
`CffDict`	CffDict.from_bytes 从给定的二进制数据创建一个 CffDict 实例。
`CffEncoding`	CffEncoding.unicode_to_gid(codepoint) 返回根据当前 CFF 编码的 Unicode 码点的 GlyphId。
`CffFont`	CffFont.get_kern_pairs() 返回一个 KernPair 对象列表，表示字体中定义的字距调整。
`CffIndex`	CffIndex.from_reader(r) 通过从二进制读取器 r 解析数据来创建一个 CffIndex 实例。
`PrivateDict`	PrivateDict.from_dict(d) 从包含诸如 default_width_x 和 nominal_width_x 等私有字典条目的字典中创建一个 PrivateDict 实例。
`PrivateDictOp`	PrivateDictOp.BLUE_VALUES 表示定义水平茎对齐区的 BlueValues 条目。
`TopDict`	TopDict.from_dict(d, string_index) 从字典表示和字符串索引表创建一个 TopDict 实例，允许以编程方式重建字体顶层元数据。
`TopDictOp`	TopDictOp.VERSION 表示字体的版本号。
`Type2Interpreter`	将 Type 2 charstrings 解释为 GlyphPath 命令。

EOT 字体处理

类	描述
`EotFont`	嵌入式 OpenType (EOT) 包装器，位于内部的 TrueType/OpenType 字体之上。
`EotHeader`	EotHeader.eot_size 是 EOT 文件的总字节大小。

TrueType 字体处理

类	描述
`AvarAxisMap`	AvarAxisMap.mapping 存储一个 (float, float) 元组列表，用于定义可变字体轴的输入‑输出值映射。
`AvarTable`	AvarTable.from_reader(r, length) 从二进制读取器构造一个 AvarTable，而 map_normalized(axis_index, value) 则返回归一化轴坐标对应的映射浮点数。
`AxisRecord`	AxisRecord.tag 存储四字符轴标签标识符（例如 ‘wght’）。
`CmapSubtable`	CmapSubtable.get_gid 返回一个 Unicode 代码点的字形 ID，如果未映射则返回 None。
`CmapTable`	CmapTable.from_reader(r, table_length) 从字体流中解析 cmap 表，best_subtable() 为 Unicode 查找选择最合适的 CmapSubtable。
`DeltaSetIndex`	DeltaSetIndex.outer 表示 delta 集位置的外部索引组件。
`DeltaSetIndexMap`	DeltaSetIndexMap.from_reader(r) 从二进制读取器构建一个 DeltaSetIndexMap，并且 get(gid) 检索相应的 DeltaSetIndex。
`FvarTable`	FvarTable.from_reader 通过从 BinaryReader 读取 length 字节来创建一个新的 FvarTable。
`GlyfTable`	GlyfTable.from_reader 使用指定的长度从 BinaryReader 中读取一个 GlyfTable，并返回一个 GlyfTable 实例。
`GvarTable`	GvarTable.from_reader 使用给定的长度和轴标签从 BinaryReader 中读取一个 GvarTable。
`HMetric`	具有 2 个属性的类。
`HeadTable`	HeadTable.from_reader 读取一个 BinaryReader 并返回一个已填充的 HeadTable 实例。
`HheaTable`	HheaTable.from_reader 读取一个 BinaryReader 并构造一个 HheaTable 对象。
`HmtxTable`	HmtxTable.from_reader 从 BinaryReader 中读取 hmtx 数据并创建一个 HmtxTable 实例。
`HvarTable`	HvarTable.advance_width_delta(gid, normalized_coordinates) 返回指定归一化轴坐标下字形 ID 的宽度调整值。
`ItemVariationData`	ItemVariationData.from_reader 通过读取来自 BinaryReader 的二进制数据来创建一个 ItemVariationData 实例。
`ItemVariationStore`	ItemVariationStore.evaluate(delta_set_index, coordinates) 根据提供的归一化坐标计算可变字体轴的增量调整。
`KernTable`	KernTable.build_lookup() 创建一个字典，将 (left_gid, right_gid) 元组映射到字距值，以实现快速查找。
`LocaTable`	LocaTable.glyph_offset(gid) 返回给定字形 ID 在字体的 glyf 表中字形数据的字节偏移量。
`MaxpTable`	MaxpTable.to_bytes 返回 MaxpTable 的二进制编码.
`NameRecord`	NameRecord.platform_id 标识适用于该名称记录的平台.
`NameTable`	NameTable.language_key 返回给定 platform_id 和 language_id 的语言标签字符串.
`NamedInstance`	NamedInstance.name_id 是实例的名称记录的整数标识符.
`NamingPolicyPreview`	生成的静态实例名称记录的试运行结果。
`Os2Table`	Os2Table.from_reader(r, table_length) 从二进制读取器解析一个 OS/2 表，并返回一个 Os2Table 实例。
`PlatformNamingDiagnostics`	PlatformNamingDiagnostics 提供布尔标志和长度检查（例如 postscript_name_safe、postscript_name_length），以帮助确保生成的名称符合平台约束。
`PostTable`	PostTable.version 保存 post 表的版本号。
`StatNamingDiagnostics`	StatNamingDiagnostics 报告源字体是否包含 STAT 表，并为导出推荐适当的 stat_policy 设置。
`TtcFaceRecord`	TtcFaceRecord.offset 表示此面记录在 TTC 文件中的字节偏移量。
`TtfFont`	TtfFont.save(path) 将当前字体实例以其原生格式写入提供的文件系统路径。
`TtfGlyphParser`	TtfGlyphParser.parse 解析给定 GlyphId 标识的字形，并返回一个 Glyph 对象。
`TtfInstancer`	TtfInstancer.preview_naming_policy 根据给定的坐标和命名选项返回可变字体实例的命名预览。
`TtfTableSet`	TtfTableSet.get_raw 返回由给定标签标识的表的原始字节，如果不存在则返回 None。
`TupleVariation`	TupleVariation.peak_coords 保存定义变体峰值的轴坐标值。
`VariationRegion`	VariationRegion.scalar 基于给定的坐标映射和轴标签顺序返回该区域的标量值。
`VariationRegionAxis`	VariationRegionAxis.scalar(coordinate) 使用轴的 start、peak 和 end 属性，返回沿轴给定坐标的标量浮点值。

Type1 字体处理

类	描述
`AfmData`	AfmData.font_name 是从 AFM 文件中提取的字体的 PostScript 名称。
`AfmGlyphMetric`	AfmGlyphMetric 属性暴露了在 AFM 文件中定义的字形的字形名称、代码点、前进宽度和边界框。
`PfbSegment`	PfbSegment.seg_type 表示 PFB 文件中段类型的整数标识符。
`Type1Font`	Type1Font.load_afm 从给定路径加载 AFM 文件到 Type1Font 实例中。
`Type1FontData`	Type1FontData.full_name 是字体的完整可读名称。
`Type1Interpreter`	Type1Interpreter.interpret 解释 Type 1 charstring 并返回一个包含已消耗字节的 GlyphPath。

WOFF / WOFF2 处理

类	描述
`Woff2Font`	Woff2Font.to_bytes(font_type) 将 WOFF2 字体序列化为指定 font_type 的 bytes 对象。
`WoffFont`	WoffFont.font_type 返回此 WOFF 字体的 FontType 枚举值。

另请参阅

Aspose.Font — Enterprise API Reference