---
name: "glRect"
section: "3x"
platform: "linux"
package: "xlibmesa-gl-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/glRect"
---

# glRect(3x)

draw a rectangle

## NAME

**glRectd, glRectf, glRecti, glRects, glRectdv, glRectfv, glRectiv, glRectsv** - 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*

  Specify one vertex of a rectangle.

- *x2*, *y2*

  Specify the opposite vertex of the rectangle.

## 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*

  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

**glBegin(3G)**, **glVertex(3G)**