Example: Stereoscopic Viewports

This page contains an example of a RenderSetup XML file using two viewports to render left and right eyes perspectives in two separate views. This combined achieves stereoscopic vision.

Notice the parameter cameraMode is used to define which eye to render in each viewport.

cameraMode

Allows you to select what eye perspective to render in the viewport, taking into account cameraConvergenceType, global eyes separation and convergence parameters, supported values are:

• left_eye: render the left eye perspective.

• right_eye: render the right eye perspective.

• setting any value different from left_eye or right_eye or not setting this parameter results in the default center camera to be used for rendering.

Limitations

• Only supported in dualhead sidebyside rendering

  The cameraMode parameter is only supported in dualhead sidebyside rendering.

  To enable dualhead sidebyside rendering on a rendersetup XML, it is necessary to name the file by including the words "dualhead" and "sidebyside" in its filename (eg. rendersetup_fgi_2screens_dualhead_sidebyside.xml).

  The dualhead and sidebyside modes detection is currently handled by naming convention.

• Viewports naming convention for dualhead

  dualhead rendering imposes the following constraints, that must be respected:

  • A layout named DEFAULT_VIEWPORT must exist.

  • A layout named RIGHT_VIEWPORT must exist.

Filename

rendersetup_fgi_dualhead_sidebyside.xml

Code example

<?xml version="1.0" encoding="utf-8" ?>

<renderSetup version="1.0">

<Viewport name="DEFAULT_VIEWPORT">

<hwnd index="0"/>

<pos value="0 0"/>

<size value="0.5 1"/>

<outputLayer value="DEFAULT_2D_LAYER"/>

<cameraMode value="left_eye"/>

<layers>

<Layer name="DEFAULT_SCENE_LAYER" type="sceneFGI">

<fgiConfig file="./GameData/hdr/fgi_default.xml"/>

<postProcess id="DEFAULT_POSTPROCESS" file="./GameData/hdr/post_process_default.xml"/>

<sceneName value="_all_"/>

<cameraName value="Camera01"/>

</Layer>

<Layer name="DEFAULT_2D_LAYER" type="2dOverlay">

<layer2DName value="DEFAULT_2D_LAYER_MAIN"/>

<input1 value="DEFAULT_SCENE_LAYER"/>

</Layer>

</layers>

</Viewport>

<Viewport name="RIGHT_VIEWPORT">

<hwnd index="0"/>

<pos value="0.5 0"/>

<size value="0.5 1"/>

<outputLayer value="RIGHT_2D_LAYER"/>

<cameraMode value="right_eye"/>

<layers>

<Layer name="RIGHT_SCENE_LAYER" type="sceneFGI">

<fgiConfig file="./GameData/hdr/fgi_default.xml"/>

<postProcess id="RIGHT_POSTPROCESS" file="./GameData/hdr/post_process_default.xml"/>

<sceneName value="_all_"/>

<cameraName value="Camera01"/>

</Layer>

<Layer name="RIGHT_2D_LAYER" type="2dOverlay">

<layer2DName value="DEFAULT_2D_LAYER_MAIN"/>

<input1 value="RIGHT_SCENE_LAYER"/>

</Layer>

</layers>

</Viewport>

</renderSetup>

Image example