Subcommand Specifications

in: Specify Input Video File

[Format] -in=filename
[Input] filename : input video file
[Function]  Specifies input video file.

This subcommand is commonly used and provides an alternative to the video subcommand.

Example: Specifies sample.avi as an input video file.

> medianoche -in=sample.avi -out=sample.usm

out: Specify Output Movie File

[Format] -out=filename
[Input] output : output movie file (usm file)
[Function]  Specifies output file name.

This subcommand is commonly used. Specify output file name with the file extension "usm".

Example: Specifies sample.usm as output file name.

> medianoche -in=sample.avi -out=sample.usm

video: Specify Input Video File

[Format] -video##=filename
[Input] filename : video file
        ##   : video track number (## = 00)
[Function]  Specifies input video file.

1. Video files: For details about video file, see Sec Video Material Files.
2. Video track number: Please be sure to specify 00 for video track number. Currently, other track numbers are not supported.

Example: Assigns an AVI file smpvid.avi to track 00.

> medianoche -video00=smpvid.avi -audio00=smpaud.wav -out=sample.usm

alpha: Specify Alpha File

[Format] -alpha##=filename
[Input] filename : alpha file
        ##   : alpha track number (## = 00)
[Function]  Specifies input alpha file.

When creating an alpha movie, specify an AVI file containing the alpha channel to encode.

1. Alpha track number: Please be sure to specify 00 for alpha track number. Currently, other track numbers are not supported.

Example: Assigns an alpha channel in an AVI file smpvid.avi to track 00.

> medianoche -video00=smpvid.avi -audio00=smpaud.wav -out=sample.usm \
                    -alpha00=smpvid.avi

audio: Specify Audio File

[Format]-audio##=filename
[Input] filename : audio file
        ##   : audio track number (## = 00 - 31)
[Function]  Specifies input audio file.

1. Audio files: For details about audio file, see Audio Material Files.
2. Audio track number:

• The track number specified here is used as audio track number for CRI Movie file.
• When using only one audio file, use track number 00.
• Up to 32 audio files can be specified.

Example: Assigns music file, English voice file and Japanese voice file to track 00, 01 and 02, respectively.

> medianoche -video00=smpvid.avi -out=sample.usm \
         -audio00=music.wav -audio01=voice_en.wav -audio02=voice_ja.wav

mca: Specify Audio File for Surround Movie

[Format]-mca**_##=filename
[Input] filename : audio files
        **   :  audio track number
        ##   : audio channel number (## = 00 - 05)
[Function]  Specifies audio file for surround movie

Audio files:

• To create surround movie, audio material files corresponding to speaker positions are required.
• All of material files for surround movie should be mono data.

Example: Assigns audio files for surround movie to track 0.

> medianoche -video00=smpvid.avi -out=sample.usm \
         -mca00_00=fl.wav -mca00_01=fr.wav -mca00_02=sl.wav -mca00_03=sr.wav \
         -mca00_04=c.wav -mca00_05=lfe.wav

subtitle: Specify Subtitle Information File

[Format]-subtitle##=filename
[Input] filename : subtitle information file
        ##   : subtitle channel (## = 00 - 15)
[Function]  Specifies subtitle information file.

1. Subtitle information file: For details about the subtitle information file, see Subtitle Information Files.
2. Subtitle channel number: Up to 16 subtitle information files can be specified.

Example: Specifies English and Japanese subtitle information files for channel 00 and channel 01, respectively.

> medianoche -video00=smpvid.avi -audio00=smpaud.wav -out=sample.usm \
         -subtitle00=subttl_en.txt -subtitle01=subttl_ja.txt

cuepoint: Specifying Cuepoint Information File

[Format] -cuepoint=filename
[Input] filename: cuepoint information file
[Function]  Specifies cuepoint information file.

For details about cuepoint information file, see Cuepoint Information File.

Example:

> medianoche -in=sample.avi -out=sample.usm -cuepoint=sample_cuepoint.txt

crop: Crop part of the Original Image

[Format]crop=crx,cry,crw,crh
[Input] crx: X coordinate of cropped image against the original image
        cry: Y coordinate of cropped image against the original image
        crw: Image width after cropping
        crh: Image height after cropping
[Function]  Crops a part of original image.

Any values are allowed, as long as the cropped image is inside of the original image. The default is no cropping.

Example: Crops video at (0,0) with width 640 and height 480.

> medianoche -in=sample.avi -out=sample.usm -crop=0,0,640,480

scale: Scales up/down the Original Image

[Format]scale=scw,sch 
[Input] scw : the width of resized image
        sch : the height of resized image
[Function]  Scales up/down the original image by averaging pixel value 

Default is no scaling.

Example: Resizes to video with width 640 and height 480.

> medianoche -in=sample.avi -out=sample.usm -scale=640,480

bitrate: Bitrate

[Format]-bitrate=rate
[Input] rate: bitrate [bps]
[Function]  Specifies the bitrate of output movie file in bps (bits per second).

When this subcommand is not specified, the movie file with the highest quality will be output without retrying the encoding.

Default: 3000000bps.

Example: Set the bitrate to 6Mbps.

> medianoche -video00=smpvid.avi -audio00=smpaud.wav -out=sample.usm \
         -bitrate=6000000

br_range: Bitrate Range for Variable Bitrate Control

[Format]-br_range=min,max
[Input] min: minimum bitrate [bps]
        max: maximum bitrate [bps]
[Function]  Sets the bitrate range with minimum and maximum values for variable bitrate control.

Default: min=0bps, max=3000000bps

Example: Set the bitrate range with min=0bps and max=3000000bps.

> medianoche -video00=smpvid.avi -audio00=smpaud.wav -out=sample.usm \
         - br_range=0,3000000

