IBM MPEG-4 Audio Video Content Generator IBM MPEG-4 Technologies
IBM MPEG-4 Technologies
Overview
Menu bar
File menu
Edit menu
Generate menu
Window menu
Help menu
Window
Input files
Output file
Creation
Command line

Command Line

The IBM MPEG-4 Audio Video Content Generator Tool supports a Command Line interface. Command line options can be specified which pre-populate the input and output file fields for the window interface. Secondly, The input and output files can be specified along with the quiet (-q)option on the command line to allow a batch generation of MPEG-4 files.

Command line format:

AVgen [video file] [audio file] [[-o] MPEG-4 output file]
      [-q] [-?]
      [-format (isma|3gpp|mvr|m4mux|none)]
      [-p packet size]
      [-copyright file]
      [-b bitrate]
      [-c (minBuffer|maxBuffer|time <t>|size <k>|min <t> <k>|max <t> <k>)]

An explanation of the various command line options follows.

Video File

Specifies a video file. The IBM MPEG-4 Audio Video Content Generator Tool will determine which parameter is a video file, thus the order of files is not mandated. The Tool will validate that only one video file specified.

If the quiet mode is specified the video parameter is optional. Note: either a video or audio file is required.

If the quiet (-q) option is not specified the video parameter will be used in the video input file field.

The supported video files, along with the file types in parentheses, are:

  • ISMA compliant video:
    • MPEG-4 video (.cmp, .m4v, .263 & .mp4)

MPEG-4 files can contain more than one video. To select a specific video in a MPEG-4 file specify the number of the track or which video offset by including video or track number. For example:

  • inputFile.mp4#video
    • specifies the first video in the file
  • inputFile.mp4#video(0)
    • specifies the first video in the file
  • inputFile.mp4#video(1)
    • specifies the second video in the file
  • inputFile.mp4#0
    • specifies the first track in the file. Knowledge of which track contains video is required.
  • inputFile.mp4#1
    • specifies the second track in the file Knowledge of which track contains video is required.

Audio File

Specifies an audio file. The IBM MPEG-4 Audio Video Content Generator Tool will determine which parameter is an audio file, thus the order of files is not mandated. The Tool will validate that only one audio file specified.

If the quiet mode is specified the audio parameter is optional. Note: either a video or audio file is required.

If the quiet (-q) option is not specified the audio parameter will be used in the audio input file field.

The supported audio files, along with the file types in parentheses, are:

  • ISMA compliant audio:
    • MPEG-4 AAC audio (.aac, .adif & .mp4)
  • Additional audio types:
    • mp3 audio (.mp3)
    • G.723 audio (.723)

MPEG-4 files can contain more than one audio. To select a specific audio in a MPEG-4 file specify the number of the track or which audio offset by including audio or track number. For example:

  • inputFile.mp4#audio
    • specifies the first audio in the file
  • inputFile.mp4#audio(0)
    • specifies the first audio in the file
  • inputFile.mp4#audio(1)
    • specifies the second audio in the file
  • inputFile.mp4#0
    • specifies the first track in the file. Knowledge of which track contains audio is required.
  • inputFile.mp4#1
    • specifies the second track in the file Knowledge of which track contains audio is required.

MPEG-4 Output File

Specifies an MPEG-4 file. The IBM MPEG-4 Audio Video Content Generator Tool will determine which parameter is the MPEG-4 output file, thus the order of files is not mandated. The Tool will validate that only one MPEG-4 output file specified.

If the quiet option (-q) is specified the MPEG-4 output file parameter is required.

If the quiet option (-q) is not specified the MPEG-4 output file parameter will be used in the MPEG-4 output file field.

-o

Specifies that the following parameter is the output file name. It forces the following parameter to be the MPEG-4 output file name. If it is not specified the MPEG-4 file will be checked for video or audio and may be considered an input file. With the parameter specified if the file exists then the file will be overwritten.

-q

Specifies to run the IBM MPEG-4 Audio Video Content Generator Tool in a batch mode (quiet). If this option is not specified the window interface will be invoked.

-?

Displays a short help description at the command line.

-format (isma | 3gpp | mvr | m4mux | none)

Specifies the stream hinting format.. If this option is not specified the default value is none.

  • none generates the standard MPEG-4 binary file.
  • isma generates the hinted MPEG-4 file to be compatible for use with ISMA compliant devices
  • 3gpp generates the hinted MPEG-4 file to be compatible for use with 3GPP compliant devices
  • mvr generates a MPEG-4 MVR streamable file suitable for streaming across the internet with a standard HTTP server
  • m4mux generates a MPEG-4 Multiplex streamable file suitable for streaming across the internet with a standard HTTP server

-copyright file

Optional file which contains copyright text in English to appear in the output file.

-b bitrate

Anticipated client connection speed for MVR MPEG-4 or MPEG-4 Multiplex file. This parameter is optional. The default is 104857600 bit/sec..

-g (minBuffer | maxBuffer | time <t> | size <s> | min <t> <s> | max <t> <s>)

Set constraints for the download buffering. A minimum amount of buffering offers a just-in-time delivery of content. A maximum amount of buffering provides the earliest possible delivery of media content. This would fill up a buffer to the extent of the maximum possible bandwidth. This will help mask network glitches which would not be possible in the just-in-time delivery, but could create extremely large buffers in networks with large bandwidth. Within these minimum and maximum buffer sizes, limits can be set on the amount of buffer space used. Buffer size can be limited based on a size limit value or an estimated playback time limit value. Both of these buffer size limiting values are constrained by the minimum and maximum buffer amount values.

minBuffer minimum buffer size
maxBuffer maximum buffer size
time <t> buffer size limit based on an estimated playback time. The default with a 5 second buffer (time 5.0).
size <k> buffer size limit based on a maximum size value.
min <t> <s> buffer size limit based on the lesser of an estimated playback time and maximum size value.
max <t> <s> buffer size limit based on the greater of an estimated playback time and maximum size value.

The time and size values are in the form:

<t> Time in seconds as a decimal value. e.g. "time 5.3"
<s> Size in bytes as a integer value. e.g. "size 10000"

For example:

AVgen video.m4v audio.adif output.mp4 -q
AVgen mpeg4withvideo.mp4#video mpeg4withaudio.mp4#audio -o ouput.mp4 -q
  IBM Home | Research Home | MPEG-4 Technologies | alphaWorks | © Copyright IBM Corp. 1998, 2006. All Rights Reserved.