fontisan 0.4.49-arm-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,105 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: TrueType (TTF)
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# TrueType (TTF)
|
|
6
|
+
|
|
7
|
+
TrueType is a standard font format using quadratic Bézier curves.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
- **Curve Type**: Quadratic Bézier
|
|
12
|
+
- **Hinting**: TrueType instructions
|
|
13
|
+
- **Storage**: glyf + loca tables
|
|
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
|
+
| glyf | Glyph outlines |
|
|
25
|
+
| loca | Glyph locations |
|
|
26
|
+
| hmtx | Horizontal metrics |
|
|
27
|
+
| post | PostScript names |
|
|
28
|
+
| prep | Control Value Program |
|
|
29
|
+
| fpgm | Font Program |
|
|
30
|
+
| cvt | Control Value Table |
|
|
31
|
+
|
|
32
|
+
## Loading
|
|
33
|
+
|
|
34
|
+
```ruby
|
|
35
|
+
font = Fontisan::FontLoader.load('font.ttf')
|
|
36
|
+
|
|
37
|
+
# Access tables
|
|
38
|
+
head = font.tables['head']
|
|
39
|
+
glyf = font.tables['glyf']
|
|
40
|
+
|
|
41
|
+
puts "Units per Em: #{head.units_per_em}"
|
|
42
|
+
puts "Glyphs: #{font.tables['maxp'].num_glyphs}"
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Glyph Outlines
|
|
46
|
+
|
|
47
|
+
```ruby
|
|
48
|
+
glyph = font.glyphs[42]
|
|
49
|
+
|
|
50
|
+
# Access outline
|
|
51
|
+
glyph.contours.each do |contour|
|
|
52
|
+
contour.points.each do |point|
|
|
53
|
+
if point.on_curve?
|
|
54
|
+
puts "Point at (#{point.x}, #{point.y})"
|
|
55
|
+
else
|
|
56
|
+
puts "Control at (#{point.x}, #{point.y})"
|
|
57
|
+
end
|
|
58
|
+
end
|
|
59
|
+
end
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## Hinting
|
|
63
|
+
|
|
64
|
+
TrueType fonts use bytecode instructions:
|
|
65
|
+
|
|
66
|
+
```ruby
|
|
67
|
+
prep = font.tables['prep']
|
|
68
|
+
fpgm = font.tables['fpgm']
|
|
69
|
+
cvt = font.tables['cvt']
|
|
70
|
+
|
|
71
|
+
if prep
|
|
72
|
+
puts "Prep program: #{prep.bytecode.length} bytes"
|
|
73
|
+
end
|
|
74
|
+
|
|
75
|
+
if cvt
|
|
76
|
+
puts "CVT entries: #{cvt.values.length}"
|
|
77
|
+
end
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Converting
|
|
81
|
+
|
|
82
|
+
### TTF to OTF
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
fontisan convert font.ttf --to otf --output font.otf
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### TTF to WOFF2
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
fontisan convert font.ttf --to woff2 --output font.woff2
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## Characteristics
|
|
95
|
+
|
|
96
|
+
### Advantages
|
|
97
|
+
|
|
98
|
+
- **Wide support** — All platforms
|
|
99
|
+
- **Excellent hinting** — TrueType instructions
|
|
100
|
+
- **Variable fonts** — gvar support
|
|
101
|
+
|
|
102
|
+
### Limitations
|
|
103
|
+
|
|
104
|
+
- **Larger file size** — Compared to CFF
|
|
105
|
+
- **Quadratic curves** — More points for complex shapes
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Type 1 (PFB/PFA)
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Type 1 (PFB/PFA)
|
|
6
|
+
|
|
7
|
+
Adobe Type 1 fonts are legacy PostScript fonts.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
- **Curve Type**: Cubic Bézier
|
|
12
|
+
- **Hinting**: PostScript hints
|
|
13
|
+
- **Formats**: PFB (binary), PFA (ASCII)
|
|
14
|
+
|
|
15
|
+
## File Formats
|
|
16
|
+
|
|
17
|
+
| Format | Extension | Description |
|
|
18
|
+
|--------|-----------|-------------|
|
|
19
|
+
| PFB | .pfb | Binary format |
|
|
20
|
+
| PFA | .pfa | ASCII format |
|
|
21
|
+
|
|
22
|
+
## Structure
|
|
23
|
+
|
|
24
|
+
Type 1 fonts contain:
|
|
25
|
+
|
|
26
|
+
1. **Font Dictionary** — Font info, encoding
|
|
27
|
+
2. **Private Dictionary** — Hinting parameters
|
|
28
|
+
3. **CharStrings** — Glyph outlines
|
|
29
|
+
4. **Subroutines** — Reusable outline segments
|
|
30
|
+
|
|
31
|
+
## Encryption
|
|
32
|
+
|
|
33
|
+
Type 1 fonts use encryption:
|
|
34
|
+
|
|
35
|
+
| Section | Key |
|
|
36
|
+
|---------|-----|
|
|
37
|
+
| eexec | 55665 |
|
|
38
|
+
| CharStrings | 4330 |
|
|
39
|
+
|
|
40
|
+
Fontisan handles decryption automatically.
|
|
41
|
+
|
|
42
|
+
## Loading
|
|
43
|
+
|
|
44
|
+
```ruby
|
|
45
|
+
font = Fontisan::FontLoader.load('font.pfb')
|
|
46
|
+
|
|
47
|
+
# Access font info
|
|
48
|
+
puts "Family: #{font.family_name}"
|
|
49
|
+
puts "Glyphs: #{font.glyph_count}"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## CharStrings
|
|
53
|
+
|
|
54
|
+
```ruby
|
|
55
|
+
# Type 1 CharStrings use operators
|
|
56
|
+
# hstem, vstem, moveto, lineto, curveto, etc.
|
|
57
|
+
|
|
58
|
+
font.charstrings.each do |glyph_name, charstring|
|
|
59
|
+
puts "#{glyph_name}: #{charstring.length} bytes"
|
|
60
|
+
end
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## seac Composites
|
|
64
|
+
|
|
65
|
+
Type 1 supports composite characters via `seac`:
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
# Example: é = e + acute accent
|
|
69
|
+
# seac references two glyphs by name
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
When converting to CFF, seac must be expanded (CFF doesn't support it).
|
|
73
|
+
|
|
74
|
+
## Converting
|
|
75
|
+
|
|
76
|
+
### Type 1 to OTF
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
fontisan convert font.pfb --to otf --output font.otf
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Type 1 to TTF
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
fontisan convert font.pfb --to ttf --output font.ttf
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### With Unicode Generation
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
# Generate Unicode mappings from glyph names
|
|
92
|
+
fontisan convert font.pfb --to otf --generate-unicode --output font.otf
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## Characteristics
|
|
96
|
+
|
|
97
|
+
### Advantages
|
|
98
|
+
|
|
99
|
+
- **Print workflows** — PostScript native
|
|
100
|
+
- **High quality** — Professional fonts
|
|
101
|
+
- **Cubic curves** — Fewer points
|
|
102
|
+
|
|
103
|
+
### Limitations
|
|
104
|
+
|
|
105
|
+
- **Legacy format** — Modern systems prefer OTF
|
|
106
|
+
- **Limited Unicode** — Requires glyph name mapping
|
|
107
|
+
- **No native Unicode** — Must be generated
|
|
108
|
+
|
|
109
|
+
## seac Expansion
|
|
110
|
+
|
|
111
|
+
seac (Standard Encoding Accented Character) must be expanded for CFF:
|
|
112
|
+
|
|
113
|
+
```ruby
|
|
114
|
+
# Fontisan automatically expands seac during conversion
|
|
115
|
+
options = Fontisan::ConversionOptions.new(
|
|
116
|
+
opening: { decompose_composites: true }
|
|
117
|
+
)
|
|
118
|
+
```
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: WOFF & WOFF2
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# WOFF & WOFF2
|
|
6
|
+
|
|
7
|
+
Web Open Font Format (WOFF and WOFF2) are optimized for web delivery.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
| Format | Compression | Browser Support |
|
|
12
|
+
|--------|-------------|-----------------|
|
|
13
|
+
| WOFF | zlib | All modern browsers (IE 9+) |
|
|
14
|
+
| WOFF2 | Brotli | Modern browsers |
|
|
15
|
+
|
|
16
|
+
The format you pick **is** the algorithm choice — WOFF 1.0 mandates zlib,
|
|
17
|
+
WOFF2 mandates Brotli. Each format exposes its algorithm's parameters
|
|
18
|
+
(level, quality, transform) rather than offering a separate algorithm
|
|
19
|
+
selector.
|
|
20
|
+
|
|
21
|
+
## WOFF2 Benefits
|
|
22
|
+
|
|
23
|
+
- 30-50% smaller than TTF/OTF
|
|
24
|
+
- Preprocessing transforms for better compression
|
|
25
|
+
- Modern browser support
|
|
26
|
+
|
|
27
|
+
## Converting to WOFF
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
# From TTF
|
|
31
|
+
fontisan convert font.ttf --to woff --output font.woff
|
|
32
|
+
|
|
33
|
+
# From OTF
|
|
34
|
+
fontisan convert font.otf --to woff --output font.woff
|
|
35
|
+
|
|
36
|
+
# Max zlib compression
|
|
37
|
+
fontisan convert font.ttf --to woff --output font.woff --zlib-level 9
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Converting to WOFF2
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
# From TTF
|
|
44
|
+
fontisan convert font.ttf --to woff2 --output font.woff2
|
|
45
|
+
|
|
46
|
+
# From OTF
|
|
47
|
+
fontisan convert font.otf --to woff2 --output font.woff2
|
|
48
|
+
|
|
49
|
+
# From Type 1
|
|
50
|
+
fontisan convert font.pfb --to woff2 --output font.woff2
|
|
51
|
+
|
|
52
|
+
# Smallest possible output (max Brotli + table transforms)
|
|
53
|
+
fontisan convert font.ttf --to woff2 --output font.woff2 \
|
|
54
|
+
--brotli-quality 11 --transform-tables
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## API Usage
|
|
58
|
+
|
|
59
|
+
```ruby
|
|
60
|
+
options = Fontisan::ConversionOptions.from_preset(:web_optimized)
|
|
61
|
+
# From: :otf, To: :woff2
|
|
62
|
+
# generating: { brotli_quality: 11, transform_tables: true,
|
|
63
|
+
# optimize_tables: true, preserve_metadata: true }
|
|
64
|
+
|
|
65
|
+
Fontisan::FontWriter.write(font, 'font.woff2', options: options)
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Compression Knobs
|
|
69
|
+
|
|
70
|
+
### WOFF (zlib)
|
|
71
|
+
|
|
72
|
+
| Option | CLI | Range | Default |
|
|
73
|
+
|--------|-----|-------|---------|
|
|
74
|
+
| `zlib_level` | `--zlib-level=N` | 0–9 | 6 |
|
|
75
|
+
| `uncompressed` | `--uncompressed` | bool | false |
|
|
76
|
+
| `compression_threshold` | `--compression-threshold=N` | bytes | 100 |
|
|
77
|
+
|
|
78
|
+
```ruby
|
|
79
|
+
generating: { zlib_level: 9 } # max zlib
|
|
80
|
+
generating: { uncompressed: true } # legal per WOFF 1.0 §5.1
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### WOFF2 (Brotli)
|
|
84
|
+
|
|
85
|
+
| Option | CLI | Range | Default |
|
|
86
|
+
|--------|-----|-------|---------|
|
|
87
|
+
| `brotli_quality` | `--brotli-quality=N` | 0–11 | 11 |
|
|
88
|
+
| `transform_tables` | `--[no-]transform-tables` | bool | false |
|
|
89
|
+
|
|
90
|
+
```ruby
|
|
91
|
+
generating: { brotli_quality: 11, transform_tables: true }
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Cross-format misuse (e.g. `brotli_quality` on `:woff`) raises
|
|
95
|
+
`ArgumentError` from `FormatConverter.validate_options_for_target!`.
|
|
96
|
+
|
|
97
|
+
## Table Transforms
|
|
98
|
+
|
|
99
|
+
WOFF2 supports table transformations:
|
|
100
|
+
|
|
101
|
+
| Table | Transform |
|
|
102
|
+
|-------|-----------|
|
|
103
|
+
| glyf | Combined with loca |
|
|
104
|
+
| hmtx | Combined with hhea |
|
|
105
|
+
| CFF | De-subroutinization |
|
|
106
|
+
|
|
107
|
+
```ruby
|
|
108
|
+
options = Fontisan::ConversionOptions.new(
|
|
109
|
+
to: :woff2,
|
|
110
|
+
generating: { transform_tables: true }
|
|
111
|
+
)
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Converting from WOFF
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
# WOFF to TTF
|
|
118
|
+
fontisan convert font.woff --to ttf --output font.ttf
|
|
119
|
+
|
|
120
|
+
# WOFF2 to OTF
|
|
121
|
+
fontisan convert font.woff2 --to otf --output font.otf
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## Browser Support
|
|
125
|
+
|
|
126
|
+
| Browser | WOFF | WOFF2 |
|
|
127
|
+
|---------|------|-------|
|
|
128
|
+
| Chrome | 5+ | 36+ |
|
|
129
|
+
| Firefox | 3.6+ | 35+ |
|
|
130
|
+
| Safari | 5.1+ | 12+ |
|
|
131
|
+
| Edge | All | 14+ |
|
|
132
|
+
| IE | 9+ | — |
|
|
133
|
+
|
|
134
|
+
## Best Practices
|
|
135
|
+
|
|
136
|
+
1. **Use WOFF2 primarily** — Best compression
|
|
137
|
+
2. **Provide WOFF fallback** — For older browsers (IE 9+)
|
|
138
|
+
3. **Keep original** — For editing
|
|
139
|
+
4. **Preserve metadata** — Unless stripping for size
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Autohint
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Autohint
|
|
6
|
+
|
|
7
|
+
Fontisan supports automatic hint generation for fonts without hints or when converting between formats.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
Autohinting generates hint data automatically based on glyph outlines. This is useful when:
|
|
12
|
+
|
|
13
|
+
- Source font lacks hints
|
|
14
|
+
- Converting between incompatible hint systems
|
|
15
|
+
- Improving rendering quality
|
|
16
|
+
|
|
17
|
+
## CLI Usage
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
# Enable autohinting during conversion
|
|
21
|
+
fontisan convert font.ttf --to otf --autohint --output font.otf
|
|
22
|
+
|
|
23
|
+
# With specific hinting mode
|
|
24
|
+
fontisan convert font.ttf --to otf --autohint --hinting-mode auto
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API Usage
|
|
28
|
+
|
|
29
|
+
```ruby
|
|
30
|
+
options = Fontisan::ConversionOptions.new(
|
|
31
|
+
opening: { autohint: true },
|
|
32
|
+
generating: { hinting_mode: "auto" }
|
|
33
|
+
)
|
|
34
|
+
|
|
35
|
+
converter = Fontisan::Converters::OutlineConverter.new
|
|
36
|
+
result = converter.convert(font, options: options)
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Hinting Modes
|
|
40
|
+
|
|
41
|
+
| Mode | Description | Use Case |
|
|
42
|
+
|------|-------------|----------|
|
|
43
|
+
| `preserve` | Keep original hints | Same-format conversions |
|
|
44
|
+
| `auto` | Apply automatic hinting | Cross-format, missing hints |
|
|
45
|
+
| `none` | Remove all hints | Smallest file size |
|
|
46
|
+
| `full` | Full hint conversion | Maximum quality |
|
|
47
|
+
|
|
48
|
+
## When to Use Autohint
|
|
49
|
+
|
|
50
|
+
### Use Autohint When:
|
|
51
|
+
|
|
52
|
+
- Converting TTF to OTF (different hint systems)
|
|
53
|
+
- Converting OTF to TTF (different hint systems)
|
|
54
|
+
- Source font has no hints
|
|
55
|
+
- Source hints are corrupt or incomplete
|
|
56
|
+
|
|
57
|
+
### Don't Use Autohint When:
|
|
58
|
+
|
|
59
|
+
- Converting same format (TTF → TTF, OTF → OTF)
|
|
60
|
+
- Source has good TrueType instructions
|
|
61
|
+
- Source has good PostScript hints
|
|
62
|
+
- Target application doesn't use hints
|
|
63
|
+
|
|
64
|
+
## Autohint Process
|
|
65
|
+
|
|
66
|
+
### For TrueType Output
|
|
67
|
+
|
|
68
|
+
1. Analyze glyph outlines
|
|
69
|
+
2. Detect stem widths and positions
|
|
70
|
+
3. Generate CVT table with common values
|
|
71
|
+
4. Create prep program with basic setup
|
|
72
|
+
5. Leave fpgm empty (no glyph programs)
|
|
73
|
+
|
|
74
|
+
### For OpenType Output
|
|
75
|
+
|
|
76
|
+
1. Analyze glyph outlines
|
|
77
|
+
2. Detect blue zones (baseline, x-height, cap height)
|
|
78
|
+
3. Detect stem widths
|
|
79
|
+
4. Generate Private DICT parameters
|
|
80
|
+
5. Create stem hints in CharStrings
|
|
81
|
+
|
|
82
|
+
## Quality
|
|
83
|
+
|
|
84
|
+
### Autohint Limitations
|
|
85
|
+
|
|
86
|
+
- **No glyph-specific instructions** — Only global hints
|
|
87
|
+
- **May not match hand-tuned hints** — Quality varies
|
|
88
|
+
- **Better than no hints** — Generally improves rendering
|
|
89
|
+
|
|
90
|
+
### Comparison
|
|
91
|
+
|
|
92
|
+
| Source | Autohint | Hand-Tuned |
|
|
93
|
+
|--------|----------|------------|
|
|
94
|
+
| Quality | Good | Best |
|
|
95
|
+
| Consistency | High | Varies |
|
|
96
|
+
| Time | Fast | Slow |
|
|
97
|
+
| Cost | Free | Expensive |
|
|
98
|
+
|
|
99
|
+
## Examples
|
|
100
|
+
|
|
101
|
+
### Convert with Autohint
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
# Type 1 to OTF with autohint
|
|
105
|
+
fontisan convert font.pfb --to otf --autohint --output font.otf
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Remove and Regenerate Hints
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
# Remove existing hints, add autohints
|
|
112
|
+
fontisan convert font.ttf --to ttf --hinting-mode none --autohint --output font-rehinted.ttf
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### Batch Processing
|
|
116
|
+
|
|
117
|
+
```ruby
|
|
118
|
+
Dir.glob('fonts/*.ttf').each do |input|
|
|
119
|
+
output = input.sub('.ttf', '-hinted.ttf')
|
|
120
|
+
options = Fontisan::ConversionOptions.new(
|
|
121
|
+
opening: { autohint: true },
|
|
122
|
+
generating: { hinting_mode: "auto" }
|
|
123
|
+
)
|
|
124
|
+
|
|
125
|
+
font = Fontisan::FontLoader.load(input)
|
|
126
|
+
converter = Fontisan::Converters::OutlineConverter.new
|
|
127
|
+
result = converter.convert(font, options: options)
|
|
128
|
+
Fontisan::FontWriter.write(result, output)
|
|
129
|
+
end
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## Testing Hints
|
|
133
|
+
|
|
134
|
+
After autohinting, test rendering quality:
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
# Generate sample images at small sizes
|
|
138
|
+
fontisan render font-hinted.ttf --size 8 --output sample-8pt.png
|
|
139
|
+
fontisan render font-hinted.ttf --size 10 --output sample-10pt.png
|
|
140
|
+
fontisan render font-hinted.ttf --size 12 --output sample-12pt.png
|
|
141
|
+
```
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Hint Conversion
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Hint Conversion
|
|
6
|
+
|
|
7
|
+
Fontisan provides bidirectional hint conversion between TrueType and PostScript formats.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
| Direction | From | To | Process |
|
|
12
|
+
|-----------|------|-----|---------|
|
|
13
|
+
| TTF → OTF | TrueType instructions | PostScript hints | Analyze bytecode |
|
|
14
|
+
| OTF → TTF | PostScript hints | TrueType instructions | Generate bytecode |
|
|
15
|
+
|
|
16
|
+
## TTF → OTF Conversion
|
|
17
|
+
|
|
18
|
+
### Process
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
TrueType Font → Instruction Analysis → PostScript Parameters → CFF Table
|
|
22
|
+
(Input) (prep/fpgm/cvt) (Hint Dict) (Output)
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### Analysis Steps
|
|
26
|
+
|
|
27
|
+
1. Parse prep (Control Value Program) bytecode
|
|
28
|
+
2. Analyze fpgm (Font Program) for complexity indicators
|
|
29
|
+
3. Extract blue zones from CVT (Control Value Table) values
|
|
30
|
+
4. Extract stem widths and alignment zones
|
|
31
|
+
|
|
32
|
+
### Generated Parameters
|
|
33
|
+
|
|
34
|
+
| Parameter | Source |
|
|
35
|
+
|-----------|--------|
|
|
36
|
+
| `blue_scale` | CVT analysis |
|
|
37
|
+
| `std_hw` | CVT[0] (standard horizontal stem) |
|
|
38
|
+
| `std_vw` | CVT[1] (standard vertical stem) |
|
|
39
|
+
| `stem_snap_h` | CVT analysis |
|
|
40
|
+
| `stem_snap_v` | CVT analysis |
|
|
41
|
+
| `blue_values` | CVT analysis (baseline, cap) |
|
|
42
|
+
| `other_blues` | CVT analysis (descender) |
|
|
43
|
+
|
|
44
|
+
### CLI
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
fontisan convert font.ttf --to otf --hinting-mode preserve
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### API
|
|
51
|
+
|
|
52
|
+
```ruby
|
|
53
|
+
converter = Fontisan::Converters::HintConverter.new
|
|
54
|
+
|
|
55
|
+
# Convert TrueType hints to PostScript
|
|
56
|
+
ps_hints = converter.truetype_to_postscript(font)
|
|
57
|
+
|
|
58
|
+
# Result contains:
|
|
59
|
+
# {
|
|
60
|
+
# blue_scale: 0.039625,
|
|
61
|
+
# std_hw: 80,
|
|
62
|
+
# std_vw: 100,
|
|
63
|
+
# blue_values: [-20, 0, 700, 720],
|
|
64
|
+
# stem_snap_h: [80, 90],
|
|
65
|
+
# stem_snap_v: [100, 110]
|
|
66
|
+
# }
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## OTF → TTF Conversion
|
|
70
|
+
|
|
71
|
+
### Process
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
OTF Font → Parameter Extraction → Instruction Generation → TrueType Tables
|
|
75
|
+
(Input) (CFF Private Dict) (prep/fpgm/cvt) (Output)
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Generation Steps
|
|
79
|
+
|
|
80
|
+
1. Generate prep program with CVT cut-in, single width settings
|
|
81
|
+
2. Build CVT table with stem widths and blue zone values
|
|
82
|
+
3. Create fpgm program (typically empty for converted fonts)
|
|
83
|
+
4. Encode instructions using optimal PUSH opcodes
|
|
84
|
+
|
|
85
|
+
### Generated Tables
|
|
86
|
+
|
|
87
|
+
| Table | Content |
|
|
88
|
+
|-------|---------|
|
|
89
|
+
| `prep` | Control Value Program with hint setup |
|
|
90
|
+
| `cvt` | Control Value Table with stems and blue zones |
|
|
91
|
+
| `fpgm` | Font Program (empty for converted fonts) |
|
|
92
|
+
|
|
93
|
+
### CLI
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
fontisan convert font.otf --to ttf --hinting-mode preserve
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### API
|
|
100
|
+
|
|
101
|
+
```ruby
|
|
102
|
+
converter = Fontisan::Converters::HintConverter.new
|
|
103
|
+
|
|
104
|
+
# Convert PostScript hints to TrueType
|
|
105
|
+
ttf_tables = converter.postscript_to_truetype(font)
|
|
106
|
+
|
|
107
|
+
# Result contains:
|
|
108
|
+
# {
|
|
109
|
+
# prep: "\xB0\x11\x1D", # Bytecode
|
|
110
|
+
# cvt: [80, 100, -20, 0, 700, 720],
|
|
111
|
+
# fpgm: ""
|
|
112
|
+
# }
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Round-Trip Conversion
|
|
116
|
+
|
|
117
|
+
Fontisan ensures hint integrity through round-trip conversion:
|
|
118
|
+
|
|
119
|
+
```
|
|
120
|
+
Original PS Hints → TrueType → PostScript → Validation
|
|
121
|
+
(Input) (Convert) (Convert) (Verify)
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Round-Trip Guarantees
|
|
125
|
+
|
|
126
|
+
- CVT values preserved (sorted and deduplicated)
|
|
127
|
+
- Standard widths (std_hw, std_vw) maintained
|
|
128
|
+
- Blue zone values retained
|
|
129
|
+
- <10% loss tolerance for approximations
|
|
130
|
+
|
|
131
|
+
### Known Limitations
|
|
132
|
+
|
|
133
|
+
- CVT sorting may change positions (optimization trade-off)
|
|
134
|
+
- blue_scale not perfectly round-trippable (conversion approximation)
|
|
135
|
+
- Standard widths extracted from CVT[0] and CVT[1] positions
|
|
136
|
+
|
|
137
|
+
## Example
|
|
138
|
+
|
|
139
|
+
```ruby
|
|
140
|
+
# Round-trip test
|
|
141
|
+
font = Fontisan::FontLoader.load('font.otf')
|
|
142
|
+
original_hints = font.tables['CFF'].top_dicts.first[:private]
|
|
143
|
+
|
|
144
|
+
# Convert to TrueType
|
|
145
|
+
ttf_converter = Fontisan::Converters::HintConverter.new
|
|
146
|
+
ttf_tables = ttf_converter.postscript_to_truetype(font)
|
|
147
|
+
|
|
148
|
+
# Convert back to PostScript
|
|
149
|
+
ps_hints = ttf_converter.truetype_to_postscript(ttf_font)
|
|
150
|
+
|
|
151
|
+
# Compare
|
|
152
|
+
puts "Original std_hw: #{original_hints[:std_hw]}"
|
|
153
|
+
puts "Round-trip std_hw: #{ps_hints[:std_hw]}"
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## Best Practices
|
|
157
|
+
|
|
158
|
+
1. **Test round-trip** — Verify hint preservation
|
|
159
|
+
2. **Use autohint for cross-format** — Consider `--hinting-mode auto`
|
|
160
|
+
3. **Validate after conversion** — Check hint validity
|
|
161
|
+
4. **Test rendering** — Verify visual quality at small sizes
|