1991-2006
Silicon Graphics, Inc.
glLineWidth
3G

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

## See Also

glEnable

## 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/.