Random Dot Motion Element

Modified on 2018/07/16 02:40 by Administrator Categorized as Elements, Stimulus generators
<div style="margin-right: 10px; margin-left: 16px; margin-bottom:10px; float: right; width: 500px; overflow: hidden; height: auto; padding: 0px; background: #fafafa; background: -webkit-gradient(linear, left top, left bottom, from(#fbfbfb), to(#fafafa));background: -moz-linear-gradient(top, #fbfbfb, #fafafa);border: 1px dashed #ddd;box-shadow: 0 0 0 3px #fff, 0 0 0 5px #ddd, 0 0 0 10px #fff, 0 0 2px 10px #eee;">
== Summary ==
{s:Element Info Panel
| title=Random Dot Motion
| category=Stimulus Generators
| icon=[image|Element Icon|{UP(Random-Dot-Motion-Element)}Random-Dot-Motion-Element-Icon.png]
| author= OkazoLab
| addin= Visual Kernels
| scope= Parent event
| usage= Stimulus screen
| ownsnippets= None
}
== Properties ==
{|
|-
! Name
! Description                              
! Constraints
! Type
! On<br/>runtime<br/>change
|-
| colspan="5" bgcolor="#AADDDDD" | Patch Appearance
|-
| Background Color        
| Defines the background color of the generated random motion patch        
| {s:atNormal}        
| stColor        
|  
|-
| Patch Shape        
| Defines the shape of the generated motion patch        
| {s:atNormal}        
| GaborP..        
|  
|-
| Dot Density        
| Defines the density of dots in the generated motion patch. The value affects the Dot Number value        
| {s:atNormal}        
| Double        
|  
|-
| Dot Number        
| Returns a number of dots in the generated motion patch. The number depends on the dot density and the patch shape        
| {s:atStatus}        
| Int32        
|  
|-
| Reset Patch Now        
| Runtime commands that resets the RDM patch by reshuffling dot positions. To invoke the command, assign 'true' in snippets        
| {s:atRuntimeAction}        
| Boolean        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Dot Appearance
|-
| Dot Color        
| Defines the color of a single motion dot        
| {s:atNormal}        
| stColor        
|  
|-
| Dot Size        
| Defines the size of a single motion dot        
| {s:atNormal}        
| clSize        
|  
|-
| Dot Shape        
| Defines the shape of a single motion dot, when its size greater than 1 pixel        
| {s:atNormal}        
| GaborP..        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Motion Settings
|-
| Motion Type        
| Defines the motion type in the generated patch        
| {s:atNormal}        
| enMoti..        
|  
|-
| Motion Coherence        
| Defines a percentage of coherently moving dots in the patch, from 0 to 100        
| {s:atNormal}        
| Double        
|  
|-
| Motion Direction        
| Defines the direction of motion in degrees        
| {s:atNormal}        
| Double        
|  
|-
| Motion Speed        
| Defines the motion speed in pixels per step        
| {s:atNormal}        
| Double        
|  
|-
| Interleaved Sets Number        
| Defines the number of uncorrelated dot sets that are interleaved in a sequence of generated motion frames. The commonly used values are either 1 or 3.        
| {s:atNormal}        
| Int32        
|  
|-
| Max Dot Lifetime        
| Defines the maximal lifetime (in frames) of the coherently moving dots. If the maximal life time is reached, the moving dot is forced to random reallocation within a patch. Zero value means the infinite lifetime        
| {s:atNormal}        
| Int32        
|  
|-
| Reposition Rule        
| Defines the reposition rule for the incoherently moving dots. If the random walk mode is selected, the dot moves in a random direction with the same motion speed. If the random position mode is selected, the noise dots are just randomly reallocated within the patch.        
| {s:atNormal}        
| enRepo..        
|  
|-
| Min Frame Duration        
| Defines the minimal duration (ms) between consecutive motion frames. The zero value denotes that motion frames will be rendered as fast as possible, usually on each monitor refresh cycle.        
| {s:atNormal}        
| clTime        
|  
|-
| Central Diffusion        
| Defines the central diffusion for the origin of the outward radial motion in percentages to the total patch size. The value must not greater than zero        
| {s:atNormal}        
| Double        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | 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.        
| {s:atDesign}        
| 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.        
| {s:atNormal}        
| Boolean        
|  
|-
| Position        
| Defines a position of the rendering viewport on the screen        
| {s:atNormal}        
| clPoint        
|  
|-
| Size        
| Defines a size of the element's rendering viewport on the screen        
| {s:atNormal}        
| clSize        
|  
|-
| Z Order        
| Indicates Z Order of the element on the given event        
| {s:atStatus}        
| 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.        
| {s:atNormal}        
| stAlig..        
|  
|-
| Visible        
| Defines whether the element is visible        
| {s:atNormal}        
| Boolean        
|  
|-
| Rotation        
| Rotation angle in degrees        
| {s:atNormal}        
| Double        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Effects
|-
| Transparent Color        
| The color of the original pixels of rendered content that will be set as transparent        
| {s:atNormal}        
| 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        
| {s:atNormal}        
| 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        
| {s:atNormal}        
| stColor        
|  
|-
| Opacity        
| Opacity of the rendered content        
| {s:atNormal}        
| Int32        
|  
|-
| Contrast        
| Contrast of the rendered content        
| {s:atNormal}        
| Int32        
|  
|-
| Brightness        
| Brightness the rendered content        
| {s:atNormal}        
| Int32        
|  
|-
| Saturation        
| Saturation of the rendered content        
| {s:atNormal}        
| Double        
|  
|-
| Pixelation        
| Pixelation of the rendered content        
| {s:atNormal}        
| 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.        
| {s:atNormal}        
| Int32        
|  
|-
| Scrambling        
|         
| {s:atNormal}        
| Double        
|  
|-
| Scrambling Grid Size        
| Defines a size of the scrambling grid        
| {s:atNormal}        
| clSize        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Positional Jitter
|-
| Reset Jitter Now        
| Runtime command that resets the positional jitter.        
| {s:atRuntimeAction}        
| Boolean        
|  
|-
| Current Jitter        
| Returns the current jitter        
| {s:atStatus}        
| clPoint        
|  
|-
| Jitter Range        
| Defines a possible range for the random jitter. The range is centered to the position of the element.        
| {s:atNormal}        
| clSize        
|  
|-
| Test Jitter        
| Click to test the current jitter        
| {s:atDesign}        
| Boolean        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Control
|-
| Is Enabled        
| If set to false the element is completely omitted when the experiment is run        
| {s:atDesign}        
| Boolean        
|  
|-
| Title        
| Title of the element        
| {s:atDesign}        
| String        
|  
|-            
|}
== ==
</div>
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
'''Random Dot Motion Element''' generates animated RDM patches controlled by a flexible set of parameters.{br}{br}
{TOC}

== 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.
== Snapshots ==
{|
| [imageleft|Example of Random-dot motion element|{UP}/pictures/Elements/kernels/randdotmot.jpg]
|| [imageleft|Snapshot 2 |{UP}/pictures/elements/**/small/sm_***.png|{UP}/pictures/elements/**/**.png]
|}

== Practical Use ==
=== Technique 1 ===

# Step 1
# Step 2

=== Technique 2 ===

# Step 1
# Step 2

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

== Notes ==
Meta Keywords:
Meta Description:
Change Comment:
EventIDE Wiki

Navigation¶

Random Dot Motion Element
