mp4box.1

一个用于智能手机的多媒体库适合S60 WinCE的跨平台开发库

.TH "MP4Box" 1 "June 2005" "MP4Box" "GPAC"
.
.SH NAME
.LP 
MP4Box \- MPEG-4 Systems Toolbox
.SH "SYNOPSIS"
.LP 
.B MP4Box
.RI [options] \ file \ [options]
.br
.
.SH "DESCRIPTION"
.LP 
MP4Box is a multi-purpose command line tool to create and edit MPEG-4 Systems presentations and manipulate ISO-media files (MP4, 3GP, MOV).
.LP
MP4Box supports file conversion from various raw formats and IsoMedia/AVI/MPEG-PS/OGG containers, file hinting for RTP streaming for QuickTime compatible streaming servers, file interleaving, file fragmentation and track extraction.
.LP
MP4Box also provides dump tools used to inspect file layout, RTP hint tracks, SDP information, scene composition. It may also be used to convert to and from BT/XMT-A/VRML/X3D.
.LP
MP4Box also features MPEG-4 Systems encoders and decoders for BIFS and OD tools.
.LP
MP4Box doesn't expect any particular order in options at prompt.
.
.SH GETTING HELP WITH MP4Box
.TP
.B \-h [type]
prints help screen. "type" can be one of "general", "hint", "import", "encode", "extract", "dump", "swf", "meta", "crypt", "format" for specific help.
.TP
.B \-version
prints version of MP4Box.
.TP
.B \-nodes
lists supported MPEG-4 Systems nodes in MP4Box current build.
.TP
.B \-node NodeName
prints the node syntax. Each field is listed as
.br
.I eventType fieldType fieldName defaultValue
.br
and field quantization information and quantization bounds if any.
.
.
.SH GENERAL OPTIONS
.P
.TP
.B \-inter duration
interleaves media data in chunks of the maximum specified duration (expressed in milliseconds) and prepare file for HTTP/FTP streaming. By default MP4Box always stores with 0.5 second interleaving. An interleaving value of '0' stores without interleaving (meta-data then track after track). 
.br
.B NOTE: Track Edit Lists are ignored when performing interleaving.
.TP
.B \-flat
stores file with all media data first, non interleaved. If used when creating a new file, no temporary file is created (faster storage).
.TP
.B \-frag duration
fragments file using ISO-Media movie fragments. Tracks will be fragmented so that no track run exceeds the specified duration (expressed in milliseconds). Disables interleaving.
.TP
.B -out\ \<filename>
specifies output file name. 
.TP
.B -tmp\ \<dirname>
specifies driectory for temporary storage. If not set, temporary storage is OS-dependent.
.TP
.B \-nosys
removes all MPEG-4 Systems information from the file but keeps an empty IOD for MPEG-4 Profile@Level indications.
.TP
.B \-isma
rewrites the file as an ISMA 1.0 Audio/Video file (all systems info rewritten) with proper clock references.
.TP
.B \-ismax
rewrites the file as an ISMA 1.0 Audio/Video file (all systems info rewritten) with ISMA clock references (streams not explicetly synchronized).
.br 
.B NOTE: Seeking may be broken with some players (in ISMA, audio and video streams do not depend on main scene clock).
.TP
.B \-3gp
rewrites the file as a 3GP file (no more MPEG-4 Systems specific info). This option is turned on by default when input file extension is .3gp or .3g2.
.TP
.B -cprt string
adds string copyright notice to file.
.TP
.B \-chap chap_file
adds chapter information contained in chap_file to movie. For more details on chapter file syntax, cf http://gpac.sourceforge.net/auth_mp4box.php.
.TP
.B -rem trackID
removes given track from file - can be specified multiple times.
.TP
.B -new
forces creation of a new destination file.
.TP
.B -lang [tkID=]LAN
sets the language of all tracks or the given track. LAN is the ISO 639-2 3 character code.
.TP
.B -delay [tkID=]delay_ms
sets the delay in milliseconds of all tracks or the given track. LAN is the ISO 639-2 3 character code.
.TP
.B \-split time_in_seconds
splits in files of desired maximum duration. This will remove all MPEG-4 Systems media.
.TP
.B \-splits size_in_kilobytes
splits in files of desired maximum size. This will remove all MPEG-4 Systems media.
.TP
.B \-splitx start:end
extracts a new file from specified start to end times (in seconds). This will remove all MPEG-4 Systems media.
.B When input file is an ISO-Media file (QT, MP4, 3GP), if no output is specified THE INPUT FILE IS OVERWRITTEN.
.
.
.SH HINTING OPTIONS
.TP
.B \-hint
hint the file for RTP\/RTSP sessions. Payload type is automatically detected and configured unless forced through one of MPEG-4 Generic RTP payload.
.TP
.B \-mtu size
specifies Maximum Transmission Unit size in bytes (eg maximum RTP packet size). Default size is 1500 bytes (Ethernet MTU). This must be choosen carefully: specifying too large packets will result in undesired packet fragmentation at UDP layer while specifying too small packets will result in RTP header overhead.
.TP
.B \-copy
forces hinted data to be copied to the hint track instead of simply referenced. This speeds up RTP packet construction at the server side but results in much bigger files.
.TP
.B \-tight
performs sample-based interleaving of media tracks and hint tracks. This should reduce disk seeks at server side (depending on server implementation) but results in a bigger file.
.TP
.B \-multi [maxptime]
enables Access Units concatenation in RTP packets if possible. maxptime is optional and specifies the maximum packet duration in milliseconds (default 100).
.TP
.B \-rate ck_rate
specifies the rtp rate in Hz when no default rate for payload. Default value is 90000 (MPEG rtp rates).
.TP
.B \-mpeg4
forces usage of the MPEG-4 generic payload whenever possible. Media tracks without a mapping to MPEG-4 Systems cannot use this.
.TP
.B \-latm
forces usage of the LATM payload for AAC audio.
.TP
.B \-static
enables usage of static RTP payload IDs for streams with official payload IDs. By default MP4Box always uses dynamic payload IDs for maximum interoperability, some players having troubles with static ones.
.
.P
.B MPEG-4 Generic Payload Options (Experts only)
.IP
.B \-ocr
forces all media tracks in the file to be served synchronized. This is needed because most streaming servers don't support desynchronized tracks in a single file. Be extremelly carefull when designing MPEG-4 interactive presentations for streaming since you will have to take care of the streaming server capabilities... MP4Box generates warnings when the file timeline can be ambiguously interpreted by the server.
.IP
.B \-rap
signals Access Units random access flag in RTP packets. This is usually only needed for streaming of MPEG-4 Systems streams.
.IP
.B \-ts
signals Access Units Time Stamps (CTS and DTS) in RTP packets.
.IP
.B \-size
signals Access Units size in RTP packets.
.IP
.B \-idx
signals Access Units indexes (sequence numbers) in RTP packets.
.IP
.B \-multi
enables Access Units concatenation in RTP packets (-ts, -size and -idx are selected if needed).
.IP
.B \-iod
prevents system tracks embedding in IOD (ISMA-like IOD) when generating in SDP. MP4Box automatically detects ambiguous (ISMA/non-ISMA) files but nobody's perfect. This shouldn't be used with -isma option.
.
.TP
.B \-sdp_ex string
adds string to movie SDP or track SDP (tkID:string, where tkID is the OD of the hint track or its media track). This takes care of SDP line reordering, but not of SDP content validity.
.TP
.B \-unhint
removes all hint tracks and other hinting info from the file.
.
.SH IMPORT OPTIONS
.TP
.B \-add <src_file>
adds all src_file tracks to input file, creating it if not exisiting. Up to 20 cumulated -add operations can be used. Supported syntaxes are:
.br
file#video: imports first video track from src_file.
.br
file#audio: imports first audio track from src_file.
.br
file#trackID=ID or file#ID: imports given trackfrom src_file. To get a listing of tracks in input file, use -info [ID]
.br
[;lang=LAN]: specifies language of imported media.
.br
[;delay=delay_ms]: specifies initial delay in milliseconds of imported media.
.TP
.B \-cat <src_file>
concatenates all src_file tracks to input file, creating it if not exisiting. Media samples are added at the end of existing compatible tracks. If no compatible track is found for a media it is created. Up to 20 cumulated -cat operations can be used. Syntax is the same as -add.
.TP
.B \-keepsys
by default all MPEG-4 systems media are removed with -add and -cat. This option will avoid removing them from final file.
.TP
.
.TP
.B \-dref
keeps media data in original file an only imports meta-data (frame timing, size and random access). 
.br
.TP
.B NOTE
Data referencing may fail with some AVI because it requires the framed data (eg an MP4 sample) to be continuous in the original file, which is not always the case depending on the original interleaving.
.TP
.B \-nodrop
forces constant FPS when importing AVI video. By default non coded frames (n-vop) are removed at import time, resulting in a variable frame-rate media.
.TP
.B \-packed
for CMP/M4V (raw MPEG-4 Visual), forces packed-bitstream mode (removes all n-vops and import at constant frame rate).
.TP
.B \-sbr
imports AAC as AAC-SBR, with backward compatible signaling (non AAC-SBR decoders should be able to play it).
.TP
.B \-sbrx
imports AAC as AAC-SBR, with non-backward compatible signaling (non AAC-SBR decoders will not be able to play it).
.TP 
.B \-fps FrameRate
overrides the input video frame rate or specifies it for SUB subtitles.
.TP 
.B \-mpeg4
forces using MPEG-4 sample descriptions rather than 3GP ones (3GP2 QCELP/EVRC/SMV audio only).
.TP 
.B \-agg N
aggregates N audio frames in 1 sample (3GP media only). Maximum possible value is 15, and default value is 1 (no aggregation).
.
.SH ENCODING OPTIONS
.TP
.B \-mp4
specifies input file is for encoding. Supported inputs are BT/XMT-A/WRL/SWF files. Output file name is by default the input file name without extensions plus ".mp4" extension. 
.TP
.B \-def
encodes DEF'ed nodes and routes with their textual names.
.TP
.B \-log
generates BIFS encoder log file.
.TP
.B \-ms file
specifies file for track importing - by default FILE.mp4 is used when encoding FILE.bt (in-place rewrite). This option is only needed if you don't provide
a proper muxInfo per stream in the BT/XMT file.
.TP
.B \-sync time
forces BIFS random access point generation every time milliseconds. Cannot be used with -shadow. WARNING: this may result in weird behavior of your presentation since a BIFS random access point restarts all media currently running in the scene (EXPERTS ONLY - DANGEROUS). Cannot be used with -shadow.
.TP
.B \-shadow time
forces BIFS shadow random access points generation every time milliseconds. Shadow samples are random access points that can be used instead of non random access points when seeking. WARNING: this may be not supported by some players (EXPERTS ONLY - DANGEROUS). Cannot be used with -sync.
.TP
.B \-inctx file
specifies initial context (MP4/BT/XMTA) for chunk processing. Input file must then be a command-only file: no IOD, and no implicit commands (commands without 'AT').
.TP
.B \-outctx file
specifies output file of updated context (MP4/BT/XMTA) in chunk processing mode. This is optional, chunk processing doesn't need to store the final context.
.
.SH EXTRACTING OPTIONS
.TP
.B \-raw TrackID
extracts given track in native format when supported.
.TP
.B \-raws TrackID
extract each track sample to a file. Note: 'TrackID:N' extracts Nth sample of the track.
.TP
.B \-nhnt TrackID
extracts given track in NHNT format. All track types except ObjectDescriptors tracks can be exported.
.TP
.B \-single TrackID
extracts given track to a new mp4 file with a single track.
.TP
.B \-avi TrackID
extracts visual track to an avi file.
.TP
.B \-qcp TrackID
same as '-raw' but defaults to QCP file format for AVRC and SMV audio codecs.
.TP