How to : use Present3D Additional Features

PAGE CURRENTLY BEING EDITED :

List of Additional Features :

Requires OSG 2.9.x and up to date OSG-Data :

Additional Tags :

hud tag to have static background or foreground layer : here
billboard tag to have image elements always face the camera : here
exit tag to auto exit show at end of show : here
loop tag to auto loop show : here
jump tag to jump from one slide to another within a show : here
vnc tag to include the display from another computer as a window within a slide scene : here
movie tag to include webcam or live camera feed as a window within a slide scene : here
env tag to set environmental variables in the xml file : here
path tag to set path environmental variables in the xml file : here

Additional Features without Tags :

audio/video spanning to allow audio or video tracks to span ( continue playing over) multiple slides : here

Additional Features that have How To pages :

VNC in a window within P3D : page
Movie : Live Video Stream into a window within P3D : page
Jump within P3D show : page
Volume files : in P3D : page
Volume files : Viewing and saving with OsgVolume : page

Other features that require additional installations

<browser> Browser in a window within P3D : working on Linux : to be confirmed for OSX
<pdf> PDF in a window within P3D : working on Linux : to be confirmed for OSX

Additional Tags and controls :

HUD :

hud="on" will create a static image or movie file, unaffected by the camera manipulators.

<image hud="on">image.jpg</image>

<image hud="on">video.mov</image>

Can be used within <image>, <stereo_image>, <vnc>, <pdf>, <browser> and <background>

Possible uses :

To create a static background image or video, while still able to move and rotate other objects in the scene.
To create static foreground elements such as logos.

Known Issues :

It will be possible to push the manipulated object through or clash with these static layers. This is a design issue you should take into consideration.

Billboard :

billboard="on" will create an image or movie element, that will always face the camera.

<image billboard="on">image.jpg</image>

<image billboard="on">video.mov</image>

Can be used within <image>, <stereo_image>, <vnc>, <pdf>, <browser> and <background>

Possible uses :

To create labels that will move with the object, but always face the camera.

Known Issues :

It will be possible to push a manipulated object through or clash with these billboards. This is a design issue you should take into consideration.

Exit Presentation :

<exit> exit or escape function as a slide and a button/layer tag.

<exit>exit_image.jpg</exit>

Usage add exit tag to a layer, on advancing to a layer containing exit P3D will exit immediately.

Possible uses :

On entering final slide of a show with <exit></exit> in a layer, the show will exit to the desktop.
Where a second show is loaded by using the click to run feature, use of the exit tag on entering final slide in the second show it escapes back to the previous show
Where a Present3D menu is used to load various shows, use of the exit tag at the end of these shows will bring you back to the menu show.
As with click to run feature, the exit tag can be used with an image or text to create a button to escape back to the previous show.

#cccccc; back

Loop :

<loop> to loop show :

Usage, add the follow to top of the xml file, just below the presentation tag:

Possible uses :

To create a show that will loop continuously.

#cccccc; background-color: #cccccc; min-height: 1.0px">

Jump :

<jump> Used to jump x number slides back or forwards within the current show

Usage:

like click to run but within the same show, so applied to image/model/text and clicking on will jump x number of slides forward or backward. Or jump to a named slide, this would have the advantage that adding, removing or moving slides would not interfere with these links. Usage:

Possible uses :

Known issues :

VNC :

<vnc> Use the vnc tag within a layer :

<vnc>network_address_of_your_Mac</vnc> for example <vnc>192.168.0.5</vnc>

This will make the vnc window fill the screen in your P3D show. You can change its size, location, fade etc; just as you would for an image or movie.

Further information on use of vnc can be found here : How to : VNC

Live Stream :

Live Stream into a window within P3D : page

For use with video capture card or webcam.

Environmental variable usage and setting, and paths :

Usage:

<env>OSG_COMPUTE_NEAR_FAR_MODE=COMPUTE_NEAR_FAR_USING_PRIMITIVES</env>

<env>OSG_NEAR_FAR_RATIO=0.00001</env>

Path :

<path>${DATA_DIR}/OpenSceneGraph-Data</path>

<path>${DATA_DIR}/Images</path>

<path>${DATA_DIR}/Models</path>

<path>${DATA_DIR}/Earth</path>

#cccccc; background-color: #cccccc; min-height: 1.0px">

Click to run and jump :

additional option of moving forward x slides in parent show. Usage - add following options to the click_to_run : jump="realtive" or "absolute" and then slide="num" and layer="num", example:

<layer>

<click_to_run jump="relative" slide="0" layer="-1">osgviewer glider.osg</click_to_run>

<image coordinate_frame="slide" position="0.25 0.75 0.0" scale="0.25">Images/lz.rgb</image>

<click_to_run jump="absolute" slide="0" layer="0">osgviewer cow.osg</click_to_run>

<image coordinate_frame="slide" position="0.75 0.75 0.0" scale="0.25">RSVclip.mov</image>

</layer>

#cccccc; background-color: #cccccc; min-height: 1.0px">

Audio spanning :

audiospan - media spanning multiple slides

audio spanning section ; to allow audio tracks to span multiple slides.

This is now supported by just adding movie (with audio) to each slide/layer that needs the audio/movie, and P3D will now spot that there is continuity between slides/layers and will leave the media playing without restarting it. This functionaity works without any new tags, it also does away with the need for clean_layers.

Mailing List :

For additional support please join the Present3D list here :

http://lists.present3d.osgforge.org/listinfo.cgi/p3d-users-present3d.osgforge.org