fontisan 0.4.49-x86_64-linux
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.rspec +3 -0
- data/.rubocop.yml +141 -0
- data/.rubocop_todo.yml +433 -0
- data/BENCHMARKS.md +56 -0
- data/BUG-stitcher-drops-isolated-cps.md +58 -0
- data/BUG-stitcher-drops-plane1-codepoints.md +310 -0
- data/BUG-stitcher-gid-cap-65535.md +110 -0
- data/CHANGELOG.md +293 -0
- data/Gemfile +40 -0
- data/LICENSE +28 -0
- data/README.adoc +2811 -0
- data/Rakefile +156 -0
- data/TODO.bug-fixes/01-cff-expert-charsets.md +27 -0
- data/TODO.bug-fixes/02-cff2-subroutine-stubs.md +32 -0
- data/TODO.bug-fixes/03-variation-subsetter-placeholders.md +42 -0
- data/TODO.bug-fixes/04-ufo-image-compile-roundtrip.md +28 -0
- data/TODO.bug-fixes/05-stale-cff-comment.md +18 -0
- data/TODO.bug-fixes/06-instance-woff2-output.md +24 -0
- data/TODO.bug-fixes/07-encapsulation-violations.md +38 -0
- data/TODO.bug-fixes/08-respond-to-violations.md +25 -0
- data/TODO.bug-fixes/09-type1-cff-seac-expansion.md +22 -0
- data/TODO.bug-fixes/10-ttf-type1-composite-glyphs.md +23 -0
- data/TODO.bug-fixes/11-remaining-respond-to.md +25 -0
- data/TODO.bug-fixes/12-type1-generators-duck-typing.md +80 -0
- data/TODO.bug-fixes/13-hint-extractor-duck-typing.md +30 -0
- data/TODO.bug-fixes/14-font-interface-type-checks.md +82 -0
- data/TODO.bug-fixes/15-glyph-type-checks-and-simple-glyph-points-bug.md +49 -0
- data/TODO.bug-fixes/16-variation-table-checks.md +31 -0
- data/TODO.bug-fixes/17-ufo-and-stitcher-cleanup.md +32 -0
- data/TODO.bug-fixes/18-generic-value-and-io-checks.md +56 -0
- data/TODO.bug-fixes/19-serialization-migration.md +52 -0
- data/TODO.bug-fixes/20-variation-validator-type-checks.md +29 -0
- data/TODO.bug-fixes/21-xml-builder-send.md +24 -0
- data/TODO.bug-fixes/22-type1-converter-font-info.md +25 -0
- data/TODO.bug-fixes/23-boundary-type-checks.md +31 -0
- data/TODO.bug-fixes/24-validator-dynamic-field-key.md +25 -0
- data/TODO.bug-fixes/25-serialization-migration.md +49 -0
- data/TODO.bug-fixes/26-variation-preserver-spec-migration.md +25 -0
- data/TODO.bug-fixes/27-table-class-registry.md +50 -0
- data/TODO.bug-fixes/28-spec-doubles-cleanup.md +40 -0
- data/TODO.bug-fixes/29-strategy-registries.md +30 -0
- data/TODO.bug-fixes/30-eliminate-send-in-specs.md +36 -0
- data/TODO.bug-fixes/README.md +52 -0
- data/TODO.improvements/01-cbdt-cblc-gid-stable-propagation.md +73 -0
- data/TODO.improvements/02-collection-outline-priority.md +48 -0
- data/TODO.improvements/03-fontisan-audit-command.md +219 -0
- data/TODO.improvements/04-ufo-composite-glyph-encoding.md +46 -0
- data/TODO.improvements/05-otf-compiler-real-cff.md +63 -0
- data/TODO.improvements/06-cff2-blend-vsindex-operators.md +51 -0
- data/TODO.improvements/07-cpal-v1-header-fields.md +71 -0
- data/TODO.improvements/08-cff-standard-string-table.md +52 -0
- data/TODO.improvements/09-type1-seac-expansion.md +57 -0
- data/TODO.improvements/10-ufo-image-set-feature-writers.md +71 -0
- data/TODO.improvements/11-kern-groups-plist.md +49 -0
- data/TODO.improvements/12-cbdt-fixture-bindata-conversion.md +68 -0
- data/TODO.improvements/13-split-octokit-fetcher.md +45 -0
- data/TODO.improvements/14-rubocop-baseline-chip.md +62 -0
- data/TODO.improvements/15-cff-cff2-subsetter-strategy.md +78 -0
- data/TODO.improvements/README.md +58 -0
- data/benchmark/baseline.json +5 -0
- data/benchmark/ci_gate.rb +217 -0
- data/benchmark/compile_benchmark.rb +78 -0
- data/benchmark/corpus/harness.rb +175 -0
- data/benchmark/corpus/ops.rb +150 -0
- data/benchmark/corpus/run.rb +182 -0
- data/benchmark/corpus/scan_child.rb +8 -0
- data/benchmark/corpus/tiers.rb +176 -0
- data/benchmark/tier_baseline.json +12 -0
- data/benchmark/variation_quick_bench.rb +47 -0
- data/build_mingw32_stub.rb +15 -0
- data/docs/.gitignore +17 -0
- data/docs/.vitepress/config.ts +373 -0
- data/docs/.vitepress/theme/components/ApiMethod.vue +127 -0
- data/docs/.vitepress/theme/components/Badge.vue +51 -0
- data/docs/.vitepress/theme/components/FeatureComparison.vue +87 -0
- data/docs/.vitepress/theme/components/HeroCodeBlock.vue +98 -0
- data/docs/.vitepress/theme/components/WithinHero.vue +30 -0
- data/docs/.vitepress/theme/index.ts +22 -0
- data/docs/.vitepress/theme/style.css +628 -0
- data/docs/AFDKO_MIGRATION.adoc +175 -0
- data/docs/APPLE_LEGACY_FONTS.adoc +173 -0
- data/docs/CFF2_SUPPORT.adoc +184 -0
- data/docs/COLLECTION_VALIDATION.adoc +204 -0
- data/docs/COLOR_FONTS.adoc +127 -0
- data/docs/CONVERSION_GUIDE.adoc +656 -0
- data/docs/EXTRACT_TTC_MIGRATION.md +549 -0
- data/docs/FEATURE_PARITY.adoc +263 -0
- data/docs/FONT_HINTING.adoc +570 -0
- data/docs/STITCHER_GUIDE.adoc +436 -0
- data/docs/SVG_TO_GLYF.adoc +118 -0
- data/docs/TTX.adoc +176 -0
- data/docs/TYPE1_FONTS.adoc +445 -0
- data/docs/UFO_COMPILATION.adoc +397 -0
- data/docs/VALIDATION.adoc +254 -0
- data/docs/VARIABLE_FONT_OPERATIONS.adoc +599 -0
- data/docs/WOFF_WOFF2_FORMATS.adoc +220 -0
- data/docs/api/conversion-options.md +164 -0
- data/docs/api/converters/curve-converter.md +34 -0
- data/docs/api/converters/hint-converter.md +34 -0
- data/docs/api/converters/outline-converter.md +27 -0
- data/docs/api/font-loader.md +117 -0
- data/docs/api/font-writer.md +103 -0
- data/docs/api/index.md +79 -0
- data/docs/api/layer.md +89 -0
- data/docs/api/models/glyph-accessor.md +43 -0
- data/docs/api/models/glyph.md +40 -0
- data/docs/api/models/table-analyzer.md +35 -0
- data/docs/api/sfnt-font.md +53 -0
- data/docs/api/type1-font.md +43 -0
- data/docs/api/validators/font-validator.md +31 -0
- data/docs/api/validators/helper.md +36 -0
- data/docs/api/validators/profile.md +39 -0
- data/docs/cli/convert.md +148 -0
- data/docs/cli/dump-table.md +110 -0
- data/docs/cli/export.md +176 -0
- data/docs/cli/features.md +124 -0
- data/docs/cli/glyphs.md +90 -0
- data/docs/cli/index.md +232 -0
- data/docs/cli/info.md +254 -0
- data/docs/cli/instance.md +122 -0
- data/docs/cli/ls.md +95 -0
- data/docs/cli/optical-size.md +94 -0
- data/docs/cli/pack.md +125 -0
- data/docs/cli/scripts.md +105 -0
- data/docs/cli/subset.md +58 -0
- data/docs/cli/tables.md +84 -0
- data/docs/cli/unicode.md +101 -0
- data/docs/cli/validate-collection.md +95 -0
- data/docs/cli/validate.md +56 -0
- data/docs/cli/variable.md +126 -0
- data/docs/cli/version.md +46 -0
- data/docs/guide/cli/convert.md +108 -0
- data/docs/guide/cli/export.md +138 -0
- data/docs/guide/cli/index.md +99 -0
- data/docs/guide/cli/info.md +144 -0
- data/docs/guide/cli/pack.md +155 -0
- data/docs/guide/cli/subset.md +149 -0
- data/docs/guide/cli/validate.md +139 -0
- data/docs/guide/color-fonts/bitmaps.md +194 -0
- data/docs/guide/color-fonts/colr-cpal.md +175 -0
- data/docs/guide/color-fonts/index.md +140 -0
- data/docs/guide/color-fonts/svg.md +154 -0
- data/docs/guide/color.md +51 -0
- data/docs/guide/comparisons/font-validator.md +222 -0
- data/docs/guide/comparisons/fonttools.md +200 -0
- data/docs/guide/comparisons/index.md +83 -0
- data/docs/guide/comparisons/lcdf-typetools.md +205 -0
- data/docs/guide/contributing.md +279 -0
- data/docs/guide/conversion/collections.md +251 -0
- data/docs/guide/conversion/curves.md +246 -0
- data/docs/guide/conversion/index.md +157 -0
- data/docs/guide/conversion/options.md +280 -0
- data/docs/guide/conversion/ttf-otf.md +184 -0
- data/docs/guide/conversion/type1.md +208 -0
- data/docs/guide/conversion/web.md +299 -0
- data/docs/guide/conversion.md +40 -0
- data/docs/guide/engines.md +117 -0
- data/docs/guide/formats/collections.md +147 -0
- data/docs/guide/formats/dfont.md +99 -0
- data/docs/guide/formats/index.md +65 -0
- data/docs/guide/formats/otf.md +103 -0
- data/docs/guide/formats/svg.md +97 -0
- data/docs/guide/formats/ttf.md +105 -0
- data/docs/guide/formats/type1.md +118 -0
- data/docs/guide/formats/woff.md +139 -0
- data/docs/guide/hinting/autohint.md +141 -0
- data/docs/guide/hinting/conversion.md +161 -0
- data/docs/guide/hinting/index.md +86 -0
- data/docs/guide/hinting/postscript.md +149 -0
- data/docs/guide/hinting/truetype.md +135 -0
- data/docs/guide/hinting.md +44 -0
- data/docs/guide/index.md +152 -0
- data/docs/guide/installation.md +116 -0
- data/docs/guide/migrations/extract-ttc.md +549 -0
- data/docs/guide/migrations/font-validator.md +260 -0
- data/docs/guide/migrations/fonttools.md +208 -0
- data/docs/guide/migrations/index.md +64 -0
- data/docs/guide/migrations/otfinfo.md +197 -0
- data/docs/guide/quick-start.md +204 -0
- data/docs/guide/type1.md +58 -0
- data/docs/guide/universal-outline.md +151 -0
- data/docs/guide/validation/custom.md +195 -0
- data/docs/guide/validation/helpers.md +188 -0
- data/docs/guide/validation/index.md +132 -0
- data/docs/guide/validation/profiles.md +156 -0
- data/docs/guide/validation.md +47 -0
- data/docs/guide/variable-fonts/advanced.md +231 -0
- data/docs/guide/variable-fonts/axes.md +209 -0
- data/docs/guide/variable-fonts/conversion.md +197 -0
- data/docs/guide/variable-fonts/index.md +84 -0
- data/docs/guide/variable-fonts/instances.md +187 -0
- data/docs/guide/variable-fonts/named-instances.md +194 -0
- data/docs/guide/variable-fonts/static.md +168 -0
- data/docs/guide/variable.md +58 -0
- data/docs/guide/woff.md +61 -0
- data/docs/index.md +136 -0
- data/docs/lychee.toml +41 -0
- data/docs/package-lock.json +2560 -0
- data/docs/package.json +15 -0
- data/docs/public/apple-touch-icon.png +0 -0
- data/docs/public/favicon-96x96.png +0 -0
- data/docs/public/favicon.ico +0 -0
- data/docs/public/favicon.svg +1 -0
- data/docs/public/logo-full.svg +1 -0
- data/docs/public/logo.svg +1 -0
- data/docs/public/robots.txt +4 -0
- data/docs/public/site.webmanifest +21 -0
- data/docs/public/web-app-manifest-192x192.png +0 -0
- data/docs/public/web-app-manifest-512x512.png +0 -0
- data/docs/reference-facade.md +130 -0
- data/docs/scripts/post-build.mjs +81 -0
- data/exe/fontisan +7 -0
- data/lib/fontisan/audit/check.rb +47 -0
- data/lib/fontisan/audit/check_registry.rb +77 -0
- data/lib/fontisan/audit/checks/cff_table_check.rb +87 -0
- data/lib/fontisan/audit/checks/cmap_check.rb +256 -0
- data/lib/fontisan/audit/checks/collection_integrity_check.rb +102 -0
- data/lib/fontisan/audit/checks/format_round_trip_check.rb +150 -0
- data/lib/fontisan/audit/checks/glyf_table_check.rb +115 -0
- data/lib/fontisan/audit/checks/glyph_name_check.rb +107 -0
- data/lib/fontisan/audit/checks/head_check.rb +96 -0
- data/lib/fontisan/audit/checks/hhea_check.rb +68 -0
- data/lib/fontisan/audit/checks/hinting_check.rb +163 -0
- data/lib/fontisan/audit/checks/kern_check.rb +47 -0
- data/lib/fontisan/audit/checks/layout_table_check.rb +70 -0
- data/lib/fontisan/audit/checks/maxp_check.rb +85 -0
- data/lib/fontisan/audit/checks/name_table_check.rb +78 -0
- data/lib/fontisan/audit/checks/naming_consistency_check.rb +102 -0
- data/lib/fontisan/audit/checks/opentype_conformance_check.rb +108 -0
- data/lib/fontisan/audit/checks/os2_check.rb +117 -0
- data/lib/fontisan/audit/checks/ots_compatibility_check.rb +191 -0
- data/lib/fontisan/audit/checks/post_check.rb +75 -0
- data/lib/fontisan/audit/checks/table_directory_check.rb +157 -0
- data/lib/fontisan/audit/checks/variable_font_check.rb +151 -0
- data/lib/fontisan/audit/checks/woff2_validation_check.rb +140 -0
- data/lib/fontisan/audit/checks.rb +42 -0
- data/lib/fontisan/audit.rb +20 -0
- data/lib/fontisan/base_collection.rb +312 -0
- data/lib/fontisan/binary/base_record.rb +82 -0
- data/lib/fontisan/binary/structures.rb +82 -0
- data/lib/fontisan/binary.rb +11 -0
- data/lib/fontisan/byte_ops.rb +314 -0
- data/lib/fontisan/cli.rb +1111 -0
- data/lib/fontisan/collection/builder.rb +336 -0
- data/lib/fontisan/collection/dfont_builder.rb +305 -0
- data/lib/fontisan/collection/offset_calculator.rb +229 -0
- data/lib/fontisan/collection/reader/stats.rb +23 -0
- data/lib/fontisan/collection/reader.rb +90 -0
- data/lib/fontisan/collection/shared_logic.rb +52 -0
- data/lib/fontisan/collection/table_analyzer.rb +289 -0
- data/lib/fontisan/collection/table_deduplicator.rb +317 -0
- data/lib/fontisan/collection/writer.rb +289 -0
- data/lib/fontisan/collection.rb +16 -0
- data/lib/fontisan/commands/audit_command.rb +288 -0
- data/lib/fontisan/commands/base_command.rb +88 -0
- data/lib/fontisan/commands/convert_command.rb +506 -0
- data/lib/fontisan/commands/dump_table_command.rb +68 -0
- data/lib/fontisan/commands/export_command.rb +157 -0
- data/lib/fontisan/commands/features_command.rb +90 -0
- data/lib/fontisan/commands/glyphs_command.rb +50 -0
- data/lib/fontisan/commands/info_command.rb +447 -0
- data/lib/fontisan/commands/instance_command.rb +357 -0
- data/lib/fontisan/commands/ls_command.rb +107 -0
- data/lib/fontisan/commands/multi_format_output.rb +64 -0
- data/lib/fontisan/commands/optical_size_command.rb +38 -0
- data/lib/fontisan/commands/pack_command.rb +344 -0
- data/lib/fontisan/commands/scripts_command.rb +56 -0
- data/lib/fontisan/commands/subset_command.rb +285 -0
- data/lib/fontisan/commands/tables_command.rb +52 -0
- data/lib/fontisan/commands/unicode_command.rb +73 -0
- data/lib/fontisan/commands/unpack_command.rb +387 -0
- data/lib/fontisan/commands/validate_collection_command.rb +127 -0
- data/lib/fontisan/commands/validate_command.rb +305 -0
- data/lib/fontisan/commands/variable_command.rb +87 -0
- data/lib/fontisan/commands.rb +30 -0
- data/lib/fontisan/config/collection_settings.yml +56 -0
- data/lib/fontisan/config/conversion_matrix.yml +626 -0
- data/lib/fontisan/config/export_settings.yml +66 -0
- data/lib/fontisan/config/features.yml +143 -0
- data/lib/fontisan/config/scripts.yml +42 -0
- data/lib/fontisan/config/subset_profiles.yml +106 -0
- data/lib/fontisan/config/svg_settings.yml +60 -0
- data/lib/fontisan/config/variable_settings.yml +99 -0
- data/lib/fontisan/config/woff2_settings.yml +77 -0
- data/lib/fontisan/constants.rb +219 -0
- data/lib/fontisan/conversion_options.rb +389 -0
- data/lib/fontisan/converters/cff_table_builder.rb +195 -0
- data/lib/fontisan/converters/collection_converter.rb +520 -0
- data/lib/fontisan/converters/conversion_strategy.rb +211 -0
- data/lib/fontisan/converters/format_converter.rb +536 -0
- data/lib/fontisan/converters/glyf_table_builder.rb +61 -0
- data/lib/fontisan/converters/outline_converter.rb +720 -0
- data/lib/fontisan/converters/outline_extraction.rb +88 -0
- data/lib/fontisan/converters/outline_optimizer.rb +84 -0
- data/lib/fontisan/converters/svg_generator.rb +236 -0
- data/lib/fontisan/converters/table_copier.rb +107 -0
- data/lib/fontisan/converters/type1_converter.rb +1201 -0
- data/lib/fontisan/converters/woff2_encoder.rb +520 -0
- data/lib/fontisan/converters/woff_writer.rb +358 -0
- data/lib/fontisan/converters.rb +21 -0
- data/lib/fontisan/dfont_collection.rb +288 -0
- data/lib/fontisan/engine.rb +393 -0
- data/lib/fontisan/error.rb +281 -0
- data/lib/fontisan/export/exporter.rb +255 -0
- data/lib/fontisan/export/table_serializer.rb +140 -0
- data/lib/fontisan/export/transformers/font_to_ttx.rb +163 -0
- data/lib/fontisan/export/transformers/head_transformer.rb +94 -0
- data/lib/fontisan/export/transformers/hhea_transformer.rb +57 -0
- data/lib/fontisan/export/transformers/maxp_transformer.rb +61 -0
- data/lib/fontisan/export/transformers/name_transformer.rb +61 -0
- data/lib/fontisan/export/transformers/os2_transformer.rb +119 -0
- data/lib/fontisan/export/transformers/post_transformer.rb +49 -0
- data/lib/fontisan/export/transformers.rb +17 -0
- data/lib/fontisan/export/ttx_generator.rb +526 -0
- data/lib/fontisan/export/ttx_parser.rb +300 -0
- data/lib/fontisan/export.rb +13 -0
- data/lib/fontisan/ffi/client.rb +123 -0
- data/lib/fontisan/ffi/libfontisan_cdylib.so +0 -0
- data/lib/fontisan/ffi.rb +387 -0
- data/lib/fontisan/ffi_platform.rb +24 -0
- data/lib/fontisan/font_loader.rb +315 -0
- data/lib/fontisan/font_writer.rb +309 -0
- data/lib/fontisan/formatters/text_formatter.rb +517 -0
- data/lib/fontisan/formatters.rb +9 -0
- data/lib/fontisan/glyph_accessor.rb +525 -0
- data/lib/fontisan/hints/hint_converter.rb +309 -0
- data/lib/fontisan/hints/hint_validator.rb +287 -0
- data/lib/fontisan/hints/postscript_hint_applier.rb +255 -0
- data/lib/fontisan/hints/postscript_hint_extractor.rb +347 -0
- data/lib/fontisan/hints/truetype_hint_applier.rb +117 -0
- data/lib/fontisan/hints/truetype_hint_extractor.rb +283 -0
- data/lib/fontisan/hints/truetype_instruction_analyzer.rb +268 -0
- data/lib/fontisan/hints/truetype_instruction_generator.rb +266 -0
- data/lib/fontisan/hints.rb +19 -0
- data/lib/fontisan/loading_modes.rb +113 -0
- data/lib/fontisan/metrics_calculator.rb +275 -0
- data/lib/fontisan/models/all_scripts_features_info.rb +20 -0
- data/lib/fontisan/models/audit_report.rb +196 -0
- data/lib/fontisan/models/bitmap_glyph.rb +123 -0
- data/lib/fontisan/models/bitmap_strike.rb +94 -0
- data/lib/fontisan/models/collection_brief_info.rb +36 -0
- data/lib/fontisan/models/collection_font_summary.rb +52 -0
- data/lib/fontisan/models/collection_info.rb +79 -0
- data/lib/fontisan/models/collection_list_info.rb +36 -0
- data/lib/fontisan/models/collection_validation_report.rb +102 -0
- data/lib/fontisan/models/color_glyph.rb +56 -0
- data/lib/fontisan/models/color_layer.rb +53 -0
- data/lib/fontisan/models/color_palette.rb +60 -0
- data/lib/fontisan/models/features_info.rb +42 -0
- data/lib/fontisan/models/font_export.rb +158 -0
- data/lib/fontisan/models/font_info.rb +98 -0
- data/lib/fontisan/models/font_report.rb +23 -0
- data/lib/fontisan/models/font_summary.rb +48 -0
- data/lib/fontisan/models/glyph_info.rb +26 -0
- data/lib/fontisan/models/glyph_outline.rb +343 -0
- data/lib/fontisan/models/hint.rb +404 -0
- data/lib/fontisan/models/optical_size_info.rb +33 -0
- data/lib/fontisan/models/outline.rb +667 -0
- data/lib/fontisan/models/scripts_info.rb +39 -0
- data/lib/fontisan/models/svg_glyph.rb +89 -0
- data/lib/fontisan/models/table_info.rb +55 -0
- data/lib/fontisan/models/table_sharing_info.rb +40 -0
- data/lib/fontisan/models/ttx/glyph_order.rb +31 -0
- data/lib/fontisan/models/ttx/tables/binary_table.rb +67 -0
- data/lib/fontisan/models/ttx/tables/head_table.rb +74 -0
- data/lib/fontisan/models/ttx/tables/hhea_table.rb +74 -0
- data/lib/fontisan/models/ttx/tables/maxp_table.rb +55 -0
- data/lib/fontisan/models/ttx/tables/name_table.rb +45 -0
- data/lib/fontisan/models/ttx/tables/os2_table.rb +157 -0
- data/lib/fontisan/models/ttx/tables/post_table.rb +50 -0
- data/lib/fontisan/models/ttx/tables.rb +21 -0
- data/lib/fontisan/models/ttx/ttfont.rb +41 -0
- data/lib/fontisan/models/ttx.rb +14 -0
- data/lib/fontisan/models/unicode_mappings.rb +42 -0
- data/lib/fontisan/models/validation_report.rb +435 -0
- data/lib/fontisan/models/variable_font_info.rb +82 -0
- data/lib/fontisan/models.rb +49 -0
- data/lib/fontisan/native/3.2/fontisan_native.so +0 -0
- data/lib/fontisan/native/3.3/fontisan_native.so +0 -0
- data/lib/fontisan/native/3.4/fontisan_native.so +0 -0
- data/lib/fontisan/native/4.0/fontisan_native.so +0 -0
- data/lib/fontisan/native.rb +235 -0
- data/lib/fontisan/open_type_collection.rb +49 -0
- data/lib/fontisan/open_type_font.rb +161 -0
- data/lib/fontisan/open_type_font_extensions.rb +54 -0
- data/lib/fontisan/optimizers/charstring_rewriter.rb +172 -0
- data/lib/fontisan/optimizers/pattern_analyzer.rb +310 -0
- data/lib/fontisan/optimizers/stack_tracker.rb +246 -0
- data/lib/fontisan/optimizers/subroutine_builder.rb +135 -0
- data/lib/fontisan/optimizers/subroutine_generator.rb +207 -0
- data/lib/fontisan/optimizers/subroutine_optimizer.rb +114 -0
- data/lib/fontisan/optimizers.rb +14 -0
- data/lib/fontisan/outline_extractor.rb +417 -0
- data/lib/fontisan/output_guard.rb +40 -0
- data/lib/fontisan/parsers/dfont_parser.rb +191 -0
- data/lib/fontisan/parsers/tag.rb +77 -0
- data/lib/fontisan/parsers.rb +10 -0
- data/lib/fontisan/pipeline/format_detector.rb +176 -0
- data/lib/fontisan/pipeline/output_writer.rb +161 -0
- data/lib/fontisan/pipeline/strategies/base_strategy.rb +75 -0
- data/lib/fontisan/pipeline/strategies/instance_strategy.rb +89 -0
- data/lib/fontisan/pipeline/strategies/named_strategy.rb +114 -0
- data/lib/fontisan/pipeline/strategies/preserve_strategy.rb +54 -0
- data/lib/fontisan/pipeline/strategies.rb +16 -0
- data/lib/fontisan/pipeline/transformation_pipeline.rb +407 -0
- data/lib/fontisan/pipeline/variation_resolver.rb +158 -0
- data/lib/fontisan/pipeline.rb +14 -0
- data/lib/fontisan/reference/table_digests.rb +251 -0
- data/lib/fontisan/reference.rb +663 -0
- data/lib/fontisan/scan.rb +372 -0
- data/lib/fontisan/sfnt_builder.rb +66 -0
- data/lib/fontisan/sfnt_directory.rb +41 -0
- data/lib/fontisan/sfnt_font.rb +749 -0
- data/lib/fontisan/sfnt_source.rb +28 -0
- data/lib/fontisan/sfnt_table.rb +260 -0
- data/lib/fontisan/stitcher/cbdt_propagator.rb +212 -0
- data/lib/fontisan/stitcher/collection_result.rb +19 -0
- data/lib/fontisan/stitcher/deduplicator.rb +47 -0
- data/lib/fontisan/stitcher/format_metadata.rb +51 -0
- data/lib/fontisan/stitcher/glyph_cloner.rb +41 -0
- data/lib/fontisan/stitcher/glyph_copier.rb +110 -0
- data/lib/fontisan/stitcher/glyph_limit.rb +53 -0
- data/lib/fontisan/stitcher/glyph_signature.rb +51 -0
- data/lib/fontisan/stitcher/partition_strategy/base.rb +52 -0
- data/lib/fontisan/stitcher/partition_strategy/blueprint.rb +24 -0
- data/lib/fontisan/stitcher/partition_strategy/by_block.rb +430 -0
- data/lib/fontisan/stitcher/partition_strategy/by_plane.rb +161 -0
- data/lib/fontisan/stitcher/partition_strategy/by_script.rb +309 -0
- data/lib/fontisan/stitcher/partition_strategy/partition.rb +24 -0
- data/lib/fontisan/stitcher/partition_strategy.rb +24 -0
- data/lib/fontisan/stitcher/selector/codepoints.rb +29 -0
- data/lib/fontisan/stitcher/selector/gid.rb +25 -0
- data/lib/fontisan/stitcher/selector/range.rb +30 -0
- data/lib/fontisan/stitcher/selector.rb +26 -0
- data/lib/fontisan/stitcher/source.rb +459 -0
- data/lib/fontisan/stitcher/unique_glyph_name.rb +46 -0
- data/lib/fontisan/stitcher.rb +185 -0
- data/lib/fontisan/stitcher_cli.rb +69 -0
- data/lib/fontisan/subset/builder.rb +263 -0
- data/lib/fontisan/subset/glyph_mapping.rb +222 -0
- data/lib/fontisan/subset/options.rb +142 -0
- data/lib/fontisan/subset/profile.rb +152 -0
- data/lib/fontisan/subset/shared_state.rb +42 -0
- data/lib/fontisan/subset/subset_context.rb +20 -0
- data/lib/fontisan/subset/table_strategy/cbdt.rb +30 -0
- data/lib/fontisan/subset/table_strategy/cblc.rb +27 -0
- data/lib/fontisan/subset/table_strategy/cff.rb +92 -0
- data/lib/fontisan/subset/table_strategy/cff2.rb +391 -0
- data/lib/fontisan/subset/table_strategy/cmap.rb +146 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_placement.rb +20 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_strike_plan.rb +45 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subset_plan.rb +62 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subsetter.rb +182 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subtable_plan.rb +59 -0
- data/lib/fontisan/subset/table_strategy/glyf.rb +29 -0
- data/lib/fontisan/subset/table_strategy/glyf_loca_builder.rb +146 -0
- data/lib/fontisan/subset/table_strategy/head.rb +43 -0
- data/lib/fontisan/subset/table_strategy/hhea.rb +67 -0
- data/lib/fontisan/subset/table_strategy/hmtx.rb +52 -0
- data/lib/fontisan/subset/table_strategy/loca.rb +41 -0
- data/lib/fontisan/subset/table_strategy/maxp.rb +23 -0
- data/lib/fontisan/subset/table_strategy/name.rb +19 -0
- data/lib/fontisan/subset/table_strategy/os2.rb +21 -0
- data/lib/fontisan/subset/table_strategy/pass_through.rb +20 -0
- data/lib/fontisan/subset/table_strategy/post.rb +37 -0
- data/lib/fontisan/subset/table_strategy.rb +79 -0
- data/lib/fontisan/subset/table_subsetter.rb +110 -0
- data/lib/fontisan/subset.rb +16 -0
- data/lib/fontisan/svg/font_face_generator.rb +274 -0
- data/lib/fontisan/svg/font_generator.rb +256 -0
- data/lib/fontisan/svg/glyph_generator.rb +201 -0
- data/lib/fontisan/svg/standalone_glyph.rb +132 -0
- data/lib/fontisan/svg/view_box_calculator.rb +137 -0
- data/lib/fontisan/svg.rb +13 -0
- data/lib/fontisan/svg_to_glyf/assembler.rb +174 -0
- data/lib/fontisan/svg_to_glyf/document.rb +102 -0
- data/lib/fontisan/svg_to_glyf/geometry/affine_transform.rb +112 -0
- data/lib/fontisan/svg_to_glyf/geometry/normalizer.rb +62 -0
- data/lib/fontisan/svg_to_glyf/geometry/transform_parser.rb +98 -0
- data/lib/fontisan/svg_to_glyf/geometry.rb +15 -0
- data/lib/fontisan/svg_to_glyf/path/command.rb +18 -0
- data/lib/fontisan/svg_to_glyf/path/contour_builder.rb +140 -0
- data/lib/fontisan/svg_to_glyf/path/parser.rb +98 -0
- data/lib/fontisan/svg_to_glyf/path/state.rb +79 -0
- data/lib/fontisan/svg_to_glyf/path.rb +14 -0
- data/lib/fontisan/svg_to_glyf.rb +62 -0
- data/lib/fontisan/tables/cbdt.rb +113 -0
- data/lib/fontisan/tables/cblc.rb +172 -0
- data/lib/fontisan/tables/cblc_big_glyph_metrics.rb +28 -0
- data/lib/fontisan/tables/cblc_bitmap_size.rb +67 -0
- data/lib/fontisan/tables/cblc_glyph_bitmap_location.rb +28 -0
- data/lib/fontisan/tables/cblc_index_subtable.rb +104 -0
- data/lib/fontisan/tables/cblc_index_subtable_array_entry.rb +20 -0
- data/lib/fontisan/tables/cblc_index_subtable_format_parser.rb +150 -0
- data/lib/fontisan/tables/cblc_index_subtable_header.rb +18 -0
- data/lib/fontisan/tables/cblc_sbit_line_metrics.rb +28 -0
- data/lib/fontisan/tables/cff/cff2_charstring_builder.rb +225 -0
- data/lib/fontisan/tables/cff/cff_glyph.rb +176 -0
- data/lib/fontisan/tables/cff/charset.rb +276 -0
- data/lib/fontisan/tables/cff/charstring.rb +978 -0
- data/lib/fontisan/tables/cff/charstring_builder.rb +356 -0
- data/lib/fontisan/tables/cff/charstring_parser.rb +249 -0
- data/lib/fontisan/tables/cff/charstring_rebuilder.rb +168 -0
- data/lib/fontisan/tables/cff/charstrings_index.rb +159 -0
- data/lib/fontisan/tables/cff/dict.rb +353 -0
- data/lib/fontisan/tables/cff/dict_builder.rb +260 -0
- data/lib/fontisan/tables/cff/encoding.rb +273 -0
- data/lib/fontisan/tables/cff/expert_charsets.rb +85 -0
- data/lib/fontisan/tables/cff/header.rb +100 -0
- data/lib/fontisan/tables/cff/hint_operation_injector.rb +207 -0
- data/lib/fontisan/tables/cff/index.rb +241 -0
- data/lib/fontisan/tables/cff/index_builder.rb +170 -0
- data/lib/fontisan/tables/cff/offset_recalculator.rb +70 -0
- data/lib/fontisan/tables/cff/private_dict.rb +282 -0
- data/lib/fontisan/tables/cff/private_dict_writer.rb +129 -0
- data/lib/fontisan/tables/cff/standard_strings_data.rb +83 -0
- data/lib/fontisan/tables/cff/table_builder.rb +215 -0
- data/lib/fontisan/tables/cff/top_dict.rb +234 -0
- data/lib/fontisan/tables/cff.rb +497 -0
- data/lib/fontisan/tables/cff2/blend_operator.rb +240 -0
- data/lib/fontisan/tables/cff2/charstring_parser.rb +624 -0
- data/lib/fontisan/tables/cff2/dict_encoder.rb +94 -0
- data/lib/fontisan/tables/cff2/fd_select.rb +142 -0
- data/lib/fontisan/tables/cff2/header.rb +34 -0
- data/lib/fontisan/tables/cff2/index.rb +155 -0
- data/lib/fontisan/tables/cff2/index_builder.rb +80 -0
- data/lib/fontisan/tables/cff2/operand_stack.rb +232 -0
- data/lib/fontisan/tables/cff2/private_dict_blend_handler.rb +247 -0
- data/lib/fontisan/tables/cff2/region_matcher.rb +200 -0
- data/lib/fontisan/tables/cff2/table_builder.rb +567 -0
- data/lib/fontisan/tables/cff2/table_reader.rb +418 -0
- data/lib/fontisan/tables/cff2/variation_data_extractor.rb +212 -0
- data/lib/fontisan/tables/cff2.rb +353 -0
- data/lib/fontisan/tables/cmap.rb +399 -0
- data/lib/fontisan/tables/cmap_table.rb +228 -0
- data/lib/fontisan/tables/colr.rb +290 -0
- data/lib/fontisan/tables/cpal.rb +381 -0
- data/lib/fontisan/tables/cvar.rb +204 -0
- data/lib/fontisan/tables/fvar.rb +159 -0
- data/lib/fontisan/tables/glyf/compound_glyph.rb +482 -0
- data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb +135 -0
- data/lib/fontisan/tables/glyf/curve_converter.rb +349 -0
- data/lib/fontisan/tables/glyf/glyph_builder.rb +468 -0
- data/lib/fontisan/tables/glyf/simple_glyph.rb +391 -0
- data/lib/fontisan/tables/glyf.rb +347 -0
- data/lib/fontisan/tables/glyf_table.rb +252 -0
- data/lib/fontisan/tables/gpos/glyph_filter.rb +87 -0
- data/lib/fontisan/tables/gpos/kerning_pairs.rb +215 -0
- data/lib/fontisan/tables/gpos/pair_position.rb +274 -0
- data/lib/fontisan/tables/gpos.rb +139 -0
- data/lib/fontisan/tables/gsub.rb +116 -0
- data/lib/fontisan/tables/gvar.rb +232 -0
- data/lib/fontisan/tables/head.rb +208 -0
- data/lib/fontisan/tables/head_table.rb +108 -0
- data/lib/fontisan/tables/hhea.rb +199 -0
- data/lib/fontisan/tables/hhea_table.rb +252 -0
- data/lib/fontisan/tables/hmtx.rb +281 -0
- data/lib/fontisan/tables/hmtx_table.rb +188 -0
- data/lib/fontisan/tables/hvar.rb +192 -0
- data/lib/fontisan/tables/layout_common.rb +245 -0
- data/lib/fontisan/tables/loca.rb +323 -0
- data/lib/fontisan/tables/loca_table.rb +209 -0
- data/lib/fontisan/tables/maxp.rb +253 -0
- data/lib/fontisan/tables/maxp_table.rb +255 -0
- data/lib/fontisan/tables/mvar.rb +185 -0
- data/lib/fontisan/tables/name.rb +340 -0
- data/lib/fontisan/tables/name_table.rb +173 -0
- data/lib/fontisan/tables/os2.rb +291 -0
- data/lib/fontisan/tables/os2_table.rb +326 -0
- data/lib/fontisan/tables/post.rb +206 -0
- data/lib/fontisan/tables/post_table.rb +180 -0
- data/lib/fontisan/tables/registry.rb +71 -0
- data/lib/fontisan/tables/sbix.rb +379 -0
- data/lib/fontisan/tables/svg.rb +300 -0
- data/lib/fontisan/tables/variation_common.rb +345 -0
- data/lib/fontisan/tables/vvar.rb +234 -0
- data/lib/fontisan/tables.rb +69 -0
- data/lib/fontisan/true_type_collection.rb +160 -0
- data/lib/fontisan/true_type_font.rb +80 -0
- data/lib/fontisan/true_type_font_extensions.rb +54 -0
- data/lib/fontisan/type1/afm_generator.rb +379 -0
- data/lib/fontisan/type1/afm_parser.rb +299 -0
- data/lib/fontisan/type1/agl.rb +456 -0
- data/lib/fontisan/type1/cff_to_type1_converter.rb +307 -0
- data/lib/fontisan/type1/charstring_converter.rb +238 -0
- data/lib/fontisan/type1/charstrings.rb +441 -0
- data/lib/fontisan/type1/conversion_options.rb +242 -0
- data/lib/fontisan/type1/decryptor.rb +183 -0
- data/lib/fontisan/type1/encodings.rb +695 -0
- data/lib/fontisan/type1/font_dictionary.rb +576 -0
- data/lib/fontisan/type1/generator.rb +217 -0
- data/lib/fontisan/type1/inf_generator.rb +307 -0
- data/lib/fontisan/type1/pfa_generator.rb +376 -0
- data/lib/fontisan/type1/pfa_parser.rb +159 -0
- data/lib/fontisan/type1/pfb_generator.rb +321 -0
- data/lib/fontisan/type1/pfb_parser.rb +166 -0
- data/lib/fontisan/type1/pfm_generator.rb +589 -0
- data/lib/fontisan/type1/pfm_parser.rb +433 -0
- data/lib/fontisan/type1/private_dict.rb +363 -0
- data/lib/fontisan/type1/seac_expander.rb +517 -0
- data/lib/fontisan/type1/ttf_to_type1_converter.rb +389 -0
- data/lib/fontisan/type1/upm_scaler.rb +118 -0
- data/lib/fontisan/type1.rb +48 -0
- data/lib/fontisan/type1_font.rb +347 -0
- data/lib/fontisan/ufo/anchor.rb +17 -0
- data/lib/fontisan/ufo/bounds.rb +91 -0
- data/lib/fontisan/ufo/cli.rb +105 -0
- data/lib/fontisan/ufo/compile/avar.rb +46 -0
- data/lib/fontisan/ufo/compile/base_compiler.rb +162 -0
- data/lib/fontisan/ufo/compile/cbdt_cblc.rb +104 -0
- data/lib/fontisan/ufo/compile/cff.rb +229 -0
- data/lib/fontisan/ufo/compile/cff2.rb +323 -0
- data/lib/fontisan/ufo/compile/cff2_subroutines.rb +39 -0
- data/lib/fontisan/ufo/compile/cmap.rb +143 -0
- data/lib/fontisan/ufo/compile/colr.rb +80 -0
- data/lib/fontisan/ufo/compile/cpal.rb +62 -0
- data/lib/fontisan/ufo/compile/feature_compiler.rb +161 -0
- data/lib/fontisan/ufo/compile/feature_writers/base.rb +56 -0
- data/lib/fontisan/ufo/compile/feature_writers/curs.rb +72 -0
- data/lib/fontisan/ufo/compile/feature_writers/gdef.rb +92 -0
- data/lib/fontisan/ufo/compile/feature_writers/kern.rb +50 -0
- data/lib/fontisan/ufo/compile/feature_writers/kern2.rb +57 -0
- data/lib/fontisan/ufo/compile/feature_writers/mark.rb +45 -0
- data/lib/fontisan/ufo/compile/feature_writers/mark_family_base.rb +124 -0
- data/lib/fontisan/ufo/compile/feature_writers/mkmk.rb +53 -0
- data/lib/fontisan/ufo/compile/feature_writers.rb +38 -0
- data/lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb +176 -0
- data/lib/fontisan/ufo/compile/filters/decompose_components.rb +33 -0
- data/lib/fontisan/ufo/compile/filters/flatten_components.rb +22 -0
- data/lib/fontisan/ufo/compile/filters/propagate_anchors.rb +102 -0
- data/lib/fontisan/ufo/compile/filters/remove_overlaps.rb +95 -0
- data/lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb +27 -0
- data/lib/fontisan/ufo/compile/filters/sort_contours.rb +69 -0
- data/lib/fontisan/ufo/compile/filters/transformations.rb +113 -0
- data/lib/fontisan/ufo/compile/filters.rb +69 -0
- data/lib/fontisan/ufo/compile/fvar.rb +113 -0
- data/lib/fontisan/ufo/compile/glyf_loca.rb +206 -0
- data/lib/fontisan/ufo/compile/gpos.rb +248 -0
- data/lib/fontisan/ufo/compile/gsub.rb +267 -0
- data/lib/fontisan/ufo/compile/gvar.rb +225 -0
- data/lib/fontisan/ufo/compile/head.rb +97 -0
- data/lib/fontisan/ufo/compile/hhea.rb +57 -0
- data/lib/fontisan/ufo/compile/hmtx.rb +38 -0
- data/lib/fontisan/ufo/compile/hvar.rb +42 -0
- data/lib/fontisan/ufo/compile/item_variation_store.rb +100 -0
- data/lib/fontisan/ufo/compile/math.rb +143 -0
- data/lib/fontisan/ufo/compile/maxp.rb +57 -0
- data/lib/fontisan/ufo/compile/meta.rb +51 -0
- data/lib/fontisan/ufo/compile/mvar.rb +59 -0
- data/lib/fontisan/ufo/compile/name.rb +81 -0
- data/lib/fontisan/ufo/compile/os2.rb +81 -0
- data/lib/fontisan/ufo/compile/otf2_compiler.rb +40 -0
- data/lib/fontisan/ufo/compile/otf_compiler.rb +34 -0
- data/lib/fontisan/ufo/compile/post.rb +32 -0
- data/lib/fontisan/ufo/compile/sbix.rb +100 -0
- data/lib/fontisan/ufo/compile/stat.rb +106 -0
- data/lib/fontisan/ufo/compile/svg_table.rb +60 -0
- data/lib/fontisan/ufo/compile/ttf_compiler.rb +75 -0
- data/lib/fontisan/ufo/compile/variable_otf.rb +84 -0
- data/lib/fontisan/ufo/compile/variable_ttf.rb +161 -0
- data/lib/fontisan/ufo/compile.rb +72 -0
- data/lib/fontisan/ufo/component.rb +18 -0
- data/lib/fontisan/ufo/contour.rb +34 -0
- data/lib/fontisan/ufo/convert/from_bin_data.rb +366 -0
- data/lib/fontisan/ufo/convert/to_dfont.rb +45 -0
- data/lib/fontisan/ufo/convert/to_otc.rb +40 -0
- data/lib/fontisan/ufo/convert/to_otf.rb +18 -0
- data/lib/fontisan/ufo/convert/to_otf2.rb +20 -0
- data/lib/fontisan/ufo/convert/to_postscript.rb +64 -0
- data/lib/fontisan/ufo/convert/to_ttc.rb +35 -0
- data/lib/fontisan/ufo/convert/to_ttf.rb +21 -0
- data/lib/fontisan/ufo/convert/to_woff.rb +61 -0
- data/lib/fontisan/ufo/convert/to_woff2.rb +50 -0
- data/lib/fontisan/ufo/convert.rb +84 -0
- data/lib/fontisan/ufo/data_set.rb +21 -0
- data/lib/fontisan/ufo/features.rb +17 -0
- data/lib/fontisan/ufo/font.rb +63 -0
- data/lib/fontisan/ufo/glyph.rb +445 -0
- data/lib/fontisan/ufo/glyph_exists_error.rb +23 -0
- data/lib/fontisan/ufo/groups.rb +45 -0
- data/lib/fontisan/ufo/guideline.rb +19 -0
- data/lib/fontisan/ufo/image.rb +29 -0
- data/lib/fontisan/ufo/image_set.rb +99 -0
- data/lib/fontisan/ufo/info.rb +133 -0
- data/lib/fontisan/ufo/kerning.rb +32 -0
- data/lib/fontisan/ufo/layer.rb +78 -0
- data/lib/fontisan/ufo/layer_set.rb +37 -0
- data/lib/fontisan/ufo/lib.rb +24 -0
- data/lib/fontisan/ufo/plist.rb +123 -0
- data/lib/fontisan/ufo/point.rb +32 -0
- data/lib/fontisan/ufo/reader.rb +163 -0
- data/lib/fontisan/ufo/transformation.rb +50 -0
- data/lib/fontisan/ufo/writer.rb +123 -0
- data/lib/fontisan/ufo.rb +47 -0
- data/lib/fontisan/unicode/plane.rb +44 -0
- data/lib/fontisan/unicode.rb +17 -0
- data/lib/fontisan/utilities/brotli_wrapper.rb +177 -0
- data/lib/fontisan/utilities/checksum_calculator.rb +104 -0
- data/lib/fontisan/utilities/padding.rb +61 -0
- data/lib/fontisan/utilities.rb +11 -0
- data/lib/fontisan/utils/thread_pool.rb +134 -0
- data/lib/fontisan/utils.rb +10 -0
- data/lib/fontisan/validation/collection_validator.rb +265 -0
- data/lib/fontisan/validation.rb +9 -0
- data/lib/fontisan/validators/basic_validator.rb +73 -0
- data/lib/fontisan/validators/font_book_validator.rb +107 -0
- data/lib/fontisan/validators/opentype_validator.rb +118 -0
- data/lib/fontisan/validators/profile_loader.rb +134 -0
- data/lib/fontisan/validators/validator.rb +494 -0
- data/lib/fontisan/validators/web_font_validator.rb +95 -0
- data/lib/fontisan/validators.rb +14 -0
- data/lib/fontisan/variable/axis_normalizer.rb +215 -0
- data/lib/fontisan/variable/delta_applicator.rb +302 -0
- data/lib/fontisan/variable/glyph_delta_processor.rb +218 -0
- data/lib/fontisan/variable/instancer.rb +172 -0
- data/lib/fontisan/variable/metric_delta_processor.rb +282 -0
- data/lib/fontisan/variable/region_matcher.rb +208 -0
- data/lib/fontisan/variable/static_font_builder.rb +209 -0
- data/lib/fontisan/variable/table_updater.rb +219 -0
- data/lib/fontisan/variable.rb +16 -0
- data/lib/fontisan/variation/blend_applier.rb +197 -0
- data/lib/fontisan/variation/cache.rb +299 -0
- data/lib/fontisan/variation/cache_key_builder.rb +162 -0
- data/lib/fontisan/variation/converter.rb +373 -0
- data/lib/fontisan/variation/data_extractor.rb +84 -0
- data/lib/fontisan/variation/delta_applier.rb +262 -0
- data/lib/fontisan/variation/delta_parser.rb +228 -0
- data/lib/fontisan/variation/inspector.rb +275 -0
- data/lib/fontisan/variation/instance_font_wrapper.rb +41 -0
- data/lib/fontisan/variation/instance_generator.rb +122 -0
- data/lib/fontisan/variation/instance_writer.rb +360 -0
- data/lib/fontisan/variation/instancing/axis_space.rb +136 -0
- data/lib/fontisan/variation/instancing/glyph_outline.rb +204 -0
- data/lib/fontisan/variation/instancing/gvar_reader.rb +146 -0
- data/lib/fontisan/variation/instancing/item_variation_store.rb +92 -0
- data/lib/fontisan/variation/instancing/name_rewriter.rb +90 -0
- data/lib/fontisan/variation/instancing/true_type_instancer.rb +326 -0
- data/lib/fontisan/variation/instancing.rb +20 -0
- data/lib/fontisan/variation/interpolator.rb +231 -0
- data/lib/fontisan/variation/metrics_adjuster.rb +309 -0
- data/lib/fontisan/variation/optimizer.rb +417 -0
- data/lib/fontisan/variation/parallel_generator.rb +147 -0
- data/lib/fontisan/variation/region_matcher.rb +221 -0
- data/lib/fontisan/variation/subsetter.rb +400 -0
- data/lib/fontisan/variation/table_accessor.rb +105 -0
- data/lib/fontisan/variation/tuple_variation_header.rb +49 -0
- data/lib/fontisan/variation/validator.rb +336 -0
- data/lib/fontisan/variation/variable_svg_generator.rb +235 -0
- data/lib/fontisan/variation/variation_context.rb +208 -0
- data/lib/fontisan/variation/variation_preserver.rb +287 -0
- data/lib/fontisan/variation.rb +33 -0
- data/lib/fontisan/version.rb +5 -0
- data/lib/fontisan/version.rb.orig +9 -0
- data/lib/fontisan/woff2/collection_decoder.rb +223 -0
- data/lib/fontisan/woff2/collection_encoder.rb +302 -0
- data/lib/fontisan/woff2/directory.rb +255 -0
- data/lib/fontisan/woff2/encoder_rules.rb +114 -0
- data/lib/fontisan/woff2/glyf_canonicalizer.rb +90 -0
- data/lib/fontisan/woff2/glyf_loca_reconstruct.rb +401 -0
- data/lib/fontisan/woff2/glyf_loca_transform.rb +319 -0
- data/lib/fontisan/woff2/header.rb +101 -0
- data/lib/fontisan/woff2/hmtx_transformer.rb +140 -0
- data/lib/fontisan/woff2/sfnt_checksum.rb +107 -0
- data/lib/fontisan/woff2/table_transformer.rb +575 -0
- data/lib/fontisan/woff2/triplet_codec.rb +181 -0
- data/lib/fontisan/woff2/uint255.rb +101 -0
- data/lib/fontisan/woff2.rb +21 -0
- data/lib/fontisan/woff2_collection.rb +127 -0
- data/lib/fontisan/woff2_font.rb +754 -0
- data/lib/fontisan/woff_container.rb +83 -0
- data/lib/fontisan/woff_font.rb +554 -0
- data/lib/fontisan.rb +299 -0
- data/rakelib/bench.rake +9 -0
- data/rakelib/cdylib.rake +39 -0
- data/rakelib/corpus.rake +272 -0
- data/rakelib/corpus_convert.rake +43 -0
- data/rakelib/corpus_goldens.rake +22 -0
- data/rakelib/corpus_malformed.rake +20 -0
- data/rakelib/corpus_scan.rake +24 -0
- data/rakelib/java.rake +61 -0
- data/rakelib/native.rake +43 -0
- data/scripts/build-woff2.sh +57 -0
- data/scripts/compare_stack_aware.rb +187 -0
- data/scripts/corpus/generate_convert_goldens.rb +478 -0
- data/scripts/corpus/generate_goldens.rb +282 -0
- data/scripts/corpus/generate_malformed_goldens.rb +254 -0
- data/scripts/corpus/generate_scan_goldens.rb +98 -0
- data/scripts/measure_optimization.rb +148 -0
- data/scripts/tier_fallback.rb +228 -0
- data/scripts/tier_smoke.rb +72 -0
- metadata +945 -0
data/docs/api/index.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: API Reference
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# API Reference
|
|
6
|
+
|
|
7
|
+
This section provides detailed API documentation for Fontisan's core classes, converters, validators, and models.
|
|
8
|
+
|
|
9
|
+
## Core Classes
|
|
10
|
+
|
|
11
|
+
- [FontLoader](/api/font-loader) — Unified font loading with automatic format detection
|
|
12
|
+
- [FontWriter](/api/font-writer) — Write fonts to various formats
|
|
13
|
+
- [ConversionOptions](/api/conversion-options) — Type-safe conversion configuration
|
|
14
|
+
- [SfntFont](/api/sfnt-font) — Base class for TrueType/OpenType fonts
|
|
15
|
+
- [Type1Font](/api/type1-font) — Adobe Type 1 font handler
|
|
16
|
+
|
|
17
|
+
## Converters
|
|
18
|
+
|
|
19
|
+
- [OutlineConverter](/api/converters/outline-converter) — TTF ↔ OTF outline conversion
|
|
20
|
+
- [CurveConverter](/api/converters/curve-converter) — Quadratic ↔ Cubic curve conversion
|
|
21
|
+
- [HintConverter](/api/converters/hint-converter) — TrueType ↔ PostScript hint conversion
|
|
22
|
+
|
|
23
|
+
## Validators
|
|
24
|
+
|
|
25
|
+
- [FontValidator](/api/validators/font-validator) — Main validation entry point
|
|
26
|
+
- [ValidationProfile](/api/validators/profile) — Validation profile definitions
|
|
27
|
+
- [ValidationHelper](/api/validators/helper) — Individual validation helpers
|
|
28
|
+
|
|
29
|
+
## Models
|
|
30
|
+
|
|
31
|
+
- [Glyph](/api/models/glyph) — Font glyph representation
|
|
32
|
+
- [GlyphAccessor](/api/models/glyph-accessor) — Unified glyph access with caching
|
|
33
|
+
- [TableAnalyzer](/api/models/table-analyzer) — Font table analysis
|
|
34
|
+
|
|
35
|
+
## Using the API
|
|
36
|
+
|
|
37
|
+
### Loading Fonts
|
|
38
|
+
|
|
39
|
+
```ruby
|
|
40
|
+
require 'fontisan'
|
|
41
|
+
|
|
42
|
+
# Automatic format detection
|
|
43
|
+
font = Fontisan::FontLoader.load('font.ttf')
|
|
44
|
+
font = Fontisan::FontLoader.load('font.otf')
|
|
45
|
+
font = Fontisan::FontLoader.load('font.pfb')
|
|
46
|
+
|
|
47
|
+
# Load from IO
|
|
48
|
+
font = Fontisan::FontLoader.load(io)
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Converting Fonts
|
|
52
|
+
|
|
53
|
+
```ruby
|
|
54
|
+
# Get recommended options
|
|
55
|
+
options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
|
|
56
|
+
|
|
57
|
+
# Convert with options
|
|
58
|
+
converter = Fontisan::Converters::OutlineConverter.new
|
|
59
|
+
tables = converter.convert(font, options: options)
|
|
60
|
+
|
|
61
|
+
# Write the result
|
|
62
|
+
Fontisan::FontWriter.write(font, 'output.otf')
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Validating Fonts
|
|
66
|
+
|
|
67
|
+
```ruby
|
|
68
|
+
# Validate with a profile
|
|
69
|
+
result = Fontisan::FontValidator.validate('font.ttf', profile: :google_fonts)
|
|
70
|
+
|
|
71
|
+
# Check results
|
|
72
|
+
if result.passed?
|
|
73
|
+
puts "Font is valid!"
|
|
74
|
+
else
|
|
75
|
+
result.errors.each do |error|
|
|
76
|
+
puts "#{error.code}: #{error.message}"
|
|
77
|
+
end
|
|
78
|
+
end
|
|
79
|
+
```
|
data/docs/api/layer.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Ufo::Layer
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# `Ufo::Layer`
|
|
6
|
+
|
|
7
|
+
A single layer in a UFO source. A `Layer` holds a set of glyphs keyed by name. The default layer is `public.default` per UFO 3.
|
|
8
|
+
|
|
9
|
+
```ruby
|
|
10
|
+
layer = Fontisan::Ufo::Layer.new # => "public.default"
|
|
11
|
+
layer.add(Fontisan::Ufo::Glyph.new(name: "A"))
|
|
12
|
+
layer["A"] # => the glyph
|
|
13
|
+
layer.size # => 1
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Naming contract
|
|
17
|
+
|
|
18
|
+
Glyph names are the layer's primary key. Two distinct glyphs with the same name cannot coexist — adding the second would silently destroy the first, a class of bug that has historically cost real data (e.g. the CJK Ext G cmap loss when CBDT placeholders collided with outline glyphs sharing `"gid{N}"` names).
|
|
19
|
+
|
|
20
|
+
To make that contract unbreakable, the API exposes two methods with named semantics:
|
|
21
|
+
|
|
22
|
+
| Method | Behavior on conflict |
|
|
23
|
+
|--------|----------------------|
|
|
24
|
+
| `Layer#add(glyph)` | **Raises** `Ufo::GlyphExistsError` (the safe default) |
|
|
25
|
+
| `Layer#put(glyph)` | Overwrites the existing glyph (explicit replace) |
|
|
26
|
+
|
|
27
|
+
Callers that need auto-renaming — insert without giving up on a collision — call `Stitcher::UniqueGlyphName.in(target, base)` first to allocate a free name, then `Layer#add` the glyph under that name.
|
|
28
|
+
|
|
29
|
+
## API
|
|
30
|
+
|
|
31
|
+
### `Layer.new(name = "public.default")`
|
|
32
|
+
|
|
33
|
+
Initialize an empty layer.
|
|
34
|
+
|
|
35
|
+
### `#add(glyph) -> Glyph`
|
|
36
|
+
|
|
37
|
+
Insert `glyph`. Raises `Ufo::GlyphExistsError` if a glyph with the same name is already present.
|
|
38
|
+
|
|
39
|
+
```ruby
|
|
40
|
+
layer = Fontisan::Ufo::Layer.new
|
|
41
|
+
layer.add(Fontisan::Ufo::Glyph.new(name: "A"))
|
|
42
|
+
|
|
43
|
+
layer.add(Fontisan::Ufo::Glyph.new(name: "A"))
|
|
44
|
+
# => raises Fontisan::Ufo::GlyphExistsError: a glyph named "A" already exists
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
The original glyph is preserved when the second `add` raises — the layer is never partially mutated.
|
|
48
|
+
|
|
49
|
+
### `#put(glyph) -> Glyph`
|
|
50
|
+
|
|
51
|
+
Insert `glyph`, replacing any existing glyph with the same name. Use this when the caller has positively decided the previous glyph (if any) should be discarded.
|
|
52
|
+
|
|
53
|
+
```ruby
|
|
54
|
+
layer.put(Fontisan::Ufo::Glyph.new(name: "A")) # overwrites the prior "A"
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### `#[](glyph_name) -> Glyph, nil`
|
|
58
|
+
|
|
59
|
+
Look up a glyph by name.
|
|
60
|
+
|
|
61
|
+
### `#each { |glyph| ... }`
|
|
62
|
+
|
|
63
|
+
Iterate over glyphs (no ordering guarantee).
|
|
64
|
+
|
|
65
|
+
### `#size -> Integer`
|
|
66
|
+
|
|
67
|
+
Number of glyphs in the layer.
|
|
68
|
+
|
|
69
|
+
## `Ufo::GlyphExistsError`
|
|
70
|
+
|
|
71
|
+
Raised by `Layer#add` on a name conflict. Carries the colliding name so callers can branch programmatically:
|
|
72
|
+
|
|
73
|
+
```ruby
|
|
74
|
+
begin
|
|
75
|
+
layer.add(glyph)
|
|
76
|
+
rescue Fontisan::Ufo::GlyphExistsError => e
|
|
77
|
+
puts "name #{e.name.inspect} already taken"
|
|
78
|
+
# Decide: layer.put(glyph) to overwrite, or
|
|
79
|
+
# unique = Fontisan::Stitcher::UniqueGlyphName.in(target, e.name)
|
|
80
|
+
# layer.add(glyph.dup_as(name: unique))
|
|
81
|
+
end
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
The error class is a sibling of `Layer` (not nested inside it) so the namespace stays flat — both `Ufo::Layer` and `Ufo::GlyphExistsError` live directly under `Fontisan::Ufo`.
|
|
85
|
+
|
|
86
|
+
## See also
|
|
87
|
+
|
|
88
|
+
- `docs/STITCHER_GUIDE.adoc` — `UniqueGlyphName`, `GlyphCopier`, and `CbdtPropagator` all build on the Layer naming contract.
|
|
89
|
+
- `docs/UFO_COMPILATION.adoc` — how layers feed the TTF/OTF/CFF2 compilers.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: GlyphAccessor
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# GlyphAccessor
|
|
6
|
+
|
|
7
|
+
Unified glyph access with caching.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::GlyphAccessor` provides efficient glyph access.
|
|
12
|
+
|
|
13
|
+
## Methods
|
|
14
|
+
|
|
15
|
+
### at(id) / get(id)
|
|
16
|
+
|
|
17
|
+
Access glyph by ID.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
glyph = font.glyphs[42]
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### each
|
|
24
|
+
|
|
25
|
+
Iterate over all glyphs.
|
|
26
|
+
|
|
27
|
+
```ruby
|
|
28
|
+
font.glyphs.each do |glyph|
|
|
29
|
+
puts glyph.name
|
|
30
|
+
end
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### count
|
|
34
|
+
|
|
35
|
+
Get glyph count.
|
|
36
|
+
|
|
37
|
+
```ruby
|
|
38
|
+
count = font.glyphs.count
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## See Also
|
|
42
|
+
|
|
43
|
+
- [Glyph](/api/models/glyph)
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Glyph
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Glyph
|
|
6
|
+
|
|
7
|
+
Font glyph representation.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::Glyph` represents a single glyph.
|
|
12
|
+
|
|
13
|
+
## Properties
|
|
14
|
+
|
|
15
|
+
| Property | Type | Description |
|
|
16
|
+
|----------|------|-------------|
|
|
17
|
+
| `id` | Integer | Glyph ID |
|
|
18
|
+
| `name` | String | Glyph name |
|
|
19
|
+
| `unicode` | Integer | Unicode codepoint |
|
|
20
|
+
| `bounds` | Hash | Bounding box |
|
|
21
|
+
| `contours` | Array | Outline contours |
|
|
22
|
+
|
|
23
|
+
## Methods
|
|
24
|
+
|
|
25
|
+
### outline
|
|
26
|
+
|
|
27
|
+
Get glyph outline.
|
|
28
|
+
|
|
29
|
+
```ruby
|
|
30
|
+
outline = glyph.outline
|
|
31
|
+
outline.contours.each do |contour|
|
|
32
|
+
contour.points.each do |point|
|
|
33
|
+
puts "(#{point.x}, #{point.y})"
|
|
34
|
+
end
|
|
35
|
+
end
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## See Also
|
|
39
|
+
|
|
40
|
+
- [GlyphAccessor](/api/models/glyph-accessor)
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: TableAnalyzer
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# TableAnalyzer
|
|
6
|
+
|
|
7
|
+
Font table analysis.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::TableAnalyzer` analyzes font tables.
|
|
12
|
+
|
|
13
|
+
## Methods
|
|
14
|
+
|
|
15
|
+
### analyze(fonts, parallel: false)
|
|
16
|
+
|
|
17
|
+
Analyze fonts for table sharing.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
analyzer = Fontisan::TableAnalyzer.new(fonts, parallel: true)
|
|
21
|
+
stats = analyzer.analyze
|
|
22
|
+
puts "Shared tables: #{stats.shared_count}"
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### checksum(table)
|
|
26
|
+
|
|
27
|
+
Calculate table checksum.
|
|
28
|
+
|
|
29
|
+
```ruby
|
|
30
|
+
checksum = analyzer.checksum(font.tables['head'])
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## See Also
|
|
34
|
+
|
|
35
|
+
- [Collections Guide](/guide/formats/collections)
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: SfntFont
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# SfntFont
|
|
6
|
+
|
|
7
|
+
Base class for TrueType and OpenType fonts.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::SfntFont` is the base class for sfnt-based fonts (TTF, OTF, WOFF, WOFF2).
|
|
12
|
+
|
|
13
|
+
## Properties
|
|
14
|
+
|
|
15
|
+
| Property | Type | Description |
|
|
16
|
+
|----------|------|-------------|
|
|
17
|
+
| `tables` | Hash | Font tables by tag |
|
|
18
|
+
| `glyphs` | GlyphAccessor | Glyph access object |
|
|
19
|
+
| `family_name` | String | Font family name |
|
|
20
|
+
| `style` | String | Font style |
|
|
21
|
+
| `version` | String | Font version |
|
|
22
|
+
|
|
23
|
+
## Methods
|
|
24
|
+
|
|
25
|
+
### table(tag)
|
|
26
|
+
|
|
27
|
+
Access a specific table.
|
|
28
|
+
|
|
29
|
+
```ruby
|
|
30
|
+
head = font.table('head')
|
|
31
|
+
name = font.table('name')
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### glyph_name(id)
|
|
35
|
+
|
|
36
|
+
Get glyph name by ID.
|
|
37
|
+
|
|
38
|
+
```ruby
|
|
39
|
+
name = font.glyph_name(42)
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### glyph_count
|
|
43
|
+
|
|
44
|
+
Get total glyph count.
|
|
45
|
+
|
|
46
|
+
```ruby
|
|
47
|
+
count = font.glyph_count
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## See Also
|
|
51
|
+
|
|
52
|
+
- [FontLoader](/api/font-loader)
|
|
53
|
+
- [Type1Font](/api/type1-font)
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Type1Font
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Type1Font
|
|
6
|
+
|
|
7
|
+
Adobe Type 1 font handler.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::Type1Font` handles Adobe Type 1 fonts (PFB/PFA).
|
|
12
|
+
|
|
13
|
+
## Properties
|
|
14
|
+
|
|
15
|
+
| Property | Type | Description |
|
|
16
|
+
|----------|------|-------------|
|
|
17
|
+
| `font_name` | String | Font name |
|
|
18
|
+
| `family_name` | String | Family name |
|
|
19
|
+
| `charstrings` | Hash | Glyph outlines |
|
|
20
|
+
| `private_dict` | Hash | Private dictionary |
|
|
21
|
+
|
|
22
|
+
## Methods
|
|
23
|
+
|
|
24
|
+
### glyph_count
|
|
25
|
+
|
|
26
|
+
Get total glyph count.
|
|
27
|
+
|
|
28
|
+
```ruby
|
|
29
|
+
count = font.glyph_count
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### charstring(glyph_name)
|
|
33
|
+
|
|
34
|
+
Get CharString for a glyph.
|
|
35
|
+
|
|
36
|
+
```ruby
|
|
37
|
+
cs = font.charstring('A')
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## See Also
|
|
41
|
+
|
|
42
|
+
- [FontLoader](/api/font-loader)
|
|
43
|
+
- [SfntFont](/api/sfnt-font)
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: FontValidator
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# FontValidator
|
|
6
|
+
|
|
7
|
+
Main validation entry point.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::Validators::FontValidator` validates fonts against profiles.
|
|
12
|
+
|
|
13
|
+
## Class Methods
|
|
14
|
+
|
|
15
|
+
### validate(path, profile: :production)
|
|
16
|
+
|
|
17
|
+
Validate a font file.
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
result = Fontisan::Validators::FontValidator.validate('font.ttf', profile: :web)
|
|
21
|
+
if result.valid?
|
|
22
|
+
puts "Font is valid"
|
|
23
|
+
else
|
|
24
|
+
puts "Errors: #{result.errors.length}"
|
|
25
|
+
end
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## See Also
|
|
29
|
+
|
|
30
|
+
- [Validation Guide](/guide/validation/)
|
|
31
|
+
- [ValidationProfile](/api/validators/profile)
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: ValidationHelper
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# ValidationHelper
|
|
6
|
+
|
|
7
|
+
Individual validation helpers.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
Validation helpers perform specific checks.
|
|
12
|
+
|
|
13
|
+
## Categories
|
|
14
|
+
|
|
15
|
+
| Category | Helpers | Focus |
|
|
16
|
+
|----------|---------|-------|
|
|
17
|
+
| Table | 12 | Table structure |
|
|
18
|
+
| Name | 8 | Name records |
|
|
19
|
+
| Head | 6 | Header validation |
|
|
20
|
+
| Metrics | 10 | Font metrics |
|
|
21
|
+
| Glyph | 8 | Glyph data |
|
|
22
|
+
| CMAP | 6 | Character mapping |
|
|
23
|
+
| Layout | 6 | GSUB/GPOS |
|
|
24
|
+
|
|
25
|
+
## Using Helpers
|
|
26
|
+
|
|
27
|
+
```ruby
|
|
28
|
+
validator = Fontisan::Validators::FontValidator.new(font)
|
|
29
|
+
result = validator.check_required_tables
|
|
30
|
+
puts result.valid?
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## See Also
|
|
34
|
+
|
|
35
|
+
- [FontValidator](/api/validators/font-validator)
|
|
36
|
+
- [Validation Helpers Guide](/guide/validation/helpers)
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: ValidationProfile
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# ValidationProfile
|
|
6
|
+
|
|
7
|
+
Validation profile definitions.
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`Fontisan::Validators::ValidationProfile` defines validation profiles.
|
|
12
|
+
|
|
13
|
+
## Built-in Profiles
|
|
14
|
+
|
|
15
|
+
| Profile | Checks | Use Case |
|
|
16
|
+
|---------|--------|----------|
|
|
17
|
+
| `indexability` | 8 | Font discovery |
|
|
18
|
+
| `usability` | 26 | Installation |
|
|
19
|
+
| `production` | 37 | Quality assurance |
|
|
20
|
+
| `web` | 18 | Web deployment |
|
|
21
|
+
| `spec_compliance` | Full | Spec audit |
|
|
22
|
+
|
|
23
|
+
## Methods
|
|
24
|
+
|
|
25
|
+
### checks
|
|
26
|
+
|
|
27
|
+
Get list of checks in profile.
|
|
28
|
+
|
|
29
|
+
```ruby
|
|
30
|
+
profile = Fontisan::Validators::ValidationProfile[:production]
|
|
31
|
+
profile.checks.each do |check|
|
|
32
|
+
puts check.id
|
|
33
|
+
end
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## See Also
|
|
37
|
+
|
|
38
|
+
- [FontValidator](/api/validators/font-validator)
|
|
39
|
+
- [Validation Helpers](/guide/validation/helpers)
|
data/docs/cli/convert.md
ADDED
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: convert
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# convert
|
|
6
|
+
|
|
7
|
+
Convert individual fonts between different formats.
|
|
8
|
+
|
|
9
|
+
::: tip For Collection Formats
|
|
10
|
+
Use [pack/unpack](/cli/pack) to work with TTC, OTC, and dfont collections. The convert command is for individual font files only.
|
|
11
|
+
:::
|
|
12
|
+
|
|
13
|
+
## Quick Reference
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
fontisan convert <input> --to <format> [options]
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Supported Formats
|
|
20
|
+
|
|
21
|
+
These are individual font formats that can be converted:
|
|
22
|
+
|
|
23
|
+
| Format | Read | Write | Description |
|
|
24
|
+
|--------|:----:|:-----:|-------------|
|
|
25
|
+
| TTF | ✅ | ✅ | TrueType (glyf outlines) |
|
|
26
|
+
| OTF | ✅ | ✅ | OpenType (CFF outlines) |
|
|
27
|
+
| WOFF | ✅ | ✅ | Web Open Font Format |
|
|
28
|
+
| WOFF2 | ✅ | ✅ | Web Open Font Format 2 |
|
|
29
|
+
| PFB/PFA | ✅ | — | Adobe Type 1 (read for conversion) |
|
|
30
|
+
|
|
31
|
+
## Options
|
|
32
|
+
|
|
33
|
+
| Option | Description |
|
|
34
|
+
|--------|-------------|
|
|
35
|
+
| `--to FORMAT[,FORMAT...]` | Target format(s): `ttf`, `otf`, `woff`, `woff2`, `type1`/`t1`, `ttc`, `otc`, `dfont`, `svg`. Pass once with comma-separated values (`--to woff,woff2`) or multiple times (`--to woff --to woff2`) for multi-format output. |
|
|
36
|
+
| `--output FILE` | Output file path (see "Output path rules" below) |
|
|
37
|
+
| `--optimize` | Enable outline optimization |
|
|
38
|
+
| `--flatten` | Flatten composite glyphs |
|
|
39
|
+
| `--zlib-level=N` | WOFF only: zlib compression level (0–9, default 6) |
|
|
40
|
+
| `--uncompressed` | WOFF only: store tables uncompressed (legal per WOFF 1.0 §5.1) |
|
|
41
|
+
| `--compression-threshold=N` | WOFF only: skip compression for tables smaller than N bytes (default 100) |
|
|
42
|
+
| `--brotli-quality=N` | WOFF2 only: Brotli quality (0–11, default 11) |
|
|
43
|
+
| `--transform-tables` / `--no-transform-tables` | WOFF2 only: apply glyf/loca + hmtx transformations |
|
|
44
|
+
|
|
45
|
+
The format you pick (`--to woff` vs `--to woff2`) **is** the algorithm
|
|
46
|
+
choice — WOFF mandates zlib, WOFF2 mandates Brotli. Passing a WOFF knob
|
|
47
|
+
to a WOFF2 target (or vice versa) exits 1 with a clear error.
|
|
48
|
+
|
|
49
|
+
## Multi-format output
|
|
50
|
+
|
|
51
|
+
`--to` accepts multiple targets so a single invocation produces N
|
|
52
|
+
output files from one input font. Both spellings work and produce
|
|
53
|
+
identical results:
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
# Comma-separated (one --to flag)
|
|
57
|
+
fontisan convert font.ttf --to woff,woff2 --output font
|
|
58
|
+
|
|
59
|
+
# Repeated flag (Thor array form)
|
|
60
|
+
fontisan convert font.ttf --to woff --to woff2 --output font
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Duplicates are deduplicated, so `--to woff,woff2,woff` is equivalent to
|
|
64
|
+
`--to woff,woff2`.
|
|
65
|
+
|
|
66
|
+
### Output path rules
|
|
67
|
+
|
|
68
|
+
| `--output` shape | `--to` shape | Behaviour |
|
|
69
|
+
|------------------|--------------|-----------|
|
|
70
|
+
| `out.ttf` (has extension) | one format | Use as given |
|
|
71
|
+
| `out` (no extension) | one format | Append `.<format>` → `out.ttf` |
|
|
72
|
+
| `out` (no extension) | many formats | Append `.<format>` per target → `out.woff`, `out.woff2` |
|
|
73
|
+
| `out.ttf` (has extension) | many formats | **Error**: ambiguous which format gets the extension |
|
|
74
|
+
|
|
75
|
+
Multi-format is single-font → single-font only. Combining multi-format
|
|
76
|
+
with collection input (TTC/OTC/dfont) exits 1 — collections pack
|
|
77
|
+
multiple faces and N formats × M faces explodes output count. Convert
|
|
78
|
+
collections to one target format at a time.
|
|
79
|
+
|
|
80
|
+
## Common Workflows
|
|
81
|
+
|
|
82
|
+
### Convert for Web
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
# TTF to WOFF2 (recommended for modern browsers)
|
|
86
|
+
fontisan convert font.ttf --to woff2 --output font.woff2
|
|
87
|
+
|
|
88
|
+
# OTF to WOFF (broader compatibility — works on IE 9+)
|
|
89
|
+
fontisan convert font.otf --to woff --output font.woff
|
|
90
|
+
|
|
91
|
+
# Smallest possible WOFF2 (max Brotli + table transforms)
|
|
92
|
+
fontisan convert font.ttf --to woff2 --output font.woff2 \
|
|
93
|
+
--brotli-quality 11 --transform-tables
|
|
94
|
+
|
|
95
|
+
# WOFF with max zlib compression
|
|
96
|
+
fontisan convert font.ttf --to woff --output font.woff --zlib-level 9
|
|
97
|
+
|
|
98
|
+
# WOFF stored uncompressed (legal per WOFF 1.0 §5.1; useful for tooling)
|
|
99
|
+
fontisan convert font.ttf --to woff --output font.woff --uncompressed
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### Convert Between Outline Formats
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
# TrueType to OpenType (glyf → CFF)
|
|
106
|
+
fontisan convert font.ttf --to otf --output font.otf
|
|
107
|
+
|
|
108
|
+
# OpenType to TrueType (CFF → glyf)
|
|
109
|
+
fontisan convert font.otf --to ttf --output font.ttf
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Convert Legacy Type 1 Fonts
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
# Type 1 to OpenType
|
|
116
|
+
fontisan convert font.pfb --to otf --output font.otf
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
### Emit Multiple Web Formats in One Invocation
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
# Both WOFF (legacy IE9+) and WOFF2 (modern browsers) from one input
|
|
123
|
+
fontisan convert font.ttf --to woff,woff2 --output font
|
|
124
|
+
# → font.woff, font.woff2
|
|
125
|
+
|
|
126
|
+
# Same result with the repeated-flag form
|
|
127
|
+
fontisan convert font.ttf --to woff --to woff2 --output font
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
## Working with Collections
|
|
131
|
+
|
|
132
|
+
Collection formats (TTC, OTC, dfont) contain multiple fonts. To convert fonts from a collection:
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
# Step 1: Extract fonts from collection
|
|
136
|
+
fontisan unpack family.ttc --output-dir ./extracted
|
|
137
|
+
|
|
138
|
+
# Step 2: Convert each font
|
|
139
|
+
fontisan convert ./extracted/Font-Regular.ttf --to woff2 --output Font-Regular.woff2
|
|
140
|
+
fontisan convert ./extracted/Font-Bold.ttf --to woff2 --output Font-Bold.woff2
|
|
141
|
+
|
|
142
|
+
# Or extract and convert in one step:
|
|
143
|
+
fontisan unpack family.ttc --output-dir ./web --format woff2
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
## Detailed Documentation
|
|
147
|
+
|
|
148
|
+
For comprehensive documentation including curve conversion, hint handling, and advanced options, see the [convert command guide](/guide/cli/convert).
|