From: kramm Date: Fri, 6 Feb 2004 16:28:15 +0000 (+0000) Subject: updated/corrected documentation X-Git-Tag: release-0-5-0~23 X-Git-Url: http://git.asbjorn.biz/?p=swftools.git;a=commitdiff_plain;h=6f3e9add89a0157ef6552bc154475b43b371e615 updated/corrected documentation --- diff --git a/src/font2swf.1 b/src/font2swf.1 index d761e5f..df7091f 100644 --- a/src/font2swf.1 +++ b/src/font2swf.1 @@ -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 diff --git a/src/font2swf.c b/src/font2swf.c index 6e355a7..be8134b 100644 --- a/src/font2swf.c +++ b/src/font2swf.c @@ -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 [...]\n", name); - printf(" OR: %s --all\n", name); + printf("Usage: %s \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 Write output to file .\n"); + printf("-V , --version Print version info and exit\n"); printf("\n"); } int args_callback_command(char*name,char*val) diff --git a/src/jpeg2swf.1 b/src/jpeg2swf.1 index cae2b42..59ff9cd 100644 --- a/src/jpeg2swf.1 +++ b/src/jpeg2swf.1 @@ -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 .TP -Matthias Kramm - +Matthias Kramm diff --git a/src/jpeg2swf.c b/src/jpeg2swf.c index fad1152..aa01fbc 100644 --- a/src/jpeg2swf.c +++ b/src/jpeg2swf.c @@ -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 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 Set compression quality (1-100, 1=worst, 100=best)\n"); + printf("-r , --rate Set movie framerate (frames per second)\n"); + printf("-X , --width Force movie width to (default: autodetect)\n"); + printf("-Y , --height Force movie height to (default: autodetect)\n"); + printf("-v , --verbose Set verbose level to (0=quiet, 1=default, 2=debug)\n"); + printf("-V , --version Print version information and exit\n"); + printf("\n"); } diff --git a/src/png2swf.1 b/src/png2swf.1 index 9e3619f..c3ed59b 100644 --- a/src/png2swf.1 +++ b/src/png2swf.1 @@ -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 +\fB\-C\fR, \fB\-\-cgi\fR + For use as CGI- prepend http header, write to stdout .TP -Rainer Böhme - +\fB\-V\fR, \fB\-\-version\fR + Print version information and exit diff --git a/src/png2swf.c b/src/png2swf.c index 2f0c606..cc70c61 100644 --- a/src/png2swf.c +++ b/src/png2swf.c @@ -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 \t\t\tSet movie framerate (frames per second)\n"); - printf("\t-o , --output \t\t\tSet name for SWF output file\n"); - printf("\t-X , --pixel \t\t\tForce movie width to pixel (default: autodetect)\n"); - printf("\t-Y , --pixel \t\t\tForce movie height to pixel (default: autodetect)\n"); - printf("\t-v , --verbose \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 Set movie framerate (frames per second)\n"); + printf("-o , --output Set name for SWF output file.\n"); + printf("-X , --pixel Force movie width to (default: autodetect)\n"); + printf("-Y , --pixel Force movie height to (default: autodetect)\n"); + printf("-v , --verbose 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) diff --git a/src/swfbbox.1 b/src/swfbbox.1 index e69de29..b752aab 100644 --- a/src/swfbbox.1 +++ b/src/swfbbox.1 @@ -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 diff --git a/src/swfbbox.c b/src/swfbbox.c index de0d96c..5fb1dba 100644 --- a/src/swfbbox.c +++ b/src/swfbbox.c @@ -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 Set output filename to (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) { diff --git a/src/swfc.1 b/src/swfc.1 index b40f2d3..42113a1 100644 --- a/src/swfc.1 +++ b/src/swfc.1 @@ -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 + Specify output file (Default: output.swf). + This affects only the parts of the .sc file which haven't + specified an output file themselves. diff --git a/src/swfc.c b/src/swfc.c index 49897ef..7a5f7c4 100644 --- a/src/swfc.c +++ b/src/swfc.c @@ -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 Set output file to .\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"); diff --git a/src/swfcombine.1 b/src/swfcombine.1 index b8d8ba1..0bc912a 100644 --- a/src/swfcombine.1 +++ b/src/swfcombine.1 @@ -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 - diff --git a/src/swfcombine.c b/src/swfcombine.c index 7c675af..e595d26 100644 --- a/src/swfcombine.c +++ b/src/swfcombine.c @@ -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 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 x Adjust position of slave by pixels\n"); + printf("-y , --movey y Adjust position of slave by pixels\n"); + printf("-s , --scale Adjust size of slave by percent (e.g. 100% = original size)\n"); + printf("-r , --rate Set movie framerate to (frames/sec)\n"); + printf("-X , --width Force movie bbox width to (default: use master width (not with -t))\n"); + printf("-Y , --height Force movie bbox height to (default: use master height (not with -t))\n"); + printf("-z , --zlib Enable Flash 6 (MX) Zlib Compression\n"); + printf("\n"); } static void makestackmaster(SWF*swf) diff --git a/src/swfdump.1 b/src/swfdump.1 index 0a78baa..3f495e3 100644 --- a/src/swfdump.1 +++ b/src/swfdump.1 @@ -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 - +\fB\-u\fR, \fB\-\-used\fR + Show referred IDs for each Tag. diff --git a/src/swfdump.c b/src/swfdump.c index 9b58e2d..05b2865 100644 --- a/src/swfdump.c +++ b/src/swfdump.c @@ -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) { diff --git a/src/wav2swf.1 b/src/wav2swf.1 index 13edbe6..69c7821 100644 --- a/src/wav2swf.1 +++ b/src/wav2swf.1 @@ -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 - +\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) diff --git a/src/wav2swf.c b/src/wav2swf.c index 6bc59cd..dddf766 100644 --- a/src/wav2swf.c +++ b/src/wav2swf.c @@ -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 Explicitly specify output file. (Otherwise, output will go to output.swf)\n"); + printf("-r , --framerate Set file framerate to frames per second.\n"); + printf("-s , --samplerate Set samplerate to frames per second (default: 11025).\n"); + printf("-b , --bitrate bps Set mp3 bitrate to .\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 Set mp3 bitrate to (default: 32)\n"); + printf("-v , --verbose Be more verbose\n"); + printf("\n"); } int args_callback_command(char*name,char*val) {