función glRects

La función glRects dibuja un rectángulo.

Sintaxis

void WINAPI glRects(
   GLshort x1,
   GLshort y1,
   GLshort x2,
   GLshort y2
);

Parámetros

x1

Coordenada x del vértice de un rectángulo.

y1

Coordenada y del vértice de un rectángulo.

x2

Coordenada x del vértice opuesto del rectángulo.

y2

Coordenada y del vértice opuesto del rectángulo.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar el siguiente código de error.

Nombre	Significado
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glRects admite una especificación eficaz de rectángulos como dos puntos de esquina. Cada comando de rectángulo toma cuatro argumentos, organizados como dos pares consecutivos de coordenadas (x, y) o como dos punteros a matrices, cada uno que contiene un par (x, y). El rectángulo resultante se define en el plano z = 0.

La función glRects(x1,y1,x2,y2) es exactamente equivalente a la siguiente secuencia:

glBegin(GL_POLYGON);

glVertex2( x1,y1 );

glVertex2( x2,y1 );

glVertex2( x2,y2 );

glVertex2( x1,y2 );

glEnd( );

Observe que si el segundo vértice está por encima y a la derecha del primer vértice, el rectángulo se construye con un viento en sentido contrario a las agujas del reloj.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glEnd

glVertex