glRect

draw a rectangle

Signature

glRect( )->
glRectd( GLdouble ( x1 ) , GLdouble ( y1 ) , GLdouble ( x2 ) , GLdouble ( y2 ) )-> void
glRectd( x1 , y1 , x2 , y2 )
glRectdv( const GLdouble * ( v1 ) , const GLdouble * ( v2 ) )-> void
glRectdv( v1 , v2 )
glRectf( GLfloat ( x1 ) , GLfloat ( y1 ) , GLfloat ( x2 ) , GLfloat ( y2 ) )-> void
glRectf( x1 , y1 , x2 , y2 )
glRectfv( const GLfloat * ( v1 ) , const GLfloat * ( v2 ) )-> void
glRectfv( v1 , v2 )
glRecti( GLint ( x1 ) , GLint ( y1 ) , GLint ( x2 ) , GLint ( y2 ) )-> void
glRecti( x1 , y1 , x2 , y2 )
glRectiv( const GLint * ( v1 ) , const GLint * ( v2 ) )-> void
glRectiv( v1 , v2 )
glRects( GLshort ( x1 ) , GLshort ( y1 ) , GLshort ( x2 ) , GLshort ( y2 ) )-> void
glRects( x1 , y1 , x2 , y2 )
glRectsv( const GLshort * ( v1 ) , const GLshort * ( v2 ) )-> void
glRectsv( v1 , v2 )

Parameters

VariablesDescription
x1, y1
Specify one vertex of a rectangle.
x2, y2
Specify the opposite vertex of the rectangle.
v1
Specifies a pointer to one vertex of a rectangle.
v2
Specifies a pointer to the opposite vertex of the rectangle.

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

Sample Code References

The following code samples have been found which appear to reference the functions described here. Take care that the code may be old, broken or not even use PyOpenGL.

glRectf
OpenGL-Demo PyOpenGL-Demo/GLUT/tom/checker.py Lines: 38
OpenGL-Demo PyOpenGL-Demo/redbook/double.py Lines: 71
OpenGL-Demo PyOpenGL-Demo/tom/conechecker.py Lines: 22
OpenGL-Demo PyOpenGL-Demo/tom/checker.py Lines: 22
{LGPL} pygl2d pygl2d/draw.py Lines: 135
{GPL} Scocca scocca/graphics/opengl/draw.py Lines: 43

MathML Rendering

Powered by MathJax