Dome Camera

This feature allows artists to visualize their interactive projects within an immersive dome environment. In order to make it an extensible tool, we are supporting Fulldome, Truncated domes (front and rear), Planetariums and domes with spherical mirrors.

Tip

The Dome camera uses a multipass texture algorithm as developed by Paul Bourke and was implemented by Dalai Felinto with sponsorship from SAT – Society for Arts and Technology within the SAT Metalab immersion research program, that involves rendering the scene four times and placing the subsequent images onto a mesh designed especially such that the result, when viewed with an orthographic camera, is a fisheye projection.

Note

Remember to use Blender in ‘fullscreen mode’ to get the maximum out of your projector.

To accomplish that launch Blender with the command-line argument -W. Also to get away of the top menu on Blender try to join all areas (buttons, 3D View, text,...) in a single one. Otherwise if you only maximize it Ctrl-Up) you cannot get the whole screen free to run your game (the top bar menu takes about 20 pixels).

Dome Camera Settings

../../_images/game-engine_camera_dome.png
Dome Type
This menu allows you to select which type of dome camera to use. They are outlined below, along with their respective settings.

Available camera settings change depending on the selected Dome Type:

Resolution
Sets the resolution of the Buffer. Decreasing this value increases speed, but decreases quality.
Tessellation
4 is the default. This is the tessellation level of the mesh. (Not available in Cube Map mode).
Angle
Sets the field of view of the dome in degrees, from 90 to 250. (Available in Fisheye and Truncated modes).
Tilt
Set the camera rotation in the horizontal axis. Available in Fisheye and Truncated modes).
Warp Data Mesh
Use a custom warp mesh data file.

Fisheye Mode

An Orthogonal Fisheye view from 90º to 250º degrees.

  • From 90º to 180º we are using four renders.
  • From 181º to 250º we are using five renders.
../../_images/bge_dome-fisheye.jpg

Fisheye Mode.

Front-Truncated Dome Mode

Designed for truncated domes, this mode aligns the fisheye image with the top of the window, while touching the sides.

  • The Field of view goes from 90º to 250º degrees.
  • From 90º to 180º we are using four renders.
  • From 181º to 250º we are using five renders.
../../_images/bge_dome-front-truncated.jpg

Front Truncated Dome Mode.

Rear-Truncated Dome Mode

Designed for truncated domes, this mode aligns the fisheye image with the bottom of the window, while touching the sides.

  • The Field of view goes from 90º to 250º degrees.
  • From 90º to 180º we are using four renders.
  • From 181º to 250º we are using five renders.
../../_images/bge_dome-rear-truncated.jpg

Rear Truncated Dome Mode.

Cube Map Mode

Cube Map mode can be used for pre-generate animated images for CubeMaps.

  • We are using six renders for that. The order of the images follows Blender internal EnvMap file format: - first line: right, back, left - second line: bottom, top, front
../../_images/bge_dome-envmap.jpg

Environment Map Mode.

Spherical Panoramic Mode

A full spherical panoramic mode.

  • We are using six cameras here.
  • The bottom and top start to get precision with Definition set to 5 or more.
../../_images/bge_dome-panoramic.jpg

Full Spherical Panoramic Mode.

Warp Data Mesh

Many projection environments require images that are not simple perspective projections that are the norm for flat screen displays. Examples include geometry correction for cylindrical displays and some new methods of projecting into planetarium domes or upright domes intended for VR.

For more information on the mesh format see Paul Bourke’s article.

../../_images/bge_dome-warped.jpg

In order to produce that images, we are using a specific file format.

File template:

mode
width height
n0_x n0_y n0_u n0_v n0_i
n1_x n1_y n1_u n1_v n1_i
n2_x n1_y n2_u n2_v n2_i
n3_x n3_y n3_u n3_v n3_i
(...)

First line is the image type the mesh is support to be applied to: 2 = rectangular, 1 = radial Next line has the mesh dimensions in pixelsRest of the lines are the nodes of the mesh.

Each line is compound of x, y, u, v, i (x, y) are the normalized screen coordinates (u, v) texture coordinates i a multiplicative intensity factor.

x varies from -screen aspect to screen aspect varies from -1 to 1 u and v vary from 0 to 1. i ranges from 0 to 1, if negative do not draw that mesh node.

  1. You need to create the file and add it to the Text Editor in order to select it as your Warp Mesh data file.
  2. Open the Text Editor Editor Types ‣ Text Editor.
  3. Open your mesh data file (e.g. myDome.data) in the text editor (Text ‣ Open or Alt-O).
  4. Go to Game Framing Settings Editor Types ‣ Properties editor ‣ Scene.
  5. Enable Dome Mode.
  6. Type filename in Warp Data field (e.g. myDome.data).

To create your own Warp Meshes an interactive tool called meshmapper is available as part of Paul Bourke’s Warpplayer software package (requires full version).

Examples

Important

The viewport is calculated using the ratio of canvas width by canvas height. Therefore different screen sizes will require different warp mesh files. Also in order to get the correct ratio of your projector you need to use Blender in Fullscreen mode.