DESCRIPTION.

La fonction FN_loadtexture() charge en mémoire, depuis un fichier image, une texture.

SYNTAXE.

ktexture = FN_loadtexture( etat , fichier )

REMARQUES.

etat est l'identifiant de la variable qui a reçu la valeur retourné par la fonction d'initiation FN_initgl().

fichier doit être le nom d'un fichier image existant. fichier doit commencer par une lettre de lecteur pour le distinguer d'une URL. Le format de fichier doit être à l'un de ces formats : .bmp, .gif, .jpg ou .png.

L'appel de la fonction FN_loadtexture() va retourner un valeur numérique correspondant à un pointeur vers mémoire vers la texture. Cette valeur devra être stockée dans un variable pour un usage ultérieur. Si la fonction FN_loadtexture()  retourne 0, zéro, fichier n'a pas pu être ouvert.

Note : si vous utilisez le module webgllib.bbc, dans WebGL, la largeur et la hauteur de l'image doivent être des puissances de deux, par exeple : 256, 512, 1024, 4096.

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_loadtexture() 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"

kquantite% = 0 : kformat% = 0 : ktaille% = 0

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

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

ktexture = FN_loadtexture( ketat , "mon_image.jpg" )

PROC_release( ktexture )

PROC_release( ketat )

END