updated/corrected documentation
authorkramm <kramm>
Fri, 6 Feb 2004 16:28:15 +0000 (16:28 +0000)
committerkramm <kramm>
Fri, 6 Feb 2004 16:28:15 +0000 (16:28 +0000)
16 files changed:
src/font2swf.1
src/font2swf.c
src/jpeg2swf.1
src/jpeg2swf.c
src/png2swf.1
src/png2swf.c
src/swfbbox.1
src/swfbbox.c
src/swfc.1
src/swfc.c
src/swfcombine.1
src/swfcombine.c
src/swfdump.1
src/swfdump.c
src/wav2swf.1
src/wav2swf.c

index d761e5f..df7091f 100644 (file)
@@ -23,7 +23,8 @@ be viewable.
     Be verbose. Use more than one -v for greater effect.
 .TP
 \fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
-    Write output to file \fIfilename\fR.
+    Write output to file \fIfilename\fR. (If not given, the output will go
+    to a file called "output.swf")
 .TP
 \fB\-V\fR, \fB\-\-version\fR 
     Print version info and exit
index 6e355a7..be8134b 100644 (file)
@@ -31,14 +31,14 @@ static char * destfilename = "output.swf";
 static int all=0;
 static int verbose=0;
 
-static struct options_t options[] =
-{
- {"a","all"},
- {"o","output"},
- {"v","verbose"},
- {"V","version"},
- {0,0}
+static struct options_t options[] = {
+{"h", "help"},
+{"v", "verbose"},
+{"o", "output"},
+{"V", "version"},
+{0,0}
 };
+
 int args_callback_option(char*name,char*val)
 {
     if(!strcmp(name, "V")) {
@@ -67,18 +67,15 @@ int args_callback_longoption(char*name,char*val)
 {
     return args_long2shortoption(options, name, val);
 }
-void args_callback_usage(char*name)
-{    
+void args_callback_usage(char *name)
+{
     printf("\n");
-    printf("Usage: %s <font> [...]\n", name);
-    printf("   OR: %s --all\n", name);
+    printf("Usage: %s <fontfile>\n", name);
     printf("\n");
-    printf("Options:\n");
-    printf("\t-h , --help\t\t Print help and exit\n");
-    printf("\t-o , --output filename\t set output filename\n");
-    printf("\t-a , --all\t\tGenerate a set of standard fonts into the current directory\n");
-    printf("\t-v , --verbose\t\t Be more verbose\n");
-    printf("\t-V , --version\t\t Print program version and exit\n");
+    printf("-h , --help                    Print short help message and exit\n");
+    printf("-v , --verbose                 Be verbose. Use more than one -v for greater effect.\n");
+    printf("-o , --output <filename>       Write output to file <filename>.\n");
+    printf("-V , --version                 Print version info and exit\n");
     printf("\n");
 }
 int args_callback_command(char*name,char*val)
index cae2b42..59ff9cd 100644 (file)
@@ -1,43 +1,43 @@
-.TH jpeg2swf "1" "October 2001" "jpeg2swf" "swftools"
+.TH jpeg2swf "1" "February 2004" "jpeg2swf" "swftools"
 .SH NAME
-jpeg2swf - convert one or more pictures to swf
+jpeg2swf - Converts jpeg images to SWF.
+
 .SH Synopsis
-.B jpeg2swf
+.B jpeg2swf [-options [value]] imagefiles[.jpg]|[.jpeg] [...]
+
 .SH DESCRIPTION
-Takes a number of jpeg files and converts them to a swf movie, one
-picture per frame.
-.PP
-(SWF files are animation files which can be displayed in Web Browsers using
-the Flash Plugin)
+This tools converts jpeg image files into an SWF animation. It takes any
+number of input pictures, and converts them to SWF one-by-one, where every
+converted picture is a seperate frame in the target SWF.
+
 .SH OPTIONS
 .TP
-\fB\-h\fR, \fB\-\-help\fR
-Print short help message and exit
-.TP
-\fB\-V\fR, \fB\-\-version\fR
-Print version info and exit
+\fB\-o\fR, \fB\-\-output\fR \fIoutputfile\fR
+    Explicitly specify output file. (Otherwise, output will go to stdout / output.swf)
 .TP
-\fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
-Explicitly specify output file. (Otherwise, output will go to stdout / output.swf)
+\fB\-m\fR, \fB\-\-mx\fR 
+    Use Flash MX H.263 compression (use for correlated images)
 .TP
 \fB\-q\fR, \fB\-\-quality\fR \fIquality\fR
-Set JPEG compression quality (1-100)
+    Set compression quality (1-100, 1=worst, 100=best).
+    This option can be set independently for each image.
 .TP
-\fB\-r\fR, \fB\-\-framerate\fR \fIrate\fR
-Set movie framerate (100/sec)
+\fB\-r\fR, \fB\-\-rate\fR \fIframerate\fR     
+    Set movie framerate (frames per second)
 .TP
-\fB\-v\fR, \fB\-\-verbose\fR \fIlevel\fR
-Set verbosity level (0=quiet, 1=default, 2=debug)
+\fB\-X\fR, \fB\-\-width\fR \fIwidth\fR   
+    Force movie width to \fIwidth\fR (default: autodetect)
 .TP
-\fB\-X\fR, \fB\-\-width\fR \fIscale\fR
-Force movie width to \fIscale\fR (default: autodetect)
+\fB\-Y\fR, \fB\-\-height\fR \fIheight\fR  
+    Force movie height to \fIheight\fR (default: autodetect)
 .TP
-\fB\-Y\fR, \fB\-\-height\fR \fIscale\fR
-Force movie height to \fIscale\fR (default: autodetect)
-
+\fB\-v\fR, \fB\-\-verbose\fR \fIlevel\fR 
+    Set verbose level to \fIlevel\fR (0=quiet, 1=default, 2=debug)
+.TP
+\fB\-V\fR, \fB\-\-version\fR 
+    Print version information and exit
 .SH AUTHORS
 
 Rainer Böhme <rfxswf@reflex-studio.de>
 .TP
-Matthias Kramm <kramm@quiss.org>
-
+Matthias Kramm
index fad1152..aa01fbc 100644 (file)
@@ -394,15 +394,16 @@ int args_callback_option(char *arg, char *val)
     return res;
 }
 
-struct options_t options[] = { {"q", "quality"},
+static struct options_t options[] = {
 {"o", "output"},
 {"m", "mx"},
+{"q", "quality"},
 {"r", "rate"},
-{"v", "verbose"},
 {"X", "width"},
 {"Y", "height"},
+{"v", "verbose"},
 {"V", "version"},
-{0, 0},
+{0,0}
 };
 
 int args_callback_longoption(char *name, char *val)
@@ -433,29 +434,18 @@ int args_callback_command(char *arg, char *next)  // actually used as filename
 
 void args_callback_usage(char *name)
 {
-    printf
-       ("Usage: %s  [-options [value]] imagefiles[.jpg]|[.jpeg] [...]\n",
-        name);
-    printf
-       ("-o outputfile       --output   explicitly specify output file. (otherwise, output.swf will be used)\n");
-    printf
-       ("-m                  --mx       Use Flash MX H.263 compression (use for correlated images)\n");
-    printf
-       ("-q quality          --quality  Set compression quality (1-100, 1=worst, 100=best)\n");
-    printf
-       ("-r framerate        --rate     Set movie framerate (frames per second)\n");
-    printf
-       ("-o outputfile       --output   Set name for SWF output file\n");
-    printf
-       ("-X pixel            --width    Force movie width to pixel (default: autodetect)\n");
-    printf
-       ("-Y pixel            --height   Force movie height to pixel (default: autodetect)\n");
-    printf
-       ("-v level            --verbose  Set verbose level (0=quiet, 1=default, 2=debug)\n");
-    printf
-       ("-V                  --version  Print version information and exit\n");
-    printf
-       ("The following options can be set independently for each image: -q\n");
+    printf("\n");
+    printf("Usage: %s [-options [value]] imagefiles[.jpg]|[.jpeg] [...]\n", name);
+    printf("\n");
+    printf("-o , --output <outputfile>     Explicitly specify output file. (otherwise, output.swf will be used)\n");
+    printf("-m , --mx                      Use Flash MX H.263 compression (use for correlated images)\n");
+    printf("-q , --quality <quality>       Set compression quality (1-100, 1=worst, 100=best)\n");
+    printf("-r , --rate <framerate>         Set movie framerate (frames per second)\n");
+    printf("-X , --width <width>           Force movie width to <width> (default: autodetect)\n");
+    printf("-Y , --height <height>         Force movie height to <height> (default: autodetect)\n");
+    printf("-v , --verbose <level>         Set verbose level to <level> (0=quiet, 1=default, 2=debug)\n");
+    printf("-V , --version                 Print version information and exit\n");
+    printf("\n");
 }
 
 
index 9e3619f..c3ed59b 100644 (file)
@@ -1,37 +1,41 @@
-.TH png2swf "1" "January 2003" "png2swf" "swftools"
+.TH png2swf "1" "February 2004" "png2swf" "swftools"
 .SH NAME
-png2swf - convert one or more PNG pictures to swf
+png2swf - Takes a number of png files and converts them to a swf movie, one
+picture per frame.
+
 .SH Synopsis
 .B png2swf [-X width] [-Y height] [-o file.swf] [-r rate] file1.png [file2.png...]
+
 .SH DESCRIPTION
-Takes a number of png files and converts them to a swf movie, one
-picture per frame.
+This tools converts png image files into an SWF animation. It takes any
+number of input pictures, and converts them to SWF one-by-one, where every
+converted picture is a seperate frame in the target SWF. 
 .PP
-(SWF files are animation files which can be displayed in Web Browsers using
-the Flash Plugin)
+The way the
+images are encoded in SWF is very similar to PNG (in that a zlib-based, lossless
+compression algorithm is used). Under special circumstances, when the image
+is 32 bpp with alpha information, it is converted to (lossy) jpeg compression
+though, to preserve the alpha, which can't be encoded in any other way in the SWF.
+
 .SH OPTIONS
 .TP
-\fB\-h\fR, \fB\-\-help\fR
-Print short help message and exit
+\fB\-r\fR, \fB\-\-rate\fR \fIframerate\fR
+    Set movie framerate (frames per second)
 .TP
-\fB\-V\fR, \fB\-\-version\fR
-Print version info and exit
+\fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
+    Explicitly specify output file. (Otherwise, output will go to stdout / output.swf)
 .TP
-\fB\-X\fR, \fB\-\-width\fR \fIscale\fR
-Force movie width to \fIscale\fR (default: autodetect)
+\fB\-X\fR, \fB\-\-pixel\fR \fIwidth\fR
+    Force movie width to \fIwidth\fR (default: autodetect)
 .TP
-\fB\-Y\fR, \fB\-\-height\fR \fIscale\fR
-Force movie height to \fIscale\fR (default: autodetect)
+\fB\-Y\fR, \fB\-\-pixel\fR \fIheight\fR
+    Force movie height to \fIheight\fR (default: autodetect)
 .TP
-\fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
-Explicitly specify output file. (Otherwise, output will go to stdout / output.swf)
+\fB\-v\fR, \fB\-\-verbose\fR \fIlevel\fR
+    Set verbose level (0=quiet, 1=default, 2=debug)
 .TP
-\fB\-r\fR, \fB\-\-framerate\fR \fIrate\fR
-Set movie framerate (frames per second).
-
-.SH AUTHORS
-
-Matthias Kramm <kramm@quiss.org>
+\fB\-C\fR, \fB\-\-cgi\fR 
+    For use as CGI- prepend http header, write to stdout
 .TP
-Rainer Böhme <rfxswf@reflex-studio.de>
-
+\fB\-V\fR, \fB\-\-version\fR 
+    Print version information and exit
index 2f0c606..cc70c61 100644 (file)
@@ -837,15 +837,13 @@ int args_callback_option(char *arg, char *val)
     return res;
 }
 
-struct options_t options[] = 
-{ 
-{"h", "help"},
-{"o", "output"},
+static struct options_t options[] = {
 {"r", "rate"},
-{"C", "cgi"},
+{"o", "output"},
+{"X", "pixel"},
+{"Y", "pixel"},
 {"v", "verbose"},
-{"X", "width"},
-{"Y", "height"},
+{"C", "cgi"},
 {"V", "version"},
 {0,0}
 };
@@ -876,14 +874,17 @@ int args_callback_command(char *arg, char *next)  // actually used as filename
 
 void args_callback_usage(char *name)
 {
-    printf("Usage: %s  [-options [value]] imagefiles[.png] [...]\n", name);
-    printf("\t-r , --rate <framerate>\t\t\tSet movie framerate (frames per second)\n");
-    printf("\t-o , --output <filename>\t\t\tSet name for SWF output file\n");
-    printf("\t-X , --pixel <width>\t\t\tForce movie width to pixel (default: autodetect)\n");
-    printf("\t-Y , --pixel <height>\t\t\tForce movie height to pixel (default: autodetect)\n");
-    printf("\t-v , --verbose <level>\t\t\t Set verbose level (0=quiet, 1=default, 2=debug)\n");
-    printf("\t-C , --cgi\t\t\t For use as CGI- prepend http header, write to stdout\n");
-    printf("\t-V , --version\t\t\tPrint version information and exit\n");
+    printf("\n");
+    printf("Usage: %s [-X width] [-Y height] [-o file.swf] [-r rate] file1.png [file2.png...]\n", name);
+    printf("\n");
+    printf("-r , --rate <framerate>        Set movie framerate (frames per second)\n");
+    printf("-o , --output <filename>       Set name for SWF output file.\n");
+    printf("-X , --pixel <width>           Force movie width to <width> (default: autodetect)\n");
+    printf("-Y , --pixel <height>          Force movie height to <height> (default: autodetect)\n");
+    printf("-v , --verbose <level>         Set verbose level (0=quiet, 1=default, 2=debug)\n");
+    printf("-C , --cgi                     For use as CGI- prepend http header, write to stdout\n");
+    printf("-V , --version                 Print version information and exit\n");
+    printf("\n");
 }
 
 int main(int argc, char **argv)
index e69de29..b752aab 100644 (file)
@@ -0,0 +1,32 @@
+.TH swfbbox "1" "February 2004" "swfbbox" "swftools"
+.SH NAME
+swfbbox - Tool for playing around with SWF bounding boxes.
+
+.SH Synopsis
+.B swfbbox [-OS] file.swf
+
+.SH DESCRIPTION
+This tool can, among others, recalculate some bounding boxes of SWFs
+in order to speed them up or make them smaller.
+.PP
+It can also dump the corners of the bounding boxes of all frames of a movie.
+
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR 
+    Print help and exit
+.TP
+\fB\-O\fR, \fB\-\-optimize\fR 
+    Recalculate bounding boxes
+.TP
+\fB\-S\fR, \fB\-\-swifty\fR 
+    Print out transformed bounding boxes
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
+    Set output filename to \fIfilename\fR (for -O)
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR 
+    Be more verbose
+.TP
+\fB\-V\fR, \fB\-\-version\fR 
+    Print program version and exit
index de0d96c..5fb1dba 100644 (file)
@@ -35,14 +35,14 @@ static int optimize = 0;
 static int swifty = 0;
 static int verbose = 0;
 
-struct options_t options[] =
-{
- {"V","version"},
- {"O","optimize"},
- {"o","output"},
- {"S","swifty"},
- {"v","verbose"},
- {0,0}
+static struct options_t options[] = {
+{"h", "help"},
+{"O", "optimize"},
+{"S", "swifty"},
+{"o", "output"},
+{"v", "verbose"},
+{"V", "version"},
+{0,0}
 };
 
 int args_callback_option(char*name,char*val)
@@ -78,15 +78,18 @@ int args_callback_longoption(char*name,char*val)
 {
     return args_long2shortoption(options, name, val);
 }
-void args_callback_usage(char*name)
-{    
+void args_callback_usage(char *name)
+{
+    printf("\n");
     printf("Usage: %s [-OS] file.swf\n", name);
-    printf("\t-h , --help\t\t Print help and exit\n");
-    printf("\t-O , --optimize\t\t Recalculate bounding boxes\n");
-    printf("\t-S , --swifty\t\t Print out transformed bounding boxes\n");
-    printf("\t-o , --output\t\t Set output filename (for -O)\n");
-    printf("\t-v , --verbose\t\t Be more verbose\n");
-    printf("\t-V , --version\t\t Print program version and exit\n");
+    printf("\n");
+    printf("-h , --help                    Print help and exit\n");
+    printf("-O , --optimize                Recalculate bounding boxes\n");
+    printf("-S , --swifty                  Print out transformed bounding boxes\n");
+    printf("-o , --output <filename>       Set output filename to <filename> (for -O)\n");
+    printf("-v , --verbose                 Be more verbose\n");
+    printf("-V , --version                 Print program version and exit\n");
+    printf("\n");
 }
 int args_callback_command(char*name,char*val)
 {
index b40f2d3..42113a1 100644 (file)
@@ -1,28 +1,25 @@
-.TH swfc "1" "January 2003" "swfc" "swftools"
+.TH swfc "1" "February 2004" "swfc" "swftools"
 .SH NAME
 swfc - compile .sc files to swf.
+
 .SH Synopsis
 .B swfc [-o file.swf] file.sc
+
 .SH DESCRIPTION
 Compiles a file written in sc (SWF Script) into a number of SWF files.
-.PP
-(SWF files are animation files which can be displayed in Web Browsers using
-the Flash Plugin)
+
 .SH OPTIONS
 .TP
-\fB\-h\fR, \fB\-\-help\fR
-Print short help message and exit
+\fB\-h\fR, \fB\-\-help\fR 
+    Print short help message and exit
 .TP
-\fB\-V\fR, \fB\-\-version\fR
-Print version info and exit
+\fB\-V\fR, \fB\-\-version\fR 
+    Print version info and exit
 .TP
-\fB\-v\fR, \fB\-\-verbose\fR
-Increase verbosity.
+\fB\-v\fR, \fB\-\-verbose\fR 
+    Increase verbosity. Use more than one \fB-v\fR for greater effect.
 .TP
 \fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
-Specify output file (Default: output.swf). (Affects only the parts of the .sc file which haven't
-specified an output file)
-
-.SH AUTHORS
-
-Matthias Kramm <kramm@quiss.org>
+    Specify output file (Default: output.swf). 
+    This affects only the parts of the .sc file which haven't
+    specified an output file themselves. 
index 49897ef..7a5f7c4 100644 (file)
@@ -42,12 +42,12 @@ static char * outputname = "output.swf";
 static int verbose = 2;
 static int override_outputname = 0;
 
-static struct options_t options[] =
-{
- {"o","output"},
- {"v","verbose"},
- {"V","version"},
- {0,0}
+static struct options_t options[] = {
+{"h", "help"},
+{"V", "version"},
+{"v", "verbose"},
+{"o", "output"},
+{0,0}
 };
     
 int args_callback_option(char*name,char*val)
@@ -75,12 +75,16 @@ int args_callback_longoption(char*name,char*val)
 {
     return args_long2shortoption(options, name, val);
 }
-void args_callback_usage(char*name)
+void args_callback_usage(char *name)
 {
-    printf("Usage: %s [-o filename] file.sc\n", name);
-    printf("\t-v , --verbose\t\t\t Be more verbose\n");
-    printf("\t-o , --output filename\t\t set output filename (default: output.swf)\n");
-    printf("\t-V , --version\t\t\t Print program version and exit\n");
+    printf("\n");
+    printf("Usage: %s [-o file.swf] file.sc\n", name);
+    printf("\n");
+    printf("-h , --help                    Print short help message and exit\n");
+    printf("-V , --version                 Print version info and exit\n");
+    printf("-v , --verbose                 Increase verbosity. \n");
+    printf("-o , --output <filename>       Set output file to <filename>.\n");
+    printf("\n");
 }
 int args_callback_command(char*name,char*val)
 {
@@ -2360,6 +2364,7 @@ int main (int argc,char ** argv)
        args_callback_usage(argv[0]);
        exit(1);
     }
+    
     file = generateTokens(filename);
     if(!file) {
        printf("parser returned error.\n");
index b8d8ba1..0bc912a 100644 (file)
@@ -1,21 +1,16 @@
-.TH swfcombine "1" "January 2003" "swfcombine" "swftools"
+.TH swfcombine "1" "February 2004" "swfcombine" "swftools"
 .SH NAME
 swfcombine - a tool for combining swf (flash) files
-.SH Synopsis
-.B swfcombine
-[\fIoptions\fR] [\fImasterfile.swf\fR] [\fIslavename1=\fR][\fIslavefile1.swf\fR] ... [\fIslavenameN=\fR][\fIslavefileN.swf\fR]
-
-.B swfcombine
-[\fIoptions\fR] [\fImasterfile.swf\fR] [\fI#id1=\fR][\fIslavefile1.swf\fR] ... [\fI#idN=\fR][\fIslavefileN.swf\fR]
-
-.B swfcombine
-[\fIoptions\fR] --stack [\fIslavename1=\fR][\fIslavefile1.swf\fR] ... [\fIslavenameN=\fR][\fIslavefileN.swf\fR]
 
-.B swfcombine
-[\fIoptions\fR] --cat [\fIslavename1=\fR][\fIslavefile1.swf\fR] ... [\fIslavenameN=\fR][\fIslavefileN.swf\fR]
+.SH Synopsis
+.B swfcombine [-rXYomlcv] [-f] masterfile [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN
+.PP
+.B swfcombine [-rXYomv] --stack[1] [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN
+.PP
+.B swfcombine [-rXYov] --cat [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN
+.PP
+.B swfcombine [-rXYomlcv] --dummy [-xys] [file]
 
-.B swfcombine
-[\fIoptions\fR] --dummy [\fIfile.swf\fR]
 .SH 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).
@@ -26,64 +21,62 @@ 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.
+
 .SH OPTIONS
 .TP
-\fB\-h\fR, \fB\-\-help\fR
-Print short help message and exit
-.TP
-\fB\-V\fR, \fB\-\-version\fR
-Print version info and exit
+\fB\-o\fR, \fB\-\-output\fR \fIoutputfile\fR  
+    explicitly specify output file. (otherwise, output.swf will be used)
 .TP
-\fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
-Explicitly specify output file. (otherwise, output.swf will be used)
+\fB\-t\fR, \fB\-\-stack\fR 
+    Don't assume the first file is a master file. Instead, store each
+    file in a seperate frame.
 .TP
-\fB\-z\fR, \fB\-\-zlib\fR
-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.
+\fB\-T\fR, \fB\-\-stack1\fR 
+    place each slave in the first frame (no master movie)
 .TP
-\fB\-l\fR, \fB\-\-overlay\fR
-Don't remove any master objects, only overlay new objects.
+\fB\-m\fR, \fB\-\-merge\fR 
+    Do not store the slave files in a sprite/MovieClip. Instead, merge the files frame by frame.
 .TP
-\fB\-c\fR, \fB\-\-clip\fR
-Clip the slave objects by the corresponding master objects.
+\fB\-a\fR, \fB\-\-cat\fR 
+    concatenate all slave files (no master movie)
 .TP
-\fB\-m\fR, \fB\-\-merge\fR
-Do not store the slave files in a sprite/MovieClip. Instead, merge the files frame by frame.
+\fB\-l\fR, \fB\-\-overlay\fR 
+    Don't remove any master objects, only overlay new objects
 .TP
-\fB\-d\fR, \fB\-\-dummy\fR
-Don't require the presence of slave objects. Usually used together with \fB\-X\fR, \fB\-Y\fR or \fB\-r\fR.
+\fB\-c\fR, \fB\-\-clip\fR 
+    Clip the slave objects by the corresponding master objects
 .TP
-\fB\-v\fR, \fB\-\-verbose\fR
-Be verbose. Use more than one -v for greater effect.
+\fB\-v\fR, \fB\-\-verbose\fR 
+    Be verbose. Use more than one -v for greater effect 
 .TP
-\fB\-t\fR, \fB\-\-stack\fR
-Don't assume the first file is a master file. Instead, store each
-file in a seperate frame.
+\fB\-d\fR, \fB\-\-dummy\fR 
+    Don't require the presence of slave objects. Usually used together with \fB\-X\fR, \fB\-Y\fR or \fB\-r\fR.
 .TP
-\fB\-a\fR, \fB\-\-cat\fR
-Like -t, but concatenate the files.
+\fB\-f\fR, \fB\-\-frame\fR 
+    The next slave replaces a frame, not an object. Therefore the slave identifier is a
+    frame number (#frame=) or frame label (framelabel=).
 .TP
-\fB\-X\fR, \fB\-\-width\fR \fIwidth\fR
-Force the output to width \fIwidth\fR. (Otherwise, the width of the master file will be used)
+\fB\-x\fR, \fB\-\-movex\fR \fIxpos\fR        
+    x Adjust position of slave by \fIxpos\fR pixels
 .TP
-\fB\-Y\fR, \fB\-\-height\fR \fIheight\fR
-Force the output to height \fIheight\fR. (Otherwise, the height of the master file will be used)
+\fB\-y\fR, \fB\-\-movey\fR \fIypos\fR        
+    y Adjust position of slave by \fIypos\fR pixels
 .TP
-\fB\-r\fR, \fB\-\-rate\fR \fIrate\fR
-Force the output to have the framerate \fIrate\fR. (Otherwise, the framerate of the master file will be used)
+\fB\-s\fR, \fB\-\-scale\fR \fIscale\fR       
+    Adjust size of slave by \fIscale\fR percent (e.g. 100%% = original size)
 .TP
-\fB\-f\fR, \fB\-\-frame\fR
-The next slave replaces a frame, not an object. Therefore the slave identifier is a
-frame number (#frame=) or frame label (framelabel=).
+\fB\-r\fR, \fB\-\-rate\fR \fIfps\fR   
+    Force the output to have the framerate \fIfps\fR. (Otherwise, the framerate of the master file will be used)
 .TP
-\fB\-x\fR, \fB\-\-xpos\fR \fIxpos\fR
-(move x) Adjust position of slave by xpos twips (1/20 pixel).
+\fB\-X\fR, \fB\-\-width\fR \fIwidth\fR       
+    Force movie bbox width to \fIwidth\fR (default: use master width (not with -t))
 .TP
-\fB\-y\fR, \fB\-\-ypos\fR \fIypos\fR
-(move y) Adjust position of slave by ypos twips (1/20 pixel).
+\fB\-Y\fR, \fB\-\-height\fR \fIheight\fR      
+    Force movie bbox height to \fIheight\fR (default: use master height (not with -t))
 .TP
-\fB\-s\fR, \fB\-\-scale\fR \fIscale\fR
-(scale) Adjust size of slave by scale%
+\fB\-z\fR, \fB\-\-zlib\fR \fIzlib\fR        
+    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.
 .PP
 .SH 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
@@ -117,7 +110,3 @@ 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.
 
-.SH AUTHOR
-
-Matthias Kramm <kramm@quiss.org>
-
index 7c675af..e595d26 100644 (file)
@@ -185,26 +185,25 @@ int args_callback_option(char*name,char*val) {
     }
 }
 
-struct options_t options[] =
-{{"o","output"},
- {"s","scale"},
- {"d","dummy"},
- {"x","xpos"},
- {"y","ypos"},
- {"X","width"},
- {"Y","height"},
- {"r","rate"},
- {"f","frame"},
- {"l","overlay"},
- {"m","merge"},
- {"t","stack"},
- {"T","stack1"},
- {"v","verbose"},
- {"V","version"},
- {"c","clip"},
- {"a","cat"},
- {"z","zlib"},
- {0,0}
+static struct options_t options[] = {
+{"o", "output"},
+{"t", "stack"},
+{"T", "stack1"},
+{"m", "merge"},
+{"a", "cat"},
+{"l", "overlay"},
+{"c", "clip"},
+{"v", "verbose"},
+{"d", "dummy"},
+{"f", "frame"},
+{"x", "movex"},
+{"y", "movey"},
+{"s", "scale"},
+{"r", "rate"},
+{"X", "width"},
+{"Y", "height"},
+{"z", "zlib"},
+{0,0}
 };
 
 int args_callback_longoption(char*name,char*val) {
@@ -256,30 +255,32 @@ int args_callback_command(char*name, char*val) {
     return 0;
 }
 
-void args_callback_usage(char*name)
+void args_callback_usage(char *name)
 {
+    printf("\n");
     printf("Usage: %s [-rXYomlcv] [-f] masterfile [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN\n", name);
     printf("OR:    %s [-rXYomv] --stack[1] [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN\n", name);
     printf("OR:    %s [-rXYov] --cat [-xysf] [(name1|#id1)=]slavefile1 .. [-xysf] [(nameN|#idN)=]slavefileN\n", name);
     printf("OR:    %s [-rXYomlcv] --dummy [-xys] [file]\n", name);
     printf("\n");
-    printf("-o outputfile       --output    explicitly specify output file. (otherwise, output.swf will be used)\n");
-    printf("-t                  --stack     place each slave in a seperate frame (no master movie)\n");
-    printf("-T                  --stack1    place each slave in the first frame (no master movie)\n");
-    printf("-m                  --merge     Don't store the slaves in Sprites/MovieClips\n");
-    printf("-a                  --cat       concatenate all slave files (no master movie)\n");
-    printf("-l                  --overlay   Don't remove any master objects, only overlay new objects\n");
-    printf("-c                  --clip      Clip the slave objects by the corresponding master objects\n");
-    printf("-v                  --verbose   Be verbose. Use more than one -v for greater effect \n");
-    printf("-d                  --dummy     Don't require slave objects (for changing movie attributes)\n");
-    printf("-f                  --frame     The following identifier is a frame or framelabel, not an id or objectname\n");
-    printf("-x xpos             --movex     x Adjust position of slave by xpos pixels\n");
-    printf("-y ypos             --movey     y Adjust position of slave by ypos pixels\n");
-    printf("-s scale            --scale     Adjust size of slave by scale% (e.g. 100%% = original size)\n");
-    printf("-r framerate        --rate      Set movie framerate (frames/sec)\n");
-    printf("-X width            --width     Force movie bbox width to scale (default: use master width (not with -t))\n");
-    printf("-Y height           --height    Force movie bbox height to scale (default: use master height (not with -t))\n");
-    printf("-z zlib             --zlib      Enable Flash 6 (MX) Zlib Compression\n");
+    printf("-o , --output <outputfile>      explicitly specify output file. (otherwise, output.swf will be used)\n");
+    printf("-t , --stack                   place each slave in a seperate frame (no master movie)\n");
+    printf("-T , --stack1                  place each slave in the first frame (no master movie)\n");
+    printf("-m , --merge                   Don't store the slaves in Sprites/MovieClips\n");
+    printf("-a , --cat                     concatenate all slave files (no master movie)\n");
+    printf("-l , --overlay                 Don't remove any master objects, only overlay new objects\n");
+    printf("-c , --clip                    Clip the slave objects by the corresponding master objects\n");
+    printf("-v , --verbose                 Be verbose. Use more than one -v for greater effect \n");
+    printf("-d , --dummy                   Don't require slave objects (for changing movie attributes)\n");
+    printf("-f , --frame                   The following identifier is a frame or framelabel, not an id or objectname\n");
+    printf("-x , --movex <xpos>            x Adjust position of slave by <xpos> pixels\n");
+    printf("-y , --movey <ypos>            y Adjust position of slave by <ypos> pixels\n");
+    printf("-s , --scale <scale>           Adjust size of slave by <scale> percent (e.g. 100% = original size)\n");
+    printf("-r , --rate <fps>              Set movie framerate to <fps> (frames/sec)\n");
+    printf("-X , --width <width>           Force movie bbox width to <width> (default: use master width (not with -t))\n");
+    printf("-Y , --height <height>          Force movie bbox height to <height> (default: use master height (not with -t))\n");
+    printf("-z , --zlib <zlib>             Enable Flash 6 (MX) Zlib Compression\n");
+    printf("\n");
 }
 
 static void makestackmaster(SWF*swf)
index 0a78baa..3f495e3 100644 (file)
@@ -1,56 +1,54 @@
-.TH swfdump "1" "January 2003" "swfdump" "swftools"
+.TH swfdump "1" "February 2004" "swfdump" "swftools"
 .SH NAME
-swfdump - a tool for displaying information about flash files
+swfdump - Display an SWF file's content.
+
 .SH Synopsis
-.B swfdump
-[\fIoptions\fR] [\fIfile.swf\fR]
+.B swfdump [-atpdu] file.swf
+
 .SH DESCRIPTION
-swfdump shows ids, names and depths of objects defined in the SWF file.
+A tool for displaying information about flash files
 .PP
-SWF files are animation files which can be displayed in Web Browsers using
-the Flash Plugin.
+swfdump shows ids, names and depths of objects defined in the SWF file.
+It can furthermore also disassemble Actionscript, extract texts, and
+display placement information about objects.
+
 .SH OPTIONS
 .TP
-\fB\-h\fR, \fB\-\-help\fR
-Print short help message and exit
+\fB\-h\fR, \fB\-\-help\fR 
+    Print short help message and exit
 .TP
-\fB\-D\fR, \fB\-\-full\fR
-Show everything. Same as -atp
+\fB\-D\fR, \fB\-\-full\fR 
+    Show everything. Same as -atp
 .TP
-\fB\-V\fR, \fB\-\-version\fR
-Print version info and exit
+\fB\-V\fR, \fB\-\-version\fR 
+    Print version info and exit
 .TP
-\fB\-e\fR, \fB\-\-html\fR
-Print out html code for embedding the file
+\fB\-e\fR, \fB\-\-html\fR 
+    Print out html code for embedding the file
 .TP
-\fB\-a\fR, \fB\-\-action\fR
-Disassemble action tags
+\fB\-a\fR, \fB\-\-action\fR 
+    Disassemble action tags
 .TP
-\fB\-t\fR, \fB\-\-text\fR
-Show text fields
+\fB\-t\fR, \fB\-\-text\fR 
+    Show text fields (like swfstrings).
 .TP
-\fB\-p\fR, \fB\-\-placements\fR
-Show placement information
+\fB\-p\fR, \fB\-\-placements\fR 
+    Show placement information
 .TP
-\fB\-X\fR, \fB\-\-width\fR
-Print out the horizontal dimension of the movie, in a string of the form "-X width"
+\fB\-X\fR, \fB\-\-width\fR 
+    Print out the horizontal dimension of the movie, in a string of the form "-X width"
 .TP
-\fB\-Y\fR, \fB\-\-height\fR
-Print out the vertical dimension of the movie, in a string of the form "-Y height"
+\fB\-Y\fR, \fB\-\-height\fR 
+    Print out the vertical dimension of the movie, in a string of the form "-Y height"
 .TP
-\fB\-r\fR, \fB\-\-rate\fR
-Print out the frame rate of the movie, in a string of the form "-r rate"
+\fB\-r\fR, \fB\-\-rate\fR 
+    Print out the frame rate of the movie, in a string of the form "-r rate".
 .TP
-\fB\-f\fR, \fB\-\-frames\fR
-Print out the number of frames in the movie, in a string of the form "-f frames"
+\fB\-f\fR, \fB\-\-frames\fR 
+    Print out the number of frames in the movie, in a string of the form "-f frames"
 .TP
-\fB\-d\fR, \fB\-\-hex\fR
-Print hex output of tag data, too.
+\fB\-d\fR, \fB\-\-hex\fR 
+    Print hex output of tag data, too.
 .TP
-\fB\-u\fR, \fB\-\-used\fR
-Show referred IDs for each Tag.
-
-.SH AUTHOR
-
-Matthias Kramm <kramm@quiss.org>
-
+\fB\-u\fR, \fB\-\-used\fR 
+    Show referred IDs for each Tag.
index 9b58e2d..05b2865 100644 (file)
@@ -56,24 +56,23 @@ static int showtext = 0;
 static int hex = 0;
 static int used = 0;
 
-struct options_t options[] =
-{
- {"D","full"},
- {"a","action"},
- {"t","text"},
- {"X","width"},
- {"Y","height"},
- {"f","frames"},
- {"r","rate"},
- {"e","html"},
- {"p","placements"},
- {"u","used"},
- {"V","version"},
- {"d","hex"},
- {0,0}
+static struct options_t options[] = {
+{"h", "help"},
+{"D", "full"},
+{"V", "version"},
+{"e", "html"},
+{"a", "action"},
+{"t", "text"},
+{"p", "placements"},
+{"X", "width"},
+{"Y", "height"},
+{"r", "rate"},
+{"f", "frames"},
+{"d", "hex"},
+{"u", "used"},
+{0,0}
 };
 
-
 int args_callback_option(char*name,char*val)
 {
     if(!strcmp(name, "V")) {
@@ -135,22 +134,25 @@ int args_callback_longoption(char*name,char*val)
 {
     return args_long2shortoption(options, name, val);
 }
-void args_callback_usage(char*name)
-{    
-    printf("Usage: %s [-at] file.swf\n", name);
-    printf("\t-h , --help\t\t Print help and exit\n");
-    printf("\t-D , --full\t\t Show everything. The same as -atMp\n");
-    printf("\t-e , --html\t\t Create html output embedding the file (simple, but useful)\n");
-    printf("\t-X , --width\t\t Prints out a string of the form \"-X width\"\n");
-    printf("\t-Y , --height\t\t Prints out a string of the form \"-Y height\"\n");
-    printf("\t-r , --rate\t\t Prints out a string of the form \"-r rate\"\n");
-    printf("\t-f , --frames\t\t Prints out a string of the form \"-f framenum\"\n");
-    printf("\t-a , --action\t\t Disassemble action tags\n");
-    printf("\t-p , --placements\t Show extra placement information\n");
-    printf("\t-t , --text\t\t Show text data\n");
-    printf("\t-d , --hex\t\t Print hex output of tag data, too\n");
-    printf("\t-u , --used\t\t Show referred IDs for each Tag\n");
-    printf("\t-V , --version\t\t Print program version and exit\n");
+void args_callback_usage(char *name)
+{
+    printf("\n");
+    printf("Usage: %s [-atpdu] file.swf\n", name);
+    printf("\n");
+    printf("-h , --help                    Print short help message and exit\n");
+    printf("-D , --full                    Show everything. Same as -atp\n");
+    printf("-V , --version                 Print version info and exit\n");
+    printf("-e , --html                    Print out html code for embedding the file\n");
+    printf("-a , --action                  Disassemble action tags\n");
+    printf("-t , --text                    Show text fields (like swfstrings).\n");
+    printf("-p , --placements              Show placement information\n");
+    printf("-X , --width                   Prints out a string of the form \"-X width\".\n");
+    printf("-Y , --height                  Prints out a string of the form \"-Y height\".\n");
+    printf("-r , --rate                    Prints out a string of the form \"-r rate\".\n");
+    printf("-f , --frames                  Prints out a string of the form \"-f framenum\".\n");
+    printf("-d , --hex                     Print hex output of tag data, too.\n");
+    printf("-u , --used                    Show referred IDs for each Tag.\n");
+    printf("\n");
 }
 int args_callback_command(char*name,char*val)
 {
index 13edbe6..69c7821 100644 (file)
@@ -1,39 +1,50 @@
-.TH wav2swf "1" "January 2003" "wav2swf" "swftools"
+.TH wav2swf "1" "February 2004" "wav2swf" "swftools"
 .SH NAME
-wav2swf - convert a WAV file to an SWF animation
+wav2swf - convert a WAV file to an SWF animation.
+
 .SH Synopsis
-.B wav2swf [-o file.swf] filename.wav
+.B wav2swf [-o filename] file.wav\n
+
 .SH DESCRIPTION
 Takes a wav file and converts it to a swf movie.
-.PP
-(SWF files are animation files which can be displayed in Web Browsers using
-the Flash Plugin)
+
 .SH OPTIONS
 .TP
-\fB\-h\fR, \fB\-\-help\fR
-Print short help message and exit
+\fB\-h\fR, \fB\-\-help\fR 
+    Print short help message and exit
 .TP
-\fB\-V\fR, \fB\-\-version\fR
-Print version info and exit
+\fB\-V\fR, \fB\-\-version\fR 
+    Print version info and exit
 .TP
 \fB\-o\fR, \fB\-\-output\fR \fIfilename\fR
-Explicitly specify output file. (Otherwise, output will go to output.swf)
+    Explicitly specify output file. (Otherwise, output will go to output.swf)
 .TP
 \fB\-r\fR, \fB\-\-framerate\fR \fIfps\fR
-Set file framerate to \fIfps\fR frames per second.
+    Set file framerate to \fIfps\fR frames per second.
 .TP
-\fB\-b\fR, \fB\-\-bitrate\fR \fIbps\fR
-Set mp3 bitrate to \fIbps\fR.
+\fB\-s\fR, \fB\-\-samplerate\fR \fIsps\fR
+    Set samplerate to \fIsps\fR frames per second (default: 11025).
 .TP
-\fB\-l\fR, \fB\-\-loop\fR \fIn\fR
-(Only used with -d)
-Loop the sound n times.
+\fB\-b\fR, \fB\-\-bitrate\fR bps
+    Set mp3 bitrate to \fIbps\fR.
 .TP
-\fB\-d\fR, \fB\-\-definesound\fR
-Store the sound as DEFINESOUND tag, not as streaming sound. Allows for
-looping.
-
-.SH AUTHORS
-
-Matthias Kramm <kramm@quiss.org>
-
+\fB\-d\fR, \fB\-\-definesound\fR 
+    Store the sound as DEFINESOUND tag, not as streaming sound. Allows for
+    looping.
+.TP
+\fB\-l\fR, \fB\-\-loop\fR n
+    Loop the sound n times.
+.TP
+\fB\-C\fR, \fB\-\-cgi\fR 
+    For use as CGI- prepend http header, write to stdout.
+.TP
+\fB\-S\fR, \fB\-\-stop\fR 
+    Stop the movie at frame 0, and start the sound at 1, so that the
+    sound will not play until a "GotoFrame(1)" is issued.
+    (For use with flashsound.js).
+.TP
+\fB\-b\fR, \fB\-\-bitrate\fR \fIbps\fR
+    Set mp3 bitrate to \fIbps\fR (default: 32)
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR 
+    Be more verbose. (Use more than one -v for greater effect)
index 6bc59cd..dddf766 100644 (file)
@@ -33,19 +33,20 @@ int stopframe0 = 0;
 
 #define DEFINESOUND_MP3 1 //define sound uses mp3?- undefine for raw sound.
 
-struct options_t options[] =
-{
- {"o","output"},
- {"v","verbose"},
- {"d","definesound"},
- {"l","loop"},
- {"r","framerate"},
- {"s","samplerate"},
- {"b","bitrate"},
- {"C","cgi"},
- {"V","version"},
- {"S","stop"},
- {0,0}
+static struct options_t options[] = {
+{"h", "help"},
+{"V", "version"},
+{"o", "output"},
+{"r", "framerate"},
+{"s", "samplerate"},
+{"b", "bitrate"},
+{"d", "definesound"},
+{"l", "loop"},
+{"C", "cgi"},
+{"S", "stop"},
+{"b", "bitrate"},
+{"v", "verbose"},
+{0,0}
 };
 
 static int loop = 0;
@@ -146,20 +147,24 @@ int args_callback_longoption(char*name,char*val)
 {
     return args_long2shortoption(options, name, val);
 }
-void args_callback_usage(char*name)
+void args_callback_usage(char *name)
 {
-    printf("Usage: %s [-o filename] file.wav\n", name);
-    printf("\t-v , --verbose\t\t\t Be more verbose\n");
-    printf("\t-d , --definesound\t\t Generate a DefineSound tag instead of streaming sound\n");
-    printf("\t-l , --loop n\t\t\t Loop sound n times (implies -d)\n");
-    printf("\t-r , --framerate fps\t\t Set framerate to fps frames per second\n");
-    printf("\t-s , --samplerate sps\t\t Set samplerate to sps frames per second (default: 11025)\n");
-    printf("\t-b , --bitrate bps\t\t Set mp3 bitrate (default: 32)\n");
-    printf("\t-o , --output filename\t\t set output filename (default: output.swf)\n");
-    printf("\t-C , --cgi\t\t\t For use as CGI- prepend http header, write to stdout\n");
-    printf("\t-S , --stop\t\t\t Stop the movie at frame 0\n");
-    printf("\t           \t\t\t (For use with flashsound.js)\n");
-    printf("\t-V , --version\t\t\t Print program version and exit\n");
+    printf("\n");
+    printf("Usage: %s [-o filename] file.wav\n\n", name);
+    printf("\n");
+    printf("-h , --help                    Print short help message and exit\n");
+    printf("-V , --version                 Print version info and exit\n");
+    printf("-o , --output <filename>       Explicitly specify output file. (Otherwise, output will go to output.swf)\n");
+    printf("-r , --framerate <fps>         Set file framerate to <fps> frames per second.\n");
+    printf("-s , --samplerate <sps>        Set samplerate to <sps> frames per second (default: 11025).\n");
+    printf("-b , --bitrate bps             Set mp3 bitrate to <bps>.\n");
+    printf("-d , --definesound             Generate a DefineSound tag instead of streaming sound.\n");
+    printf("-l , --loop n                  (Only used with -d)\n");
+    printf("-C , --cgi                     For use as CGI- prepend http header, write to stdout.\n");
+    printf("-S , --stop                    Stop the movie at frame 0\n");
+    printf("-b , --bitrate <bps>           Set mp3 bitrate to <bps> (default: 32)\n");
+    printf("-v , --verbose                 Be more verbose\n");
+    printf("\n");
 }
 int args_callback_command(char*name,char*val)
 {