Causes the Text object to display the value of another object's property.
Category
Latest Behaviors
Author
Gavin Kistner
Difficulty
(Reference)
Time to Complete
5 Minutes
Downloads
Click Here
to download the associated files.
(This document covers version 1.2.2 of the 'Display Property' behavior, current as of 2005-Feb-11)
Description
The
Target Property
parameter may be specified either in global scope (e.g. ‘mouse.x’ or ‘scene.Layer.Cube.materials
0
.diffuse.r’) or as a path relative to the behavior (e.g. ‘parent.font’ or ‘parent.parent.rotation.x’).
If
Max Characters
is greater than zero, the display value for the property will be truncated to no more than this number of characters. For example, a value of ’-23.124564462’ with
Max Characters
set to ‘5’ would display as ’-23.1’. Alternatively, if
Round Value?
is checked, the display value for the property will be treated as a number and rounded to the nearest integer.
The
Prefix
and
Suffix
strings are wrapped around the property value. They do not contribute to overall character count for
Max Characters
.
If
Start Immediately?
is not checked, the text will not begin updating until the
Start
action is called on this behavior.
Basic Properties
Target Property
Code reference to the object/property to display.
Start Immediately?
Start displaying the property immediately, or wait for the 'Start' action to be called?
Advanced Properties
Prefix
Text to put before the value.
Suffix
Text to put after the value.
Max Characters
Limit the length of the displayed value (0 for unlimited)
Decimal Places
Decimal places to round the output to (-1 for no rounding).
Actions
Start
Begin displaying the property value.
Stop
Stop updating the text to match the property value.
Update Once
Display the current property value (for when not already running).
Events
Value Changed
Fires every time the watched property changes value.
