1AdvanceCOMP MNG Compression UGteinleirtayl(1C)ommaAnddvsanMcaenCuOaMlP MNG Compression Utility(1)
2
6 advmng ‐ AdvanceCOMP MNG Compression Utility
7
9 advmng [‐l, ‐‐list] [‐z, ‐‐recompress]
10 [‐x, ‐‐extract] [‐a, ‐‐add RATE MNG_FILE PNG_FILES...]
11 [‐0, ‐‐shrink‐store] [‐1, ‐‐shrink‐fast] [‐2, ‐‐shrink‐normal]
12 [‐3, ‐‐shrink‐extra] [‐4, ‐‐shrink‐insane]
13 [‐s, ‐‐scroll HxV] [‐S, ‐‐scroll‐square]
14 [‐e, ‐‐expand] [‐r, ‐‐reduce]
15 [‐c, ‐‐lc] [‐C, ‐‐vlc] [‐f, ‐‐force] [‐q, ‐‐quiet] [‐v, ‐‐verbose]
16 [‐h, ‐‐help] [‐V, ‐‐version] FILES...
18 The main purpose of this utility is to recompress MNG files to get the
19 smallest possible size.
20 Please note that this utility is not able to read a generic file. It’s
22 granted to be able to read only the files generated by the AdvanceMAME
23 emulator.
24 To compress the files this utility uses the following strategies:
26 · Remove all ancillary chunks.
27 · Use the MNG Delta feature to compress video clips with only
28 small changes between frames.
29 · Use the MNG Move feature to compress video clips with a
30 scrolling background (option ‐s).
31 · Reduce the color depth to 8 bit (option ‐r).
32 · Use the 7zip Deflate implementation.
33
35 ‐l, ‐‐list FILES...
36 List the content of the specified files.
37 ‐z, ‐‐recompress FILES...
39 Recompress the specified files. If the ‐1, ‐2, ‐3 options are
40 specified, it’s used the smallest file choice from the previous
41 compressed data and the new compression. If the ‐0 option is
42 specified the file is always rewritten without any compression.
43 ‐x, ‐‐extract FILES...
45 Extract all the .png frames in the .mng clips. You can use the
46 ‐‐shrink options to control the compression ratio of the .png
47 files. The extracted images are always 24 bit images with alpha
48 channel. You can remove the alpha channel with the ‐n option.
49 ‐a, ‐‐add RATE MNG_FILE PNG_FILES...
51 Compress all the .png files on the command line as a .mng file.
52 All the .png files must have the same size and the same bit
53 depth. You must also specify an integer frame rate to use in the
54
56 ‐0, ‐‐shrink‐store
57 Disable the compression. The file is only stored and not com‐
58 pressed. The file is always rewritten also if it’s bigger.
59 ‐1, ‐‐shrink‐fast
61 Set the compression level to ˝fast˝.
62 ‐2, ‐‐shrink‐normal
64 Set the compression level to ˝normal˝. This is the default level
65 of compression.
66 ‐3, ‐‐shrink‐extra
68 Set the compression level to ˝extra˝.
69 ‐4, ‐‐shrink‐insane
71 Set the compression level to ˝insane˝. It’s VERY SLOW.
72 ‐s, ‐‐scroll HxV
74 The ˝‐s HxV˝ option specifies the size of the pattern (H width x
75 V height) used to check for a scrolling background. The size is
76 expressed in pixels and it must be bigger or equal than the
77 scrolling speed of the background. For example take the game
78 1942 that scrolls vertically by 1 pixel every frame. If you
79 recorded with an interleave factor of 2 the vertical scrolling
80 speed is 1*2 = 2. In this case the minimum pattern is ˝‐s 0x2˝.
81 Generally you can use ˝‐s 8x8˝ and use bigger values only for
82 games scrolling faster. If the game scrolls only horizontally or
83 vertically you can speed up a lot the compression with monodi‐
84 rectional patterns like ˝‐s 16x0˝ or ˝‐s 0x16˝.
85 ‐S, ‐‐scroll‐square N
87 This option is like the option ˝‐s NxN˝ but excludes big move‐
88 ment on both directions reducing the computation time. Specifi‐
89 cally the check done is X+Y<=N.
90 ‐r, ‐‐reduce
92 Force the color reduction to 8 bit. The reduction is really done
93 only if any frame have less than 256 colors and if no alpha
94 channel is present. To force the reduction also if an alpha
95 channel is present use the ‐n option.
96 ‐e, ‐‐expand
98 Force the color expansion to 24 bit.
99 ‐n, ‐‐noalpha
101 Remove the alpha channel if present.
102 ‐c, ‐‐lc
104 Force the use of the MNG LC (Low Complexity) specifications. It
105 disables the delta compression. The file is always rewritten
106 also if it’s bigger.
107 ‐C, ‐‐vlc
109 Force the use of the MNG VLC (Very Low Complexity) specifica‐
110 tions. It disables the delta compression and the precise timing.
111 Warning! you may lose the correct timing information because the
112 VLC format only supports integer frequency. The file is always
113 rewritten also if it’s bigger.
114 ‐f, ‐‐force
116 Force the use of the new file also if it’s bigger.
117 ‐q, ‐‐quiet
119 Don’t print the filenames.
120 ‐v, ‐‐verbose
122 Print more information on the compression process.
123
125 A good tradeoff of recompression and time is the command :
126 advmng ‐z ‐r ‐S 16 *.mng
128 To create a .mng file from a series of .png files use the command :
130 advmng ‐a 30 video.mng video*.png
132 To extract all the images in a .mng file use the command :
134 advmng ‐x video.mng
136
138 This file is Copyright (C) 2003 Andrea Mazzoleni, Filipe Estima
139
141 advzip(1), advpng(1), advdef(1)
142 AdvanceCOMP MNG Compression Utility(1)