Modèle objet OpenType indépendant

Installer avec Composer · Packagist ↗

Module optionnel · pdftoolkit/opentype 0.1.0

English | Français

Des objets de fonte explicites et des substitutions de glyphes pour PHP 8.3+.

OpenType fait partie de PDFToolkit et reste indépendant du PDF : installer pdftoolkit/opentype n'installe aucun package PDF. Ses noms et structures suivent la spécification OpenType 1.9.1.

Cette première version lit une fonte SFNT individuelle, ses correspondances Unicode et ses métriques horizontales, puis applique les substitutions GSUB prises en charge avec des objets immuables de script, langue, fonctionnalité et lookup. L'application choisit explicitement les fonctionnalités et les variantes.

composer require 'pdftoolkit/opentype:^0.1'

PHP 8.3 ou ultérieur et une plateforme 64 bits sont requis. Aucune dépendance de package ni extension n'est requise en production. La CI vérifie PHP 8.3, 8.4 et 8.5.

Suivre les objets

use PDFToolkit\OpenType\Cmap\UnicodeCmapReader;
use PDFToolkit\OpenType\Sfnt\SfntReader;
use PDFToolkit\OpenType\Substitution\FeatureSelection;
use PDFToolkit\OpenType\Substitution\GlyphSequence;
use PDFToolkit\OpenType\Substitution\GsubReader;
use PDFToolkit\OpenType\Substitution\SubstitutionEngine;
use PDFToolkit\OpenType\Value\CodePoint;
use PDFToolkit\OpenType\Value\Tag;

// L'application fournit les octets ; la bibliothèque n'ouvre pas de fichier.
$font = (new SfntReader())->read($fontBytes);
$cmap = (new UnicodeCmapReader())->read($font->table(new Tag('cmap')), $font->glyphCount());
$input = new GlyphSequence([
    $cmap->glyphFor(new CodePoint(0x66)), // f
    $cmap->glyphFor(new CodePoint(0x66)), // f
    $cmap->glyphFor(new CodePoint(0x69)), // i
]);
$gsub = (new GsubReader())->read($font->table(new Tag('GSUB')), $font->glyphCount());
$selection = new FeatureSelection(new Tag('latn'), features: [new Tag('liga')]);
$result = (new SubstitutionEngine())->apply($gsub, $selection, $input);

La table de correspondance transforme les scalaires Unicode en glyphes de cette fonte. Le lecteur GSUB construit ses tables de layout. Le moteur sélectionne le système de langue et les fonctionnalités, applique leurs lookups et renvoie une nouvelle séquence. Une ligature ffi n'est produite que si la fonte et la sélection la définissent. Les clusters d'origine restent disponibles pour le traitement ultérieur du texte.

Le didacticiel des substitutions explique ligatures, petites capitales et variantes. L'architecture, la couverture, la politique de sécurité et la documentation commune précisent les contrats. Les pages d'API proviennent de la version publiée exacte.

Couverture de la version 0.1

Les substitutions contextuelles et inverses, les flags nécessitant GDEF, le positionnement et le crénage GPOS, les fontes variables, l'interprétation des contours et l'écriture de fontes restent à implémenter. L'accès aux octets ne signifie pas que le mécanisme d'une table est pris en charge. Le moteur reçoit des glyphes déjà ordonnés ; ce n'est pas un moteur complet de shaping Unicode ou de texte bidirectionnel. L'API 0.x peut évoluer entre versions mineures.

Le document Adobe OTGuide.pdf fourni est conservé sans modification comme référence d'utilisation. Son nom, ses 13 pages et son SHA-256 sont enregistrés à côté. Les définitions techniques utilisent la spécification officielle. Le guide conserve ses droits d'origine ; MIT porte sur le code du package. Le PDF et les fixtures de développement sont exclus des distributions Composer.

Développement

composer install
composer check
php examples/substitution.php
php examples/manual-ligature.php
php examples/font-metrics.php

L'exemple utilise une fonte reproductible créée pour les tests et affiche les substitutions. Les validateurs indépendants figurent dans tools/. Le journal des versions décrit chaque publication.

Source de ce guide au commit documenté ↗