LibGraph

Synopsis

Cette librairie permet la creation de graphiques sous PHP3. Elle est constituée d'un ensemble de classes permettant le tracage de courbes, histogrammes, aires, camemberts.

Afficher sommaire

	include "cls_Pie.php3";
	$p= new Pie( 300, 100 );
	$values= array( 56, 24, 6, 14 );
	$legends= array( "Apache", "IIS", "Netscape", "Others" );
	$p->Draw( $values, $legends );
	$p->Save( "pie.gif" );
	$p->SaveLegend( "pie_legend.gif" );

Installation

Télécharger libgraph.zip

Contenu :

• cls_Area.php3 : la classe gerant les aires.
• cls_Bar3D.php3 : la classe gerant les histogrammes.
• cls_Curve.php3 : la classe gerant les courbes.
• cls_Pie.php3 : la classe gerant les camemberts.
• cls_Graphik.php3 : la classe matrice héritée par les autres classes.
• libgraph.html : documentation au format HTML

Configuration

La librairie GD de PHP doit etre fonctionnelle.

Dans cls_Graphik.php3 , $fontpath est le repertoire des polices de caractères. le / final ne doit pas etre omis.

	var $fontpath= "C:/WinNT/Fonts/"; // Exemple sous Win32
	var $fontpath= "/usr/share/fonts/ttf/"; // Exemple sous Unix

Documentation

Constructeur

Creation de l'instance de graphique

new Object( width, height )

• Object : nom de l'objet graphique (Area, Curve...)
• width : largeur de l'image générée en pixels
• height : hauteur de l'image générée en pixels

	$p= new Pie( 300, 140 );
	$a= new Area( 600, 100 );
	$c= new Curve( 400, 200 );
	$b= new Bar3D( 500, 200 );

Draw

Tracé du graphique, et construction éventuelle de la légende. La légende est générée uniquement si le paramètre legend est présent. Il faut ensuite l'enregistrer, cf SaveLegend.

Draw( data, [legend] )

• data : valeurs a tracer. son contenu depend du type de graphique.
• legend : texte pour la legende de cette serie de donnée.

	$curve->Draw( $data );
	$pie->Draw( $data, $legend );

Save

Enregistre le graphique dans une image GIF

Save( filename )

• filename : nom du fichier avec l'extension

	$o->Save( "mypie.gif" );

SaveLegend

Enregistre la legende générée dans une image GIF

SaveLegend( filename )

• filename : nom du fichier avec l'extension

	$o->SaveLegend( "legends/mypie.gif" )

setFont

Definit la police de caractère a utiliser pour la légende. L'appel est optionel, les paramètres par défaut étant ( Arial,10 ). Ne pas oublier de configurer le chemin des polices de caractères.

setFont( font, [fontsize] )

• font : nom de la police de caractère
• fontsize : taille de la police en pixel. par defaut 10

	$o->setFont( "Arial", 12 );

setBgColor

Definit la couleur de fond du graphique. Appel optionnel, la couleur par defaut est le blanc (255:255:255).

setBgColor( array rgb )

• rgb : tableau contenant les composantes rouge/vert/bleu de la couleur. chaque composante est un entier compris entre 0 et 255.

	$o->setBgColor( array( 200, 100, 50 ) );

setFgColor

Definit la couleur d'avant plan du graphique. Cette couleur est utilisée pour la légende, le cadre et les graduations... Appel optionnel, la couleur par defaut est un gris foncé (160:160:160).

setFgColor( array rgb )

• rgb : tableau des composantes rouge/vert/bleu de la couleur. chaque composante est un entier compris entre 0 et 255.

	$col= array( 0, 120,120 );
	$o->setFgColor( $col );

setViewPort

Definit le viewport du graphique. Le Viewport est la fenetre que represente le graphique dans le domaine représenté. Il est defini par les coordonnées de ses points extrèmes minimal ( en bas à droite ) et maximal ( en haut à gauche ). n'est pas utilisé par l'objet Pie.

setViewPort( Xmin, Ymin, Xmax, Ymax )

• Xmin, Xmax : valeurs minimales et maximales de l'axe des X
• Ymin, Ymax : valeurs minimales et maximales de l'axe des Y

	$o->setViewPort( 0, 0, 100, 40 );

setScale

Definit l'intervalle des graduations verticales (Xscale) et horizontales ( Yscale) pour ne definir qu'une des grduation, il suffit de laisser l'autre paramètre vide ( "" ).

Appel optionnel, par defaut le graphique ne comporte pas de graduations non utilisé par l'objet Pie

setScale( Xscale, Yscale )

• Xscale : valeur de la graduation des X
• Yscale : valeur de la graduation des Y

	$o->setScale( 2, 10 ); // graduation des X tous les 2 , des Y tous les 10
	$o->setScale( 2, "" ); // graduation verticale seulement
	$o->setScale( "", 10 ); // graduation horizontale seulement

setShade

Defini la profondeur en pixel de l'effet 3D. Appel optionnel, valeur par defaut = 3 Utilisable pour les objets 3D ( Bar3D, Pie, Area )

setShade( depth )

• depth : profondeur de l'effet en pixel

	$o->setShade( 4 );

Statut

Sommaire

1. LibGraph
1. Synopsis
2. Installation
1. Configuration
3. Documentation
1. Constructeur
2. Draw
3. Save
4. SaveLegend
5. setFont
6. setBgColor
7. setFgColor
8. setViewPort
9. setScale
10. setShade
4. Statut
5. Sommaire