SoCreateCubeMapSampler

InventorModule
author MeVis Medical Solutions AG
package MeVisLab/Standard
dll SoImageSamplers
definition SoImageSamplers.def
see also SoVertexShader, SoFragmentShader, SoMLSampler2D
inherits from SoFramebufferSampler
keywords cubemap

Purpose

The SoCreateCubeMapSampler module creates a cube map and renders the given inventor scene into each of the 6 cube map faces. The camera is placed at the given World Position, so that the cube map is valid from the view of that world position. The cube map can either be updated manually or automatically on each rendering.

Usage

The rendered cube map can be used inside of the shader framework, using its Name as the cube map sampler.

Windows

Default Panel

../../../Modules/Inventor/SoImageSamplers/mhelp/Images/Screenshots/SoCreateCubeMapSampler._default.png

Input Fields

child

name: child, type: SoNode

The scene to be rendered into the cube map.

Output Fields

self

name: self, type: SoNode

The generated samplerCube.

Parameter Fields

Field Index

Auto Update: Bool Min Filter: Enum takeSnapshot: Trigger
automaticTraversal: Bool Mode: Enum Update: Trigger
Border Color: Vector4 Name: String Use Separate Render Action: Bool
Clear Alpha: Float Near Distance: Float use16BitFloat: Bool
Clear Color: Color needsTextureCoordinates: Bool useFormatStateHints: Bool
Color Buffer Format: Enum Orientation: Rotation useSizeStateHints: Bool
depthBufferTarget: Enum pixelScale: Float World Position: Vector3
Enable Border: Bool Size: Integer Wrap S: Enum
Far Distance: Float sizeMultiplier: Float Wrap T: Enum
Mag Filter: Enum stencilBuffer: Bool  

Visible Fields

Name

name: name, type: String

The sampler name as it appears in shaders.

see also SoFramebufferSampler.name

Enable Border

name: enableBorder, type: Bool, default: FALSE

see SoFramebufferSampler.enableBorder

Border Color

name: borderColor, type: Vector4, default: 0 0 0 0

see SoFramebufferSampler.borderColor

Min Filter

name: minFilter, type: Enum, default: LINEAR

see SoFramebufferSampler.minFilter

Mag Filter

name: magFilter, type: Enum, default: LINEAR

see SoFramebufferSampler.magFilter

Wrap S

name: wrapS, type: Enum, default: REPEAT

see SoFramebufferSampler.wrapS

Wrap T

name: wrapT, type: Enum, default: REPEAT

see SoFramebufferSampler.wrapT

Clear Color

name: clearColor, type: Color, default: 0 0 0

see SoFramebufferSampler.clearColor

Clear Alpha

name: clearAlpha, type: Float, default: 1, minimum: 0, maximum: 1

see SoFramebufferSampler.clearAlpha

Color Buffer Format

name: colorBufferFormat, type: Enum, default: RGBA

see SoFramebufferSampler.colorBufferFormat

Use Separate Render Action

name: useSeparateRenderAction, type: Bool, default: FALSE

If enabled, a separate SoGLRenderAction is used, so the Open Inventor and GL state above the module does not affect the framebuffer scene rendering. This means that the camera and any lights above the module will no longer affect the rendering of the scene below the sampler.

see also SoFramebufferSampler.useSeparateRenderAction

Size

name: size, type: Integer, default: 512

The size of the cube map.

see also SoFramebufferSampler.size

World Position

name: worldPosition, type: Vector3, default: 0 0 0

The world position of the camera that is used to render the cube map.

Orientation

name: orientation, type: Rotation, default: 0 1 0 3.14159274101257

Main orientation applied to the whole cube map.

Near Distance

name: nearDistance, type: Float, default: 0.0099999998, minimum: 0

Near clipping distance of the used cameras.

Far Distance

name: farDistance, type: Float, default: 1000, minimum: 0

Far clipping distance of the used cameras.

Auto Update

name: autoUpdate, type: Bool, default: TRUE

If enabled, the cube map is recreated on each re-rendering. If disabled, the cube map is rendered initially and when the Update field is triggered.

Update

name: update, type: Trigger

Manually updates the cube map rendering.

Mode

name: mode, type: Enum, default: ColorCubeMap

Defines the Cubemap mode

Values:

Title Name Description
Color Cube Map ColorCubeMap Create a color cube map.
Depth Cube Map DepthCubeMap Create a depth cube map.
Color And Depth Cube Map ColorAndDepthCubeMap Create a color and a depth cube map.

Hidden Fields

use16BitFloat

name: use16BitFloat, type: Bool, default: TRUE

see SoFramebufferSampler.use16BitFloat

needsTextureCoordinates

name: needsTextureCoordinates, type: Bool, default: TRUE

see SoFramebufferSampler.needsTextureCoordinates

depthBufferTarget

name: depthBufferTarget, type: Enum, default: RENDERBUFFER

see SoFramebufferSampler.depthBufferTarget

stencilBuffer

name: stencilBuffer, type: Bool, default: FALSE

see SoFramebufferSampler.stencilBuffer

useSizeStateHints

name: useSizeStateHints, type: Bool, default: FALSE

see SoFramebufferSampler.useSizeStateHints

useFormatStateHints

name: useFormatStateHints, type: Bool, default: FALSE

see SoFramebufferSampler.useFormatStateHints

pixelScale

name: pixelScale, type: Float, default: 1

see SoFramebufferSampler.pixelScale

automaticTraversal

name: automaticTraversal, type: Bool, default: TRUE

see SoFramebufferSampler.automaticTraversal

takeSnapshot

name: takeSnapshot, type: Trigger

see SoFramebufferSampler.takeSnapshot

sizeMultiplier

name: sizeMultiplier, type: Float, default: 1

see SoFramebufferSampler.sizeMultiplier