Base viewer class which adds a decoration around the rendering area. More...

#include <Inventor/Win/viewers/SoWinFullViewer.h>

Inheritance diagram for SoWinFullViewer:

Public Types
enum	BuildFlag { BUILD_NONE = 0x00 , BUILD_DECORATION = 0x01 , BUILD_POPUP = 0x02 , BUILD_ALL = 0xff }
	This specifies what should be build by default in the constructor. More...

Public Types inherited from SoWinViewer
enum	Type { BROWSER , EDITOR }
	An EDITOR viewer will create a camera under the user supplied scene graph (specified in setSceneGraph()) if it cannot find one in the scene and will leave the camera behind when supplied with a new scene. More...

enum	DrawStyle { VIEW_AS_IS , VIEW_HIDDEN_LINE , VIEW_NO_TEXTURE , VIEW_LOW_COMPLEXITY , VIEW_LINE , VIEW_POINT , VIEW_BBOX , VIEW_LOW_RES_LINE , VIEW_LOW_RES_POINT , VIEW_SAME_AS_STILL }
	list of possible drawing styles More...

enum	DrawType { STILL , INTERACTIVE }
	DrawType. More...

enum	BufferType { BUFFER_SINGLE , BUFFER_DOUBLE , BUFFER_INTERACTIVE }
	list of different buffering types More...

enum	DecimationStrategy { NORMAL , FIXED_NUM_TRIANGLES , FRAMES_PER_SECOND , FIXED_PERCENTAGE }
	list of decimation strategies More...

enum	CursorStyle { CLASSIC , XOR , SHADOW }
	Classic cursors are all white and tend to disappear over white geometry or white background. More...

Public Types inherited from SoWinGLWidget
enum	FloatColorBufferSize { FLOAT_16_COLOR_BUFFER = SoGuiGLWidget::FLOAT_16_COLOR_BUFFER , FLOAT_32_COLOR_BUFFER = SoGuiGLWidget::FLOAT_32_COLOR_BUFFER }
	FloatColorBufferSize. More...

Public Member Functions
void	setDecoration (SbBool onOrOff)
	Shows/hides the viewer component trim (default on).

SbBool	isDecoration ()
	Returns whether the viewer component trim is on or off.

void	setPopupMenuEnabled (SbBool trueOrFalse)
	Enables/disables the viewer popup menu (default enabled).

SbBool	isPopupMenuEnabled ()
	Returns whether the viewer popup menu is enabled or disabled.

void	setClientPopupMenu (Hmenu hmenu)
	Enables application-specific popup menu.

SbBool	isClientPopupMenuInstalled ()
	Returns TRUE if an application-specific popup menu is installed.

SoWidget	getAppPushButtonParent () const
	Returns application push button parent.

void	addAppPushButton (SoWidget newButton)
	Adds application push button, which will be placed in the left hand side decoration trim.

void	insertAppPushButton (SoWidget newButton, int index)
	Adds application push button, which will be placed in the left hand side decoration trim.

void	removeAppPushButton (SoWidget oldButton)
	Removes specified application push button.

int	findAppPushButton (SoWidget oldButton)
	Returns index of specified push button.

int	lengthAppPushButton ()
	Returns number of application push buttons.

SoWidget	getRenderAreaWidget ()
	Returns the render area window handle.

virtual void	setViewing (SbBool onOrOff)
	Sets whether the viewer is turned on or off.

virtual void	setCamera (SoCamera *cam)
	Sets the camera that will be controlled by the viewer.

virtual void	hide ()
	This hides the component.

SoStereoDialog *	getStereoDialog ()

void	setStereoDialog (SoStereoDialog *newDialog)

void	addPushAppButtonCallback (PushAppButtonCB cb, void data=NULL)

void	addRedrawAppButtonCallback (RedrawAppButtonCB cb, void data=NULL)

Public Member Functions inherited from SoWinViewer
virtual void	setSceneGraph (SoNode *newScene)
	Sets the scene graph to render.

virtual SoNode *	getSceneGraph ()
	Gets the scene graph to be rendered in this component's window.

SoCamera *	getCamera ()
	Gets the camera controlled by the viewer.

virtual void	setCameraType (SoType type)
	Sets the camera type that will be created by the viewer if no cameras are found in the scene graph (see SoPerspectiveCamera and SoOrthographicCamera).

SoType	getCameraType ()
	Gets the camera type that will be created by the viewer if no cameras are found in the scene graph (see SoPerspectiveCamera and SoOrthographicCamera).

virtual void	setPreserveCameraHeightAngle (SbBool flag)
	If TRUE, an SoPerspectiveCamera's heightAngle is preserved if the camera is changed to an SoOrthographicCamera and then toggled back to an SoPerspectiveCamera.

