<HTML
><HEAD
><TITLE
>SWFAction</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="PHP Manual"
HREF="index.html"><LINK
REL="UP"
TITLE="Ming functions for Flash"
HREF="ref.ming.html"><LINK
REL="PREVIOUS"
TITLE="ming_useswfversion"
HREF="function.ming-useswfversion.html"><LINK
REL="NEXT"
TITLE="SWFBitmap->getHeight"
HREF="function.swfbitmap.getheight.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=ISO-8859-1"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.ming-useswfversion.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.swfbitmap.getheight.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.swfaction"
></A
>SWFAction</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN52768"
></A
><P
> (PHP 4 >= 4.0.5)</P
>SWFAction -- Creates a new Action.</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN52771"
></A
><H2
>Description</H2
>new <B
CLASS="methodname"
>swfaction</B
> ( string script)<BR
></BR
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>Warning</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>This function is
<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>EXPERIMENTAL</I
></SPAN
>. The behaviour of this function, the
name of this function, and anything else documented about this
function may change without notice in a future release of PHP.
Use this function at your own risk.</P
></TD
></TR
></TABLE
></DIV
><P
> <B
CLASS="function"
>swfaction()</B
> creates a new Action, and
compiles the given script into an SWFAction object.
</P
><P
> The script syntax is based on the C language, but with a lot taken out- the SWF
bytecode machine is just too simpleminded to do a lot of things we might like.
For instance, we can't implement function calls without a tremendous
amount of hackery because the jump bytecode has a hardcoded offset
value. No pushing your calling address to the stack and returning-
every function would have to know exactly where to return to.
</P
><P
> So what's left? The compiler recognises the following tokens:
<P
></P
><UL
><LI
><P
> break
</P
></LI
><LI
><P
> for
</P
></LI
><LI
><P
> continue
</P
></LI
><LI
><P
> if
</P
></LI
><LI
><P
> else
</P
></LI
><LI
><P
> do
</P
></LI
><LI
><P
> while
</P
></LI
></UL
>
</P
><P
> There is no typed data; all values in the SWF action machine are stored as strings.
The following functions can be used in expressions:
<P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>time()</DT
><DD
><P
> Returns the number of milliseconds (?) elapsed since the movie started.
</P
></DD
><DT
>random(seed)</DT
><DD
><P
> Returns a pseudo-random number in the range 0-seed.
</P
></DD
><DT
>length(expr)</DT
><DD
><P
> Returns the length of the given expression.
</P
></DD
><DT
>int(number)</DT
><DD
><P
> Returns the given number rounded down to the nearest integer.
</P
></DD
><DT
>concat(expr, expr)</DT
><DD
><P
> Returns the concatenation of the given expressions.
</P
></DD
><DT
>ord(expr)</DT
><DD
><P
> Returns the ASCII code for the given character
</P
></DD
><DT
>chr(num)</DT
><DD
><P
> Returns the character for the given ASCII code
</P
></DD
><DT
>substr(string, location, length)</DT
><DD
><P
> Returns the substring of length length at location location of
the given string string.
</P
></DD
></DL
></DIV
>
</P
><P
> Additionally, the following commands may be used:
<P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>duplicateClip(clip, name, depth)</DT
><DD
><P
> Duplicate the named movie clip (aka sprite). The new movie clip has name name
and is at depth depth.
</P
></DD
><DT
>removeClip(expr)</DT
><DD
><P
> Removes the named movie clip.
</P
></DD
><DT
>trace(expr)</DT
><DD
><P
> Write the given expression to the trace log. Doubtful that the browser
plugin does anything with this.
</P
></DD
><DT
>startDrag(target, lock, [left, top, right, bottom])</DT
><DD
><P
> Start dragging the movie clip target. The lock argument indicates whether
to lock the mouse (?)- use 0 (<TT
CLASS="constant"
><B
>FALSE</B
></TT
>) or 1 (<TT
CLASS="constant"
><B
>TRUE</B
></TT
>). Optional parameters
define a bounding area for the dragging.
</P
></DD
><DT
>stopDrag()</DT
><DD
><P
> Stop dragging my heart around. And this movie clip, too.
</P
></DD
><DT
>callFrame(expr)</DT
><DD
><P
> Call the named frame as a function.
</P
></DD
><DT
>getURL(url, target, [method])</DT
><DD
><P
> Load the given URL into the named target. The target argument
corresponds to HTML document targets (such as "_top" or "_blank").
The optional method argument can be POST or GET if you want to submit
variables back to the server.
</P
></DD
><DT
>loadMovie(url, target)</DT
><DD
><P
> Load the given URL into the named target. The target argument can be a
frame name (I think), or one of the magical values "_level0" (replaces
current movie) or "_level1" (loads new movie on top of current movie).
</P
></DD
><DT
>nextFrame()</DT
><DD
><P
> Go to the next frame.
</P
></DD
><DT
>prevFrame()</DT
><DD
><P
> Go to the last (or, rather, previous) frame.
</P
></DD
><DT
>play()</DT
><DD
><P
> Start playing the movie.
</P
></DD
><DT
>stop()</DT
><DD
><P
> Stop playing the movie.
</P
></DD
><DT
>toggleQuality()</DT
><DD
><P
> Toggle between high and low quality.
</P
></DD
><DT
>stopSounds()</DT
><DD
><P
> Stop playing all sounds.
</P
></DD
><DT
>gotoFrame(num)</DT
><DD
><P
> Go to frame number num. Frame numbers start at 0.
</P
></DD
><DT
>gotoFrame(name)</DT
><DD
><P
> Go to the frame named name. Which does a lot of good, since I
haven't added frame labels yet.
</P
></DD
><DT
>setTarget(expr)</DT
><DD
><P
> Sets the context for action. Or so they say- I really have no
idea what this does.
</P
></DD
></DL
></DIV
>
And there's one weird extra thing. The expression frameLoaded(num) can be used
in if statements and while loops to check if the given frame number has been
loaded yet. Well, it's supposed to, anyway, but I've never tested it and I
seriously doubt it actually works. You can just use /:framesLoaded instead.
</P
><P
> Movie clips (all together now- aka sprites) have properties. You can
read all of them (or can you?), you can set some of them, and here
they are:
<P
></P
><UL
><LI
><P
> x
</P
></LI
><LI
><P
> y
</P
></LI
><LI
><P
> xScale
</P
></LI
><LI
><P
> yScale
</P
></LI
><LI
><P
> currentFrame - (read-only)
</P
></LI
><LI
><P
> totalFrames - (read-only)
</P
></LI
><LI
><P
> alpha - transparency level
</P
></LI
><LI
><P
> visible - 1=on, 0=off (?)
</P
></LI
><LI
><P
> width - (read-only)
</P
></LI
><LI
><P
> height - (read-only)
</P
></LI
><LI
><P
> rotation
</P
></LI
><LI
><P
> target - (read-only) (???)
</P
></LI
><LI
><P
> framesLoaded - (read-only)
</P
></LI
><LI
><P
> name
</P
></LI
><LI
><P
> dropTarget - (read-only) (???)
</P
></LI
><LI
><P
> url - (read-only) (???)
</P
></LI
><LI
><P
> highQuality - 1=high, 0=low (?)
</P
></LI
><LI
><P
> focusRect - (???)
</P
></LI
><LI
><P
> soundBufTime - (???)
</P
></LI
></UL
>
So, setting a sprite's x position is as simple as <TT
CLASS="literal"
>/box.x = 100;</TT
>.
Why the slash in front of the box, though? That's how flash keeps
track of the sprites in the movie, just like a unix filesystem-
here it shows that box is at the top level. If the sprite named
box had another sprite named biff inside of it, you'd set its x
position with /box/biff.x = 100;. At least, I think so; correct
me if I'm wrong here.
</P
><P
> This simple example will move the red square across the window.
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN52949"
></A
><P
><B
>Example 1. <B
CLASS="function"
>swfaction()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="php"
><?php
$s = new SWFShape();
$f = $s->addFill(0xff, 0, 0);
$s->setRightFill($f);
$s->movePenTo(-500,-500);
$s->drawLineTo(500,-500);
$s->drawLineTo(500,500);
$s->drawLineTo(-500,500);
$s->drawLineTo(-500,-500);
$p = new SWFSprite();
$i = $p->add($s);
$i->setDepth(1);
$p->nextFrame();
for($n=0; $n<5; ++$n)
{
$i->rotate(-15);
$p->nextFrame();
}
$m = new SWFMovie();
$m->setBackground(0xff, 0xff, 0xff);
$m->setDimension(6000,4000);
$i = $m->add($p);
$i->setDepth(1);
$i->moveTo(-500,2000);
$i->setName("box");
$m->add(new SWFAction("/box.x += 3;"));
$m->nextFrame();
$m->add(new SWFAction("gotoFrame(0); play();"));
$m->nextFrame();
header('Content-type: application/x-shockwave-flash');
$m->output();
?></PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> This simple example tracks down your mouse on the screen.
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN52954"
></A
><P
><B
>Example 2. <B
CLASS="function"
>swfaction()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="php"
><?php
$m = new SWFMovie();
$m->setRate(36.0);
$m->setDimension(1200, 800);
$m->setBackground(0, 0, 0);
/* mouse tracking sprite - empty, but follows mouse so we can
get its x and y coordinates */
$i = $m->add(new SWFSprite());
$i->setName('mouse');
$m->add(new SWFAction("
startDrag('/mouse', 1); /* '1' means lock sprite to the mouse */
"));
/* might as well turn off antialiasing, since these are just squares. */
$m->add(new SWFAction("
this.quality = 0;
"));
/* morphing box */
$r = new SWFMorph();
$s = $r->getShape1();
/* Note this is backwards from normal shapes. No idea why. */
$s->setLeftFill($s->addFill(0xff, 0xff, 0xff));
$s->movePenTo(-40, -40);
$s->drawLine(80, 0);
$s->drawLine(0, 80);
$s->drawLine(-80, 0);
$s->drawLine(0, -80);
$s = $r->getShape2();
$s->setLeftFill($s->addFill(0x00, 0x00, 0x00));
$s->movePenTo(-1, -1);
$s->drawLine(2, 0);
$s->drawLine(0, 2);
$s->drawLine(-2, 0);
$s->drawLine(0, -2);
/* sprite container for morphing box -
this is just a timeline w/ the box morphing */
$box = new SWFSprite();
$box->add(new SWFAction("
stop();
"));
$i = $box->add($r);
for($n=0; $n<=20; ++$n)
{
$i->setRatio($n/20);
$box->nextFrame();
}
/* this container sprite allows us to use the same action code many times */
$cell = new SWFSprite();
$i = $cell->add($box);
$i->setName('box');
$cell->add(new SWFAction("
setTarget('box');
/* ...x means the x coordinate of the parent, i.e. (..).x */
dx = (/mouse.x + random(6)-3 - ...x)/5;
dy = (/mouse.y + random(6)-3 - ...y)/5;
gotoFrame(int(dx*dx + dy*dy));
"));
$cell->nextFrame();
$cell->add(new SWFAction("
gotoFrame(0);
play();
"));
$cell->nextFrame();
/* finally, add a bunch of the cells to the movie */
for($x=0; $x<12; ++$x)
{
for($y=0; $y<8; ++$y)
{
$i = $m->add($cell);
$i->moveTo(100*$x+50, 100*$y+50);
}
}
$m->nextFrame();
$m->add(new SWFAction("
gotoFrame(1);
play();
"));
header('Content-type: application/x-shockwave-flash');
$m->output();
?></PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> Same as above, but with nice colored balls...
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN52959"
></A
><P
><B
>Example 3. <B
CLASS="function"
>swfaction()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="php"
><?php
$m = new SWFMovie();
$m->setDimension(11000, 8000);
$m->setBackground(0x00, 0x00, 0x00);
$m->add(new SWFAction("
this.quality = 0;
/frames.visible = 0;
startDrag('/mouse', 1);
"));
// mouse tracking sprite
$t = new SWFSprite();
$i = $m->add($t);
$i->setName('mouse');
$g = new SWFGradient();
$g->addEntry(0, 0xff, 0xff, 0xff, 0xff);
$g->addEntry(0.1, 0xff, 0xff, 0xff, 0xff);
$g->addEntry(0.5, 0xff, 0xff, 0xff, 0x5f);
$g->addEntry(1.0, 0xff, 0xff, 0xff, 0);
// gradient shape thing
$s = new SWFShape();
$f = $s->addFill($g, SWFFILL_RADIAL_GRADIENT);
$f->scaleTo(0.03);
$s->setRightFill($f);
$s->movePenTo(-600, -600);
$s->drawLine(1200, 0);
$s->drawLine(0, 1200);
$s->drawLine(-1200, 0);
$s->drawLine(0, -1200);
// need to make this a sprite so we can multColor it
$p = new SWFSprite();
$p->add($s);
$p->nextFrame();
// put the shape in here, each frame a different color
$q = new SWFSprite();
$q->add(new SWFAction("gotoFrame(random(7)+1); stop();"));
$i = $q->add($p);
$i->multColor(1.0, 1.0, 1.0);
$q->nextFrame();
$i->multColor(1.0, 0.5, 0.5);
$q->nextFrame();
$i->multColor(1.0, 0.75, 0.5);
$q->nextFrame();
$i->multColor(1.0, 1.0, 0.5);
$q->nextFrame();
$i->multColor(0.5, 1.0, 0.5);
$q->nextFrame();
$i->multColor(0.5, 0.5, 1.0);
$q->nextFrame();
$i->multColor(1.0, 0.5, 1.0);
$q->nextFrame();
// finally, this one contains the action code
$p = new SWFSprite();
$i = $p->add($q);
$i->setName('frames');
$p->add(new SWFAction("
dx = (/:mousex-/:lastx)/3 + random(10)-5;
dy = (/:mousey-/:lasty)/3;
x = /:mousex;
y = /:mousey;
alpha = 100;
"));
$p->nextFrame();
$p->add(new SWFAction("
this.x = x;
this.y = y;
this.alpha = alpha;
x += dx;
y += dy;
dy += 3;
alpha -= 8;
"));
$p->nextFrame();
$p->add(new SWFAction("prevFrame(); play();"));
$p->nextFrame();
$i = $m->add($p);
$i->setName('frames');
$m->nextFrame();
$m->add(new SWFAction("
lastx = mousex;
lasty = mousey;
mousex = /mouse.x;
mousey = /mouse.y;
++num;
if(num == 11)
num = 1;
removeClip('char' & num);
duplicateClip(/frames, 'char' & num, num);
"));
$m->nextFrame();
$m->add(new SWFAction("prevFrame(); play();"));
header('Content-type: application/x-shockwave-flash');
$m->output();
?></PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> This simple example will handles keyboard actions.
(You'll probably have to click in the window to give it focus.
And you'll probably have to leave your mouse in the frame, too.
If you know how to give buttons focus programatically, feel free
to share, won't you?)
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN52964"
></A
><P
><B
>Example 4. <B
CLASS="function"
>swfaction()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="php"
><?php
/* sprite has one letter per frame */
$p = new SWFSprite();
$p->add(new SWFAction("stop();"));
$chars = "abcdefghijklmnopqrstuvwxyz".
"ABCDEFGHIJKLMNOPQRSTUVWXYZ".
"1234567890!@#$%^&/*()_+-=/[]{}|;:,.<>?`~";
$f = new SWFFont("_sans");
for($n=0; $nremove($i);
$t = new SWFTextField();
$t->setFont($f);
$t->setHeight(240);
$t->setBounds(600,240);
$t->align(SWFTEXTFIELD_ALIGN_CENTER);
$t->addString($c);
$i = $p->add($t);
$p->labelFrame($c);
$p->nextFrame();
}
/* hit region for button - the entire frame */
$s = new SWFShape();
$s->setFillStyle0($s->addSolidFill(0, 0, 0, 0));
$s->drawLine(600, 0);
$s->drawLine(0, 400);
$s->drawLine(-600, 0);
$s->drawLine(0, -400);
/* button checks for pressed key, sends sprite to the right frame */
$b = new SWFButton();
$b->addShape($s, SWFBUTTON_HIT);
for($n=0; $naddAction(new SWFAction("
setTarget('/char');
gotoFrame('$c');
"), SWFBUTTON_KEYPRESS($c));
}
$m = new SWFMovie();
$m->setDimension(600,400);
$i = $m->add($p);
$i->setName('char');
$i->moveTo(0,80);
$m->add($b);
header('Content-type: application/x-shockwave-flash');
$m->output();
?></PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.ming-useswfversion.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.swfbitmap.getheight.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>ming_useswfversion</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.ming.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>SWFBitmap->getHeight</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
Mandriva
>
9.1
>
ppc
>
media
>
main
>
by-pkgid
>
0afeee9cca140e167a996902b9a677c5
>
files
>
2634
