MAN page from PLD advancecomp-1.15-1.i686.rpm

AdvanceCOMP MNG Compression Utility

Section: User Commands (1)
Index

NAME

advmng - AdvanceCOMP MNG Compression Utility

SYNOPSIS

advmng [-l, --list] [-z, --recompress]

[-x, --extract] [-a, --add RATE MNG_FILE PNG_FILES...]

[-0, --shrink-store] [-1, --shrink-fast] [-2, --shrink-normal]

[-3, --shrink-extra] [-4, --shrink-insane]

[-s, --scroll HxV] [-S, --scroll-square]

[-e, --expand] [-r, --reduce]

[-c, --lc] [-C, --vlc] [-f, --force] [-q, --quiet] [-v, --verbose]

[-h, --help] [-V, --version] FILES...

DESCRIPTION

The main purpose of this utility is to recompress MNGfiles to get the smallest possible size.

Please note that this utility is not able to reada generic file. It's granted to be able to read onlythe files generated by the AdvanceMAME emulator.

To compress the files this utility uses the followingstrategies:

•: Remove all ancillary chunks.
•: Use the MNG Delta feature to compress video clips withonly small changes between frames.
•: Use the MNG Move feature to compress video clips witha scrolling background (option -s).
•: Reduce the color depth to 8 bit (option -r).
•: Use the 7zip Deflate implementation.

COMMANDS

-l, --list FILES...: List the content of the specified files.
-z, --recompress FILES...: Recompress the specified files. If the -1, -2, -3options are specified, it's used the smallest filechoice from the previous compressed data and thenew compression. If the -0 option is specified thefile is always rewritten without any compression.
-x, --extract FILES...: Extract all the .png frames in the .mng clips.You can use the --shrink options to control thecompression ratio of the .png files. The extractedimages are always 24 bit images with alpha channel.You can remove the alpha channel with the -n option.
-a, --add RATE MNG_FILE PNG_FILES...: Compress all the .png files on the command lineas a .mng file. All the .png files must have thesame size and the same bit depth. You must alsospecify an integer frame rate to use in the

OPTIONS

-0, --shrink-store: Disable the compression. The file isonly stored and not compressed. The file is alwaysrewritten also if it's bigger.
-1, --shrink-fast: Set the compression level to a"fasta".
-2, --shrink-normal: Set the compression level to a"normala". This is thedefault level of compression.
-3, --shrink-extra: Set the compression level to a"extraa".
-4, --shrink-insane: Set the compression level to a"insanea". It's VERYSLOW.
-s, --scroll HxV: The a"-s HxVa" option specifies the size of the pattern(H width x V height) used to check for ascrolling background. The size is expressed inpixels and it must be bigger or equal than thescrolling speed of the background. For exampletake the game 1942 that scrolls vertically by 1pixel every frame. If you recorded with an interleavefactor of 2 the vertical scrolling speed is1*2 = 2. In this case the minimum pattern is a"-s 0x2a".Generally you can use a"-s 8x8a" and use biggervalues only for games scrolling faster. If thegame scrolls only horizontally or vertically you canspeed up a lot the compression with monodirectionalpatterns like a"-s 16x0a" or a"-s 0x16a".
-S, --scroll-square N: This option is like the option a"-s NxNa" but excludesbig movement on both directions reducing the computationtime. Specifically the check done is X+Y<=N.
-r, --reduce: Force the color reduction to 8 bit. The reduction isreally done only if any frame have less than 256 colorsand if no alpha channel is present. To force the reductionalso if an alpha channel is present use the -n option.
-e, --expand: Force the color expansion to 24 bit.
-n, --noalpha: Remove the alpha channel if present.
-c, --lc: Force the use of the MNG LC (Low Complexity)specifications. It disables the delta compression.The file is always rewritten also if it's bigger.
-C, --vlc: Force the use of the MNG VLC (Very Low Complexity)specifications. It disables the delta compressionand the precise timing. Warning! you may lose thecorrect timing information because the VLC formatonly supports integer frequency. The file is alwaysrewritten also if it's bigger.
-f, --force: Force the use of the new file also if it's bigger.
-q, --quiet: Don't print the filenames.
-v, --verbose: Print more information on the compression process.

EXAMPLES

A good tradeoff of recompression and time is the command :

: advmng -z -r -S 16 *.mng

To create a .mng file from a series of .png files use thecommand :

: advmng -a 30 video.mng video*.png

To extract all the images in a .mng file use the command :

: advmng -x video.mng

COPYRIGHT

This document was created byman2html,using the manual pages.