virtual SbBool	isCameraHeightAnglePreserved () const
	Query whether the SoPerspectiveCamera's heightAngle is preserved if the camera is changed to an SoOrthographicCamera and then toggled back to an SoPerspectiveCamera.

virtual void	enableSeekWithOrtho (SbBool flag)
	If FALSE, the seek functionality is disabled for an SoOrthographicCamera.

virtual SbBool	isSeekWithOrthoEnabled () const
	Query whether the seek functionality is enabled for an SoOrthographicCamera.

virtual void	viewAll ()
	Changes the camera position to view the entire scene (the camera zoom or orientation isn't changed).

virtual void	saveHomePosition ()
	Saves the camera values.

virtual void	resetToHomePosition ()
	Restores the camera values.

void	setCameraTypeChangeCallback (SoWinViewerCameraTypeChangeCB callback, void userdata)
	Defines a callback which is called each time the camera type has changed (change from SoPerspectiveCamera to SoOrthographicCamera or vice versa).

void	setHeadlight (SbBool onOrOff)
	Turns the headlight on/off (default on).

SbBool	isHeadlight ()
	Queries if the headlight is on.

SoDirectionalLight *	getHeadlight ()
	Returns the headlight node.

void	setDrawStyle (SoWinViewer::DrawType type, SoWinViewer::DrawStyle style)
	Sets the current drawing style in the main view.

SoWinViewer::DrawStyle	getDrawStyle (SoWinViewer::DrawType type)
	Queries the current drawing style in the main view.

void	setBufferingType (SoWinViewer::BufferType type)
	Sets the current buffering type in the main view (default SoWinViewer::BUFFER_DOUBLE).

SoWinViewer::BufferType	getBufferingType ()
	Gets the current buffering type in the main view.

SbBool	isViewing () const
	Queries whether the viewer is turned on or off.

virtual void	setSeekMode (SbBool onOrOff)
	Externally set the viewer into/out off seek mode (default OFF).

SbBool	isSeekMode ()
	Queries whether the seek mode is active.

virtual void	setCursorEnabled (SbBool onOrOff)
	Sets whether the viewer is allowed to change the cursor over the renderArea window.

SbBool	isCursorEnabled () const
	Queries whether the viewer is allowed to change the cursor over the renderArea window.

void	setAutoClipping (SbBool onOrOff)
	Sets the auto clipping plane.

SbBool	isAutoClipping () const
	Queries if auto clipping is ON.

virtual void	setStereoViewing (SbBool onOrOff)
	Turns stereo viewing on/off on the viewer (default off).

virtual SbBool	isStereoViewing ()
	Queries if stereo viewing is on or off on the viewer.

void	setStereoOffset (float dist)
	Sets the stereo offset.

float	getStereoOffset ()
	Returns the stereo offset.

void	setDetailSeek (SbBool onOrOff)
	When the viewer is in seek mode, left mouse clicks initiate a pick, and the viewer changes its orientation and position to look at the picked object.

SbBool	isDetailSeek ()
	Queries whether detail seek is on.

void	setSeekTime (float seconds)
	Sets the time a seek takes to change to the new camera location.

float	getSeekTime ()
	Queries the seek time.

void	addStartCallback (SoWinViewerCB f, void userData=NULL)
	Adds start callback routine on the viewer.

void	addFinishCallback (SoWinViewerCB f, void userData=NULL)
	Adds finish callback routine on the viewer.

void	removeStartCallback (SoWinViewerCB f, void userData=NULL)
	Removes start callback routine from the viewer.

void	removeFinishCallback (SoWinViewerCB f, void userData=NULL)
	Removes finish callback routine from the viewer.

void	copyView (Time eventTime)
	Copies the view.

void	pasteView (Time eventTime)
	Pastes the view.

virtual void	setNormalVisual (XVisualInfo *i)
	Specifies the exact pixel format descriptor for the normal window.

virtual void	recomputeSceneSize ()
	This can be used to let the viewer know that the scene graph has changed so that the viewer can recompute things like speed which depend on the scene graph size.

void	setDecimationStrategy (SoWinViewer::DecimationStrategy strategy)
	Sets strategy to use to decide on decimation value.

SoWinViewer::DecimationStrategy	getDecimationStrategy ()
	Gets strategy to use to decide on decimation value.

void	setGoalNumberOfTriangles (int32_t goal)
	Sets goal number of triangles for the viewer to try to render.

int32_t	getGoalNumberOfTriangles ()
	Gets goal number of triangles for the viewer to try to render.

void	setGoalFramesPerSecond (float goal)
	Sets goal frames per second for the viewer to try to render.

float	getGoalFramesPerSecond ()
	Gets goal frames per second for the viewer to try to render.

void	setFixedPercentage (float percent)
	Sets fixed percentage for the viewer to render (0.0 to 1.0) Default is 1.0.

float	getFixedPercentage ()
	Gets fixed percentage for the viewer to render (0.0 to 1.0)

void	enableFullRenderingWhenStill (SbBool onOff)
	If this flag is set, the viewer will render at full resolution when it sits still for a certain period of time.

SbBool	isFullRenderingWhenStill ()
	Queries if the viewer will render at full resolution when it sits still for a certain period of time.

SbBool	isStillNow ()
	Returns whether the viewer is currently still.

void	setFramesPerSecondCallback (SoWinViewerFPSCB callback, void userData=NULL)
	Registers frames per second callback.

void	setNumSamples (int numFrames)
	Sets how many frames should be timed before frames per second callback is called, default is 10.

int	getNumSamples ()
	Gets how many frames should be timed before frames per second callback is called.

void	setDecimationPercentageCallback (SoWinViewerDecimationPercentageCB callback, void userData=NULL)
	Registers decimation percentage callback.

float	getCurrentDecimationPercentage ()
	Returns the Decimation Percentage the viewer used in its last render.

void	enableMouseWheelDolly (SbBool onOff)
	Enable/disable moving the camera with the mouse wheel, TRUE by default.

void	setPickRadius (float radius)
	Sets the pick radius, in pixels, used by the viewer for picking and seeking actions.

float	getPickRadius () const
	Returns the current pick radius for picking and seeking actions.

virtual SoCamera *	getViewerCamera ()
	Returns the camera so SoBaseStereo can manipulate it to achieve the stereo effect.

virtual SbBool	isViewerDoubleBuffer ()
	Returns TRUE if viewer is double buffered.

virtual void	actualRendering ()
	This method is called automatically when the viewer requests that its SoBaseStereo object perform stereo rendering.

virtual const SbVec2s &	getSize ()
	Returns the size of the OpenGL drawing window in absolute screen coordinates (not relative to parent window) of the native window system (typically Y increasing downward).

virtual const SbVec2s &	getTopLeft ()
	Returns the position of the OpenGL drawing window in absolute screen coordinates (not relative to parent window) of the native window system (typically Y increasing downward).

virtual const SbVec2s &	getBottomRight ()
	Returns the position of the OpenGL drawing window in absolute screen coordinates (not relative to parent window) of the native window system (typically Y increasing downward).

void	setStereoViewType (SoBaseStereo *stereo)
	Set an implementation of stereo viewing to use.

SoBaseStereo *	getStereoViewType ()
	Returns the current stereo implementation.

void	reverseStereoView (SbBool reverse)
	If TRUE, reverse the left and right eye views.

SbBool	isStereoViewReversed ()
	Returns TRUE if the left and right eye views are reversed.

virtual void	setStereoAbsoluteAdjustments (SbBool absolute)
	If TRUE, use stereo absolute adjustments.

virtual SbBool	isStereoAbsoluteAdjustments () const
	Returns TRUE if stereo absolute adjustments are enabled.

virtual void	setStereoBalance (float balance, SbBool nearFrac=false)
	Sets the stereo balance (the position of the zero parallax plane).

virtual float	getStereoBalance ()
	Returns the current stereo balance.

virtual SbBool	isStereoBalanceNearFrac ()
	Returns TRUE if the stereo balance adjustement is defined as a fraction of the camera near distance.

virtual void	setStereoActive (SbBool activate)
	If TRUE, stero is activated.

virtual SbBool	isStereoActive ()
	Returns TRUE if stereo is active.

void	setViewport (short left, short bottom, short width, short height)
	Sets viewport region with given origin (lower-left corner) and size, given as pixel coordinates.

void	getViewport (short &left, short &bottom, short &width, short &height)
	Returns viewport region as origin (lower-left corner) and size, given as pixel coordinates.

virtual void	setCursorStyle (SoWinViewer::CursorStyle style)
	Sets the cursor style.

SoWinViewer::CursorStyle	getCursorStyle ()
	Returns the cursor style.

void	setAutoClipTolerance (float tolerance)
	Sets the auto clipping tolerance value.

float	getAutoClipTolerance () const
	Returns the auto clipping tolerance value.

virtual void	setCameraSceneGraph (SoNode *cameraSceneGraph)
	Sets the sub-scene graph to be used for viewAll computation.

SoNode *	getCameraSceneGraph ()
	Gets the sub-scene graph to be viewed.

virtual void	toggleCameraType ()
	This routine will toggle the current camera from perspective to orthographic, and from orthographic back to perspective.

SbBool	getDepthValue (int x, int y, float &depth)
	Returns the depth value, scaled between 0.0 and 1.0, from the depth buffer at window coordinates x, y.

virtual SoDEPRECATED void	adjustClippingPlanes ()
	Along with the manipulation of the camera, SoBaseStereo needs to set the scene appropriately when changing the camera settings.

Public Member Functions inherited from SoWinRenderArea
	SoWinRenderArea (SoWidget parent=NULL, const char *name=NULL, SbBool buildInsideParent=TRUE, SbBool getMouseInput=TRUE, SbBool getKeyboardInput=TRUE)
	Constructor which is passed arguments which tell it whether to register the mouse and keyboard devices by default (SoWinMouse and SoWinKeyboard).

	~SoWinRenderArea ()
	Destructor.

void	registerDevice (SoWinDevice *d)
	Registers interest in devices.

void	unregisterDevice (SoWinDevice *d)
	Unregisters interest in devices.

void	setBackgroundColor (const SbColor &c)
	Sets the background color for this window.

SbColor	getBackgroundColor () const
	Gets the background color for this window.

void	setBackgroundIndex (int index)
	Sets the window background color when in color index mode.

int	getBackgroundIndex () const
	Gets the window background color when in color index mode.

void	setColorMap (int startIndex, int num, const SbColor *colors)
	Sets the colors to use when displaying in color index mode.

void	setViewportRegion (const SbViewportRegion &newRegion)
	Sets viewport region to use for rendering.

const SbViewportRegion &	getViewportRegion () const
	Gets current viewport region to use for rendering.

void	setTransparencyType (SoGLRenderAction::TransparencyType type)
	Sets the algorithm for rendering transparent objects.

SoGLRenderAction::TransparencyType	getTransparencyType () const
	Gets the algorithm for rendering transparent objects.

void	setFastEditSavePolicy (SoGLRenderAction::FastEditSavePolicy policy, SbBool fastEditDelayedObjects=FALSE)
	Sets fast editing save policy to use when rendering.

SoGLRenderAction::FastEditSavePolicy	getFastEditSavePolicy () const
	Returns fast editing save policy used when rendering.

void	setInvalidateCacheMode (SoGLRenderAction::InvalidateCacheMode icm)
	Enables or disables the invalidation of render caches.

SoGLRenderAction::InvalidateCacheMode	getInvalidateCacheMode ()
	Returns the current cache invalidation mode.

void	setClearBeforeRender (SbBool trueOrFalse, SbBool zbTrueOrFalse=TRUE)
	Enables/prevents window clearing from happening before a rendering starts (default is clear TRUE).

SbBool	isClearBeforeRender () const
	Queries whether the window will be cleared before rendering starts.

SbBool	isClearZBufferBeforeRender () const
	Queries whether the depth buffer (sometimes called the Z buffer) will be cleared before rendering starts.

void	setAutoRedraw (SbBool trueOrFalse)
	The render area will automatically redraw whenever something in the scene graph changes.

SbBool	isAutoRedraw () const
	Queries whether the render area will automatically redraw whenever something in the scene graph changes.

void	setRedrawPriority (unsigned long priority)
	Sets the priority of the redraw sensor.

unsigned long	getRedrawPriority () const
	Gets the priority of the redraw sensor.

void	render ()
	Calling this forces the render area to be redrawn now.

void	scheduleRedraw ()
	Schedules a redraw to happen sometime soon (as opposed to immediately).

void	redrawOnSelectionChange (SoSelection *s)
	Call this convenience method to have this render area redraw whenever the selection list changes in the passed node.

void	setEventCallback (SoWinRenderAreaEventCB fcn, void userData=NULL)
	Windows messages which occur in the render area window are either directly handled by the viewer (when this is really a viewer) or automatically translated to SoEvents, then passed into the scene graph (via the SoHandleEventAction) so that live scene graph objects can handle the message (when viewers are not in viewing mode).

void	setSceneManager (SoSceneManager *sm)
	Sets the normal scene manager.

SoSceneManager *	getSceneManager () const
	Gets the normal scene manager.

void	setGLRenderAction (SoGLRenderAction *ra)
	Sets the GL render action to use.

SoGLRenderAction *	getGLRenderAction () const
	Gets the current GL render action.

const SbGLShareContext	getShareContext ()
	Returns the information needed to make OpenGL render contexts share OpenGL objects, for example, display lists and texture objects.

void	setPostRenderCallback (SoWinRenderAreaRenderCB fcn, void userData=NULL)
	Specifies a function to be called after the Open Inventor render traversal and immediately before the OpenGL buffer swap.

SoWinRenderAreaRenderCB *	getPostRenderCallback (const void *&userData) const
	Gets the post-render callback function and data.

void	setFloatingColorBuffer (SbBool enable, FloatColorBufferSize size=FLOAT_16_COLOR_BUFFER)
	Enables/disables floating point rendering using 16- or 32-bit components.

void	getFloatingColorBuffer (SbBool &enable, FloatColorBufferSize &size)
	Returns TRUE if floating point rendering is used and its precision.

void	sendEvent (XAnyEvent *anEvent)
	Sends the event to be processed by the renderArea.

virtual void	setMPEGRecorder (SoMPEGRenderer *recorder)
	Sets the recorder used for MPEG encoding.

virtual SoMPEGRenderer *	getMPEGRecorder () const
	Returns the recorder used for MPEG encoding.

Public Member Functions inherited from SoWinGLWidget
virtual Window	getNormalWindow ()
	Gets the normal GL window, which is needed as an argument to SbGlContextHelper::makeCurrent() when drawing in the normal planes.

GLXContext	getNormalContext ()
	Gets the normal context, which is needed as an argument to SbGlContextHelper::makeCurrent() when drawing in the normal planes.

virtual SoGLContext *	getNormalSoContext ()

Hdc	getNormalDC () const
	Returns the device context (which is needed for SbGlContextHelper::makeCurrent).

void	setStealFocus (SbBool onOrOff)
	By default the GLWidget "steals" focus whenever the cursor moves over it.

SoWidget	getNormalWidget () const
	Gets the normal window handle, which is needed as an argument to SbGlContextHelper::makeCurrent() when drawing in the normal planes.

XVisualInfo *	getNormalVisual ()
	Returns the pixel format descriptor for the normal window.

virtual void	setPixelFormat (int format)
	Sets the current pixel format.

int	getPixelFormat ()
	Returns the current pixel format.

void	setAntialiasing (const float quality, const SoSceneManager::AntialiasingMode mode=SoSceneManager::AUTO)
	Enable (or disable) antialiasing with specified quality and mode.

void	setAntialiasing (SoAntialiasingParameters *advancedParameters)
	Enable (or disable) antialiasing with specific parameters.

float	getAntialiasingQuality () const
	Returns the antialiasing quality set using the setAntialiasing(float,AntialiasingMode) method.

SoSceneManager::AntialiasingMode	getAntialiasingMode () const
	Returns the antialiasing mode set using the setAntialiasing(float,AntialiasingMode) method.

SoAntialiasingParameters *	getAntialiasingParameters () const
	Returns the antialiasing parameters set using the setAntialiasing(SoAntialiasingParameters*) method.

void	setDoubleBuffer (SbBool onOrOff)
	Routine that dynamically changes between single and double buffering.

SbBool	isDoubleBuffer ()
	Returns whether double buffering is on or off.

void	setBorder (SbBool onOrOff)
	Included for portability only.

int	getBorderSize ()
	Included for portability only.

SbBool	isBorder () const
	Included for portability only.

void	setDrawToFrontBufferEnable (SbBool enableFlag)
	Sets drawing to the front buffer.

SbBool	isDrawToFrontBufferEnable () const
	Returns whether drawing to the front buffer is enabled.

void	setCursor (Cursor newCursor)
	Sets the current cursor.

Cursor	getCursor ()
	Returns the current cursor.

virtual SbBool	bindNormalContext ()
	Makes the normal rendering context the current context.

virtual SbBool	unbindNormalContext ()
	unbind the current context (previously bind with bindNormalContext );

virtual SbBool	swapNormalBuffers ()
	Swaps the normal front and back buffers.

SoGLGraphicConfigTemplate *	getGraphicConfigTemplate ()
	Gets the current graphics configuration template.

void	setGraphicConfigTemplate (SoGLGraphicConfigTemplate *gTemplate)
	Sets a new graphics configuration template.

bool	saveSnapshot (const SbString &filename, bool overwrite=true)
	Save a snapshot of the current image displayed in the viewer.

Public Member Functions inherited from SoWinComponent
virtual void	show ()
	This shows the component.

SbBool	isVisible ()
	Returns TRUE if this component is mapped onto the screen.

SoWidget	getWidget () const
	This returns the base window handle for this component.

SbBool	isTopLevelShell () const
	Returns TRUE if this component is a top level shell component (has its own window).

SoWidget	getShellWidget () const
	Returns the shell window handle (NULL if the shell hasn't been created by this component).

SoWidget	getParentWidget () const
	Returns the parent window handle, be it a shell or not.

void	setSize (const SbVec2s &size)
	Convenience routine on the window handle.

SbVec2s	getSize ()
	Convenience routine on the window handle.

SbBool	setFullScreen (const SbBool enable)
	Switches the viewer into (or out of) fullscreen mode.

SbBool	isFullScreen () const
	Queries if the viewer is in fullscreen mode.

void	setFullScreenEnable (const SbBool enable)
	Enables/disables fullscreen mode.

SbBool	isFullScreenEnable (void) const
	Queries if it is possible to put the viewer in fullscreen mode.

UINT *	getDisplay ()
	Included for portability only.

SoNONUNICODE void	setTitle (const char *newTitle)
	Sets window title.

void	setTitle (const SbString &newTitle)
	Sets window title.

SbString	getTitle () const
	Gets window title.

SoNONUNICODE void	setIconTitle (const char *newIconTitle)
	Included for portability only.

void	setIconTitle (const SbString &newIconTitle)
	Included for portability only.

SbString	getIconTitle () const
	Included for portability only.

void	setWindowCloseCallback (SoWinComponentCB func, void data=NULL)
	Sets which callback to call when the user closes this component (double click in the upper left corner) - by default hide() is called on this component, unless a callback is specified.

SbString	getWidgetName () const
	Returns the window handle name.

SbString	getClassName () const
	Returns the class name.

virtual	~SoWinComponent ()
	Destructor.

Public Member Functions inherited from SoStereoViewer
virtual	~SoStereoViewer ()
	Destructor.

Static Public Member Functions
static void	setDoButtonBar (SbBool onOrOff)
	Create the next instance of fullviewer w/wo the buttonbar.

static SbBool	isDoButtonBar ()
	Returns whether the buttonbar is enabled or disabled.

Static Public Member Functions inherited from SoWinRenderArea
static unsigned long	getDefaultRedrawPriority ()
	Gets the default priority number of the redraw sensor.

static SbBool	isFloatingColorBufferSupported ()
	Returns TRUE if floating point rendering is available.

Static Public Member Functions inherited from SoWinComponent
SoDEPRECATED static SoNONUNICODE void	displayHelp (const char *filename, UINT contextID)
	Static method to display the specified topic of the specified help file.

static SoDEPRECATED void	displayHelp (const SbString &filename, UINT contextID)
	Static method to display the specified topic of the specified help file.

static SoWinComponent *	getComponent (SoWidget w)
	Returns the SoWinComponent for this window handle.

Public Attributes
SoCallbackList	popupPostCallback
	The callbacks in this list will be invoked after the action selected from the viewer popup has been performed.

SoCallbackList	popupPreCallback
	The callbacks in this list are invoked immediately prior to display of the popup menu, regardless of whether it is the pre-defined viewer menu or a menu installed by the client application.

Hmenu	rootPopup
	Pointer to the popup menu container.

Hmenu	mainPopup
	Pointer to the root of the popup menu.

Hmenu	funcPopup
	Pointer to the Functions submenu.

Hmenu	drawPopup
	Pointer to the Draw Style submenu.

Hmenu	prefPopup
	Pointer to the Preferences submenu.

UINT	curPopupDrawItem
	In this version we track the currently "check marked" menu item in the Draw Style submenu (only one checked at a time).

UINT	curPopupMoveItem

UINT	curPopupBufferItem

Hmenu	hClientPopup
	Popup menu provided by a client (i.e.

Public Attributes inherited from SoWinComponent
SbString	helpFileName
	Name of help file to open when the viewer Help button is pressed.

UINT	helpContextID
	The context ID of the help topic to open when the viewer Help button is pressed.

SbString	helpContextString
	The TopicID of the help topic to open when the viewer Help button is pressed.

Detailed Description

Base viewer class which adds a decoration around the rendering area.

This is a base class used by all viewer components. The class adds a decoration around the rendering area which includes thumb wheels, a zoom slider and push buttons. This base class also includes a viewer popup menu and a preference sheet with generic viewing functions. The constructors for the various subclasses of SoWinFullViewer provide a flag for specifying whether the decoration and popup menus should be built.

Member Enumeration Documentation

◆ BuildFlag

enum SoWinFullViewer::BuildFlag

This specifies what should be build by default in the constructor.

Enumerator
BUILD_NONE	Doesn't build anything extra.
BUILD_DECORATION	Build the decoration only.
BUILD_POPUP	Build the popup menu only.
BUILD_ALL	Build everything by default.

Definition at line 84 of file SoWinFullViewer.h.

Member Function Documentation

◆ addAppPushButton()

void SoWinFullViewer::addAppPushButton ( SoWidget newButton )

Adds application push button, which will be placed in the left hand side decoration trim.

Buttons are appended to the end of the list.

Note: The button bitmaps should be 24-by-24 pixels to fit nicely into the decoration trim like the other viewer buttons.

◆ addPushAppButtonCallback()

void SoWinFullViewer::addPushAppButtonCallback	(	PushAppButtonCB *	cb,
		void *	data = `NULL`
	)

inline

Definition at line 306 of file SoWinFullViewer.h.

◆ addRedrawAppButtonCallback()

void SoWinFullViewer::addRedrawAppButtonCallback	(	RedrawAppButtonCB *	cb,
		void *	data = `NULL`
	)

inline

Definition at line 311 of file SoWinFullViewer.h.

◆ findAppPushButton()

int SoWinFullViewer::findAppPushButton ( SoWidget oldButton )

inline

Returns index of specified push button.

Definition at line 237 of file SoWinFullViewer.h.

◆ getAppPushButtonParent()

SoWidget SoWinFullViewer::getAppPushButtonParent ( ) const

inline

Returns application push button parent.

Definition at line 205 of file SoWinFullViewer.h.

◆ getRenderAreaWidget()

SoWidget SoWinFullViewer::getRenderAreaWidget ( )

inline

Returns the render area window handle.

Definition at line 247 of file SoWinFullViewer.h.

◆ getStereoDialog()

SoStereoDialog * SoWinFullViewer::getStereoDialog ( )

inline

Definition at line 255 of file SoWinFullViewer.h.

◆ hide()

virtual void SoWinFullViewer::hide ( )

virtual

This hides the component.

It calls the appropriate unrealize or unmanage routines.

Reimplemented from SoWinComponent.

◆ insertAppPushButton()

void SoWinFullViewer::insertAppPushButton	(	SoWidget	newButton,
		int	index
	)

Adds application push button, which will be placed in the left hand side decoration trim.

Buttons are inserted at the desired index.

Note: The button bitmaps should be 24-by-24 pixels to fit nicely into the decoration trim like the other viewer buttons.

◆ isClientPopupMenuInstalled()

SbBool SoWinFullViewer::isClientPopupMenuInstalled ( )

inline

Returns TRUE if an application-specific popup menu is installed.

Definition at line 200 of file SoWinFullViewer.h.

◆ isDecoration()

SbBool SoWinFullViewer::isDecoration ( )

inline

Returns whether the viewer component trim is on or off.

Definition at line 116 of file SoWinFullViewer.h.

◆ isDoButtonBar()

static SbBool SoWinFullViewer::isDoButtonBar ( )

inlinestatic

Returns whether the buttonbar is enabled or disabled.

Definition at line 166 of file SoWinFullViewer.h.

◆ isPopupMenuEnabled()

SbBool SoWinFullViewer::isPopupMenuEnabled ( )

inline

Returns whether the viewer popup menu is enabled or disabled.

Definition at line 154 of file SoWinFullViewer.h.

◆ lengthAppPushButton()

int SoWinFullViewer::lengthAppPushButton ( )

inline

Returns number of application push buttons.

Definition at line 242 of file SoWinFullViewer.h.

◆ removeAppPushButton()

void SoWinFullViewer::removeAppPushButton ( SoWidget oldButton )

Removes specified application push button.

◆ setCamera()

virtual void SoWinFullViewer::setCamera ( SoCamera * cam )

virtual

Sets the camera that will be controlled by the viewer.

Setting the camera is only needed if the first camera found in the scene when setting the scene graph isn't the one that should be controlled.

Reimplemented from SoWinViewer.

Reimplemented in SoWinExaminerViewer, SoWinFlyViewer, SoWinPlaneViewer, SoWinWalkViewer, and SoWinConstrainedViewer.

◆ setClientPopupMenu()

void SoWinFullViewer::setClientPopupMenu ( Hmenu hmenu )

Enables application-specific popup menu.

◆ setDecoration()

void SoWinFullViewer::setDecoration ( SbBool onOrOff )

Shows/hides the viewer component trim (default on).

See the viewer constructor to prevent the decoration from being built.

The default value can be set using the environment variable OIV_VIEWER_DECORATION (0 = OFF, 1 = ON).

◆ setDoButtonBar()

static void SoWinFullViewer::setDoButtonBar ( SbBool onOrOff )

static

Create the next instance of fullviewer w/wo the buttonbar.

◆ setPopupMenuEnabled()

void SoWinFullViewer::setPopupMenuEnabled ( SbBool trueOrFalse )

Enables/disables the viewer popup menu (default enabled).

See the viewer constructor to prevent the popup menu from being built.

The default value can be set using the environment variable OIV_VIEWER_POPUP_MENU (0 = OFF, 1 = ON).

Description or equivalent function for each submenu of this popup menu:

Functions: Manage the position of the camera:
- Home see resetToHomePosition()
- Set home see saveHomePosition()
- View all see viewAll()
- Seek see seekToPoint(const SbVec2s& mouseLocation)
DrawStyle: Manage the draw style and buffering style:
- see setDrawStyle(DrawType type, DrawStyle style)
- see setBufferingType(BufferType type)
Viewing: see setViewing()
Decorations: see setDecoration()
FullScreen: see setFullScreen()
HeadLight: see setHeadlight()
Preferences:
- Seek to point: Enables/disables seek mode (like the 'S' key)
- Auto clip planes: Enables/disables automatic clipping
- Automatic interactive mode: Enables/disables automatic interactive mode
- Stereo: Opens the stereo dialog
- Anti-aliasing: see setAntialiasing()
- Record: Opens the recording dialog
- Rotation axes: Shows/hides the rotation axes

◆ setStereoDialog()

void SoWinFullViewer::setStereoDialog ( SoStereoDialog * newDialog )

inline

Definition at line 256 of file SoWinFullViewer.h.

◆ setViewing()

virtual void SoWinFullViewer::setViewing ( SbBool onOrOff )

virtual

Sets whether the viewer is turned on or off.

When turned on, messages are consumed by the viewer. When viewing is off, messages are processed by the viewer's render area. This means messages will be sent down to the scene graph for processing (i.e. picking can occur). Note that if the application has registered a message callback , it will be invoked on every message, whether viewing is turned on or not. However, the return value of this callback (which specifies whether the callback handled the message or not) is ignored when viewing is on. That is, the viewer will process the message even if the callback already did. This is to ensure that the viewing paradigm is not broken (default viewing is on).

Reimplemented from SoWinViewer.

Reimplemented in SoWinExaminerViewer, SoWinFlyViewer, SoWinPlaneViewer, and SoWinWalkViewer.

Member Data Documentation

◆ curPopupBufferItem

UINT SoWinFullViewer::curPopupBufferItem

Definition at line 299 of file SoWinFullViewer.h.

◆ curPopupDrawItem

UINT SoWinFullViewer::curPopupDrawItem

In this version we track the currently "check marked" menu item in the Draw Style submenu (only one checked at a time).

Tracks the checkmark for "Still" draw style.

Definition at line 289 of file SoWinFullViewer.h.

◆ curPopupMoveItem

UINT SoWinFullViewer::curPopupMoveItem

Definition at line 294 of file SoWinFullViewer.h.

◆ drawPopup

Hmenu SoWinFullViewer::drawPopup

Pointer to the Draw Style submenu.

Definition at line 276 of file SoWinFullViewer.h.

◆ funcPopup

Hmenu SoWinFullViewer::funcPopup

Pointer to the Functions submenu.

Definition at line 271 of file SoWinFullViewer.h.

◆ hClientPopup

Hmenu SoWinFullViewer::hClientPopup

Popup menu provided by a client (i.e.

application program) of the viewer.

Definition at line 304 of file SoWinFullViewer.h.

◆ mainPopup

Hmenu SoWinFullViewer::mainPopup

Pointer to the root of the popup menu.

Definition at line 266 of file SoWinFullViewer.h.

◆ popupPostCallback

SoCallbackList SoWinFullViewer::popupPostCallback

The callbacks in this list will be invoked after the action selected from the viewer popup has been performed.

This applies to actions selected from only from the viewer popup, not from the clients popup. Note that it is possible to add the viewer's pre-defined popup as a submenu of the client's popup. In this case the callbacks in this list are still invoked after actions selected from the viewer popup are performed. The callback data for the callback is a pointer to the SoWinFullViewer object.

Definition at line 179 of file SoWinFullViewer.h.

◆ popupPreCallback

SoCallbackList SoWinFullViewer::popupPreCallback

The callbacks in this list are invoked immediately prior to display of the popup menu, regardless of whether it is the pre-defined viewer menu or a menu installed by the client application.

The callback data for the callback is a pointer to the SoWinFullViewer object.

Definition at line 188 of file SoWinFullViewer.h.

◆ prefPopup

Hmenu SoWinFullViewer::prefPopup

Pointer to the Preferences submenu.

Definition at line 281 of file SoWinFullViewer.h.

◆ rootPopup

Hmenu SoWinFullViewer::rootPopup

Pointer to the popup menu container.

Definition at line 261 of file SoWinFullViewer.h.

The documentation for this class was generated from the following file:

Inventor/Win/viewers/SoWinFullViewer.h

Open Inventor Release 2023.2.3

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Detailed Description

SEE ALSO

Member Enumeration Documentation

◆ BuildFlag

Member Function Documentation

◆ addAppPushButton()

◆ addPushAppButtonCallback()

◆ addRedrawAppButtonCallback()

◆ findAppPushButton()

◆ getAppPushButtonParent()

◆ getRenderAreaWidget()

◆ getStereoDialog()

◆ hide()

◆ insertAppPushButton()

◆ isClientPopupMenuInstalled()

◆ isDecoration()

◆ isDoButtonBar()

◆ isPopupMenuEnabled()

◆ lengthAppPushButton()

◆ removeAppPushButton()

◆ setCamera()

◆ setClientPopupMenu()

◆ setDecoration()

◆ setDoButtonBar()

◆ setPopupMenuEnabled()

◆ setStereoDialog()

◆ setViewing()

Member Data Documentation

◆ curPopupBufferItem

◆ curPopupDrawItem

◆ curPopupMoveItem

◆ drawPopup

◆ funcPopup

◆ hClientPopup

◆ mainPopup

◆ popupPostCallback

◆ popupPreCallback

◆ prefPopup

◆ rootPopup