MPEG(1) MPEG(1) NNAAMMEE mpeg - MPEG compression and decompression SSYYNNOOPPSSIISS mmppeegg [[--dd]] [[--NNTTSSCC]] [[--CCIIFF]] [[--QQCCIIFF]] [[--PPFF]] [[--NNPPSS]] [[--MMBBPPSS mmbbppss]] [[--UUTTCC]] [[--XXIINNGG]] [[--DDMMVVBB]] [[--MMVVNNTT]] [[--aa SSttaarrttNNuummbbeerr]] [[--bb EEnnddNNuummbbeerr]] [[--hh HHoorriizzoonnttaallSSiizzee]] [[--vv VVeerrttiiccaallSSiizzee]] [[--ff FFrraammeeIInntteerrvvaall]] [[--gg GGrroouuppIInntteerrvvaall]] [[--44]] [[--cc]] [[--ii MMCCSSeeaarrcchhLLiimmiitt]] [[--oo]] [[--pp PPiiccttuurreeRRaattee]] [[--qq QQuuaannttiizzaattiioonn]] [[--rr TTaarrggeett RRaattee]] [[--ss SSttrreeaammFFiillee]] [[--xx TTaarrggeett FFiilleessiizzee]] [[--yy]] [[--zz CCoommppoonneennttFFiilleeSSuuffffiixx ii]] CCoommppoonneennttFFiilleePPrreeffiixx11 [[CCoommppoonneennttFFiilleePPrreeffiixx22 CCoommppoonneenntt-- FFiilleePPrreeffiixx33]] DDEESSCCRRIIPPTTIIOONN _m_p_e_g is a multimedia image sequence compres- sion/decompression program that performs MPEG encoding and decoding. OOPPTTIIOONNSS --NNTTSSCC indicates that the source frame size for the Lumi- nance component is 352x240 and for the Chrominance components is 176x120. This is the default size. --CCIIFF indicates that the source frame size for the Lumi- nance component is 352x288 and for the Chrominance components is 176x144. --QQCCIIFF indicates that the source frame size for the Lumi- nance component is 176x144 and for the Chrominance components is 88x72. --PPFF indicates that the component sizes specified by --hh and --vv are not multiples of 16 and furthermore that the input files (or output files) should be exactly that specified by the component size --hh and --vv (or as read from the compressed stream). Otherwise the input and output files will be the component size rounded up to a multiple of 16 in each dimension. --NNPPSS The NPS option allows the encoder to encode without having the restriction that the last macroblock in a slice cannot be skipped. For coding purposes, the first macroblock in a slice must be coded, although the decoder will probably handle that case as well. --MMBBPPSS This specifies the macroblocks per slice. If left unspecified then the number of macroblocks per slice is the number of macroblocks on one row of 14 June 1993 1 MPEG(1) MPEG(1) the image. --UUTTCC Forces the frame number of the image to match the Group-of-Pictures time code. Only useful for the decoder. --XXIINNGG enables XING compatible encoding for intra-frame only files for the XING decoders. May not be robust, but eventually XING encoders and decoders will become more MPEG compatible. This specifies 160x120 encoding (apparently the defacto) for XING decoders. If you wish to overide the 160x120 encoding for XING image format, use the --hh and --vv options after the --XXIINNGG option. By default --PPFF is always selected with -XING option. --DDMMVVBB denotes Dynamic Motion Vector Bounding. Should reduce the overall bits spent in the motion vectors if set. Generally doesn't do that much for the default settings, but changing the search limit will automatically enable the dynamic motion vector bounding feature. --MMVVNNTT disables the motion vector telescoping. Generally telescoping is a big gain when the search window is small, though if the search window grows large, telescoping may not be beneficial. --aa denotes the following value to be the start of the filename index [inclusive]. Defaults to 0. --bb denotes the following value to be the end of the filename index [inclusive]. Defaults to 0. --dd enables the decoder. The only options useful for the decoder are the filename specifications and the --NNPPSS,, --UUTTCC commmands; the rest of the command-line information is used for encoding. --hh is the horizontal size of the picture in terms of the luminance component, used for a non --NNTTSSCC,, --CCIIFF,, --QQCCIIFF filesize. See the preceding note about --PPFF about the dimensions of the file relative to that of the component. --vv is the vertical size of the picture in terms of the luminance component, used for a non --NNTTSSCC,, --CCIIFF,, --QQCCIIFF filesize. See the preceding note about --PPFF about the dimensions of the file relative to that of the component. --ff is the number of interpolated frames between each intra/predicted frame. FFrraammeeIInntteerrvvaall--11 is the num- ber of interpolated frames within each frame 14 June 1993 2 MPEG(1) MPEG(1) interval. --gg is the number of frame intervals per group-of- pictures. With a group interval of 1 then there are no predicted frames. The value GGrroouuppIInntteerrvvaall--11 is the number of predicted frames in each group of pictures. --44 is used to DC Intraframe mode where only the DC components of each picture block is coded. --ii is the diameter of the motion estimation search. The diameter must be be positive. The default value is 15 for a search window of approx (+- 7.5, +- 7.5). The motion estimation is telescopic for frame distances greater than 1 (thus having a greater effective range). The telescopic motion estimation can be turned off by the --MMVVNNTT flag. This option can now have a value greater than 15 but less than approximately 960. For large values the estimation becomes very slow. --oo signals that the program interpreter will read the control algorithms from the standard input. --pp specifies the picture rate by a code directly placed into the stream. It must be a number between 0 and 8. (default 5=30Hz). --qq gives a value for the quantization not in the pres- ence of rate control (rate control automatically changes the quantization values). If rate control is specified, this parameter gives a value for the initial quantization of the first frame (which the program usually takes an educated guess at). --rr specified a rate for the coded stream. If this is enabled, a buffer model is used to limit the size of the coding stream. Note this is given in bits per second. --ss specifies the filename to store the coded image. If unspecified it defaults to CCoommppoonneennttFFiilleePPrree-- ffiixx00..mmppgg.. --vv designates that quantization decisions are to be written to standard output. This is the verbose mode. --xx gives a target filesize for the compressed stream. This overrides the rate option --rr,, if specified. This is specified in bits. The actual implementa- tion of this technique is through calculating the equivalent bit-rate. Since the buffer usually has 14 June 1993 3 MPEG(1) MPEG(1) some contents at the end of coding, the final file- size is larger than actually designated. --yy enables the double-precision floating point Refer- ence DCT. The default is the Chen DCT. --zz denotes the component file suffixes in sequential order. For example --zz ..yy..ccllrr --zz ..uu..ccllrr --zz ..vv..ccllrr indicates that the luminance and the two chrominance files end with a suffix of ..yy..ccllrr,, ..uu..ccllrr,, and ..vv..ccllrr,, in that order. If unspecified, the suffixes default to ..YY,, UU,, and ..VV.. CCoommppoonneennttFFiilleePPrreeffiixx_n must be specified. In general, the other component files share the same prefix and will default to CCoommppoonneennttFFiilleePPrreeffiixx11 if not explicitly specified. However, in some cases the prefix is what changes in the file and we can specify this individually. EEXXAAMMPPLLEESS To encode a set of raw raster scan YCbCr (also known as digital YUV) files with dimension 352x240 Y, 176x120 U,V, with labels, hheelllloo00..YY hheelllloo00..UU hheelllloo00..VV,, hheelllloo11..YY hheelllloo11..UU hheelllloo11..VV,, ......,, hheelllloo1122..YY hheelllloo1122..UU hheelllloo1122..VV through the mpeg encoder, type mmppeegg --aa 00 --bb 1122 hheelllloo --ss hheelllloo..mmppgg This creates the output file hheelllloo..mmppgg.. In order to decode such a file into a sequence of image files with prefix ggooooddbbyyee,, type mmppeegg --dd --ss hheelllloo..mmppgg ggooooddbbyyee The output will be placed in the files ggooooddbbyyee00..YY ggoooodd-- bbyyee00..UU ggooooddbbyyee00..VV,, ggooooddbbyyee11..YY ggooooddbbyyee11..UU ggooooddbbyyee11..VV,, ......,, ggooooddbbyyee1122..YY ggooooddbbyyee1122..UU ggooooddbbyyee1122..VV.. These image sequences can be displayed by the _c_v program. The image sequences can also be converted to ppm and back through the programs _c_y_u_v_2_p_p_m and _p_p_m_2_c_y_u_v Those utility programs available by anonymous ftp from _h_a_v_e_- _f_u_n_._s_t_a_n_f_o_r_d_._e_d_u_:_p_u_b_/_c_v_/_C_V_v_1_._2_._1_._t_a_r_._Z_. There are more options within an internal program interpreter. Please see the accompanying documentation in _d_o_c_._p_s for more details. FFTTPP _m_p_e_g is available by anonymous ftp from _h_a_v_e_- _f_u_n_._s_t_a_n_f_o_r_d_._e_d_u_:_p_u_b_/_m_p_e_g_/_M_P_E_G_v_1_._2_._t_a_r_._Z_. 14 June 1993 4 MPEG(1) MPEG(1) BBUUGGSS Somewhat slower than many commercial implementations. Please inform the author at achung@cs.stanford.edu if any bugs are found. AAUUTTHHOORR Andy Hung 14 June 1993 5