Page History: Renderer Element
Compare Page Revisions
Page Revision: 2011/07/12 07:02
Renderer is perhaps the most used element for delivering visual stimuli. The element can load and render any library item that contains static graphics. Such library items include bitmap images in any format plus XAML vector graphics.
Element Description
Renderer elements renders a content of the selected library item inside of a selected rectangular area on the screen. The rendering can be tuned with various properties of the Renderer element. For example, you can adjust the size and contrast of the original graphics item and set its rotation angle.
Each Renderer element works with a its own list of loaded Library items. It's handy for experimental scenarios where you need to present a visual stimulus selected randomly from a stimulus set. You can form a list by simply dragging library items to a Renderer element in the Element Panel. The items included in the list can be always reordered such that each item has its own integer index. Renderer elements has a property that defines which item is currenlty selected and rendered on the screen. Changing this property will cause rendering of a new item.
The list of Renderer properties:
Properties of Renderer Element
Properties inherited from clVisualElement
| Name | Description | Attributes | Value Type |
|---|
| VISUAL APPEARANCE |
| Is Opacity Mask | Indicates if the element is used to make an opacity mask for the surface of the parent event. If true, the element does render a Library item directly. Instead, the original pixels are used to estimate the opacity of the corresponding pixels on the parent event surface. The brighter is a single pixel of the element the more transparent will be the corresponding pixel on the surface. The black pixels mean no transparency and the white ones mean full transparency. | D | Boolean |
| Position | Defines the position (Cartesian or radial) of element's rendering area on the screen | D,R,* | clPoint |
| Size | Defines the size (pixels or visual degrees) of element's rendering area on the screen | D,R,* | clSize |
| Z Order | Indicates the depth order of the element on the surface of the parent event. The value is calculated out of the Renderer position in the event's elements list. | R,ReadOnly | Int32 |
| Alignment | Defines the alignment of the rendering area of the element relatively to its position. The default value is the central alignment. | D,R,* | stAlignment/Int32 |
| Visible | Defines if the element is currently visible. | D,R,* | Boolean |
| Rotation Angle | Defines the rotation angle of a rendered content around the current element position. The angle is in degrees which originate from the right-most axis (0 degree- no rotation) and goes anti-clockwise until 360. | D,R,* | Boolean |
| EFFECTS |
| Transparent Color | Defines a color value that is replaced with transparent pixels on rendering. | D,R,* | clColor |
| Transparency Tolerance | Defines how tolerant is a transparency replacement if the transparent color is set. The value si percentage ratio. Zero means that only pixels with exact match will be replaced, whereas 100 means that all pixel will become trnasparent | D,R,* | Int32, range 0..100 |
| Color Mask | Defines a color that produces the effect of “look through the colored glass” on the rendering. Use non-transparent colors for adequate results. White color means no effect. | D,R,* | clColor |
| Opacity | Defines the transparency of the entire rendering in percents. 100 means no effect. | D,R,* | Int32, range 0..100 |
| Contrast | Defines the contrast of the rendering. Zero means no effect. | D,R,* | Int32, range -100..100 |
| Brightness | Defines the brighness of the rendering. Zero means no effect. | D,R,* | Int32, range -100..100 |
| Pixelation | Defines the pixel scale of the rendering. If value >0 the original pixels are replaced with larger squats, which color is taken from the original pixel at center of squat’s area (not average color of all pixels in squat). Zero means no effect. | D,R,* | Int32, range 0..100 |
| POSITIONAL JITTER |
| Reset Jitter | Generate and apply a new random jitter for the element | Runtime action,* | Boolean, set true for action |
| Current Jitter | Shows the current jitter of the element | R,ReadOnly | clSize |
| Jitter Range | Defines the spatial range for random jitters (the size of imaginary rectangular area, superimposed at the position of the element) | D,R | 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 |
|