INITGRAPH |
Initialise le graphique |
|---|---|
| Turbo Pascal 4+ | Graph |
Syntaxe
| Procedure InitGraph(Var pilote,mode:Integer;chemin:String); |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| pilote | Ce paramètre retourne le numéro du pilote supporté: | ||
| Constante | Valeur | Description | |
| CurrentDriver | -128 | Cette constante permet d'indiquer le pilote courant pour la procédure GetModeRange | |
| Detect | 0 | Cette constante permet d'indiquer une autodétection | |
| CGA | 1 | Cette constante permet d'indiquer une carte vidéo de type CGA | |
| MCGA | 2 | Cette constante permet d'indiquer une carte vidéo de type MCGA | |
| EGA | 3 | Cette constante permet d'indiquer une carte vidéo de type EGA | |
| EGA64 | 4 | Cette constante permet d'indiquer une carte vidéo de type EGA 64 Ko | |
| EGAMono | 5 | Cette constante permet d'indiquer une carte vidéo de type EGA monochrome | |
| IBM8514 | 6 | Cette constante permet d'indiquer une carte vidéo de type IBM 8514 | |
| HercMono | 7 | Cette constante permet d'indiquer une carte vidéo de type Hercule | |
| ATT400 | 8 | Cette constante permet d'indiquer une carte vidéo de type AT&T 400 | |
| VGA | 9 | Cette constante permet d'indiquer une carte vidéo de type VGA | |
| PC3270 | 10 | Cette constante permet d'indiquer une carte vidéo de type PC 3270 | |
| mode | Ce paramètre retourne le plus haut mode vidéo supporté: | ||
| Constante | Valeur | Description | |
| CGAC0 | 0 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| CGAC1 | 1 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| CGAC2 | 2 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| CGAC3 | 3 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| CGAHi | 4 | Cette constante permet le mode vidéo 640 x 200 pixels | |
| MCGAC0 | 0 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| MCGAC1 | 1 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| MCGAC2 | 2 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| MCGAC3 | 3 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| MCGAMed | 4 | Cette constante permet le mode vidéo 640 x 200 pixels | |
| MCGAHi | 5 | Cette constante permet le mode vidéo 640 x 480 pixels | |
| EGAMonoHi | 3 | Cette constante permet le mode vidéo 640 x 350 pixels | |
| HercMonoHi | 0 | Cette constante permet le mode vidéo 720 x 348 pixels | |
| VGALo | 0 | Cette constante permet le mode vidéo 640 x 200 pixels | |
| VGAMed | 1 | Cette constante permet le mode vidéo 640 x 350 pixels | |
| VGAHi | 2 | Cette constante permet le mode vidéo 640 x 480 pixels | |
| EGALo | 0 | Cette constante permet le mode vidéo 640 x 200 pixels | |
| EGAHi | 1 | Cette constante permet le mode vidéo 640 x 350 pixels | |
| EGA64Lo | 0 | Cette constante permet le mode vidéo 640 x 200 pixels | |
| EGA64Hi | 1 | Cette constante permet le mode vidéo 640 x 350 pixels | |
| ATT400C0 | 0 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| ATT400C1 | 1 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| ATT400C2 | 2 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| ATT400C3 | 3 | Cette constante permet le mode vidéo 320 x 200 pixels | |
| ATT400Med | 4 | Cette constante permet le mode vidéo 640 x 200 pixels | |
| ATT400Hi | 5 | Cette constante permet le mode vidéo 640 x 400 pixels | |
| IBM8514Lo | 0 | Cette constante permet le mode vidéo 640 x 480 pixels | |
| IBM8514Hi | 1 | Cette constante permet le mode vidéo 1024 x 768 pixels | |
| PC3270Hi | 0 | Cette constante permet le mode vidéo 720 x 350 pixels | |
| chemin | Ce paramètre permet de définir le répertoire où sont situés les fichiers de pilote «BGI» | ||
Description
Cette procédure permet d'initialiser le mode d'affichage pour passer à l'écran graphique.
Remarques
- Les variables pilote et mode sont des paramètres Var.
- Si pilote est égal à Detect(0), un appel est fait à toutes les routines de détection automatique définies par l'utilisateur (voir InstallUserDriver), puis à DetectGraph. Si du matériel graphique est détecté, le pilote graphique approprié est initialisé et un mode graphique est sélectionné.
- Si pilote n'est pas égal à 0, la valeur de pilote est supposée être un numéro de pilote. Ce pilote est sélectionné et le système passe dans le mode spécifié par mode. Si vous substituez la détection automatique de cette manière, vous devez fournir un paramètre mode valide pour le pilote demandé.
- Le paramètre chemin spécifie le chemin du répertoire dans lequel les pilotes graphiques peuvent être trouvés. Si chemin est nulle, les fichiers du pilote doivent se trouver dans le répertoire en cours.
- Normalement, InitGraph charge un pilote graphique en allouant de la mémoire au pilote (via GraphGetMem), puis charge le fichier .BGI approprié à partir du disque. En guise d'alternative à ce schéma de chargement dynamique, vous pouvez lier un fichier de pilote graphique (ou plusieurs d'entre eux) directement à votre fichier de programme exécutable. Pour ce faire, vous devez d'abord convertir le fichier .BGI en un fichier .OBJ (à l'aide de l'utilitaire BINOBJ), puis passer des appels à RegisterBGIdriver dans votre code source (avant l'appel à InitGraph) pour enregistrer le ou les pilotes graphiques. Lorsque vous générez votre programme, vous devez lier les fichiers .OBJ des pilotes enregistrés. Vous pouvez également charger un pilote BGI sur le tas, puis l'enregistrer à l'aide de RegisterBGIdriver.
- Si la mémoire du pilote graphique est allouée sur le segment de mémoire à l'aide de GraphGetMem, cette mémoire est libérée lorsqu'un appel est effectué vers CloseGraph.
- Après avoir appelé InitGraph, le pilote sera défini sur le pilote graphique actuel et mode sur le mode graphique actuel. En cas d'erreur, pilote et
GraphResult (une fonction) renvoient une des valeurs suivantes :
Valeur Description -2 Cette valeur permet d'indiquer qu'il est impossible de détecter une carte graphique. -3 Cette valeur permet d'indiquer qu'il est impossible de trouver le fichier de pilote. -4 Cette valeur permet d'indiquer que le pilote est invalide. -5 Cette valeur permet d'indiquer que la mémoire insuffisante pour charger le pilote. -10 Cette valeur permet d'indiquer que le mode graphique est non valide pour le pilote sélectionné. - La procédure InitGraph réinitialise tous les paramètres graphiques à leurs valeurs par défaut (pointeur actuel, palette, couleur, fenêtre d'affichage,...).
- Vous pouvez utiliser InstallDriver pour installer un pilote graphique fourni par le fournisseur (voir InstallUserDriver pour plus d'informations).
- Plusieurs constantes utiles sont définies pour chaque pilote graphique pris en charge :
- Si vous utilisez l'interface graphique Borland (BGI) sur une carte Zenith Z-449, le code de détection automatique de Turbo Pascal sélectionnera toujours le mode EGA amélioré 640x480. Si ce mode n'est pas compatible avec votre moniteur, sélectionnez un autre mode dans l'appel InitGraph. De plus, Turbo Pascal ne peut pas détecter automatiquement la carte graphique IBM 8514 (la logique de détection automatique la reconnaît comme VGA). Par conséquent, pour utiliser la carte IBM 8514, la variable pilote doit recevoir la valeur IBM8514 (définie dans l'unité Graph) lors de l'appel de InitGraph. Vous ne devez pas utiliser DetectGraph (ou DetectGraph avec InitGraph) avec IBM 8514 sauf si vous souhaitez émuler le mode VGA.
| Constante | Code d'erreur | Description | Version |
|---|---|---|---|
| grOk | 0 | Cette constante indique qu'il n'y a pas d'erreur | 4+ |
| grNoInitGraph | -1 | Cette constante indique qu'il s'est produit une erreur pendant l'installation du mode d'écran graphique | 4+ |
| grNoDetected | -2 | Cette constante indique qu'aucune carte graphique compatible n'a été détecté | 4+ |
| grFileNotFound | -3 | Cette constante indique que le fichier contenant le pilote n'a été trouver dans le répertoire spécifié | 4+ |
| grInvalidDriver | -4 | Cette constante indique que le fichier contenant le pilote n'est pas supporté avec le mode vidéo graphique | 4+ |
| grNoLoadMem | -5 | Cette constante indique qu'il n'y a pas assez de mémoire disponible pour effectuer le chargement du fichier contenant le pilote | 4+ |
| grNoScanMem | -6 | Cette constante indique qu'il n'y a pas assez de mémoire disponible pour effectuer l'opération de balayage | 4+ |
| grNoFloodMem | -7 | Cette constante indique qu'il n'y a pas assez de mémoire disponible pour effectuer l'opération de «Flood» | 4+ |
| grFontNotFound | -8 | Cette constante indique que la police de caractères n'a pas été trouvé dans le répertoire spécifié | 4+ |
| grNoFontMem | -9 | Cette constante indique qu'il n'y a pas assez de mémoire pour effectuer le chargement d'une police de caractères | 4+ |
| grInvalidMode | -10 | Cette constante indique que le mode graphique n'est pas valide pour le pilote spécifié | 4+ |
| grError | -11 | Cette constante indique une erreur graphique générale | 4+ |
| grIOError | -12 | Cette constante indique une erreur graphique au niveau des entrées/sorties | 6+ |
| grInvalidFont | -13 | Cette constante indique que le fichier contenant la police de caractères n'est pas valide | 6+ |
| grInvalidFontNum | -14 | Cette constante indique que le numéro de la police de caractères n'est pas valide | 6+ |
| grInvalidVerNum | -18 | Cette constante indique que le numéro de version n'est pas valide | 6+ |
Exemple
L'exemple suivant permet de lancer le mode graphique par défaut, trace une ligne et attend que vous tapiez la touche Enter :
- Program InitGraphSamples;
-
- Uses Graph;
-
- Var
- grDriver:Integer;
- grMode:Integer;
- ErrCode:Integer;
-
- BEGIN
- grDriver:=Detect;
- InitGraph(grDriver,grMode,' ');
- ErrCode:=GraphResult;
- If ErrCode=grOk Then Begin { Faire des graphiques }
- Line(0,0,GetMaxX,GetMaxY);
- Readln;
- CloseGraph;
- End
- Else
- Writeln('Erreur graphiques :', GraphErrorMsg(ErrCode));
- END.
Voir également
Langage de programmation - Turbo Pascal - Affichage & Graphique - L'instruction «DRAW» du BASIC
Référence
Aide-mémoire de Turbo Pascal versions de 3 à 6, Edition Marabout, De Groote, Virga, 1992, ISBN: 2-501-01833-8, page 254 à 258.
Dernière mise à jour : Dimanche, le 25 janvier 2015