font_add


La description

Cette fonction peut être utilisée pour ajouter une police à votre jeu à partir des polices installées sur le système sur lequel il s'exécute. Vous pouvez définir la taille de la police (en points), si la police doit être en gras ou en italique, et vous pouvez également définir la plage de caractères à inclure (pour une table complète de caractères disponibles et leur valeur UTF8 voir Police tables ). La fonction renvoie une valeur d' index qui doit être stockée dans une variable car elle sera nécessaire dans tous les autres codes qui se réfèrent à cette police.

IMPORTANT! Cette fonction n'est pas disponible avec la licence d'évaluation du produit.


Pour le module cible HTML5, cette fonction ne peut être utilisée que pour ajouter des polices Web, mais ne fonctionnera que si WebGL n'est pas activé. Si WebGL est activé, vous devez utiliser un fichier de police inclus. Le tableau suivant montre les polices standard dans tous les navigateurs et qui devraient être disponibles pour une utilisation sans problèmes. N'importe quelle autre police peut exister ou ne pas exister sur l'ordinateur ou l'appareil qui exécute votre jeu, donc l'utilisation de cette fonction devrait être limitée à ces polices standard:

Nom de police Windows Mac Nom de la police Famille de polices
Arial Arial / Helvetica sans-serif
Noir arial Arial Black / Gadget sans-serif
Comic Sans MS Comic Sans MS cursive
Courier New Courier New monospaced
Géorgie Géorgie serif
Impact Impact / Charbon sans-serif
Lucida Console Monaco monospaced
Lucida Sans Unicode Lucida Grande sans-serif
Palatino Linotype / Livre Antiqua Palatino serif
Tahoma Genève sans-serif
Times New Roman Times New Roman / Times serif
Trebuchet MS Trebuchet MS sans-serif
Verdana Verdana / Genève sans-serif
Géorgie Géorgie serif
symbole symbole N / A
Webdings Webdings N / A
Wingdings Zapf Dingbats N / A
MS Sans Serif Genève sans-serif
MS Serif New York sans-serif



Sur toutes les autres cibles (non JavaScript), vous pouvez utiliser cette fonction pour ajouter une police à partir d'un fichier. Le fichier doit être inclus dans l'ensemble de jeu à l'aide de la fonctionnalité Fichiers inclus de GameMaker Studio 2, et doit être un *.ttf format de fichier de police, utile pour ajouter des polices non standard comme l'Asie ou l'arabe.

AVERTISSEMENT!: Si vous incluez une police dans *.ttf format avec un jeu, il doit être autorisé pour la distribution avec le jeu.


Lorsque vous chargez une police à partir d'un fichier de cette manière, la taille de la police est en pixels et les première et dernière valeurs sont ignorées, ce qui signifie que tous les glyphes de la police seront ajoutés. Les polices ajoutées de cette manière sont affectées à leur propre page de texture, il faut donc prendre soin d'utiliser cette fonction car elle incrémentera le nombre de swaps de texture lors du dessin. Il est également à noter que les polices peuvent apparaître légèrement plus grandes lorsqu'elles sont dessinées, car les glyphes peuvent avoir des parties qui sont dessinées à l'extérieur de la boîte de délimitation définie pour la police. Vous devez également savoir qu'il existe une limite d'environ 200 glyphes pouvant être rendus dans une seule image pour une police particulière.

REMARQUE: lorsque vous chargez une police dans GameMaker Studio 2: Studio, n'oubliez pas de la supprimer font_delete ) lorsqu'il n'est plus nécessaire, sinon il y a un risque de fuite de mémoire qui ralentira et finira par planter votre jeu.


Syntaxe:

font_add(name, size, bold, italic, first, last);


Argument La description
name Le nom de la police à ajouter (par exemple 'Arial'), ou le chemin du fichier si la police est incluse *.ttf fichier.
size La taille de la police - points pour les polices Web, pixels pour *.ttf polices.
bold Si la police est en gras (vrai) ou non (faux).
italics Si la police est en italique (vrai) ou non (faux).
first Le premier personnage à inclure (si vous n'êtes pas sûr, optez pour 32).
last Le dernier caractère à inclure (si vous n'êtes pas sûr, optez pour 128).


Résultats:

Real


Exemple:

newfont = font_add( 'Arial', 24, true, true, 32, 128);

Cela va créer une nouvelle police de taille 24pt, utilise "Arial" qui est en gras et en italique et l'index de cette nouvelle police est stocké dans la variable "newfont". La plage de polices inclut majuscules et minuscules, chiffres et toute ponctuation courante.