NAME

       swfcombine - a tool for combining swf (flash) files

Synopsis

       swfcombine  [-rXYomlcv]  [-f]  masterfile  [-xysf]  [(name1|#id1)=]slavefile1  ..  [-xysf]
       [(nameN|#idN)=]slavefileN

       swfcombine   [-rXYomv]   --stack[1]   [-xysf]   [(name1|#id1)=]slavefile1    ..    [-xysf]
       [(nameN|#idN)=]slavefileN

       swfcombine     [-rXYov]     --cat    [-xysf]    [(name1|#id1)=]slavefile1    ..    [-xysf]
       [(nameN|#idN)=]slavefileN

       swfcombine [-rXYomlcv] --dummy [-xys] [file]

DESCRIPTION

       Take two or more SWF files, and combine them into a new SWF. SWFs can  either  be  stacked
       (no masterfile is present) or inserted (into the masterfile).

       SWF  files  are  animation  files  which  can be displayed in Web Browsers using the Flash
       Plugin.

       For template mechanisms, it's often convenient to separate  the  processes  of  generating
       small  animation  fragments  and  merging them into a big movie. swfcombine can be used to
       perform the latter.

OPTIONS

       -o, --output outputfile
                  explicitly specify output file. (otherwise, output.swf will be used)

       -t, --stack
                  Don't assume the first file is a master file. Instead, store each
                  file in a separate frame.

       -T, --stack1
                  place each slave in the first frame (no master movie)

       -m, --merge
                  Do not store the slave files in a sprite/MovieClip. Instead,  merge  the  files
              frame by frame.

       -a, --cat
                  concatenate all slave files (no master movie)

       -l, --overlay
                  Don't remove any master objects, only overlay new objects

       -c, --clip
                  Clip the slave objects by the corresponding master objects

       -v, --verbose
                  Be verbose. Use more than one -v for greater effect

       -F, --flashversion
                  Set the flash version of the output file.

       -d, --dummy
                  Don't  require the presence of slave objects. Usually used together with -X, -Y
              or -r.

       -f, --frame
                  The next slave replaces a frame, not an object. Therefore the slave  identifier
              is a
                  frame number (#frame=) or frame label (framelabel=).

       -x, --movex xpos
                  x Adjust position of slave by xpos pixels

       -y, --movey ypos
                  y Adjust position of slave by ypos pixels

       -s, --scale scale
                  Adjust size of slave by scale percent (e.g. 100% = original size)

       -r, --rate fps
                  Force  the  output  to have the framerate fps. (Otherwise, the framerate of the
              master file will be used)

       -X, --width width
                  Force movie bbox width to width (default: use master width (not with -t))

       -Y, --height height
                  Force movie bbox height to height (default: use master height (not with -t))

       -N, --local-with-networking
                  Make output file "local-with-networking"

       -G, --hardware-gpu
                  Set the "use hardware gpu" bit in the output file

       -B, --accelerated-blit
                  Set the "use accelerated blit" bit in the output file

       -L, --local-with-filesystem
                  Make output file "local-with-filesystem"

       -z, --zlib zlib
                  Use Flash MX (SWF 6) Zlib encoding for the output. The resulting SWF will be
                  smaller, but not playable in Flash Plugins of Version 5 and below.

Combining two or more .swf files using a master file

       Of the flash files to be combined, all except one will be packed into a  sprite  structure
       (Movieclip)  which  will  then be inserted into the master .swf file.  This means that, in
       terms of trees, when combining several flash files, one will form the root  of  the  tree,
       while the others will be appended to the root as a subnode.  The user has to specify which
       of the files will become the root of the tree ("master") and which will  be  the  appended
       nodes  ("slaves").   The slave files must all have a name, which is then used to determine
       their exact position inside the master file.  The slave files will then be converted  into
       sprites,  inserted into the master file, and all PlaceObject tags in the master file which
       match the name of the slave file will be updated to correctly display  the  slave  sprite.
       The  slave name may also be the object id, preceded by '#', in which case the object to be
       replaced is referenced by id and not by instance name.

Combining (stacking) one or more .swf files without a master

       The flash files will be inserted in separate  frames.  They  will  still  be  packed  into
       Movieclips,  therefore  the  outputfile  will  have  exactly  as many frames as there were
       inputfiles. Also, the files don't  need  to  have  names.   If  you  want  to  access  the
       Movieclips,  their names are frameXX, where XX is the decimal number of the file, starting
       by zero (00).

EXAMPLES

       Create two flash movies. Insert some rectangle into one of them, and give it a name. (E.g.
       "foo") Now call

       swfcombine -o combined.swf master.swf foo=slave.swf

       As  a  result,  the  slave movie should be visible inside the master movie at the position
       where the rectangle used to be.

AUTHOR

       Matthias Kramm <kramm@quiss.org>