指定トラックの言語を指定。トラックIDを指定しない場合
は全てのトラックに適用。使
える言語コードは ISO 639-1
2-char code、ISO 639-2 3-char code、または full language
name。サポートする言語のリストを見るには MP4Box -languages。
IsoMedia
File
Hintingは、ファイルの中にトランスポート・プロトコル固有の情報を含んだ特殊トラックを作成する事です。また、多重化情報
(multiplexing information)を加える事もできます。
こうしたトラックは、サーバが実際にネットワーク越しに伝送するパケットを作成する際に使います。ひらたく云うとパケット作成のヒントです。だから
Hint Track。
MP4Boxはマルチメディア・ストリーミングで最も幅広く使われているRTPプロトコル用のヒントトラックを作る事が出来る。生
成ファイルは
AppleのQTSS/DSS serverのようなIsoMedia file format と hint
trackを扱えるサーバからクライアントへストリーミングできる。
movie SDP information
に指定のテキストを追加(-sdp_ex
"a=x-test: an sdp
test") またはトラックに指定のテキストを追加(-sdp_ex
"N:a=x-test"、N はヒントトラックか、そのベーストラック ID)。これは SDP line
orderingを管理する。警告:SDPには何も追加してはいけない。詳細は RFC2327
参照。
-unhint :
全ての hint trackと SDP
information
をファイルから取り除く。MP4Boxはヒンティングの工程で既存のヒントトラックを一切除去しないので、使う機会は多いだろう。
ファイル中の全メディアトラックを強制的に同期して配信で
きるようにする。ストリーミ
ングサーバの多くは非同期トラックを含んだ単一ファイルをサポートしていないために必要となる。ストリーミング用にMPEG-4
interactive
presentationを作る際には注意に注意を重ねること。というのはストリーミングサーバの能力も考えなければならないからだ。サーバがファイルの
timelineを曖昧に解釈しそうな場合(*when
the
file timeline can be ambiguously interpreted by the server*)、MP4Box
は警告を表示する。
ペイロードにランダムアクセスポイント信号をつける。 (*signals
random access points in the payload.*)
-ts
:
ペイロードにAUタイムスタンプ信号をつける。メディアの
中にB-Frame(または
類似のもの)が検出された場合、自動的に使う。 (*signals AU
timestamps in the
payload. This option is automatically
turned on when B-Frames (or similar) are detected in the media.*)
-size
:
ペイロードにAUサイズ信号をつける。 (*signals AU size in
the payload.*)
-idx :
ペイロードにAUシークエンスナンバー信号をつける。 (*signals AU
sequence number in the payload.*)
入力ファイルを SAF
multiplexにremux。これは LASeR contentをエンコードする際にはダイレクトに使える。
MPEG-4
Systems、VRML、X3Dのハンドリング("MP4Box -h dump" and "MP4Box -h encode"
)
MP4BoxはMPEG-4 Scene
Description(*シーン記述*)の
エンコード・デコードに使える。またさまざまなテキストベースフォーマット、 BT, XMT-A,
WRL (VRML97), X3D in XML or VRML format, LASeR and
SVG、の相互変換もできる。こうした変換は必ずしもうまく行くとは限らない。というのはこれらの規格間には使用するノードのセットに違いがあるからだ。
-mp4 :
specifies input file is to
be encoded.
Supports .bt (BT), .xmt (XMT-A), .wrl (VRML97), .swf (Flash) and
SVG/LASeR (.svg or .xsr) input. For more details on flash input, try
MP4Box -h swf. For more details on BT/XMT-A, go here.
-def
:
encodes nodes
and routes names, rather
than just binary identifiers.
This is usefull when developping content otherwise the decoded scene
becomes quickly messy.
-log :
generates log file for
BIFS encoder and for LASeR encoder/decoder. The log is only usefull to
debug the scene codecs.
-ms
:
specifies the media source
to check for
track importing. This is
needed when no MuxInfo is present in the BT file, although this is not
recommended. By default, MP4Box looks for tracks in MYFILE.mp4 when
encoding MYFILE.bt
-bt :
dumps scene in a BT file.
-xmt
:
dumps scene in an XMT-A
file.
-wrl :
dumps scene
into VRML97 format - unknown/incompatible nodes are removed.
-x3d
:
dumps scene into X3D/XML
format -
unknown/incompatible nodes are
removed.
-x3dv :
dumps scene into X3D/text
format -
- unknown/incompatible nodes are removed.
-lsr :
dumps scene in a
LASeR+XML file.
-svg :
dumps LASeR
scene root node to an SVG file.
Note :
conversion
from VRML-based scene graphs to/from SVG-based scene graphs is not
supported.
LASeR
encoding options
-resolution
res :
specifies the resolution
to use when encoding points. Value
ranges from -8 to 7, and all coordinates are multiplied by 2^res. The
default resolution used is 0.
-coord-bits bits :
Number of bits
used to encode a point coordinate. Default value is 12
bits.
-scale-bits
bits :
Number of extra bits used
to encode a scale factor (scale factor
are therefore encoded on coord_bits+scale_bits). Default value is 0
bits.
-auto-quant res :
resolution is given as if
using
-resolution but coord-bits and scale-bits are computed dynamically. The
default resolution used is 0.
inserts random
access points at the
desired frequency, specified in
milliseconds. This cannot be used with the -sync or -shadow option.
-shadow
time :
inserts random access
points at the
desired frequency, specified
in milliseconds. This cannot be used with the -sync or -carousel
option. The difference with -carousel is that random access samples can
only be inserted as a substitution to existing samples, therefore their
frequency is not guaranteed.
-sync time :
forces
sync sample at
the desired frequency by replacing the original sample. Time is
specified in milliseconds. This cannot be used with the -shadow or
-carousel option.
ISMA
Encryption and
description ("MP4Box -h crypt")
assign the given type to
the meta
container (similar to file
branding). Arguments syntax is ABCD[:tk=ID] where:
ABCD
: four char meta type (NULL or 0 to remove meta)
tk=ID
: if not set, use the root (file) meta is used. If ID is 0,
the
moovie (moov) meta is used, otherwise the given track meta is used
-add-item
args :
adds a file resource to
the meta
container. Arguments syntax is
file_path + options (':' separated) with the following options:
tk=ID : meta adressing (file, moov, track) - same
as above.
name=str : overrides the item name,
otherwise the file name is
used.
mime=mtype : specifies the item mime type.
encoding=enctype
: specifies the item content-encoding type.
Note
: a file_path of this or self means the item is the containing file
itself.
-rem-item args :
removes the given resource
from the meta container. Arguments syntax is item_ID[:tk=ID].
-set-primary
args :
sets the given item as
primary item for
the meta container. A
primary item is the item used when no XML information is available in
the meta container. Arguments syntax is item_ID[:tk=ID].
-set-xml
args :
sets XML data of the meta
container.
Arguments syntax is
xml_file_path[:tk=ID][:binary], where binary specifies that the XML is
not in plain text.
-rem-xml [tk=ID] :
removes XML
data from the meta container.
-dump-xml args :
dumps
XML data of the meta container to a file. Arguments syntax is
output_file_path[:tk=ID].
-dump-item
args :
dumps given item to file.
Arguments
syntax is
item_ID[:tk=ID][:path=fileName], where path is the output file name.
-package
:
packages the input XML
file into an ISO
container. All local media
referenced (except hyperlinks) are added to file (only 'href' and 'url'
attributes are currently processsed). THIS IS AN
EXPERIMENTAL
FEATURE
NOT FULLY TESTED
Misc
("MP4Box -h")
-nodes
:
prints list of MPEG-4
nodes supported
in this MP4Box build.
-node
NodeName :
prints MPEG-4 node syntax:
fields,
their type, event type,
default value and quantization info if any. Note this works only for
nodes supported in the current built.
-xnodes :
prints list of
X3D nodes supported in
this MP4Box build.
-xnode
NodeName :
prints X3D node syntax:
fields, their
type, event type and
default value. Note this works only for nodes supported in the current
built.
-snodes :
prints list of SVG nodes
supported
in this MP4Box build.
-snode
NodeName :
prints possible attributes
and
properties of the SVG node.
Note this works only for nodes supported in the current built.
-languages
:
prints list of supported
languages and
their ISO 639 associated codes.