DESCRIPTION.

La fonction FN_initgl() initialise le module ogllib.bbc en déclarant les variables globales nécessaires.

SYNTAXE.

ketat = FN_initgl( fenetre , surfaces , lumiere )

REMARQUES.

fenetre doit être une valeur numérique indiquant le descripteur de la fenêtre de sortie qui recevra les graphiques 3D. fenetre généralement être défini sur la variable système @hwnd% pour que les graphismes soient affichés dans la fenêtre de sortie principale. 

surfaces doit être un nombre entier indiquant le mode d'élimination, c'est-à-dire si les surfaces se comportent comme des surfaces à une seule face ou à deux faces. surfaces peut valoir : 

- 1, aucune, valeur par défaut ; 

- 2, sens horaire ; 

- 3, sens antihoraire.

lumiere doit être un nombre entier indiquant si le moteur d'éclairage est activé ou non. Si l'éclairage est désactivé, les objets apparaissent comme s'ils étaient uniformément éclairés par la lumière ambiante, sinon, il est nécessaire que tous les objets incluent les normales de surface dans la description des leurs sommets. lumiere peut valoir :

- 0, pour désactiver le moteur d'éclairage ; 

- 1, pour activer le moteur d'éclairage ; 

- 2, pour désactiver le moteur d'éclairage et activer le canal alpha (uniquement avec le module webgllib) ; 

- 1, pour activer le moteur d'éclairage et le canal alpha (uniquement avec le module webgllib). 

L'appel de la fonction FN_initgl() retourne un valeur numérique; Si cette valeur est zéro (0) cela indique que les graphismes 3D ne sont pas disponibles. On pourra donc affecter cette valeur dans une variable et la tester immédiatement après l'appel de la fonction FN_initgl() dans un test logique IF ... THEN afin de s'assurer que le programme pourra se dérouler normalement.

Note : il n'est pas possibles d'afficher des graphismes OpenGL et des textes et des dessins générés par des instructions BBC BASIC dans la même fenêtre de sortie. Voir le module multiwin.bbc pour afficher plusieurs fenêtres de sorties dans une même application.

Rappel : selon l'environnement de l'exécution de l'application, il faudra choisir un des modules : ogllib, gleslib ou webgllib.

La fonction FN_initgl() est importée depuis le module ogllib.bbc. 

RUBRIQUES.

Les dessins et les graphismes pour plus de détails sur la création de dessins et de graphismes.

La gestion des couleurs pour plus de détails sur la gestion des couleurs logiques et physiques.

EXEMPLE.

INSTALL @lib$ + "ogllib.bbc"

ketat = FN_initgl( @hwnd% , 1 , 0 )

IF ketat = 0 THEN PRINT "Graphismes 3D indisponibles." 

PROC_release( ketat )

END