PHP: Ming functions for Flash - Manual
PHP  
downloads | documentation | faq | getting help | mailing lists | | php.net sites | links | my php.net 
search for in the  
<mssql_select_dbming_setcubicthreshold>
view the version of this page
Last updated: Thu, 15 Jul 2004

LXIII. Ming functions for Flash

Varov�n�

Toto roz���en� je EXPERIMENT�LN�. Chov�n� tohoto roz���en�, n�zvy funkc� a v�echno ostatn�, co je zde zdokumentov�no, se v budouc�ch verz�ch PHP m��e bez ohl�en� zm�nit. Berte to v �vahu a pou��vejte tento modul na vlastn� nebezpe��.

�vod

First of all: Ming is not an acronym. Ming is an open-source (LGPL) library which allows you to create SWF ("Flash") format movies. Ming supports almost all of Flash 4's features, including: shapes, gradients, bitmaps (pngs and jpegs), morphs ("shape tweens"), text, buttons, actions, sprites ("movie clips"), streaming mp3, and color transforms --the only thing that's missing is sound events.

Note that all values specifying length, distance, size, etc. are in "twips", twenty units per pixel. That's pretty much arbitrary, though, since the player scales the movie to whatever pixel size is specified in the embed/object tag, or the entire frame if not embedded.

Ming offers a number of advantages over the existing PHP/libswf module. You can use Ming anywhere you can compile the code, whereas libswf is closed-source and only available for a few platforms, Windows not one of them. Ming provides some insulation from the mundane details of the SWF file format, wrapping the movie elements in PHP objects. Also, Ming is still being maintained; if there's a feature that you want to see, just let us know .

Ming was added in PHP 4.0.5.

Po�adavky

To use Ming with PHP, you first need to build and install the Ming library. Source code and installation instructions are available at the Ming home page: along with examples, a small tutorial, and the latest news.

Download the ming archive. Unpack the archive. Go in the Ming directory. make. make install.

This will build libming.so and install it into /usr/lib/, and copy ming.h into /usr/include/. Edit the PREFIX= line in the Makefile to change the installation directory.

Instalace

