pfvInputMngrPicker(3pf) OpenGL Performer 3.2.2 libpfv C++ Reference Pages
NAMEpfvInputMngrPicker - A pfvPicker implementation that uses mouse and
keyboard events collected by the pfvInputMngr to determine current focus
and to coordinate user-interaction.
FUNCTION SPECIFICATION
#include <Performer/pfv/pfvXml.h>
pfvInputMngrPicker::pfvInputMngrPicker();
int pfvInputMngrPicker::getViewIndex();
void pfvInputMngrPicker::setViewIndex(int i);
pfuMouse * pfvInputMngrPicker::getMouse();
pfuEventStream* pfvInputMngrPicker::getEventStream();
pfChannel* pfvInputMngrPicker::getChan();
DESCRIPTION
The pfvInputMngrPicker extends the pfvPicker class and may be used
directly by applications in order to coordinate user interaction with
scene elements through mouse and keyboard input. pfvInputMngrPickers are
very similar to pfvMousePickers. The only difference is that
pfvMousePickers calls pfuGetMouse and pfuGetEvents to collect events and
current mouse state, while pfvInputMngrPickers relies on pfvInputMngr to
call pfuGetMouse and pfuGetEvents, and obtains its input from the
pfuMouse and pfuEventStream structures managed by pfvInputMnger.
new pfvInputMngrPicker creates and returns a handle to a new
pfvInputMngrPicker object.
pfvInputMngrPicker::setViewIndex associates this picker with the ith view
in Display Manager's view list. Picker will ignore events generated while
other views detain mouse focus.
pfvInputMngrPicker::getViewIndex returns the index of the view to which
picker is associated, as set through method
pfvInputMngrPicker::setViewIndex.
pfvInputMngrPicker::getMouse returns a pointer to the pfuMouse structure
used by picker for determining current mouse state. Note that this will
point directly to the pfuMouse structure managed and updated by the
pfvInputMngr.
pfvInputMngrPicker::getEventStream returns a pointer to the
pfuEventStream structure used by picker for tracking keyboard events.
Note that this will point directly to the pfuEventStream structure
managed and updated by the pfvInputMngr.
pfvInputMngrPicker::getChan returns a pointer to the pfChannel currently
Page 1
pfvInputMngrPicker(3pf) OpenGL Performer 3.2.2 libpfv C++ Reference Pages
associated with picker. This will be equal to the pfChannel associated
with the pfvChannel with current mouse focus, if channel belongs to the
view associated with picker. If no channel has current mouse focus, or
if focus channel belongs to a view different from that associated with
picker, this method returns NULL.
NOTES
For examples of uses of the pfvPicker API, look at the sample code in
/usr/share/Performer/src/pguide/libpfv/picker and the README file
contained in that directory.
For an example of usage of the pfvInputMngrPicker class also look at the
source code for the pfvmPicker module in
/usr/share/Performer/src/pguide/libpfv/viewer/modules/pfvmPicker
SEE ALSO
pfvInputMngr, pfvPicker, pfvmPicker
Page 2
