fontisan 0.4.49-x86_64-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,220 @@
|
|
|
1
|
+
= WOFF and WOFF2 Font Format Support
|
|
2
|
+
|
|
3
|
+
== General
|
|
4
|
+
|
|
5
|
+
Fontisan provides comprehensive support for Web Open Font Format (WOFF) and WOFF2,
|
|
6
|
+
including reading, writing, and conversion between these and other font formats.
|
|
7
|
+
|
|
8
|
+
WOFF is a wrapper around SFNT fonts (TTF/OTF) using zlib compression, while WOFF2
|
|
9
|
+
uses Brotli compression for better compression ratios and table transformations.
|
|
10
|
+
|
|
11
|
+
== W3C specification compliance
|
|
12
|
+
|
|
13
|
+
Fontisan's WOFF and WOFF2 implementations are fully compliant with the
|
|
14
|
+
W3C Recommendations:
|
|
15
|
+
|
|
16
|
+
* **WOFF 1.0** (W3C Recommendation, 13 December 2012):
|
|
17
|
+
https://www.w3.org/TR/WOFF/[spec] — reading and writing
|
|
18
|
+
* **WOFF 2.0** (W3C Recommendation, 08 August 2024):
|
|
19
|
+
https://www.w3.org/TR/WOFF2/[spec] — reading and writing
|
|
20
|
+
|
|
21
|
+
=== WOFF 2.0 (spec section references below)
|
|
22
|
+
|
|
23
|
+
Compliance covers every normative requirement of the WOFF2 spec:
|
|
24
|
+
|
|
25
|
+
* *Section 3.2 (WOFF2 Header)*: 48-byte header with correct signature
|
|
26
|
+
(`wOF2`), flavor, file length, reserved=0, totalSfntSize,
|
|
27
|
+
totalCompressedSize, version, and meta/private offset/length fields.
|
|
28
|
+
* *Section 4.1 (Table directory)*: flags byte structure (bits 0-5 tag
|
|
29
|
+
index, bits 6-7 transform version); optional 4-byte custom tag when
|
|
30
|
+
index=63; `transformLength` field present IFF table is transformed.
|
|
31
|
+
* *Section 4.2 (Collection directory)*: full support for flavor=`ttcf`
|
|
32
|
+
font collections — CollectionHeader + CollectionFontEntry per font,
|
|
33
|
+
with deduplicated tables shared across fonts via directory indices.
|
|
34
|
+
* *Section 5 (Compressed data)*: single Brotli stream of all tables in
|
|
35
|
+
directory order; `DSIG` table removed per encoder rule; `head.flags`
|
|
36
|
+
bit 11 set to indicate lossless modifying transform.
|
|
37
|
+
* *Section 5.1 (Transformed glyf table)*: 36-byte header (uint16
|
|
38
|
+
version + uint16 optionFlags + uint16 numGlyphs + uint16 indexFormat
|
|
39
|
+
+ 7 × uint32 stream sizes); 7 streams in spec order (nContour,
|
|
40
|
+
nPoints, flags, glyph, composite, bbox with bboxBitmap prefix,
|
|
41
|
+
instructions); optional overlapSimpleBitmap when optionFlags bit 0
|
|
42
|
+
is set; bboxBitmap semantics per spec (composite glyphs always have
|
|
43
|
+
explicit bbox, simple glyphs omit when calculated bbox matches,
|
|
44
|
+
empty glyphs MUST have all-zero bbox).
|
|
45
|
+
* *Section 5.2 (Triplet coordinate encoding)*: variable-length
|
|
46
|
+
coordinate codec with all 128 flag index variants (1-4 byte
|
|
47
|
+
payloads based on coordinate magnitude); bit 7 = off-curve flag.
|
|
48
|
+
* *Section 5.3 (Transformed loca table)*: `transformLength` MUST be 0;
|
|
49
|
+
loca data omitted from compressed stream (reconstructed by decoder
|
|
50
|
+
from glyf).
|
|
51
|
+
* *Section 5.4 (Transformed hmtx table)*: optional version 1 transform
|
|
52
|
+
exploiting `lsb == xMin` redundancy.
|
|
53
|
+
* *Section 5.5 (Table order constraints)*: loca MUST immediately
|
|
54
|
+
follow glyf in table directory; for collections, loca MUST
|
|
55
|
+
immediately follow its corresponding glyf with no other tables in
|
|
56
|
+
between.
|
|
57
|
+
|
|
58
|
+
Validation: fontisan's WOFF2 output is verified byte-identical to
|
|
59
|
+
fontTools' output for transformed glyf tables, and round-trips
|
|
60
|
+
correctly through the W3C `woff2_decompress` reference tool.
|
|
61
|
+
|
|
62
|
+
=== WOFF 1.0
|
|
63
|
+
|
|
64
|
+
* *Section 4 (WOFF Header)*: 44-byte header with correct signature
|
|
65
|
+
(`wOFF`), flavor, length, numTables, reserved=0, totalSfntSize,
|
|
66
|
+
version, and meta/private offset/length fields.
|
|
67
|
+
* *Section 5 (Table directory)*: 20-byte entries with tag, offset,
|
|
68
|
+
compLength, origLength, origChecksum. Tables sorted in input font
|
|
69
|
+
order per spec ("MUST be stored in the same order as the
|
|
70
|
+
well-formed input font").
|
|
71
|
+
* *Section 6 (Font data tables)*: tables compressed individually with
|
|
72
|
+
zlib (compress2-compatible); each table 4-byte aligned and
|
|
73
|
+
zero-padded to next boundary ("MUST begin on 4-byte boundaries and
|
|
74
|
+
be zero-padded to the next 4-byte boundary").
|
|
75
|
+
* *Section 7 (Extended metadata)*: optional block of XML data,
|
|
76
|
+
always zlib-compressed ("it is never stored in uncompressed form").
|
|
77
|
+
* *Section 8 (Private data)*: optional block of arbitrary bytes,
|
|
78
|
+
always 4-byte aligned.
|
|
79
|
+
|
|
80
|
+
Validation: fontisan's WOFF 1 output round-trips through fontTools
|
|
81
|
+
without errors; all 4-byte alignment, padding, and compression
|
|
82
|
+
requirements verified by spec-conformance specs.
|
|
83
|
+
|
|
84
|
+
=== Display WOFF/WOFF2 font information
|
|
85
|
+
|
|
86
|
+
Show metadata specific to WOFF/WOFF2 fonts including version, compression details,
|
|
87
|
+
and original font flavor.
|
|
88
|
+
|
|
89
|
+
[source,shell]
|
|
90
|
+
----
|
|
91
|
+
$ fontisan info FONT.woff [--format FORMAT]
|
|
92
|
+
----
|
|
93
|
+
|
|
94
|
+
Where,
|
|
95
|
+
|
|
96
|
+
`FONT.woff`:: Path to the WOFF or WOFF2 file
|
|
97
|
+
`FORMAT`:: Output format: `text` (default), `json`, or `yaml`
|
|
98
|
+
|
|
99
|
+
.Major version from WOFF/WOFF2 header
|
|
100
|
+
[example]
|
|
101
|
+
====
|
|
102
|
+
[source,shell]
|
|
103
|
+
----
|
|
104
|
+
$ fontisan info /path/to/your/font.woff
|
|
105
|
+
|
|
106
|
+
Font type: WOFF (TrueType)
|
|
107
|
+
Family: Example Font
|
|
108
|
+
WOFF Major Version: 1
|
|
109
|
+
WOFF Minor Version: 0
|
|
110
|
+
WOFF Metadata: 0 entries
|
|
111
|
+
WOFF Private Data: 0 bytes
|
|
112
|
+
Original Font Flavor: TrueType
|
|
113
|
+
----
|
|
114
|
+
====
|
|
115
|
+
|
|
116
|
+
=== WOFF2 validation
|
|
117
|
+
|
|
118
|
+
Fontisan validates WOFF2 fonts according to the specification, checking:
|
|
119
|
+
|
|
120
|
+
* Required table presence and order
|
|
121
|
+
* Table transformation flags (glyf, loca transformations)
|
|
122
|
+
* Checksum validation for transformed tables
|
|
123
|
+
* Compression format validation
|
|
124
|
+
|
|
125
|
+
.Validation example
|
|
126
|
+
[example]
|
|
127
|
+
====
|
|
128
|
+
[source,shell]
|
|
129
|
+
----
|
|
130
|
+
$ fontisan validate font.woff2 -t web
|
|
131
|
+
|
|
132
|
+
CHECK_ID | STATUS | SEVERITY
|
|
133
|
+
--------------------------------------------------------------
|
|
134
|
+
woff2_required_tables | PASS | error
|
|
135
|
+
woff2_table_transformations | PASS | error
|
|
136
|
+
woff2_checksum_validation | PASS | error
|
|
137
|
+
----
|
|
138
|
+
====
|
|
139
|
+
|
|
140
|
+
=== Convert fonts to WOFF/WOFF2
|
|
141
|
+
|
|
142
|
+
Convert TTF/OTF fonts to web-optimized formats.
|
|
143
|
+
|
|
144
|
+
[source,shell]
|
|
145
|
+
----
|
|
146
|
+
$ fontisan convert INPUT.ttf --to woff --output output.woff
|
|
147
|
+
$ fontisan convert INPUT.ttf --to woff2 --output output.woff2
|
|
148
|
+
----
|
|
149
|
+
|
|
150
|
+
=== Choosing between WOFF and WOFF2
|
|
151
|
+
|
|
152
|
+
WOFF and WOFF2 use different compression algorithms, fixed by their specs.
|
|
153
|
+
The format you choose **is** the choice of algorithm — there is no separate
|
|
154
|
+
`--compression` flag.
|
|
155
|
+
|
|
156
|
+
[options="header"]
|
|
157
|
+
|====
|
|
158
|
+
| Format | Algorithm | Compatibility | Typical size
|
|
159
|
+
| WOFF | zlib | All browsers (legacy-safe) | baseline
|
|
160
|
+
| WOFF2 | Brotli | Modern browsers only | ~30% smaller than WOFF
|
|
161
|
+
|====
|
|
162
|
+
|
|
163
|
+
If you need to support old browsers that lack Brotli decoders, use WOFF:
|
|
164
|
+
|
|
165
|
+
[source,shell]
|
|
166
|
+
----
|
|
167
|
+
$ fontisan convert INPUT.ttf --to woff --output out.woff --zlib-level 9
|
|
168
|
+
----
|
|
169
|
+
|
|
170
|
+
For modern-only delivery, WOFF2 is preferred:
|
|
171
|
+
|
|
172
|
+
[source,shell]
|
|
173
|
+
----
|
|
174
|
+
$ fontisan convert INPUT.ttf --to woff2 --output out.woff2
|
|
175
|
+
----
|
|
176
|
+
|
|
177
|
+
Note: WOFF2 mandates Brotli, WOFF mandates zlib. The container format is the
|
|
178
|
+
algorithm selector — you cannot mix and match.
|
|
179
|
+
|
|
180
|
+
==== Per-format compression knobs
|
|
181
|
+
|
|
182
|
+
Each container exposes only the knobs that apply to it. Options declared for
|
|
183
|
+
the wrong target format raise a clear `ArgumentError` at convert time.
|
|
184
|
+
|
|
185
|
+
[options="header"]
|
|
186
|
+
|====
|
|
187
|
+
| Format | Knob | Range / values | Default
|
|
188
|
+
| WOFF | `--zlib-level` | 0–9 | 6
|
|
189
|
+
| WOFF | `--uncompressed` | (flag) | off
|
|
190
|
+
| WOFF | `--compression-threshold` | bytes | 100
|
|
191
|
+
| WOFF2 | `--brotli-quality` | 0–11 | 11
|
|
192
|
+
| WOFF2 | `--[no-]transform-tables` | (flag) | off
|
|
193
|
+
|====
|
|
194
|
+
|
|
195
|
+
The same knobs are available on the Ruby API via keyword arguments:
|
|
196
|
+
|
|
197
|
+
[source,ruby]
|
|
198
|
+
----
|
|
199
|
+
Fontisan.convert("f.ttf", to: :woff, output: "f.woff", zlib_level: 9)
|
|
200
|
+
Fontisan.convert("f.ttf", to: :woff2, output: "f.woff2", brotli_quality: 11)
|
|
201
|
+
----
|
|
202
|
+
|
|
203
|
+
.Conversion with optimization
|
|
204
|
+
[example]
|
|
205
|
+
====
|
|
206
|
+
[source,shell]
|
|
207
|
+
----
|
|
208
|
+
$ fontisan convert font.ttf --to woff2 --output font.woff2
|
|
209
|
+
|
|
210
|
+
Converting font.ttf to WOFF2...
|
|
211
|
+
Input: 245.8 KB (TTF)
|
|
212
|
+
Output: 89.2 KB (WOFF2)
|
|
213
|
+
Ratio: 63.7% reduction
|
|
214
|
+
|
|
215
|
+
Compression details:
|
|
216
|
+
Tables: 12
|
|
217
|
+
Brotli compression: Applied
|
|
218
|
+
Transformed tables: glyf, loca
|
|
219
|
+
----
|
|
220
|
+
====
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: ConversionOptions
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# ConversionOptions
|
|
6
|
+
|
|
7
|
+
Type-safe conversion configuration.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::ConversionOptions` provides a type-safe way to configure font conversions.
|
|
12
|
+
|
|
13
|
+
## Class Methods
|
|
14
|
+
|
|
15
|
+
### recommended(from:, to:)
|
|
16
|
+
|
|
17
|
+
Get recommended options for a conversion type.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
|
|
21
|
+
# => #<Fontisan::ConversionOptions ...>
|
|
22
|
+
|
|
23
|
+
# Access settings
|
|
24
|
+
options.opening # => { convert_curves: true, ... }
|
|
25
|
+
options.generating # => { hinting_mode: "auto", ... }
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
**Parameters:**
|
|
29
|
+
|
|
30
|
+
| Name | Type | Description |
|
|
31
|
+
|------|------|-------------|
|
|
32
|
+
| from | Symbol | Source format |
|
|
33
|
+
| to | Symbol | Target format |
|
|
34
|
+
|
|
35
|
+
### from_preset(name)
|
|
36
|
+
|
|
37
|
+
Load options from a named preset.
|
|
38
|
+
|
|
39
|
+
```ruby
|
|
40
|
+
# Web optimization preset
|
|
41
|
+
options = Fontisan::ConversionOptions.from_preset(:web_optimized)
|
|
42
|
+
|
|
43
|
+
# Type 1 to modern
|
|
44
|
+
options = Fontisan::ConversionOptions.from_preset(:type1_to_modern)
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
**Available Presets:**
|
|
48
|
+
|
|
49
|
+
| Preset | From | To |
|
|
50
|
+
|--------|------|-----|
|
|
51
|
+
| `type1_to_modern` | Type 1 | OTF |
|
|
52
|
+
| `modern_to_type1` | OTF | Type 1 |
|
|
53
|
+
| `web_optimized` | OTF | WOFF2 |
|
|
54
|
+
| `legacy_web` | OTF | WOFF |
|
|
55
|
+
| `archive_to_modern` | TTC | OTF |
|
|
56
|
+
|
|
57
|
+
### new(**kwargs)
|
|
58
|
+
|
|
59
|
+
Create custom options.
|
|
60
|
+
|
|
61
|
+
```ruby
|
|
62
|
+
options = Fontisan::ConversionOptions.new(
|
|
63
|
+
from: :ttf,
|
|
64
|
+
to: :otf,
|
|
65
|
+
opening: {
|
|
66
|
+
convert_curves: true,
|
|
67
|
+
autohint: true
|
|
68
|
+
},
|
|
69
|
+
generating: {
|
|
70
|
+
hinting_mode: 'auto',
|
|
71
|
+
optimize_tables: true
|
|
72
|
+
}
|
|
73
|
+
)
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Instance Attributes
|
|
77
|
+
|
|
78
|
+
### opening
|
|
79
|
+
|
|
80
|
+
Opening options control source font processing.
|
|
81
|
+
|
|
82
|
+
| Option | Type | Default |
|
|
83
|
+
|--------|------|---------|
|
|
84
|
+
| `decompose_composites` | Boolean | false |
|
|
85
|
+
| `convert_curves` | Boolean | true |
|
|
86
|
+
| `scale_to_1000` | Boolean | false |
|
|
87
|
+
| `scale_from_1000` | Boolean | false |
|
|
88
|
+
| `autohint` | Boolean | false |
|
|
89
|
+
| `generate_unicode` | Boolean | false |
|
|
90
|
+
| `store_custom_tables` | Boolean | true |
|
|
91
|
+
| `store_native_hinting` | Boolean | false |
|
|
92
|
+
| `interpret_ot` | Boolean | false |
|
|
93
|
+
| `read_all_records` | Boolean | false |
|
|
94
|
+
| `preserve_encoding` | String | nil |
|
|
95
|
+
|
|
96
|
+
### generating
|
|
97
|
+
|
|
98
|
+
Generating options control output font writing.
|
|
99
|
+
|
|
100
|
+
| Option | Type | Default | Applies to |
|
|
101
|
+
|--------|------|---------|------------|
|
|
102
|
+
| `write_pfm` | Boolean | false | Type 1 output |
|
|
103
|
+
| `write_afm` | Boolean | false | Type 1 output |
|
|
104
|
+
| `write_inf` | Boolean | false | Type 1 output |
|
|
105
|
+
| `select_encoding_automatically` | Boolean | false | Type 1 output |
|
|
106
|
+
| `hinting_mode` | String | 'preserve' | All outline conversions |
|
|
107
|
+
| `decompose_on_output` | Boolean | false | All outline conversions |
|
|
108
|
+
| `write_custom_tables` | Boolean | true | All |
|
|
109
|
+
| `optimize_tables` | Boolean | false | All |
|
|
110
|
+
| `zlib_level` | Integer (0–9) | 6 | WOFF only |
|
|
111
|
+
| `uncompressed` | Boolean | false | WOFF only |
|
|
112
|
+
| `compression_threshold` | Integer (bytes) | 100 | WOFF only |
|
|
113
|
+
| `brotli_quality` | Integer (0–11) | 11 | WOFF2 only |
|
|
114
|
+
| `transform_tables` | Boolean | false | WOFF2 only |
|
|
115
|
+
| `metadata_xml` | String | nil | WOFF only |
|
|
116
|
+
| `private_data` | String | nil | WOFF only |
|
|
117
|
+
| `preserve_metadata` | Boolean | true | All |
|
|
118
|
+
|
|
119
|
+
Compression knobs are declared by each strategy (`WoffWriter`, `Woff2Encoder`)
|
|
120
|
+
via the `ConversionStrategy` DSL. `FormatConverter.validate_options_for_target!`
|
|
121
|
+
rejects knobs that don't apply to the requested target format.
|
|
122
|
+
|
|
123
|
+
## Examples
|
|
124
|
+
|
|
125
|
+
### Basic Conversion
|
|
126
|
+
|
|
127
|
+
```ruby
|
|
128
|
+
options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
|
|
129
|
+
converter = Fontisan::Converters::OutlineConverter.new
|
|
130
|
+
result = converter.convert(font, options: options)
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### Web Optimization
|
|
134
|
+
|
|
135
|
+
```ruby
|
|
136
|
+
options = Fontisan::ConversionOptions.from_preset(:web_optimized)
|
|
137
|
+
Fontisan::FontWriter.write(font, 'output.woff2', options: options)
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### Custom Options
|
|
141
|
+
|
|
142
|
+
```ruby
|
|
143
|
+
options = Fontisan::ConversionOptions.new(
|
|
144
|
+
from: :ttf,
|
|
145
|
+
to: :woff2,
|
|
146
|
+
opening: { autohint: true },
|
|
147
|
+
generating: {
|
|
148
|
+
hinting_mode: 'auto',
|
|
149
|
+
optimize_tables: true,
|
|
150
|
+
brotli_quality: 11,
|
|
151
|
+
transform_tables: true
|
|
152
|
+
}
|
|
153
|
+
)
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
### WOFF with Max zlib (Legacy Browser Reach)
|
|
157
|
+
|
|
158
|
+
```ruby
|
|
159
|
+
options = Fontisan::ConversionOptions.new(
|
|
160
|
+
from: :ttf,
|
|
161
|
+
to: :woff,
|
|
162
|
+
generating: { zlib_level: 9, preserve_metadata: true }
|
|
163
|
+
)
|
|
164
|
+
```
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: CurveConverter
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# CurveConverter
|
|
6
|
+
|
|
7
|
+
Convert between quadratic and cubic curves.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::Converters::CurveConverter` handles Bézier curve conversion.
|
|
12
|
+
|
|
13
|
+
## Methods
|
|
14
|
+
|
|
15
|
+
### quadratic_to_cubic(points)
|
|
16
|
+
|
|
17
|
+
Convert quadratic points to cubic.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
converter = Fontisan::Converters::CurveConverter.new
|
|
21
|
+
cubic = converter.quadratic_to_cubic(quadratic_points)
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### cubic_to_quadratic(points, tolerance: 0.5)
|
|
25
|
+
|
|
26
|
+
Convert cubic points to quadratic.
|
|
27
|
+
|
|
28
|
+
```ruby
|
|
29
|
+
quadratic = converter.cubic_to_quadratic(cubic_points, tolerance: 0.5)
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## See Also
|
|
33
|
+
|
|
34
|
+
- [OutlineConverter](/api/converters/outline-converter)
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: HintConverter
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# HintConverter
|
|
6
|
+
|
|
7
|
+
Convert hints between TrueType and PostScript formats.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::Converters::HintConverter` handles bidirectional hint conversion.
|
|
12
|
+
|
|
13
|
+
## Methods
|
|
14
|
+
|
|
15
|
+
### truetype_to_postscript(font)
|
|
16
|
+
|
|
17
|
+
Convert TrueType instructions to PostScript hints.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
converter = Fontisan::Converters::HintConverter.new
|
|
21
|
+
ps_hints = converter.truetype_to_postscript(font)
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### postscript_to_truetype(font)
|
|
25
|
+
|
|
26
|
+
Convert PostScript hints to TrueType instructions.
|
|
27
|
+
|
|
28
|
+
```ruby
|
|
29
|
+
ttf_tables = converter.postscript_to_truetype(font)
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## See Also
|
|
33
|
+
|
|
34
|
+
- [Font Hinting Guide](/guide/hinting/)
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: OutlineConverter
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# OutlineConverter
|
|
6
|
+
|
|
7
|
+
Convert font outlines between formats.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::Converters::OutlineConverter` handles TTF ↔ OTF conversion.
|
|
12
|
+
|
|
13
|
+
## Methods
|
|
14
|
+
|
|
15
|
+
### convert(font, options: nil)
|
|
16
|
+
|
|
17
|
+
Convert a font to a different format.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
converter = Fontisan::Converters::OutlineConverter.new
|
|
21
|
+
options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
|
|
22
|
+
result = converter.convert(font, options: options)
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## See Also
|
|
26
|
+
|
|
27
|
+
- [ConversionOptions](/api/conversion-options)
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: FontLoader
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# FontLoader
|
|
6
|
+
|
|
7
|
+
Unified font loading with automatic format detection.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::FontLoader` provides a unified interface for loading fonts in any supported format.
|
|
12
|
+
|
|
13
|
+
## Class Methods
|
|
14
|
+
|
|
15
|
+
### load(source)
|
|
16
|
+
|
|
17
|
+
Load a font from file path or IO.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
# From file path
|
|
21
|
+
font = Fontisan::FontLoader.load('font.ttf')
|
|
22
|
+
font = Fontisan::FontLoader.load('font.otf')
|
|
23
|
+
font = Fontisan::FontLoader.load('font.pfb')
|
|
24
|
+
font = Fontisan::FontLoader.load('font.woff2')
|
|
25
|
+
|
|
26
|
+
# From IO
|
|
27
|
+
font = Fontisan::FontLoader.load(File.open('font.ttf'))
|
|
28
|
+
|
|
29
|
+
# From string
|
|
30
|
+
font = Fontisan::FontLoader.load(File.read('font.ttf', mode: 'rb'))
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
**Parameters:**
|
|
34
|
+
|
|
35
|
+
| Name | Type | Description |
|
|
36
|
+
|------|------|-------------|
|
|
37
|
+
| source | String, IO | File path, IO object, or binary data |
|
|
38
|
+
|
|
39
|
+
**Returns:** SfntFont, Type1Font, or Collection
|
|
40
|
+
|
|
41
|
+
**Raises:** Fontisan::FormatError if format is unsupported
|
|
42
|
+
|
|
43
|
+
### detect_format(path)
|
|
44
|
+
|
|
45
|
+
Detect a font's on-disk format from its content (magic bytes). The file
|
|
46
|
+
extension is ignored — a `.ttc` that actually contains a single OpenType-CFF
|
|
47
|
+
font is reported as `:otf`.
|
|
48
|
+
|
|
49
|
+
```ruby
|
|
50
|
+
format = Fontisan::FontLoader.detect_format('font.ttf')
|
|
51
|
+
# => :ttf
|
|
52
|
+
|
|
53
|
+
format = Fontisan::FontLoader.detect_format('font.otf')
|
|
54
|
+
# => :otf
|
|
55
|
+
|
|
56
|
+
format = Fontisan::FontLoader.detect_format('font.pfb')
|
|
57
|
+
# => :pfb
|
|
58
|
+
|
|
59
|
+
format = Fontisan::FontLoader.detect_format('font.pfa')
|
|
60
|
+
# => :pfa
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**Returns:** Symbol (`:ttf`, `:otf`, `:ttc`, `:otc`, `:woff`, `:woff2`,
|
|
64
|
+
`:dfont`, `:pfa`, `:pfb`) or `nil` if the format is not recognised.
|
|
65
|
+
|
|
66
|
+
## Supported Formats
|
|
67
|
+
|
|
68
|
+
| Symbol | Detection | Notes |
|
|
69
|
+
|---------|-------------|--------------------------------|
|
|
70
|
+
| `:ttf` | Magic bytes | TrueType |
|
|
71
|
+
| `:otf` | Magic bytes | OpenType / CFF |
|
|
72
|
+
| `:ttc` | Magic bytes | TrueType Collection |
|
|
73
|
+
| `:otc` | Magic bytes | OpenType Collection |
|
|
74
|
+
| `:woff` | Magic bytes | Web Open Font Format |
|
|
75
|
+
| `:woff2` | Magic bytes | Web Open Font Format 2 |
|
|
76
|
+
| `:pfb` | Marker byte | Adobe Type 1 Binary |
|
|
77
|
+
| `:pfa` | Text header | Adobe Type 1 ASCII |
|
|
78
|
+
| `:dfont` | Magic bytes | Apple Data-Fork resource fork |
|
|
79
|
+
|
|
80
|
+
## Examples
|
|
81
|
+
|
|
82
|
+
### Load with Error Handling
|
|
83
|
+
|
|
84
|
+
```ruby
|
|
85
|
+
begin
|
|
86
|
+
font = Fontisan::FontLoader.load(path)
|
|
87
|
+
puts "Loaded: #{font.family_name}"
|
|
88
|
+
rescue Fontisan::FormatError => e
|
|
89
|
+
puts "Unsupported format: #{e.message}"
|
|
90
|
+
rescue Errno::ENOENT => e
|
|
91
|
+
puts "File not found: #{path}"
|
|
92
|
+
end
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Batch Loading
|
|
96
|
+
|
|
97
|
+
```ruby
|
|
98
|
+
fonts = Dir.glob('fonts/*.ttf').map do |path|
|
|
99
|
+
Fontisan::FontLoader.load(path)
|
|
100
|
+
end
|
|
101
|
+
|
|
102
|
+
puts "Loaded #{fonts.length} fonts"
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### Detect and Load
|
|
106
|
+
|
|
107
|
+
```ruby
|
|
108
|
+
path = 'unknown.dat'
|
|
109
|
+
|
|
110
|
+
format = Fontisan::FontLoader.detect_format(path)
|
|
111
|
+
if format
|
|
112
|
+
puts "Detected format: #{format}"
|
|
113
|
+
font = Fontisan::FontLoader.load(path)
|
|
114
|
+
else
|
|
115
|
+
puts "Unknown format"
|
|
116
|
+
end
|
|
117
|
+
```
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: FontWriter
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# FontWriter
|
|
6
|
+
|
|
7
|
+
Write fonts to various formats.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::FontWriter` handles saving fonts to files in various formats.
|
|
12
|
+
|
|
13
|
+
## Class Methods
|
|
14
|
+
|
|
15
|
+
### write(font, path, options: {})
|
|
16
|
+
|
|
17
|
+
Write a font to a file.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
font = Fontisan::FontLoader.load('input.ttf')
|
|
21
|
+
|
|
22
|
+
# Write as TTF
|
|
23
|
+
Fontisan::FontWriter.write(font, 'output.ttf')
|
|
24
|
+
|
|
25
|
+
# Write as OTF
|
|
26
|
+
Fontisan::FontWriter.write(font, 'output.otf')
|
|
27
|
+
|
|
28
|
+
# Write as WOFF2
|
|
29
|
+
Fontisan::FontWriter.write(font, 'output.woff2')
|
|
30
|
+
|
|
31
|
+
# With options
|
|
32
|
+
options = Fontisan::ConversionOptions.new(
|
|
33
|
+
generating: { optimize_tables: true }
|
|
34
|
+
)
|
|
35
|
+
Fontisan::FontWriter.write(font, 'output.ttf', options: options)
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
**Parameters:**
|
|
39
|
+
|
|
40
|
+
| Name | Type | Description |
|
|
41
|
+
|------|------|-------------|
|
|
42
|
+
| font | SfntFont, Type1Font | Font object |
|
|
43
|
+
| path | String | Output file path |
|
|
44
|
+
| options | ConversionOptions | Optional settings |
|
|
45
|
+
|
|
46
|
+
**Returns:** Boolean
|
|
47
|
+
|
|
48
|
+
### write_to_file(data, path, sfnt_version: nil)
|
|
49
|
+
|
|
50
|
+
Write raw font data to a file.
|
|
51
|
+
|
|
52
|
+
```ruby
|
|
53
|
+
# Write raw table data
|
|
54
|
+
Fontisan::FontWriter.write_to_file(
|
|
55
|
+
font.table_data,
|
|
56
|
+
'output.ttf',
|
|
57
|
+
sfnt_version: 0x00010000
|
|
58
|
+
)
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## Output Formats
|
|
62
|
+
|
|
63
|
+
| Format | Extension | Notes |
|
|
64
|
+
|--------|-----------|-------|
|
|
65
|
+
| TTF | .ttf | TrueType |
|
|
66
|
+
| OTF | .otf | OpenType/CFF |
|
|
67
|
+
| WOFF | .woff | Web Open Font Format |
|
|
68
|
+
| WOFF2 | .woff2 | Web Open Font Format 2 |
|
|
69
|
+
| PFB | .pfb | Adobe Type 1 |
|
|
70
|
+
| SVG | .svg | SVG Font |
|
|
71
|
+
|
|
72
|
+
## Examples
|
|
73
|
+
|
|
74
|
+
### Convert and Write
|
|
75
|
+
|
|
76
|
+
```ruby
|
|
77
|
+
# Load TTF
|
|
78
|
+
font = Fontisan::FontLoader.load('input.ttf')
|
|
79
|
+
|
|
80
|
+
# Convert to OTF
|
|
81
|
+
options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
|
|
82
|
+
converter = Fontisan::Converters::OutlineConverter.new
|
|
83
|
+
otf_tables = converter.convert(font, options: options)
|
|
84
|
+
|
|
85
|
+
# Write OTF
|
|
86
|
+
Fontisan::FontWriter.write(otf_tables, 'output.otf')
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### Batch Writing
|
|
90
|
+
|
|
91
|
+
```ruby
|
|
92
|
+
fonts.each_with_index do |font, i|
|
|
93
|
+
Fontisan::FontWriter.write(font, "output-#{i}.ttf")
|
|
94
|
+
end
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Web Optimization
|
|
98
|
+
|
|
99
|
+
```ruby
|
|
100
|
+
font = Fontisan::FontLoader.load('input.otf')
|
|
101
|
+
options = Fontisan::ConversionOptions.from_preset(:web_optimized)
|
|
102
|
+
Fontisan::FontWriter.write(font, 'output.woff2', options: options)
|
|
103
|
+
```
|