HC_Insert_Marker

Key HC_Insert_Marker(double x, double y, double z)
Key HC_Insert_Marker(double x, double y, double z)

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

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.

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.

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

HC_Insert_Line, HC_Insert_Polygon, HC_Insert_Circle, HC_Insert_Mesh, HC_Set_Marker_Symbol, HC_Set_Marker_Size, HC_Set_Color, HC_Set_Visibility, HC_Renumber_Key.

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.