NOM
Defoma::Font - module Defoma pour la gestion des polices et des caches
de polices
SYNOPSIS
use Defoma::Font;
defoma_font_register( catégorie, police, indications... );
defoma_font_unregister( catégorie, police );
defoma_font_reregister( catégorie, police, indications... );
defoma_font_if_register( catégorie, police );
@polices = defoma_font_get_fonts( catégorie );
@indications = defoma_font_get_hints( catégorie, police );
%echec_apps = defoma_font_get_failed ( catégorie, police );
DESCRIPTION
Defoma::Font est un module Defoma qui permet de gérer l’enregistrement
et le désenregistrement de polices et de caches de polices. Il fournit
les fonctions listées ci-dessous qui sont supposées être appelées dans
les scripts de configuration Defoma lorsque les scripts veulent
enregistrer ou désenregistrer une police, ou veulent récupérer les
données contenues dans un cache de police (« font-cache »), qui
contiennent des polices et leurs indications.
defoma_font_register permet d’enregistrer une police dans une catégorie
avec les indications spécifiées. Si la police est déjà enregistrée, la
fonction renvoie une valeur non nulle. Sinon, la police et ses
indications sont enregistrées dans le cache de polices de la catégorie
spécifiée, et les autres scripts de configuration Defoma qui acceptent
la catégorie spécifiée sont appelés avec la commande register.
defoma_font_unregister permet de retirer une police d’une certaine
catégorie. Si la police n’est pas enregistrée dans la catégorie
spécifiée, elle retourne une valeur non nulle. Sinon, les autres
scripts de configuration Defoma qui acceptent cette catégorie sont
appelés avec la commande unregister, et la police et ses indications
sont retirées du cache de polices de la catégorie.
defoma_font_reregister rappelle defoma_font_unregister et
defoma_font_register dans l’ordre. Si la police spécifiée n’est pas
enregistrée dans la catégorie, l’étape de désenregistrement est passée.
Si la police est déjà enregistrée dans une autre catégorie, cette
fonction retourne une valeur non nulle.
defoma_font_if_register permet de vérifier si une police est
enregistrée dans une catégorie. Si la police est enregistrée, elle
retourne une valeur non nulle. Sinon, cette fonction retourne zéro.
defoma_font_get_fonts permet d’obtenir une liste de polices
enregistrées dans la catégorie spécifiée. Cette fonction retourne la
liste des polices sous forme de tableau (« police1 police2 police3
... »).
defoma_font_get_hints permet d’obtenir les indications de la police
enregistrée dans la catégorie spécifiée. Une liste d’indications sous
forme de tableau est retournée.
defoma_font_get_failed permet d’obtenir les applications pour
lesquelles Defoma n’a pas réussi à configurer la police spécifiée.
Cette fonction retourne une table de hachage dont les clés sont les
applications et les valeurs sont les statuts d’erreur.
EXEMPLES
1. Enregistrement de « Helvetica-Bold » dans la catégorie
« postscript » avec des indications.
$police = ’Helvetica-Bold’;
@indications = (’--Family’, ’Helvetica’, ’--Weight’, ’Bold’,
’--Charset’, ’ISO8859-1);
defoma_font_register(’postscript’, $police, @indications);
2. Désenregistrement de « toto.pfa » de la catégorie « type1 ».
$police = ’/usr/share/fonts/toto.pfa’;
defoma_font_unregister(’type1’, $police);
3. Désenregistrement de « toto.pfa » de la catégorie « type1 », s’il
était enregistré.
$police = ’/usr/share/fonts/toto.pfa’;
if (defoma_font_if_register(’type1’, $police)) {
defoma_font_unregister(’type1’, $police);
}
4. Récupération d’une liste de polices et de leurs indications
%hash = ();
@polices = defoma_font_get_fonts(’x-postscript’);
foreach $police (@polices) {
$hash{$police} = [];
@{$hash{$police}} = defoma_font_get_hints(’x-postscript’, $police);
}
VOIR AUSSI
defoma(1), defoma-font(1)
TRADUCTION
Ce document est une traduction, réalisée par Nicolas François le 29
juillet 2005 et mise à jour par Cyril Brulebois en janvier 2007.
L’équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité.
La version anglaise la plus à jour de ce document est toujours
consultable en ajoutant l’option « -L C » à la commande man.
N’hésitez pas à signaler à l’auteur ou à la liste de traduction
<debian-l10n-french@lists.debian.org>, selon le cas, toute erreur dans
cette page de manuel.