Easy Studierstube Applications with a little help from OpenInventor Gerhard Reitmayr Gerhard Reitmayr Vienna University of Technology Vienna University of Technology

Gerhard Reitmayr StbDay 2 – Stb application requirements User interface design needs iterative development. User interface design needs iterative development. Need to be adapted to different user interface modalities. Need to be adapted to different user interface modalities. Demos need to be kept alive ! Demos need to be kept alive ! Reuse of application features is very desirable. Reuse of application features is very desirable.

Gerhard Reitmayr StbDay 2 – User interface components 3D window PIP pen icon widgets content

Gerhard Reitmayr StbDay 2 – Structure of an application SoMyContextKit Widgets Scene graph Application Different modalities Different presentation styles Reuse this ?

Gerhard Reitmayr StbDay 2 – Skeleton of an application SoApplicationKit { contextKit SomeApplication { templatePipSheet Separator { # your PIP sheet widgets } windowGroup Group { # content and windows ! } # all kinds of application # specific fields }

Gerhard Reitmayr StbDay 2 – Use the file format ! Let your application become an understandable part of an OIV file. Let your application become an understandable part of an OIV file. Use fields as inputs and outputs of applications. Use fields as inputs and outputs of applications. Build scene graphs in the OIV file instead of in code. Build scene graphs in the OIV file instead of in code. Try to write all applications as pure OIV nodekits ! Try to write all applications as pure OIV nodekits !

Gerhard Reitmayr StbDay 2 – Fields as inputs/outputs Connecting to widgets Connecting to widgets Callbacks tie you to the type of widget Callbacks tie you to the type of widget Lower abstraction used then necessary e.g. observe 3 buttons instead of a 3 valued state variable. Lower abstraction used then necessary e.g. observe 3 buttons instead of a 3 valued state variable. Use fields that represent exactly the state the application needs. Use fields that represent exactly the state the application needs. Output states as fields allows simple change of presentation. Output states as fields allows simple change of presentation.

Gerhard Reitmayr StbDay 2 – OIV: Observing changes Sensors are the callbacks of OIV ! Sensors are the callbacks of OIV ! SoFieldSensor SoFieldSensor Only one field per sensor Only one field per sensor Not ref counted > take care yourself Not ref counted > take care yourself SoNodeSensor SoNodeSensor Reports changes on node / sub scene graph Reports changes on node / sub scene graph Beware of node fields Beware of node fields

Gerhard Reitmayr StbDay 2 – Scene graphs as parameters Use node fields Use node fields As templates for complex scene graphs As templates for complex scene graphs Use parts Use parts For scene graphs that need traversal For scene graphs that need traversal Use conventions Use conventions Node type, e.g. set a texture to be picked up by geometry in the graph Node type, e.g. set a texture to be picked up by geometry in the graph Search for a given name, type and change its fields Search for a given name, type and change its fields

Gerhard Reitmayr StbDay 2 – Parameterized scene graphs Using context sensitive traversal Using context sensitive traversal New element SoContextElement New element SoContextElement Maps int -> int Maps int -> int Context[3] = 2 Context[3] = 2 Context[-5] = NIL Context[-5] = NIL SoContext to modify context during traversal SoContext to modify context during traversal SoContextSwitch (…) SoContextSwitch (…) Modify traversal depending on context Modify traversal depending on context

Gerhard Reitmayr StbDay 2 – Context 2->0 Context Example Context 2->1 ContextSwitc h index[2] Geometr y Group Color green Color red

Gerhard Reitmayr StbDay 2 – OIV : NodeKits - concept A nodekit represents a tightly integrated template scene graph with meaning to the developer. A nodekit represents a tightly integrated template scene graph with meaning to the developer. We get We get Fixed scene graph Fixed scene graph Represented by a node Represented by a node Internal connections Internal connections OIV interface of fields and children OIV interface of fields and children

Gerhard Reitmayr StbDay 2 – Nodekit structure Root node Private parts Public parts SoTrackedArtifaktKit

Gerhard Reitmayr StbDay 2 – OIV : setUpConnections Central method to establish connections within a nodekit. Central method to establish connections within a nodekit. Signals nodekit when the structure changes. Signals nodekit when the structure changes. Important for Important for Correct loading of applications Correct loading of applications Distributed OpenInventor Distributed OpenInventor

Gerhard Reitmayr StbDay 2 – OIV : setupConnections

Gerhard Reitmayr StbDay 2 – Navigation app – 1

Gerhard Reitmayr StbDay 2 – Navigation app - 2 DEF NavKit NavigationContext { DEF NavKit NavigationContext { waypoint ["Karlskirche",… ] waypoint ["Karlskirche",… ] waypointPosition [0 1 0,… ] waypointPosition [0 1 0,… ] edge [1,… ] edge [1,… ] numEdge [3,… ] numEdge [3,… ] userPosition = SoTrakEngine{}.translation userPosition = SoTrakEngine{}.translation destination = USE waypointList.selected destination = USE waypointList.selected path [“Karlskirche”,… ] path [“Karlskirche”,… ] edgeIndex [1,2,3] nodeIndex [2,3,5,10] edgeIndex [1,2,3] nodeIndex [2,3,5,10] templatePipSheet SoPipSheetKit {…} templatePipSheet SoPipSheetKit {…} windowGroup So3DSeparator {…} windowGroup So3DSeparator {…} }

Gerhard Reitmayr StbDay 2 – Thank you ?

Gerhard Reitmayr StbDay 2 – SoClassLoader classLoader SoClassLoader { className "MyOIVNode" fileName "../somewhere/mynodes" } MyOIVNode { … } Load OIV classes from within a file ! Load OIV classes from within a file !

Gerhard Reitmayr StbDay 2 – Timing issues Delayed execution Delayed execution SoOneShotSensor SoOneShotSensor SoAlarmSensor SoAlarmSensor Repeated actions Repeated actions SoTimeSensor SoTimeSensor SoIdleSensor SoIdleSensor

Gerhard Reitmayr StbDay 2 – Stb Applications Applications are OpenInventor nodekits Applications are OpenInventor nodekits Subclasses of SoContextKit Subclasses of SoContextKit Implementation as shared library (dll,so) Implementation as shared library (dll,so) Additional callback API for Additional callback API for User specific data User specific data Distribution Distribution

Gerhard Reitmayr StbDay 2 – Writing STB applications SoApplicationKit SoApplicationKit SoClassLoader SoClassLoader SoContextKit SoContextKit templatePipSheet templatePipSheet windowGroup windowGroup

Gerhard Reitmayr StbDay 2 – Interfacing SoContextKit Use fields as interface Use fields as interface Avoid connections based on names, pointers, etc Avoid connections based on names, pointers, etc Special patterns for multi user applications Special patterns for multi user applications Use localized search Use localized search

Gerhard Reitmayr StbDay 2 – PIP - personal interaction panel PIP App 1 App 2 PipSheet PipSheet 1 PipSheet 2 System Sheet User

Gerhard Reitmayr StbDay 2 – PIP Komponenten system tab window tab sheet tab

Gerhard Reitmayr StbDay 2 – Remedy – OpenInventor A set of guidelines to A set of guidelines to Structure application API Structure application API Structure data flow in application Structure data flow in application Modularize applications Modularize applications OpenInventor can support us here ! OpenInventor can support us here !

Gerhard Reitmayr StbDay 2 – Beispiel : hello world SoApplicationKit { contextKit SoContextKit { windowGroup DEF Hello Group { Material {diffuseColor } Scale {scaleFactor } Font { size 1 } Text3 { string ["Hello", "World !"] justification CENTER parts ALL } templatePipSheet USE Hello }

Gerhard Reitmayr StbDay 2 – Guidelines Data driven implementation Data driven implementation Store all data in fields or children Store all data in fields or children React to changes and update internal and dependent state React to changes and update internal and dependent state  > Very flexible  > Highly reusable components

Gerhard Reitmayr StbDay 2 – Lifetime of an application Loading Initialisation SoMyAppKit per user Interaction checkPipGeometry() checkWindowGeometry() checkPipConnections() checkPipMasterMode() focusChange() windowEventCB()