OpenScreen()

Syntaxe

Resultat = OpenScreen(Largeur, Hauteur, Profondeur, Titre$ [, FlipMode [, TauxDeRafraichissement])

Ouvre un nouvel écran avec les caractéristiques Largeur, Hauteur et Profondeur. L'écran est créé avec deux buffers vidéo, ce qui permet l'affichage successif des deux buffers avec la fonction FlipBuffers(), particulièrement utile pour les jeux. Si Resultat = 0, la création de l'écran a échoué.

Largeur et Hauteur doivent être une combinaison standard du type : 640*480, 800*600, 1024*768...

Profondeur peut prendre les valeurs suivantes :

   4:    16 couleurs, palettes indépendantes
   8:   256 couleurs, palettes indépendantes
  16: 65000 couleurs, palette fixe
  24: 16 Mo couleurs, palette fixe
  32: 16 Mo couleurs, plus rapide que le mode 24-bit

Le paramètre 'FlipMode' est facultatif et permet d'attendre ou non la synchronisation avec l'écran avant d'inverser les buffers avec FlipBuffers() (aussi connu sous le nom de 'Vertical blank synchronization'). Les valeurs possibles du paramètre 'Flipmode' sont:

   #PB_Screen_NoSynchronization   : désactive la synchronisation 
   #PB_Screen_WaitSynchronization : active la synchronisation (mode par défaut)
   #PB_Screen_SmartSynchronization: active la synchronisation en essayant de préserver le temps processeur, 
   lorsque le jeu est en mode plein écran.

Attendre la synchronisation permet d'avoir des inversions de buffers parfaites (sans 'tearing' (ancienne et nouvelle image à moitié visible) ou autres effets parasites) car l'inversion est effectuée lorsque que le faisceau lumineux est en dehors de la partie visible de l'écran. De plus, l'inversion se fait à un rythme régulier, en relation avec sa fréquence de rafraîchissement: par exemple, pour un écran en 60 Hz, l'inversion pourra se faire au maximum 60 fois par seconde (donc on aura un rythme régulier de 60 images/secondes).

Le paramètre optionnel 'TauxDeRafraichissement' Définit le taux de rafraîchissement (en Hz) auquel le prochain écran ouvert devra se conformer. Si l'écran ne supporte pas ce taux de rafraîchissement, alors OpenScreen() échouera. Il suffit de remettre le 'TauxDeRafraichissement' à 0 pour ouvrir l'écran avec son taux par défaut
Note: Sous Windows, le taux de rafraîchissement peut être bloqué par le système ou par les drivers vidéo. Le résultat de cette fonction n'est donc pas forcément fiable.

Note: Sous Windows, le paramètre 'Titre$' sera affiché dans la barre des tâches, il est conseillé de choisir un nom approprié à l'application.

Pour ouvrir un écran à l'intérieur d'une fenêtre, il convient d'utiliser la commande OpenWindowedScreen().

OS Supportés

Windows, Linux (OpenGl), MacOS X