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.
Files changed (792) hide show
  1. checksums.yaml +7 -0
  2. data/.rspec +3 -0
  3. data/.rubocop.yml +141 -0
  4. data/.rubocop_todo.yml +433 -0
  5. data/BENCHMARKS.md +56 -0
  6. data/BUG-stitcher-drops-isolated-cps.md +58 -0
  7. data/BUG-stitcher-drops-plane1-codepoints.md +310 -0
  8. data/BUG-stitcher-gid-cap-65535.md +110 -0
  9. data/CHANGELOG.md +293 -0
  10. data/Gemfile +40 -0
  11. data/LICENSE +28 -0
  12. data/README.adoc +2811 -0
  13. data/Rakefile +156 -0
  14. data/TODO.bug-fixes/01-cff-expert-charsets.md +27 -0
  15. data/TODO.bug-fixes/02-cff2-subroutine-stubs.md +32 -0
  16. data/TODO.bug-fixes/03-variation-subsetter-placeholders.md +42 -0
  17. data/TODO.bug-fixes/04-ufo-image-compile-roundtrip.md +28 -0
  18. data/TODO.bug-fixes/05-stale-cff-comment.md +18 -0
  19. data/TODO.bug-fixes/06-instance-woff2-output.md +24 -0
  20. data/TODO.bug-fixes/07-encapsulation-violations.md +38 -0
  21. data/TODO.bug-fixes/08-respond-to-violations.md +25 -0
  22. data/TODO.bug-fixes/09-type1-cff-seac-expansion.md +22 -0
  23. data/TODO.bug-fixes/10-ttf-type1-composite-glyphs.md +23 -0
  24. data/TODO.bug-fixes/11-remaining-respond-to.md +25 -0
  25. data/TODO.bug-fixes/12-type1-generators-duck-typing.md +80 -0
  26. data/TODO.bug-fixes/13-hint-extractor-duck-typing.md +30 -0
  27. data/TODO.bug-fixes/14-font-interface-type-checks.md +82 -0
  28. data/TODO.bug-fixes/15-glyph-type-checks-and-simple-glyph-points-bug.md +49 -0
  29. data/TODO.bug-fixes/16-variation-table-checks.md +31 -0
  30. data/TODO.bug-fixes/17-ufo-and-stitcher-cleanup.md +32 -0
  31. data/TODO.bug-fixes/18-generic-value-and-io-checks.md +56 -0
  32. data/TODO.bug-fixes/19-serialization-migration.md +52 -0
  33. data/TODO.bug-fixes/20-variation-validator-type-checks.md +29 -0
  34. data/TODO.bug-fixes/21-xml-builder-send.md +24 -0
  35. data/TODO.bug-fixes/22-type1-converter-font-info.md +25 -0
  36. data/TODO.bug-fixes/23-boundary-type-checks.md +31 -0
  37. data/TODO.bug-fixes/24-validator-dynamic-field-key.md +25 -0
  38. data/TODO.bug-fixes/25-serialization-migration.md +49 -0
  39. data/TODO.bug-fixes/26-variation-preserver-spec-migration.md +25 -0
  40. data/TODO.bug-fixes/27-table-class-registry.md +50 -0
  41. data/TODO.bug-fixes/28-spec-doubles-cleanup.md +40 -0
  42. data/TODO.bug-fixes/29-strategy-registries.md +30 -0
  43. data/TODO.bug-fixes/30-eliminate-send-in-specs.md +36 -0
  44. data/TODO.bug-fixes/README.md +52 -0
  45. data/TODO.improvements/01-cbdt-cblc-gid-stable-propagation.md +73 -0
  46. data/TODO.improvements/02-collection-outline-priority.md +48 -0
  47. data/TODO.improvements/03-fontisan-audit-command.md +219 -0
  48. data/TODO.improvements/04-ufo-composite-glyph-encoding.md +46 -0
  49. data/TODO.improvements/05-otf-compiler-real-cff.md +63 -0
  50. data/TODO.improvements/06-cff2-blend-vsindex-operators.md +51 -0
  51. data/TODO.improvements/07-cpal-v1-header-fields.md +71 -0
  52. data/TODO.improvements/08-cff-standard-string-table.md +52 -0
  53. data/TODO.improvements/09-type1-seac-expansion.md +57 -0
  54. data/TODO.improvements/10-ufo-image-set-feature-writers.md +71 -0
  55. data/TODO.improvements/11-kern-groups-plist.md +49 -0
  56. data/TODO.improvements/12-cbdt-fixture-bindata-conversion.md +68 -0
  57. data/TODO.improvements/13-split-octokit-fetcher.md +45 -0
  58. data/TODO.improvements/14-rubocop-baseline-chip.md +62 -0
  59. data/TODO.improvements/15-cff-cff2-subsetter-strategy.md +78 -0
  60. data/TODO.improvements/README.md +58 -0
  61. data/benchmark/baseline.json +5 -0
  62. data/benchmark/ci_gate.rb +217 -0
  63. data/benchmark/compile_benchmark.rb +78 -0
  64. data/benchmark/corpus/harness.rb +175 -0
  65. data/benchmark/corpus/ops.rb +150 -0
  66. data/benchmark/corpus/run.rb +182 -0
  67. data/benchmark/corpus/scan_child.rb +8 -0
  68. data/benchmark/corpus/tiers.rb +176 -0
  69. data/benchmark/tier_baseline.json +12 -0
  70. data/benchmark/variation_quick_bench.rb +47 -0
  71. data/build_mingw32_stub.rb +15 -0
  72. data/docs/.gitignore +17 -0
  73. data/docs/.vitepress/config.ts +373 -0
  74. data/docs/.vitepress/theme/components/ApiMethod.vue +127 -0
  75. data/docs/.vitepress/theme/components/Badge.vue +51 -0
  76. data/docs/.vitepress/theme/components/FeatureComparison.vue +87 -0
  77. data/docs/.vitepress/theme/components/HeroCodeBlock.vue +98 -0
  78. data/docs/.vitepress/theme/components/WithinHero.vue +30 -0
  79. data/docs/.vitepress/theme/index.ts +22 -0
  80. data/docs/.vitepress/theme/style.css +628 -0
  81. data/docs/AFDKO_MIGRATION.adoc +175 -0
  82. data/docs/APPLE_LEGACY_FONTS.adoc +173 -0
  83. data/docs/CFF2_SUPPORT.adoc +184 -0
  84. data/docs/COLLECTION_VALIDATION.adoc +204 -0
  85. data/docs/COLOR_FONTS.adoc +127 -0
  86. data/docs/CONVERSION_GUIDE.adoc +656 -0
  87. data/docs/EXTRACT_TTC_MIGRATION.md +549 -0
  88. data/docs/FEATURE_PARITY.adoc +263 -0
  89. data/docs/FONT_HINTING.adoc +570 -0
  90. data/docs/STITCHER_GUIDE.adoc +436 -0
  91. data/docs/SVG_TO_GLYF.adoc +118 -0
  92. data/docs/TTX.adoc +176 -0
  93. data/docs/TYPE1_FONTS.adoc +445 -0
  94. data/docs/UFO_COMPILATION.adoc +397 -0
  95. data/docs/VALIDATION.adoc +254 -0
  96. data/docs/VARIABLE_FONT_OPERATIONS.adoc +599 -0
  97. data/docs/WOFF_WOFF2_FORMATS.adoc +220 -0
  98. data/docs/api/conversion-options.md +164 -0
  99. data/docs/api/converters/curve-converter.md +34 -0
  100. data/docs/api/converters/hint-converter.md +34 -0
  101. data/docs/api/converters/outline-converter.md +27 -0
  102. data/docs/api/font-loader.md +117 -0
  103. data/docs/api/font-writer.md +103 -0
  104. data/docs/api/index.md +79 -0
  105. data/docs/api/layer.md +89 -0
  106. data/docs/api/models/glyph-accessor.md +43 -0
  107. data/docs/api/models/glyph.md +40 -0
  108. data/docs/api/models/table-analyzer.md +35 -0
  109. data/docs/api/sfnt-font.md +53 -0
  110. data/docs/api/type1-font.md +43 -0
  111. data/docs/api/validators/font-validator.md +31 -0
  112. data/docs/api/validators/helper.md +36 -0
  113. data/docs/api/validators/profile.md +39 -0
  114. data/docs/cli/convert.md +148 -0
  115. data/docs/cli/dump-table.md +110 -0
  116. data/docs/cli/export.md +176 -0
  117. data/docs/cli/features.md +124 -0
  118. data/docs/cli/glyphs.md +90 -0
  119. data/docs/cli/index.md +232 -0
  120. data/docs/cli/info.md +254 -0
  121. data/docs/cli/instance.md +122 -0
  122. data/docs/cli/ls.md +95 -0
  123. data/docs/cli/optical-size.md +94 -0
  124. data/docs/cli/pack.md +125 -0
  125. data/docs/cli/scripts.md +105 -0
  126. data/docs/cli/subset.md +58 -0
  127. data/docs/cli/tables.md +84 -0
  128. data/docs/cli/unicode.md +101 -0
  129. data/docs/cli/validate-collection.md +95 -0
  130. data/docs/cli/validate.md +56 -0
  131. data/docs/cli/variable.md +126 -0
  132. data/docs/cli/version.md +46 -0
  133. data/docs/guide/cli/convert.md +108 -0
  134. data/docs/guide/cli/export.md +138 -0
  135. data/docs/guide/cli/index.md +99 -0
  136. data/docs/guide/cli/info.md +144 -0
  137. data/docs/guide/cli/pack.md +155 -0
  138. data/docs/guide/cli/subset.md +149 -0
  139. data/docs/guide/cli/validate.md +139 -0
  140. data/docs/guide/color-fonts/bitmaps.md +194 -0
  141. data/docs/guide/color-fonts/colr-cpal.md +175 -0
  142. data/docs/guide/color-fonts/index.md +140 -0
  143. data/docs/guide/color-fonts/svg.md +154 -0
  144. data/docs/guide/color.md +51 -0
  145. data/docs/guide/comparisons/font-validator.md +222 -0
  146. data/docs/guide/comparisons/fonttools.md +200 -0
  147. data/docs/guide/comparisons/index.md +83 -0
  148. data/docs/guide/comparisons/lcdf-typetools.md +205 -0
  149. data/docs/guide/contributing.md +279 -0
  150. data/docs/guide/conversion/collections.md +251 -0
  151. data/docs/guide/conversion/curves.md +246 -0
  152. data/docs/guide/conversion/index.md +157 -0
  153. data/docs/guide/conversion/options.md +280 -0
  154. data/docs/guide/conversion/ttf-otf.md +184 -0
  155. data/docs/guide/conversion/type1.md +208 -0
  156. data/docs/guide/conversion/web.md +299 -0
  157. data/docs/guide/conversion.md +40 -0
  158. data/docs/guide/engines.md +117 -0
  159. data/docs/guide/formats/collections.md +147 -0
  160. data/docs/guide/formats/dfont.md +99 -0
  161. data/docs/guide/formats/index.md +65 -0
  162. data/docs/guide/formats/otf.md +103 -0
  163. data/docs/guide/formats/svg.md +97 -0
  164. data/docs/guide/formats/ttf.md +105 -0
  165. data/docs/guide/formats/type1.md +118 -0
  166. data/docs/guide/formats/woff.md +139 -0
  167. data/docs/guide/hinting/autohint.md +141 -0
  168. data/docs/guide/hinting/conversion.md +161 -0
  169. data/docs/guide/hinting/index.md +86 -0
  170. data/docs/guide/hinting/postscript.md +149 -0
  171. data/docs/guide/hinting/truetype.md +135 -0
  172. data/docs/guide/hinting.md +44 -0
  173. data/docs/guide/index.md +152 -0
  174. data/docs/guide/installation.md +116 -0
  175. data/docs/guide/migrations/extract-ttc.md +549 -0
  176. data/docs/guide/migrations/font-validator.md +260 -0
  177. data/docs/guide/migrations/fonttools.md +208 -0
  178. data/docs/guide/migrations/index.md +64 -0
  179. data/docs/guide/migrations/otfinfo.md +197 -0
  180. data/docs/guide/quick-start.md +204 -0
  181. data/docs/guide/type1.md +58 -0
  182. data/docs/guide/universal-outline.md +151 -0
  183. data/docs/guide/validation/custom.md +195 -0
  184. data/docs/guide/validation/helpers.md +188 -0
  185. data/docs/guide/validation/index.md +132 -0
  186. data/docs/guide/validation/profiles.md +156 -0
  187. data/docs/guide/validation.md +47 -0
  188. data/docs/guide/variable-fonts/advanced.md +231 -0
  189. data/docs/guide/variable-fonts/axes.md +209 -0
  190. data/docs/guide/variable-fonts/conversion.md +197 -0
  191. data/docs/guide/variable-fonts/index.md +84 -0
  192. data/docs/guide/variable-fonts/instances.md +187 -0
  193. data/docs/guide/variable-fonts/named-instances.md +194 -0
  194. data/docs/guide/variable-fonts/static.md +168 -0
  195. data/docs/guide/variable.md +58 -0
  196. data/docs/guide/woff.md +61 -0
  197. data/docs/index.md +136 -0
  198. data/docs/lychee.toml +41 -0
  199. data/docs/package-lock.json +2560 -0
  200. data/docs/package.json +15 -0
  201. data/docs/public/apple-touch-icon.png +0 -0
  202. data/docs/public/favicon-96x96.png +0 -0
  203. data/docs/public/favicon.ico +0 -0
  204. data/docs/public/favicon.svg +1 -0
  205. data/docs/public/logo-full.svg +1 -0
  206. data/docs/public/logo.svg +1 -0
  207. data/docs/public/robots.txt +4 -0
  208. data/docs/public/site.webmanifest +21 -0
  209. data/docs/public/web-app-manifest-192x192.png +0 -0
  210. data/docs/public/web-app-manifest-512x512.png +0 -0
  211. data/docs/reference-facade.md +130 -0
  212. data/docs/scripts/post-build.mjs +81 -0
  213. data/exe/fontisan +7 -0
  214. data/lib/fontisan/audit/check.rb +47 -0
  215. data/lib/fontisan/audit/check_registry.rb +77 -0
  216. data/lib/fontisan/audit/checks/cff_table_check.rb +87 -0
  217. data/lib/fontisan/audit/checks/cmap_check.rb +256 -0
  218. data/lib/fontisan/audit/checks/collection_integrity_check.rb +102 -0
  219. data/lib/fontisan/audit/checks/format_round_trip_check.rb +150 -0
  220. data/lib/fontisan/audit/checks/glyf_table_check.rb +115 -0
  221. data/lib/fontisan/audit/checks/glyph_name_check.rb +107 -0
  222. data/lib/fontisan/audit/checks/head_check.rb +96 -0
  223. data/lib/fontisan/audit/checks/hhea_check.rb +68 -0
  224. data/lib/fontisan/audit/checks/hinting_check.rb +163 -0
  225. data/lib/fontisan/audit/checks/kern_check.rb +47 -0
  226. data/lib/fontisan/audit/checks/layout_table_check.rb +70 -0
  227. data/lib/fontisan/audit/checks/maxp_check.rb +85 -0
  228. data/lib/fontisan/audit/checks/name_table_check.rb +78 -0
  229. data/lib/fontisan/audit/checks/naming_consistency_check.rb +102 -0
  230. data/lib/fontisan/audit/checks/opentype_conformance_check.rb +108 -0
  231. data/lib/fontisan/audit/checks/os2_check.rb +117 -0
  232. data/lib/fontisan/audit/checks/ots_compatibility_check.rb +191 -0
  233. data/lib/fontisan/audit/checks/post_check.rb +75 -0
  234. data/lib/fontisan/audit/checks/table_directory_check.rb +157 -0
  235. data/lib/fontisan/audit/checks/variable_font_check.rb +151 -0
  236. data/lib/fontisan/audit/checks/woff2_validation_check.rb +140 -0
  237. data/lib/fontisan/audit/checks.rb +42 -0
  238. data/lib/fontisan/audit.rb +20 -0
  239. data/lib/fontisan/base_collection.rb +312 -0
  240. data/lib/fontisan/binary/base_record.rb +82 -0
  241. data/lib/fontisan/binary/structures.rb +82 -0
  242. data/lib/fontisan/binary.rb +11 -0
  243. data/lib/fontisan/byte_ops.rb +314 -0
  244. data/lib/fontisan/cli.rb +1111 -0
  245. data/lib/fontisan/collection/builder.rb +336 -0
  246. data/lib/fontisan/collection/dfont_builder.rb +305 -0
  247. data/lib/fontisan/collection/offset_calculator.rb +229 -0
  248. data/lib/fontisan/collection/reader/stats.rb +23 -0
  249. data/lib/fontisan/collection/reader.rb +90 -0
  250. data/lib/fontisan/collection/shared_logic.rb +52 -0
  251. data/lib/fontisan/collection/table_analyzer.rb +289 -0
  252. data/lib/fontisan/collection/table_deduplicator.rb +317 -0
  253. data/lib/fontisan/collection/writer.rb +289 -0
  254. data/lib/fontisan/collection.rb +16 -0
  255. data/lib/fontisan/commands/audit_command.rb +288 -0
  256. data/lib/fontisan/commands/base_command.rb +88 -0
  257. data/lib/fontisan/commands/convert_command.rb +506 -0
  258. data/lib/fontisan/commands/dump_table_command.rb +68 -0
  259. data/lib/fontisan/commands/export_command.rb +157 -0
  260. data/lib/fontisan/commands/features_command.rb +90 -0
  261. data/lib/fontisan/commands/glyphs_command.rb +50 -0
  262. data/lib/fontisan/commands/info_command.rb +447 -0
  263. data/lib/fontisan/commands/instance_command.rb +357 -0
  264. data/lib/fontisan/commands/ls_command.rb +107 -0
  265. data/lib/fontisan/commands/multi_format_output.rb +64 -0
  266. data/lib/fontisan/commands/optical_size_command.rb +38 -0
  267. data/lib/fontisan/commands/pack_command.rb +344 -0
  268. data/lib/fontisan/commands/scripts_command.rb +56 -0
  269. data/lib/fontisan/commands/subset_command.rb +285 -0
  270. data/lib/fontisan/commands/tables_command.rb +52 -0
  271. data/lib/fontisan/commands/unicode_command.rb +73 -0
  272. data/lib/fontisan/commands/unpack_command.rb +387 -0
  273. data/lib/fontisan/commands/validate_collection_command.rb +127 -0
  274. data/lib/fontisan/commands/validate_command.rb +305 -0
  275. data/lib/fontisan/commands/variable_command.rb +87 -0
  276. data/lib/fontisan/commands.rb +30 -0
  277. data/lib/fontisan/config/collection_settings.yml +56 -0
  278. data/lib/fontisan/config/conversion_matrix.yml +626 -0
  279. data/lib/fontisan/config/export_settings.yml +66 -0
  280. data/lib/fontisan/config/features.yml +143 -0
  281. data/lib/fontisan/config/scripts.yml +42 -0
  282. data/lib/fontisan/config/subset_profiles.yml +106 -0
  283. data/lib/fontisan/config/svg_settings.yml +60 -0
  284. data/lib/fontisan/config/variable_settings.yml +99 -0
  285. data/lib/fontisan/config/woff2_settings.yml +77 -0
  286. data/lib/fontisan/constants.rb +219 -0
  287. data/lib/fontisan/conversion_options.rb +389 -0
  288. data/lib/fontisan/converters/cff_table_builder.rb +195 -0
  289. data/lib/fontisan/converters/collection_converter.rb +520 -0
  290. data/lib/fontisan/converters/conversion_strategy.rb +211 -0
  291. data/lib/fontisan/converters/format_converter.rb +536 -0
  292. data/lib/fontisan/converters/glyf_table_builder.rb +61 -0
  293. data/lib/fontisan/converters/outline_converter.rb +720 -0
  294. data/lib/fontisan/converters/outline_extraction.rb +88 -0
  295. data/lib/fontisan/converters/outline_optimizer.rb +84 -0
  296. data/lib/fontisan/converters/svg_generator.rb +236 -0
  297. data/lib/fontisan/converters/table_copier.rb +107 -0
  298. data/lib/fontisan/converters/type1_converter.rb +1201 -0
  299. data/lib/fontisan/converters/woff2_encoder.rb +520 -0
  300. data/lib/fontisan/converters/woff_writer.rb +358 -0
  301. data/lib/fontisan/converters.rb +21 -0
  302. data/lib/fontisan/dfont_collection.rb +288 -0
  303. data/lib/fontisan/engine.rb +393 -0
  304. data/lib/fontisan/error.rb +281 -0
  305. data/lib/fontisan/export/exporter.rb +255 -0
  306. data/lib/fontisan/export/table_serializer.rb +140 -0
  307. data/lib/fontisan/export/transformers/font_to_ttx.rb +163 -0
  308. data/lib/fontisan/export/transformers/head_transformer.rb +94 -0
  309. data/lib/fontisan/export/transformers/hhea_transformer.rb +57 -0
  310. data/lib/fontisan/export/transformers/maxp_transformer.rb +61 -0
  311. data/lib/fontisan/export/transformers/name_transformer.rb +61 -0
  312. data/lib/fontisan/export/transformers/os2_transformer.rb +119 -0
  313. data/lib/fontisan/export/transformers/post_transformer.rb +49 -0
  314. data/lib/fontisan/export/transformers.rb +17 -0
  315. data/lib/fontisan/export/ttx_generator.rb +526 -0
  316. data/lib/fontisan/export/ttx_parser.rb +300 -0
  317. data/lib/fontisan/export.rb +13 -0
  318. data/lib/fontisan/ffi/client.rb +123 -0
  319. data/lib/fontisan/ffi/libfontisan_cdylib.so +0 -0
  320. data/lib/fontisan/ffi.rb +387 -0
  321. data/lib/fontisan/ffi_platform.rb +24 -0
  322. data/lib/fontisan/font_loader.rb +315 -0
  323. data/lib/fontisan/font_writer.rb +309 -0
  324. data/lib/fontisan/formatters/text_formatter.rb +517 -0
  325. data/lib/fontisan/formatters.rb +9 -0
  326. data/lib/fontisan/glyph_accessor.rb +525 -0
  327. data/lib/fontisan/hints/hint_converter.rb +309 -0
  328. data/lib/fontisan/hints/hint_validator.rb +287 -0
  329. data/lib/fontisan/hints/postscript_hint_applier.rb +255 -0
  330. data/lib/fontisan/hints/postscript_hint_extractor.rb +347 -0
  331. data/lib/fontisan/hints/truetype_hint_applier.rb +117 -0
  332. data/lib/fontisan/hints/truetype_hint_extractor.rb +283 -0
  333. data/lib/fontisan/hints/truetype_instruction_analyzer.rb +268 -0
  334. data/lib/fontisan/hints/truetype_instruction_generator.rb +266 -0
  335. data/lib/fontisan/hints.rb +19 -0
  336. data/lib/fontisan/loading_modes.rb +113 -0
  337. data/lib/fontisan/metrics_calculator.rb +275 -0
  338. data/lib/fontisan/models/all_scripts_features_info.rb +20 -0
  339. data/lib/fontisan/models/audit_report.rb +196 -0
  340. data/lib/fontisan/models/bitmap_glyph.rb +123 -0
  341. data/lib/fontisan/models/bitmap_strike.rb +94 -0
  342. data/lib/fontisan/models/collection_brief_info.rb +36 -0
  343. data/lib/fontisan/models/collection_font_summary.rb +52 -0
  344. data/lib/fontisan/models/collection_info.rb +79 -0
  345. data/lib/fontisan/models/collection_list_info.rb +36 -0
  346. data/lib/fontisan/models/collection_validation_report.rb +102 -0
  347. data/lib/fontisan/models/color_glyph.rb +56 -0
  348. data/lib/fontisan/models/color_layer.rb +53 -0
  349. data/lib/fontisan/models/color_palette.rb +60 -0
  350. data/lib/fontisan/models/features_info.rb +42 -0
  351. data/lib/fontisan/models/font_export.rb +158 -0
  352. data/lib/fontisan/models/font_info.rb +98 -0
  353. data/lib/fontisan/models/font_report.rb +23 -0
  354. data/lib/fontisan/models/font_summary.rb +48 -0
  355. data/lib/fontisan/models/glyph_info.rb +26 -0
  356. data/lib/fontisan/models/glyph_outline.rb +343 -0
  357. data/lib/fontisan/models/hint.rb +404 -0
  358. data/lib/fontisan/models/optical_size_info.rb +33 -0
  359. data/lib/fontisan/models/outline.rb +667 -0
  360. data/lib/fontisan/models/scripts_info.rb +39 -0
  361. data/lib/fontisan/models/svg_glyph.rb +89 -0
  362. data/lib/fontisan/models/table_info.rb +55 -0
  363. data/lib/fontisan/models/table_sharing_info.rb +40 -0
  364. data/lib/fontisan/models/ttx/glyph_order.rb +31 -0
  365. data/lib/fontisan/models/ttx/tables/binary_table.rb +67 -0
  366. data/lib/fontisan/models/ttx/tables/head_table.rb +74 -0
  367. data/lib/fontisan/models/ttx/tables/hhea_table.rb +74 -0
  368. data/lib/fontisan/models/ttx/tables/maxp_table.rb +55 -0
  369. data/lib/fontisan/models/ttx/tables/name_table.rb +45 -0
  370. data/lib/fontisan/models/ttx/tables/os2_table.rb +157 -0
  371. data/lib/fontisan/models/ttx/tables/post_table.rb +50 -0
  372. data/lib/fontisan/models/ttx/tables.rb +21 -0
  373. data/lib/fontisan/models/ttx/ttfont.rb +41 -0
  374. data/lib/fontisan/models/ttx.rb +14 -0
  375. data/lib/fontisan/models/unicode_mappings.rb +42 -0
  376. data/lib/fontisan/models/validation_report.rb +435 -0
  377. data/lib/fontisan/models/variable_font_info.rb +82 -0
  378. data/lib/fontisan/models.rb +49 -0
  379. data/lib/fontisan/native/3.2/fontisan_native.so +0 -0
  380. data/lib/fontisan/native/3.3/fontisan_native.so +0 -0
  381. data/lib/fontisan/native/3.4/fontisan_native.so +0 -0
  382. data/lib/fontisan/native/4.0/fontisan_native.so +0 -0
  383. data/lib/fontisan/native.rb +235 -0
  384. data/lib/fontisan/open_type_collection.rb +49 -0
  385. data/lib/fontisan/open_type_font.rb +161 -0
  386. data/lib/fontisan/open_type_font_extensions.rb +54 -0
  387. data/lib/fontisan/optimizers/charstring_rewriter.rb +172 -0
  388. data/lib/fontisan/optimizers/pattern_analyzer.rb +310 -0
  389. data/lib/fontisan/optimizers/stack_tracker.rb +246 -0
  390. data/lib/fontisan/optimizers/subroutine_builder.rb +135 -0
  391. data/lib/fontisan/optimizers/subroutine_generator.rb +207 -0
  392. data/lib/fontisan/optimizers/subroutine_optimizer.rb +114 -0
  393. data/lib/fontisan/optimizers.rb +14 -0
  394. data/lib/fontisan/outline_extractor.rb +417 -0
  395. data/lib/fontisan/output_guard.rb +40 -0
  396. data/lib/fontisan/parsers/dfont_parser.rb +191 -0
  397. data/lib/fontisan/parsers/tag.rb +77 -0
  398. data/lib/fontisan/parsers.rb +10 -0
  399. data/lib/fontisan/pipeline/format_detector.rb +176 -0
  400. data/lib/fontisan/pipeline/output_writer.rb +161 -0
  401. data/lib/fontisan/pipeline/strategies/base_strategy.rb +75 -0
  402. data/lib/fontisan/pipeline/strategies/instance_strategy.rb +89 -0
  403. data/lib/fontisan/pipeline/strategies/named_strategy.rb +114 -0
  404. data/lib/fontisan/pipeline/strategies/preserve_strategy.rb +54 -0
  405. data/lib/fontisan/pipeline/strategies.rb +16 -0
  406. data/lib/fontisan/pipeline/transformation_pipeline.rb +407 -0
  407. data/lib/fontisan/pipeline/variation_resolver.rb +158 -0
  408. data/lib/fontisan/pipeline.rb +14 -0
  409. data/lib/fontisan/reference/table_digests.rb +251 -0
  410. data/lib/fontisan/reference.rb +663 -0
  411. data/lib/fontisan/scan.rb +372 -0
  412. data/lib/fontisan/sfnt_builder.rb +66 -0
  413. data/lib/fontisan/sfnt_directory.rb +41 -0
  414. data/lib/fontisan/sfnt_font.rb +749 -0
  415. data/lib/fontisan/sfnt_source.rb +28 -0
  416. data/lib/fontisan/sfnt_table.rb +260 -0
  417. data/lib/fontisan/stitcher/cbdt_propagator.rb +212 -0
  418. data/lib/fontisan/stitcher/collection_result.rb +19 -0
  419. data/lib/fontisan/stitcher/deduplicator.rb +47 -0
  420. data/lib/fontisan/stitcher/format_metadata.rb +51 -0
  421. data/lib/fontisan/stitcher/glyph_cloner.rb +41 -0
  422. data/lib/fontisan/stitcher/glyph_copier.rb +110 -0
  423. data/lib/fontisan/stitcher/glyph_limit.rb +53 -0
  424. data/lib/fontisan/stitcher/glyph_signature.rb +51 -0
  425. data/lib/fontisan/stitcher/partition_strategy/base.rb +52 -0
  426. data/lib/fontisan/stitcher/partition_strategy/blueprint.rb +24 -0
  427. data/lib/fontisan/stitcher/partition_strategy/by_block.rb +430 -0
  428. data/lib/fontisan/stitcher/partition_strategy/by_plane.rb +161 -0
  429. data/lib/fontisan/stitcher/partition_strategy/by_script.rb +309 -0
  430. data/lib/fontisan/stitcher/partition_strategy/partition.rb +24 -0
  431. data/lib/fontisan/stitcher/partition_strategy.rb +24 -0
  432. data/lib/fontisan/stitcher/selector/codepoints.rb +29 -0
  433. data/lib/fontisan/stitcher/selector/gid.rb +25 -0
  434. data/lib/fontisan/stitcher/selector/range.rb +30 -0
  435. data/lib/fontisan/stitcher/selector.rb +26 -0
  436. data/lib/fontisan/stitcher/source.rb +459 -0
  437. data/lib/fontisan/stitcher/unique_glyph_name.rb +46 -0
  438. data/lib/fontisan/stitcher.rb +185 -0
  439. data/lib/fontisan/stitcher_cli.rb +69 -0
  440. data/lib/fontisan/subset/builder.rb +263 -0
  441. data/lib/fontisan/subset/glyph_mapping.rb +222 -0
  442. data/lib/fontisan/subset/options.rb +142 -0
  443. data/lib/fontisan/subset/profile.rb +152 -0
  444. data/lib/fontisan/subset/shared_state.rb +42 -0
  445. data/lib/fontisan/subset/subset_context.rb +20 -0
  446. data/lib/fontisan/subset/table_strategy/cbdt.rb +30 -0
  447. data/lib/fontisan/subset/table_strategy/cblc.rb +27 -0
  448. data/lib/fontisan/subset/table_strategy/cff.rb +92 -0
  449. data/lib/fontisan/subset/table_strategy/cff2.rb +391 -0
  450. data/lib/fontisan/subset/table_strategy/cmap.rb +146 -0
  451. data/lib/fontisan/subset/table_strategy/color_bitmap_placement.rb +20 -0
  452. data/lib/fontisan/subset/table_strategy/color_bitmap_strike_plan.rb +45 -0
  453. data/lib/fontisan/subset/table_strategy/color_bitmap_subset_plan.rb +62 -0
  454. data/lib/fontisan/subset/table_strategy/color_bitmap_subsetter.rb +182 -0
  455. data/lib/fontisan/subset/table_strategy/color_bitmap_subtable_plan.rb +59 -0
  456. data/lib/fontisan/subset/table_strategy/glyf.rb +29 -0
  457. data/lib/fontisan/subset/table_strategy/glyf_loca_builder.rb +146 -0
  458. data/lib/fontisan/subset/table_strategy/head.rb +43 -0
  459. data/lib/fontisan/subset/table_strategy/hhea.rb +67 -0
  460. data/lib/fontisan/subset/table_strategy/hmtx.rb +52 -0
  461. data/lib/fontisan/subset/table_strategy/loca.rb +41 -0
  462. data/lib/fontisan/subset/table_strategy/maxp.rb +23 -0
  463. data/lib/fontisan/subset/table_strategy/name.rb +19 -0
  464. data/lib/fontisan/subset/table_strategy/os2.rb +21 -0
  465. data/lib/fontisan/subset/table_strategy/pass_through.rb +20 -0
  466. data/lib/fontisan/subset/table_strategy/post.rb +37 -0
  467. data/lib/fontisan/subset/table_strategy.rb +79 -0
  468. data/lib/fontisan/subset/table_subsetter.rb +110 -0
  469. data/lib/fontisan/subset.rb +16 -0
  470. data/lib/fontisan/svg/font_face_generator.rb +274 -0
  471. data/lib/fontisan/svg/font_generator.rb +256 -0
  472. data/lib/fontisan/svg/glyph_generator.rb +201 -0
  473. data/lib/fontisan/svg/standalone_glyph.rb +132 -0
  474. data/lib/fontisan/svg/view_box_calculator.rb +137 -0
  475. data/lib/fontisan/svg.rb +13 -0
  476. data/lib/fontisan/svg_to_glyf/assembler.rb +174 -0
  477. data/lib/fontisan/svg_to_glyf/document.rb +102 -0
  478. data/lib/fontisan/svg_to_glyf/geometry/affine_transform.rb +112 -0
  479. data/lib/fontisan/svg_to_glyf/geometry/normalizer.rb +62 -0
  480. data/lib/fontisan/svg_to_glyf/geometry/transform_parser.rb +98 -0
  481. data/lib/fontisan/svg_to_glyf/geometry.rb +15 -0
  482. data/lib/fontisan/svg_to_glyf/path/command.rb +18 -0
  483. data/lib/fontisan/svg_to_glyf/path/contour_builder.rb +140 -0
  484. data/lib/fontisan/svg_to_glyf/path/parser.rb +98 -0
  485. data/lib/fontisan/svg_to_glyf/path/state.rb +79 -0
  486. data/lib/fontisan/svg_to_glyf/path.rb +14 -0
  487. data/lib/fontisan/svg_to_glyf.rb +62 -0
  488. data/lib/fontisan/tables/cbdt.rb +113 -0
  489. data/lib/fontisan/tables/cblc.rb +172 -0
  490. data/lib/fontisan/tables/cblc_big_glyph_metrics.rb +28 -0
  491. data/lib/fontisan/tables/cblc_bitmap_size.rb +67 -0
  492. data/lib/fontisan/tables/cblc_glyph_bitmap_location.rb +28 -0
  493. data/lib/fontisan/tables/cblc_index_subtable.rb +104 -0
  494. data/lib/fontisan/tables/cblc_index_subtable_array_entry.rb +20 -0
  495. data/lib/fontisan/tables/cblc_index_subtable_format_parser.rb +150 -0
  496. data/lib/fontisan/tables/cblc_index_subtable_header.rb +18 -0
  497. data/lib/fontisan/tables/cblc_sbit_line_metrics.rb +28 -0
  498. data/lib/fontisan/tables/cff/cff2_charstring_builder.rb +225 -0
  499. data/lib/fontisan/tables/cff/cff_glyph.rb +176 -0
  500. data/lib/fontisan/tables/cff/charset.rb +276 -0
  501. data/lib/fontisan/tables/cff/charstring.rb +978 -0
  502. data/lib/fontisan/tables/cff/charstring_builder.rb +356 -0
  503. data/lib/fontisan/tables/cff/charstring_parser.rb +249 -0
  504. data/lib/fontisan/tables/cff/charstring_rebuilder.rb +168 -0
  505. data/lib/fontisan/tables/cff/charstrings_index.rb +159 -0
  506. data/lib/fontisan/tables/cff/dict.rb +353 -0
  507. data/lib/fontisan/tables/cff/dict_builder.rb +260 -0
  508. data/lib/fontisan/tables/cff/encoding.rb +273 -0
  509. data/lib/fontisan/tables/cff/expert_charsets.rb +85 -0
  510. data/lib/fontisan/tables/cff/header.rb +100 -0
  511. data/lib/fontisan/tables/cff/hint_operation_injector.rb +207 -0
  512. data/lib/fontisan/tables/cff/index.rb +241 -0
  513. data/lib/fontisan/tables/cff/index_builder.rb +170 -0
  514. data/lib/fontisan/tables/cff/offset_recalculator.rb +70 -0
  515. data/lib/fontisan/tables/cff/private_dict.rb +282 -0
  516. data/lib/fontisan/tables/cff/private_dict_writer.rb +129 -0
  517. data/lib/fontisan/tables/cff/standard_strings_data.rb +83 -0
  518. data/lib/fontisan/tables/cff/table_builder.rb +215 -0
  519. data/lib/fontisan/tables/cff/top_dict.rb +234 -0
  520. data/lib/fontisan/tables/cff.rb +497 -0
  521. data/lib/fontisan/tables/cff2/blend_operator.rb +240 -0
  522. data/lib/fontisan/tables/cff2/charstring_parser.rb +624 -0
  523. data/lib/fontisan/tables/cff2/dict_encoder.rb +94 -0
  524. data/lib/fontisan/tables/cff2/fd_select.rb +142 -0
  525. data/lib/fontisan/tables/cff2/header.rb +34 -0
  526. data/lib/fontisan/tables/cff2/index.rb +155 -0
  527. data/lib/fontisan/tables/cff2/index_builder.rb +80 -0
  528. data/lib/fontisan/tables/cff2/operand_stack.rb +232 -0
  529. data/lib/fontisan/tables/cff2/private_dict_blend_handler.rb +247 -0
  530. data/lib/fontisan/tables/cff2/region_matcher.rb +200 -0
  531. data/lib/fontisan/tables/cff2/table_builder.rb +567 -0
  532. data/lib/fontisan/tables/cff2/table_reader.rb +418 -0
  533. data/lib/fontisan/tables/cff2/variation_data_extractor.rb +212 -0
  534. data/lib/fontisan/tables/cff2.rb +353 -0
  535. data/lib/fontisan/tables/cmap.rb +399 -0
  536. data/lib/fontisan/tables/cmap_table.rb +228 -0
  537. data/lib/fontisan/tables/colr.rb +290 -0
  538. data/lib/fontisan/tables/cpal.rb +381 -0
  539. data/lib/fontisan/tables/cvar.rb +204 -0
  540. data/lib/fontisan/tables/fvar.rb +159 -0
  541. data/lib/fontisan/tables/glyf/compound_glyph.rb +482 -0
  542. data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb +135 -0
  543. data/lib/fontisan/tables/glyf/curve_converter.rb +349 -0
  544. data/lib/fontisan/tables/glyf/glyph_builder.rb +468 -0
  545. data/lib/fontisan/tables/glyf/simple_glyph.rb +391 -0
  546. data/lib/fontisan/tables/glyf.rb +347 -0
  547. data/lib/fontisan/tables/glyf_table.rb +252 -0
  548. data/lib/fontisan/tables/gpos/glyph_filter.rb +87 -0
  549. data/lib/fontisan/tables/gpos/kerning_pairs.rb +215 -0
  550. data/lib/fontisan/tables/gpos/pair_position.rb +274 -0
  551. data/lib/fontisan/tables/gpos.rb +139 -0
  552. data/lib/fontisan/tables/gsub.rb +116 -0
  553. data/lib/fontisan/tables/gvar.rb +232 -0
  554. data/lib/fontisan/tables/head.rb +208 -0
  555. data/lib/fontisan/tables/head_table.rb +108 -0
  556. data/lib/fontisan/tables/hhea.rb +199 -0
  557. data/lib/fontisan/tables/hhea_table.rb +252 -0
  558. data/lib/fontisan/tables/hmtx.rb +281 -0
  559. data/lib/fontisan/tables/hmtx_table.rb +188 -0
  560. data/lib/fontisan/tables/hvar.rb +192 -0
  561. data/lib/fontisan/tables/layout_common.rb +245 -0
  562. data/lib/fontisan/tables/loca.rb +323 -0
  563. data/lib/fontisan/tables/loca_table.rb +209 -0
  564. data/lib/fontisan/tables/maxp.rb +253 -0
  565. data/lib/fontisan/tables/maxp_table.rb +255 -0
  566. data/lib/fontisan/tables/mvar.rb +185 -0
  567. data/lib/fontisan/tables/name.rb +340 -0
  568. data/lib/fontisan/tables/name_table.rb +173 -0
  569. data/lib/fontisan/tables/os2.rb +291 -0
  570. data/lib/fontisan/tables/os2_table.rb +326 -0
  571. data/lib/fontisan/tables/post.rb +206 -0
  572. data/lib/fontisan/tables/post_table.rb +180 -0
  573. data/lib/fontisan/tables/registry.rb +71 -0
  574. data/lib/fontisan/tables/sbix.rb +379 -0
  575. data/lib/fontisan/tables/svg.rb +300 -0
  576. data/lib/fontisan/tables/variation_common.rb +345 -0
  577. data/lib/fontisan/tables/vvar.rb +234 -0
  578. data/lib/fontisan/tables.rb +69 -0
  579. data/lib/fontisan/true_type_collection.rb +160 -0
  580. data/lib/fontisan/true_type_font.rb +80 -0
  581. data/lib/fontisan/true_type_font_extensions.rb +54 -0
  582. data/lib/fontisan/type1/afm_generator.rb +379 -0
  583. data/lib/fontisan/type1/afm_parser.rb +299 -0
  584. data/lib/fontisan/type1/agl.rb +456 -0
  585. data/lib/fontisan/type1/cff_to_type1_converter.rb +307 -0
  586. data/lib/fontisan/type1/charstring_converter.rb +238 -0
  587. data/lib/fontisan/type1/charstrings.rb +441 -0
  588. data/lib/fontisan/type1/conversion_options.rb +242 -0
  589. data/lib/fontisan/type1/decryptor.rb +183 -0
  590. data/lib/fontisan/type1/encodings.rb +695 -0
  591. data/lib/fontisan/type1/font_dictionary.rb +576 -0
  592. data/lib/fontisan/type1/generator.rb +217 -0
  593. data/lib/fontisan/type1/inf_generator.rb +307 -0
  594. data/lib/fontisan/type1/pfa_generator.rb +376 -0
  595. data/lib/fontisan/type1/pfa_parser.rb +159 -0
  596. data/lib/fontisan/type1/pfb_generator.rb +321 -0
  597. data/lib/fontisan/type1/pfb_parser.rb +166 -0
  598. data/lib/fontisan/type1/pfm_generator.rb +589 -0
  599. data/lib/fontisan/type1/pfm_parser.rb +433 -0
  600. data/lib/fontisan/type1/private_dict.rb +363 -0
  601. data/lib/fontisan/type1/seac_expander.rb +517 -0
  602. data/lib/fontisan/type1/ttf_to_type1_converter.rb +389 -0
  603. data/lib/fontisan/type1/upm_scaler.rb +118 -0
  604. data/lib/fontisan/type1.rb +48 -0
  605. data/lib/fontisan/type1_font.rb +347 -0
  606. data/lib/fontisan/ufo/anchor.rb +17 -0
  607. data/lib/fontisan/ufo/bounds.rb +91 -0
  608. data/lib/fontisan/ufo/cli.rb +105 -0
  609. data/lib/fontisan/ufo/compile/avar.rb +46 -0
  610. data/lib/fontisan/ufo/compile/base_compiler.rb +162 -0
  611. data/lib/fontisan/ufo/compile/cbdt_cblc.rb +104 -0
  612. data/lib/fontisan/ufo/compile/cff.rb +229 -0
  613. data/lib/fontisan/ufo/compile/cff2.rb +323 -0
  614. data/lib/fontisan/ufo/compile/cff2_subroutines.rb +39 -0
  615. data/lib/fontisan/ufo/compile/cmap.rb +143 -0
  616. data/lib/fontisan/ufo/compile/colr.rb +80 -0
  617. data/lib/fontisan/ufo/compile/cpal.rb +62 -0
  618. data/lib/fontisan/ufo/compile/feature_compiler.rb +161 -0
  619. data/lib/fontisan/ufo/compile/feature_writers/base.rb +56 -0
  620. data/lib/fontisan/ufo/compile/feature_writers/curs.rb +72 -0
  621. data/lib/fontisan/ufo/compile/feature_writers/gdef.rb +92 -0
  622. data/lib/fontisan/ufo/compile/feature_writers/kern.rb +50 -0
  623. data/lib/fontisan/ufo/compile/feature_writers/kern2.rb +57 -0
  624. data/lib/fontisan/ufo/compile/feature_writers/mark.rb +45 -0
  625. data/lib/fontisan/ufo/compile/feature_writers/mark_family_base.rb +124 -0
  626. data/lib/fontisan/ufo/compile/feature_writers/mkmk.rb +53 -0
  627. data/lib/fontisan/ufo/compile/feature_writers.rb +38 -0
  628. data/lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb +176 -0
  629. data/lib/fontisan/ufo/compile/filters/decompose_components.rb +33 -0
  630. data/lib/fontisan/ufo/compile/filters/flatten_components.rb +22 -0
  631. data/lib/fontisan/ufo/compile/filters/propagate_anchors.rb +102 -0
  632. data/lib/fontisan/ufo/compile/filters/remove_overlaps.rb +95 -0
  633. data/lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb +27 -0
  634. data/lib/fontisan/ufo/compile/filters/sort_contours.rb +69 -0
  635. data/lib/fontisan/ufo/compile/filters/transformations.rb +113 -0
  636. data/lib/fontisan/ufo/compile/filters.rb +69 -0
  637. data/lib/fontisan/ufo/compile/fvar.rb +113 -0
  638. data/lib/fontisan/ufo/compile/glyf_loca.rb +206 -0
  639. data/lib/fontisan/ufo/compile/gpos.rb +248 -0
  640. data/lib/fontisan/ufo/compile/gsub.rb +267 -0
  641. data/lib/fontisan/ufo/compile/gvar.rb +225 -0
  642. data/lib/fontisan/ufo/compile/head.rb +97 -0
  643. data/lib/fontisan/ufo/compile/hhea.rb +57 -0
  644. data/lib/fontisan/ufo/compile/hmtx.rb +38 -0
  645. data/lib/fontisan/ufo/compile/hvar.rb +42 -0
  646. data/lib/fontisan/ufo/compile/item_variation_store.rb +100 -0
  647. data/lib/fontisan/ufo/compile/math.rb +143 -0
  648. data/lib/fontisan/ufo/compile/maxp.rb +57 -0
  649. data/lib/fontisan/ufo/compile/meta.rb +51 -0
  650. data/lib/fontisan/ufo/compile/mvar.rb +59 -0
  651. data/lib/fontisan/ufo/compile/name.rb +81 -0
  652. data/lib/fontisan/ufo/compile/os2.rb +81 -0
  653. data/lib/fontisan/ufo/compile/otf2_compiler.rb +40 -0
  654. data/lib/fontisan/ufo/compile/otf_compiler.rb +34 -0
  655. data/lib/fontisan/ufo/compile/post.rb +32 -0
  656. data/lib/fontisan/ufo/compile/sbix.rb +100 -0
  657. data/lib/fontisan/ufo/compile/stat.rb +106 -0
  658. data/lib/fontisan/ufo/compile/svg_table.rb +60 -0
  659. data/lib/fontisan/ufo/compile/ttf_compiler.rb +75 -0
  660. data/lib/fontisan/ufo/compile/variable_otf.rb +84 -0
  661. data/lib/fontisan/ufo/compile/variable_ttf.rb +161 -0
  662. data/lib/fontisan/ufo/compile.rb +72 -0
  663. data/lib/fontisan/ufo/component.rb +18 -0
  664. data/lib/fontisan/ufo/contour.rb +34 -0
  665. data/lib/fontisan/ufo/convert/from_bin_data.rb +366 -0
  666. data/lib/fontisan/ufo/convert/to_dfont.rb +45 -0
  667. data/lib/fontisan/ufo/convert/to_otc.rb +40 -0
  668. data/lib/fontisan/ufo/convert/to_otf.rb +18 -0
  669. data/lib/fontisan/ufo/convert/to_otf2.rb +20 -0
  670. data/lib/fontisan/ufo/convert/to_postscript.rb +64 -0
  671. data/lib/fontisan/ufo/convert/to_ttc.rb +35 -0
  672. data/lib/fontisan/ufo/convert/to_ttf.rb +21 -0
  673. data/lib/fontisan/ufo/convert/to_woff.rb +61 -0
  674. data/lib/fontisan/ufo/convert/to_woff2.rb +50 -0
  675. data/lib/fontisan/ufo/convert.rb +84 -0
  676. data/lib/fontisan/ufo/data_set.rb +21 -0
  677. data/lib/fontisan/ufo/features.rb +17 -0
  678. data/lib/fontisan/ufo/font.rb +63 -0
  679. data/lib/fontisan/ufo/glyph.rb +445 -0
  680. data/lib/fontisan/ufo/glyph_exists_error.rb +23 -0
  681. data/lib/fontisan/ufo/groups.rb +45 -0
  682. data/lib/fontisan/ufo/guideline.rb +19 -0
  683. data/lib/fontisan/ufo/image.rb +29 -0
  684. data/lib/fontisan/ufo/image_set.rb +99 -0
  685. data/lib/fontisan/ufo/info.rb +133 -0
  686. data/lib/fontisan/ufo/kerning.rb +32 -0
  687. data/lib/fontisan/ufo/layer.rb +78 -0
  688. data/lib/fontisan/ufo/layer_set.rb +37 -0
  689. data/lib/fontisan/ufo/lib.rb +24 -0
  690. data/lib/fontisan/ufo/plist.rb +123 -0
  691. data/lib/fontisan/ufo/point.rb +32 -0
  692. data/lib/fontisan/ufo/reader.rb +163 -0
  693. data/lib/fontisan/ufo/transformation.rb +50 -0
  694. data/lib/fontisan/ufo/writer.rb +123 -0
  695. data/lib/fontisan/ufo.rb +47 -0
  696. data/lib/fontisan/unicode/plane.rb +44 -0
  697. data/lib/fontisan/unicode.rb +17 -0
  698. data/lib/fontisan/utilities/brotli_wrapper.rb +177 -0
  699. data/lib/fontisan/utilities/checksum_calculator.rb +104 -0
  700. data/lib/fontisan/utilities/padding.rb +61 -0
  701. data/lib/fontisan/utilities.rb +11 -0
  702. data/lib/fontisan/utils/thread_pool.rb +134 -0
  703. data/lib/fontisan/utils.rb +10 -0
  704. data/lib/fontisan/validation/collection_validator.rb +265 -0
  705. data/lib/fontisan/validation.rb +9 -0
  706. data/lib/fontisan/validators/basic_validator.rb +73 -0
  707. data/lib/fontisan/validators/font_book_validator.rb +107 -0
  708. data/lib/fontisan/validators/opentype_validator.rb +118 -0
  709. data/lib/fontisan/validators/profile_loader.rb +134 -0
  710. data/lib/fontisan/validators/validator.rb +494 -0
  711. data/lib/fontisan/validators/web_font_validator.rb +95 -0
  712. data/lib/fontisan/validators.rb +14 -0
  713. data/lib/fontisan/variable/axis_normalizer.rb +215 -0
  714. data/lib/fontisan/variable/delta_applicator.rb +302 -0
  715. data/lib/fontisan/variable/glyph_delta_processor.rb +218 -0
  716. data/lib/fontisan/variable/instancer.rb +172 -0
  717. data/lib/fontisan/variable/metric_delta_processor.rb +282 -0
  718. data/lib/fontisan/variable/region_matcher.rb +208 -0
  719. data/lib/fontisan/variable/static_font_builder.rb +209 -0
  720. data/lib/fontisan/variable/table_updater.rb +219 -0
  721. data/lib/fontisan/variable.rb +16 -0
  722. data/lib/fontisan/variation/blend_applier.rb +197 -0
  723. data/lib/fontisan/variation/cache.rb +299 -0
  724. data/lib/fontisan/variation/cache_key_builder.rb +162 -0
  725. data/lib/fontisan/variation/converter.rb +373 -0
  726. data/lib/fontisan/variation/data_extractor.rb +84 -0
  727. data/lib/fontisan/variation/delta_applier.rb +262 -0
  728. data/lib/fontisan/variation/delta_parser.rb +228 -0
  729. data/lib/fontisan/variation/inspector.rb +275 -0
  730. data/lib/fontisan/variation/instance_font_wrapper.rb +41 -0
  731. data/lib/fontisan/variation/instance_generator.rb +122 -0
  732. data/lib/fontisan/variation/instance_writer.rb +360 -0
  733. data/lib/fontisan/variation/instancing/axis_space.rb +136 -0
  734. data/lib/fontisan/variation/instancing/glyph_outline.rb +204 -0
  735. data/lib/fontisan/variation/instancing/gvar_reader.rb +146 -0
  736. data/lib/fontisan/variation/instancing/item_variation_store.rb +92 -0
  737. data/lib/fontisan/variation/instancing/name_rewriter.rb +90 -0
  738. data/lib/fontisan/variation/instancing/true_type_instancer.rb +326 -0
  739. data/lib/fontisan/variation/instancing.rb +20 -0
  740. data/lib/fontisan/variation/interpolator.rb +231 -0
  741. data/lib/fontisan/variation/metrics_adjuster.rb +309 -0
  742. data/lib/fontisan/variation/optimizer.rb +417 -0
  743. data/lib/fontisan/variation/parallel_generator.rb +147 -0
  744. data/lib/fontisan/variation/region_matcher.rb +221 -0
  745. data/lib/fontisan/variation/subsetter.rb +400 -0
  746. data/lib/fontisan/variation/table_accessor.rb +105 -0
  747. data/lib/fontisan/variation/tuple_variation_header.rb +49 -0
  748. data/lib/fontisan/variation/validator.rb +336 -0
  749. data/lib/fontisan/variation/variable_svg_generator.rb +235 -0
  750. data/lib/fontisan/variation/variation_context.rb +208 -0
  751. data/lib/fontisan/variation/variation_preserver.rb +287 -0
  752. data/lib/fontisan/variation.rb +33 -0
  753. data/lib/fontisan/version.rb +5 -0
  754. data/lib/fontisan/version.rb.orig +9 -0
  755. data/lib/fontisan/woff2/collection_decoder.rb +223 -0
  756. data/lib/fontisan/woff2/collection_encoder.rb +302 -0
  757. data/lib/fontisan/woff2/directory.rb +255 -0
  758. data/lib/fontisan/woff2/encoder_rules.rb +114 -0
  759. data/lib/fontisan/woff2/glyf_canonicalizer.rb +90 -0
  760. data/lib/fontisan/woff2/glyf_loca_reconstruct.rb +401 -0
  761. data/lib/fontisan/woff2/glyf_loca_transform.rb +319 -0
  762. data/lib/fontisan/woff2/header.rb +101 -0
  763. data/lib/fontisan/woff2/hmtx_transformer.rb +140 -0
  764. data/lib/fontisan/woff2/sfnt_checksum.rb +107 -0
  765. data/lib/fontisan/woff2/table_transformer.rb +575 -0
  766. data/lib/fontisan/woff2/triplet_codec.rb +181 -0
  767. data/lib/fontisan/woff2/uint255.rb +101 -0
  768. data/lib/fontisan/woff2.rb +21 -0
  769. data/lib/fontisan/woff2_collection.rb +127 -0
  770. data/lib/fontisan/woff2_font.rb +754 -0
  771. data/lib/fontisan/woff_container.rb +83 -0
  772. data/lib/fontisan/woff_font.rb +554 -0
  773. data/lib/fontisan.rb +299 -0
  774. data/rakelib/bench.rake +9 -0
  775. data/rakelib/cdylib.rake +39 -0
  776. data/rakelib/corpus.rake +272 -0
  777. data/rakelib/corpus_convert.rake +43 -0
  778. data/rakelib/corpus_goldens.rake +22 -0
  779. data/rakelib/corpus_malformed.rake +20 -0
  780. data/rakelib/corpus_scan.rake +24 -0
  781. data/rakelib/java.rake +61 -0
  782. data/rakelib/native.rake +43 -0
  783. data/scripts/build-woff2.sh +57 -0
  784. data/scripts/compare_stack_aware.rb +187 -0
  785. data/scripts/corpus/generate_convert_goldens.rb +478 -0
  786. data/scripts/corpus/generate_goldens.rb +282 -0
  787. data/scripts/corpus/generate_malformed_goldens.rb +254 -0
  788. data/scripts/corpus/generate_scan_goldens.rb +98 -0
  789. data/scripts/measure_optimization.rb +148 -0
  790. data/scripts/tier_fallback.rb +228 -0
  791. data/scripts/tier_smoke.rb +72 -0
  792. metadata +945 -0
