Skip to main content
Documentation

3D Visualization

Projects can have multiple different 3D visualizations in parallel, each presenting a different branch, scenario or aspect of your project.

Examples

Planet visualization:
A 3D planet visualization rendered in the Diafunc cockpit


Lake visualization:
A 3D lake scene with terrain and water surface


Deep sea visualization:
A 3D deep sea scene beneath the water surface


Space visualization:
A 3D space scene with a starfield and celestial bodies

Scene

A scene entity represents a specific visualization and can be viewed via the Diafunc cockpit.
It's the container entity for all entities which should be displayed or are required for the visualization.

Scene Attributes

Attribute Type Example Description
size number 2400 Size of cubic 3D space (scenes at Diafunc are always cubic)
sky bool true Activates the support for sky visualization
terrain bool true Activates the support for terrain visualization
waterSurface bool true Activates the support for the water surface visualization
ambientLightColor text 0x202020 Ambient light color
fogAboveWaterColor text 0xBFCEFF Color of the fog above the water surface
fogAboveWaterDensity number 0.0006 Density of the fog above the water surface
fogUnderWaterColor text 0x464EBD Color of the fog under the water surface
fogUnderWaterDensity number 0.0015 Density of the fog under the water surface
sunColor text 0xffffbb Color of the sun
sunIntensity number 1 Intensity of the sun
sunPositionX number -2400 X-position of the sun
sunPositionY number 1200 Y-position of the sun
sunPositionZ number 4800 Z-position of the sun
Scenes that embed 2D graphics support one additional attribute, 'canvas', which is documented on the 2D Visualization page.

Attachments

A scene displays all entities which are linked from the entity via the linkId 'attachments'.

Body

The body entity represents a visualizable physical body within 3D space.

Visualization

The visualization entity specifies the way an entity is visualized.
It must be linked from the body entity via the linkId 'visualization'.

Animations

The animation entity specifies a single supported animation of a visualization.
The active animation can be configured at entities via the attribute 'animation' by mentioning either the entityId or the name of the animation entity.

What next?