Brief Index      Full Index      I.M. Reference

Set_Edge_Weight


Functions

void Set_Edge_Weight (double weight)
void QSet_Edge_Weight (const char *segment, double weight)
void UnSet_Edge_Weight (void)
void QUnSet_Edge_Weight (const char *segment)

Function Documentation

void Set_Edge_Weight ( double  weight  ) 

Makes the edges of polygons, circles, ellipses, shells, and meshes broader or narrower than normal.

Parameters:
weight - Scale factor to be applied to the edge-line width.

DETAILS

There are several methods available to vary the visual depiction of edges, including Edge Weight, Edge Pattern, and Edge Color. Edge Weight does it by thickening or thinning the edges relative to 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. A line weight of "0.5" makes them half as thick.

NOTES

The "1.0" edge weight always corresponds to an edge 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.

There is not yet an implemented method of inquiring precisely how wide a "normal" line 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.

Depending on the implementation, the system might elect to thin very thick lines that have been scrunched down into a small Window.

RESTRICTIONS

See also:
Set_Edge_Pattern, Set_Color, Insert_Polygon, Insert_Shell, Insert_Mesh, Insert_Circle, Insert_Ellipse, Set_Line_Weight, Set_Marker_Size.

void QSet_Edge_Weight ( const char *  segment,
double  weight 
)

Similar to Set_Edge_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 edge-line width.

DETAILS

No additional details. See Set_Edge_Weight()

void UnSet_Edge_Weight ( void   ) 

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

DETAILS

No additional details. See Set_Edge_Weight()

void QUnSet_Edge_Weight ( const char *  segment  ) 

Removes all settings established by a previous call Set_Edge_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_Edge_Weight()

Main Index
Brief Index      Full Index      I.M. Functions