Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
AdvanceCOM...ion Utility(1)  General Commands Manual AdvanceCOM...ion Utility(1)

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] [-i, --iter N]
	  [-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 MNG files to get the
     smallest possible size.

     Please note that this utility is not able to  read  a  generic  file.  It's
     granted to be able to read only the files generated by the AdvanceMAME emu-
     lator.

     To compress the files this utility uses the following strategies:
     *	    Remove all ancillary chunks.
     *	    Use  the  MNG  Delta feature to compress video clips with only small
	    changes between frames.
     *	    Use the MNG Move feature to compress video clips  with  a  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, -3 options are speci-
	    fied,  it's  used  the  smallest  file choice from the previous com-
	    pressed data and the new compression. If the -0 option is  specified
	    the file 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 the compression ratio of the .png files.
	    The extracted images 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 line as a .mng file. All
	    the .png files must have the same size and the same bit  depth.  You
	    must also specify an integer frame rate to use in the

OPTIONS
     -0, --shrink-store
	    Disable the compression. The file is only stored and not compressed.
	    The file is always rewritten also if it's bigger.

     -1, --shrink-fast
	    Set the compression level to "fast" using the zlib compressor.

     -2, --shrink-normal
	    Set  the compression level to "normal" using the libdeflate compres-
	    sor.  This is the default level of compression.

     -3, --shrink-extra
	    Set the compression level to "extra" using the 7z  compressor.   You
	    can define the compressor iterations with the -i, --iter option.

     -4, --shrink-insane
	    Set  the  compression level to "insane" using the zopfli compressor.
	    You can define the compressor iterations with the -i, --iter option.

     -i, --iter N
	    Define an additional numer of iterations for the 7z and zopfli  com-
	    pressors for modes -3 and -4.  More iterations usually give a better
	    compression,  but may require a lot more time.  Try for example with
	    10, 15, 20, and so on.

     -s, --scroll HxV
	    The "-s HxV" option specifies the size of the pattern (H width  x  V
	    height)  used  to  check for a scrolling background. The size is ex-
	    pressed in pixels and it must be bigger or equal than the  scrolling
	    speed of the background. For example take the game 1942 that scrolls
	    vertically	by  1  pixel every frame. If you recorded with an inter-
	    leave factor of 2 the vertical scrolling speed is 1*2 = 2.	In  this
	    case  the  minimum	pattern  is "-s 0x2".  Generally you can use "-s
	    8x8" and use bigger values only for games scrolling faster.  If  the
	    game  scrolls only horizontally or vertically you can speed up a lot
	    the compression with monodirectional patterns like "-s 16x0" or  "-s
	    0x16".

     -S, --scroll-square N
	    This option is like the option "-s NxN" but excludes big movement on
	    both  directions  reducing	the  computation  time. Specifically the
	    check done is X+Y<=N.

     -r, --reduce
	    Force the color reduction to 8 bit. The  reduction	is  really  done
	    only  if any frame have less than 256 colors and if no alpha channel
	    is present. To force the reduction	also  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 dis-
	    ables  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 compression and the precise timing. Warning!
	    you may lose the correct timing information because the  VLC  format
	    only  supports  integer frequency. The file is always rewritten 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 the command :

	 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 file is Copyright (C) 2003 Andrea Mazzoleni, Filipe Estima

SEE ALSO
     advzip(1), advpng(1), advdef(1)

						     AdvanceCOM...ion Utility(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=advmng&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help