Welcome Guest, you are in: Login

ScrewTurn Wiki

RSSRSS

Navigation




Search the wiki


PoweredBy


Element Icon Text Element
Info
Category: Visual Stimuli AddIn: Base Elements
Creator: OkazoLab Team Scope: Parent Event
Owns Snippets: no Usage: Runtime Screen,Snippets

Synchronized Internal Actions

Experiment StartParent Event OnsetStatus change between Onset/OffsetParent Event OffsetExperiment End
Gets displayed on screen Is removed from screen

Generic Properties

NameDescriptionConstraints Value TypeUpon Runtime Change
VISUAL APPEARANCE
TextMulti-line string value that defines a text rendered by the element. Type your text here. Use Enter press to initiate a new text line. String
Font ColorColor of the text stColor
Auto sizeIf true, the text rendering area is resized automatically when the text is changed Boolean
Font nameDefines the font for the text. Select a font from the list. Font, String
Font SizeThe size of the font Double
Text alignmentHorizontal text alignment inside of a text area.TextAligment

+=== Properties inherited from clVisualElement ===
NameDescriptionConstraintsValue TypeUpon Runtime Change
VISUAL APPEARANCE
Alpha MaskingDefines 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
AntiAliasingIf 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
PositionDefines 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
SizeDefines 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 OrderIndicates 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 PointDefines the pivot point (coordinate and the rotation centers) within the element viewport. stAlignment or Int32
VisibleDefines whether the element is currently visible on the event surface. The property is convenient for switching visual content on and off. Boolean
RotationDefines the rotation angle (in degrees) of element viewport relative to the its pivot point. Double in the range 0..360
EFFECTS
Transparent ColorThe color of the original pixels of rendered content that will be set as transparent. stColor
Transparency ToleranceTolerance 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 MaskProduces 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
OpacityOpacity of the rendered content. Int32, range (0..100)
ContrastContrast of the rendered content. Int32, range (-100..100)
BrightnessDefines the brighness of the rendered content. Int32, range (-100..100)
SaturationSaturation of the rendered content. Double
PixelationDefines the pixel scale of the rendering. Int32, range (0..100)
BlurringThe 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 JitterSet to true at runtime to reset the current positional jitter.Boolean, set true for action
Current JitterJitter range, in pixels (non inclusive)..clSize
Jitter RangeJitter range, centered at the original position of the element.. clSize

+=== Properties inherited from clElement === Inherited properties of clElement
NameDescriptionConstraintsValue TypeUpon Change
Control
Is EnabledIf set to false the element is completely omitted when the experiment is run.Boolean
TitleTitle of the element.String





Text element allows displaying text blocks for instructions and feedback. Element provides a variety of text decoration options, e.g. font, color and alignment selection. The text content can always be changed and reformatted at runtime.

Snapshots

Text element in the EventIDE scene editor

Text element in
the EventIDE scene editor

Multiple textblocks with different  fonts (inluding the symbol font), colors and visual effects applied

Multiple textblocks with different
fonts (inluding the symbol font),
colors and visual effects applied

Multiple textblocks making  an instruction screen

Multiple textblocks making
an instruction screen


Practical Use

Creating a single textblock on a visual scene

  1. Select Event where you want to place a textblock
  2. Add Text Element into that event, the element will appear at the center of the screen
  3. Select the element in the Element List
  4. Edit the Text property of the element in the Property Panel. Use the return key to add new lines.
  5. Adjust the size of element's rendering area in the Scene Editor with the mouse. Alternatevly, set the uniform font size by adjusting the AutoSize property.
  6. Change the font, color and text alignment of the elementif nessesary, with the corresponding properties in the Property Panel
  7. Adjust element's screen position, if nessesary

Using the text element for delivering visual feedback

  1. Add Text Element into a feedback event.
  2. Create a Proxy Variable, for example, called FeedbackText, linked to the Text property of the element.
  3. Add the following code into any snippet called before activation of the feedback event in each trial (Snippet suggestion- OnDeactivated of the previous event or OnActivating of the parent event)

 // Check the trial outcome. Result and RT just other user variables
if (Result==true)
   {
   FeedbackText="Correct";
   }   
else
   {
   FeedbackText="Wrong";
   }

if (RT>5000)
   FeedbackText="Too Late";


Notes

If you use the transparent background in the parent event and the global backgound is bright, then you may discover that a tiny border around the text is rendered by the Text Element. To prevent this rendering issue from happening you can either set a solid background for the parent event or switch-off the antialiasing in properties of Text Element.

ScrewTurn Wiki version 5.2.0.8. Some of the icons created by FamFamFam.