Brief Index      Full Index      Events Index      I.M. Reference

Set_Marker_Size

Functions

void Set_Marker_Size (double weight)
void UnSet_Marker_Size (void)

Function Documentation

void Set_Marker_Size ( double  weight)

Makes marker symbols larger or smaller than usual.

Parameters:
weight- Scale factor to be applied to the normal Marker size.

DETAILS

There are several methods available to vary the visual depiction of Markers, including changing the Marker Symbol, Color, and Size. Marker Size performs the task by enlarging (or reducing) the marker symbols used on the screen.

A Size of "2.0" causes the markers to be rendered twice as big as they would usually be, while a size of "0.5" makes them half as big.

NOTES

The default "1.0" marker size equals 3.0 percent of the height of the display screen or virtual display screen. More precisely, it describes a 3.0 percent circle into which any marker symbol (except ".") will be made as large as possible and still fit into it. So if, for example, you wanted a 3 pixel x 3 pixel box, you would need a circle of diameter 3*sqrt(2).

There is not yet an implemented method of inquiring just how big a "standard marker" actually is on a given display screen.

On some displays using nonstandard Marker sizes may slow down rendering.

For some markers symbols, HOOPS can attempt to rendered the marker with hardware acceleration if the Set_Driver_Options suboption marker drawing is set to fastest as opposed to nicest. The table listed below identifies when certain markers symbols can be rendered with hardware acceleration:

Legend

  • Hardware Accelerated Rendering
  • Software Rendering
Symbol Fastest Nicest
.
(*)
[*]
other

RESTRICTIONS

Very large marker sizes (e.g. greater than about 10 or so) perform poorly with the software z buffer hidden line removal algorithm. Extremely large values, (e.g. greater than 100) can cause HOOPS to crash. HOOPS makes the (usually valid) assumption that marker sizes are small enough that it can allocate a small "soft clip" border around the frame buffer so that if the marker insertion point is visible, the marker need not be clipped. Large marker sizes can make such soft clip regions either expensive or impossible to allocate.

See also:
Set_Edge_Weight, Set_Line_Weight, Set_Line_Pattern, Set_Color, Insert_Marker, Insert_Grid, Insert_Mesh, Set_Variable_Marker_Size, Set_Text_Font
void UnSet_Marker_Size ( void  )

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

DETAILS

No additional details. See Set_Marker_Size()

Brief Index      Full Index      Events Index      I.M. Reference