swfcombine(1) swftools swfcombine(1)NAMEswfcombine - a tool for combining swf (flash) files
Synopsisswfcombine [-rXYomlcv] [-f] masterfile [-xysf] [(name1|#id1)=]slave‐
file1 .. [-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 mas‐
terfile).
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 pro‐
cesses 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 seperate 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 mas‐
ter .swf file. This means that, in terms of trees, when combining sev‐
eral 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 seperate 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)
