NAME¶

glRect - draw a rectangle

C SPECIFICATION¶

void glRectd(GLdouble x1, GLdouble y1, GLdouble x2, GLdouble y2);

void glRectf(GLfloat x1, GLfloat y1, GLfloat x2, GLfloat y2);

void glRecti(GLint x1, GLint y1, GLint x2, GLint y2);

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

PARAMETERS¶

x1, y1

x2, y2

C SPECIFICATION¶

void glRectdv(const GLdouble * v1, const GLdouble * v2);

void glRectfv(const GLfloat * v1, const GLfloat * v2);

void glRectiv(const GLint * v1, const GLint * v2);

void glRectsv(const GLshort * v1, const GLshort * v2);

PARAMETERS¶

v1

v2

DESCRIPTION¶

glRect supports efficient specification of rectangles as two corner points. Each rectangle command takes four arguments, organized either as two consecutive pairs of x y coordinates or as two pointers to arrays, each containing an x y pair. The resulting rectangle is defined in the z = 0 plane.

glRect(x1, y1, x2, y2) is exactly equivalent to the following sequence:

glBegin(GL_POLYGON);
glVertex2(x1, y1);
glVertex2(x2, y1);
glVertex2(x2, y2);
glVertex2(x1, y2);
glEnd();


            

Note that if the second vertex is above and to the right of the first vertex, the rectangle is constructed with a counterclockwise winding.

ERRORS¶

GL_INVALID_OPERATION is generated if glRect is executed between the execution of glBegin() and the corresponding execution of glEnd().

SEE ALSO¶

glBegin(), glVertex()

COPYRIGHT¶

Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.

AUTHORS¶

opengl.org