3D Viewport Element

Modified on 2018/08/03 01:50 by Administrator — Categorized as: 3D Graphics, Base Elements, Elements

Summary

Element Icon 3D Viewport
Info
Category: 3D Graphics AddIn: Base Layer
Creator: OkazoLab Scope: Parent event
Owns Snippets: None Usage: Stimulus screen

Properties

NameDescription                              ConstraintsTypeOn
runtime
change
Viewport Settings
Is Input Enabled        Defines whether input is allowed to control the 3D viewport. If the value is true, the viewport camera can me controlled with mouse gestures at runtime.                Boolean         
Auto Zoom        Defines whether the viewport automatically reset its zooming and panning to fit a newly loaded 3D model                Boolean         
Show View Cube        Defines whether the view cube widget is shown in the viewport                Boolean         
Show Framerate        Defines whether the framerate counter is shown in the viewport                Boolean         
Show Axis        Defines whether the axis widget is shown in the viewport                Boolean         
Show Grid        Defines whether the Y=0 grid is shown in the viewport                Boolean         
Background Color        Defines the background color of the viewport                stColor         
Default Material        Defines the default material color for material-less 3D models                stColor         
Camera Orbit
Orbit Rotation        Rotation of the camera in the viewport orbital system. The field X,Y and Z represent Yew, Pitch and Roll in degrees.                Vector..         
Orbit Center        Center of the camera orbit in the world coordinates.                Point3D         
Orbit Scale        Scale of the camera orbit height relative to the orbit center. The value is in percentates where 100% match to the default camera position in the current 3D model.                Double         
colspan="5" bgcolor="#AADDDDD" |   
                          Boolean         
Material List
Selected Index        Defines an index of the selected library item in the list of this element                Int32         
Selected Item        Defines a name if the selected library item in the list of this element                String         
Item Count        Return the total number of material items in the list of this element                Int32         
Equalize RGB        If true,the RGB pixel intensity is equalized across all loaded items                Boolean         
Visual Appearance
Alpha Masking        Defines, whether the visual content is used to create an opacity mask on the event surface. If masking is on, the content's pixel luminance (or, its inverse) defines transparency within element's viewport. The alpha masking allows, for example, create transparent holes on the event surface.                Int32         
AntiAliasing        if true, the rendered content will be antialiased for smoother visual appeariance. If false, rendering will be authentic to its source, e.g. a bitmap.                Boolean         
Position        Defines a position of the rendering viewport on the screen                clPoint         
Size        Defines a size of the element's rendering viewport on the screen                clSize         
Z Order        Indicates Z Order of the element on the given event                Int32         
Pivot Point        Defines alignment of the pivot point (or, element's position) relative to element's rendering area. The pivot point sets the center of element's rotation and scale directions.                stAlig..         
Visible        Defines whether the element is visible                Boolean         
Rotation        Rotation angle in degrees                Double         
Effects
Transparent Color        The color of the original pixels of rendered content that will be set as transparent                stColor         
Transparent Tolerance        Tolerance ratio for choosing colors that become transparent. Zero means that effect is not applied, 1 denotes that all colors will become trasparent                Int32         
Color Mask        Produces a multiplicative combination of the original pixels and the selected mask color (except the alpha channel).  The effect emulates a look through a colored glass.  White or transparent mask color dont change the original pixels                stColor         
Opacity        Opacity of the rendered content                Int32         
Contrast        Contrast of the rendered content                Int32         
Brightness        Brightness the rendered content                Int32         
Saturation        Saturation of the rendered content                Double         
Pixelation        Pixelation of the rendered content                Int32         
Blurring        The radius used in the gaussian blur of rendered content, as a pixel-based factor. The default is 0 which means no blurring.                Int32         
Scrambling                        Double         
Scrambling Grid Size        Defines a size of the scrambling grid                clSize         
Positional Jitter
Reset Jitter Now        Runtime command that resets the positional jitter.                Boolean         
Current Jitter        Returns the current jitter                clPoint         
Jitter Range        Defines a possible range for the random jitter. The range is centered to the position of the element.                clSize         
Control
Is Enabled        If set to false the element is completely omitted when the experiment is run                Boolean         
Title        Title of the element                String         

3D Viewport Element allows rendering of 3D models stored in popular 3D formats, e.g. the Wavefront obj. The elements allows to control the camera position for changing 3D views or producing 3D animation. Multiple 3D scenes can be loaded into element's material list in order to form a 3D stimulus set. If you need even deeper control of 3D scenes, consider using another element, 3D XAML element, which requires model conversion to the XAML 3D format.


Description

Short description

Snapshots

Snapshot 1

Snapshot 1

Snapshot 2

Snapshot 2


Practical Use

Technique 1

  1. Step 1
  2. Step 2

Technique 2

  1. Step 1
  2. Step 2

 // Check the trial outcome. Result and RT just other user variables
// insert code snippet here..