fonction glAddSwapHintRectWIN
La fonction de rappel glAddSwapHintRectWIN spécifie un ensemble de rectangles qui doivent être copiés par SwapBuffers.
Syntaxe
void WINAPI glAddSwapHintRectWIN(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
Paramètres
-
x
-
Coordonnée x (dans les coordonnées de la fenêtre) du coin inférieur gauche du rectangle de région d’indicateur.
-
y
-
Coordonnée y (en coordonnées de fenêtre) du coin inférieur gauche du rectangle de la région d’indicateur.
-
width
-
Largeur du rectangle de région d’indicateur.
-
height
-
Hauteur du rectangle de région d’indicateur.
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
La fonction glAddSwapHintRectWIN accélère l’animation en réduisant la quantité de repeints entre les images. Avec glAddSwapHintRectWIN, vous spécifiez un ensemble de zones rectangulaires que vous souhaitez copier lorsque vous appelez SwapBuffers. Lorsque vous ne spécifiez pas de rectangles avec glAddSwapHintRectWIN avant d’appeler SwapBuffers, l’intégralité du framebuffer est permutée. L’utilisation de glAddSwapHintRectWIN pour copier uniquement les parties modifiées de la mémoire tampon peut augmenter considérablement les performances de SwapBuffers, en particulier lorsque SwapBuffers est implémenté dans un logiciel.
La fonction glAddSwapHintRectWIN ajoute un rectangle à la région d’indicateur. Lorsque l’indicateur PFD_SWAP_COPY de la structure de format de pixel PIXELFORMATDESCRIPTOR est défini, SwapBuffers utilise cette région pour couper la copie de la mémoire tampon arrière sur la mémoire tampon avant. Vous ne spécifiez pas PFD_SWAP_COPY ; il est défini par le matériel compatible. La région d’indicateur est effacée après chaque appel à SwapBuffers. Avec certaines configurations matérielles, SwapBuffers peut ignorer la région d’indicateur et échanger la mémoire tampon entière. SwapBuffers est implémenté par le système, et non par l’application.
OpenGL gère une région d’indicateur distincte pour chaque fenêtre. Lorsque vous appelez glAddSwapHintRectWIN sur les contextes de rendu associés à une fenêtre, les rectangles d’indicateur sont combinés en une seule région.
Appelez glAddSwapHintRectWIN avec un rectangle englobant pour chaque objet dessiné pour un cadre et pour chaque rectangle effacé pour effacer les objets frame précédents.
Notes
La fonction glAddSwapHintRectWIN est une fonction d’extension qui ne fait pas partie de la bibliothèque OpenGL standard, mais qui fait partie de l’extension GL_WIN_swap_hint. Pour case activée si votre implémentation d’OpenGL prend en charge glAddSwapHintRectWIN, appelez glGetString(GL_EXTENSIONS). S’il retourne GL_WIN_swap_hint, glAddSwapHintRectWIN est pris en charge. Pour obtenir l’adresse d’une fonction d’extension, appelez wglGetProcAddress.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|