TOPIC LOCATION:     `Stage Editor`;     `Object Menu (Stage)`

PRECEDING TOPIC:    `Alignment Bar`
FOLLOWING TOPIC:    `Show_Path_Length`

VISUAL DEMONSTRATION AVAILABLE:    `(S)_Size_Bar.demo`

* (Make sure CAMERA VIEW is selected in the Stage Editor's Display Menu)

To have an object's size change over the course of an animation, you would
normally have to enter the Action script editor to break up the size
timeline in order to enter the changing size values.  The Size Bar function
allows you to interactively change the size of an object at certain frames
within the Stage Editor screen.

You must first have started by entering the Action script editor and
setting the number of frames for the animation. Make sure that the object
whose size you want to adjust, exists in the desired frames; set the
starting and ending frames in the object's Actor timeline. Then enter the
Stage Editor quad views.

For a simple example, in a 30 frame animation, let's cause an object to
start out at a relatively small size, expand to a much larger size at frame
15, then shrink back to small size again at frame 30.  If you are not
already at frame 1, just goto it by selecting First from the Frame menu.
Use the interactive manipulation functions (S on the keyboard for scaling)
or the Transformation function to adjust the size of the object in this
frame.  After the size is set, select Size Bar from the object menu.  The
values for the Size timeline in the Action Script will automatically be set
according to the current, visual size of the object.  Now goto frame 15 and
scale the the object to a larger size.  Again, select Size Bar to adjust
the Size timeline.  Finally go to the last frame (30), reduce the size of
the object and select Size Bar a final time.  If you enter the Action
Script Screen, you should notice that the Size bar has automatically been
set and split appropriately over the 30 frames.  You can then select Make
to build the preview of the animation.

