NAME
SoLocateHighlight – special separator that performs locate highlighting
INHERITS FROM
SoLocateHighlight
SYNOPSIS
#include <Inventor/nodes/SoLocateHighlight.h>
enum Modes {
SoLocateHighlight::AUTO highlight when mouse is over (default)
SoLocateHighlight::ON always highlight
SoLocateHighlight::OFF never highlight
}
enum Styles {
SoLocateHighlight::EMISSIVE changes emissive color only (default)
SoLocateHighlight::EMISSIVE_DIFFUSE changes emissive and diffuse colors
}
Fields from class SoLocateHighlight:
Methods from class SoLocateHighlight:
static SoType getClassTypeId()
static void setNumRenderCaches(int howMany)
static int getNumRenderCaches()
void insertChild(SoNode *child, int newChildIndex)
SoNode * getChild(int index) const
int findChild(const SoNode *child) const
int getNumChildren() const
void removeChild(int index)
void removeChild(SoNode *child)
void replaceChild(int index, SoNode *newChild)
void setOverride(SbBool state)
virtual SbBool affectsState() const
SbBool hasDefaultValues() const
SbBool set(const char *fieldDataString)
SbBool isNotifyEnabled() const
void unrefNoDelete() const
virtual SoType getTypeId() const
virtual void setName(const SbName &name)
virtual SbName getName() const
DESCRIPTION
This is a subclass of
SoSeparator that redraws itself in a different color when the cursor is over the contents of the separator.
The redraw happens for that separator only and not the entire window (redraw along
the handle event pick path) and in the front buffer, to efficiently track the mouse motion. The highlighted redraw overrides the emissive and/or diffuse color of the subgraph based on the field values
in this node.
NOTE: when using
SoLightModel::BASE_COLOR (to turn lighting off) only the diffuse color will be used to render objects, so
EMISSIVE_DIFFUSE must be used for this node to have any effect.
FIELDS
SoSFColor color
highlighting color - default [.3, .3, .3]
SoSFEnum style
highlighting draw style - default EMISSIVE
SoSFEnum mode
Whether to highlight or not - default AUTO
METHODS
SoLocateHighlight()
Creates a LocateHighlight node with default settings.
static SoType getClassTypeId()
Returns type identifier for this class.
ACTION BEHAVIOR
Checks to see if the cursor moves onto or off of the contents of the separator, and redraws appropriately (if mode is AUTO), otherwise traverses as a normal separator.
Redraws either highlighted (if cursor is over the contents of the separator when mode == AUTO or always if mode == ON), otherwise traverses as a normal separator.
FILE FORMAT/DEFAULTS
SEE ALSO
Typeset by Felix Ritter (MeVis Research GmbH)
Hyperlinks by Wolfram Esser (method park Software AG)