Page History: Random Dot Motion Element
Compare Page Revisions
Page Revision: 2015/01/01 21:49
|
New Element
|
| Info |
| Category: |
|
|
AddIn: |
Base Elements |
| Creator: |
OkazoLab Team |
|
Scope: |
Parent Event |
| Owns Snippets: |
no |
|
Usage: |
Runtime Screen,Snippets |
Properties
Generic Properties
| Name | Description | Attributes | Value Type | Upon Change |
|---|
| Dot Pattern |
| Dot Density | The requested proportion of the all visible dots to the total number of dots in element's rendering area. | | Double | |
| Lookup Map Size | The size of the lookup map. Use value larger than the rendering area of the given element. Larger lookup map increase non-periodicity of the dot motion | | clSize | |
| Allow Dot Clusters | Indicates whether clusters of two or more dots are allowed. If false, all visible dots will be isolated but the actual dot density may be decreased. | | Boolean | |
| Lookup index | Index of the random lookup map. If value is 0 then an automatic time dependent index is used. Otherwise, the value has to be a positive integer. | | Int32 | |
| Background color | Background color such that its brightness (B) is used to define the luminance of element's background. | | stColor | |
| Dot color | Foreground color such that its brightness (B) is used to define dot luminance | | stColor | |
| Show Lookup Borders | Indicates whether the left and top borders of the lookup map are shown being superimposed over the dots. Use for debugging purposes. | | Boolean | |
| Motion |
| Motion Coherence | Proportion of the dots coherently moving in a single direction | | Double | |
| Motion Step | The pixel distance of one step of the coherent motion. Can be less than 1 for slow motion | | Double | |
| Motion Angle | Direction of the coherent motion in degrees (0..360). | | Double | |
| Runtime |
| Noise Lookup | Lookup position on the map A representing the noise dots | | Point | |
| Motion Lookup | Lookup position on the map B containing coherently moving dots | | Point | |
| Make Noise | Runtime action. | | Boolean | |
| Make Motion | Runtime action. | | Boolean | |
+=== 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 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 |
|
The element allows/is capable of doing something in experiments
Description
Random-dot motion element generates a sequence of 2D frames that can make up a random dot motion patten. The selected fraction of all dots can be set to move in a single direction, thus producing a coherent motion. Some examples how this stimulus looks like during the experiment can be found
here.
Snapshots
 Example of Random-dot motion element |  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..
Notes