
Functions | |
| void | Set_Marker_Symbol (const char *symbol) |
| Changes the screen icon used to represent graphical "markers" in the scene. More... | |
| void | UnSet_Marker_Symbol (void) |
| Removes all settings established by a previous call to Set_Marker_Symbol(). More... | |
| 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.
"|*|" A 3D sphere marker.
-------------------------------------------------------------------------------------
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()