@database ???? @master ???? @width 80 @width 76 @node Main "Table des matières" ============================================================================ AGraph 36.0 Copyright (C) 1995 par Denis GOUNELLE ============================================================================ Toute utilisation commerciale ou vente sans autorisation écrite est strictement interdite. Vous pouvez copier et diffuser ce programme aux conditions suivantes : 1. L'ensemble des fichiers doit être fourni 2. Aucun fichier ne doit avoir été modifié 3. Vous ne devez pas demander plus de 40FF pour cela Malgré de nombreux tests, je ne peux garantir que AGraph ne contient aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET PERILS. Je ne pourrai en aucun cas être tenu pour responsable de tout dommage, direct ou indirect, résultant de l'utilisation de AGraph. @{"Introduction" Link "Introduction"} @{"Installation de AGraph" Link "Installation"} @{"Démarrage du programme" Link "Arguments"} @{"Format des fichiers d'entrée" Link "InputFiles"} @{"Description des menus" Link "Menus"} @{"Utilisation avec ARexx" Link "ARexx"} @{"Informations techniques" Link "Technical"} @endnode @node Introduction "Introduction" AGraph est un petit mais puissant programme, dont le but est de dessiner des graphiques comme des histogrammes ou des camemberts. Il offre cinq types de graphique (la plupart pouvant être décliné en plusieurs modes), un port ARexx, et peut sauvegarder les graphiques sous forme d'image IFF. Vos critiques et suggestions sur ce programme seront toujours les bienvenues. N'hésitez pas à m'écrire, à l'adresse suivante : M. GOUNELLE Denis 27, rue Jules GUESDE 45400 FLEURY-LES-AUBRAIS FRANCE Vous pouvez également m'adresser un message électronique à "gounelle@@alphanet.ch". Notez qu'il s'agit d'une boite à lettre mise à ma disposition par un ami, aussi veuillez n'envoyer que de courts messages. De plus, n'ayant pas accès directement à mes messages, n'espérez pas avoir une réponse avant un mois. @endnode @node Installation "Installation de AGraph" Pour installer AGraph, il vous suffit de copier le fichier exécutable dans n'importe quel répertoire de votre "path". Ce programme nécessite d'avoir un Kickstart V36 ou supérieur. Deux versions de AGraph sont fournies : une qui fonctionne sur n'importe quel modèle d'Amiga, l'autre optimisée pour les Amiga disposant d'au moins un 68020 comme processeur central, ainsi que d'un coprocesseur arithmétique (68881/82). AGraph est localisé, c'est-à-dire qu'il peut s'adapter à la langue par défaut si vous avez le système 2.1 ou plus. Il vous faudra alors copier le fichier catalogue désiré dans le répertoire correspondant à votre langue par défaut. Par exemple, s'il s'agit du francais, copiez le fichier "francais.catalog" dans le répertoire "SYS:Locale/Catalogs/Francais}", sous le nom "AGraph.catalog". @endnode @node Arguments "Démarrage du programme" AGraph peut être lancé aussi bien depuis la ligne de commande du Shell, que depuis le Workbench. Dans les deux cas, il n'accepte qu'un seul argument, facultatif, qui est supposé être le nom du fichier d'entrée à utiliser. Si aucun argument n'est indiqué, une requête de fichier apparaitra, pour que vous puissiez choisir le fichier d'entrée. Si vous annulez la requête, le programme s'arrêtera. @endnode @node InputFiles "Format des fichiers d'entrée" Ce chapitre décrit le format des fichiers d'entrée de AGraph. Ces fichiers sont de simples fichiers textes, qui contienent les données et les paramètres nécessaires au tracé des graphiques. La forme générale d'un fichier d'entrée est : ; commentaire AGRAPH OPTIONS OPTION1=valeur OPTION2=valeur etc... DATA TitreColonne1,TitreColonne2,... TitreLigne1,DonnéeLigne1Colonne1,DonnéeLigne1Colonne2,... ... ... Les lignes vides et les lignes de commentaire sont ignorées. La première ligne qui n'est ni vide ni un commentaire doit commencer par le mot "AGRAPH". Comme vous pouvez le constater, les fichiers d'entrée sont divisés en une ou deux sections : - la section OPTIONS, facultative, qui permet de modifier les paramètres par défaut, comme par exemple le mode écran ou le type de graphique. - la section DATA, obligatoire, qui contient les données du graphique. Les sections OPTIONS et DATA peuvent apparaitre dans n'importe quel ordre. Il est fortement recommandé que chaque ligne d'option ou de donnée commence par au moins un espace ou une tabulation. @{"Liste des options" Link "OptionsList"} @{"Exemple de fichier d'entrée" Link "Example"} @endnode @node OptionsList "Liste des options" DEPTH=n Utilise un écran de "n" plans. Si "n" est différent du nombre de plans de l'écran du Workbench, un écran particulier est ouvert. Cet écran aura le même mode que l'écran du Workbench, sauf si l'option DISPLAYID est indiquée. Exemple: DEPTH=3 DISPLAYID=modeécran Ouvre un écran particulier, dans le mode indiqué. Exemple: DISPLAYID=0x29004 FONT=nompoliceY Indique la police de caractères à utiliser, au lieu de la police par défaut. Exemple: FONT=topaz8 LEGEND=RIGHT|BOTTOM|NONE Indique où placer la légende du graphique. La valeur par défaut est RIGHT Exemple: LEGEND=BOTTOM MODE=PERCENT|HORIZONTAL|BACKDROP|NOAXES Indique le mode du graphique. Vous pouvez donner une liste de mode, en séparant chaque mot par une virgule (voir exemple ci-dessous). Si un mode ne convient pas au type de graphique courant, il sera ignoré. En mode PERCENT, les graphiques de type AREA, CUMHISTO et PIE convertissent toutes les données en pourcentage relatif à la somme des valeurs pour une même colonne. En mode HORIZONTAL, les axes des X et des Y sont inversés pour les graphiques de type STDHISTO et CUMHISTO. En mode BACKDROP, AGraph ouvre toujours un écran particulier, et les fenêtres d'affichage sont des fenêtres "backdrop", qui ne peuvent être redimensionnées. Vous pouvez indiquer le mode souhaité pour l'écran avec l'option DISPLAYID. En mode NOAXES, AGraph n'affiche pas les axes verticaux (ou horizontaux en mode HORIZONTAL). Exemple: MODE=PERCENT,HORIZONTAL PALETTE=0xRGB,0xRGB,... Indique les couleurs de l'écran. Si AGraph travaille sur l'écran du Workbench, la palette initiale sera rétablie quand le programme se terminera. Exemple: PALETTE=0xAAA,0x000,0xFFF,0x68B STARTPEN=n Indique la première couleur à utiliser. Cette couleur sera choisie pour la première ligne de données. La valeur par défaut est 2 (blanc dans la palette standard). Exemple: STARTPEN=3 TITLE=titre de la fenêtre Indique le titre de la fenêtre d'affichage. La valeur par défaut est le nom du fichier d'entrée. Exemple: TITLE=Courbe des ventes TYPE=CURVE|AREA|PIE|STDHISTO|CUMHISTO Indique le type de graphique à afficher : courbe (CURVE), aires (AREA), camembert (PIE), histogramme normal (STDHISTO) ou histogramme cumulé (CUMHISTO). La valeur par défaut est CURVE. Les données doivent être toutes du même signe pour les types AREA et PIE. Notez que le type PIE n'utilise que la première colonne de donnée. Exemple: TYPE=PIE YSCALE=n Indique la graduation sur l'axe des Y. Par défaut, AGraph indique le zéro et les valeurs minimales et maximales. Exemple: YSCALE=2.5 @endnode @node Example "Exemple de fichier d'entrée" ; ; Exemple de fichier d'entrée pour AGraph ; AGRAPH OPTIONS FONT=times11 TITLE=Courbe des ventes YSCALE=10 TYPE=STDHISTO DATA 01/94, 02/94, 03/94, 04/94, 05/94, 06/94, 07/94, 08/94 Joe, 11.12, 3.49, 0.13, 2.29, 3.20, 9.13, 2.23, 3.24 Jack, 22.57, 30.44, 17.21, 10.48, 36.36, 63.11, 25.55, 24.41 William, 50.49, 42.08, 43.13, 9.36, 13.52, 37.06, 24.32, 15.19 Averell, 0 , 0 , 51.40, 1.55, 7.24, 4.37, 0.33, 0.25 @endnode @node Menus "Description des menus" Une fois la fenêtre d'affichage ouverte, AGraph lui ajoute deux menus. Le menu "Projet" offre les choix suivants : Ouvrir... Ouvre un nouveau fichier d'entrée. Une requête de fichier apparait pour vous permettre de choisir le fichier. Sauver en... Sauve le graphique courant sous forme d'image IFF. Une requête de fichier apparait pour vous permettre d'indiquer le nom du fichier de sortie. A propos... Affiche quelques informations sur le programme et son auteur. Quitter Termine le programme. Le menu "Mode" offre les choix suivants : Aire Courbe Histo. cumulé Histo. standard Camembert Change le type de graphique. Certains types peuvent être désactivés, si les données ne permettent pas de les afficher. Pourcent Inverse le mode PERCENT. Horizontal Inverse le mode HORIZONTAL. Sans axes Inverse le mode NOAXES. @endnode @node ARexx "Utilisation avec ARexx" AGraph a un port ARexx, nommé "AGraph_rexx". Ce port est ouvert dès que le programme démarre. En cas d'échec, un message d'avertissement est affiché. Les commandes acceptées sont : MODE nouveau mode MODE liste de modes Change le mode du graphique. OPEN fichier Charge un nouveau fichier d'entrée. PALETTE 0xRGB,0xRGB... Change la palette de l'écran. SAVEAS fichier Sauve le graphique courant sous format d'un fichier IFF, de nom "fichier". TOFRONT Place l'écran actuel au premier plan. TYPE nouveau type Change le type du graphique. QUIT Termine le programme. Toutes ces commandes renvoient 0 en cas de succès, 10 en cas d'erreur, 20 si une erreur fatale est survenue. Dans ce dernier cas, le programme s'arrête immédiatement. @endnode @node Technical "Informations techniques" Langage utilisé Langage C uniquement. Compilateur utilisé SAS/C 6.51. Taille du source 112638 octets, 4695 lignes, 24 modules. Machine de développement Amiga 3000 25Mhz avec 10Mo de RAM, disque dur 160Mo, OS 3.1. Durée du développement Moins de 40 heures (pour la v36.0). @endnode