MANUEL DE REFERENCE PHIGURE C - GRADUATIONS DAXES LOG

GRADUATIONS DAXES LOG

tset_axis_log_grad

SEQUENCE D'APPEL

void tset_axis_log_grad (strid, pow10_grad_rep, sub_grad_rep, sub_grad_ht)

PARAMETRES EN ENTREE

Pint 	strid;
Tlog_pow10_grad_rep	pow10_grad_rep;
Tlog_sub_grad_rep	sub_grad_rep;
Pfloat	sub_grad_ht;

ARGUMENTS

strid: Identificateur de structure.
pow10_grad_rep: Type de présentation des graduations puissances de 10
sub_grad_rep: Type de présentation des sous graduations entre 2 puissances de 10
sub_grad_ht: Hauteur des sous graduations dans l'espace normalisé [0-1] ×× [0-1]
: (× [0-1]). Si sub_grad_ht <= 0, la hauteur est fixée à 0.025 à condition que les textes des sous graduations ne se chevauchent pas.

TYPES

typedef enum {
	TLOG_POW10_GRAD_10POW,
	TLOG_POW10_GRAD_DECIMAL,
	TLOG_POW10_GRAD_AUTO
} Tlog_pow10_grad_rep;

typedef enum {
	TLOG_SUB_GRAD_NONE,
	TLOG_SUB_GRAD_AS_POW10,
	TLOG_SUB_GRAD_DECIMAL,
	TLOG_SUB_GRAD_DIGIT,
	TLOG_SUB_GRAD_AUTO
} Tlog_sub_grad_rep;

EFFET

Cette fonction positionne les attributs de représentation des graduations d'un axe logarithmique (ou polaire logarithmique) d'identificateur strid. On distingue deux types de graduations sur un axe logarithmique : les graduations des puissances de 10 et les sous graduations. Ces dernières materialisent un multiple entier des puissances de 10 de l'axe. (La liste de ces entiers est spécifiée en dernier paramètre des fonctions de création d'un axe logarithmique).

pow10_grad_rep permet de spécifier la façon d'annoter les graduations puissances de 10. Selon cette valeur :

TLOG_POW10_GRAD_10POW représentation sous forme de puissance : exemple 10⁴ ou 10^-2

TLOG_POW10_GRAD_DECIMAL sous forme décimale : exemple 10000 ou 0.01

TLOG_POW10_GRAD_AUTO sous une forme décimale ou puissance selon l'intervalle de l'axe

sub_grad_rep permet de spécifier la façon d'annoter les sous graduations entre deux puissances de 10. Selon la valeur de sub_grad_rep :

TLOG_SUB_GRAD_AS_POW10 les sous graduations sont représentées comme les graduations puissance de 10. Les textes de ces sous graduations ont la même hauteur que les textes des puissance de 10

TLOG_SUB_GRAD_NONE aucun texte n'est affiché aux sous graduations. Seuls les tirets apparaissent entre deux graduations puissance de 10

TLOG_SUB_GRAD_DECIMAL les sous graduations sont représentées sous forme décimale : exemple 300 ou 0.03 ou 50000

TLOG_SUB_GRAD_DIGIT les sous graduations sont représentés par un chiffre compris entre 2 et 9 indiquant le multiple de la puissance de 10

TLOG_SUB_GRAD_AUTO mode automatique, une des 3 formes précédentes est utilisée selon l'intervalle de l'axe

Si sub_grad_rep = TLOG_SUB_GRAD_AS_POW10 les sous graduations sont considérées comme les graduations des puissances de 10 :

- sub_grad_ht n'est pas pris en compte

- le type de représentation des sous graduations est défini par pow10_grad_rep

Sinon

- les textes des sous graduations ont pour hauteur sub_grad_height

- leur représentation est celle donnée par sub_grad_rep

Les graduations des puissances de 10 et les sous graduations possédent un type de représentation automatique.

Dans ce cas, une représentation est choisie selon l'intervalle de l'axe, de sorte que les graduations soit lisibles.

Par exemple si sub_grad_rep = TLOG_SUB_GRAD_AUTO et que l'intervalle de l'axe est grand, la représentation sous forme chiffre multiple de la puissance 10, sera préférée à la représentation sous forme décimale; par contre ce sera l'inverse si l'intervalle est petit.

De plus, on rappelle que si le pointeur sub_grad_list est nul, (le dernier paramètre des fonctions d'axe log), celles ci calculeront automatiquement une liste de sous graduations selon l'intervalle de l'axe.

Exemples :

sub_grad_rep = TLOG_SUB_GRAD_DIGIT

pow10_grad_rep = TLOG_POW10_GRAD_10POW

sub_grad_rep = TLOG_SUB_GRAD_DECIMAL

pow10_grad_rep = TLOG_POW10_GRAD_10POW

sub_grad_rep = TLOG_SUB_GRAD_DECIMAL

pow10_grad_rep = TLOG_POW10_GRAD_DECIMAL

sub_grad_rep = TLOG_SUB_GRAD_AS_POW10

pow10_grad_rep = TLOG_POW10_GRAD_DECIMAL