IBM MPEG-4 XMT Batch Converter IBM MPEG-4 Technologies
IBM MPEG-4 Technologies
Overview
Menu bar
File menu
Edit menu
Generate menu
Help menu
Window
Input file
Output file
Creation
Command line

Command Line

The IBM MPEG-4 XMT Batch Converter Tool supports a Command Line interface. Command line options can be specified which pre-populate window interface especially the input and output file fields. Secondly, The input and output files can be specified along with the quiet (-noGui) option on the command line to allow a batch generation of MPEG-4 files.

Command line format:

XmtBatch <input>
         [-m <MPEG-4.mp4>]
         [-o <XMT-O.xml>]
         [-a <XMT-A.xml>]
         [-h <Hinter.mp4>
         [-v <M4Mvr.mv4>]
         [-t <M4Mux.m4x>]
         [-p <XMT-O.xsd>]
         [-u <schemas/o/>]
         [-[no]ValidateXmto]
         [-s <XMT-A.xsd>]
         [-w <schemas/a/>]
         [-[no]ValidateXmta]
         [-[no]convert]
         [-[no]Gui]
         [-l <logfile.txt>]
         [-e (4|3|2|1|0) [class list]]
         [-?] [-??]
         [-meter|-pixel]
         [-r (size|%)]
         [-[no]bmp]
         [-c <imgDir>]
         [-d <imgDirOff>]
         [-q <list of element id=*a boolean value*>]
         [-standard|-av|-isma|-3gpp]
         [-b <pktSize>]
         [-f <bitRate>]
         [-g minBuffer|maxBuffer|time <t>|size <k>|min <t> <k>|max <t> <k>]]
         [-y <bitRate>]
         [-z minBuffer|maxBuffer|time <t>|size <k>|min <t> <k>|max <t> <k>]]

An explanation of the various command line options follows.

<input> input file name. Valid input files are:
WMF file If no other parameter is provided then the extension will be changed from .wmf to .mp4.
XMT-O file If no other parameter is provided then the extension will be changed from .xml to .mp4.
XMT-A file If no other parameter is provided then the extension will be changed from .xml to .mp4.
MPEG-4 binary file If no other parameter is provided then the extension will be changed from .mp4 to .xml.
<MPEG-4.mp4> MPEG-4 binary file name.
<XMT-O.xml> optional XMT-O file name. If one is not provided then the XMT-O file will not be generated. If an XMT-O file is the input then this parameter is ignored.
<XMT-A.xml> optional XMT-A file name. If one is not provided then the XMT-A file will not be generated. If an XMT-A file is the input then this parameter is ignored.
<Hinter.mp4> optional MPEG-4 Hinter file name. Hinted MPEG-4 is file for a server like VideoCharger for unicast/multicast over RTP.
<M4Mvr.mv4> optional MPEG-4 MVR file name. MPEG-4 MVR file for streaming over an HTTP server.
<M4Mux.m4x> optional MPEG-4 Multiplex file name. MPEG-4 Multiplex file for streaming over an HTTP server.
<XMT-O.xsd> optional XMT-O schema file. The name to be used for the XMT-O output file. If an XMT-O file is not output then this parameter is ignored. NOTE: the schema file name should be in the format of a URL name. For example: 'xmt-o.xsd', 'http://www.ibm.com/xmt-o.xsd' or 'file:///c:/xmt-o.xsd'. If one is not specified then the default is 'xmt-o.xsd'.
<schemas/o/> optional path to an xmt-o schema file. This path will be used before the default one while looking for the schema. The default is 'schemas/xmt-o/'.
-[no]ValidateXmto optional flag for validation of the XMT-O file. Default is to validate the XMT-O file.
<XMT-A.xsd> optional XMT-A schema file. The name to be used for the XMT-A output file. If an XMT-A file is not output then this parameter is ignored. NOTE: the schema file name should be in the format of a URL name. For example: 'xmt-a.xsd', 'http://www.ibm.com/xmt-a.xsd' or 'file:///c:/xmt-a.xsd'. If one is not specified then the default is 'xmt-a.xsd'.
<schemas/a/> optional path to an xmt-a schema file. This path will be used before the default one while looking for the schema. The default is 'schemas/xmt-a/'.
-[no]ValidateXmta optional flag for validation of the XMT-A file. Default is to validate the XMT-A file.
-[no]convert optional flag to perform validation only. The input file will be validated but not converted. Default is to perform the conversion.
-[no]Gui flag to display the window user interface or run in command line batch mode. Default is to run in the command line batch mode. If there are no arguments then the default is to run the window user interface.
<logfile.txt> optional file name where messages will be logged. If one is not provided then any message will be printed on the console.
-e (4|3|2|1|0) level for error messages.
4 only fatal error messages will appear.
3 error and fatal error messages will appear, default.
2 warning, error and fatal error messages will appear.
1 trace, warning, error and fatal error messages will appear.
0 OK, trace, warning, error and fatal error messages will appear.
[class list] optional list of classes to trace. Only works if trace level for messages is supported.
-? short help information.
-?? long help information.
-meter|-pixel optional flag to indicate that the XMT-O generated from the WMF (Windows Media Format) file should be in meter metrics or pixel metrics. Default is meter 'meter'.
(size|%) optional scaling factor to be used in the XMT-O file from the WMF file. It can be specified as a raw size or as a percentage of the original. To indicate a percentage of the original suffix the numeric value with a percent sign (%). Default is '100%'.
size the XMT-O layout size is scaled to the width provided in the size value. The scene is sized to fit the presentation window.
% the XMT-O layout size is obtained from the WMF file. The scene size is scaled to the percentage of the size value found in the WMF file.
-bmp|-nobmp optional flag to indicate whether external bitmap files should be generated in addition to the JPEG files generated from images found in the WMF files. The name and location of the BMP files is the same as for the JPEG files with the .bmp extension. Default is to not generate the BMP files.
<imgDir> directory where the image files will be created. This is either an absolute path location or relative to the current execution directory. E.g. 'c:\XMT-O Source Dir\multimedia\' or '..\XMT-O Source Dir\multimedia\'. Default is to place the image files in the current execution directory.
<imgDirOff> directory offset from the location of the in the XMT-O file. This is the prefix used file location of the source attribute on the image element. E.g. <img src="multimedia\image.jpg">. Default is to not use a prefix.
-q optional. Use this flag to manually set defaultState attributes of customTest elements.
-standard | -av | -isma | -3gpp optional flag for determining the hinting format. The default is "standard". The various options are:
standard hint the entire file.
av only hint the audio and video tracks.
isma hint the audio and video tracks in ISMA format.
3gpp hint the audio and video tracks in 3GPP format.
-b <pktSize> Maximum RTP packet size. The default is 1024 bytes.
-f <bitRate> Anticipated client connection speed for MPEG-4 MVR 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"
-y <bitRate> Anticipated client connection speed for MPEG-4 Multiplex file. This parameter is optional. The default is 104857600 bit/sec.
 -z (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:

XmtBatch sample.xml
XmtBatch sample.xml -a sampleA.xml -m sample.mp4 -noGui
  IBM Home | Research Home | MPEG-4 Technologies | alphaWorks | © Copyright IBM Corp. 1998, 2004. All Rights Reserved.