Welcome Guest, you are in: <root>Elements • Login

Page History: Text Element

Compare Page Revisions

65 64 63 62 61 60 59 58 57 56 55 54 53 52 51 50 49 48 47 46 45 44 43 42 41 40 39 38 37 36 35 34 33 32 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Current 65 64 63 62 61 60 59 58 57 56 55 54 53 52 51 50 49 48 47 46 45 44 43 42 41 40 39 38 37 36 35 34 33 32 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

« Older Revision - Back to Page History - Newer Revision »

Page Revision: 2011/07/16 10:47

Text element allows diplaying a text in experiments.

Table of Contents [Hide/Show] Description Pictures     Creating a single textblock on a visual scene     Using text element for delivering a visual feedback Notes Generic Properties

Description ¶

Text element provides a variety of text decoration options, like font, color, alignment. The visual appearance of the text element can be changed at runtime - for example a particular text feedback can be delivered to participants dependent upon their response. You can use multiple text elements with different visual properties to create comprehensive, professional instruction screens.

Pictures ¶

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

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 enter to add new lines.
5. Adjust the size of element's rendering area in the Scene Editor with a mouse. Alternatevly, set a fixed font size by AutoSize property.
6. Change a font, color and text alignment of the element, if nessesary, by corresponding properties in the Property Panel
7. Adjust element's screen position
   

Using text element for delivering a 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.
   

    // Check the trial outcome
   
   if (Result==true)
   
   {
   
   FeedbackText="Correct";
   
   }   
   
   else
   
   {
   
   FeedbackText="Wrong";
   
   }
   
   
   if (RT<=5000)
   
   FeedbackText="Too Late";
   
   

   
   

Notes ¶

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

Generic Properties ¶

Name	Description	Attributes	Value Type
VISUAL APPEARANCE
Font Color	Defines the color of the rendered text	D, R, *	clColor
Text	Multi-line string value that defines a text rendered by the element. Strings can be are separated in the runtime by inserting "\n" char.	D,R,*	String
Font	Defines the font for the rendered text	D,R,*	Font, String
Auto size	Assigning a number to this property causes resetting of the element size according to the new font size. The width and height can be reset differently in order to render the text in the right proportion.	D, WriteOnly	float
Text alignment	Defines the alignment of the rendered text within the output rectangular area.	D	TextAligment

+=== 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.	Design Time..	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	Visual Update..
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	Visual Update..
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	Visual Update..
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.	Status..	Int32
Pivot Point	Defines the pivot point (coordinate and the rotation centers) within the element viewport.		stAlignment or Int32	Visual Update..
Visible	Defines whether the element is currently visible on the event surface. The property is convenient for switching visual content on and off.		Boolean	Visual Update..
Rotation	Defines the rotation angle (in degrees) of element viewport relative to the its pivot point.		Double in the range 0..360	Visual Update..
EFFECTS
Transparent Color	The color of the original pixels of rendered content that will be set as transparent.		stColor	Visual Update..
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)	Visual Update..
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	Visual Update..
Opacity	Opacity of the rendered content.		Int32, range (0..100)	Visual Update..
Contrast	Contrast of the rendered content.		Int32, range (-100..100)	Visual Update..
Brightness	Defines the brighness of the rendered content.		Int32, range (-100..100)	Visual Update..
Saturation	Saturation of the rendered content.		Double	Visual Update..
Pixelation	Defines the pixel scale of the rendering.		Int32, range (0..100)	Visual Update..
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	Visual Update..
POSITIONAL JITTER
Reset Jitter	Set to true at runtime to reset the current positional jitter.	Runtime Command..	Boolean, set true for action	Visual Update..
Current Jitter	Jitter range, in pixels (non inclusive).	.	clSize	Visual Update..
Jitter Range	Jitter range, centered at the original position of the element.	.	clSize	Visual Update..

+=== 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.	Status..	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.	Design Time..	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.	Design Time..	Boolean
Title	Title of the element.	Design Time..	String