Renderer Element

Summary ¶

	Renderer
Info
Category:	Visual Stimuli		AddIn:	Base Layer
Creator:	OkazoLab		Scope:	Parent event
Owns Snippets:	None		Usage:	Stimulus screen

Properties ¶

Name	Description	Constraints	Type	On runtime change
Material List
Selected Index	Defines an index of the selected library item in the list of this element	Normal..	Int32
Selected Item	Defines a name if the selected library item in the list of this element	Normal..	String
Item Count	Return the total number of material items in the list of this element	Status..	Int32
Equalize RGB	If true,the RGB pixel intensity is equalized across all loaded items	Design Time..	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.	Design Time..	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.	Normal..	Boolean
Position	Defines a position of the rendering viewport on the screen	Normal..	clPoint
Size	Defines a size of the element's rendering viewport on the screen	Normal..	clSize
Z Order	Indicates Z Order of the element on the given event	Status..	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.	Normal..	stAlig..
Visible	Defines whether the element is visible	Normal..	Boolean
Rotation	Rotation angle in degrees	Normal..	Double
Effects
Transparent Color	The color of the original pixels of rendered content that will be set as transparent	Normal..	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	Normal..	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	Normal..	stColor
Opacity	Opacity of the rendered content	Normal..	Int32
Contrast	Contrast of the rendered content	Normal..	Int32
Brightness	Brightness the rendered content	Normal..	Int32
Saturation	Saturation of the rendered content	Normal..	Double
Pixelation	Pixelation of the rendered content	Normal..	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.	Normal..	Int32
Scrambling		Normal..	Double
Scrambling Grid Size	Defines a size of the scrambling grid	Normal..	clSize
Positional Jitter
Reset Jitter Now	Runtime command that resets the positional jitter.	Runtime Command..	Boolean
Current Jitter	Returns the current jitter	Status..	clPoint
Jitter Range	Defines a possible range for the random jitter. The range is centered to the position of the element.	Normal..	clSize
Test Jitter	Click to test the current jitter	Design Time..	Boolean
Control
Is Enabled	If set to false the element is completely omitted when the experiment is run	Design Time..	Boolean
Title	Title of the element	Design Time..	String

¶

Snapshots ¶

3D Graphic	Jpg/Png pictures
Vector Graphic	Built-in library vector graphic

Practical Use ¶

Creating a single Renderer on a visual scene ¶

1. Click on "add element", and select the Renderer element.
2. Navigate to the Material Library.
3. Drag selected visual materials (e.g an image or images) onto the Renderer element, in the element list on the left of the main window. Notice that you can change sorting order
4. Click on an expander button of Renderer icon to check a list loaded items and rearrange them, if necessary.
5. Adjust a position and size of the Renderer viewport on the event surface.
6. Check other properties of the Renderer element in the property grid (the element has to be selected first)
   

Using Renderer to create a switchable stimulus list ¶

1. The procedure is the same as above, except that you may drag & drop multiple visual materials onto the element.
   You may click on the down arrows to expand the list of elements.
   
   You may double click on one of the material items in the element to draw it on screen.
   
   The 'Selected Index' property will hold the index of the item in the element and the 'Selected Item' property will hold the name of the item. These properties can be changed at run time as described below.
   

Multiple Materials

Adjusting the renderer at runtime using a proxy variable ¶

1. Create a Renderer Element with multiple material items as above.
2. Create a Proxy Variable from the "Selected Index" property. (please see Proxy Variables if you do not know how to do this). E.g name it "StimulusIndex"
3. Now you can use the following code to change which item is displayed in the Renderer Element:
   
   

StimulusIndex=2;

1. Alternatively, one can create a Proxy Variable for the "Selected Item" property, and then use code to change the item according to it's name.
   e.g
   

   StimulusItem="Red Circle";