glLineWidth

Name

glLineWidth — specify the width of rasterized lines

C Specification

void glLineWidth( GLfloat width);

Parameters

width: Specifies the width of rasterized lines. The initial value is 1.

Description

glLineWidth specifies the rasterized width of lines.

The actual width is determined by rounding the supplied width to the nearest integer. (If the rounding results in the value 0, it is as if the line width were 1.) If Δ x >= Δ y , i pixels are filled in each column that is rasterized, where i is the rounded value of width. Otherwise, i pixels are filled in each row that is rasterized.

There is a range of supported line widths. Only width 1 is guaranteed to be supported; others depend on the implementation. To query the range of supported widths, call glGet with argument GL_ALIASED_LINE_WIDTH_RANGE.

Notes

The line width specified by glLineWidth is always returned when GL_LINE_WIDTH is queried. Clamping and rounding have no effect on the specified value.

Line width may be clamped to an implementation-dependent maximum. Call glGet with GL_ALIASED_LINE_WIDTH_RANGE to determine the maximum width.

Errors

GL_INVALID_VALUE is generated if width is less than or equal to 0.

Associated Gets

glGet with argument GL_LINE_WIDTH

glGet with argument GL_ALIASED_LINE_WIDTH_RANGE