@@ -0,0 +1,220 @@
1
+ = WOFF and WOFF2 Font Format Support
2
+
3
+ == General
4
+
5
+ Fontisan provides comprehensive support for Web Open Font Format (WOFF) and WOFF2,
6
+ including reading, writing, and conversion between these and other font formats.
7
+
8
+ WOFF is a wrapper around SFNT fonts (TTF/OTF) using zlib compression, while WOFF2
9
+ uses Brotli compression for better compression ratios and table transformations.
10
+
11
+ == W3C specification compliance
12
+
13
+ Fontisan's WOFF and WOFF2 implementations are fully compliant with the
14
+ W3C Recommendations:
15
+
16
+ * **WOFF 1.0** (W3C Recommendation, 13 December 2012):
17
+ https://www.w3.org/TR/WOFF/[spec] — reading and writing
18
+ * **WOFF 2.0** (W3C Recommendation, 08 August 2024):
19
+ https://www.w3.org/TR/WOFF2/[spec] — reading and writing
20
+
21
+ === WOFF 2.0 (spec section references below)
22
+
23
+ Compliance covers every normative requirement of the WOFF2 spec:
24
+
25
+ * *Section 3.2 (WOFF2 Header)*: 48-byte header with correct signature
26
+ (`wOF2`), flavor, file length, reserved=0, totalSfntSize,
27
+ totalCompressedSize, version, and meta/private offset/length fields.
28
+ * *Section 4.1 (Table directory)*: flags byte structure (bits 0-5 tag
29
+ index, bits 6-7 transform version); optional 4-byte custom tag when
30
+ index=63; `transformLength` field present IFF table is transformed.
31
+ * *Section 4.2 (Collection directory)*: full support for flavor=`ttcf`
32
+ font collections — CollectionHeader + CollectionFontEntry per font,
33
+ with deduplicated tables shared across fonts via directory indices.
34
+ * *Section 5 (Compressed data)*: single Brotli stream of all tables in
35
+ directory order; `DSIG` table removed per encoder rule; `head.flags`
36
+ bit 11 set to indicate lossless modifying transform.
37
+ * *Section 5.1 (Transformed glyf table)*: 36-byte header (uint16
38
+ version + uint16 optionFlags + uint16 numGlyphs + uint16 indexFormat
39
+ + 7 × uint32 stream sizes); 7 streams in spec order (nContour,
40
+ nPoints, flags, glyph, composite, bbox with bboxBitmap prefix,
41
+ instructions); optional overlapSimpleBitmap when optionFlags bit 0
42
+ is set; bboxBitmap semantics per spec (composite glyphs always have
43
+ explicit bbox, simple glyphs omit when calculated bbox matches,
44
+ empty glyphs MUST have all-zero bbox).
45
+ * *Section 5.2 (Triplet coordinate encoding)*: variable-length
46
+ coordinate codec with all 128 flag index variants (1-4 byte
47
+ payloads based on coordinate magnitude); bit 7 = off-curve flag.
48
+ * *Section 5.3 (Transformed loca table)*: `transformLength` MUST be 0;
49
+ loca data omitted from compressed stream (reconstructed by decoder
50
+ from glyf).
51
+ * *Section 5.4 (Transformed hmtx table)*: optional version 1 transform
52
+ exploiting `lsb == xMin` redundancy.
53
+ * *Section 5.5 (Table order constraints)*: loca MUST immediately
54
+ follow glyf in table directory; for collections, loca MUST
55
+ immediately follow its corresponding glyf with no other tables in
56
+ between.
57
+
58
+ Validation: fontisan's WOFF2 output is verified byte-identical to
59
+ fontTools' output for transformed glyf tables, and round-trips
60
+ correctly through the W3C `woff2_decompress` reference tool.
61
+
62
+ === WOFF 1.0
63
+
64
+ * *Section 4 (WOFF Header)*: 44-byte header with correct signature
65
+ (`wOFF`), flavor, length, numTables, reserved=0, totalSfntSize,
66
+ version, and meta/private offset/length fields.
67
+ * *Section 5 (Table directory)*: 20-byte entries with tag, offset,
68
+ compLength, origLength, origChecksum. Tables sorted in input font
69
+ order per spec ("MUST be stored in the same order as the
70
+ well-formed input font").
71
+ * *Section 6 (Font data tables)*: tables compressed individually with
72
+ zlib (compress2-compatible); each table 4-byte aligned and
73
+ zero-padded to next boundary ("MUST begin on 4-byte boundaries and
74
+ be zero-padded to the next 4-byte boundary").
75
+ * *Section 7 (Extended metadata)*: optional block of XML data,
76
+ always zlib-compressed ("it is never stored in uncompressed form").
77
+ * *Section 8 (Private data)*: optional block of arbitrary bytes,
78
+ always 4-byte aligned.
79
+
80
+ Validation: fontisan's WOFF 1 output round-trips through fontTools
81
+ without errors; all 4-byte alignment, padding, and compression
82
+ requirements verified by spec-conformance specs.
83
+
84
+ === Display WOFF/WOFF2 font information
85
+
86
+ Show metadata specific to WOFF/WOFF2 fonts including version, compression details,
87
+ and original font flavor.
88
+
89
+ [source,shell]
90
+ ----
91
+ $ fontisan info FONT.woff [--format FORMAT]
92
+ ----
93
+
94
+ Where,
95
+
96
+ `FONT.woff`:: Path to the WOFF or WOFF2 file
97
+ `FORMAT`:: Output format: `text` (default), `json`, or `yaml`
98
+
99
+ .Major version from WOFF/WOFF2 header
100
+ [example]
101
+ ====
102
+ [source,shell]
103
+ ----
104
+ $ fontisan info /path/to/your/font.woff
105
+
106
+ Font type: WOFF (TrueType)
107
+ Family: Example Font
108
+ WOFF Major Version: 1
109
+ WOFF Minor Version: 0
110
+ WOFF Metadata: 0 entries
111
+ WOFF Private Data: 0 bytes
112
+ Original Font Flavor: TrueType
113
+ ----
114
+ ====
115
+
116
+ === WOFF2 validation
117
+
118
+ Fontisan validates WOFF2 fonts according to the specification, checking:
119
+
120
+ * Required table presence and order
121
+ * Table transformation flags (glyf, loca transformations)
122
+ * Checksum validation for transformed tables
123
+ * Compression format validation
124
+
125
+ .Validation example
126
+ [example]
127
+ ====
128
+ [source,shell]
129
+ ----
130
+ $ fontisan validate font.woff2 -t web
131
+
132
+ CHECK_ID | STATUS | SEVERITY
133
+ --------------------------------------------------------------
134
+ woff2_required_tables | PASS | error
135
+ woff2_table_transformations | PASS | error
136
+ woff2_checksum_validation | PASS | error
137
+ ----
138
+ ====
139
+
140
+ === Convert fonts to WOFF/WOFF2
141
+
142
+ Convert TTF/OTF fonts to web-optimized formats.
143
+
144
+ [source,shell]
145
+ ----
146
+ $ fontisan convert INPUT.ttf --to woff --output output.woff
147
+ $ fontisan convert INPUT.ttf --to woff2 --output output.woff2
148
+ ----
149
+
150
+ === Choosing between WOFF and WOFF2
151
+
152
+ WOFF and WOFF2 use different compression algorithms, fixed by their specs.
153
+ The format you choose **is** the choice of algorithm — there is no separate
154
+ `--compression` flag.
155
+
156
+ [options="header"]
157
+ |====
158
+ | Format | Algorithm | Compatibility | Typical size
159
+ | WOFF | zlib | All browsers (legacy-safe) | baseline
160
+ | WOFF2 | Brotli | Modern browsers only | ~30% smaller than WOFF
161
+ |====
162
+
163
+ If you need to support old browsers that lack Brotli decoders, use WOFF:
164
+
165
+ [source,shell]
166
+ ----
167
+ $ fontisan convert INPUT.ttf --to woff --output out.woff --zlib-level 9
168
+ ----
169
+
170
+ For modern-only delivery, WOFF2 is preferred:
171
+
172
+ [source,shell]
173
+ ----
174
+ $ fontisan convert INPUT.ttf --to woff2 --output out.woff2
175
+ ----
176
+
177
+ Note: WOFF2 mandates Brotli, WOFF mandates zlib. The container format is the
178
+ algorithm selector — you cannot mix and match.
179
+
180
+ ==== Per-format compression knobs
181
+
182
+ Each container exposes only the knobs that apply to it. Options declared for
183
+ the wrong target format raise a clear `ArgumentError` at convert time.
184
+
185
+ [options="header"]
186
+ |====
187
+ | Format | Knob | Range / values | Default
188
+ | WOFF | `--zlib-level` | 0–9 | 6
189
+ | WOFF | `--uncompressed` | (flag) | off
190
+ | WOFF | `--compression-threshold` | bytes | 100
191
+ | WOFF2 | `--brotli-quality` | 0–11 | 11
192
+ | WOFF2 | `--[no-]transform-tables` | (flag) | off
193
+ |====
194
+
195
+ The same knobs are available on the Ruby API via keyword arguments:
196
+
197
+ [source,ruby]
198
+ ----
199
+ Fontisan.convert("f.ttf", to: :woff, output: "f.woff", zlib_level: 9)
200
+ Fontisan.convert("f.ttf", to: :woff2, output: "f.woff2", brotli_quality: 11)
201
+ ----
202
+
203
+ .Conversion with optimization
204
+ [example]
205
+ ====
206
+ [source,shell]
207
+ ----
208
+ $ fontisan convert font.ttf --to woff2 --output font.woff2
209
+
210
+ Converting font.ttf to WOFF2...
211
+ Input: 245.8 KB (TTF)
212
+ Output: 89.2 KB (WOFF2)
213
+ Ratio: 63.7% reduction
214
+
215
+ Compression details:
216
+ Tables: 12
217
+ Brotli compression: Applied
218
+ Transformed tables: glyf, loca
219
+ ----
220
+ ====
@@ -0,0 +1,164 @@
1
+ ---
2
+ title: ConversionOptions
3
+ ---
4
+
5
+ # ConversionOptions
6
+
7
+ Type-safe conversion configuration.
8
+
9
+ ## Overview
10
+
11
+ `Fontisan::ConversionOptions` provides a type-safe way to configure font conversions.
12
+
13
+ ## Class Methods
14
+
15
+ ### recommended(from:, to:)
16
+
17
+ Get recommended options for a conversion type.
18
+
19
+ ```ruby
20
+ options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
21
+ # => #<Fontisan::ConversionOptions ...>
22
+
23
+ # Access settings
24
+ options.opening # => { convert_curves: true, ... }
25
+ options.generating # => { hinting_mode: "auto", ... }
26
+ ```
27
+
28
+ **Parameters:**
29
+
30
+ | Name | Type | Description |
31
+ |------|------|-------------|
32
+ | from | Symbol | Source format |
33
+ | to | Symbol | Target format |
34
+
35
+ ### from_preset(name)
36
+
37
+ Load options from a named preset.
38
+
39
+ ```ruby
40
+ # Web optimization preset
41
+ options = Fontisan::ConversionOptions.from_preset(:web_optimized)
42
+
43
+ # Type 1 to modern
44
+ options = Fontisan::ConversionOptions.from_preset(:type1_to_modern)
45
+ ```
46
+
47
+ **Available Presets:**
48
+
49
+ | Preset | From | To |
50
+ |--------|------|-----|
51
+ | `type1_to_modern` | Type 1 | OTF |
52
+ | `modern_to_type1` | OTF | Type 1 |
53
+ | `web_optimized` | OTF | WOFF2 |
54
+ | `legacy_web` | OTF | WOFF |
55
+ | `archive_to_modern` | TTC | OTF |
56
+
57
+ ### new(**kwargs)
58
+
59
+ Create custom options.
60
+
61
+ ```ruby
62
+ options = Fontisan::ConversionOptions.new(
63
+ from: :ttf,
64
+ to: :otf,
65
+ opening: {
66
+ convert_curves: true,
67
+ autohint: true
68
+ },
69
+ generating: {
70
+ hinting_mode: 'auto',
71
+ optimize_tables: true
72
+ }
73
+ )
74
+ ```
75
+
76
+ ## Instance Attributes
77
+
78
+ ### opening
79
+
80
+ Opening options control source font processing.
81
+
82
+ | Option | Type | Default |
83
+ |--------|------|---------|
84
+ | `decompose_composites` | Boolean | false |
85
+ | `convert_curves` | Boolean | true |
86
+ | `scale_to_1000` | Boolean | false |
87
+ | `scale_from_1000` | Boolean | false |
88
+ | `autohint` | Boolean | false |
89
+ | `generate_unicode` | Boolean | false |
90
+ | `store_custom_tables` | Boolean | true |
91
+ | `store_native_hinting` | Boolean | false |
92
+ | `interpret_ot` | Boolean | false |
93
+ | `read_all_records` | Boolean | false |
94
+ | `preserve_encoding` | String | nil |
95
+
96
+ ### generating
97
+
98
+ Generating options control output font writing.
99
+
100
+ | Option | Type | Default | Applies to |
101
+ |--------|------|---------|------------|
102
+ | `write_pfm` | Boolean | false | Type 1 output |
103
+ | `write_afm` | Boolean | false | Type 1 output |
104
+ | `write_inf` | Boolean | false | Type 1 output |
105
+ | `select_encoding_automatically` | Boolean | false | Type 1 output |
106
+ | `hinting_mode` | String | 'preserve' | All outline conversions |
107
+ | `decompose_on_output` | Boolean | false | All outline conversions |
108
+ | `write_custom_tables` | Boolean | true | All |
109
+ | `optimize_tables` | Boolean | false | All |
110
+ | `zlib_level` | Integer (0–9) | 6 | WOFF only |
111
+ | `uncompressed` | Boolean | false | WOFF only |
112
+ | `compression_threshold` | Integer (bytes) | 100 | WOFF only |
113
+ | `brotli_quality` | Integer (0–11) | 11 | WOFF2 only |
114
+ | `transform_tables` | Boolean | false | WOFF2 only |
115
+ | `metadata_xml` | String | nil | WOFF only |
116
+ | `private_data` | String | nil | WOFF only |
117
+ | `preserve_metadata` | Boolean | true | All |
118
+
119
+ Compression knobs are declared by each strategy (`WoffWriter`, `Woff2Encoder`)
120
+ via the `ConversionStrategy` DSL. `FormatConverter.validate_options_for_target!`
121
+ rejects knobs that don't apply to the requested target format.
122
+
123
+ ## Examples
124
+
125
+ ### Basic Conversion
126
+
127
+ ```ruby
128
+ options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
129
+ converter = Fontisan::Converters::OutlineConverter.new
130
+ result = converter.convert(font, options: options)
131
+ ```
132
+
133
+ ### Web Optimization
134
+
135
+ ```ruby
136
+ options = Fontisan::ConversionOptions.from_preset(:web_optimized)
137
+ Fontisan::FontWriter.write(font, 'output.woff2', options: options)
138
+ ```
139
+
140
+ ### Custom Options
141
+
142
+ ```ruby
143
+ options = Fontisan::ConversionOptions.new(
144
+ from: :ttf,
145
+ to: :woff2,
146
+ opening: { autohint: true },
147
+ generating: {
148
+ hinting_mode: 'auto',
149
+ optimize_tables: true,
150
+ brotli_quality: 11,
151
+ transform_tables: true
152
+ }
153
+ )
154
+ ```
155
+
156
+ ### WOFF with Max zlib (Legacy Browser Reach)
157
+
158
+ ```ruby
159
+ options = Fontisan::ConversionOptions.new(
160
+ from: :ttf,
161
+ to: :woff,
162
+ generating: { zlib_level: 9, preserve_metadata: true }
163
+ )
164
+ ```
@@ -0,0 +1,34 @@
1
+ ---
2
+ title: CurveConverter
3
+ ---
4
+
5
+ # CurveConverter
6
+
7
+ Convert between quadratic and cubic curves.
8
+
9
+ ## Overview
10
+
11
+ `Fontisan::Converters::CurveConverter` handles Bézier curve conversion.
12
+
13
+ ## Methods
14
+
15
+ ### quadratic_to_cubic(points)
16
+
17
+ Convert quadratic points to cubic.
18
+
19
+ ```ruby
20
+ converter = Fontisan::Converters::CurveConverter.new
21
+ cubic = converter.quadratic_to_cubic(quadratic_points)
22
+ ```
23
+
24
+ ### cubic_to_quadratic(points, tolerance: 0.5)
25
+
26
+ Convert cubic points to quadratic.
27
+
28
+ ```ruby
29
+ quadratic = converter.cubic_to_quadratic(cubic_points, tolerance: 0.5)
30
+ ```
31
+
32
+ ## See Also
33
+
34
+ - [OutlineConverter](/api/converters/outline-converter)
@@ -0,0 +1,34 @@
1
+ ---
2
+ title: HintConverter
3
+ ---
4
+
5
+ # HintConverter
6
+
7
+ Convert hints between TrueType and PostScript formats.
8
+
9
+ ## Overview
10
+
11
+ `Fontisan::Converters::HintConverter` handles bidirectional hint conversion.
12
+
13
+ ## Methods
14
+
15
+ ### truetype_to_postscript(font)
16
+
17
+ Convert TrueType instructions to PostScript hints.
18
+
19
+ ```ruby
20
+ converter = Fontisan::Converters::HintConverter.new
21
+ ps_hints = converter.truetype_to_postscript(font)
22
+ ```
23
+
24
+ ### postscript_to_truetype(font)
25
+
26
+ Convert PostScript hints to TrueType instructions.
27
+
28
+ ```ruby
29
+ ttf_tables = converter.postscript_to_truetype(font)
30
+ ```
31
+
32
+ ## See Also
33
+
34
+ - [Font Hinting Guide](/guide/hinting/)
@@ -0,0 +1,27 @@
1
+ ---
2
+ title: OutlineConverter
3
+ ---
4
+
5
+ # OutlineConverter
6
+
7
+ Convert font outlines between formats.
8
+
9
+ ## Overview
10
+
11
+ `Fontisan::Converters::OutlineConverter` handles TTF ↔ OTF conversion.
12
+
13
+ ## Methods
14
+
15
+ ### convert(font, options: nil)
16
+
17
+ Convert a font to a different format.
18
+
19
+ ```ruby
20
+ converter = Fontisan::Converters::OutlineConverter.new
21
+ options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
22
+ result = converter.convert(font, options: options)
23
+ ```
24
+
25
+ ## See Also
26
+
27
+ - [ConversionOptions](/api/conversion-options)
@@ -0,0 +1,117 @@
1
+ ---
2
+ title: FontLoader
3
+ ---
4
+
5
+ # FontLoader
6
+
7
+ Unified font loading with automatic format detection.
8
+
9
+ ## Overview
10
+
11
+ `Fontisan::FontLoader` provides a unified interface for loading fonts in any supported format.
12
+
13
+ ## Class Methods
14
+
15
+ ### load(source)
16
+
17
+ Load a font from file path or IO.
18
+
19
+ ```ruby
20
+ # From file path
21
+ font = Fontisan::FontLoader.load('font.ttf')
22
+ font = Fontisan::FontLoader.load('font.otf')
23
+ font = Fontisan::FontLoader.load('font.pfb')
24
+ font = Fontisan::FontLoader.load('font.woff2')
25
+
26
+ # From IO
27
+ font = Fontisan::FontLoader.load(File.open('font.ttf'))
28
+
29
+ # From string
30
+ font = Fontisan::FontLoader.load(File.read('font.ttf', mode: 'rb'))
31
+ ```
32
+
33
+ **Parameters:**
34
+
35
+ | Name | Type | Description |
36
+ |------|------|-------------|
37
+ | source | String, IO | File path, IO object, or binary data |
38
+
39
+ **Returns:** SfntFont, Type1Font, or Collection
40
+
41
+ **Raises:** Fontisan::FormatError if format is unsupported
42
+
43
+ ### detect_format(path)
44
+
45
+ Detect a font's on-disk format from its content (magic bytes). The file
46
+ extension is ignored — a `.ttc` that actually contains a single OpenType-CFF
47
+ font is reported as `:otf`.
48
+
49
+ ```ruby
50
+ format = Fontisan::FontLoader.detect_format('font.ttf')
51
+ # => :ttf
52
+
53
+ format = Fontisan::FontLoader.detect_format('font.otf')
54
+ # => :otf
55
+
56
+ format = Fontisan::FontLoader.detect_format('font.pfb')
57
+ # => :pfb
58
+
59
+ format = Fontisan::FontLoader.detect_format('font.pfa')
60
+ # => :pfa
61
+ ```
62
+
63
+ **Returns:** Symbol (`:ttf`, `:otf`, `:ttc`, `:otc`, `:woff`, `:woff2`,
64
+ `:dfont`, `:pfa`, `:pfb`) or `nil` if the format is not recognised.
65
+
66
+ ## Supported Formats
67
+
68
+ | Symbol | Detection | Notes |
69
+ |---------|-------------|--------------------------------|
70
+ | `:ttf` | Magic bytes | TrueType |
71
+ | `:otf` | Magic bytes | OpenType / CFF |
72
+ | `:ttc` | Magic bytes | TrueType Collection |
73
+ | `:otc` | Magic bytes | OpenType Collection |
74
+ | `:woff` | Magic bytes | Web Open Font Format |
75
+ | `:woff2` | Magic bytes | Web Open Font Format 2 |
76
+ | `:pfb` | Marker byte | Adobe Type 1 Binary |
77
+ | `:pfa` | Text header | Adobe Type 1 ASCII |
78
+ | `:dfont` | Magic bytes | Apple Data-Fork resource fork |
79
+
80
+ ## Examples
81
+
82
+ ### Load with Error Handling
83
+
84
+ ```ruby
85
+ begin
86
+ font = Fontisan::FontLoader.load(path)
87
+ puts "Loaded: #{font.family_name}"
88
+ rescue Fontisan::FormatError => e
89
+ puts "Unsupported format: #{e.message}"
90
+ rescue Errno::ENOENT => e
91
+ puts "File not found: #{path}"
92
+ end
93
+ ```
94
+
95
+ ### Batch Loading
96
+
97
+ ```ruby
98
+ fonts = Dir.glob('fonts/*.ttf').map do |path|
99
+ Fontisan::FontLoader.load(path)
100
+ end
101
+
102
+ puts "Loaded #{fonts.length} fonts"
103
+ ```
104
+
105
+ ### Detect and Load
106
+
107
+ ```ruby
108
+ path = 'unknown.dat'
109
+
110
+ format = Fontisan::FontLoader.detect_format(path)
111
+ if format
112
+ puts "Detected format: #{format}"
113
+ font = Fontisan::FontLoader.load(path)
114
+ else
115
+ puts "Unknown format"
116
+ end
117
+ ```
@@ -0,0 +1,103 @@
1
+ ---
2
+ title: FontWriter
3
+ ---
4
+
5
+ # FontWriter
6
+
7
+ Write fonts to various formats.
8
+
9
+ ## Overview
10
+
11
+ `Fontisan::FontWriter` handles saving fonts to files in various formats.
12
+
13
+ ## Class Methods
14
+
15
+ ### write(font, path, options: {})
16
+
17
+ Write a font to a file.
18
+
19
+ ```ruby
20
+ font = Fontisan::FontLoader.load('input.ttf')
21
+
22
+ # Write as TTF
23
+ Fontisan::FontWriter.write(font, 'output.ttf')
24
+
25
+ # Write as OTF
26
+ Fontisan::FontWriter.write(font, 'output.otf')
27
+
28
+ # Write as WOFF2
29
+ Fontisan::FontWriter.write(font, 'output.woff2')
30
+
31
+ # With options
32
+ options = Fontisan::ConversionOptions.new(
33
+ generating: { optimize_tables: true }
34
+ )
35
+ Fontisan::FontWriter.write(font, 'output.ttf', options: options)
36
+ ```
37
+
38
+ **Parameters:**
39
+
40
+ | Name | Type | Description |
41
+ |------|------|-------------|
42
+ | font | SfntFont, Type1Font | Font object |
43
+ | path | String | Output file path |
44
+ | options | ConversionOptions | Optional settings |
45
+
46
+ **Returns:** Boolean
47
+
48
+ ### write_to_file(data, path, sfnt_version: nil)
49
+
50
+ Write raw font data to a file.
51
+
52
+ ```ruby
53
+ # Write raw table data
54
+ Fontisan::FontWriter.write_to_file(
55
+ font.table_data,
56
+ 'output.ttf',
57
+ sfnt_version: 0x00010000
58
+ )
59
+ ```
60
+
61
+ ## Output Formats
62
+
63
+ | Format | Extension | Notes |
64
+ |--------|-----------|-------|
65
+ | TTF | .ttf | TrueType |
66
+ | OTF | .otf | OpenType/CFF |
67
+ | WOFF | .woff | Web Open Font Format |
68
+ | WOFF2 | .woff2 | Web Open Font Format 2 |
69
+ | PFB | .pfb | Adobe Type 1 |
70
+ | SVG | .svg | SVG Font |
71
+
72
+ ## Examples
73
+
74
+ ### Convert and Write
75
+
76
+ ```ruby
77
+ # Load TTF
78
+ font = Fontisan::FontLoader.load('input.ttf')
79
+
80
+ # Convert to OTF
81
+ options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
82
+ converter = Fontisan::Converters::OutlineConverter.new
83
+ otf_tables = converter.convert(font, options: options)
84
+
85
+ # Write OTF
86
+ Fontisan::FontWriter.write(otf_tables, 'output.otf')
87
+ ```
88
+
89
+ ### Batch Writing
90
+
91
+ ```ruby
92
+ fonts.each_with_index do |font, i|
93
+ Fontisan::FontWriter.write(font, "output-#{i}.ttf")
94
+ end
95
+ ```
96
+
97
+ ### Web Optimization
98
+
99
+ ```ruby
100
+ font = Fontisan::FontLoader.load('input.otf')
101
+ options = Fontisan::ConversionOptions.from_preset(:web_optimized)
102
+ Fontisan::FontWriter.write(font, 'output.woff2', options: options)
103
+ ```