framerate: Frame Rate

[Format]-framerate=decfr
        -framerate=fr_num,fr_den
[Input] decfr:  frame rate in decimal number
        fr_num: numerator of frame rate in fractional number
        fr_den: denominator of frame rate in fractional number
[Function]  Specifies movie frame rate (fps).

The following two formats are available:

1. In the decimal representation: -framerate=29.97
2. In the fractional representation: -framerate=30000/1001

Up to 60 fps can be specified. When omitted, original frame rate of video material is used.

Example: Specifies 29.97 fps for movie frame rate.

> medianoche -video00=smpvid.avi -audio00=smpaud.wav -out=sample.usm \
         -framerate=29.97

hcfilter: High Compression Filter

[Format]-hcfilter=fltype
[Input] fltype: high compression filter type
        ON:   always on
        OFF:  always off
        AUTO: automatically applies when it's applicable.  (Default)
[Function]  Applies high compression filter for video encoding.

High compression filter is effective especially for encoding at lower-bitrate.

The GOP is a group of successive pictures within a coded video stream. Each coded video stream consists of successive GOPs. From the pictures contained in it, the visible frames are generated.

A GOP can contain the following picture types:

• I-picture or I-frame (intra coded picture) - reference picture, which represents a fixed image and is independent of other picture types. Each GOP begins with this type of picture.
• P-picture or P-frame (predictive coded picture) - contains motion-compensated difference information from the preceding I- or P-frame.
• B-picture or B-frame (bidirectionally predictive coded picture) - contains difference information from the preceding and following I- or P-frame within a GOP.

gop_i: Number of I-pictures in GOP

[Format] -gop_i=count
[Input] count: number of I pictures in GOP
[Function]  Specifies number of I pictures in GOP

By adjusting GOP length and number of pictures for each picture type (I, P, B) in GOP, the movie quality can be improved.

• The more I pictures are used, the less decoding load can be. But data amount of I picture is larger than other picture types.
• Default: 1

gop_p: Number of P-pictures in GOP

[Format] -gop_p=count
[Input] count: number of P pictures in one GOP
[Function]  Specifies number of P pictures in one GOP

By adjusting GOP length and number of pictures for each picture type (I, P, B) in GOP, the movie quality can be improved.

• P picture has intermediate data size between I picture and B picture.
• Default: 4

gop_b: Number of B-pictures in GOP

[Format] -gop_b=count
[Input] count: number of B pictures in one GOP
[Function]  Specifies number of B pictures in one GOP

By adjusting GOP length and number of pictures for each picture type (I, P, B) in GOP, the movie quality can be improved.

• The more B pictures are used, the higher movie compression ratio will be because more video information will be allocated in the same bitrate. But decoding load will become higher.
• Default: 2

gop_closed: Closed GOP

[Format]-gop_closed=sw
[Input] sw: switch for the closed GOP
    ON:  closed GOP (Default)
    OFF: non closed GOP
[Function]  Enables the closed GOP.

When enabling closed GOP, the GOP sequence becomes independent from other GOP's and can be easily edited.

detectsc: Scene Change Detection

[Format]    -detectsc=sw
[Input] sw: switch for the scene change detection
        ON : (Default)
        OFF:
[Function]  Enables the scene change detection.

When detecting change of cut scenes, an I-picture is automatically inserted. By inserting an I-picture at the start of the new scene, the image quality immediately after scene change can be improved.

hca: Encode audio source for HCA codec

[Format] -hca=sw [Input] sw: switch for HCA encoding ON: Encode as HCA OFF: Not encode as HCA (Default) [Function] Specifies whether or not to encode audio source as HCA codec.

When setting this option as disabled, encode audio source with ADX codec.

hca_quality: Sound quality when encoding as HCA

[Format]   -hca_quality=count 
[Input] count: Selects encoding quality from the following 5 values
    5 = Highest 
    4 = High (default)
    3 = Medium
    2 = Low  (high compression)
    1 = Lowest   (highest compression)
[Function]  Set sound quality for HCA encoding.

Rough relationship between encoding quality value and compression rate is shown below:

ms_fullpel_still: Motion Search in Full Pel (full pixel) for Still Parts

[Format]-ms_fullpel_still=sw
[Input] sw: switch for the motion search in full pel for still parts
        ON:  
        OFF: (Default)
[Function]  Specifies whether or not to perform motion search in full pel for still parts.

When setting this option as enabled, motion search is performed in half pel (half pixel distances) for moved parts and in full pel for still parts.

This option will suppress fluctuations in dark scenes but subtle motion may not be reproduced.

cleanup: Delete intermediate files

[Format]-cleanup=sw
[Input] sw = switch for deleting intermediate files
        ON:  Delete (Default)
        OFF: Not delete
[Function]  Specifies whether to delete intermediate files that are created during encoding process.

When set to OFF, CRI Movie video files (.usv) and CRI Movie audio files (.usa) are left in the same folder where the CRI Movie file (.usm) exists.

Default setting is ON (to delete).

work_dir: Sets the working directory

[Format] -work_dir=dirname
[Input] dirname : working directory
[Function]  Sets the working directory to create intermediate files for encoding process.

If the working directory is not specified, intermediate files are created in the same directory as the input files.

debug: Output debug information

[Format]-debug=sw
[Input] sw = switch for outputting debug information
        ON:  Display debug info.
        OFF: No debug info. (Default)
[Function]  Enables to output debug information.

Default setting is OFF (no debug info).

preview: Display preview screen

[Format]-preview=sw
[Input] sw = switch for displaying preview screen
        ON:  Display (Default)
        OFF: Not display
[Function]  Specifies whether or not to display the preview screen that appears during encoding process.

Default setting is ON (to display).