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

FreeBSD Manual Pages

  
 
  

home | help
AdvanceCOMP MNG	Compression General(CommAdvanceCOMP MNG	Compression 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
       emulator.

       To compress the files this utility uses the following strategies:
       o      Remove all ancillary chunks.
       o      Use the MNG Delta	feature	to  compress  video  clips  with  only
	      small changes between frames.
       o      Use  the	MNG  Move  feature  to	compress  video	 clips	with a
	      scrolling	background (option -s).
       o      Reduce the color depth to	8 bit (option -r).
       o      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
	      specified,  it's used the	smallest file choice from the previous
	      compressed 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  com-
	      pressed. 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 com-
	      pressor.	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 op-
	      tion.

       -4, --shrink-insane
	      Set the compression level	to "insane" using the zopfli  compres-
	      sor.   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
	      compressors 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
	      expressed	 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 interleave 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  monodi-
	      rectional	patterns like "-s 16x0"	or "-s 0x16".

       -S, --scroll-square N
	      This  option  is like the	option "-s NxN"	but excludes big move-
	      ment on both directions reducing the computation time.  Specifi-
	      cally 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
	      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)  specifica-
	      tions. 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)

					AdvanceCOMP MNG	Compression Utility(1)

NAME | SYNOPSIS | DESCRIPTION | COMMANDS | OPTIONS | EXAMPLES | COPYRIGHT | SEE ALSO

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

home | help