P��klad 1. built into PHP (Unix)



    mkdir <phpdir>/ext/ming
    cp php_ext/* <phpdir>/ext/ming
    cd <phpdir>
    ./buildconf 
    ./configure --with-ming <other config options>

    

Build and install PHP as usual, restart web server if necessary.

Now either just add extension=php_ming.so to your php.ini file, or put dl('php_ming.so'); at the head of all of your Ming scripts.

Konfigurace b�hu

Toto roz���en� nem� definov�no ��dn� konfigura�n� direktivy.

P�eddefinovan� konstanty

Tyto konstanty jsou definov�ny t�mto roz���en�m a budou k dispozici pouze tehdy, bylo-li roz���en� zkompilov�no spole�n� s PHP nebo dynamicky zavedeno za b�hu.

SWFBUTTON_HIT (integer)

SWFBUTTON_DOWN (integer)

SWFBUTTON_OVER (integer)

SWFBUTTON_UP (integer)

SWFBUTTON_MOUSEUPOUTSIDE (integer)

SWFBUTTON_DRAGOVER (integer)

SWFBUTTON_DRAGOUT (integer)

SWFBUTTON_MOUSEUP (integer)

SWFBUTTON_MOUSEDOWN (integer)

SWFBUTTON_MOUSEOUT (integer)

SWFBUTTON_MOUSEOVER (integer)

SWFFILL_RADIAL_GRADIENT (integer)

SWFFILL_LINEAR_GRADIENT (integer)

SWFFILL_TILED_BITMAP (integer)

SWFFILL_CLIPPED_BITMAP (integer)

SWFTEXTFIELD_HASLENGTH (integer)

SWFTEXTFIELD_NOEDIT (integer)

SWFTEXTFIELD_PASSWORD (integer)

SWFTEXTFIELD_MULTILINE (integer)

SWFTEXTFIELD_WORDWRAP (integer)

SWFTEXTFIELD_DRAWBOX (integer)

SWFTEXTFIELD_NOSELECT (integer)

SWFTEXTFIELD_HTML (integer)

SWFTEXTFIELD_ALIGN_LEFT (integer)

SWFTEXTFIELD_ALIGN_RIGHT (integer)

SWFTEXTFIELD_ALIGN_CENTER (integer)

SWFTEXTFIELD_ALIGN_JUSTIFY (integer)

SWFACTION_ONLOAD (integer)

SWFACTION_ENTERFRAME (integer)

SWFACTION_UNLOAD (integer)

SWFACTION_MOUSEMOVE (integer)

SWFACTION_MOUSEDOWN (integer)

SWFACTION_MOUSEUP (integer)

SWFACTION_KEYDOWN (integer)

SWFACTION_KEYUP (integer)

SWFACTION_DATA (integer)

P�eddefinovan� t��dy

Tyto t��dy jsou definov�ny roz���en�m a budou dostupn� pouze v p��pad�, �e PHP bude zkompilov�no s t�mto roz���en�m nebo bude roz���en� zavedeno dynamicky za b�hu.

Ming introduces 13 new objects in PHP, all with matching methods and attributes. To use them, you need to know about objects.

swfshape

swffill

swfgradient

swfbitmap

swftext

swftextfield

swffont

swfdisplayitem

swfmovie

swfbutton

swfaction

swfmorph

swfsprite

Obsah
ming_setcubicthreshold --  Set cubic threshold (?)
ming_setscale --  Set scale (?)
ming_useswfversion --  Use SWF version (?)
SWFAction -- Creates a new Action.
SWFBitmap->getHeight -- Returns the bitmap's height.
SWFBitmap->getWidth -- Returns the bitmap's width.
SWFBitmap -- Loads Bitmap object
swfbutton_keypress --  Returns the action flag for keyPress(char)
SWFbutton->addAction -- Adds an action
SWFbutton->addShape -- Adds a shape to a button
SWFbutton->setAction -- Sets the action
SWFbutton->setdown -- Alias for addShape(shape, SWFBUTTON_DOWN)
SWFbutton->setHit -- Alias for addShape(shape, SWFBUTTON_HIT)
SWFbutton->setOver -- Alias for addShape(shape, SWFBUTTON_OVER)
SWFbutton->setUp -- Alias for addShape(shape, SWFBUTTON_UP)
SWFbutton -- Creates a new Button.
SWFDisplayItem->addColor -- Adds the given color to this item's color transform.
SWFDisplayItem->move -- Moves object in relative coordinates.
SWFDisplayItem->moveTo -- Moves object in global coordinates.
SWFDisplayItem->multColor -- Multiplies the item's color transform.
SWFDisplayItem->remove -- Removes the object from the movie
SWFDisplayItem->Rotate -- Rotates in relative coordinates.
SWFDisplayItem->rotateTo -- Rotates the object in global coordinates.
SWFDisplayItem->scale -- Scales the object in relative coordinates.
SWFDisplayItem->scaleTo -- Scales the object in global coordinates.
SWFDisplayItem->setDepth -- Sets z-order
SWFDisplayItem->setName -- Sets the object's name
SWFDisplayItem->setRatio -- Sets the object's ratio.
SWFDisplayItem->skewX -- Sets the X-skew.
SWFDisplayItem->skewXTo -- Sets the X-skew.
SWFDisplayItem->skewY -- Sets the Y-skew.
SWFDisplayItem->skewYTo -- Sets the Y-skew.
SWFDisplayItem -- Creates a new displayitem object.
SWFFill->moveTo -- Moves fill origin
SWFFill->rotateTo -- Sets fill's rotation
SWFFill->scaleTo -- Sets fill's scale
SWFFill->skewXTo -- Sets fill x-skew
SWFFill->skewYTo -- Sets fill y-skew
SWFFill -- Loads SWFFill object
swffont->getwidth -- Returns the string's width
SWFFont -- Loads a font definition
SWFGradient->addEntry -- Adds an entry to the gradient list.
SWFGradient -- Creates a gradient object
SWFMorph->getshape1 -- Gets a handle to the starting shape
SWFMorph->getshape2 -- Gets a handle to the ending shape
SWFMorph -- Creates a new SWFMorph object.
SWFMovie->add -- Adds any type of data to a movie.
SWFMovie->nextframe -- Moves to the next frame of the animation.
SWFMovie->output -- Dumps your lovingly prepared movie out.
swfmovie->remove -- Removes the object instance from the display list.
SWFMovie->save -- Saves your movie in a file.
SWFMovie->setbackground -- Sets the background color.
SWFMovie->setdimension -- Sets the movie's width and height.
SWFMovie->setframes -- Sets the total number of frames in the animation.
SWFMovie->setrate -- Sets the animation's frame rate.
SWFMovie->streammp3 -- Streams a MP3 file.
SWFMovie -- Creates a new movie object, representing an SWF version 4 movie.
SWFShape->addFill -- Adds a solid fill to the shape.
SWFShape->drawCurve -- Draws a curve (relative).
SWFShape->drawCurveTo -- Draws a curve.
SWFShape->drawLine -- Draws a line (relative).
SWFShape->drawLineTo -- Draws a line.
SWFShape->movePen -- Moves the shape's pen (relative).
SWFShape->movePenTo -- Moves the shape's pen.
SWFShape->setLeftFill -- Sets left rasterizing color.
SWFShape->setLine -- Sets the shape's line style.
SWFShape->setRightFill -- Sets right rasterizing color.
SWFShape -- Creates a new shape object.
swfsprite->add -- Adds an object to a sprite
SWFSprite->nextframe -- Moves to the next frame of the animation.
SWFSprite->remove -- Removes an object to a sprite
SWFSprite->setframes -- Sets the total number of frames in the animation.
SWFSprite -- Creates a movie clip (a sprite)
SWFText->addString -- Draws a string
SWFText->getWidth -- Computes string's width
SWFText->moveTo -- Moves the pen
SWFText->setColor -- Sets the current font color
SWFText->setFont -- Sets the current font
SWFText->setHeight -- Sets the current font height
SWFText->setSpacing -- Sets the current font spacing
SWFText -- Creates a new SWFText object.
SWFTextField->addstring -- Concatenates the given string to the text field
SWFTextField->align -- Sets the text field alignment
SWFTextField->setbounds -- Sets the text field width and height
SWFTextField->setcolor -- Sets the color of the text field.
SWFTextField->setFont -- Sets the text field font
SWFTextField->setHeight -- Sets the font height of this text field font.
SWFTextField->setindentation -- Sets the indentation of the first line.
SWFTextField->setLeftMargin -- Sets the left margin width of the text field.
SWFTextField->setLineSpacing -- Sets the line spacing of the text field.
SWFTextField->setMargins -- Sets the margins width of the text field.
SWFTextField->setname -- Sets the variable name
SWFTextField->setrightMargin -- Sets the right margin width of the text field.
SWFTextField -- Creates a text field object


add a note add a note User Contributed Notes
Ming functions for Flash
Habib Valanejad
14-Jul-2004 04:15
I had some problems compiling ming03a on Solaris using both gcc and/or Sun compiler. One problem was in php_ext/ming.c file. SWFMovie_setSoundStream() expects 2 args in
../ming.h file, but in ming.c we're passing 3 args to the function:
ming.c:
SWFMovie_setSoundStream(movie, sound, skip);
ming.h:
void SWFMovie_setSoundStream(SWFMovie movie, SWFSoundStream sound);

I had to remove the last argument (skip) in ming.c and do the compilation again.
wokan at cox dot net
02-Jun-2004 01:07
For those who don't get the naming, _Ming_ the Merciless was comic book hero _Flash_ Gordon's arch enemy.
jg at donotspam dot jmkg dot net
22-Dec-2003 03:14
As of July 10th 2003 the output method of SWFMovie now requires an integer 0 ... 9 parameter to select the compression intensity that should be used. This does not appear to be documented right now - a look in your webserver's error log will reveal a 'wrong paramter count' for this method - this is the reason why. SWFMovie->output(3) works okay - I presume 0 ... 9 mirrors gzip compression levels but I don't know...
Anze
03-Nov-2003 10:53
DisplayItem has another method, not included in this documentation - addAction(). Use it like this:

 $di=$m->add($mySprite); // add movie clip to main movie
 $di->addAction(new SWFAction("do_something();"),SWFACTION_ONLOAD);

Enjoy!
gaz_b3 at yahoo dot com
04-Apr-2003 01:11
The current CVS version, Ming 0.3a, supports
a lot of MX ActionScript including the MX Drawing API.
This is very nice for easy command line compiling of
MX ActionScript only movies.

For example:

<?
ming_setScale
(20.00000000);
ming_useswfversion(6);
$movie = new SWFMovie();
$movie->setDimension(550,400);
$movie->setBackground(0xcc, 0xcc, 0xcc );
$movie->setRate(31);

// mx actionscript
$strAction = "
_root.createEmptyMovieClip ( 'triangle', 1 );
with ( _root.triangle ) {
lineStyle( 5, 0xff00ff, 100 );
moveTo( 200, 200 );
lineTo( 300,300 );
lineTo( 100, 300 );
lineTo( 200, 200 );
}
"
;

$movie->add(new SWFAction( str_replace("\r", "", $strAction) ));
$movie->save("trianglemx.swf");
?>

Lots of examples here:

attila at linuks dot NOSPAM dot net
26-Dec-2001 05:42
You can get several .fdb font files from
kunnoichi at hotmail dot com
20-Aug-2001 07:50
//In quicktime, movies may be exported as jpeg or png
//This object will convert any movie that has been saved as a group of images into
//an swf file. The frame rate and other attributes can be controlled

$path = "my_movie_dir"; //relative path to the jpg/png or bmp files
$frame_rate=30; //frame rate of the flash movie
$quality=50; //image quality during conversion (only valid if not jpeg)
$skip_rate=5; //how many frames to skip
set_time_limit("600"); //this could take some time

$converter=new images_to_swf($path,$frame_rate,$skip_rate);

//$converter->convert_images(70); //Use this if using non jpeg files or decreasing the quality

$converter->make_movie();//Make the movie

//Do two things with it
$converter->save_movie("my_movie_dir/my_movie.swf");
$converter->output_movie();

class images_to_swf {
  
   var $path; //path to the image files
   var $skip_rate;
   var $movie;
   var $images=array();
  
   function images_to_swf($path,$frame_rate=30,$skip_rate=5) {
       $this->path=$path;
       $this->skip_rate=$skip_rate;
      
       $this->movie=new swfmovie ();
       $this->movie->setrate ($frame_rate);
   }
  
   function convert_images($quality=80,$delete_old_files=1) {
       $main = opendir($this->path);
       rewinddir($main);
       //first convert to jpeg (if we have to)
       //also change the quality
       while($filename = readdir($main)) {
          
           //only use valid file types
           if (ereg("(png|bmp|jpg|jpeg)\$",$filename)) {
               $file_path=$this->path."/".$filename;
              
               if (ereg("png\$",$filename)) $temp_img=imagecreatefrompng ($file_path);
               else if (ereg("bmp\$",$filename)) $temp_img=imagecreatefrompng ($file_path);
               else if (ereg("(jpg|jpeg)\$",$filename)) $temp_img=imagecreatefromjpeg ($file_path);
              
               if (ereg("(png|bmp)\$",$filename)) {
                   if ($delete_old_files) unlink($file_path);
                   $new_file_path=$file_path.".jpg";
               }
               else $new_file_path=$file_path;
              
               ImageJPEG($temp_img,$new_file_path,$quality);
              
               //echo "Converted $filename to $new_file_path at quality $quality<br />";
           }
       }
   }
  
   function make_movie() {
       $main = opendir($this->path);
       rewinddir($main);
       //Get all valid jpegs
       while($filename = readdir($main)) {
           if (ereg("(jpg|jpeg)\$",$filename)) {
               $file_path=$this->path."/".$filename;
               $valid_paths[]=$file_path;
           }
       }
      
       //Put jpegs in order
       sort($valid_paths);
      
       //then create the movie
       for ($a=0; $a<count($valid_paths); $a=$a+$this->skip_rate) {
           $fp = fopen($valid_paths[$a],"rb");
           $this->images[$a] = fread($fp,999999);
           fclose($fp);
           $this->movie->add(new swfbitmap($this->images[$a]));
           $this->movie->nextframe();
           //echo "Added ".$valid_paths[$a]." to the movie<br />\n";
       }
   }
  
   function save_movie($file_name) {
       $this->movie->save($file_name);
   }
  
   function output_movie() {
       header('Content-type: application/x-shockwave-flash');
       $this->movie->output();
   }
}
ivv_rousse at yahoo dot com
04-Aug-2001 01:17
// Simple button with link

<?php
  Ming_setScale
(1.0);

  function
makeRect($r, $g, $b){
  
$s = new SWFShape();
  
$s->setRightFill($s->addFill($r, $g, $b));
  
$s->movePenTo(-100,-20);
  
$s->drawLineTo(100,-20);
  
$s->drawLineTo(100,20);
  
$s->drawLineTo(-100,20);
  
$s->drawLineTo(-100,-20);
   return
$s;
  }

// Set Font
 
$font = new SWFFont("test.fdb");
 
$text1 = new SWFText();
 
$text1->setFont($font);
 
$text1->moveTo(155, 410);
 
$text1->setColor(0x00, 0x00, 0x00);
 
$text1->setHeight(28);
 
$text1->addString("php.net");
 
$b1 = new SWFButton();
 
$b1->setUp(makeRect(0xff, 0, 0));
 
$b1->setOver(makeRect(0xcc, 0, 0));
 
$b1->setDown(makeRect(0, 0, 0xaa));
 
$b1->setHit(makeRect(0, 0, 0));
 
$b1->addAction(new SWFAction("getURL(' 'phpsite');"),
              
SWFBUTTON_MOUSEUP);

 
$m = new SWFMovie();
 
$m->setDimension(1000,1000);
 
$m->setBackground(0xcc, 0xcc, 0xcc);

 
$i = $m->add($b1);
 
$m->add($text1);
 
$i->setName("phpsite");
 
$i->moveTo(200,400);

header("Content-type: application/x-shockwave-flash");
$m->output();
?>

<mssql_select_dbming_setcubicthreshold>
 Last updated: Thu, 15 Jul 2004
show source | credits | sitemap | contact | advertising | mirror sites 
Copyright © 2001-2004 The PHP Group
All rights reserved.
This unofficial mirror is operated at: /
Last updated: Sun Nov 14 23:09:54 2004 Local time zone must be set--see zic manual page