Page History: 3D Viewport Element
Compare Page Revisions
Page Revision: 2014/09/23 04:35
|
New Element
|
| Info |
| Category: |
|
|
AddIn: |
Base Elements |
| Creator: |
OkazoLab Team |
|
Scope: |
Parent Event |
| Owns Snippets: |
no |
|
Usage: |
Runtime Screen,Snippets |
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 2 |
Practical Use
Technique 1
- Step 1
- Step 2
Technique 2
- Step 1
- Step 2
// Check the trial outcome. Result and RT just other user variables
// insert code snippet here..
Element actions aligned with different epochs of the parent event
| Epoch | Actions |
|---|
| Initialized |
| Rendered |
| Activating |
| Activated |
| Running |
| Deactivated |
| Deinitialized |
Notes
Insert Notes here..
Properties
Generic Properties
| Name | Description | Attributes | Value Type | Proxy Reflex |
|---|
| Camera Orbit |
| Orbit Rotation | Rotation of the camera in the view-port orbital system. The field X,Y and Z represent Yew, Pitch and Roll in degrees. | | Vector3D |
| 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 | |
| Camera Settings |
| Camera Position | Camera location in world coordinates. The property does not specify where the camera is directed. The direction is defined by the Camera Lookup Direction property. | | Point3D | |
| Lookup Direction | Vector3D which defines the direction in which the camera is looking in world coordinates. | | Vector3D | |
| Camera Up Direction | Unit vector that that represents the upward direction of the camera and scene projection | | Vector3D | |
| Near Plane Distance | Distance from the camera to the camera's near clip plane | | Double |
| Far Plane Distance | Distance from the camera to the camera's far clip plane | | Double | |
| Field of view | Horizontal bounds of the camera's projection between the camera's position and the image planee, in degrees | | Double | |
| Object tracking |
| Is Tracking | Enables 3D reatime object tracking | | Boolean | |
| Tracked Object | Name of 3D object which is currently tracked | | String | |
| Tracked Point | 3D coordinate of the tracked point on the tracked object | | Point3D | |
| Tracking Distance | Distance from the screen surfce to the tracked point of 3D object, in the world units | | Double | |
+=== Properties inherited from clVisualElement ===
| Name | Description | Constraints | Value Type | Upon Runtime Change |
|---|
| VISUAL APPEARANCE |
| Alpha Masking | Defines whether the visual content rendered by this element will be used as an opacity mask which is applied onto the given event surface. The active opacity mask allows one to expose pixels of the parent event surface through a solid background of the given event. If the value is true, the darker pixels of the content will make more transparent holes on the entire event surface. | | Boolean | |
| AntiAliasing | If true, the rendered content will be anti-aliased for smoother visual appearance. If false, rendering will be authentic to its source, e.g. a bitmap. | | Boolean | |
| Position | Defines the position of the element viewport on the screen. The position can be set in any of three coordinate systems: a) pixels, b) polar, c) central. | | clPoint | |
| Size | Defines the size of the element viewport on the screen. The size can be set in any of three coordinate systems: a) pixels, b) visual degrees, c) 'relative-to-screen' size. | | clSize | |
| Z Order | Indicates the current depth order of the element viewport on the surface of the parent event. The greatest number corresponds to the top position. The order can be changed by moving the element up and down in the element list. | | Int32 | |
| Pivot Point | Defines the pivot point (coordinate and the rotation centers) within the element viewport. | | stAlignment or Int32 | |
| Visible | Defines whether the element is currently visible on the event surface. The property is convenient for switching visual content on and off. | | Boolean | |
| Rotation | Defines the rotation angle (in degrees) of element viewport relative to the its pivot point. | | Double in the range 0..360 | |
| EFFECTS |
| Transparent Color | The color of the original pixels of rendered content that will be set as transparent. | | stColor | |
| Transparency 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, range (0..100) | |
| 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 doesn't change the original pixels. | | stColor | |
| Opacity | Opacity of the rendered content. | | Int32, range (0..100) | |
| Contrast | Contrast of the rendered content. | | Int32, range (-100..100) | |
| Brightness | Defines the brighness of the rendered content. | | Int32, range (-100..100) | |
| Saturation | Saturation of the rendered content. | | Double | |
| Pixelation | Defines the pixel scale of the rendering. | | Int32, range (0..100) | |
| 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 | |
| POSITIONAL JITTER |
| Reset Jitter | Set to true at runtime to reset the current positional jitter. | | Boolean, set true for action | |
| Current Jitter | Jitter range, in pixels (non inclusive). | . | clSize | |
| Jitter Range | Jitter range, centered at the original position of the element. | . | clSize | |
+=== Properties inherited from clLibraryElement ===
| Name | Description | Constraints | Value Type | Upon Runtime Change |
|---|
| Material List |
| Selected Index | Defines the index of the active item in the material list of the element. | | Int32 | A change causes the current item to be reloaded and an update of the element. |
| Selected Item | Defines the name of the active item in the material list of the element. The name matches to a name of item in the Material Library | | String | A change causes the current item to be reloaded and an update of the element. |
| Item Count | Returns the total number of items in the material list of the element. | | Int32 |
| Equalize RGB | The property is only available in the visual element. If the value is true, the average RGB pixel intensity will be equalized across all items in the material list. You can turn on this property, when you need to obtain a luminance-balanced set of visual stimulus. | | Boolean | |
+=== Properties inherited from clElement ===
Inherited properties of clElement
| Name | Description | Constraints | Value Type | Upon Change |
|---|
| Control |
| Is Enabled | If set to false the element is completely omitted when the experiment is run. | | Boolean |
|
| Title | Title of the element. | | String |
|