Insert_Marker

Functions

HC_KEY DInsert_Marker (double x, double y, double z)
 Similar to Insert_Marker(), but accepts parameters of type double for increased precision. Unlike Insert_Marker, the parameters are not truncated. More...
 
HC_KEY Insert_Marker (double x, double y, double z)
 Inserts a single marker symbol at the specified location in your scene. More...
 

Detailed Description

Function Documentation

◆ DInsert_Marker()

HC_KEY DInsert_Marker ( double  x,
double  y,
double  z 
)

Similar to Insert_Marker(), but accepts parameters of type double for increased precision. Unlike Insert_Marker, the parameters are not truncated.

Parameters
x- x-coordinate of the marker in object space.
y- y-coordinate of the marker in object space.
z- z-coordinate of the marker in object space.
Returns
The key to the inserted geometry.

DETAILS

No additional details. See Insert_Marker().

◆ Insert_Marker()

HC_KEY Insert_Marker ( double  x,
double  y,
double  z 
)

Inserts a single marker symbol at the specified location in your scene.

Parameters
x- x-coordinate of the marker in object space.
y- y-coordinate of the marker in object space.
z- z-coordinate of the marker in object space.
Returns
The key to the inserted geometry, or -1 if an error occurred.

DETAILS

You "mark" a position in your scene. The marker actually used depends on the current marker symbol attribute setting. The size of the marker is determined by the current marker size, and the color by the "marker" color setting. Markers are not scaled with geometry.
This function's double parameters are internally truncated to float. If you require extra precision, use this function's double-precision variant, DInsert_Marker.

NOTES

There is no "polymarker" routine in HOOPS Visualize. A mesh with edges and faces turned off (in the segment, not locally one-by-one!) is a reasonably compact and fast alternative.

The marker generated always faces to the front on the final screen display.

RESTRICTIONS

Due to the floating point to integer round-off error, the positioning of markers, particularly the asterisk, can sometimes be off by one pixel.

See also
Insert_Line, Insert_Polygon, Insert_Circle, Insert_Mesh, Set_Marker_Symbol, Set_Marker_Size, Set_Color, Set_Visibility, Renumber_Key.