swfcombine(1)							     swftools							     swfcombine(1)

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  posi-
       tion  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>

swfcombine							   February 2012						     swfcombine(1)