swf::button(3pm) [debian man page]
.::SWF::Button(3pm) User Contributed Perl Documentation .::SWF::Button(3pm) NAME
SWF::Button - SWF button class SYNOPSIS
use SWF::Button; $button = new SWF::Button(); $button->setUp($shape1); $button->setDown($shape2); DESCRIPTION
Creates buttons for flash movies. Buttons are controlled by various methods for visible design and triggered actions, see below: METHODS
new SWF::Button() Creates a new Button object. $button->addShape($shape, FLAG) Adds $shape to the button. Using this method is not recommended, better use addCharacter(), see next item for details. Also unlike addCharacter() this method does not return any SWF::ButtonRecord objects $buttonrecord = $button->addCharacter($character [, $flags]) Adds character $shape to the button. Valid FLAGs are: SWFBUTTON_HIT SWFBUTTON_UP SWFBUTTON_DOWN SWFBUTTON_OVER Unlike addShape() this method returns an object of SWF::ButtonRecord class. The flag states can be combined using the binary or operator. $buttonrecord = $button->setOver($shape) Shortcut for $button->addCharacter($shape, SWFBUTTON_OVER); $buttonrecord = $button->setHit($shape) Shortcut for $button->addCharacter($shape, SWFBUTTON_HIT); $buttonrecord = $button->setUp($shape) Shortcut for $button->addCharacter($shape, SWFBUTTON_UP); $buttonrecord = $button->setDown($shape) Shortcut for $button->addCharacter($shape, SWFBUTTON_DOWN); $button->addAction($action [,FLAG]) $button->setAction($action [,FLAG]) Adds $action object (see SWF::Action). Valid FLAGs are: SWFBUTTON_MOUSEUP SWFBUTTON_MOUSEOVER SWFBUTTON_MOUSEOUT SWFBUTTON_MOUSEDOWN SWFBUTTON_DRAGOVER SWFBUTTON_DRAGOUT SWFBUTTON_MOUSEUP is the default value of FLAG. $button->setMenu(0|1) Parameter is 0 (off) or 1(on). Can be used for a slight different behavior of buttons. $soundinstance = $button->addSound($sound, $flags) Plays a prepared SWF::Sound object and returns an object of SWF::SoundInstance. Once more valid flags are: SWFBUTTON_MOUSEUP SWFBUTTON_MOUSEOVER SWFBUTTON_MOUSEOUT SWFBUTTON_MOUSEDOWN For example: $sound = new SWF::Sound("wow.mp3", SWF_SOUND_MP3_COMPRESSED ); $soundinstance = $button->addSound($sound, SWFBUTTON_MOUSEDOWN ); $button->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). $button->removeScalingGrid() Removes scaling grid rectangles. AUTHOR
wrapper written by Soheil Seyfaie (soheil at users dot sourceforge dot net) Peter Liscovius (peterdd at users dot sourceforge dot net) and many others. SEE ALSO
SWF, SWF::Action, SWF::Shape, SWF::Movie, SWF::MovieClip, SWF::Constants, SWF::Sound, SWF::SoundInstance perl v5.14.2 2011-10-26 .::SWF::Button(3pm)
Check Out this Related Man Page
.::SWF::DisplayItem(3pm) User Contributed Perl Documentation .::SWF::DisplayItem(3pm) NAME
SWF::DisplayItem - SWF DisplayItem class SYNOPSIS
use SWF::DisplayItem; $dispitem = $movie->add($shape); $dispitem->rotate(45); DESCRIPTION
When you place an SWF object (one of the types that can be seen with eyes by user) in a frame of a SWF::Movie or SWF::MovieClip, the return value will be in a SWF::DisplayItem. You can now modify that item in current and every following frames of the clip where you added the SWF object. Further it is accessible by ActionScript too. Just give the DisplayItem a name with method setName($name) after you added the SWF object to a SWF::Movie or SWF::MovieClip METHODS
$displayItem->moveTo($x, $y); Move $displayItem to ($x, $y) in global co-ordinates. $displayItem->move($x, $y); Displace $displayItem by ($x, $y) $displayItem->scaleTo($x [,$y]); Set $displayItem scale to $x in the x-direction and $y in the y-direction. If $y is not specified, $y=$x is assumed. $displayItem->scale($x [,$y]); Multiply $displayItem scale by $x in the x-direction and $y in the y-direction. If $y is not specified, $y=$x is assumed. $displayItem->rotateTo($degrees); Set $displayItem rotation to $degrees. $displayItem->rotate($degrees); Rotate $displayItem by $degrees. $displayItem->skewX($x); Add $x to the current x-skew. $displayItem->skewXTo($x); Set x-skew to $x. 1.0 is 45-degree forward slant. More is more forward while less is more backward. $displayItem->skewY($y); Add $y to the current y-skew. $displayItem->skewYTo($y); Set y-skew to $y. 1.0 is 45-degree upward slant. More is more upward while less is more downward. $displayItem->setMatrix($a, $b, $c, $d, $e, $f) Do an operation of rotating/skewing (b,c), moving (e,f) and scaling (a,d) at once. The default initial values of an SWF::DisplayItem object's matrix are 1.0, 0, 0, 1.0, 0, 0 . So calling setMatrix with these defaults (setMatrix(1.0, 0, 0, 1.0, 0, 0);) will reset results of earlier calls of SWF::DisplayItem methods (like rotate(45) etc. etc.) $displayItem->setDepth($depth); Set Z-order of $displayItem to $depth. $displayItem->setRatio($ratio); Useful for SWF::Morph. Sets $displayItem ratio to $ratio. $displayItem->setColorAdd($r, $g, $b [,$a])) $displayItem->addColor($r, $g, $b [,$a]); Add RGB color to the $displayItem's color transform. Default value of $a is 1.0 $displayItem->setColorMult($r, $g, $b [,$a])) $displayItem->multColor($r, $g, $b [,$a]); Multiplies the $displayItem's color transform by the given values. Default value of $a is 1.0 $displayItem->setName($name); Set $displayItem's name to $name (used for targetting with SWF::Action). $displayItem->remove(); Remove $displayItem from the movie display list. ($x, $y) = $displayItem->getPosition((); Returns displace coordinates of $displayitem. $degrees = $displayItem->getRotation(); Returns rotation of $displayItem. ($x, $y) = $displayItem->getScale(); Returns scale of $displayItem in x- and y-direction. ($x, $y) = $displayItem->getSkew(); Returns x- and y-skew of $displayItem. $depth = $displayItem->getDepth(); Returns Z-order of $displayItem. $displayItem->setMask($level); Sets a mask level: display items with lower or equal depth are masked, any other display items are not masked. Use setDepth() to control desired masking. $displayItem->endMask() End masking started by prior setMask() call. $displayItem->addAction( $action, $flags ) Add $action, an object of SWF::Action class. The flags are exported from SWF::Constants. SWFACTION_ONLOAD SWFACTION_ENTERFRAME SWFACTION_UNLOAD SWFACTION_MOUSEMOVE SWFACTION_MOUSEDOWN SWFACTION_MOUSEUP SWFACTION_KEYDOWN SWFACTION_KEYUP SWFACTION_DATA Using this flags you have control at which events the action will run. $displayItem->setBlendMode($mode) Set an alternative blend mode instead of default alpha blend. Possible modes are: SWFBLEND_MODE_NULL SWFBLEND_MODE_NORMAL SWFBLEND_MODE_LAYER SWFBLEND_MODE_MULT SWFBLEND_MODE_SCREEN SWFBLEND_MODE_DARKEN SWFBLEND_MODE_LIGHTEN SWFBLEND_MODE_ADD SWFBLEND_MODE_SUB SWFBLEND_MODE_DIFF SWFBLEND_MODE_INV SWFBLEND_MODE_ALPHA SWFBLEND_MODE_ERASE SWFBLEND_MODE_OVERLAY SWFBLEND_MODE_HARDLIGHT Here comes some demonstration code: use SWF::Constants qw(:DisplayItem); # .... $sh=new SWF::Shape(); $fill = $sh->addFill(255, 0, 0, 255); # red $sh->setRightFill($fill); $sh->drawLine(440, 0); $sh->drawLine(0, 380); $sh->drawLine(-440, 0); $sh->drawLine(0, -380); # $sh2=new SWF::Shape(); $fill2 = $sh2->addFill(0, 255, 0, 255); # green $sh2->setRightFill($fill2); $sh2->drawLine(240, 0); $sh2->drawLine(0, 280); $sh2->drawLine(-240, 0); $sh2->drawLine(0, -280); $di=$m->add($sh); $di2=$m->add($sh2); # $di2->setBlendMode( SWFBLEND_MODE_NORMAL); # would be green ( as you have expected ) $di2->setBlendMode( SWFBLEND_MODE_ADD); # y e l l o w ( surprising, a litle bit ) $displayItem->cacheAsBitmap($flag) Set a flag (value 0 or 1) showing the character can be cached as a bitmap. This might improve rendering speed, if the object does no change often. This feature is available for SWF version >= 8 only. $displayItem->flush() Writes the SWF::DisplayItem object immediately to the blocklist. Usually MING waits with writing a display item until a frame is closed through a nextFrame() call, because a display items state could be altered for the current frame. By using the flush() method MING does not wait and writes the frame immediately. Therefore an user can influence the swf tag order. Changing a display items state after calling flush() takes effect in the next frame. $matrix = $displayItem->getMatrix() Returns an associated SWF::Matrix object. $character = $displayItem->getCharacter() Returns the associated SWF::Character object. $displayItem->addFilter( $filter ) Process the DisplayItem object thru a prepared filter: an object of SWF::Filter class, e.g. BlurFilter or DropShadowFilter. Filters are available since player version 8. $displayItem->setCXform( $cxform ) Process the DisplayItem object thru $cxform: a prepared color transformation object of SWF::CXform class. AUTHOR
Soheil Seyfaie (soheil AT users.sourceforge.net) Peter Liscovius Albrecht Kleine SEE ALSO
SWF, SWF::Button, SWF::Movie, SWF::MovieClip, SWF::Shape, SWF::Text, SWF::TextField, SWF::Filter, SWF::CXform, SWF::Matrix, SWF::Action, SWF::Morph, SWF::Character, SWF::Constants perl v5.14.2 2011-10-26 .::SWF::DisplayItem(3pm)