Função glAddSwapHintRectWIN
A função de retorno de chamada glAddSwapHintRectWIN especifica um conjunto de retângulos que devem ser copiados por SwapBuffers.
Sintaxe
void WINAPI glAddSwapHintRectWIN(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
Parâmetros
-
x
-
A coordenada x (em coordenadas de janela) do canto inferior esquerdo do retângulo da região de dica.
-
y
-
A coordenada y (em coordenadas de janela) do canto inferior esquerdo do retângulo da região de dica.
-
width
-
A largura do retângulo da região da dica.
-
altura
-
A altura do retângulo da região da dica.
Retornar valor
Essa função não retorna um valor.
Comentários
A função glAddSwapHintRectWIN acelera a animação reduzindo a quantidade de repintura entre quadros. Com glAddSwapHintRectWIN, você especifica um conjunto de áreas retangulares que deseja copiar ao chamar SwapBuffers. Quando você não especificar nenhum retângulo com glAddSwapHintRectWIN antes de chamar SwapBuffers, todo o framebuffer será trocado. Usar glAddSwapHintRectWIN para copiar apenas partes alteradas do buffer pode aumentar significativamente o desempenho de SwapBuffers, especialmente quando SwapBuffers é implementado no software.
A função glAddSwapHintRectWIN adiciona um retângulo à região da dica. Quando o sinalizador PFD_SWAP_COPY da estrutura de formato de pixel PIXELFORMATDESCRIPTOR é definido, SwapBuffers usa essa região para recortar a cópia do buffer traseiro para o buffer frontal. Você não especifica PFD_SWAP_COPY; ele é definido por hardware compatível. A região da dica é desmarcada após cada chamada para SwapBuffers. Com algumas configurações de hardware, o SwapBuffers pode ignorar a região da dica e trocar todo o buffer. SwapBuffers é implementado pelo sistema, não pelo aplicativo.
O OpenGL mantém uma região de dica separada para cada janela. Quando você chama glAddSwapHintRectWIN em qualquer contexto de renderização associado a uma janela, os retângulos de dica são combinados em uma única região.
Chame glAddSwapHintRectWIN com um retângulo delimitador para cada objeto desenhado para um quadro e para cada retângulo limpo para apagar objetos de quadro anteriores.
Observação
A função glAddSwapHintRectWIN é uma função de extensão que não faz parte da biblioteca OpenGL padrão, mas faz parte da extensão GL_WIN_swap_hint. Para marcar se a implementação do OpenGL dá suporte a glAddSwapHintRectWIN, chame glGetString(GL_EXTENSIONS). Se retornar GL_WIN_swap_hint, há suporte para glAddSwapHintRectWIN . Para obter o endereço de uma função de extensão, chame wglGetProcAddress.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|