Nous allons créer un graphique fait de 3 rangées de 3 plans chacune et
en faire la sortie au format AegisDraw2000.
La première étape est la création des donnés. Pour se faire, utiliser
votre éditeur de texte préféré. Il est important de noter que celui-ci doit
pouvoir produire un fichier exant de tout caractère spéciaux d'édition qui
ne seraient pas reconnus par JcGraph (ASCII international).
Après avoir chargé votre éditeur, entrer tout de suite "1002," (les
guillemets n'étant que des délimiteurs, ne les incluez pas. Cette séquence
permet à JcGraph d'identifier le fichier comme étant bel et bien un fichier
de donné qui lui est compréhensible. Toutes les entrée doivent-êtres
séparées par des virgules.
Ensuite, entrez le nombre de colonnes de donnés que contiendra votre
fichier, dans notre exemple "3". Faites la même chose pour le nombre de
lignes. Ensuite, vient un chiffre qui sert à déterminer l'espace séparant
chaque cote de l'échelle des valeurs; par exemple, si vos donnés varient
entre 0 à 100, une entrée de 25 résulterait en une échelle de cotes
contenant les valeurs "0","25","50","75" et "100". Ce chiffre utilise la
même unité de mesure que les donnés elle même. Le chiffre qui suivra
indiquera (par un nombre en virgule flottante), la valeur par laquelle
chaque cotes doit être multiplié; par exemple, si vous entrer "1.24",
chaque cote sera multipliée par 1.24. Ceci permet d'avoir accès à des
valeurs en virgule flottante sans changer la représentation des donnés.
Notez que seulement 3 décimales sont conservées après le point pour
l'instant et qu'une valeur de 0 permet l'affichage des cotes sous la forme
entière (ie pas de point décimal).
Par la suite, vous entrez les valeurs de vos donnés. Dans l'exemple,
nous avons décidé de produire un graphique de 3 lignes par 3 colonnes, il y
aura donc, 9 valeurs consécutives (Nb elles peuvent-être sur la même ligne
si vous le désirez).
Les trois valeurs qui suivent sont des textes qui seront les
identificateurs de vos colonnes (3 colonnes = toujours 3 identificateurs,
même s'ils sont vides). Même procédure pour les 3 lignes avec trois nouveaux
textes qui représenteront cette fois le type de produit de la ligne. Il est
à noter que l'orientation est toujours la même: des ensembles de valeurs
différentes sont sur des lignes différentes alors que leur variation est
représenté en colonne.
Voici le résultat de l'exemple créé:
1002,
3,3,10,0,
10,20,30,
50,60,60,
15,32,17,
Jan,Fev,Mar,
Gaz,Oil,Fer,
Sauvegarder ce résultat sous le nom "test3X3.asc".
La seconde étape consiste à charger les donnés. Pour se faire, charger
JcGraph en mémoire. Il est à noter qu'une fois JcGraph démarré, il peut
s'écouler 3 à 5 secondes avant que les fenêtres de contrôle apparaissent,
ceci est normal.
Maintenant, allez choisir l'option "Open..." sous le menu "Project" (Ou
tenez simplement enfoncé les touches Amiga de droite et "O" simultanément.
IMPORTANT: Il est à noter que JcGraph n'accèpte les commandes que depuis
la fenêtre d'interface (celle avec les différents boutons), il est donc
nécéssaire de la sélectionner (si ce n'est déja fait) avant de tenter
d'exécuter quelqu'opération que ce soit qui nécéssite le travail sur le
graphique en cours. Il faut aussi noter qui la fenêtre d'interface affiche
la mention "No Data" dans sa barre titre lorsqu'aucune donné n'a été chargée
en mémoire.
Une boîte de requête de fichier ayant la mention "Choose an ASCII data
file" apparaitra alors à votre écran. Son utilisation n'est pas décrite ici
mais vous pouvez retrouvez cette information en appuyant la touche HELP ou
SHIFT-F1 lorsqu'elle est active.
Retrouvez et selectionnez le fichier "test3X3.asc" et selectionnez
ensuite l'option "Open" au bas de la fenêtre. Le pointeur de la souris ce
transformera alors en horlgoge pendant le chargement. Après un temps très
court, il reviendra à son état inital, vous indiquant ainsi que les donnés
ont été correctement chargées (La barre de titre de la fenêtre d'interface
devrait alors indiquer le nom de votre fichier).
La fenêtre titrée "Preview" nous donnes un apperçu en fil de fer de ce
que sera notre graphique une fois terminé. Bien entendu, la version finale
ne sera pas transparente mais pour fin de rapidité d'affichage, cette
représentation est nécéssaire.
Comme vous pouvez le constater dans la fenêtre "Preview", le type de
graphique par défaut représente les donnés sous forme de blocs
tri-dimensionnels. Choisissons donc maintenant un type de graphique
différent pour illustrer le processus de changement de type. Allez choisir
l'option "Load..." sous le menu "GraphType" (Amiga+T). Un autre sélecteur
de fichier apparaîtra à l'écran. Si tout va bien, une liste de fichier se
terminant par l'extension ".grf" devrait être affichée à l'écran. Si aucune
entrée selectionnable n'apparait dans la fenêtre, vous avez probablement
fait une erreur en installant JcGraph, référez vous alors à la section 2.
Vous pouvez alors choisir le type de graphique qui vous convient. Pour
fin d'exemple, selectionnez le fichier "3D_BrokenPlanes.grf" et poussez
ensuite le bouton "Load". Après un petit moment d'attente, la fenêtre
titrée "Preview" devrait affiché un graphique fait de plans
tri-dimmensionnel.
La perspective actuelle de l'image ne permet pas très bien d'apprécier
l'effet 3D de la représentation graphique. Pour l'améliorer, nous
utiliserons une des fonctions les plus puissantes de JcGraph, la rotation.
Regardez maintenant dans la fenêtre d'interface; elle est divisée en 2
sections importante:
1.à gauche, il y a deux boutons annotés "Undo" et "Render". Nous y
reviendrons plus loin.
2.à droite, il y a 4 rangées de boutons, celles-ci contrôlent les valeurs
de rotation de perspective de la représentation de votre graphique.
Rangée 1: Rotation autour de l'axe des X.
Rangée 2: Rotation autour de l'axe des Y.
Rangée 3: Rotation autour de l'axe des Z.
Rangée 4: Contrôle de la perspective.
Pour fin d'exemple, nous ne nous étendrons pas plus sur ces
fonctionnalités pour le moment (qui sont décrites dans la section 5). Pour
le moment, selectionnez simplement le cadre dans lequel est écrit le chiffre
0 à la rangée 1. Entrez au clavier la valeur "-30". Appuyez sur la touche
"Return". Sélectionnez ensuite le chiffre 0 à la rangée 2. Entrez au clavier
la valeur "30". Appuyez sur la touche "Return". Vous pouvez dès maintenant
voir dans la fenêtre "Preview", les changement effectués à la représentation
de votre graphique. L'effet produit est beaucoup plus dynamique.
Maintenant, vous pourriez désirer admirer le résultat final. Vous n'avez
qu'à appuyer sur le bouton "Render" (Rendu final) de la fenêtre d'interface.
Le pointeur se transformera en horloge plus longtemps cette fois-ci.
Lorsqu'il reviendra à son état normal, ce sera l'indication que le graphique
est prêt. Il se peut que la fenêtre titré "Preview" obscurcisse celle titré
"Output Window" (qui contient le résultat final). Ecartez la simplement de
votre vue. Mais n'oubliez pas de re-selectionnez la fenêtre d'interface si
vous devez faire d'autre manipulation sur le graphe.
Vous contaterez alors probablement 3 choses:
1. C'est joli (je l'espère :-)
2. C'est trop petit.
3. Les couleurs ne vous conviennent pas.
Règlons les problèmes un par un.
1. C'est joli : Ce n'est pas un problème !!!
2. C'est trop petit: Vous n'avez qu'a "tirez" le bouton en bas, à droite
de la fenêtre titrée "Output Window" et changez sa taille pour celle qui
vous convient. Par la suite, refaites "Render". Voilà!
3. Les couleurs ne vous conviennent pas: C'est la prochaine étape!
L'étape suivante est le choix des couleurs:
Choisissez l'option "Color..." (Amiga+K) sous le menu "Edit". Une boite de
dialogue vous apparaîtra, titré "Data color selector". A gauche, vous verrez
la représentation de toutes les couleurs disponibles alors qu'à droite, vous
avez les ensembles de données à colorer. Vous reconnaitrez dans cette dernière,
les textes associés à chacunes de vos lignes. Il y à aussi deux entrées
supplémentaires nommées "Background" et "Floor" permmetant respectivement de
changer la couleur du fond et du plancher (comparer avec le résultat final et
vous comprendrez mieux). Selectionnez "Floor". Un rectangle blanc encadrant
la couleur et le texte devrait vous indiquer qu'il a bien été choisit. Par,
la suite, sélectionnez une couleur de votre choix dans l'ensemble des
couleur à gauche. La couleur immédiatement à gauche de l'inscription "Floor"
devrait changer , indiquant que votre selection à été retenu. Faites de même
jusqu'à ce que les couleurs vous conviennent. Lorsque vous aurez terminé,
poussez le bouton en haut à gauche de la fenêtre, ceci validera vos entrées.
Pour voir le résultat, refaites "Render".
La dernière étape consiste à sauvegarder le fichier au format
"AegisDraw2000". Pour se faire, choisissez l'option "Draw2000" du sous-menu
"Format..." du menu "Project" (Amiga+4). Par la suite, choisissez l'option
"Save as..." du menu "Project" (Amiga+A) qui appelera un selecteur de
fichier. Entrez un nom au clavier, appuyez sur "Return", et voilà!
Après quelques temps, le fichier devrait être sauvegardé et maintenant
disponible pour utilisation ultérieure.
Pour plus de détail sur les fonctions particulières de JCGraph,
consultez la section 4.
4.Sommaire des options de menu.
-------------------------------
PROJECT
About... :Information sur JcGraph.
Open... :Ouvre un fichier texte de données (Desciption à la section 6).
Save :Sauvegarde le graphique au format spécifié par "Format" sans requête de nom.
Save as... :Sauvegarde le graphique au format spécifié par "Format" en
recquérant le nom de fichier.
Format :Selectionne le format de fichier en sortie: voir section 7.
Print... :Permet l'impression du résultat final à l'imprimante.
Vous aurez la possibilité de canceler une seule fois avant
l'impression, si vous choisissez "Print", l'impression se
fera complètement.
Quit... :Quitte JcGraph...
EDIT
Undo :Permet d'annuler la dernière rotation effectuée.
Copy :Pas encore implantée.
Color :Permet la selection des couleurs.
Le bouton cyclique permet d'alterner entre les positions
couleur et tons de gris, cette dernière donnant un aperçu du
résultat à l'imprimante.
TEMPLATE
Load... :Charge un fichier "Template" qui contient:
-le type de graphique.
-les positions de rotation.
-la perspective.
Save... :Sauvegarde un fichier "Template".
GRAPHTYPE
Load... :Charge un nouveau type de graphique 2D ou 3D.
ENVIRONMENT
Iconify :Pas encore implanté.
Notes... :Permet de laisser un commentaire sur un sujet qui vous est important. Si vous enfoncer l'icônes de gauche. Le message
laissé vous sera rappelé avant de quitter.
Arrange :Organise logiquement les fenêtre à l'écran.
HELP
General... :Activera le système d'aide générale.
On Help... :Activera le système d'aide sur l'aide.
Start Help :Permet d'avoir de l'aide spécifique. Vous n'aurez par la suite
qu'à selectionner un bouton ou une option de menu et vous
obtiendrai de l'aide spécifique à cet item. Pour stopper, re-selectionner cette option (qui s'appellera maintenant
Stop Helper).
5.Fenêtre de l'interface.
-------------------------
Vous pouvez la reconnaitre au fait qu'elle contient tout les
bouton-poussoirs qui controllent l'apparence de graphique.
Prenons chaque "Gadget" (nous parlerons plutot de "gadget", terme emprunté
de l'Anglais traduisant plus ou moins la notion de "Bouton-poussoir" ) en
débutant par le haut:
1. La première ligne de "gadgets" contient (en partant de la droite);
l'identificateur de rotation, 'X' dans le cas présent, un gadget
"glissière" permettant de déterminer la valeur de la rotation autour de
l'axe des 'X', et un gadget permmetant l'entrée numérique de la valeur de
rotation 'X'. La modification de l'un ou l'autre de ces "gadget" entraine
automatiquement une modification de l'apparence du graphique dans la
fenêtre titrée "Preview".
2. et 3. La même chose pour l'axe des 'Y' et 'Z' respectivement.
4. Le gadget à glissière nommé "Perspective" permet , comme son nom
l'indique, de changer la perspective du graphique; plus la glissière
(le bouton en forme de flêche) sera tiré vers la gauche, plus la perspective
deformera le graphique alors que la tirer vers la droite donnera un effet
plus orthogonal.Il est à noter que cet effet n'est que visuel et n'est donc
pas conservé lors d'une sauvegarde au type "3D GEO".
5. Le gadget titré "Undo" permet d'annuler la dernière rotation effectué.
L'option de menu "Undo" (Amiga+Z) effectue la même tâche.
6. Le gadget titré "Render" permet de visualiser le résultat final des
modifications appliqués.
6.Format de fichier en entrée de JcGraph.
-----------------------------------------
Pour l'instant, JcGraph accepte uniquement son propre format de fichier. Selon la réponse (le nombre d'enregistrement et les suggestions), je verrai s'il vaut la peine de faire des filtres d'importation et/ou une interface d'entrée de donnés.
JcGraph est le premier programme important que je réalise sur Amiga et
malgré l'attention que j'ai porté à sa réalisation, certaines facilitées
n'ont pu etre implantés, faute de temps et d'argent. Etant étudiant à temps
plein à l'Université, j'ai eu très peu de temps à consacrer à sa réalisation et ainsi, j'ai décidé de prévilégier la qualité de ce qui serait présenté plutôt que la quantité. Toutefois, si l'effort que j'ai pu mettre dans la réalisation de JcGraph se réflètait dans un nombre d'enregistrement assez important, j'envisagerais d'ajouter certaines fonctionnalités majeures à mon logiciel. Ci-suis la liste des améliorations immédiatemment prévue pour JcGraph:
-Passage au Gadtools et iffparse.library.
-Filtre d'import ProCalc, Advantage, MaxiPlan...
-Support complet d'ARexx avec scripts permettants d'animer directement avec
le Video-Toaster. HotLink avec ADPro, PageStream
-Support du protocole HotLink de Soft-Logik.
-Support complet des règles énnoncées dans le livre de référence "Amiga
Interface Style Guide" de Commodore.
-Création de fichier IFF DR2D en sortie.
-Support des fontes de caractères Compugraphics.
Je tiens toutefois a spécifier que toute suggestion ou commentaire
constructif est bienvenue et sera tenu en compte individuellement pour
l'ajout éventuel dans une future révision de JcGraph. Tous les commentaires
ou suggestions peuvent êtres envoyés par la poste à:
Jean-Christophe Clément
921, rang 3
St-Simon
Québec, CANADA
J0H-1Y0
12.Histoire de JcGraph:
------------------------
23 avril 1992:(v0.90)
-Sortie officiel du premier Beta.
-Pas complètement à mon goût mais veux d'abord voir la réponse
des utilisateurs pour évaluer l'énergie à investir dans les
