GINO Graphics Suite - GINO v9.0  

gSetLineWidth

Syntax

[C/C++:]
void gSetLineWidth(float width);
void gSetLineWidthPixel(float pixels);
[F90:]
subroutine gSetLineWidth(width)
subroutine gSetLineWidthPixel(pixels)

real, intent(in) :: width,pixels

Arguments

width
Line width in current units

pixels
Line width in device units (pixels)

Description

The routines gSetLineWidth() and gSetLineWidthPixel() specifies a line width for subsequent graphical output, where the former defines the width in current units (and is also affected by the line width scaling factor), and the latter sets it in physical device units (and is not affected by any other routine, or viewport.

When width or pixels is set to zero (0.0) the line width is set to the default width for the currently nominated device. This would be equivalent to a single pixel's width on raster devices or the default pen width on plotters. In some cases a smaller line width is available in which case a small positive value should be used to select the finest line width available on any device.

Where only discrete line/pen widths are possible, the nearest available width is selected and a call to gEnqSelectedPen() will return the line width actually used.

If width or pixels is less than zero, a warning message is output. The absolute value of width is taken to be the line width.

Line width only affects characters if gSetSoftChars() has been called and gSetFontWeight() has not been called.

pixels can be real or integer.

See Also

gSetLineWidth Usage
gEnqSelectedPen
gSetLineWidthScaling