Set_Line_Weight

Functions

void Set_Line_Weight (double weight)
 Makes simple lines and polylines broader or narrower than normal. More...
 
void UnSet_Line_Weight (void)
 Removes all settings established by a previous call to Set_Line_Weight(). More...
 

Detailed Description

Function Documentation

◆ Set_Line_Weight()

void Set_Line_Weight ( double  weight)

Makes simple lines and polylines broader or narrower than normal.

Parameters
weight- Scale factor ( rounded to the nearest integer ) to be applied to the normal line width.

DETAILS

There are several methods available to vary the visual depiction of Lines, Polylines, and Inked polylines, including Line Weight, Line Pattern, and Line Color. Line Weight performs the task by thickening (or thinning) lines away from what they would normally be. "Normal" depends on the particular display device.
A line weight of "2.0" causes the lines to be rendered twice as thick as usual.

NOTES

Use Set_Variable_Line_Weight for non-integer values.

The "1.0" line weight always corresponds to a line one pixel wide, which usually comes out to about 0.1 percent of the screen size. In the exceptional case where a device has very small pixels—but only in the exceptional case—the 1.0 weight is forced to correspond to 0.1 percent of the screen.
To force a line to be the minimum possible width (a hairline), specify 0 as the line weight. This causes lines to be drawn in a fixed (screen space) size; they will not scale as the object scales.

Currently, there is no method of inquiring just how wide a "pixel" actually is on a given display screen.
Thinning lines will probably not get you any visible change if your device doesn't have sufficient resolution. As a corollary, you should watch out for lines that might someday, on a new device, be entirely too thin.

RESTRICTIONS

See also
Set_Line_Pattern, Set_Color, Set_Edge_Weight, Set_Marker_Size, Insert_Line, Insert_Polyline, Insert_Ink, Set_Variable_Line_Weight.

◆ UnSet_Line_Weight()

void UnSet_Line_Weight ( void  )

Removes all settings established by a previous call to Set_Line_Weight().

DETAILS

No additional details. See Set_Line_Weight()