| |
Class Axis
La classe Axis permet de manipuler des axes.
Un axe permet à un utilisateur de répérer les points et leurs valeurs sur un graphique.
De nombreuses méthodes de la classe Axis ne sont pas documentées,
car elles ne sont utilisées qu'en interne par Artichow.
Néanmoins, si vous développez Artichow, vous aurez besoin de ces méthodes.
N'hésitez donc pas à parcourir le code source de cette classe.
Méthodes et propriétésDocumentation
-
public Label $title
Représente le titre de l'axe.
-
public Label $label
Représente les étiquettes qui portent les valeurs affichées sur l'axe.
-
public Line $line
Représente la ligne de l'axe.
Vous pouvez modifier le style et l'épaisseur de cette ligne, pas ses coordonnées.
-
protected bool $auto
Précise si la gestion de l'axe doit être automatique ou non.
-
public __construct(float $min, float $max)
Déclare un nouvel axe.
Les variables $min et $max représentent respectivement la valeurs minimales et maximales associées à l'axe.
Par exemple, choisir $min = -12 et $max = 42 signifie tout simplement que l'axe ira de -12 à 42.
-
public auto(bool $auto)
-
public true isAuto()
Retourne TRUE si l'axe est gérée automatiquement, FALSE sinon.
-
public hide(bool $hide := TRUE)
Cache ou non l'axe. Le paramètre $hide est par défaut à TRUE (ce qui signifie que l'axe ne sera pas dessiné).
S'il est mis à FALSE, l'axe sera dessiné.
-
public addTick(string $name, Tick $tick)
Associe un objet Tick $tick à l'axe.
Cet objet sera reconnu par le nom $name au sein de la classe Axis.
-
public Tick tick(string $name)
Récupère un objet Tick en fonction de son nom.
Cet objet doit avoir été précédemment ajouté avec la méthode Axis::addTick().
-
public deleteTick(string $name)
Supprime l'objet Tick de nom $name associé à l'axe.
Pour pouvoir être supprimé, cet objet doit avoir été précédemment ajouté avec la méthode Axis::addTick().
-
public hideTicks(bool $hide := TRUE)
Cache ou non tous les ticks qui ont été associés à cet axe.
-
public setTickStyle(int $style)
Change le style de tous les ticks associés à l'axe pour $style.
-
public reverseTickStyle()
Inverse le style de tous les ticks associés à l'axe pour $style.
Si les ticks étaient tournés vers l'extérieur, ils seront désormais tournés vers l'intérieur.
Et vice-versa.
-
public setTickInterval(int $interval)
Change l'intervalle d'affichage de tous les ticks associés à l'axe pour $interval.
Cette méthode permet d'espacer l'affichage des ticks par rapport aux valeurs de l'axe.
-
public setNumberByTick(string $to, string $from, float $number)
Cette méthode permet de modifier la fréquence d'affichage d'un objet Tick par rapport à un autre.
$to représente l'objet dont la fréquence d'affichage doit être modifiée et $from l'objet auquel on se réfère.
A chaque fois qu'un tick $from sera affiché, on affichera $number ticks $to.
Si $number vaut 2, cela signifie que deux ticks $to seront affichés pour un tick $from.
Cette méthode prend tout son sens donc le cadre des Plot par exemple :
<?php
require_once 'LinePlot.class.php';
$graph = new Graph(400, 400);
$plot = new LinePlot(array(1, 2, 3));
// Pour chaque tick major affiché,
// on affichera 10 ticks minor
$plot->xAxis->setNumberByTick('minor', 'major', 10);
$graph->add($plot);
$graph->draw();
?>
Cela donne 10 ticks mineurs par tick majeur :
-
public setLabelInterval(int $interval)
Change l'intervalle d'affichage des étiquettes sur l'axe pour $interval.
Par défaut, cet intervalle est égal à 1.
-
public setLabelNumber(int $number)
Change le nombre d'étiquettes à afficher sur l'axe pour $number.
-
public int getLabelNumber()
Retourne le nombre d'étiquettes qui seront affichées sur l'axe.
-
public setLabelPrecision(int $precision)
Change la précision des valeurs affichées sur chaque étiquette de l'axe.
$number représente le nombre de chiffres après la virgule qui doivent être affiché.
Par défaut, $precision vaut 0.
-
public setLabelText(array $texts)
Cette méthode permet d'afficher des valeurs arbitraires plutôt que des valeurs numériques sur les étiquettes de l'axe.
$texts est un tableau comportant autant d'entrées que d'étiquettes et qui contient les nouvelles valeurs à afficher.
-
public setTitleAlignment(int $alignment)
-
public setTitlePosition(float $postion)
Change la position du titre sur l'axe.
$position est une fraction de la taille de l'axe.
Par exemple, si $position est placé à 0.5, le titre sera affiché au milieu de l'axe.
Si $position vaut 0.25, alors le titre sera affiché sur le premier quart de l'axe.
Pour aligner le titre par rapport à cette position, utilisez la méthode Axis::setTitleAlignment().
-
public setColor(Color $color)
Change la couleur de l'axe et de son titre pour $color.
-
public setPadding(int $left, int $right)
Change l'espace interne à gauche et à droite de l'axe.
Gauche et droite n'ont de sens que pour les axes verticaux.
Pour les axes plus horizontaux, préférez haut à gauche et bas à droite.
-
public Side getPadding()
Retourne l'espace interne associé à l'axe.
|
|
