mp4box.1

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

.B \-aviraw TK
extracts AVI track to its raw format. TK can be one of "video", "audio" or "audioN" for multi-track avi files (cf '-info'). 
.
.SH DUMP OPTIONS
.TP
.B \-info [TrackID]
prints movie and tracks information. If TrackID specified, dumps only extended track info. If input file is not an IsoMedia file, lists known tracks for import.
.TP
.B \-bt
dumps complete scene in a BT file. This will remove unknown MPEG4 nodes.
.TP
.B \-xmt
dumps complete scene in an XMT-A file. This will remove unknown MPEG4 nodes.
.TP
.B \-wrl
dumps complete scene in an VRML97 WRL file. This will remove unknown VRML97 nodes.
.TP
.B \-x3d
dumps complete scene in an X3D XML file. This will remove unknown X3D nodes.
.TP
.B \-x3dv
dumps complete scene in an X3D Text (VRML) file. This will remove unknown X3D nodes.
.TP
.B \-diso
creates XML image of the file atoms.
.TP
.B \-drtp
creates XML image of all hint tracks samples of a hinted mp4 file.
.TP
.B \-dcr
creates XML image of all ISMACryp tracks samples of an mp4 file.
.TP
.B \-sdp
creates SDP file associated with a hinted mp4 file.
.TP
.B \-ttxt
converts input subtitle to GPAC TTXT format.
.TP
.B \-ttxt trackID
exports given text track to GPAC TTXT format.
.TP
.B \-srt
converts input subtitle to SRT format.
.TP
.B \-srt trackID
exports given text track to SRT subtitle format.
.TP
.B \-std
dumps to stdout rather than file.
.TP
.B \-stat
generates statitistic report on node/field usage for the whole presentation.
.TP
.B \-stats
generates statistic report on node/field usage per BIFS Access Unit.
.TP
.B \-statx
generates statistic report on node/field usage in the scene graph after each BIFS Access Unit.
.
.SH Meta OPTIONS
.
.LP
MP4Box supports the Meta addition to IsoMedia file format, used to make the file a generic data container (timed or untimed).
.TP
.B \-set-meta args
sets meta object type. Syntax is "ABCD[;tk=N] where:
.br ABCD is the four character code of the type, or O/NULL to remove the meta object
.br tk indicates whether the meta is at the root level (no "tk"), at the moov level (tk=0) or at the track level (tk=trackID).
.TP 
.B \-add-item args
adds resource to the given meta. args is the item file path followed by ';' separated options:
.br tk=N: same as above
.br name=item_name: specifies the item name, otherwise file name is used
.br mime=mimeType: specifies the item mime type, otherwise application/octet-stream is used
.br encoding=enctype: specifies the content encoding type
Note that file path set to "this" or "self" will identify the item added as the whole IsoMedia file
.TP
.B \-rem-item args
removes item from given meta. Syntax is itemID[;tk=ID].
.TP
.B \-set-primary args
sets given item as the primary one of the given meta. Syntax is itemID[;tk=ID].
.TP
.B \-set-xml args
sets XML to the given meta. Syntax is xml_file_path[;tk=ID][;binary].
.TP
.B \-rem-xml [tk=ID]
removes XML data from the given meta.
.TP
.B \-dump-xml xml_out_file_name[;tk=ID]
dumps the XML data of the given meta to a file.
.TP
.B \-dump-item itemID[;tk=ID][;path=fileName]
dumps the given item of the the given meta to a file. By default the item name is used as the output file name.
.
.SH SWF OPTIONS
.
.LP
MP4Box can import very simple Macromedia Flash files (".SWF"). You can specify a SWF input file with -bt, xmt and -mp4 switches.
.TP
.B \-static
all SWF defines are placed in first scene replace. By default SWF defines are sent when needed.
.TP
.B \-ctrl
uses a dedicated stream for movie control (forces -static option).
.TP
.B \-notext
removes all SWF text.
.TP
.B \-nofont
removes all embedded SWF Fonts, forcing usage of MPEG-4 Text and terminal fonts.
.TP
.B \-noline
removes all lines from SWF shapes.
.TP
.B \-nograd
removes all gradients from swf shapes.
.TP
.B \-quad
uses quadratic bezier curves instead of cubic ones.
.TP
.B \-xlp
support for lines transparency and scalability.
.TP
.B \-flatten Value
replaces 2 consecutive lines by a single one when angle between lines is less than Value (expressed in radians). Value 0 disables flattening.
.
.
.SH SUPPORTED INPUT FORMATS
.TP
.B RAW Formats and extensions
.IP
NHNT (.media .nhnt .info)
.br
MPEG Audio (.mp3)
.br
ADTS-AAC (.aac)
.br
MPEG-4 Visual (.cmp .m4v)
.br
H263 Video (.263 .h263)
.br
AVC/H264 Video (.h264 .h26L .264 .26L)
.br
JPEG Images (.jpg .jpeg)
.br
PNG Images (.png)
.br
AMR(WB) Audio (.amr .awb)
.br
EVRC Audio (.evc)
.br
SMV Audio (.smv)
.
.TP
.B Container Formats and extensions
.IP
AVI (.avi)
.br
MPEG-PS (.mpg .mpeg .vob .vcd .svcd)
.br
QCP (.qcp)
.br
OGG (.ogg)
.br
ISO-Media files (no extension checking)
.
.TP
.B Text Formats and extensions
.IP
.br
SRT Subtitles (.srt)
.br
SUB Subtitles (.sub)
.br
GPAC Timed Text (.ttxt)
.br
QuickTime TeXML Text (.xml)  (cf QT documentation)
.
.TP
.B Scene Formats and extensions
.IP
MPEG-4 XMT-A (.xmt .xmta .xmt.gz .xmta.gz)
.br
.br
MPEG-4 BT (.bt .bt.gz)
.br
VRML (.wrl .wrl.gz)
.br
X3D-XML (.x3d .x3d.gz)
.br
X3D-VRML (.x3dv .x3dv.gz)
.br
MacroMedia Flash (.swf) - very limitted import support only
.
.
.SH COMMON USAGE
.TP
.B Importing a file
.IP
Import an AVI: MP4Box -add myfile.avi mymp4.mp4
.br
Import audio from an AVI: MP4Box -add myfile.avi#audio mymp4.mp4
.br
Import video from an AVI: MP4Box -add myfile.avi#video mymp4.mp4
.br
Import an MP3 and leave data outside: MP4Box -dref -add myfile.mp3 mymp4.mp4
.br
Import a JPEG or PNG: MP4Box -add myfile.jpg mymp4.mp4
.br
Create a movie with subtitle: MP4Box -add video.avi -add audio.mp3 -add Subtitle.srt mymp4.mp4
.br
.TP
.B Base File operations
.IP
Convert file for HTTP/FTP streaming: MP4Box -inter 1000 myfile.mp4
.br
Convert unknown file to ISMA for HTTP/FTP streaming: MP4Box -isma -inter 1000 myfile.mp4
.br
Convert unknown file to ISMA and respect ISMA broken sync: MP4Box -ismax myfile.mp4
.br
Convert unknown file to 3GP : MP4Box -3gp myfile.mp4
.br
.TP
.B Hinting a File
.IP
Prepare any mp4 for ISMA streaming: MP4Box -isma -hint myfile.mp4
.br
Prepare any 3GP for streaming: MP4Box -hint myfile.3gp
.br
Prepare any 3GP for streaming with RTP aggregation : MP4Box -hint -multi myfile.3gp
.br
Prepare a simple audio/video mp4 optimized for server: MP4Box -hint -copy -tight myfile.mp4
.br
Prepare a complex mp4 with BIFS for streaming: MP4Box -ocr -iod -hint myfile.mp4
.br
.TP
.B Encoding/Decoding a file
.IP
Encode a BT file and keep node names for later inspection: MP4Box -mp4 -def pres.bt
.br
Encode a XMT-A file: MP4Box -mp4 pres.xmt
.br
Translate BT to XMT-A file: MP4Box -xmt pres.bt
.br
Translate XMT-A to BT file: MP4Box -bt pres.xmt
.br
Decode MP4 to BT: MP4Box -bt pres.mp4
.br
.
.SH BUGS and OTHER HELP
.TP
For bug reports, more information on BT or XMT-A formats or GPAC TTXT files or ISMACryp, MPEG-4 Systems usage and more help on MP4Box please visit the GPAC web site http://gpac.sourceforge.net
.
.SH "AUTHORS"
.LP 
Jean Le Feuvre <[e-mail]> - GPAC (c) 2000-2005
.
.SH "SEE ALSO"
.LP 
GPAC(1), MP4Client(1)