Aspose.Font FOSS dla Python

API reference dla Aspose.Font FOSS dla Python v1.0.0. 139 publicznych typów uporządkowanych według modułu.

Podstawowe API

KlasaOpis
ActiveTupleSummaryActiveTupleSummary.to_dict() zwraca słownik zawierający indeks krotki, wartość skalarną, współrzędne szczytu, współrzędne początkowe oraz współrzędne końcowe.
AnimationAssetAnimationAsset.write_to(path) zapisuje wygenerowane dane animacji w podanej lokalizacji systemu plików, tworzy brakujące katalogi nadrzędne i zwraca ścieżkę zapisanego pliku.
AnimationFramePackageAnimationFramePackage.write_to(path) zapisuje obraz storyboardu, każdy obraz klatki oraz manifest JSON opisujący fps i etykiety klatek w określonym katalogu.
AnimationPresetAnimationPreset.name przechowuje identyfikator presetu animacji.
AnimationPreviewBuilderAnimationPreviewBuilder.available_presets zwraca krotkę nazw presetów do generowania animacji.
AnimationReviewPackageAnimationReviewPackage.write_to zapisuje pakiet przeglądu w podanej ścieżce systemu plików i zwraca obiekt Path.
AnimationShowcasePackageAnimationShowcasePackage.write_to zapisuje pakiet do podanej ścieżki i zwraca wynikowy Path.
AnimationStepAnimationStep.coordinates przechowuje mapowanie nazw osi na wartości float definiujące instancję czcionki.
BinaryReaderOpakowuje źródło bajtów w seekable BytesIO do parsowania binarnego czcionki w formacie big-endian.
BinaryWriterGromadzi bajty do binarnej serializacji czcionki.
CffSerializerCffSerializer może serializować w pełni wypełniony CffFont do tablicy bajtów odpowiedniej do zapisania jako plik czcionki CFF lub OpenType.
ClosePathKlasa rozszerzająca PathCommand.
CompatibilityCheckerCompatibilityChecker.compare_fonts(before, after, before_label, after_label, codepoints, text) tworzy CompatibilityReport, który może być wyeksportowany do JSON za pomocą report.to_json(indent=2, sort_keys=True).
CompatibilityReportCompatibilityReport.to_json(indent, sort_keys) zwraca ciąg znaków JSON raportu, a write_json(target, indent, sort_keys) zapisuje ten JSON bezpośrednio do pliku.
CompletedTaskRecordCompletedTaskRecord.task_id jednoznacznie identyfikuje zakończone zadanie.
CompositeComponentMovementCompositeComponentMovement.to_dict zwraca słownik z numerycznymi i logicznymi polami obiektu.
CompositeGlyphComponentCompositeGlyphComponent.to_dict() zwraca słownik atrybutów liczbowych komponentu.
CoverageGroupDiagnostyka pokrycia dla jednego źródła żądania, takiego jak preset, tekst lub zakres.
CurveAdapterCurveAdapter.quad_to_cubic konwertuje kwadratową krzywą Bézier (p0, q, p3) na równoważną sześcienną krzywą Bézier, zwracając cztery punkty.
CurveToCurveTo.x1 jest współrzędną x pierwszego punktu kontrolnego Bézier.
DeltaInspectorDeltaInspector umożliwia szczegółową analizę delta zmiennych‑czcionek, generując obiekty GlyphDeltaReport i TextDeltaReport, które uwidaczniają zmiany współrzędnych pomiędzy instancjami.
DeltaPointDeltaPoint.to_dict zwraca słownik numerycznych składników punktu.
DeltaTupleReportDeltaTupleReport.tuple_index jest zerowym indeksem krotki delta.
EotSerializerEotSerializer.serialize(font) zwraca pełną binarną reprezentację czcionki EOT gotową do zapisu w pliku.
FamilyReviewExportPackageFamilyReviewExportPackage.write_to(directory) tworzy zestaw HTML, CSS oraz plików manifestu dla rodziny czcionek, zwracając listę wygenerowanych ścieżek plików.
FontAbstrakcyjna klasa bazowa dla wszystkich implementacji formatów czcionek.
FontCleanerMetadane czcionki i czyszczenie tabeli technicznej.
FontConversionExceptionZgłaszany, gdy konwersja formatu czcionki nie powiedzie się lub nie jest obsługiwana.
FontConverterFontConverter.convert(font, target) tworzy nowy obiekt Font w formacie docelowym, rzucając FontConversionException, jeśli konwersja nie może zostać wykonana.
FontEncodingMapuje punkty kodowe Unicode na identyfikatory glifów.
FontExceptionKlasa bazowa dla wszystkich wyjątków biblioteki czcionek.
FontLoaderFontLoader.open(source, font_type, collection_index) zwraca obiekt Font reprezentujący żądany typ czcionki bez pełnego wczytywania całego pliku do pamięci.
FontMetricsFontMetrics udostępnia kluczowe wartości typograficzne, takie jak units_per_em, ascender, descender i line_gap, do obliczeń układu.
FontNotSupportedExceptionZgłaszane w przypadku prawidłowych, ale nieobsługiwanych funkcji czcionki (np.
FontParseExceptionZgłaszane, gdy nie można sparsować binarnych danych czcionki.
FontPreviewBuilderFontPreviewBuilder.build(font, text, size, color, background, padding, antialias, file_stem, instance_coordinates, instance_name, output_format) generuje PreviewImage (PNG lub SVG) dostarczonego tekstu renderowanego przy użyciu podanej czcionki.
FontSourceInfoOpisz pochodzenie załadowanych bajtów.
FontSubsetterFontSubsetter.available_presets() zwraca krotkę nazw presetów, które mogą być użyte do podzestawiania zorientowanego na sieć.
GlyphGlyph.glyph_id identyfikuje glif przy użyciu jego numerycznego GlyphId.
GlyphAccessorPobiera glify według ID lub kodu Unicode.
GlyphCompatibilityIssueGlyphCompatibilityIssue.to_dict zwraca słownikową reprezentację problemu.
GlyphDeltaComparisonReportGlyphDeltaComparisonReport.moved_point_count jest liczbą punktów, które przemieściły się pomiędzy przed i po.
GlyphDeltaReportGlyphDeltaReport.to_dict zwraca słownikową reprezentację danych raportu.
GlyphIdGlyphId.value przechowuje całkowity identyfikator glifu.
GlyphInterpolationIssueGlyphInterpolationIssue.codepoint jest całkowitym kodem Unicode glifu, którego dotyczy.
GlyphLayoutPojedynczy glif umieszczony w współrzędnych układu w przestrzeni świata.
GlyphNotFoundExceptionZgłaszane, gdy żądany identyfikator glifu lub kod punktu nie ma mapowania w czcionce.
GlyphOutlineStatsGlyphOutlineStats.to_dict zwraca słownikową reprezentację statystyk konturu.
GlyphPathUporządkowana sekwencja obiektów PathCommand przedstawiających kontur jednego glifu.
KernPairKernPair.left jest GlyphId lewego glifu w parze kerningowej.
LanguageProfileLanguageProfile.to_dict zwraca słownikową reprezentację profilu językowego.
LineToLineTo.x reprezentuje współrzędną poziomą punktu końcowego linii.
LoadedFontPrzyjazny wynik ładowarki, który obejmuje czcionkę oraz metadane źródła.
LocalizationCoverageLocalizationCoverage.to_dict zwraca słownikową reprezentację danych pokrycia.
LocalizationResolutionLocalizationResolution.to_dict zwraca słownikową reprezentację stanu rozdzielczości.
MoveToMoveTo.x przechowuje współrzędną poziomą dla operacji przemieszczenia.
PathCommandAbstrakcyjny znacznik dla wszystkich typów poleceń ścieżki.
PreviewImagePreviewImage.write_to(path) zapisuje wygenerowany podgląd PNG lub SVG w określonym miejscu w systemie plików i zwraca obiekt Path.
QuadraticToQuadraticTo.x1 reprezentuje współrzędną x punktu kontrolnego krzywej kwadratowej Béziera.
RasterizerRasteryzator skanowy dla konturów GlyphPath z czystym eksportem PNG pure-Python.
RequestedLanguageHintRequestedLanguageHint.to_dict zwraca słownikową reprezentację obiektu podpowiedzi.
ResolvedInstanceResolvedInstance.label jest czytelną dla człowieka nazwą rozwiązanej instancji.
SmartInstancerSmartInstancer.instantiate(coordinates, instance_name, naming_strategy, family_suffix, legacy_family_name, typographic_family_name, legacy_style_name, typographic_style_name, stat_policy) zwraca obiekt TtfFont reprezentujący statyczną instancję zmiennej czcionki.
SubsetCoverageZagreguj diagnostykę pokrycia Unicode dla żądania podzbioru.
SubsetResultPodzestawianie wyjścia dołączonego do raportu pokrycia używanego do jego wygenerowania.
TaskCompletionReceiptTaskCompletionReceipt.task_id jednoznacznie identyfikuje zadanie.
TaskTokenEstimateTaskTokenEstimate.task_id jest unikalnym identyfikatorem zadania.
TextDeltaComparisonReportTextDeltaComparisonReport.to_dict() zwraca słownik zawierający wszystkie pola raportu.
TextDeltaReportTextDeltaReport agreguje informacje o delta na poziomie glifu, udostępniając glyph_count, active_glyph_count oraz zbiór glyph_reports do inspekcji QA.
TextLayoutWynik wywołania TextRenderer.layout().
TextRendererUkłada tekst przy użyciu metryk glifów czcionki i opcjonalnych par kerningowych.
TtfSerializerTtfSerializer.serialize serializuje podany obiekt czcionki do tablicy bajtów, opcjonalnie używając podanej wersji sfnt.
TupleScalarDeltaTupleScalarDelta.to_dict() zwraca słownik z wartościami tuple_index, before_scalar oraz after_scalar.
Type1SerializerType1Serializer.serialize_pfb konwertuje obiekt czcionki na binarne dane PFB.
UnsupportedFontFormatExceptionPodnoszone przez FontLoader, gdy bajty magiczne pliku nie są rozpoznawane.
VariableAxisVariableAxis.normalize(value) zwraca znormalizowaną pozycję (0‑1) surowej współrzędnej osi zgodnie z określonym zakresem osi.
VariableAxisPresetVariableAxisPreset.to_presentation(axis) zwraca słownik metadanych prezentacji dla presetu, odpowiedni do renderowania kontrolek presetu w interfejsie użytkownika.
VariableInstanceVariableInstance.css_variation_settings(axes) tworzy krotkę łańcuchów znaków CSS font-variation-settings dla podanej kolekcji osi.
WebFontAssetWebFontAsset.filename przechowuje oryginalną nazwę pliku czcionki jako ciąg znaków.
WebFontBuilderWebFontBuilder może generować kompletne rodziny czcionek internetowych z CSS, HTML stronami podglądu i plikami manifestu gotowymi do wdrożenia.
WebFontBundleWebFontBundle.write_to zapisuje pakiet do katalogu i zwraca listę zapisanych ścieżek plików.
WebFontFamilyPackageWebFontFamilyPackage.write_to(directory) tworzy kompletny pakiet rodziny zawierający CSS, HTML, manifest oraz wszystkie zgrupowane zasoby czcionek dla wielu wariantów stylu.

Wyliczenia

WyliczenieOpis
FontTypeFontType.TTF reprezentuje format czcionki TrueType.

Obsługa czcionek CFF

KlasaOpis
CffCharsetCffCharset.standard(num_glyphs) tworzy standardowy zestaw znaków CFF dla podanej liczby glifów, a name_for(gid) zwraca nazwę glifu dla identyfikatora glifu.
CffDictCffDict.from_bytes tworzy instancję CffDict z podanych danych binarnych.
CffEncodingCffEncoding.unicode_to_gid(codepoint) zwraca GlyphId dla punktu kodowego Unicode zgodnie z bieżącym kodowaniem CFF.
CffFontCffFont.get_kern_pairs() zwraca listę obiektów KernPair reprezentujących korekty kerningu zdefiniowane w czcionce.
CffIndexCffIndex.from_reader(r) tworzy instancję CffIndex poprzez parsowanie danych z binarnego czytnika r.
PrivateDictPrivateDict.from_dict(d) tworzy instancję PrivateDict z słownika zawierającego prywatne wpisy słownika, takie jak default_width_x i nominal_width_x.
PrivateDictOpPrivateDictOp.BLUE_VALUES reprezentuje wpis BlueValues definiujący strefy wyrównania dla poziomych prętów.
TopDictTopDict.from_dict(d, string_index) tworzy instancję TopDict z reprezentacji słownika i tabeli indeksów łańcuchów, umożliwiając programowe odtworzenie metadanych czcionki na najwyższym poziomie.
TopDictOpTopDictOp.VERSION reprezentuje numer wersji czcionki.
Type2InterpreterInterpretuję ciągi znaków Type 2 na polecenia GlyphPath.

Obsługa czcionek EOT

KlasaOpis
EotFontOsadzony OpenType (EOT) wrapper nad wewnętrzną czcionką TrueType/OpenType.
EotHeaderEotHeader.eot_size jest całkowitym rozmiarem pliku EOT w bajtach.

TrueType Obsługa czcionek

KlasaOpis
AvarAxisMapAvarAxisMap.mapping przechowuje listę krotek (float, float), które definiują mapowania wartości wejściowych‑wyjściowych dla osi zmiennej czcionki.
AvarTableAvarTable.from_reader(r, length) konstruuje AvarTable z czytnika binarnego, a map_normalized(axis_index, value) zwraca zmapowaną wartość float dla znormalizowanej współrzędnej osi.
AxisRecordAxisRecord.tag przechowuje czteroznakowy identyfikator tagu osi (np. ‘wght’).
CmapSubtableCmapSubtable.get_gid zwraca identyfikator glifu dla punktu kodowego Unicode lub None, jeśli nie jest mapowany.
CmapTableCmapTable.from_reader(r, table_length) analizuje tabelę cmap z strumienia czcionki, a best_subtable() wybiera najbardziej odpowiedni CmapSubtable do wyszukiwań Unicode.
DeltaSetIndexDeltaSetIndex.outer reprezentuje zewnętrzny komponent indeksu lokalizacji zestawu delta.
DeltaSetIndexMapDeltaSetIndexMap.from_reader(r) tworzy DeltaSetIndexMap z czytnika binarnego, a get(gid) zwraca odpowiadający DeltaSetIndex.
FvarTableFvarTable.from_reader tworzy nowy FvarTable, odczytując length bajtów z BinaryReader.
GlyfTableGlyfTable.from_reader odczytuje GlyfTable z BinaryReader przy użyciu określonej długości i zwraca instancję GlyfTable.
GvarTableGvarTable.from_reader odczytuje GvarTable z BinaryReader przy użyciu podanej długości i znaczników osi.
HMetricKlasa z 2 właściwościami.
HeadTableHeadTable.from_reader odczytuje BinaryReader i zwraca wypełnioną instancję HeadTable.
HheaTableHheaTable.from_reader odczytuje BinaryReader i tworzy obiekt HheaTable.
HmtxTableHmtxTable.from_reader odczytuje dane hmtx z BinaryReader i tworzy instancję HmtxTable.
HvarTableHvarTable.advance_width_delta(gid, normalized_coordinates) zwraca korektę szerokości dla identyfikatora glifu przy określonych znormalizowanych współrzędnych osi.
ItemVariationDataItemVariationData.from_reader tworzy instancję ItemVariationData poprzez odczyt danych binarnych z BinaryReader.
ItemVariationStoreItemVariationStore.evaluate(delta_set_index, coordinates) oblicza korektę delta dla osi zmiennej czcionki na podstawie dostarczonych znormalizowanych współrzędnych.
KernTableKernTable.build_lookup() tworzy słownik mapujący krotki (left_gid, right_gid) na wartości kerningu w celu szybkiego wyszukiwania.
LocaTableLocaTable.glyph_offset(gid) zwraca offset w bajtach danych glifu dla podanego identyfikatora glifu w tabeli glyf czcionki.
MaxpTableMaxpTable.to_bytes zwraca binarne kodowanie MaxpTable.
NameRecordNameRecord.platform_id identyfikuje platformę, dla której rekord nazwy ma zastosowanie.
NameTableNameTable.language_key zwraca ciąg znacznika języka dla podanych platform_id i language_id.
NamedInstanceNamedInstance.name_id jest całkowitym identyfikatorem rekordu nazwy instancji.
NamingPolicyPreviewWynik symulacji dla wygenerowanych rekordów nazw statycznych instancji.
Os2TableOs2Table.from_reader(r, table_length) parsuje tabelę OS/2 z binarnego czytnika i zwraca instancję Os2Table.
PlatformNamingDiagnosticsPlatformNamingDiagnostics zapewnia flagi logiczne i kontrole długości (np. postscript_name_safe, postscript_name_length), aby pomóc zapewnić, że generowane nazwy spełniają ograniczenia platformy.
PostTablePostTable.version przechowuje numer wersji tabeli post.
StatNamingDiagnosticsStatNamingDiagnostics zgłasza, czy czcionka źródłowa zawiera tabele STAT i zaleca odpowiednie ustawienia stat_policy przy eksporcie.
TtcFaceRecordTtcFaceRecord.offset reprezentuje bajtowy offset tego rekordu twarzy w pliku TTC.
TtfFontTtfFont.save(path) zapisuje bieżącą instancję czcionki do podanej ścieżki systemu plików w jej natywnym formacie.
TtfGlyphParserTtfGlyphParser.parse analizuje glif zidentyfikowany przez podany GlyphId i zwraca obiekt Glyph.
TtfInstancerTtfInstancer.preview_naming_policy zwraca podgląd nazewnictwa dla instancji czcionki zmiennej na podstawie podanych współrzędnych i opcji nazewnictwa.
TtfTableSetTtfTableSet.get_raw zwraca surowe bajty tabeli zidentyfikowanej przez podany tag, lub None jeśli nie istnieje.
TupleVariationTupleVariation.peak_coords przechowuje wartości współrzędnych osi definiujące szczyt wariacji.
VariationRegionVariationRegion.scalar zwraca wartość skalarną dla regionu na podstawie podanej mapy współrzędnych i kolejności tagów osi.
VariationRegionAxisVariationRegionAxis.scalar(coordinate) zwraca zmiennoprzecinkową wartość skalarną dla danej współrzędnej wzdłuż osi, wykorzystując właściwości start, peak i end osi.

Obsługa czcionek Type1

KlasaOpis
AfmDataAfmData.font_name jest PostScript nazwą czcionki wyodrębnioną z pliku AFM.
AfmGlyphMetricAfmGlyphMetric właściwości ujawniają nazwę glifu, kod punktu, szerokość wyprzedzenia i ramkę ograniczającą dla glifu zdefiniowanego w pliku AFM.
PfbSegmentPfbSegment.seg_type reprezentuje całkowity identyfikator typu segmentu w pliku PFB.
Type1FontType1Font.load_afm ładuje plik AFM z podanej ścieżki do instancji Type1Font.
Type1FontDataType1FontData.full_name jest pełną, czytelną dla człowieka nazwą czcionki.
Type1InterpreterType1Interpreter.interpret interpretuje charstring Type 1 i zwraca GlyphPath z zużytymi bajtami.

Obsługa WOFF / WOFF2

KlasaOpis
Woff2FontWoff2Font.to_bytes(font_type) serializuje czcionkę WOFF2 do obiektu bytes dla określonego font_type.
WoffFontWoffFont.font_type zwraca wartość wyliczenia FontType tej czcionki WOFF.

Zobacz także

 Polski