fontisan 0.4.49-aarch64-linux
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.rspec +3 -0
- data/.rubocop.yml +141 -0
- data/.rubocop_todo.yml +433 -0
- data/BENCHMARKS.md +56 -0
- data/BUG-stitcher-drops-isolated-cps.md +58 -0
- data/BUG-stitcher-drops-plane1-codepoints.md +310 -0
- data/BUG-stitcher-gid-cap-65535.md +110 -0
- data/CHANGELOG.md +293 -0
- data/Gemfile +40 -0
- data/LICENSE +28 -0
- data/README.adoc +2811 -0
- data/Rakefile +156 -0
- data/TODO.bug-fixes/01-cff-expert-charsets.md +27 -0
- data/TODO.bug-fixes/02-cff2-subroutine-stubs.md +32 -0
- data/TODO.bug-fixes/03-variation-subsetter-placeholders.md +42 -0
- data/TODO.bug-fixes/04-ufo-image-compile-roundtrip.md +28 -0
- data/TODO.bug-fixes/05-stale-cff-comment.md +18 -0
- data/TODO.bug-fixes/06-instance-woff2-output.md +24 -0
- data/TODO.bug-fixes/07-encapsulation-violations.md +38 -0
- data/TODO.bug-fixes/08-respond-to-violations.md +25 -0
- data/TODO.bug-fixes/09-type1-cff-seac-expansion.md +22 -0
- data/TODO.bug-fixes/10-ttf-type1-composite-glyphs.md +23 -0
- data/TODO.bug-fixes/11-remaining-respond-to.md +25 -0
- data/TODO.bug-fixes/12-type1-generators-duck-typing.md +80 -0
- data/TODO.bug-fixes/13-hint-extractor-duck-typing.md +30 -0
- data/TODO.bug-fixes/14-font-interface-type-checks.md +82 -0
- data/TODO.bug-fixes/15-glyph-type-checks-and-simple-glyph-points-bug.md +49 -0
- data/TODO.bug-fixes/16-variation-table-checks.md +31 -0
- data/TODO.bug-fixes/17-ufo-and-stitcher-cleanup.md +32 -0
- data/TODO.bug-fixes/18-generic-value-and-io-checks.md +56 -0
- data/TODO.bug-fixes/19-serialization-migration.md +52 -0
- data/TODO.bug-fixes/20-variation-validator-type-checks.md +29 -0
- data/TODO.bug-fixes/21-xml-builder-send.md +24 -0
- data/TODO.bug-fixes/22-type1-converter-font-info.md +25 -0
- data/TODO.bug-fixes/23-boundary-type-checks.md +31 -0
- data/TODO.bug-fixes/24-validator-dynamic-field-key.md +25 -0
- data/TODO.bug-fixes/25-serialization-migration.md +49 -0
- data/TODO.bug-fixes/26-variation-preserver-spec-migration.md +25 -0
- data/TODO.bug-fixes/27-table-class-registry.md +50 -0
- data/TODO.bug-fixes/28-spec-doubles-cleanup.md +40 -0
- data/TODO.bug-fixes/29-strategy-registries.md +30 -0
- data/TODO.bug-fixes/30-eliminate-send-in-specs.md +36 -0
- data/TODO.bug-fixes/README.md +52 -0
- data/TODO.improvements/01-cbdt-cblc-gid-stable-propagation.md +73 -0
- data/TODO.improvements/02-collection-outline-priority.md +48 -0
- data/TODO.improvements/03-fontisan-audit-command.md +219 -0
- data/TODO.improvements/04-ufo-composite-glyph-encoding.md +46 -0
- data/TODO.improvements/05-otf-compiler-real-cff.md +63 -0
- data/TODO.improvements/06-cff2-blend-vsindex-operators.md +51 -0
- data/TODO.improvements/07-cpal-v1-header-fields.md +71 -0
- data/TODO.improvements/08-cff-standard-string-table.md +52 -0
- data/TODO.improvements/09-type1-seac-expansion.md +57 -0
- data/TODO.improvements/10-ufo-image-set-feature-writers.md +71 -0
- data/TODO.improvements/11-kern-groups-plist.md +49 -0
- data/TODO.improvements/12-cbdt-fixture-bindata-conversion.md +68 -0
- data/TODO.improvements/13-split-octokit-fetcher.md +45 -0
- data/TODO.improvements/14-rubocop-baseline-chip.md +62 -0
- data/TODO.improvements/15-cff-cff2-subsetter-strategy.md +78 -0
- data/TODO.improvements/README.md +58 -0
- data/benchmark/baseline.json +5 -0
- data/benchmark/ci_gate.rb +217 -0
- data/benchmark/compile_benchmark.rb +78 -0
- data/benchmark/corpus/harness.rb +175 -0
- data/benchmark/corpus/ops.rb +150 -0
- data/benchmark/corpus/run.rb +182 -0
- data/benchmark/corpus/scan_child.rb +8 -0
- data/benchmark/corpus/tiers.rb +176 -0
- data/benchmark/tier_baseline.json +12 -0
- data/benchmark/variation_quick_bench.rb +47 -0
- data/build_mingw32_stub.rb +15 -0
- data/docs/.gitignore +17 -0
- data/docs/.vitepress/config.ts +373 -0
- data/docs/.vitepress/theme/components/ApiMethod.vue +127 -0
- data/docs/.vitepress/theme/components/Badge.vue +51 -0
- data/docs/.vitepress/theme/components/FeatureComparison.vue +87 -0
- data/docs/.vitepress/theme/components/HeroCodeBlock.vue +98 -0
- data/docs/.vitepress/theme/components/WithinHero.vue +30 -0
- data/docs/.vitepress/theme/index.ts +22 -0
- data/docs/.vitepress/theme/style.css +628 -0
- data/docs/AFDKO_MIGRATION.adoc +175 -0
- data/docs/APPLE_LEGACY_FONTS.adoc +173 -0
- data/docs/CFF2_SUPPORT.adoc +184 -0
- data/docs/COLLECTION_VALIDATION.adoc +204 -0
- data/docs/COLOR_FONTS.adoc +127 -0
- data/docs/CONVERSION_GUIDE.adoc +656 -0
- data/docs/EXTRACT_TTC_MIGRATION.md +549 -0
- data/docs/FEATURE_PARITY.adoc +263 -0
- data/docs/FONT_HINTING.adoc +570 -0
- data/docs/STITCHER_GUIDE.adoc +436 -0
- data/docs/SVG_TO_GLYF.adoc +118 -0
- data/docs/TTX.adoc +176 -0
- data/docs/TYPE1_FONTS.adoc +445 -0
- data/docs/UFO_COMPILATION.adoc +397 -0
- data/docs/VALIDATION.adoc +254 -0
- data/docs/VARIABLE_FONT_OPERATIONS.adoc +599 -0
- data/docs/WOFF_WOFF2_FORMATS.adoc +220 -0
- data/docs/api/conversion-options.md +164 -0
- data/docs/api/converters/curve-converter.md +34 -0
- data/docs/api/converters/hint-converter.md +34 -0
- data/docs/api/converters/outline-converter.md +27 -0
- data/docs/api/font-loader.md +117 -0
- data/docs/api/font-writer.md +103 -0
- data/docs/api/index.md +79 -0
- data/docs/api/layer.md +89 -0
- data/docs/api/models/glyph-accessor.md +43 -0
- data/docs/api/models/glyph.md +40 -0
- data/docs/api/models/table-analyzer.md +35 -0
- data/docs/api/sfnt-font.md +53 -0
- data/docs/api/type1-font.md +43 -0
- data/docs/api/validators/font-validator.md +31 -0
- data/docs/api/validators/helper.md +36 -0
- data/docs/api/validators/profile.md +39 -0
- data/docs/cli/convert.md +148 -0
- data/docs/cli/dump-table.md +110 -0
- data/docs/cli/export.md +176 -0
- data/docs/cli/features.md +124 -0
- data/docs/cli/glyphs.md +90 -0
- data/docs/cli/index.md +232 -0
- data/docs/cli/info.md +254 -0
- data/docs/cli/instance.md +122 -0
- data/docs/cli/ls.md +95 -0
- data/docs/cli/optical-size.md +94 -0
- data/docs/cli/pack.md +125 -0
- data/docs/cli/scripts.md +105 -0
- data/docs/cli/subset.md +58 -0
- data/docs/cli/tables.md +84 -0
- data/docs/cli/unicode.md +101 -0
- data/docs/cli/validate-collection.md +95 -0
- data/docs/cli/validate.md +56 -0
- data/docs/cli/variable.md +126 -0
- data/docs/cli/version.md +46 -0
- data/docs/guide/cli/convert.md +108 -0
- data/docs/guide/cli/export.md +138 -0
- data/docs/guide/cli/index.md +99 -0
- data/docs/guide/cli/info.md +144 -0
- data/docs/guide/cli/pack.md +155 -0
- data/docs/guide/cli/subset.md +149 -0
- data/docs/guide/cli/validate.md +139 -0
- data/docs/guide/color-fonts/bitmaps.md +194 -0
- data/docs/guide/color-fonts/colr-cpal.md +175 -0
- data/docs/guide/color-fonts/index.md +140 -0
- data/docs/guide/color-fonts/svg.md +154 -0
- data/docs/guide/color.md +51 -0
- data/docs/guide/comparisons/font-validator.md +222 -0
- data/docs/guide/comparisons/fonttools.md +200 -0
- data/docs/guide/comparisons/index.md +83 -0
- data/docs/guide/comparisons/lcdf-typetools.md +205 -0
- data/docs/guide/contributing.md +279 -0
- data/docs/guide/conversion/collections.md +251 -0
- data/docs/guide/conversion/curves.md +246 -0
- data/docs/guide/conversion/index.md +157 -0
- data/docs/guide/conversion/options.md +280 -0
- data/docs/guide/conversion/ttf-otf.md +184 -0
- data/docs/guide/conversion/type1.md +208 -0
- data/docs/guide/conversion/web.md +299 -0
- data/docs/guide/conversion.md +40 -0
- data/docs/guide/engines.md +117 -0
- data/docs/guide/formats/collections.md +147 -0
- data/docs/guide/formats/dfont.md +99 -0
- data/docs/guide/formats/index.md +65 -0
- data/docs/guide/formats/otf.md +103 -0
- data/docs/guide/formats/svg.md +97 -0
- data/docs/guide/formats/ttf.md +105 -0
- data/docs/guide/formats/type1.md +118 -0
- data/docs/guide/formats/woff.md +139 -0
- data/docs/guide/hinting/autohint.md +141 -0
- data/docs/guide/hinting/conversion.md +161 -0
- data/docs/guide/hinting/index.md +86 -0
- data/docs/guide/hinting/postscript.md +149 -0
- data/docs/guide/hinting/truetype.md +135 -0
- data/docs/guide/hinting.md +44 -0
- data/docs/guide/index.md +152 -0
- data/docs/guide/installation.md +116 -0
- data/docs/guide/migrations/extract-ttc.md +549 -0
- data/docs/guide/migrations/font-validator.md +260 -0
- data/docs/guide/migrations/fonttools.md +208 -0
- data/docs/guide/migrations/index.md +64 -0
- data/docs/guide/migrations/otfinfo.md +197 -0
- data/docs/guide/quick-start.md +204 -0
- data/docs/guide/type1.md +58 -0
- data/docs/guide/universal-outline.md +151 -0
- data/docs/guide/validation/custom.md +195 -0
- data/docs/guide/validation/helpers.md +188 -0
- data/docs/guide/validation/index.md +132 -0
- data/docs/guide/validation/profiles.md +156 -0
- data/docs/guide/validation.md +47 -0
- data/docs/guide/variable-fonts/advanced.md +231 -0
- data/docs/guide/variable-fonts/axes.md +209 -0
- data/docs/guide/variable-fonts/conversion.md +197 -0
- data/docs/guide/variable-fonts/index.md +84 -0
- data/docs/guide/variable-fonts/instances.md +187 -0
- data/docs/guide/variable-fonts/named-instances.md +194 -0
- data/docs/guide/variable-fonts/static.md +168 -0
- data/docs/guide/variable.md +58 -0
- data/docs/guide/woff.md +61 -0
- data/docs/index.md +136 -0
- data/docs/lychee.toml +41 -0
- data/docs/package-lock.json +2560 -0
- data/docs/package.json +15 -0
- data/docs/public/apple-touch-icon.png +0 -0
- data/docs/public/favicon-96x96.png +0 -0
- data/docs/public/favicon.ico +0 -0
- data/docs/public/favicon.svg +1 -0
- data/docs/public/logo-full.svg +1 -0
- data/docs/public/logo.svg +1 -0
- data/docs/public/robots.txt +4 -0
- data/docs/public/site.webmanifest +21 -0
- data/docs/public/web-app-manifest-192x192.png +0 -0
- data/docs/public/web-app-manifest-512x512.png +0 -0
- data/docs/reference-facade.md +130 -0
- data/docs/scripts/post-build.mjs +81 -0
- data/exe/fontisan +7 -0
- data/lib/fontisan/audit/check.rb +47 -0
- data/lib/fontisan/audit/check_registry.rb +77 -0
- data/lib/fontisan/audit/checks/cff_table_check.rb +87 -0
- data/lib/fontisan/audit/checks/cmap_check.rb +256 -0
- data/lib/fontisan/audit/checks/collection_integrity_check.rb +102 -0
- data/lib/fontisan/audit/checks/format_round_trip_check.rb +150 -0
- data/lib/fontisan/audit/checks/glyf_table_check.rb +115 -0
- data/lib/fontisan/audit/checks/glyph_name_check.rb +107 -0
- data/lib/fontisan/audit/checks/head_check.rb +96 -0
- data/lib/fontisan/audit/checks/hhea_check.rb +68 -0
- data/lib/fontisan/audit/checks/hinting_check.rb +163 -0
- data/lib/fontisan/audit/checks/kern_check.rb +47 -0
- data/lib/fontisan/audit/checks/layout_table_check.rb +70 -0
- data/lib/fontisan/audit/checks/maxp_check.rb +85 -0
- data/lib/fontisan/audit/checks/name_table_check.rb +78 -0
- data/lib/fontisan/audit/checks/naming_consistency_check.rb +102 -0
- data/lib/fontisan/audit/checks/opentype_conformance_check.rb +108 -0
- data/lib/fontisan/audit/checks/os2_check.rb +117 -0
- data/lib/fontisan/audit/checks/ots_compatibility_check.rb +191 -0
- data/lib/fontisan/audit/checks/post_check.rb +75 -0
- data/lib/fontisan/audit/checks/table_directory_check.rb +157 -0
- data/lib/fontisan/audit/checks/variable_font_check.rb +151 -0
- data/lib/fontisan/audit/checks/woff2_validation_check.rb +140 -0
- data/lib/fontisan/audit/checks.rb +42 -0
- data/lib/fontisan/audit.rb +20 -0
- data/lib/fontisan/base_collection.rb +312 -0
- data/lib/fontisan/binary/base_record.rb +82 -0
- data/lib/fontisan/binary/structures.rb +82 -0
- data/lib/fontisan/binary.rb +11 -0
- data/lib/fontisan/byte_ops.rb +314 -0
- data/lib/fontisan/cli.rb +1111 -0
- data/lib/fontisan/collection/builder.rb +336 -0
- data/lib/fontisan/collection/dfont_builder.rb +305 -0
- data/lib/fontisan/collection/offset_calculator.rb +229 -0
- data/lib/fontisan/collection/reader/stats.rb +23 -0
- data/lib/fontisan/collection/reader.rb +90 -0
- data/lib/fontisan/collection/shared_logic.rb +52 -0
- data/lib/fontisan/collection/table_analyzer.rb +289 -0
- data/lib/fontisan/collection/table_deduplicator.rb +317 -0
- data/lib/fontisan/collection/writer.rb +289 -0
- data/lib/fontisan/collection.rb +16 -0
- data/lib/fontisan/commands/audit_command.rb +288 -0
- data/lib/fontisan/commands/base_command.rb +88 -0
- data/lib/fontisan/commands/convert_command.rb +506 -0
- data/lib/fontisan/commands/dump_table_command.rb +68 -0
- data/lib/fontisan/commands/export_command.rb +157 -0
- data/lib/fontisan/commands/features_command.rb +90 -0
- data/lib/fontisan/commands/glyphs_command.rb +50 -0
- data/lib/fontisan/commands/info_command.rb +447 -0
- data/lib/fontisan/commands/instance_command.rb +357 -0
- data/lib/fontisan/commands/ls_command.rb +107 -0
- data/lib/fontisan/commands/multi_format_output.rb +64 -0
- data/lib/fontisan/commands/optical_size_command.rb +38 -0
- data/lib/fontisan/commands/pack_command.rb +344 -0
- data/lib/fontisan/commands/scripts_command.rb +56 -0
- data/lib/fontisan/commands/subset_command.rb +285 -0
- data/lib/fontisan/commands/tables_command.rb +52 -0
- data/lib/fontisan/commands/unicode_command.rb +73 -0
- data/lib/fontisan/commands/unpack_command.rb +387 -0
- data/lib/fontisan/commands/validate_collection_command.rb +127 -0
- data/lib/fontisan/commands/validate_command.rb +305 -0
- data/lib/fontisan/commands/variable_command.rb +87 -0
- data/lib/fontisan/commands.rb +30 -0
- data/lib/fontisan/config/collection_settings.yml +56 -0
- data/lib/fontisan/config/conversion_matrix.yml +626 -0
- data/lib/fontisan/config/export_settings.yml +66 -0
- data/lib/fontisan/config/features.yml +143 -0
- data/lib/fontisan/config/scripts.yml +42 -0
- data/lib/fontisan/config/subset_profiles.yml +106 -0
- data/lib/fontisan/config/svg_settings.yml +60 -0
- data/lib/fontisan/config/variable_settings.yml +99 -0
- data/lib/fontisan/config/woff2_settings.yml +77 -0
- data/lib/fontisan/constants.rb +219 -0
- data/lib/fontisan/conversion_options.rb +389 -0
- data/lib/fontisan/converters/cff_table_builder.rb +195 -0
- data/lib/fontisan/converters/collection_converter.rb +520 -0
- data/lib/fontisan/converters/conversion_strategy.rb +211 -0
- data/lib/fontisan/converters/format_converter.rb +536 -0
- data/lib/fontisan/converters/glyf_table_builder.rb +61 -0
- data/lib/fontisan/converters/outline_converter.rb +720 -0
- data/lib/fontisan/converters/outline_extraction.rb +88 -0
- data/lib/fontisan/converters/outline_optimizer.rb +84 -0
- data/lib/fontisan/converters/svg_generator.rb +236 -0
- data/lib/fontisan/converters/table_copier.rb +107 -0
- data/lib/fontisan/converters/type1_converter.rb +1201 -0
- data/lib/fontisan/converters/woff2_encoder.rb +520 -0
- data/lib/fontisan/converters/woff_writer.rb +358 -0
- data/lib/fontisan/converters.rb +21 -0
- data/lib/fontisan/dfont_collection.rb +288 -0
- data/lib/fontisan/engine.rb +393 -0
- data/lib/fontisan/error.rb +281 -0
- data/lib/fontisan/export/exporter.rb +255 -0
- data/lib/fontisan/export/table_serializer.rb +140 -0
- data/lib/fontisan/export/transformers/font_to_ttx.rb +163 -0
- data/lib/fontisan/export/transformers/head_transformer.rb +94 -0
- data/lib/fontisan/export/transformers/hhea_transformer.rb +57 -0
- data/lib/fontisan/export/transformers/maxp_transformer.rb +61 -0
- data/lib/fontisan/export/transformers/name_transformer.rb +61 -0
- data/lib/fontisan/export/transformers/os2_transformer.rb +119 -0
- data/lib/fontisan/export/transformers/post_transformer.rb +49 -0
- data/lib/fontisan/export/transformers.rb +17 -0
- data/lib/fontisan/export/ttx_generator.rb +526 -0
- data/lib/fontisan/export/ttx_parser.rb +300 -0
- data/lib/fontisan/export.rb +13 -0
- data/lib/fontisan/ffi/client.rb +123 -0
- data/lib/fontisan/ffi/libfontisan_cdylib.so +0 -0
- data/lib/fontisan/ffi.rb +387 -0
- data/lib/fontisan/ffi_platform.rb +24 -0
- data/lib/fontisan/font_loader.rb +315 -0
- data/lib/fontisan/font_writer.rb +309 -0
- data/lib/fontisan/formatters/text_formatter.rb +517 -0
- data/lib/fontisan/formatters.rb +9 -0
- data/lib/fontisan/glyph_accessor.rb +525 -0
- data/lib/fontisan/hints/hint_converter.rb +309 -0
- data/lib/fontisan/hints/hint_validator.rb +287 -0
- data/lib/fontisan/hints/postscript_hint_applier.rb +255 -0
- data/lib/fontisan/hints/postscript_hint_extractor.rb +347 -0
- data/lib/fontisan/hints/truetype_hint_applier.rb +117 -0
- data/lib/fontisan/hints/truetype_hint_extractor.rb +283 -0
- data/lib/fontisan/hints/truetype_instruction_analyzer.rb +268 -0
- data/lib/fontisan/hints/truetype_instruction_generator.rb +266 -0
- data/lib/fontisan/hints.rb +19 -0
- data/lib/fontisan/loading_modes.rb +113 -0
- data/lib/fontisan/metrics_calculator.rb +275 -0
- data/lib/fontisan/models/all_scripts_features_info.rb +20 -0
- data/lib/fontisan/models/audit_report.rb +196 -0
- data/lib/fontisan/models/bitmap_glyph.rb +123 -0
- data/lib/fontisan/models/bitmap_strike.rb +94 -0
- data/lib/fontisan/models/collection_brief_info.rb +36 -0
- data/lib/fontisan/models/collection_font_summary.rb +52 -0
- data/lib/fontisan/models/collection_info.rb +79 -0
- data/lib/fontisan/models/collection_list_info.rb +36 -0
- data/lib/fontisan/models/collection_validation_report.rb +102 -0
- data/lib/fontisan/models/color_glyph.rb +56 -0
- data/lib/fontisan/models/color_layer.rb +53 -0
- data/lib/fontisan/models/color_palette.rb +60 -0
- data/lib/fontisan/models/features_info.rb +42 -0
- data/lib/fontisan/models/font_export.rb +158 -0
- data/lib/fontisan/models/font_info.rb +98 -0
- data/lib/fontisan/models/font_report.rb +23 -0
- data/lib/fontisan/models/font_summary.rb +48 -0
- data/lib/fontisan/models/glyph_info.rb +26 -0
- data/lib/fontisan/models/glyph_outline.rb +343 -0
- data/lib/fontisan/models/hint.rb +404 -0
- data/lib/fontisan/models/optical_size_info.rb +33 -0
- data/lib/fontisan/models/outline.rb +667 -0
- data/lib/fontisan/models/scripts_info.rb +39 -0
- data/lib/fontisan/models/svg_glyph.rb +89 -0
- data/lib/fontisan/models/table_info.rb +55 -0
- data/lib/fontisan/models/table_sharing_info.rb +40 -0
- data/lib/fontisan/models/ttx/glyph_order.rb +31 -0
- data/lib/fontisan/models/ttx/tables/binary_table.rb +67 -0
- data/lib/fontisan/models/ttx/tables/head_table.rb +74 -0
- data/lib/fontisan/models/ttx/tables/hhea_table.rb +74 -0
- data/lib/fontisan/models/ttx/tables/maxp_table.rb +55 -0
- data/lib/fontisan/models/ttx/tables/name_table.rb +45 -0
- data/lib/fontisan/models/ttx/tables/os2_table.rb +157 -0
- data/lib/fontisan/models/ttx/tables/post_table.rb +50 -0
- data/lib/fontisan/models/ttx/tables.rb +21 -0
- data/lib/fontisan/models/ttx/ttfont.rb +41 -0
- data/lib/fontisan/models/ttx.rb +14 -0
- data/lib/fontisan/models/unicode_mappings.rb +42 -0
- data/lib/fontisan/models/validation_report.rb +435 -0
- data/lib/fontisan/models/variable_font_info.rb +82 -0
- data/lib/fontisan/models.rb +49 -0
- data/lib/fontisan/native/3.2/fontisan_native.so +0 -0
- data/lib/fontisan/native/3.3/fontisan_native.so +0 -0
- data/lib/fontisan/native/3.4/fontisan_native.so +0 -0
- data/lib/fontisan/native/4.0/fontisan_native.so +0 -0
- data/lib/fontisan/native.rb +235 -0
- data/lib/fontisan/open_type_collection.rb +49 -0
- data/lib/fontisan/open_type_font.rb +161 -0
- data/lib/fontisan/open_type_font_extensions.rb +54 -0
- data/lib/fontisan/optimizers/charstring_rewriter.rb +172 -0
- data/lib/fontisan/optimizers/pattern_analyzer.rb +310 -0
- data/lib/fontisan/optimizers/stack_tracker.rb +246 -0
- data/lib/fontisan/optimizers/subroutine_builder.rb +135 -0
- data/lib/fontisan/optimizers/subroutine_generator.rb +207 -0
- data/lib/fontisan/optimizers/subroutine_optimizer.rb +114 -0
- data/lib/fontisan/optimizers.rb +14 -0
- data/lib/fontisan/outline_extractor.rb +417 -0
- data/lib/fontisan/output_guard.rb +40 -0
- data/lib/fontisan/parsers/dfont_parser.rb +191 -0
- data/lib/fontisan/parsers/tag.rb +77 -0
- data/lib/fontisan/parsers.rb +10 -0
- data/lib/fontisan/pipeline/format_detector.rb +176 -0
- data/lib/fontisan/pipeline/output_writer.rb +161 -0
- data/lib/fontisan/pipeline/strategies/base_strategy.rb +75 -0
- data/lib/fontisan/pipeline/strategies/instance_strategy.rb +89 -0
- data/lib/fontisan/pipeline/strategies/named_strategy.rb +114 -0
- data/lib/fontisan/pipeline/strategies/preserve_strategy.rb +54 -0
- data/lib/fontisan/pipeline/strategies.rb +16 -0
- data/lib/fontisan/pipeline/transformation_pipeline.rb +407 -0
- data/lib/fontisan/pipeline/variation_resolver.rb +158 -0
- data/lib/fontisan/pipeline.rb +14 -0
- data/lib/fontisan/reference/table_digests.rb +251 -0
- data/lib/fontisan/reference.rb +663 -0
- data/lib/fontisan/scan.rb +372 -0
- data/lib/fontisan/sfnt_builder.rb +66 -0
- data/lib/fontisan/sfnt_directory.rb +41 -0
- data/lib/fontisan/sfnt_font.rb +749 -0
- data/lib/fontisan/sfnt_source.rb +28 -0
- data/lib/fontisan/sfnt_table.rb +260 -0
- data/lib/fontisan/stitcher/cbdt_propagator.rb +212 -0
- data/lib/fontisan/stitcher/collection_result.rb +19 -0
- data/lib/fontisan/stitcher/deduplicator.rb +47 -0
- data/lib/fontisan/stitcher/format_metadata.rb +51 -0
- data/lib/fontisan/stitcher/glyph_cloner.rb +41 -0
- data/lib/fontisan/stitcher/glyph_copier.rb +110 -0
- data/lib/fontisan/stitcher/glyph_limit.rb +53 -0
- data/lib/fontisan/stitcher/glyph_signature.rb +51 -0
- data/lib/fontisan/stitcher/partition_strategy/base.rb +52 -0
- data/lib/fontisan/stitcher/partition_strategy/blueprint.rb +24 -0
- data/lib/fontisan/stitcher/partition_strategy/by_block.rb +430 -0
- data/lib/fontisan/stitcher/partition_strategy/by_plane.rb +161 -0
- data/lib/fontisan/stitcher/partition_strategy/by_script.rb +309 -0
- data/lib/fontisan/stitcher/partition_strategy/partition.rb +24 -0
- data/lib/fontisan/stitcher/partition_strategy.rb +24 -0
- data/lib/fontisan/stitcher/selector/codepoints.rb +29 -0
- data/lib/fontisan/stitcher/selector/gid.rb +25 -0
- data/lib/fontisan/stitcher/selector/range.rb +30 -0
- data/lib/fontisan/stitcher/selector.rb +26 -0
- data/lib/fontisan/stitcher/source.rb +459 -0
- data/lib/fontisan/stitcher/unique_glyph_name.rb +46 -0
- data/lib/fontisan/stitcher.rb +185 -0
- data/lib/fontisan/stitcher_cli.rb +69 -0
- data/lib/fontisan/subset/builder.rb +263 -0
- data/lib/fontisan/subset/glyph_mapping.rb +222 -0
- data/lib/fontisan/subset/options.rb +142 -0
- data/lib/fontisan/subset/profile.rb +152 -0
- data/lib/fontisan/subset/shared_state.rb +42 -0
- data/lib/fontisan/subset/subset_context.rb +20 -0
- data/lib/fontisan/subset/table_strategy/cbdt.rb +30 -0
- data/lib/fontisan/subset/table_strategy/cblc.rb +27 -0
- data/lib/fontisan/subset/table_strategy/cff.rb +92 -0
- data/lib/fontisan/subset/table_strategy/cff2.rb +391 -0
- data/lib/fontisan/subset/table_strategy/cmap.rb +146 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_placement.rb +20 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_strike_plan.rb +45 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subset_plan.rb +62 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subsetter.rb +182 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subtable_plan.rb +59 -0
- data/lib/fontisan/subset/table_strategy/glyf.rb +29 -0
- data/lib/fontisan/subset/table_strategy/glyf_loca_builder.rb +146 -0
- data/lib/fontisan/subset/table_strategy/head.rb +43 -0
- data/lib/fontisan/subset/table_strategy/hhea.rb +67 -0
- data/lib/fontisan/subset/table_strategy/hmtx.rb +52 -0
- data/lib/fontisan/subset/table_strategy/loca.rb +41 -0
- data/lib/fontisan/subset/table_strategy/maxp.rb +23 -0
- data/lib/fontisan/subset/table_strategy/name.rb +19 -0
- data/lib/fontisan/subset/table_strategy/os2.rb +21 -0
- data/lib/fontisan/subset/table_strategy/pass_through.rb +20 -0
- data/lib/fontisan/subset/table_strategy/post.rb +37 -0
- data/lib/fontisan/subset/table_strategy.rb +79 -0
- data/lib/fontisan/subset/table_subsetter.rb +110 -0
- data/lib/fontisan/subset.rb +16 -0
- data/lib/fontisan/svg/font_face_generator.rb +274 -0
- data/lib/fontisan/svg/font_generator.rb +256 -0
- data/lib/fontisan/svg/glyph_generator.rb +201 -0
- data/lib/fontisan/svg/standalone_glyph.rb +132 -0
- data/lib/fontisan/svg/view_box_calculator.rb +137 -0
- data/lib/fontisan/svg.rb +13 -0
- data/lib/fontisan/svg_to_glyf/assembler.rb +174 -0
- data/lib/fontisan/svg_to_glyf/document.rb +102 -0
- data/lib/fontisan/svg_to_glyf/geometry/affine_transform.rb +112 -0
- data/lib/fontisan/svg_to_glyf/geometry/normalizer.rb +62 -0
- data/lib/fontisan/svg_to_glyf/geometry/transform_parser.rb +98 -0
- data/lib/fontisan/svg_to_glyf/geometry.rb +15 -0
- data/lib/fontisan/svg_to_glyf/path/command.rb +18 -0
- data/lib/fontisan/svg_to_glyf/path/contour_builder.rb +140 -0
- data/lib/fontisan/svg_to_glyf/path/parser.rb +98 -0
- data/lib/fontisan/svg_to_glyf/path/state.rb +79 -0
- data/lib/fontisan/svg_to_glyf/path.rb +14 -0
- data/lib/fontisan/svg_to_glyf.rb +62 -0
- data/lib/fontisan/tables/cbdt.rb +113 -0
- data/lib/fontisan/tables/cblc.rb +172 -0
- data/lib/fontisan/tables/cblc_big_glyph_metrics.rb +28 -0
- data/lib/fontisan/tables/cblc_bitmap_size.rb +67 -0
- data/lib/fontisan/tables/cblc_glyph_bitmap_location.rb +28 -0
- data/lib/fontisan/tables/cblc_index_subtable.rb +104 -0
- data/lib/fontisan/tables/cblc_index_subtable_array_entry.rb +20 -0
- data/lib/fontisan/tables/cblc_index_subtable_format_parser.rb +150 -0
- data/lib/fontisan/tables/cblc_index_subtable_header.rb +18 -0
- data/lib/fontisan/tables/cblc_sbit_line_metrics.rb +28 -0
- data/lib/fontisan/tables/cff/cff2_charstring_builder.rb +225 -0
- data/lib/fontisan/tables/cff/cff_glyph.rb +176 -0
- data/lib/fontisan/tables/cff/charset.rb +276 -0
- data/lib/fontisan/tables/cff/charstring.rb +978 -0
- data/lib/fontisan/tables/cff/charstring_builder.rb +356 -0
- data/lib/fontisan/tables/cff/charstring_parser.rb +249 -0
- data/lib/fontisan/tables/cff/charstring_rebuilder.rb +168 -0
- data/lib/fontisan/tables/cff/charstrings_index.rb +159 -0
- data/lib/fontisan/tables/cff/dict.rb +353 -0
- data/lib/fontisan/tables/cff/dict_builder.rb +260 -0
- data/lib/fontisan/tables/cff/encoding.rb +273 -0
- data/lib/fontisan/tables/cff/expert_charsets.rb +85 -0
- data/lib/fontisan/tables/cff/header.rb +100 -0
- data/lib/fontisan/tables/cff/hint_operation_injector.rb +207 -0
- data/lib/fontisan/tables/cff/index.rb +241 -0
- data/lib/fontisan/tables/cff/index_builder.rb +170 -0
- data/lib/fontisan/tables/cff/offset_recalculator.rb +70 -0
- data/lib/fontisan/tables/cff/private_dict.rb +282 -0
- data/lib/fontisan/tables/cff/private_dict_writer.rb +129 -0
- data/lib/fontisan/tables/cff/standard_strings_data.rb +83 -0
- data/lib/fontisan/tables/cff/table_builder.rb +215 -0
- data/lib/fontisan/tables/cff/top_dict.rb +234 -0
- data/lib/fontisan/tables/cff.rb +497 -0
- data/lib/fontisan/tables/cff2/blend_operator.rb +240 -0
- data/lib/fontisan/tables/cff2/charstring_parser.rb +624 -0
- data/lib/fontisan/tables/cff2/dict_encoder.rb +94 -0
- data/lib/fontisan/tables/cff2/fd_select.rb +142 -0
- data/lib/fontisan/tables/cff2/header.rb +34 -0
- data/lib/fontisan/tables/cff2/index.rb +155 -0
- data/lib/fontisan/tables/cff2/index_builder.rb +80 -0
- data/lib/fontisan/tables/cff2/operand_stack.rb +232 -0
- data/lib/fontisan/tables/cff2/private_dict_blend_handler.rb +247 -0
- data/lib/fontisan/tables/cff2/region_matcher.rb +200 -0
- data/lib/fontisan/tables/cff2/table_builder.rb +567 -0
- data/lib/fontisan/tables/cff2/table_reader.rb +418 -0
- data/lib/fontisan/tables/cff2/variation_data_extractor.rb +212 -0
- data/lib/fontisan/tables/cff2.rb +353 -0
- data/lib/fontisan/tables/cmap.rb +399 -0
- data/lib/fontisan/tables/cmap_table.rb +228 -0
- data/lib/fontisan/tables/colr.rb +290 -0
- data/lib/fontisan/tables/cpal.rb +381 -0
- data/lib/fontisan/tables/cvar.rb +204 -0
- data/lib/fontisan/tables/fvar.rb +159 -0
- data/lib/fontisan/tables/glyf/compound_glyph.rb +482 -0
- data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb +135 -0
- data/lib/fontisan/tables/glyf/curve_converter.rb +349 -0
- data/lib/fontisan/tables/glyf/glyph_builder.rb +468 -0
- data/lib/fontisan/tables/glyf/simple_glyph.rb +391 -0
- data/lib/fontisan/tables/glyf.rb +347 -0
- data/lib/fontisan/tables/glyf_table.rb +252 -0
- data/lib/fontisan/tables/gpos/glyph_filter.rb +87 -0
- data/lib/fontisan/tables/gpos/kerning_pairs.rb +215 -0
- data/lib/fontisan/tables/gpos/pair_position.rb +274 -0
- data/lib/fontisan/tables/gpos.rb +139 -0
- data/lib/fontisan/tables/gsub.rb +116 -0
- data/lib/fontisan/tables/gvar.rb +232 -0
- data/lib/fontisan/tables/head.rb +208 -0
- data/lib/fontisan/tables/head_table.rb +108 -0
- data/lib/fontisan/tables/hhea.rb +199 -0
- data/lib/fontisan/tables/hhea_table.rb +252 -0
- data/lib/fontisan/tables/hmtx.rb +281 -0
- data/lib/fontisan/tables/hmtx_table.rb +188 -0
- data/lib/fontisan/tables/hvar.rb +192 -0
- data/lib/fontisan/tables/layout_common.rb +245 -0
- data/lib/fontisan/tables/loca.rb +323 -0
- data/lib/fontisan/tables/loca_table.rb +209 -0
- data/lib/fontisan/tables/maxp.rb +253 -0
- data/lib/fontisan/tables/maxp_table.rb +255 -0
- data/lib/fontisan/tables/mvar.rb +185 -0
- data/lib/fontisan/tables/name.rb +340 -0
- data/lib/fontisan/tables/name_table.rb +173 -0
- data/lib/fontisan/tables/os2.rb +291 -0
- data/lib/fontisan/tables/os2_table.rb +326 -0
- data/lib/fontisan/tables/post.rb +206 -0
- data/lib/fontisan/tables/post_table.rb +180 -0
- data/lib/fontisan/tables/registry.rb +71 -0
- data/lib/fontisan/tables/sbix.rb +379 -0
- data/lib/fontisan/tables/svg.rb +300 -0
- data/lib/fontisan/tables/variation_common.rb +345 -0
- data/lib/fontisan/tables/vvar.rb +234 -0
- data/lib/fontisan/tables.rb +69 -0
- data/lib/fontisan/true_type_collection.rb +160 -0
- data/lib/fontisan/true_type_font.rb +80 -0
- data/lib/fontisan/true_type_font_extensions.rb +54 -0
- data/lib/fontisan/type1/afm_generator.rb +379 -0
- data/lib/fontisan/type1/afm_parser.rb +299 -0
- data/lib/fontisan/type1/agl.rb +456 -0
- data/lib/fontisan/type1/cff_to_type1_converter.rb +307 -0
- data/lib/fontisan/type1/charstring_converter.rb +238 -0
- data/lib/fontisan/type1/charstrings.rb +441 -0
- data/lib/fontisan/type1/conversion_options.rb +242 -0
- data/lib/fontisan/type1/decryptor.rb +183 -0
- data/lib/fontisan/type1/encodings.rb +695 -0
- data/lib/fontisan/type1/font_dictionary.rb +576 -0
- data/lib/fontisan/type1/generator.rb +217 -0
- data/lib/fontisan/type1/inf_generator.rb +307 -0
- data/lib/fontisan/type1/pfa_generator.rb +376 -0
- data/lib/fontisan/type1/pfa_parser.rb +159 -0
- data/lib/fontisan/type1/pfb_generator.rb +321 -0
- data/lib/fontisan/type1/pfb_parser.rb +166 -0
- data/lib/fontisan/type1/pfm_generator.rb +589 -0
- data/lib/fontisan/type1/pfm_parser.rb +433 -0
- data/lib/fontisan/type1/private_dict.rb +363 -0
- data/lib/fontisan/type1/seac_expander.rb +517 -0
- data/lib/fontisan/type1/ttf_to_type1_converter.rb +389 -0
- data/lib/fontisan/type1/upm_scaler.rb +118 -0
- data/lib/fontisan/type1.rb +48 -0
- data/lib/fontisan/type1_font.rb +347 -0
- data/lib/fontisan/ufo/anchor.rb +17 -0
- data/lib/fontisan/ufo/bounds.rb +91 -0
- data/lib/fontisan/ufo/cli.rb +105 -0
- data/lib/fontisan/ufo/compile/avar.rb +46 -0
- data/lib/fontisan/ufo/compile/base_compiler.rb +162 -0
- data/lib/fontisan/ufo/compile/cbdt_cblc.rb +104 -0
- data/lib/fontisan/ufo/compile/cff.rb +229 -0
- data/lib/fontisan/ufo/compile/cff2.rb +323 -0
- data/lib/fontisan/ufo/compile/cff2_subroutines.rb +39 -0
- data/lib/fontisan/ufo/compile/cmap.rb +143 -0
- data/lib/fontisan/ufo/compile/colr.rb +80 -0
- data/lib/fontisan/ufo/compile/cpal.rb +62 -0
- data/lib/fontisan/ufo/compile/feature_compiler.rb +161 -0
- data/lib/fontisan/ufo/compile/feature_writers/base.rb +56 -0
- data/lib/fontisan/ufo/compile/feature_writers/curs.rb +72 -0
- data/lib/fontisan/ufo/compile/feature_writers/gdef.rb +92 -0
- data/lib/fontisan/ufo/compile/feature_writers/kern.rb +50 -0
- data/lib/fontisan/ufo/compile/feature_writers/kern2.rb +57 -0
- data/lib/fontisan/ufo/compile/feature_writers/mark.rb +45 -0
- data/lib/fontisan/ufo/compile/feature_writers/mark_family_base.rb +124 -0
- data/lib/fontisan/ufo/compile/feature_writers/mkmk.rb +53 -0
- data/lib/fontisan/ufo/compile/feature_writers.rb +38 -0
- data/lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb +176 -0
- data/lib/fontisan/ufo/compile/filters/decompose_components.rb +33 -0
- data/lib/fontisan/ufo/compile/filters/flatten_components.rb +22 -0
- data/lib/fontisan/ufo/compile/filters/propagate_anchors.rb +102 -0
- data/lib/fontisan/ufo/compile/filters/remove_overlaps.rb +95 -0
- data/lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb +27 -0
- data/lib/fontisan/ufo/compile/filters/sort_contours.rb +69 -0
- data/lib/fontisan/ufo/compile/filters/transformations.rb +113 -0
- data/lib/fontisan/ufo/compile/filters.rb +69 -0
- data/lib/fontisan/ufo/compile/fvar.rb +113 -0
- data/lib/fontisan/ufo/compile/glyf_loca.rb +206 -0
- data/lib/fontisan/ufo/compile/gpos.rb +248 -0
- data/lib/fontisan/ufo/compile/gsub.rb +267 -0
- data/lib/fontisan/ufo/compile/gvar.rb +225 -0
- data/lib/fontisan/ufo/compile/head.rb +97 -0
- data/lib/fontisan/ufo/compile/hhea.rb +57 -0
- data/lib/fontisan/ufo/compile/hmtx.rb +38 -0
- data/lib/fontisan/ufo/compile/hvar.rb +42 -0
- data/lib/fontisan/ufo/compile/item_variation_store.rb +100 -0
- data/lib/fontisan/ufo/compile/math.rb +143 -0
- data/lib/fontisan/ufo/compile/maxp.rb +57 -0
- data/lib/fontisan/ufo/compile/meta.rb +51 -0
- data/lib/fontisan/ufo/compile/mvar.rb +59 -0
- data/lib/fontisan/ufo/compile/name.rb +81 -0
- data/lib/fontisan/ufo/compile/os2.rb +81 -0
- data/lib/fontisan/ufo/compile/otf2_compiler.rb +40 -0
- data/lib/fontisan/ufo/compile/otf_compiler.rb +34 -0
- data/lib/fontisan/ufo/compile/post.rb +32 -0
- data/lib/fontisan/ufo/compile/sbix.rb +100 -0
- data/lib/fontisan/ufo/compile/stat.rb +106 -0
- data/lib/fontisan/ufo/compile/svg_table.rb +60 -0
- data/lib/fontisan/ufo/compile/ttf_compiler.rb +75 -0
- data/lib/fontisan/ufo/compile/variable_otf.rb +84 -0
- data/lib/fontisan/ufo/compile/variable_ttf.rb +161 -0
- data/lib/fontisan/ufo/compile.rb +72 -0
- data/lib/fontisan/ufo/component.rb +18 -0
- data/lib/fontisan/ufo/contour.rb +34 -0
- data/lib/fontisan/ufo/convert/from_bin_data.rb +366 -0
- data/lib/fontisan/ufo/convert/to_dfont.rb +45 -0
- data/lib/fontisan/ufo/convert/to_otc.rb +40 -0
- data/lib/fontisan/ufo/convert/to_otf.rb +18 -0
- data/lib/fontisan/ufo/convert/to_otf2.rb +20 -0
- data/lib/fontisan/ufo/convert/to_postscript.rb +64 -0
- data/lib/fontisan/ufo/convert/to_ttc.rb +35 -0
- data/lib/fontisan/ufo/convert/to_ttf.rb +21 -0
- data/lib/fontisan/ufo/convert/to_woff.rb +61 -0
- data/lib/fontisan/ufo/convert/to_woff2.rb +50 -0
- data/lib/fontisan/ufo/convert.rb +84 -0
- data/lib/fontisan/ufo/data_set.rb +21 -0
- data/lib/fontisan/ufo/features.rb +17 -0
- data/lib/fontisan/ufo/font.rb +63 -0
- data/lib/fontisan/ufo/glyph.rb +445 -0
- data/lib/fontisan/ufo/glyph_exists_error.rb +23 -0
- data/lib/fontisan/ufo/groups.rb +45 -0
- data/lib/fontisan/ufo/guideline.rb +19 -0
- data/lib/fontisan/ufo/image.rb +29 -0
- data/lib/fontisan/ufo/image_set.rb +99 -0
- data/lib/fontisan/ufo/info.rb +133 -0
- data/lib/fontisan/ufo/kerning.rb +32 -0
- data/lib/fontisan/ufo/layer.rb +78 -0
- data/lib/fontisan/ufo/layer_set.rb +37 -0
- data/lib/fontisan/ufo/lib.rb +24 -0
- data/lib/fontisan/ufo/plist.rb +123 -0
- data/lib/fontisan/ufo/point.rb +32 -0
- data/lib/fontisan/ufo/reader.rb +163 -0
- data/lib/fontisan/ufo/transformation.rb +50 -0
- data/lib/fontisan/ufo/writer.rb +123 -0
- data/lib/fontisan/ufo.rb +47 -0
- data/lib/fontisan/unicode/plane.rb +44 -0
- data/lib/fontisan/unicode.rb +17 -0
- data/lib/fontisan/utilities/brotli_wrapper.rb +177 -0
- data/lib/fontisan/utilities/checksum_calculator.rb +104 -0
- data/lib/fontisan/utilities/padding.rb +61 -0
- data/lib/fontisan/utilities.rb +11 -0
- data/lib/fontisan/utils/thread_pool.rb +134 -0
- data/lib/fontisan/utils.rb +10 -0
- data/lib/fontisan/validation/collection_validator.rb +265 -0
- data/lib/fontisan/validation.rb +9 -0
- data/lib/fontisan/validators/basic_validator.rb +73 -0
- data/lib/fontisan/validators/font_book_validator.rb +107 -0
- data/lib/fontisan/validators/opentype_validator.rb +118 -0
- data/lib/fontisan/validators/profile_loader.rb +134 -0
- data/lib/fontisan/validators/validator.rb +494 -0
- data/lib/fontisan/validators/web_font_validator.rb +95 -0
- data/lib/fontisan/validators.rb +14 -0
- data/lib/fontisan/variable/axis_normalizer.rb +215 -0
- data/lib/fontisan/variable/delta_applicator.rb +302 -0
- data/lib/fontisan/variable/glyph_delta_processor.rb +218 -0
- data/lib/fontisan/variable/instancer.rb +172 -0
- data/lib/fontisan/variable/metric_delta_processor.rb +282 -0
- data/lib/fontisan/variable/region_matcher.rb +208 -0
- data/lib/fontisan/variable/static_font_builder.rb +209 -0
- data/lib/fontisan/variable/table_updater.rb +219 -0
- data/lib/fontisan/variable.rb +16 -0
- data/lib/fontisan/variation/blend_applier.rb +197 -0
- data/lib/fontisan/variation/cache.rb +299 -0
- data/lib/fontisan/variation/cache_key_builder.rb +162 -0
- data/lib/fontisan/variation/converter.rb +373 -0
- data/lib/fontisan/variation/data_extractor.rb +84 -0
- data/lib/fontisan/variation/delta_applier.rb +262 -0
- data/lib/fontisan/variation/delta_parser.rb +228 -0
- data/lib/fontisan/variation/inspector.rb +275 -0
- data/lib/fontisan/variation/instance_font_wrapper.rb +41 -0
- data/lib/fontisan/variation/instance_generator.rb +122 -0
- data/lib/fontisan/variation/instance_writer.rb +360 -0
- data/lib/fontisan/variation/instancing/axis_space.rb +136 -0
- data/lib/fontisan/variation/instancing/glyph_outline.rb +204 -0
- data/lib/fontisan/variation/instancing/gvar_reader.rb +146 -0
- data/lib/fontisan/variation/instancing/item_variation_store.rb +92 -0
- data/lib/fontisan/variation/instancing/name_rewriter.rb +90 -0
- data/lib/fontisan/variation/instancing/true_type_instancer.rb +326 -0
- data/lib/fontisan/variation/instancing.rb +20 -0
- data/lib/fontisan/variation/interpolator.rb +231 -0
- data/lib/fontisan/variation/metrics_adjuster.rb +309 -0
- data/lib/fontisan/variation/optimizer.rb +417 -0
- data/lib/fontisan/variation/parallel_generator.rb +147 -0
- data/lib/fontisan/variation/region_matcher.rb +221 -0
- data/lib/fontisan/variation/subsetter.rb +400 -0
- data/lib/fontisan/variation/table_accessor.rb +105 -0
- data/lib/fontisan/variation/tuple_variation_header.rb +49 -0
- data/lib/fontisan/variation/validator.rb +336 -0
- data/lib/fontisan/variation/variable_svg_generator.rb +235 -0
- data/lib/fontisan/variation/variation_context.rb +208 -0
- data/lib/fontisan/variation/variation_preserver.rb +287 -0
- data/lib/fontisan/variation.rb +33 -0
- data/lib/fontisan/version.rb +5 -0
- data/lib/fontisan/version.rb.orig +9 -0
- data/lib/fontisan/woff2/collection_decoder.rb +223 -0
- data/lib/fontisan/woff2/collection_encoder.rb +302 -0
- data/lib/fontisan/woff2/directory.rb +255 -0
- data/lib/fontisan/woff2/encoder_rules.rb +114 -0
- data/lib/fontisan/woff2/glyf_canonicalizer.rb +90 -0
- data/lib/fontisan/woff2/glyf_loca_reconstruct.rb +401 -0
- data/lib/fontisan/woff2/glyf_loca_transform.rb +319 -0
- data/lib/fontisan/woff2/header.rb +101 -0
- data/lib/fontisan/woff2/hmtx_transformer.rb +140 -0
- data/lib/fontisan/woff2/sfnt_checksum.rb +107 -0
- data/lib/fontisan/woff2/table_transformer.rb +575 -0
- data/lib/fontisan/woff2/triplet_codec.rb +181 -0
- data/lib/fontisan/woff2/uint255.rb +101 -0
- data/lib/fontisan/woff2.rb +21 -0
- data/lib/fontisan/woff2_collection.rb +127 -0
- data/lib/fontisan/woff2_font.rb +754 -0
- data/lib/fontisan/woff_container.rb +83 -0
- data/lib/fontisan/woff_font.rb +554 -0
- data/lib/fontisan.rb +299 -0
- data/rakelib/bench.rake +9 -0
- data/rakelib/cdylib.rake +39 -0
- data/rakelib/corpus.rake +272 -0
- data/rakelib/corpus_convert.rake +43 -0
- data/rakelib/corpus_goldens.rake +22 -0
- data/rakelib/corpus_malformed.rake +20 -0
- data/rakelib/corpus_scan.rake +24 -0
- data/rakelib/java.rake +61 -0
- data/rakelib/native.rake +43 -0
- data/scripts/build-woff2.sh +57 -0
- data/scripts/compare_stack_aware.rb +187 -0
- data/scripts/corpus/generate_convert_goldens.rb +478 -0
- data/scripts/corpus/generate_goldens.rb +282 -0
- data/scripts/corpus/generate_malformed_goldens.rb +254 -0
- data/scripts/corpus/generate_scan_goldens.rb +98 -0
- data/scripts/measure_optimization.rb +148 -0
- data/scripts/tier_fallback.rb +228 -0
- data/scripts/tier_smoke.rb +72 -0
- metadata +945 -0
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Font Conversion
|
|
2
|
+
|
|
3
|
+
Fontisan supports conversion between various font formats.
|
|
4
|
+
|
|
5
|
+
## Supported Formats
|
|
6
|
+
|
|
7
|
+
| Input | Output Formats |
|
|
8
|
+
|-------|---------------|
|
|
9
|
+
| TrueType (.ttf) | OTF, WOFF, WOFF2 |
|
|
10
|
+
| OpenType (.otf) | TTF, WOFF, WOFF2 |
|
|
11
|
+
| Type 1 (.pfb) | TTF, OTF, WOFF, WOFF2 |
|
|
12
|
+
| WOFF | TTF, OTF |
|
|
13
|
+
| WOFF2 | TTF, OTF |
|
|
14
|
+
|
|
15
|
+
## Basic Conversion
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
require 'fontisan'
|
|
19
|
+
|
|
20
|
+
# Convert TTF to WOFF2
|
|
21
|
+
Fontisan.convert('font.ttf', to: :woff2, output: 'font.woff2')
|
|
22
|
+
|
|
23
|
+
# Convert TTF to OTF
|
|
24
|
+
Fontisan.convert('font.ttf', to: :otf, output: 'font.otf')
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Batch Conversion
|
|
28
|
+
|
|
29
|
+
```ruby
|
|
30
|
+
# Convert multiple files
|
|
31
|
+
fonts = Dir.glob('fonts/*.ttf')
|
|
32
|
+
fonts.each do |font|
|
|
33
|
+
out = font.sub(/\.ttf$/, '.otf')
|
|
34
|
+
Fontisan.convert(font, to: :otf, output: out)
|
|
35
|
+
end
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Related
|
|
39
|
+
|
|
40
|
+
- [WOFF/WOFF2 Formats](/guide/conversion/web) - Details on web font formats
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Engines
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Engines
|
|
6
|
+
|
|
7
|
+
The path-based operations of `Fontisan::Reference` (`read`, `outline_hashes`, `audit`, `audit_dir`, `scan`, `convert`, `extract`, `instance`, `glyph_ids`, `subset`) can run on one of three engine tiers. All tiers return the same results; they differ in speed.
|
|
8
|
+
|
|
9
|
+
| Tier | What it is |
|
|
10
|
+
|---|---|
|
|
11
|
+
| `ruby` | The pure Ruby implementation. Always available. |
|
|
12
|
+
| `native` | A compiled Rust extension (`Fontisan::Native`) loaded into the Ruby process. |
|
|
13
|
+
| `ffi` | A bundled Rust shared library (`Fontisan::Ffi`) called through the `ffi` gem, which is not a runtime dependency of fontisan. |
|
|
14
|
+
|
|
15
|
+
Reference timings on macOS arm64 (see `BENCHMARKS.md`, local run, not CI), native versus Ruby:
|
|
16
|
+
|
|
17
|
+
| Operation | Speedup |
|
|
18
|
+
|---|---|
|
|
19
|
+
| `audit` (one file) | 30x |
|
|
20
|
+
| `audit_dir` | 8.2x |
|
|
21
|
+
| `scan` (directory) | 3.9x |
|
|
22
|
+
|
|
23
|
+
Peak memory of a directory scan is about 4% lower on the native tier.
|
|
24
|
+
|
|
25
|
+
## Selecting an engine
|
|
26
|
+
|
|
27
|
+
Set `FONTISAN_ENGINE` before the process starts. Unset or empty means `auto`:
|
|
28
|
+
|
|
29
|
+
| Value | Behaviour |
|
|
30
|
+
|---|---|
|
|
31
|
+
| `ruby` | Use the Ruby tier only. |
|
|
32
|
+
| `native` | Use the native tier. |
|
|
33
|
+
| `ffi` | Use the ffi tier. |
|
|
34
|
+
| `auto` | The default. Currently serves everything from ruby; the Rust tiers are used only when selected explicitly, until the phase-3 gates pass (fontisan#160). After that, the first available tier in the order native, ffi, ruby. |
|
|
35
|
+
|
|
36
|
+
```sh
|
|
37
|
+
FONTISAN_ENGINE=native FONTISAN_ENGINE_STRICT=1 fontisan convert MyFont.ttf --to woff2 --output out.woff2
|
|
38
|
+
ruby -e 'require "fontisan"; p Fontisan::Reference.audit("MyFont.ttf").keys'
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Any other value raises `Fontisan::Engine::ConfigError`.
|
|
42
|
+
|
|
43
|
+
### Command line
|
|
44
|
+
|
|
45
|
+
The same variables apply to the CLI, but only for the commands that go through the engine: `convert`, `unpack`, `subset` and `instance`. Each routes only its plain cases: `convert` a single-target conversion (several targets, instance coordinates, conversion options, hinting, a collection target format, compression options or a font index run on Ruby); `subset` by `--text` or `--unicode` with the `pdf`, `web` or `minimal` profile; `instance` of a TrueType variable font by axis coordinates to the same format (`--to`, `--named-instance` and `--list-instances` run on Ruby). Every other command (`info`, `validate`, `export`, `pack`, and so on) runs on Ruby.
|
|
46
|
+
|
|
47
|
+
## Strict mode
|
|
48
|
+
|
|
49
|
+
If a forced tier (`native` or `ffi`) is not available, fontisan falls back to Ruby silently. Set `FONTISAN_ENGINE_STRICT=1` (also `true`, `yes`, `on`; `0`, `false`, `no`, `off` leave it off, anything else raises `Fontisan::Engine::ConfigError`) to raise `Fontisan::Engine::TierUnavailable` instead:
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
FONTISAN_ENGINE=native FONTISAN_ENGINE_STRICT=1 ruby -rfontisan -e 'Fontisan::Reference.audit("MyFont.ttf")'
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Strict mode does not apply to operations a tier cannot serve (see below); those always go to Ruby.
|
|
56
|
+
|
|
57
|
+
## Which tier served a call
|
|
58
|
+
|
|
59
|
+
`Fontisan::Engine.served_by(operation)` returns the tier (a Symbol) that served the last call of that operation in the current process, or `nil` if there was none.
|
|
60
|
+
|
|
61
|
+
```ruby
|
|
62
|
+
ENV["FONTISAN_ENGINE"] = "auto"
|
|
63
|
+
Fontisan::Reference.audit("MyFont.ttf")
|
|
64
|
+
Fontisan::Engine.served_by(:audit) # => :native
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
`Fontisan::Engine.scan(paths)` and `Fontisan::Engine.audit_dir(dir)` return the same rows as the `Reference` methods with an added `"served_by"` key per row or entry. Results of the `Reference` methods themselves do not change with the tier.
|
|
68
|
+
|
|
69
|
+
## What stays on Ruby
|
|
70
|
+
|
|
71
|
+
These always run on the Ruby tier, whichever engine is selected, and strict mode does not raise for them:
|
|
72
|
+
|
|
73
|
+
- The object-based API: `Fontisan::Subset::Builder.new(font, ...)` and `Fontisan::Variable::Instancer`. Only the path-based `Reference.subset` and `Reference.instance` can use another tier.
|
|
74
|
+
- Apple dfont files.
|
|
75
|
+
- CLI commands other than `convert`, `unpack` and `subset`, and the non-plain `convert` cases listed above.
|
|
76
|
+
- Type 1 fonts (PFB/PFA).
|
|
77
|
+
|
|
78
|
+
## Platforms
|
|
79
|
+
|
|
80
|
+
Platform gems with the native extension and the bundled shared library are published for:
|
|
81
|
+
|
|
82
|
+
- `x86_64-linux`
|
|
83
|
+
- `x86_64-linux-musl`
|
|
84
|
+
- `arm64-darwin`
|
|
85
|
+
- `x86_64-darwin`
|
|
86
|
+
- `x64-mingw-ucrt` (Ruby 3.2 to 4.0)
|
|
87
|
+
|
|
88
|
+
The `java` gem (JRuby) carries the shared library only (bundled for linux-x86_64, darwin-arm64, darwin-x86_64 and windows-x86_64; no musl or linux-arm64), so it serves the `ffi` tier. It depends on neither `brotli` nor `rb_sys`; a WOFF2 operation that falls to the Ruby tier on this gem raises `Fontisan::Engine::Woff2Unavailable`.
|
|
89
|
+
|
|
90
|
+
The plain source gem builds the native extension at install time when a Rust toolchain (`cargo`) and the `rb_sys` gem are present. Without them the install still succeeds and fontisan runs on the Ruby tier.
|
|
91
|
+
|
|
92
|
+
## Troubleshooting
|
|
93
|
+
|
|
94
|
+
### "native tier not available"
|
|
95
|
+
|
|
96
|
+
With `FONTISAN_ENGINE=native` and `FONTISAN_ENGINE_STRICT=1` you get `TierUnavailable`: the native extension did not load. Check:
|
|
97
|
+
|
|
98
|
+
```sh
|
|
99
|
+
ruby -rfontisan -e 'p Fontisan::Native.available?, Fontisan::Ffi.available?'
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
- `false` on an installed platform gem: the gem was installed on a Ruby version or platform it does not cover. Run `gem list fontisan` and check the platform suffix; install the matching one.
|
|
103
|
+
- `false` on a source install: the extension was skipped because `cargo` or `rb_sys` was missing. See below.
|
|
104
|
+
- Without strict mode, the same condition silently serves from Ruby; use `Fontisan::Engine.served_by` to confirm which tier ran.
|
|
105
|
+
|
|
106
|
+
For the ffi tier, `FONTISAN_CDYLIB` can point at a specific shared library file.
|
|
107
|
+
|
|
108
|
+
### Building from source
|
|
109
|
+
|
|
110
|
+
Install a Rust toolchain ([rustup](https://rustup.rs)), then reinstall so the extension is compiled:
|
|
111
|
+
|
|
112
|
+
```sh
|
|
113
|
+
gem install rb_sys
|
|
114
|
+
gem install fontisan --platform ruby
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
With Bundler, add `gem "fontisan", force_ruby_platform: true` to build from the source gem. Set `FONTISAN_NATIVE_REQUIRED=1` during the install to make a missing toolchain or a failed build an error instead of a silent skip. `FONTISAN_SKIP_CDYLIB=1` skips building the shared library for the ffi tier.
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Font Collections
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Font Collections (TTC/OTC)
|
|
6
|
+
|
|
7
|
+
Font collections pack multiple fonts into a single file with shared tables.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
| Format | Description | Font Type |
|
|
12
|
+
|--------|-------------|-----------|
|
|
13
|
+
| TTC | TrueType Collection | TrueType fonts |
|
|
14
|
+
| OTC | OpenType Collection | CFF/OpenType fonts |
|
|
15
|
+
|
|
16
|
+
## Benefits
|
|
17
|
+
|
|
18
|
+
- **Smaller total size** — Shared tables
|
|
19
|
+
- **Simpler distribution** — One file
|
|
20
|
+
- **Family organization** — Related fonts together
|
|
21
|
+
|
|
22
|
+
## Shared Tables
|
|
23
|
+
|
|
24
|
+
Collections share common tables:
|
|
25
|
+
|
|
26
|
+
- `cmap` — Character mappings
|
|
27
|
+
- `loca` — Glyph locations
|
|
28
|
+
- `maxp` — Maximum profile
|
|
29
|
+
- `name` — Font names
|
|
30
|
+
- `post` — PostScript names
|
|
31
|
+
|
|
32
|
+
## Listing Fonts
|
|
33
|
+
|
|
34
|
+
### CLI
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
fontisan ls family.ttc
|
|
38
|
+
|
|
39
|
+
# Collection: family.ttc
|
|
40
|
+
# Fonts: 4
|
|
41
|
+
#
|
|
42
|
+
# 0. Family Regular
|
|
43
|
+
# PostScript: Family-Regular
|
|
44
|
+
# Glyphs: 268, Tables: 14
|
|
45
|
+
#
|
|
46
|
+
# 1. Family Bold
|
|
47
|
+
# PostScript: Family-Bold
|
|
48
|
+
# Glyphs: 268, Tables: 14
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### API
|
|
52
|
+
|
|
53
|
+
```ruby
|
|
54
|
+
collection = Fontisan::FontLoader.load('family.ttc')
|
|
55
|
+
|
|
56
|
+
collection.each_with_index do |font, index|
|
|
57
|
+
puts "#{index}. #{font.family_name} #{font.style}"
|
|
58
|
+
end
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## Extracting Fonts
|
|
62
|
+
|
|
63
|
+
### CLI
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
# Extract all fonts
|
|
67
|
+
fontisan unpack family.ttc --output-dir ./extracted
|
|
68
|
+
|
|
69
|
+
# Extract specific font
|
|
70
|
+
fontisan unpack family.ttc --index 0 --output regular.ttf
|
|
71
|
+
|
|
72
|
+
# Extract with conversion
|
|
73
|
+
fontisan unpack family.ttc --output-dir ./otf --format otf
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### API
|
|
77
|
+
|
|
78
|
+
```ruby
|
|
79
|
+
collection = Fontisan::FontLoader.load('family.ttc')
|
|
80
|
+
|
|
81
|
+
collection.each_with_index do |font, index|
|
|
82
|
+
output = "font-#{index}.ttf"
|
|
83
|
+
Fontisan::FontWriter.write(font, output)
|
|
84
|
+
end
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## Creating Collections
|
|
88
|
+
|
|
89
|
+
### CLI
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
# Pack fonts into TTC
|
|
93
|
+
fontisan pack regular.ttf bold.ttf italic.ttf --output family.ttc
|
|
94
|
+
|
|
95
|
+
# Pack with deduplication
|
|
96
|
+
fontisan pack *.ttf --output family.ttc --deduplicate
|
|
97
|
+
|
|
98
|
+
# Pack as OTC
|
|
99
|
+
fontisan pack regular.otf bold.otf --output family.otc
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### API
|
|
103
|
+
|
|
104
|
+
```ruby
|
|
105
|
+
fonts = [
|
|
106
|
+
Fontisan::FontLoader.load('regular.ttf'),
|
|
107
|
+
Fontisan::FontLoader.load('bold.ttf'),
|
|
108
|
+
Fontisan::FontLoader.load('italic.ttf')
|
|
109
|
+
]
|
|
110
|
+
|
|
111
|
+
Fontisan::CollectionWriter.pack(fonts, 'family.ttc')
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Table Deduplication
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
# Deduplicate tables when packing
|
|
118
|
+
fontisan pack *.ttf --output family.ttc --deduplicate
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Benefits:
|
|
122
|
+
- Smaller file size
|
|
123
|
+
- Identical tables shared
|
|
124
|
+
- Optimized storage
|
|
125
|
+
|
|
126
|
+
## Converting Collections
|
|
127
|
+
|
|
128
|
+
### TTC to OTC
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
fontisan convert family.ttc --to otc --output family.otc
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
### OTC to TTC
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
fontisan convert family.otc --to ttc --output family.ttc
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
## Apple dfont
|
|
141
|
+
|
|
142
|
+
dfont supports mixed font types:
|
|
143
|
+
|
|
144
|
+
```bash
|
|
145
|
+
# Convert TTC to dfont
|
|
146
|
+
fontisan convert family.ttc --to dfont --output family.dfont
|
|
147
|
+
```
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Apple dfont
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Apple dfont
|
|
6
|
+
|
|
7
|
+
Apple Data Fork Font (dfont) is a legacy Mac OS X format.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
- **Container**: Resource fork format in data fork
|
|
12
|
+
- **Font Types**: TrueType, OpenType, or mixed
|
|
13
|
+
- **Platform**: macOS specific
|
|
14
|
+
|
|
15
|
+
## Structure
|
|
16
|
+
|
|
17
|
+
dfont uses resource fork structure:
|
|
18
|
+
- Resource map
|
|
19
|
+
- Resource data
|
|
20
|
+
- Multiple font resources
|
|
21
|
+
|
|
22
|
+
## Loading
|
|
23
|
+
|
|
24
|
+
```ruby
|
|
25
|
+
font = Fontisan::FontLoader.load('font.dfont')
|
|
26
|
+
|
|
27
|
+
# Access as collection
|
|
28
|
+
if font.respond_to?(:each)
|
|
29
|
+
font.each do |f|
|
|
30
|
+
puts "#{f.family_name} #{f.style}"
|
|
31
|
+
end
|
|
32
|
+
end
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Extracting
|
|
36
|
+
|
|
37
|
+
### CLI
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
# List fonts in dfont
|
|
41
|
+
fontisan ls font.dfont
|
|
42
|
+
|
|
43
|
+
# Extract all
|
|
44
|
+
fontisan unpack font.dfont --output-dir ./extracted
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### API
|
|
48
|
+
|
|
49
|
+
```ruby
|
|
50
|
+
dfont = Fontisan::FontLoader.load('font.dfont')
|
|
51
|
+
|
|
52
|
+
dfont.each_with_index do |font, index|
|
|
53
|
+
output = "font-#{index}.ttf"
|
|
54
|
+
Fontisan::FontWriter.write(font, output)
|
|
55
|
+
end
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Converting
|
|
59
|
+
|
|
60
|
+
### dfont to TTF
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
fontisan convert font.dfont --to ttf --output font.ttf
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### dfont to OTF
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
fontisan convert font.dfont --to otf --output font.otf
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### To dfont
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# From TTC
|
|
76
|
+
fontisan convert family.ttc --to dfont --output family.dfont
|
|
77
|
+
|
|
78
|
+
# From individual fonts
|
|
79
|
+
fontisan pack regular.ttf bold.ttf --output family.dfont
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Limitations
|
|
83
|
+
|
|
84
|
+
- **macOS only** — Not cross-platform
|
|
85
|
+
- **Legacy format** — Modern formats preferred
|
|
86
|
+
- **Limited support** — Some tools don't read dfont
|
|
87
|
+
|
|
88
|
+
## When to Use
|
|
89
|
+
|
|
90
|
+
- **Legacy Mac fonts** — Converting old resources
|
|
91
|
+
- **Resource fork recovery** — Extracting embedded fonts
|
|
92
|
+
- **macOS compatibility** — When required
|
|
93
|
+
|
|
94
|
+
## Modern Alternatives
|
|
95
|
+
|
|
96
|
+
For new fonts, prefer:
|
|
97
|
+
- **TTC** — TrueType Collection
|
|
98
|
+
- **OTC** — OpenType Collection
|
|
99
|
+
- **WOFF2** — Web delivery
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Font Formats Overview
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Font Formats Overview
|
|
6
|
+
|
|
7
|
+
Fontisan supports a wide range of font formats.
|
|
8
|
+
|
|
9
|
+
## Supported Formats
|
|
10
|
+
|
|
11
|
+
### Modern Formats
|
|
12
|
+
|
|
13
|
+
| Format | Extension | Description |
|
|
14
|
+
|--------|-----------|-------------|
|
|
15
|
+
| TrueType | .ttf | Standard TrueType font |
|
|
16
|
+
| OpenType | .otf | CFF-based OpenType font |
|
|
17
|
+
| WOFF | .woff | Web Open Font Format |
|
|
18
|
+
| WOFF2 | .woff2 | Web Open Font Format 2 |
|
|
19
|
+
|
|
20
|
+
### Legacy Formats
|
|
21
|
+
|
|
22
|
+
| Format | Extension | Description |
|
|
23
|
+
|--------|-----------|-------------|
|
|
24
|
+
| Type 1 | .pfb, .pfa | Adobe Type 1 font |
|
|
25
|
+
| dfont | .dfont | Apple Data Fork font |
|
|
26
|
+
| TTC | .ttc | TrueType Collection |
|
|
27
|
+
| OTC | .otc | OpenType Collection |
|
|
28
|
+
|
|
29
|
+
### Other Formats
|
|
30
|
+
|
|
31
|
+
| Format | Extension | Description |
|
|
32
|
+
|--------|-----------|-------------|
|
|
33
|
+
| SVG | .svg | SVG font |
|
|
34
|
+
|
|
35
|
+
## Guides
|
|
36
|
+
|
|
37
|
+
- [TrueType (TTF)](/guide/formats/ttf) — TrueType font format
|
|
38
|
+
- [OpenType (OTF)](/guide/formats/otf) — OpenType/CFF format
|
|
39
|
+
- [Type 1 (PFB/PFA)](/guide/formats/type1) — Adobe Type 1 fonts
|
|
40
|
+
- [WOFF & WOFF2](/guide/formats/woff) — Web font formats
|
|
41
|
+
- [Collections](/guide/formats/collections) — TTC and OTC collections
|
|
42
|
+
- [Apple dfont](/guide/formats/dfont) — Apple legacy format
|
|
43
|
+
- [SVG Fonts](/guide/formats/svg) — SVG-based fonts
|
|
44
|
+
|
|
45
|
+
## Format Detection
|
|
46
|
+
|
|
47
|
+
Fontisan automatically detects font format:
|
|
48
|
+
|
|
49
|
+
```ruby
|
|
50
|
+
# Works with any format
|
|
51
|
+
font = Fontisan::FontLoader.load('font.ttf')
|
|
52
|
+
font = Fontisan::FontLoader.load('font.otf')
|
|
53
|
+
font = Fontisan::FontLoader.load('font.pfb')
|
|
54
|
+
font = Fontisan::FontLoader.load('font.woff2')
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Conversion Matrix
|
|
58
|
+
|
|
59
|
+
| From | To TTF | To OTF | To WOFF | To WOFF2 |
|
|
60
|
+
|------|--------|--------|---------|----------|
|
|
61
|
+
| TTF | ✓ | ✓ | ✓ | ✓ |
|
|
62
|
+
| OTF | ✓ | ✓ | ✓ | ✓ |
|
|
63
|
+
| Type 1 | ✓ | ✓ | ✓ | ✓ |
|
|
64
|
+
| WOFF | ✓ | ✓ | ✓ | ✓ |
|
|
65
|
+
| WOFF2 | ✓ | ✓ | ✓ | ✓ |
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: OpenType (OTF)
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# OpenType (OTF)
|
|
6
|
+
|
|
7
|
+
OpenType/CFF uses cubic Bézier curves in a Compact Font Format.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
- **Curve Type**: Cubic Bézier
|
|
12
|
+
- **Hinting**: PostScript hints
|
|
13
|
+
- **Storage**: CFF table
|
|
14
|
+
|
|
15
|
+
## Key Tables
|
|
16
|
+
|
|
17
|
+
| Table | Purpose |
|
|
18
|
+
|-------|---------|
|
|
19
|
+
| head | Font header |
|
|
20
|
+
| hhea | Horizontal header |
|
|
21
|
+
| maxp | Maximum profile |
|
|
22
|
+
| name | Name records |
|
|
23
|
+
| cmap | Character mapping |
|
|
24
|
+
| CFF | Compact Font Format |
|
|
25
|
+
| hmtx | Horizontal metrics |
|
|
26
|
+
| post | PostScript names |
|
|
27
|
+
| OS/2 | OS/2 metrics |
|
|
28
|
+
| GSUB | Glyph substitution |
|
|
29
|
+
| GPOS | Glyph positioning |
|
|
30
|
+
|
|
31
|
+
## CFF Table Structure
|
|
32
|
+
|
|
33
|
+
```ruby
|
|
34
|
+
cff = font.tables['CFF']
|
|
35
|
+
|
|
36
|
+
# Top DICT
|
|
37
|
+
top_dict = cff.top_dicts.first
|
|
38
|
+
|
|
39
|
+
# Name
|
|
40
|
+
puts "Font name: #{cff.names.first}"
|
|
41
|
+
|
|
42
|
+
# Private DICT
|
|
43
|
+
private = top_dict[:private]
|
|
44
|
+
puts "Blue values: #{private[:blue_values]}"
|
|
45
|
+
puts "Std HW: #{private[:std_hw]}"
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## CharStrings
|
|
49
|
+
|
|
50
|
+
```ruby
|
|
51
|
+
cff = font.tables['CFF']
|
|
52
|
+
|
|
53
|
+
# Access CharStrings
|
|
54
|
+
charstrings = cff.charstrings
|
|
55
|
+
|
|
56
|
+
charstrings.each_with_index do |charstring, glyph_id|
|
|
57
|
+
puts "Glyph #{glyph_id}: #{charstring.length} operators"
|
|
58
|
+
end
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## Hinting
|
|
62
|
+
|
|
63
|
+
OpenType fonts use PostScript hints:
|
|
64
|
+
|
|
65
|
+
```ruby
|
|
66
|
+
private = font.tables['CFF'].top_dicts.first[:private]
|
|
67
|
+
|
|
68
|
+
# Blue zones
|
|
69
|
+
puts "Blue values: #{private[:blue_values]}"
|
|
70
|
+
puts "Other blues: #{private[:other_blues]}"
|
|
71
|
+
|
|
72
|
+
# Stem widths
|
|
73
|
+
puts "Std HW: #{private[:std_hw]}"
|
|
74
|
+
puts "Std VW: #{private[:std_vw]}"
|
|
75
|
+
puts "Stem snap H: #{private[:stem_snap_h]}"
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Converting
|
|
79
|
+
|
|
80
|
+
### OTF to TTF
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
fontisan convert font.otf --to ttf --output font.ttf
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### OTF to WOFF2
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
fontisan convert font.otf --to woff2 --output font.woff2
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## Characteristics
|
|
93
|
+
|
|
94
|
+
### Advantages
|
|
95
|
+
|
|
96
|
+
- **Smaller file size** — CFF compression
|
|
97
|
+
- **Cubic curves** — Fewer points needed
|
|
98
|
+
- **PostScript heritage** — Print workflows
|
|
99
|
+
|
|
100
|
+
### Limitations
|
|
101
|
+
|
|
102
|
+
- **Limited hinting** — PostScript hints vs TrueType
|
|
103
|
+
- **Variable support** — CFF2 required
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: SVG Fonts
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# SVG Fonts
|
|
6
|
+
|
|
7
|
+
SVG fonts define glyphs using SVG graphics.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
- **Format**: SVG document
|
|
12
|
+
- **Features**: Full SVG capabilities
|
|
13
|
+
- **Use Case**: Specialized applications
|
|
14
|
+
|
|
15
|
+
## Structure
|
|
16
|
+
|
|
17
|
+
SVG fonts are SVG documents with font definitions:
|
|
18
|
+
|
|
19
|
+
```xml
|
|
20
|
+
<svg>
|
|
21
|
+
<font>
|
|
22
|
+
<font-face font-family="MyFont"/>
|
|
23
|
+
<glyph unicode="A" d="M0 0 L100 0..."/>
|
|
24
|
+
</font>
|
|
25
|
+
</svg>
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Loading
|
|
29
|
+
|
|
30
|
+
```ruby
|
|
31
|
+
font = Fontisan::FontLoader.load('font.svg')
|
|
32
|
+
|
|
33
|
+
# Access glyphs
|
|
34
|
+
font.glyphs.each do |glyph|
|
|
35
|
+
puts glyph.unicode
|
|
36
|
+
puts glyph.path_data
|
|
37
|
+
end
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Creating
|
|
41
|
+
|
|
42
|
+
SVG fonts can be created manually or with tools:
|
|
43
|
+
|
|
44
|
+
```ruby
|
|
45
|
+
# Export to SVG
|
|
46
|
+
Fontisan::FontWriter.write(font, 'output.svg', format: :svg)
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Converting
|
|
50
|
+
|
|
51
|
+
### SVG to TTF
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
fontisan convert font.svg --to ttf --output font.ttf
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### SVG to OTF
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
fontisan convert font.svg --to otf --output font.otf
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### From other formats
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
fontisan convert font.ttf --to svg --output font.svg
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Limitations
|
|
70
|
+
|
|
71
|
+
- **No hinting** — SVG has no hint support
|
|
72
|
+
- **Large files** — XML overhead
|
|
73
|
+
- **Limited layout** — No GSUB/GPOS
|
|
74
|
+
- **Variable support** — No variable fonts
|
|
75
|
+
|
|
76
|
+
## SVG vs COLR/CPAL
|
|
77
|
+
|
|
78
|
+
| Feature | SVG Font | COLR/CPAL |
|
|
79
|
+
|---------|----------|-----------|
|
|
80
|
+
| File size | Large | Small |
|
|
81
|
+
| Effects | Full | Limited |
|
|
82
|
+
| Browser support | Good | Good |
|
|
83
|
+
| Variable fonts | No | Yes |
|
|
84
|
+
| Performance | Slow | Fast |
|
|
85
|
+
|
|
86
|
+
## When to Use
|
|
87
|
+
|
|
88
|
+
- **SVG workflows** — Integration with SVG graphics
|
|
89
|
+
- **Special effects** — Complex visual effects
|
|
90
|
+
- **Legacy content** — Existing SVG fonts
|
|
91
|
+
|
|
92
|
+
## Modern Alternatives
|
|
93
|
+
|
|
94
|
+
For most uses, prefer:
|
|
95
|
+
- **COLR/CPAL** — Color fonts
|
|
96
|
+
- **WOFF2** — Web delivery
|
|
97
|
+
- **OTF/TTF** — General use
|