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,436 @@
|
|
|
1
|
+
= Stitcher Guide
|
|
2
|
+
|
|
3
|
+
== General
|
|
4
|
+
|
|
5
|
+
The Stitcher combines glyphs from multiple source fonts into one or
|
|
6
|
+
more new fonts. Sources can be UFO directories, loaded TTF/OTF files,
|
|
7
|
+
or any object responding to the `Ufo::Font` interface.
|
|
8
|
+
|
|
9
|
+
The design rule: **the user controls the collection structure
|
|
10
|
+
explicitly**. Every `include_*` method requires an `into:` keyword
|
|
11
|
+
naming the target subfont, and `write_to` requires a `subfont:` name.
|
|
12
|
+
There are no defaults and no after-the-fact splitting.
|
|
13
|
+
|
|
14
|
+
== API
|
|
15
|
+
|
|
16
|
+
[cols="2,3", options="header"]
|
|
17
|
+
|===
|
|
18
|
+
| Method | Purpose
|
|
19
|
+
|
|
20
|
+
| `Stitcher.new(deduplicate: true)` | Create a stitcher; dedup is on by default
|
|
21
|
+
|
|
22
|
+
| `add_source(label, font)` | Register a source font under a Symbol label
|
|
23
|
+
|
|
24
|
+
| `add_source(label, font, remap:)` | Register a source with a
|
|
25
|
+
`{src_codepoint => target_codepoint}` remap. Useful for donor
|
|
26
|
+
fonts whose glyphs live at non-canonical codepoints (PUA, ASCII-
|
|
27
|
+
mapped pre-Unicode fonts). Source codepoints not in the remap
|
|
28
|
+
are hidden — the donor's other coverage (often ASCII/PUA noise)
|
|
29
|
+
does not leak into the output.
|
|
30
|
+
|
|
31
|
+
| `include_range(range, from:, into:)` | Add codepoint range from `from` into `into`
|
|
32
|
+
|
|
33
|
+
| `include_codepoints(cps, from:, into:)` | Add an explicit Array of codepoints
|
|
34
|
+
|
|
35
|
+
| `include_codepoints_map(cp_map, into:)` | Add `{codepoint => donor}` for many codepoints and donors in one call
|
|
36
|
+
|
|
37
|
+
| `include_gid(donor_gid, from:, into:)` | Add a specific GID from the source
|
|
38
|
+
|
|
39
|
+
| `include_notdef(from:, into:)` | Convenience for `include_gid(0, ...)`
|
|
40
|
+
|
|
41
|
+
| `set_info(hash)` | Override font info (family name, etc.)
|
|
42
|
+
|
|
43
|
+
| `subfont_names` | List declared subfont names (insertion order)
|
|
44
|
+
|
|
45
|
+
| `write_to(path, format:, subfont:)` | Compile one subfont to a single file
|
|
46
|
+
|
|
47
|
+
| `write_collection(path, format:)` | Compile all declared subfonts into a TTC/OTC; returns a `CollectionResult`
|
|
48
|
+
|===
|
|
49
|
+
|
|
50
|
+
`format:` is one of `:ttf`, `:otf`, `:otf2`. For collections, `:ttf`
|
|
51
|
+
produces a `.ttc` and `:otf`/`:otf2` produce an `.otc`.
|
|
52
|
+
|
|
53
|
+
== Single-font example
|
|
54
|
+
|
|
55
|
+
[source,ruby]
|
|
56
|
+
----
|
|
57
|
+
stitcher = Fontisan::Stitcher.new
|
|
58
|
+
stitcher.add_source(:latin, Fontisan::FontLoader.load("NotoSans.ttf"))
|
|
59
|
+
stitcher.add_source(:cjk, Fontisan::FontLoader.load("FSung-m.ttf"))
|
|
60
|
+
|
|
61
|
+
stitcher.include_notdef(from: :latin, into: :main)
|
|
62
|
+
stitcher.include_range(0x41..0x5A, from: :latin, into: :main) # A-Z
|
|
63
|
+
stitcher.include_range(0x4E00..0x9FFF, from: :cjk, into: :main) # CJK
|
|
64
|
+
|
|
65
|
+
stitcher.write_to("stitched.ttf", format: :ttf, subfont: :main)
|
|
66
|
+
----
|
|
67
|
+
|
|
68
|
+
== Collection example (TTC/OTC)
|
|
69
|
+
|
|
70
|
+
When the total glyph count would exceed 65,535 (the OpenType
|
|
71
|
+
`maxp.numGlyphs` cap), split the work across named subfonts and write
|
|
72
|
+
a collection:
|
|
73
|
+
|
|
74
|
+
[source,ruby]
|
|
75
|
+
----
|
|
76
|
+
stitcher = Fontisan::Stitcher.new
|
|
77
|
+
stitcher.add_source(:noto_sans, Fontisan::FontLoader.load("NotoSans.ttf"))
|
|
78
|
+
stitcher.add_source(:noto_cjk, Fontisan::FontLoader.load("NotoSansCJK.ttf"))
|
|
79
|
+
|
|
80
|
+
stitcher.include_range(0x41..0x5A, from: :noto_sans, into: :latin)
|
|
81
|
+
stitcher.include_range(0x4E00..0x9FFF, from: :noto_cjk, into: :cjk)
|
|
82
|
+
|
|
83
|
+
stitcher.write_collection("out.otc", format: :otf2)
|
|
84
|
+
----
|
|
85
|
+
|
|
86
|
+
Each subfont is compiled independently, then packed by
|
|
87
|
+
`Collection::Builder` with table deduplication enabled — shared tables
|
|
88
|
+
(head, name, OS/2, ...) are stored once and referenced from each
|
|
89
|
+
subfont's offset table.
|
|
90
|
+
|
|
91
|
+
== Donor remap (non-canonical codepoints)
|
|
92
|
+
|
|
93
|
+
Some donor fonts ship glyphs at codepoints that don't match the
|
|
94
|
+
canonical Unicode assignment — a keyboard-mapped font whose letters
|
|
95
|
+
live at ASCII slots, or a PUA-allocated pre-Unicode font. Pass a
|
|
96
|
+
`remap:` hash to `add_source` to expose those glyphs at their
|
|
97
|
+
canonical targets without mutating the donor's cmap:
|
|
98
|
+
|
|
99
|
+
[source,ruby]
|
|
100
|
+
----
|
|
101
|
+
donor = Fontisan::FontLoader.load("TolongSikiMappedToASCII.ttf")
|
|
102
|
+
|
|
103
|
+
stitcher = Fontisan::Stitcher.new
|
|
104
|
+
stitcher.add_source(:tolong_siki, donor, remap: {
|
|
105
|
+
0x41 => 0x11DB0, # ASCII A → Tolong Siki KA
|
|
106
|
+
0x42 => 0x11DB1, # ASCII B → Tolong Siki NGA
|
|
107
|
+
# ...
|
|
108
|
+
})
|
|
109
|
+
stitcher.include_codepoints((0x11DB0..0x11DC0).to_a,
|
|
110
|
+
from: :tolong_siki, into: :tolong)
|
|
111
|
+
----
|
|
112
|
+
|
|
113
|
+
With a remap set, the source answers `gid_for_codepoint(target)`
|
|
114
|
+
by translating through the inverse remap to the donor's source
|
|
115
|
+
codepoint. Source codepoints not in the remap are hidden — only
|
|
116
|
+
remapped coverage is exposed.
|
|
117
|
+
|
|
118
|
+
The donor's cmap is never mutated. `remap:` is a translation layer
|
|
119
|
+
at the source's API boundary; multiple sources on the same
|
|
120
|
+
Stitcher can have different remaps (or none at all).
|
|
121
|
+
|
|
122
|
+
`write_collection` returns a `Stitcher::CollectionResult` Struct with
|
|
123
|
+
the output `path`, total `bytes`, and one `Stitcher::SubfontStats`
|
|
124
|
+
per declared subfont (`name`, `glyph_count`, `codepoint_count`). Stats
|
|
125
|
+
are read from the compiled on-disk face so they reflect what was
|
|
126
|
+
actually written — including glyphs the compiler adds (e.g. `.notdef`).
|
|
127
|
+
|
|
128
|
+
[source,ruby]
|
|
129
|
+
----
|
|
130
|
+
result = stitcher.write_collection("out.otc", format: :otf2)
|
|
131
|
+
result.path # => "out.otc"
|
|
132
|
+
result.bytes # => File.size("out.otc")
|
|
133
|
+
result.face_count # => result.subfonts.size
|
|
134
|
+
result.subfonts.first.glyph_count # maxp.num_glyphs of face 0
|
|
135
|
+
result.subfonts.first.codepoint_count # cmap size of face 0
|
|
136
|
+
----
|
|
137
|
+
|
|
138
|
+
== Donor maps (many codepoints, many donors, one call)
|
|
139
|
+
|
|
140
|
+
`include_codepoints_map(cp_map, into:)` takes a `{codepoint => donor}`
|
|
141
|
+
map and forwards each donor group to `include_codepoints` after sorting
|
|
142
|
+
the codepoints (reproducible GID assignment). Useful when the cp →
|
|
143
|
+
donor routing comes from an external plan (Unicode block table,
|
|
144
|
+
partitioner output, coverage analysis).
|
|
145
|
+
|
|
146
|
+
[source,ruby]
|
|
147
|
+
----
|
|
148
|
+
cp_map = {
|
|
149
|
+
0x41 => :latin,
|
|
150
|
+
0x42 => :latin,
|
|
151
|
+
0x4E00 => :cjk,
|
|
152
|
+
0x4E01 => :cjk,
|
|
153
|
+
}
|
|
154
|
+
stitcher.include_codepoints_map(cp_map, into: :main)
|
|
155
|
+
# equivalent to:
|
|
156
|
+
# stitcher.include_codepoints([0x41, 0x42], from: :latin, into: :main)
|
|
157
|
+
# stitcher.include_codepoints([0x4E00, 0x4E01], from: :cjk, into: :main)
|
|
158
|
+
----
|
|
159
|
+
|
|
160
|
+
== Codepoint partitioning (PartitionStrategy)
|
|
161
|
+
|
|
162
|
+
When the codepoint set is too large for one subfont (or when you want
|
|
163
|
+
to split by Unicode plane / block / script for organizational reasons),
|
|
164
|
+
`Stitcher::PartitionStrategy` provides ready-to-use partitioner classes
|
|
165
|
+
that produce a `Blueprint` (an ordered list of `Partition`s). Each
|
|
166
|
+
partition names a target subfont and carries its codepoints and
|
|
167
|
+
donor map.
|
|
168
|
+
|
|
169
|
+
The framework is open for new partitioners — adding one is a new file
|
|
170
|
+
under `lib/fontisan/stitcher/partition_strategy/` plus an autoload
|
|
171
|
+
entry. No edits to existing partitioners required (OCP).
|
|
172
|
+
|
|
173
|
+
=== ByPlane
|
|
174
|
+
|
|
175
|
+
Groups codepoints by Unicode plane (`cp >> 16`). Each plane that fits
|
|
176
|
+
under the cap becomes one partition named `:plane_<n>` (e.g.
|
|
177
|
+
`:plane_0` for BMP, `:plane_2` for SIP). When a plane overflows the
|
|
178
|
+
cap, ByPlane sub-splits along the large CJK-extension block
|
|
179
|
+
boundaries (`CJK_Ext_B` through `CJK_Ext_F`), naming partitions
|
|
180
|
+
`:plane_<n>_a`, `:plane_<n>_b`, etc.
|
|
181
|
+
|
|
182
|
+
[source,ruby]
|
|
183
|
+
----
|
|
184
|
+
require "fontisan/stitcher/partition_strategy"
|
|
185
|
+
|
|
186
|
+
cp_map = build_coverage_map # { codepoint => donor_label, ... }
|
|
187
|
+
blueprint = Fontisan::Stitcher::PartitionStrategy::ByPlane.new
|
|
188
|
+
.call(cp_map, cap: 65_484)
|
|
189
|
+
|
|
190
|
+
blueprint.names # => [:plane_0, :plane_2, ...]
|
|
191
|
+
blueprint.partitions # => [#<Partition name=:plane_0 cps=[...] ...>, ...]
|
|
192
|
+
|
|
193
|
+
# Push every partition's bindings into the Stitcher in one go:
|
|
194
|
+
declared = blueprint.apply_to(stitcher)
|
|
195
|
+
# declared == blueprint.names
|
|
196
|
+
----
|
|
197
|
+
|
|
198
|
+
If a single CJK extension block alone exceeds `cap` (e.g. `CJK_Ext_B`
|
|
199
|
+
has ~6,592 codepoints and the cap is set to 5,000), ByPlane raises
|
|
200
|
+
`Fontisan::PartitionCapExceededError` — its codepoints are contiguous
|
|
201
|
+
and ByPlane has no finer-grained boundary to sub-split on. The caller
|
|
202
|
+
must either raise the cap, drop codepoints, or switch to a format
|
|
203
|
+
with a higher glyph limit.
|
|
204
|
+
|
|
205
|
+
The Unicode plane metadata used by ByPlane lives in
|
|
206
|
+
`Fontisan::Unicode::Plane` (`Plane.of(cp)`, `Plane.label(n)`).
|
|
207
|
+
|
|
208
|
+
The sub-plane block boundaries used for sub-splitting live on ByPlane
|
|
209
|
+
itself:
|
|
210
|
+
|
|
211
|
+
* `ByPlane::ATOMIC_BLOCKS` — five SIP CJK extension blocks that cannot
|
|
212
|
+
be sub-split; raise if one alone exceeds `cap`.
|
|
213
|
+
* `ByPlane::CARVE_OUT_BLOCKS` — BMP-resident blocks (CJK Unified
|
|
214
|
+
Ideographs, Hangul Syllables) that get their own partition bucket
|
|
215
|
+
when BMP overflows `cap`; chunkable, never raised.
|
|
216
|
+
* `ByPlane::RECOGNIZED_BLOCKS` — union of the two; the lookup table
|
|
217
|
+
the bucketing pass walks.
|
|
218
|
+
|
|
219
|
+
=== Partition / Blueprint
|
|
220
|
+
|
|
221
|
+
A `Partition` is a `Struct.new(:name, :cps, :donor_map, keyword_init: true)`.
|
|
222
|
+
`Partition#apply_to(stitcher)` pushes its bindings via
|
|
223
|
+
`include_codepoints_map`.
|
|
224
|
+
|
|
225
|
+
A `Blueprint` is a `Struct.new(:partitions, keyword_init: true)`;
|
|
226
|
+
`Blueprint#apply_to(stitcher)` calls `apply_to` on each partition in
|
|
227
|
+
order and returns the list of declared subfont names.
|
|
228
|
+
|
|
229
|
+
=== ByBlock — partition by Unicode Blocks.txt
|
|
230
|
+
|
|
231
|
+
`PartitionStrategy::ByBlock` partitions codepoints by their Unicode
|
|
232
|
+
block. Each non-empty block becomes one partition. The full Unicode
|
|
233
|
+
16.0 block list (~340 entries covering BMP, SMP, SIP, TIP, SSP) is
|
|
234
|
+
inlined as `ByBlock::BLOCKS` so the partitioner is self-contained
|
|
235
|
+
(no external data file). Codepoints in unassigned planes fall into
|
|
236
|
+
`:block_other`.
|
|
237
|
+
|
|
238
|
+
[source,ruby]
|
|
239
|
+
----
|
|
240
|
+
bp = Fontisan::Stitcher::PartitionStrategy::ByBlock.new
|
|
241
|
+
blueprint = bp.call(cp_map)
|
|
242
|
+
blueprint.names # => [:block_basic_latin, :block_cjk_unified_ideographs, ...]
|
|
243
|
+
----
|
|
244
|
+
|
|
245
|
+
Every block is treated as atomic — if a single block alone exceeds
|
|
246
|
+
`cap`, ByBlock raises `PartitionCapExceededError` (callers must
|
|
247
|
+
either use ByPlane with carve-outs or implement a custom
|
|
248
|
+
partitioner).
|
|
249
|
+
|
|
250
|
+
=== ByScript — partition by Unicode script property
|
|
251
|
+
|
|
252
|
+
`PartitionStrategy::ByScript` partitions codepoints by Unicode
|
|
253
|
+
script (Latin, Greek, Cyrillic, Han, Hangul, etc.). Derived from
|
|
254
|
+
`ByBlock::BLOCKS` via a `SCRIPT_OF_BLOCK` map — keeps the data DRY.
|
|
255
|
+
|
|
256
|
+
Scripts that overflow `cap` are chunked with alphabetic suffixes
|
|
257
|
+
matching ByPlane's sub-split convention (e.g. `:script_han`,
|
|
258
|
+
`:script_han_a`, `:script_han_b`). Common and Inherited scripts
|
|
259
|
+
get their own buckets — useful for separating shared punctuation
|
|
260
|
+
and combining marks.
|
|
261
|
+
|
|
262
|
+
[source,ruby]
|
|
263
|
+
----
|
|
264
|
+
sp = Fontisan::Stitcher::PartitionStrategy::ByScript.new
|
|
265
|
+
blueprint = sp.call(cp_map)
|
|
266
|
+
blueprint.names # => [:script_common, :script_latin, :script_han, ...]
|
|
267
|
+
----
|
|
268
|
+
|
|
269
|
+
=== Choosing a strategy
|
|
270
|
+
|
|
271
|
+
|===
|
|
272
|
+
| Strategy | When to use
|
|
273
|
+
|
|
274
|
+
| `ByPlane`
|
|
275
|
+
| CJK-heavy fonts that need to respect the 65,535-glyph cap per
|
|
276
|
+
plane. Sub-splits only the SIP CJK extensions and the BMP
|
|
277
|
+
carve-out blocks.
|
|
278
|
+
|
|
279
|
+
| `ByBlock`
|
|
280
|
+
| Fonts that span many small Unicode blocks where each block
|
|
281
|
+
should land in its own subfont (e.g. for selective subsetting
|
|
282
|
+
per block). Each block is atomic.
|
|
283
|
+
|
|
284
|
+
| `ByScript`
|
|
285
|
+
| Web font delivery where each subfont should cover one script
|
|
286
|
+
(Latin-only file, Greek-only file, etc.). Chunks large scripts
|
|
287
|
+
(Han) when they overflow the cap.
|
|
288
|
+
|===
|
|
289
|
+
|
|
290
|
+
All three autoload from `lib/fontisan/stitcher/partition_strategy/`.
|
|
291
|
+
Adding a new strategy = new file + one autoload entry (OCP).
|
|
292
|
+
|
|
293
|
+
== Per-subfont metadata (Ufo::Info.for_subfont)
|
|
294
|
+
|
|
295
|
+
`Fontisan::Ufo::Info.for_subfont(family:, subfont:, version:, ...)`
|
|
296
|
+
builds the standard name-table fields for one subfont of a collection.
|
|
297
|
+
The family name embeds the subfont name (e.g. `"MyFont CJK"`), and
|
|
298
|
+
the PostScript name uses the hyphenated form (e.g. `"MyFont-CJK"`).
|
|
299
|
+
`version` is parsed into `version_major` / `version_minor` per the
|
|
300
|
+
UFO major.minor shape (semver patch is dropped).
|
|
301
|
+
|
|
302
|
+
[source,ruby]
|
|
303
|
+
----
|
|
304
|
+
info = Fontisan::Ufo::Info.for_subfont(
|
|
305
|
+
family: "essenfont",
|
|
306
|
+
subfont: :SIP,
|
|
307
|
+
version: "0.1",
|
|
308
|
+
)
|
|
309
|
+
info.family_name # => "essenfont SIP"
|
|
310
|
+
info.postscript_font_name # => "essenfont-SIP"
|
|
311
|
+
info.postscript_full_name # => "essenfont SIP"
|
|
312
|
+
info.version_major # => 0
|
|
313
|
+
info.version_minor # => 1
|
|
314
|
+
----
|
|
315
|
+
|
|
316
|
+
Optional kwargs: `subfamily:` (default `"Regular"`), `copyright:`,
|
|
317
|
+
`trademark:`. `trademark` lands in `extras["openTypeNameTrademark"]`
|
|
318
|
+
because it is not in `Ufo::Info::STANDARD_FIELDS` yet — round-trip
|
|
319
|
+
still works through the extras channel.
|
|
320
|
+
|
|
321
|
+
== Glyph deduplication
|
|
322
|
+
|
|
323
|
+
By default the Stitcher deduplicates glyphs across all sources using
|
|
324
|
+
SHA-256 outline signatures (`Stitcher::GlyphSignature`). Two donor
|
|
325
|
+
glyphs with identical width + contours + components are merged into a
|
|
326
|
+
single target glyph; subsequent references are aliased by adding the
|
|
327
|
+
extra codepoint to the merged glyph's unicode set.
|
|
328
|
+
|
|
329
|
+
To disable deduplication (e.g., for forensic comparison):
|
|
330
|
+
|
|
331
|
+
[source,ruby]
|
|
332
|
+
----
|
|
333
|
+
stitcher = Fontisan::Stitcher.new(deduplicate: false)
|
|
334
|
+
----
|
|
335
|
+
|
|
336
|
+
== 65,535 glyph cap
|
|
337
|
+
|
|
338
|
+
OpenType `maxp.numGlyphs` is uint16 — no format (TTF, CFF1, or CFF2)
|
|
339
|
+
can hold more than 65,535 glyphs in a single font. The Stitcher
|
|
340
|
+
enforces this:
|
|
341
|
+
|
|
342
|
+
* `Stitcher::GlyphLimit.check!(count, format:)` raises
|
|
343
|
+
`GlyphLimitExceededError` when a single subfont would exceed the cap.
|
|
344
|
+
* The only path to >65,535 glyphs is a TTC/OTC collection — each
|
|
345
|
+
subfont is its own 65,535-space.
|
|
346
|
+
|
|
347
|
+
== CBDT/CBLC passthrough (color emoji)
|
|
348
|
+
|
|
349
|
+
Sources that contain CBDT/CBLC tables (e.g. NotoColorEmoji) can be
|
|
350
|
+
used as Stitcher sources. The bitmap data is propagated byte-for-byte
|
|
351
|
+
into the output:
|
|
352
|
+
|
|
353
|
+
[source,ruby]
|
|
354
|
+
----
|
|
355
|
+
stitcher = Fontisan::Stitcher.new
|
|
356
|
+
stitcher.add_source(:text, Fontisan::FontLoader.load("NotoSans.ttf"))
|
|
357
|
+
stitcher.add_source(:emoji, Fontisan::FontLoader.load("NotoColorEmoji.ttf"))
|
|
358
|
+
|
|
359
|
+
stitcher.include_notdef(from: :text, into: :main)
|
|
360
|
+
stitcher.include_range(0x41..0x5A, from: :text, into: :main)
|
|
361
|
+
stitcher.include_range(0x1F600..0x1F64F, from: :emoji, into: :main)
|
|
362
|
+
|
|
363
|
+
stitcher.write_to("out.ttf", format: :ttf, subfont: :main)
|
|
364
|
+
# → out.ttf has glyf + CBDT + CBLC, emoji renders correctly
|
|
365
|
+
----
|
|
366
|
+
|
|
367
|
+
=== Outline-first cmap priority
|
|
368
|
+
|
|
369
|
+
When a codepoint is covered by BOTH an outline donor and the CBDT
|
|
370
|
+
donor, the cmap maps it to the outline glyph — never to the CBDT
|
|
371
|
+
placeholder. The Cmap compiler follows first-wins semantics, and
|
|
372
|
+
`GlyphCopier` runs before `CbdtPropagator` so the outline GID is
|
|
373
|
+
registered first. This was the fix for the Emoticons cmap-loss bug
|
|
374
|
+
where shared codepoints silently dropped out of the cmap.
|
|
375
|
+
|
|
376
|
+
=== Placeholder name deconfliction
|
|
377
|
+
|
|
378
|
+
CBDT placeholders are named after the source's glyph IDs
|
|
379
|
+
(`"gid1"`, `"gid2"`, …), which is the SAME naming scheme
|
|
380
|
+
`Source#extract_truetype_glyph` uses for outline glyphs from TTF
|
|
381
|
+
donors. Without protection, a placeholder at `"gid110"` would
|
|
382
|
+
silently overwrite an outline glyph at `"gid110"` from a different
|
|
383
|
+
donor via `Layer#add` — the original cmap-loss vector for the
|
|
384
|
+
Essenfont CJK Ext G regression.
|
|
385
|
+
|
|
386
|
+
The Stitcher resolves this with two pieces:
|
|
387
|
+
|
|
388
|
+
* `Ufo::Layer#add` RAISES `Ufo::GlyphExistsError` on name conflict.
|
|
389
|
+
Silent overwrites are no longer possible. Callers that want to
|
|
390
|
+
replace an existing glyph use the explicit `Ufo::Layer#put`.
|
|
391
|
+
* `Stitcher::UniqueGlyphName.in(target, base)` allocates a
|
|
392
|
+
non-colliding name (`"gid110"`, then `"gid110.1"`, `"gid110.2"`,
|
|
393
|
+
…). `GlyphCopier` and `CbdtPropagator` both call it before every
|
|
394
|
+
`Layer#add`, so each glyph lands at its own GID slot without
|
|
395
|
+
touching the others.
|
|
396
|
+
|
|
397
|
+
=== Limitations
|
|
398
|
+
|
|
399
|
+
* Only ONE CBDT source per Stitcher. Multiple CBDT sources raise
|
|
400
|
+
`Fontisan::MultipleCbdtSourcesError`.
|
|
401
|
+
* **GID stability for overlapping codepoint ranges.** The raw-bytes
|
|
402
|
+
CBDT/CBLC propagation (`CbdtPropagator#propagate_tables_into`)
|
|
403
|
+
copies the source's CBLC verbatim. CBLC indexes glyphs by SOURCE
|
|
404
|
+
GID. After placeholder renaming (`"gid110"` → `"gid110.1"`), the
|
|
405
|
+
compiled GID no longer matches the source GID, so CBLC's source-
|
|
406
|
+
GID-indexed bitmaps can dangle. This is masked in the typical
|
|
407
|
+
Essenfont case (CBDT donor NotoColorEmoji and outline donors
|
|
408
|
+
cover disjoint codepoint ranges) but would produce wrong bitmaps
|
|
409
|
+
for any stitch where CBDT and outline sources share codepoint
|
|
410
|
+
ranges. A proper fix requires a CBLC rebuild pass that walks the
|
|
411
|
+
compiled cmap to remap source GIDs to compiled GIDs — tracked as
|
|
412
|
+
follow-up.
|
|
413
|
+
* **Collection-mode single-face coverage.** Each face is compiled
|
|
414
|
+
independently; `CbdtPropagator` currently requires at least one
|
|
415
|
+
outline codepoint per face. Collection-mode coverage of the
|
|
416
|
+
outline-first cmap-priority invariant is tracked as follow-up.
|
|
417
|
+
|
|
418
|
+
== CLI
|
|
419
|
+
|
|
420
|
+
[source,bash]
|
|
421
|
+
----
|
|
422
|
+
fontisan stitch \
|
|
423
|
+
--source latin=NotoSans.ttf \
|
|
424
|
+
--source cjk=FSung-m.ttf \
|
|
425
|
+
--include-range latin=0x41-0x5A \
|
|
426
|
+
--include-range cjk=0x4E00-0x9FFF \
|
|
427
|
+
--notdef-from latin \
|
|
428
|
+
--output stitched.ttf
|
|
429
|
+
----
|
|
430
|
+
|
|
431
|
+
== See also
|
|
432
|
+
|
|
433
|
+
* link:UFO_COMPILATION.adoc[UFO Compilation Guide] — TTF/OTF/CFF2 compilers
|
|
434
|
+
- link:COLLECTION_VALIDATION.adoc[Collection Validation Guide]
|
|
435
|
+
- link:SVG_TO_GLYF.adoc[SVG to Glyph Guide] — turn chart SVGs into
|
|
436
|
+
Stitcher sources
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
= SVG to Glyph Guide
|
|
2
|
+
|
|
3
|
+
== General
|
|
4
|
+
|
|
5
|
+
`Fontisan::SvgToGlyf` converts SVG path data — as produced by ucode's
|
|
6
|
+
code-chart extraction — into `Ufo::Glyph` objects that feed directly
|
|
7
|
+
into the UFO → TTF/OTF compile pipeline.
|
|
8
|
+
|
|
9
|
+
SvgToGlyf emits cubic Bezier contours (matching UFO/PostScript
|
|
10
|
+
conventions). The cubic-to-quadratic conversion and winding-order
|
|
11
|
+
correction happen later, in `Ufo::Compile::Filters::CubicToQuadratic`
|
|
12
|
+
and `ReverseContourDirection`, when the glyph is compiled to TTF.
|
|
13
|
+
|
|
14
|
+
== API
|
|
15
|
+
|
|
16
|
+
[cols="2,3", options="header"]
|
|
17
|
+
|===
|
|
18
|
+
| Method | Purpose
|
|
19
|
+
|
|
20
|
+
| `SvgToGlyf.convert(path_data, upm:, codepoint:, name:, viewbox:, transform:)`
|
|
21
|
+
| Convert a single SVG path `d` string into a `Ufo::Glyph`
|
|
22
|
+
|
|
23
|
+
| `SvgToGlyf.from_svg_file(file_path, upm:, codepoint:)`
|
|
24
|
+
| Convert one `.svg` file into a `Ufo::Glyph`
|
|
25
|
+
|
|
26
|
+
| `SvgToGlyf.from_directory(dir, upm:)`
|
|
27
|
+
| Convert a directory of `.svg` files into a `Ufo::Font` (one glyph
|
|
28
|
+
per file)
|
|
29
|
+
|===
|
|
30
|
+
|
|
31
|
+
The default `upm` is 1000.
|
|
32
|
+
|
|
33
|
+
== Single path
|
|
34
|
+
|
|
35
|
+
[source,ruby]
|
|
36
|
+
----
|
|
37
|
+
glyph = Fontisan::SvgToGlyf.convert(
|
|
38
|
+
"M 0 0 L 500 0 L 500 700 L 0 700 Z",
|
|
39
|
+
upm: 1000,
|
|
40
|
+
codepoint: 0x10940,
|
|
41
|
+
)
|
|
42
|
+
# → #<Fontisan::Ufo::Glyph name="uni10940" ...>
|
|
43
|
+
----
|
|
44
|
+
|
|
45
|
+
== Single file
|
|
46
|
+
|
|
47
|
+
[source,ruby]
|
|
48
|
+
----
|
|
49
|
+
glyph = Fontisan::SvgToGlyf.from_svg_file("U+10940.svg", upm: 1000)
|
|
50
|
+
----
|
|
51
|
+
|
|
52
|
+
If the codepoint is not supplied, it is derived from the filename when
|
|
53
|
+
it matches `U+XXXX.svg` or `hexcode.svg`.
|
|
54
|
+
|
|
55
|
+
== Directory → Font
|
|
56
|
+
|
|
57
|
+
For batch conversion of a code-chart directory (one SVG per
|
|
58
|
+
codepoint):
|
|
59
|
+
|
|
60
|
+
[source,ruby]
|
|
61
|
+
----
|
|
62
|
+
font = Fontisan::SvgToGlyf.from_directory(
|
|
63
|
+
"/tmp/chart-svg/Khitan",
|
|
64
|
+
upm: 1000,
|
|
65
|
+
)
|
|
66
|
+
Fontisan::Ufo::Compile::TtfCompiler.new(font)
|
|
67
|
+
.compile(output_path: "Khitan.ttf")
|
|
68
|
+
----
|
|
69
|
+
|
|
70
|
+
Or feed it directly to the Stitcher:
|
|
71
|
+
|
|
72
|
+
[source,ruby]
|
|
73
|
+
----
|
|
74
|
+
stitcher = Fontisan::Stitcher.new
|
|
75
|
+
stitcher.add_source(:khitan, font)
|
|
76
|
+
stitcher.include_range(0x18B00..0x18CFF, from: :khitan, into: :main)
|
|
77
|
+
stitcher.write_to("Khitan.ttf", format: :ttf, subfont: :main)
|
|
78
|
+
----
|
|
79
|
+
|
|
80
|
+
== SVG subset supported
|
|
81
|
+
|
|
82
|
+
SvgToGlyf handles the subset of SVG that real chart extractions use:
|
|
83
|
+
|
|
84
|
+
* Path commands: `M`, `L`, `H`, `V`, `C`, `S`, `Q`, `T`, `A`, `Z`
|
|
85
|
+
(absolute and lowercase relative variants)
|
|
86
|
+
* `<svg>` `viewBox` and `width`/`height` for coordinate scaling
|
|
87
|
+
* `<g transform="...">` group transforms (matrix, translate, scale,
|
|
88
|
+
rotate)
|
|
89
|
+
* `<path d="...">` elements
|
|
90
|
+
|
|
91
|
+
Unsupported SVG features (filters, masks, embedded raster images) are
|
|
92
|
+
ignored. SvgToGlyf is a vector-only converter — for raster emoji, use
|
|
93
|
+
the CBDT/CBLC passthrough path (see link:STITCHER_GUIDE.adoc[Stitcher Guide]).
|
|
94
|
+
|
|
95
|
+
== Coordinate system
|
|
96
|
+
|
|
97
|
+
SVG uses a y-down coordinate system; UFO uses y-up. SvgToGlyf flips
|
|
98
|
+
the y-axis using the SVG `viewBox` height so glyphs render right-way-up
|
|
99
|
+
in font rendering contexts. When no `viewBox` is present, the
|
|
100
|
+
`<svg>` `width`/`height` attributes are used as a fallback.
|
|
101
|
+
|
|
102
|
+
== Namespace layout
|
|
103
|
+
|
|
104
|
+
[source]
|
|
105
|
+
----
|
|
106
|
+
Fontisan::SvgToGlyf
|
|
107
|
+
├── Path # SVG path parser → contour builder
|
|
108
|
+
├── Geometry # AffineTransform, vector math
|
|
109
|
+
├── Document # <svg> document parsing, viewBox handling
|
|
110
|
+
└── Assembler # top-level glue: builds Ufo::Glyph / Ufo::Font
|
|
111
|
+
----
|
|
112
|
+
|
|
113
|
+
== See also
|
|
114
|
+
|
|
115
|
+
* link:UFO_COMPILATION.adoc[UFO Compilation Guide] — compile converted
|
|
116
|
+
glyphs to binary fonts
|
|
117
|
+
* link:STITCHER_GUIDE.adoc[Stitcher Guide] — combine converted fonts
|
|
118
|
+
with other donors
|