src/swfcombine.doc

   1 Usage: %s [-rXYomlcv] [-f] masterfile [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN
   2 OR:    %s [-rXYomv] --stack[1] [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN
   3 OR:    %s [-rXYov] --cat [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN
   4 OR:    %s [-rXYomlcv] --dummy [-xys] [file]
   5
   6 a tool for combining swf (flash) files
   7
   8 Take two or more SWF files, and combine them into a new SWF. SWFs can either
   9 be stacked (no masterfile is present) or inserted (into the masterfile).
  10 .PP
  11 SWF files are animation files which can be displayed in Web Browsers using
  12 the Flash Plugin.
  13 .LP
  14 For template mechanisms, it's often convenient to separate the processes
  15 of generating small animation fragments and merging them into a big
  16 movie. swfcombine can be used to perform the latter.
  17
  18 -o  --output  <outputfile>
  19     explicitly specify output file. (otherwise, output.swf will be used)
  20 -t  --stack
  21     place each slave in a seperate frame (no master movie)
  22     Don't assume the first file is a master file. Instead, store each
  23     file in a seperate frame.
  24 -T  --stack1
  25     place each slave in the first frame (no master movie)
  26 -m  --merge
  27     Don't store the slaves in Sprites/MovieClips
  28     Do not store the slave files in a sprite/MovieClip. Instead, merge the files frame by frame.
  29 -a  --cat
  30     concatenate all slave files (no master movie)
  31 -l  --overlay
  32     Don't remove any master objects, only overlay new objects
  33 -c  --clip
  34     Clip the slave objects by the corresponding master objects
  35 -v  --verbose
  36     Be verbose. Use more than one -v for greater effect
  37 -F  --flashversion
  38     Set the flash version of the output file.
  39 -d  --dummy
  40     Don't require slave objects (for changing movie attributes)
  41     Don't require the presence of slave objects. Usually used together with \fB\-X\fR, \fB\-Y\fR or \fB\-r\fR.
  42 -f  --frame
  43     The following identifier is a frame or framelabel, not an id or objectname
  44     The next slave replaces a frame, not an object. Therefore the slave identifier is a
  45     frame number (#frame=) or frame label (framelabel=).
  46 -x  --movex   <xpos>
  47     x Adjust position of slave by <xpos> pixels
  48 -y  --movey   <ypos>
  49     y Adjust position of slave by <ypos> pixels
  50 -s  --scale   <scale>
  51     Adjust size of slave by <scale> percent (e.g. 100% = original size)
  52 -r  --rate    <fps>
  53     Set movie framerate to <fps> (frames/sec)
  54     Force the output to have the framerate <fps>. (Otherwise, the framerate of the master file will be used)
  55 -X  --width   <width>
  56     Force movie bbox width to <width> (default: use master width (not with -t))
  57 -Y  --height  <height>
  58     Force movie bbox height to <height> (default: use master height (not with -t))
  59 -N  --local-with-networking
  60     Make output file "local-with-networking"
  61 -G  --hardware-gpu
  62     Set the "use hardware gpu" bit in the output file
  63 -B  --accelerated-blit
  64     Set the "use accelerated blit" bit in the output file
  65 -L  --local-with-filesystem
  66     Make output file "local-with-filesystem"
  67 -z  --zlib    <zlib>
  68     Enable Flash 6 (MX) Zlib Compression
  69     Use Flash MX (SWF 6) Zlib encoding for the output. The resulting SWF will be
  70     smaller, but not playable in Flash Plugins of Version 5 and below.
  71
  72 .PP
  73 .SH Combining two or more .swf files using a master file
  74 Of the flash files to be combined, all except one will be packed into a sprite
  75 structure (Movieclip) which will then be inserted into the master .swf file.
  76 This means that, in terms of trees, when combining several flash files,
  77 one will form the root of the tree, while the others will be
  78 appended to the root as a subnode.
  79 The user has to specify which of the files will become the root
  80 of the tree ("master") and which will be the appended nodes ("slaves").
  81 The slave files must all have a name, which is then used to determine
  82 their exact position inside the master file.
  83 The slave files will then be converted into sprites, inserted into the
  84 master file, and all PlaceObject tags in the master file which match the
  85 name of the slave file will be updated to correctly display the slave sprite.
  86 The slave name may also be the object id, preceded by '#', in which case
  87 the object to be replaced is referenced by id and not by instance name.
  88 .SH Combining (stacking) one or more .swf files without a master
  89 The flash files will be inserted in seperate frames. They will still be
  90 packed into Movieclips, therefore the outputfile will have exactly as many
  91 frames as there were inputfiles. Also, the files don't need to have names.
  92 If you want to access the Movieclips, their names are frameXX, where XX is
  93 the decimal number of the file, starting by zero (00).
  94
  95 .SH EXAMPLES
  96
  97 Create two flash movies. Insert some rectangle into one of them, and give
  98 it a name. (E.g. "foo") Now call
  99
 100 swfcombine -o combined.swf master.swf foo=slave.swf
 101
 102 As a result, the slave movie should be visible inside the master movie
 103 at the position where the rectangle used to be.
 104
 105 .SH AUTHOR
 106
 107 Matthias Kramm <kramm@quiss.org>