NAME¶
SWF::MovieClip - MovieClip Class
SYNOPSIS¶
use SWF::MovieClip;
my $movieclip = new SWF::MovieClip();
DESCRIPTION¶
SWF::MovieClip allows you to add animated objects to your Flash movies.
METHODS¶
- $mc= new SWF::MovieClip()
- Returns an SWF::MovieClip object.
- $item = $mc->add($swfobject)
- When you add following types of objects to the $mc they
will return a SWF::DisplayItem:
- SWF::Button
- SWF::PrebuiltClip (a whole external swf file)
- SWF::MovieClip (you can nest them like a tree)
- SWF::Shape
- SWF::Text
- SWF::TextField
- SWF::VideoStream
[ToDo: to be verified: When you add a SWF::Sound the return value is a
SWF::SoundInstance: $si = $mc->add($sound); ]
- $si = $mc->startSound($sound)
- Starts making noise and returns an object of
SWF::SoundInstance class.
- $mc->stopSound($sound)
- Stops sound started by startSound() method.
- $mc->remove($di)
- Removes SWF::DisplayItem $di from the display list.
- $mc->nextFrame()
- Move to the next frame in the timeline of SWF::MovieClip
$mc
- $mc->setNumberOfFrames($i)
- $mc->setFrames($i)
- Sets total number of $mc frames to $i This is an optional
autofiller, e.g. when you want to be sure that 2 different movieclips have
100 frames when playing, but the number of nextFrame() calls in
these 2 movieclips is unknown or dynamic (dependent on data from
databases, whatever). By default a movieclip the number of frames in the
timeline is how often you called $mc->nextFrame for this clip.
- $mc->labelFrame($name)
- Sets frame name to $name. You are then able to access this
frame by name in ActionScript, not just by frame number.
- $mc->setScalingGrid($x, $y, $w, $h)
- This function (available from SWF>=8) sets a 9 slice
scaling grid: 1 2 3 4 5 6 7 8 9 X, y, w and h define a rectangle, which is
the dimension of the center slice (5). All other slices are determined out
of the characters bounds and the defined rect. While slice 5 is scaled
vertical and horizontal, slice 2 and 8 are only scaled horizontal. Slice 4
and 6 only vertical. The 4 corner slices are not scaled (1, 3, 7, 9).
[ToDo: to be verified]
- $mc->removeScalingGrid()
- Removes scaling grid rectangles.
- $mc->addInitAction($action)
- Adds an initial ActionScript block to MovieClip $mc. These
actions are executed before the MovieClip is available as a script object.
[ToDo: to be verified]
- $mc->setSoundStream($sound, $rate, [$skip])
- Includes streaming sound to a movie. [ToDo: add more doc
and a demo here.]
AUTHOR¶
Soheil Seyfaie (soheil@netcom.ca) Peter Liscovius
see AUTHORS of ming distribution (ming.sf.net)
SEE ALSO¶
SWF::DisplayItem for how you can modify the instances in a SWF::MovieClip or
SWF::Movie SWF, SWF::Action, SWF::InitAction, SWF::Button, SWF::Movie,
SWF::Shape, SWF::Sound, SWF::SoundStream, SWF::Text, SWF::TextField,
SWF::VideoStream