Brief Index      Full Index      I.M. Reference

Insert_Marker


Functions

void Insert_Marker (double x, double y, double z)
HC_KEY KInsert_Marker (double x, double y, double z)
void QInsert_Marker (const char *segment, double x, double y, double z)
HC_KEY QKInsert_Marker (const char *segment, double x, double y, double z)
void DInsert_Marker (double x, double y, double z)
HC_KEY DKInsert_Marker (double x, double y, double z)
void DQInsert_Marker (const char *segment, double x, double y, double z)
HC_KEY DQKInsert_Marker (const char *segment, double x, double y, double z)

Function Documentation

void 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.

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 KInsert 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 KInsert_Marker ( double  x,
double  y,
double  z 
)

Similar to Insert_Marker(), but returns an HC_KEY to the object.

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:
key

DETAILS

No additional details. See Insert_Marker()

void QInsert_Marker ( const char *  segment,
double  x,
double  y,
double  z 
)

Similar to Insert_Marker(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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.

DETAILS

No additional details. See Insert_Marker()

HC_KEY QKInsert_Marker ( const char *  segment,
double  x,
double  y,
double  z 
)

Similar to Insert_Marker(), but operates on a given segment and returns an HC_KEY to the object.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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:
key

DETAILS

No additional details. See Insert_Marker()

void 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.

DETAILS

No additional details. See Insert_Marker().

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

Similar to DInsert_Marker(), but returns an HC_KEY to the object.

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:
key

DETAILS

No additional details. See Insert_Marker()

void DQInsert_Marker ( const char *  segment,
double  x,
double  y,
double  z 
)

Similar to DInsert_Marker(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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.

DETAILS

No additional details. See Insert_Marker()

HC_KEY DQKInsert_Marker ( const char *  segment,
double  x,
double  y,
double  z 
)

Similar to DInsert_Marker(), but operates on a given segment and returns an HC_KEY to the object.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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:
key

DETAILS

No additional details. See Insert_Marker()

Main Index
Brief Index      Full Index      I.M. Functions