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