Animates, displays values, shows pictures, or plays movies in its icon based on the value at its input. You can choose to display a value at its inputs, animate (flash box, flash text, flash circle, show picture, play movie) when the input values are greater than or equal to a value specified in the dialog, or you can have the icon show a rising and falling level to indicate where the input values fall within a specified range. You can also specify the color and pattern of the animated object (this is ignored for pictures or movies).
If this block is used in a hierarchical window, you can animate the hierarchical block's icon based on the values received by the Animate Value block. First determine which block in the submodel you want to animate. Then connect the output of that block to the input of the Animate Value block (you can connect the output of the Animate Value to another input, or just not connect it). You animate the hierarchical icon by adding an animation object to the hierarchical block's icon. Then specify in the dialog of the Animate Value block what the number of the animation object is. Consult the manual for information about how to animate hierarchical blocks.
Dialog Choices
Animate when input is >=: You can choose the type of animation to show (flash box, flash text, flash circle, show picture, play movie) when the input value equals or exceeds a value specified in the dialog.
Animate by changing a level: If you choose this type of animation, the icon will show a level which rises and falls depending on where the input value falls between the specified minimum and maximum values.
Color: Select a color for the icon to show when animated (ignored for pictures and movies).
Display value at input connector: If you choose this type of animation, the icon will show the input value as text.
Flash box: Shows a box with the specified color and pattern when the value equals or exceeds the specified value.
Flash circle: Shows a circle with the specified color and pattern when the value equals or exceeds the specified value.
Flash text: Shows the entered text when the value equals or exceeds the specified value.
Play movie: Plays the "movie name" at the relative "movie speed" asynchronously when the value equals or exceeds the specified value. "Movie name" must be a QuickTime movie file in the Extend Extensions folder. Don't forget to turn the Run menu item "Show Movies" on.
Show picture: Shows the "picture name" when the value equals or exceeds the specified value. "Picture name" must be a PICT resource in a resource file in the Extend Extensions folder.
Maximum: If the Animate by showing a level changing choice is selected, the Maximum value specifies the top of the range for the level. Be sure to specify the maximum possible value receivable.
Minimum: If the Animate by showing a level changing choice is selected, the Minimum value specifies the bottom of the range for the level. Be sure to specify the minimum possible value receivable.
Pattern: Select a pattern for the icon to show when animated (ignored for pictures and movies).
To animate a hierarchical...: Use only if you use this block in a hierarchical submodel and you want the hierarchical block to animate based on the values that this block receives. You must put an animation object in the hierarchical block's icon. You must specify the hierarchical icon's animation object number in the dialog of this Animate Value block. You must also connect this Animate Value block to the block in the submodel whose value you want to animate.
Wait here before replay: If this block is playing a movie when it gets another message to start the movie again, the simulation will pause until the first movie has finished.
Connectors
The input connector is a value.
The output is the same value as the input. You can attach the output to the next block's input, or you can leave it unconnected.
