Brief Index      Full Index      I.M. Reference

Set_Line_Weight


Functions

void Set_Line_Weight (double weight)
void QSet_Line_Weight (const char *segment, double weight)
void UnSet_Line_Weight (void)
void QUnSet_Line_Weight (const char *segment)

Function Documentation

void Set_Line_Weight ( double  weight  ) 

Makes simple lines and polylines broader or narrower than normal.

Parameters:
weight - Scale factor 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, while a weight of "0.5" makes them half as thick.

NOTES

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.

void QSet_Line_Weight ( const char *  segment,
double  weight 
)

Similar to Set_Line_Weight(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be changed.
weight - Scale factor to be applied to the normal line width.

DETAILS

No additional details. See Set_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()

void QUnSet_Line_Weight ( const char *  segment  ) 

Removes all settings established by a previous call Set_Line_Weight(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be changed.

DETAILS

No additional details. See Set_Line_Weight()

Main Index
Brief Index      Full Index      I.M. Functions