Brief Index      Full Index      Events Index      I.M. Reference

Insert_Marker

Functions

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

Function Documentation

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.

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.

NOTES

There is no "polymarker" routine in HOOPS. 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.

If there is an error the Insert routine returns a -1.

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.
HC_KEY DInsert_Marker ( double  x,
double  y,
double  z 
)

Similar to Insert_Marker(), but accepts and/or returns double-precision values. This command can only be used when the application source includes the HOOPS double-precision header, hcd.h.

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().

Brief Index      Full Index      Events Index      I.M. Reference