SoCameraInteraction

InventorModule

status	work-in-progress
author	Uwe Siems
package	MeVisLab/Standard
dll	SoCameraInteraction
definition	SoCameraInteraction.def
see also	SoRenderArea, SoExaminerViewer, RemoteRendering
keywords	camera, interaction, view

Purpose

This module implements camera steering with an additional headlight, similar to that provided by a SoExaminerViewer.

Usage

Attach the part of the scene you want to have camera control over to the inScene input and the module itself to your inventor scene. If you need to change the mouse button or key bindings from their current defaults, you need to use a SoInteractionMapping module.

Interaction

The default interaction for this module is: Left mouse button: Rotate camera Shift+left mouse button: Pan camera Control+left mouse button: Zoom camera.

You need a SoInteractionMapping module to change this bindings. It is also needed to connect the commands "ViewAll", "SetHome", "GotoHome" and "ToggleCamera" to key bindings.

Input Fields

inScene

name: inScene, type: SoNode

Attach the part of the scene you want to have camera control over to this input (if you need to attach more than one element, you need to combine them with a SoGroup or SoSeparator).

Output Fields

self

name: self, type: SoNode

Connect the output e.g. to a SoRenderArea.

Parameter Fields

Hidden Fields

viewAll

name: viewAll, type: Trigger

Trigger this to make the camera zoom out (or in) till the sub-scene of this module just fits into the viewport. (This command uses the bounding box of OpenInventor nodes.)

setHome

name: setHome, type: Trigger

Trigger this to set the current camera position as the home position which will be set by gotoHome.

gotoHome

name: gotoHome, type: Trigger

Trigger this to set the camera position to the one marked with setHome.

toggleCamera

name: toggleCamera, type: Trigger

Trigger this to toggle between perspective and orthographic camera.