Brief Index      Full Index      Events Index      I.M. Reference

Set_Edge_Weight

Functions

void Set_Edge_Weight (double weight)
void UnSet_Edge_Weight (void)

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 ( rounded to the nearest integer ) 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.

NOTES

Use Set_Variable_Edge_Weight for non-integer values.

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 UnSet_Edge_Weight ( void  )

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

DETAILS

No additional details. See Set_Edge_Weight()

Brief Index      Full Index      Events Index      I.M. Reference