forked from halo-battle/game
121 lines
4.6 KiB
Plaintext
121 lines
4.6 KiB
Plaintext
|
I. Installation
|
||
|
II. Configuration
|
||
|
III. Utilisation
|
||
|
IV. Divers
|
||
|
|
||
|
|
||
|
I. Installation
|
||
|
------------
|
||
|
|
||
|
*** Première installation ***
|
||
|
|
||
|
L'installation de Artichow se résume à décompresser l'archive dans le dossier
|
||
|
de votre choix sur votre serveur. Veillez simplement à télécharger l'archive
|
||
|
dont vous avez vraiment besoin (PHP 5 ou PHP 4 & 5).
|
||
|
Notez que Artichow requiert GD 2 et PHP 4.3.0 au minimum pour fonctionner.
|
||
|
|
||
|
*** Mise à jour ***
|
||
|
|
||
|
Lorsque vous souhaitez mettre à jour Artichow avec la dernière version,
|
||
|
essayez de suivre pas à pas ces étapes :
|
||
|
1) Décompressez la dernière version de Artichow dans un dossier
|
||
|
2) Ecrasez le fichier Artichow.cfg.php avec votre ancien fichier
|
||
|
3) Copiez vos patterns dans le dossier patterns/ de la nouvelle version
|
||
|
4) Supprimez l'ancienne version de Artichow de votre disque
|
||
|
5) Copiez la nouvelle version là où était l'ancienne
|
||
|
Une fois ces cinq étapes effectuées, vous n'aurez plus qu'à mettre
|
||
|
éventuellement à jour vos graphiques, en fonction des dernières évolutions de
|
||
|
l'API de Artichow. Pour cela, voyez le titre "Migrer d'une version à l'autre"
|
||
|
sur la page :
|
||
|
http://www.artichow.org/documentation
|
||
|
|
||
|
II. Configuration
|
||
|
-------------
|
||
|
|
||
|
Même si une utilisation normale de Artichow ne nécessite pas de configuration
|
||
|
particulière, il existe un fichier Artichow.cfg.php qui permet de modifier
|
||
|
quelques paramètres de la librairie.
|
||
|
Vous pouvez notamment configurer le répertoire vers les polices de caractère
|
||
|
en modifiant la constante ARTICHOW_FONT (par exemple en choisissant
|
||
|
'c:\Windows\font' si vous êtes sous Windows).
|
||
|
Vous pouvez également redéfinir la variable $fonts. Cette variable contient une
|
||
|
liste de polices TTF (sans l'extension) présentes dans votre répertoire
|
||
|
ARTICHOW_FONT. Pour toutes les polices de cette liste, une classe du même nom
|
||
|
est créée. Les polices ainsi définies peuvent ensuite être utilisées de cette
|
||
|
manière :
|
||
|
<?php
|
||
|
$font = new Verdana(12); // 12 représente la taille en points
|
||
|
?>
|
||
|
Il existe également une constante ARTICHOW_DEPRECATED. Si cette constante vaut
|
||
|
TRUE, alors un message d'erreur sera affiché lorsque vous utiliserez une
|
||
|
fonctionnalité dépréciée de Artichow. A l'inverse, avec la valeur FALSE,
|
||
|
vous pourrez continuer à utiliser les fonctions dépréciées sans soucis.
|
||
|
Cependant, dans un souci de compatibilité, il est préférable de mettre à
|
||
|
jour vos graphiques dès lors qu'un message de ce type apparaît (et donc de
|
||
|
laisser la constante à TRUE). Les fonctionnalités dépréciées sont toujours
|
||
|
potentiellement susceptibles de disparaître d'une version à l'autre de la
|
||
|
librairie.
|
||
|
La constante ARTICHOW_PREFIX est vide par défaut et correspond à un préfixe qui
|
||
|
est ajouté au nom de chaque classe utilisée sur Artichow. Certains noms de
|
||
|
classe (Graph, Image, Text, Font, etc.) sont utilisés par d'autres librairies
|
||
|
et cela peut aboutir à des conflits. Pour résoudre ce problème, choisissez par
|
||
|
exemple 'xyz' comme préfixe et toutes les classes de Artichow s'appèleront
|
||
|
désormais xyz[Nom normal]. Exemple d'utilisation de Artichow avec
|
||
|
ARTICHOW_PREFIX à 'xyz' :
|
||
|
<?php
|
||
|
require_once "Artichow/LinePlot.class.php";
|
||
|
|
||
|
$plot = new xyzLinePlot(array(1, 2, 3));
|
||
|
$plot->title->set('Mon graphique');
|
||
|
$plot->title->setFont(new xyzFont4);
|
||
|
|
||
|
$graph = new xyzGraph(400, 300);
|
||
|
$graph->add($plot);
|
||
|
$graph->draw();
|
||
|
?>
|
||
|
|
||
|
|
||
|
III. Utilisation
|
||
|
-----------
|
||
|
|
||
|
Si vous utilisez la version conçue exclusivement pour PHP 5, vous pouvez vous
|
||
|
référer aux exemples et aux tutoriels afin de bien prendre en main la
|
||
|
librairie.
|
||
|
Si vous utilisez la version pour PHP 4 & 5, référez vous également aux exemples
|
||
|
et tutoriels mais faîtes attention lors de l'inclusion des fichiers de
|
||
|
Artichow. N'incluez pas les fichiers de cette manière :
|
||
|
<?php
|
||
|
// Ceci ne fonctionnera pas
|
||
|
require_once "Artichow/php5/LinePlot.class.php";
|
||
|
// Cela non plus
|
||
|
require_once "Artichow/php4/LinePlot.class.php";
|
||
|
?>
|
||
|
Préférez plutôt :
|
||
|
<?php
|
||
|
// Fonctionnera correctement
|
||
|
require_once "Artichow/LinePlot.class.php";
|
||
|
?>
|
||
|
C'est la librairie qui se charge de sélectionner les bons fichiers en fonction
|
||
|
de la version de PHP dont vous disposez.
|
||
|
|
||
|
IV. Divers
|
||
|
------
|
||
|
|
||
|
La documentation de Artichow est disponible sur :
|
||
|
http://www.artichow.org/documentation
|
||
|
|
||
|
Des tutoriels sont accessibles sur :
|
||
|
http://www.artichow.org/tutorial
|
||
|
|
||
|
Un forum de support peut être trouvé sur :
|
||
|
http://www.artichow.org/forum/
|
||
|
|
||
|
N'oubliez pas que Artichow est dans le domaine public. Vous pouvez donc faire
|
||
|
CE QUE VOUS SOUHAITEZ avec cette librairie, y compris ajouter votre nom dans
|
||
|
chaque fichier, et la redistribuer ainsi.
|
||
|
|
||
|
Si vous souhaitez aider et participer au développement de Artichow, n'hésitez
|
||
|
pas à consulter cette page :
|
||
|
http://www.artichow.org/help
|
||
|
|