Functions | |
void | Set_Marker_Symbol (const char *symbol) |
void | UnSet_Marker_Symbol (void) |
void Set_Marker_Symbol | ( | const char * | symbol | ) |
Changes the screen icon used to represent graphical "markers" in the scene.
symbol | - Special constant (see below.) |
"Markers" are used to represent abstract geometrical points. You have a large choice over the representation to be used—the string constants are interpreted as follows:
------------------------------------------------------------------------------------- "()" or "O" An open circle, similar to `O'. Note: both a letter ("O" or "o") and a numeral ("0") will work. This is the default. "*" A star of some sort. "X" A `x' mark. "+" A `+' mark. "." A simple dot. This is often the only marker symbol that devices handle directly (others are composed and transformed in software). "(*)" or "@" A filled-in circle. "(.)" An open circle with a dot in the center. "(+)" An open circle with a + in the center. "(x)" An open circle with a 'x' in the center. "(())" or "(O)" An open circle with another circle inside. "[]" A hollow box. "[*]" A filled-in box. "[.]" A hollow box with a dot in the center. "[x]" A hollow box with a 'x' in the center. "<>" A hollow diamond. "<*>" A filled-in diamond. "<.>" A hollow diamond with a dot in the center. "<+>" A hollow diamond with a + in the center. "/\" A hollow up-pointing triangle. Note that in C string constants the \ must be doubled. "/*\" A filled-in triangle. "/.\" A hollow triangle with a dot in the center. "|>" A hollow rightward-triangle. "|*>" A filled-in rightward-triangle. "|.>" A hollow rightward-triangle with a dot in the center. "<|" A hollow leftward-triangle. "<*|" A filled-in leftward-triangle. "<.|" A hollow leftward-triangle with a dot in the center. "\/" A hollow downward-triangle. Note again that in C string constants the \ must be doubled. "\*/" A filled-in downward-triangle. "\./" A hollow downward-triangle with a dot in the center. -------------------------------------------------------------------------------------
The precise shape of the icon as it finally appears on the screen depends on the display device.
HOOPS markers will all have the identical radius in x and y, except for the "." marker, which will be smaller.
The "." marker will be drawn "as small as possible but still clearly visible"; this size may be larger than a single pixel on some machines. If you want a true single pixel set the Marker Size to zero.
For compatibility with previous releases, the "()" and "(*)" will be returned as "o" and "@" from Show_Marker_Symbol() .
As an example of defining new glyph patterns, the following code defines some legacy marker symbols that have been removed.
void UnSet_Marker_Symbol | ( | void | ) |
Removes all settings established by a previous call to Set_Marker_Symbol().
No additional details. See Set_Marker_Symbol()