Aspose.Font FOSS для Python

API reference для Aspose.Font FOSS для Python v1.0.0. 139 публічних типів, організованих за модулем.

Основне API

КласОпис
ActiveTupleSummaryActiveTupleSummary.to_dict() повертає словник, що містить індекс кортежу, скалярне значення, координати піку, координати початку та координати кінця.
AnimationAssetAnimationAsset.write_to(path) записує згенеровані дані анімації у вказане розташування файлової системи, створює відсутні батьківські каталоги та повертає Path записаного файлу.
AnimationFramePackageAnimationFramePackage.write_to(path) записує зображення раскадровки, кожне зображення кадру та JSON маніфест, який описує fps і мітки кадрів, у вказаний каталог.
AnimationPresetAnimationPreset.name зберігає ідентифікатор пресету анімації.
AnimationPreviewBuilderAnimationPreviewBuilder.available_presets повертає кортеж назв пресетів для генерації анімації.
AnimationReviewPackageAnimationReviewPackage.write_to зберігає пакет огляду у вказаний шлях файлової системи та повертає Path.
AnimationShowcasePackageAnimationShowcasePackage.write_to записує пакет у вказаний шлях і повертає отриманий Path.
AnimationStepAnimationStep.coordinates зберігає відображення імен осей у значення типу float, що визначають екземпляр шрифту.
BinaryReaderОбгортає джерело байтів у придатний до перемотування BytesIO для парсингу двійкових даних шрифту у big-endian формі.
BinaryWriterНакопичує байти для бінарної серіалізації шрифту.
CffSerializerCffSerializer може серіалізувати повністю заповнений CffFont у масив байтів, придатний для запису у файл шрифту CFF або OpenType.
ClosePathКлас, що розширює PathCommand.
CompatibilityCheckerCompatibilityChecker.compare_fonts(before, after, before_label, after_label, codepoints, text) створює CompatibilityReport, який можна експортувати у JSON за допомогою report.to_json(indent=2, sort_keys=True).
CompatibilityReportCompatibilityReport.to_json(indent, sort_keys) повертає рядок JSON звіту, а write_json(target, indent, sort_keys) записує цей JSON безпосередньо у файл.
CompletedTaskRecordCompletedTaskRecord.task_id унікально ідентифікує завершене завдання.
CompositeComponentMovementCompositeComponentMovement.to_dict повертає dict числових та булевих полів об’єкта.
CompositeGlyphComponentCompositeGlyphComponent.to_dict() повертає dict числових атрибутів компонента.
CoverageGroupДіагностика покриття для одного джерела запиту, наприклад пресету, тексту або діапазону.
CurveAdapterCurveAdapter.quad_to_cubic перетворює квадратичну криву Безьє (p0, q, p3) на еквівалентну кубічну криву Безьє, повертаючи чотири точки.
CurveToCurveTo.x1 — це x‑координата першої контрольної точки Безьє.
DeltaInspectorDeltaInspector дозволяє детальний аналіз дельт змінних шрифтів, створюючи об’єкти GlyphDeltaReport та TextDeltaReport, які підкреслюють зміни координат між екземплярами.
DeltaPointDeltaPoint.to_dict повертає словник числових компонент точки.
DeltaTupleReportDeltaTupleReport.tuple_index — це індекс кортежа дельти, що нумерується з нуля.
EotSerializerEotSerializer.serialize(font) повертає повне бінарне представлення шрифту EOT, готове для запису у файл.
FamilyReviewExportPackageFamilyReviewExportPackage.write_to(directory) створює набір HTML, CSS та файлів маніфесту для сімейства шрифтів, повертаючи список згенерованих шляхів до файлів.
FontАбстрактний базовий клас для всіх реалізацій форматів шрифтів.
FontCleanerОчищувач метаданих шрифту та технічних таблиць.
FontConversionExceptionВикидається, коли конвертація формату шрифту не вдається або не підтримується.
FontConverterFontConverter.convert(font, target) створює новий об’єкт Font у цільовому форматі, викидаючи FontConversionException, якщо конверсія не може бути виконана.
FontEncodingВідображає Unicode-кодпоінти на ідентифікатори гліфів.
FontExceptionБазовий клас для всіх винятків бібліотеки шрифтів.
FontLoaderFontLoader.open(source, font_type, collection_index) повертає об’єкт Font, що представляє запитаний тип шрифту, не завантажуючи повністю весь файл у пам’ять.
FontMetricsFontMetrics надає ключові типографічні значення, такі як units_per_em, ascender, descender та line_gap, для розрахунків розмітки.
FontNotSupportedExceptionВикидається для дійсних, але не підтримуваних функцій шрифту (наприклад,
FontParseExceptionВикидається, коли бінарні дані шрифту не можуть бути розпарсені.
FontPreviewBuilder.build(font, text, size, color, background, padding, antialias, file_stem, instance_coordinates, instance_name, output_format) генерує PreviewImage (PNG або SVG) наданого тексту, відтвореного заданим шрифтом.
FontSourceInfoОпишіть походження завантажених байтів.
FontSubsetterFontSubsetter.available_presets() повертає кортеж заданих імен, які можна використовувати для веб‑орієнтованого підмножинування.
GlyphGlyph.glyph_id ідентифікує гліф, використовуючи його числовий GlyphId.
GlyphAccessorОтримує гліфи за ID або кодовою точкою Unicode.
GlyphCompatibilityIssueGlyphCompatibilityIssue.to_dict повертає словникове представлення випуску.
GlyphDeltaComparisonReportGlyphDeltaComparisonReport.moved_point_count — це кількість точок, які перемістились між «до» та «після».
GlyphDeltaReportGlyphDeltaReport.to_dict повертає словникове представлення даних звіту.
GlyphIdGlyphId.value містить ціле число-ідентифікатор гліфа.
GlyphInterpolationIssueGlyphInterpolationIssue.codepoint — це ціле число Unicode codepoint відповідного гліфа.
GlyphLayoutОдин гліф, розташований у координатах розмітки у світовому просторі.
GlyphNotFoundExceptionВикликається, коли запитаний ID гліфа або codepoint не має відображення у шрифті.
GlyphOutlineStatsGlyphOutlineStats.to_dict повертає словникове представлення статистики контуру.
GlyphPathВпорядкована послідовність об’єктів PathCommand, що представляє контур одного гліфа.
KernPairKernPair.left — це GlyphId лівого гліфа у парі кернінгу.
LanguageProfileLanguageProfile.to_dict повертає словникове представлення профілю мови.
LineToLineTo.x представляє горизонтальну координату кінцевої точки лінії.
LoadedFontДружній результат завантажувача, який обгортає шрифт та метадані джерела.
LocalizationCoverageLocalizationCoverage.to_dict повертає словникове представлення даних покриття.
LocalizationResolutionLocalizationResolution.to_dict повертає словникове представлення стану розв’язання.
MoveToMoveTo.x зберігає горизонтальну координату для операції переміщення.
PathCommandАбстрактний маркер для всіх типів команд шляху.
PreviewImagePreviewImage.write_to(path) зберігає згенерований PNG або SVG-попередній перегляд у вказане місце у файловій системі та повертає об’єкт Path.
QuadraticToQuadraticTo.x1 представляє x‑координату квадратичної контрольної точки Безьє.
RasterizerСкан-лінійний растеризатор для контурів GlyphPath з чистим-Python PNG-експортом.
RequestedLanguageHintRequestedLanguageHint.to_dict повертає словникове представлення об’єкта підказки.
ResolvedInstanceResolvedInstance.label — це зрозуміла для людини назва розв’язаної інстанції.
SmartInstancerSmartInstancer.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Вихід підмножини, упакований разом зі звітом про охоплення, використаним для його створення.
TaskCompletionReceiptTaskCompletionReceipt.task_id унікально ідентифікує завдання.
TaskTokenEstimateTaskTokenEstimate.task_id — унікальний ідентифікатор завдання.
TextDeltaComparisonReportTextDeltaComparisonReport.to_dict() повертає словник, що містить усі поля звіту.
TextDeltaReportTextDeltaReport агрегує інформацію про дельти на рівні гліфів, надаючи glyph_count, active_glyph_count та колекцію glyph_reports для QA‑перевірки.
TextLayoutРезультат виклику TextRenderer.layout().
TextRendererРозташовує текст, використовуючи метрики гліфів шрифту та необов’язкові пари кернінгу.
TtfSerializerTtfSerializer.serialize серіалізує даний об’єкт шрифту у масив байтів, за потреби використовуючи вказану версію sfnt.
TupleScalarDeltaTupleScalarDelta.to_dict() повертає dict з tuple_index, before_scalar та after_scalar значеннями.
Type1SerializerType1Serializer.serialize_pfb перетворює об’єкт шрифту у двійкові дані PFB.
UnsupportedFontFormatExceptionВикидається FontLoader, коли магічні байти файлу не розпізнані.
VariableAxisVariableAxis.normalize(value) повертає нормалізовану (0‑1) позицію необробленої координати осі відповідно до визначеного діапазону осі.
VariableAxisPresetVariableAxisPreset.to_presentation(axis) повертає словник метаданих презентації для пресету, придатний для відображення елементів керування пресетом у UI.
VariableInstanceVariableInstance.css_variation_settings(axes) створює кортеж CSS font-variation-settings рядків для даної колекції осей.
WebFontAssetWebFontAsset.filename зберігає оригінальну назву файлу шрифту як рядок.
WebFontBuilderWebFontBuilder може генерувати повні сімейства веб‑шрифтів з CSS, HTML сторінками попереднього перегляду та файлами маніфесту, готовими до розгортання.
WebFontBundleWebFontBundle.write_to записує пакет у каталог і повертає список записаних шляхів до файлів.
WebFontFamilyPackageWebFontFamilyPackage.write_to(directory) створює повний пакет сімейства, що містить CSS, HTML, маніфест і всі згруповані шрифтові ресурси для кількох варіантів стилю.

Перелік

ПерелікОпис
FontTypeFontType.TTF представляє формат шрифту TrueType.

Обробка шрифтів CFF

КласОпис
CffCharsetCffCharset.standard(num_glyphs) створює стандартний CFF charset для заданої кількості гліфів, а name_for(gid) повертає назву гліфа за ідентифікатором гліфа.
CffDictCffDict.from_bytes створює екземпляр CffDict з наданих двійкових даних.
CffEncodingCffEncoding.unicode_to_gid(codepoint) повертає GlyphId для Unicode-коду відповідно до поточного кодування CFF.
CffFontCffFont.get_kern_pairs() повертає список об’єктів KernPair, що представляють коригування кернінгу, визначені у шрифті.
CffIndexCffIndex.from_reader(r) створює екземпляр CffIndex шляхом аналізу даних з бінарного читача r.
PrivateDictPrivateDict.from_dict(d) створює екземпляр PrivateDict зі словника, що містить приватні записи, такі як default_width_x і nominal_width_x.
PrivateDictOpPrivateDictOp.BLUE_VALUES представляє BlueValues запис, який визначає зони вирівнювання для горизонтальних штрихів.
TopDictTopDict.from_dict(d, string_index) створює TopDict екземпляр із словникового представлення та таблиці індексів рядків, що дозволяє програмно відтворювати метадані шрифту верхнього рівня.
TopDictOpTopDictOp.VERSION представляє номер версії шрифту.
Type2InterpreterІнтерпретує Type 2 charstrings у команди GlyphPath.

Обробка шрифтів EOT

КласОпис
EotFontВбудований OpenType (EOT) обгортка над внутрішнім шрифтом TrueType/OpenType.
EotHeaderEotHeader.eot_size — це загальний розмір файлу EOT у байтах.

TrueType Обробка шрифтів

КласОпис
AvarAxisMapAvarAxisMap.mapping зберігає список кортежів (float, float), які визначають відображення вхідних‑вихідних значень для осі змінного шрифту.
AvarTableAvarTable.from_reader(r, length) створює AvarTable з бінарного читача, а map_normalized(axis_index, value) повертає відображений float для нормалізованої координати осі.
AxisRecordAxisRecord.tag зберігає чотирьохсимвольний ідентифікатор тегу осі (наприклад, ‘wght’).
CmapSubtableCmapSubtable.get_gid повертає glyph ID для Unicode codepoint або None, якщо не зіставлено.
CmapTableCmapTable.from_reader(r, table_length) розбирає cmap таблицю з потоку шрифту, а best_subtable() вибирає найбільш підходящий CmapSubtable для Unicode lookups.
DeltaSetIndexDeltaSetIndex.outer представляє зовнішній індексний компонент розташування набору дельт.
DeltaSetIndexMapDeltaSetIndexMap.from_reader(r) створює DeltaSetIndexMap з бінарного читача, а get(gid) отримує відповідний DeltaSetIndex.
FvarTableFvarTable.from_reader створює новий FvarTable, читаючи length байтів з BinaryReader.
GlyfTableGlyfTable.from_reader читає GlyfTable з BinaryReader, використовуючи вказану довжину, і повертає екземпляр GlyfTable.
GvarTableGvarTable.from_reader читає GvarTable з BinaryReader, використовуючи задану довжину та мітки осі.
HMetricКлас з 2 властивостями.
HeadTableHeadTable.from_reader читає BinaryReader і повертає заповнений екземпляр HeadTable.
HheaTableHheaTable.from_reader читає BinaryReader і створює об’єкт HheaTable.
HmtxTableHmtxTable.from_reader читає дані hmtx з BinaryReader і створює екземпляр HmtxTable.
HvarTableHvarTable.advance_width_delta(gid, normalized_coordinates) повертає корекцію ширини для ідентифікатора гліфа у зазначених нормалізованих координатах осі.
ItemVariationDataItemVariationData.from_reader створює екземпляр ItemVariationData шляхом читання бінарних даних з BinaryReader.
ItemVariationStoreItemVariationStore.evaluate(delta_set_index, coordinates) обчислює дельта‑корекцію для осі змінного шрифту на основі наданих нормалізованих координат.
KernTableKernTable.build_lookup() створює словник, що відображає кортежі (left_gid, right_gid) у значення кернінгу для швидкого пошуку.
LocaTableLocaTable.glyph_offset(gid) повертає байтовий зсув даних гліфа для заданого glyph ID у таблиці glyf шрифту.
MaxpTableMaxpTable.to_bytes повертає бінарне кодування MaxpTable.
NameRecordNameRecord.platform_id ідентифікує платформу, для якої застосовується запис імені.
NameTableNameTable.language_key повертає рядок мітки мови для заданих platform_id та language_id.
NamedInstanceNamedInstance.name_id є цілим ідентифікатором запису імені екземпляра.
NamingPolicyPreviewРезультат пробного запуску для згенерованих записів імен статичних екземплярів.
Os2TableOs2Table.from_reader(r, table_length) розбирає таблицю OS/2 з бінарного читача та повертає екземпляр Os2Table.
PlatformNamingDiagnosticsPlatformNamingDiagnostics надає булеві прапорці та перевірки довжини (наприклад, postscript_name_safe, postscript_name_length), щоб допомогти забезпечити, що згенеровані імена відповідають обмеженням платформи.
PostTablePostTable.version містить номер версії таблиці post.
StatNamingDiagnosticsStatNamingDiagnostics повідомляє, чи містить вихідний шрифт таблиці STAT, і рекомендує відповідні налаштування stat_policy для експорту.
TtcFaceRecordTtcFaceRecord.offset представляє байтовий зсув цього запису face у файлі TTC.
TtfFontTtfFont.save(path) записує поточний екземпляр шрифту у вказаний файловий шлях у його рідному форматі.
TtfGlyphParserTtfGlyphParser.parse аналізує гліф, ідентифікований заданим GlyphId, і повертає об’єкт Glyph.
TtfInstancerTtfInstancer.preview_naming_policy повертає попередній перегляд назви для екземпляра змінного шрифту на основі заданих координат і параметрів назви.
TtfTableSetTtfTableSet.get_raw повертає необроблені байти таблиці, ідентифікованої заданим тегом, або None, якщо її немає.
TupleVariationTupleVariation.peak_coords містить значення координат осі, що визначають пікову варіацію.
VariationRegionVariationRegion.scalar повертає скалярне значення для регіону на основі заданого відображення координат і порядку тегів осі.
VariationRegionAxisVariationRegionAxis.scalar(coordinate) повертає скалярне значення типу float для заданої координати вздовж осі, використовуючи властивості start, peak і end осі.

Обробка шрифтів Type1

КласОпис
AfmDataAfmData.font_name — це PostScript назва шрифту, витягнута з файлу AFM.
AfmGlyphMetricAfmGlyphMetric властивості розкривають назву гліфа, кодову точку, ширину кроку та обмежувальний прямокутник для гліфа, визначеного у файлі AFM.
PfbSegmentPfbSegment.seg_type представляє ціле число-ідентифікатор типу сегмента у файлі PFB.
Type1FontType1Font.load_afm завантажує файл AFM за вказаним шляхом у екземпляр Type1Font.
Type1FontDataType1FontData.full_name — це повна людсько‑читана назва шрифту.
Type1InterpreterType1Interpreter.interpret інтерпретує Type 1 charstring і повертає GlyphPath з кількістю спожитих байтів.

Обробка WOFF / WOFF2

КласОпис
Woff2FontWoff2Font.to_bytes(font_type) серіалізує шрифт WOFF2 у об’єкт bytes для вказаного font_type.
WoffFontWoffFont.font_type повертає значення перерахування FontType цього шрифту WOFF.

Дивіться також

 Українська