本文中でIsoMedia fileに言及する事があります。IsoMediaとは、MPEG-4 Part 12規格に由来する全てのフォーマット〜MP4、3GP、そしてMJ2K file〜の一般名称です。MJ2K fileのサポートはまだGPACではテストされていません。

　version 0.2.4以降、MP4BoxはIsoMedia fileのin-place rewrite（入力ファイルの上書き）を行います。この動作は -out Filename オプションで変更できます。

　古いバージョンのMP4Boxでは、既存のIsoMedia file（例えばAFILE.mp4）を上書きせず、出力はout_AFILE.mp4のようになっていました。出力ファイル名を変更するには -out Filename オプションを使います。

　version 0.2.4以降、MP4Boxは常にファイルを0.5秒間隔でインターリーブ（＊交互配置＊）し、メタデータを先 頭に書き込みます。これはHTTPスト リーミングに便利なようにです。

　 通常、MP4Boxは新しいIsoMedia fileの生成時に一時ファイルを作成します。作成場所はOSによって異なりますが、一時ファイル作成に使うドライブやパーティションに充分な空きや書き 込み権限が無いケースもあります。このような場合に一時ファイルの作成場所を変更するには -tmp path_to_dir オプションを使います。

　MP4Boxはaudio/video/imageのトランスコーディング（メディアトラックを他の符号化形式に再エンコードするこ と）ができません。 トランスコードには他のツールが必要です。

　version 0.2.2以降、プロンプトでオプションの順番を気にする必要は一切ありません。

　このページのドキュメントは最新版のMP4Boxについて書かれるものですから、時にGPAC CVSでなければ使えないオプションに言及する事があります。もしも手許で使えないオプションがあったらアップグレードして下さい。

　このオプションの多くは入力ファイルの保存方式を指示す るものです。作成、変換、既存ファイルの変更全てに使えます。

-tmp dir
-inter Duration
-tight :
-flat :
-frag time_ms :
-out fileName :
-new :
-no-sys :
-no-iod :
-isma:
-3gp :
-brand ABCD[:v] :
-ab ABCD :
-rb ABCD :
-rem trackID :
-par trackID=PAR :
-lang [trackID=]lang :
-delay trackID=TIME :
-name trackID=NAME :
-cprt string :
-chap chap_file :

• ZoomPlayer chapter files : AddChapter(nb_frames,chapter name)、AddChapterBySeconds(nb_sec,chapter name)、AddChapterByTime(h,m,s,chapter name) 。一行一チャプタ。
• Time codes : h:m:s name, h:m:s:ms name and h:m:s.ms name。 一行一チャプタ。
• SMPTE codes : h:m:s;nb_f/fps name 、 h:m:s;nb_f name 。nb_f はフレームの数、fps はフレームレート。一行一チャプタ。
• Common syntax : CHAPTERX=h:m:s[:ms or .ms] を一行に書き、CHAPTERXNAME=name は別の行に。順番は重要ではないが、チャプタの記述行は連続していなければならない（連続する２行に書くXの値は同一であること）。

　既存の MP4 fileの中には、MPEG-4 Visual trackのB-Frameを不適切な形式で保存したものがある。現在のMP4boxはこうしたものの自動クリンナップ機能を持っていないが、トラックの 再インポートで解決できる。

• MP4Box -avi trackID file.mp4: トラックをaviにエクスポートする（raw MPEG-4 video でも可能）。
• MP4Box -import file.avi dest.mp4: aviを MP4 に変換し、B-Frame を正しくインポートする（packed bitstreams, n-Vops）。

MP4Box は以下のファイルを規格に適合した IsoMedia fileに変換できる：

• RAW フォーマットとその拡張子：

  • MPEG-4 Video (.cmp .m4v（＊iPod 用.m4vはAppleの誤用＊）)
  • MPEG-4 Audio ADTS-AAC (.aac) - ADIF or RAW formats not supported
  • MPEG-1/2 Video (.m1v .m2v)
  • MPEG-1/2 Audio (.mp3)
  • JPEG and PNG Images (.jpg .jpeg .m4v)
  • H263 Video (.263 .h263)
  • AVC/H264 Video (.264 .h264, .26l .h26l)
  • AMR and AMR-WideBand Speech (.amr .awb)
  • EVRC Speech (.evc)
  • SMV Speech (.smv)
  • VobSub subtitles (.idx)

• AV コンテナとその拡張子：

  • AVI (.avi) - 現時点でサポートしているのは、MPEG-4 SP/ASP ビデオと MP3 audio のみ。AVC/H264 ビデオをインポートするには、先にAVIトラックを MP4Box -aviraw video file.avi で抽出すること。
  • MPEG-TS (.m2t .ts) - 現時点でサポートしているのは MPEG-1/2 ビデオと MPEG-1/2 audio のみ。
  • MPEG-PS (.mpg .mpeg .vob) - 現時点でサポートしているのは MPEG-1/2 ビデオと MPEG-1/2 audio のみ。
  • QCP (.qcp)
  • XIPH OGG (.ogg) - 試験的実装。IsoMediaベースの規格とは一切関係ない。サポートしているのは Vorbis audio と Theora video のみ。
  • NHNT (.media .info .nhnt) - 詳細はリンク先参照 NHNT documentation。
  • NHML (.nhml) - 詳細はリンク先参照 NHML documentation。
  • SAF (.saf) - SAF はhttp用の MPEG-4 LASeR transport format。
  • IsoMedia file （拡張子チェックなし）

• テ キストフォーマットとその拡張子：

  • SRT Subtitles (.srt)
  • SUB Subtitles (.sub)
  • QuickTime TeXML (.xml) - cf QT documentation
  • GPAC Timed Text (.ttxt)

　変換コマンドの書式は MP4Box -add inputFile destinationFile。こ のオプションは複数ソースからメディアをインポートするのに使う。一般的なMP4boxビルドでは最大で20個の-addコマンドが使える。 destination file が無い場合は自動的に作成し、トラックを追加する。destination fileを削除したい場合は、 -new オプションを追加する事。

　任意のメディアトラックを選択するには、以下の書式を使う：

• -add inputFile#video: で、 inputFileに最初のビデオトラックを追加。IsoMedia ならびに MPEG-2 TS では動作しない。
• -add inputFile#audio: で、inputFile.に最初のオーディオ トラックを追加。IsoMedia ならびに MPEG-2 TS では動作しない。
• -add inputFile#trackID=ID または -add inputFile#ID: で指定トラックを追加。IsoMedia fileでは、ID はトラックID。その他のメディアファイルでは、ID は MP4Box -info inputFileで表示される。

　MP4Box はinput fileの全体ではなく、任意の量をインポートできる。指定書式は -add inputFile%N、N はインポートする秒数。インポート開始位置は任意指定できないので、常に先頭からになる。

　-add オプションを使う場合、MP4Boxは自動的にデフォルトのBIFS と OD トラックを作る。出力ファイルが可能な限り ISMA 1.0 standard に適合するようにだ。出力ファイルの拡張子が .3gp または .3g2だった場合、MP4Box は自動的に 3GP(2) 規格に適合するファイルを書き出す。これは、MP4Box で-addを使うと、システムトラックが除去される事を意味する。これを避けるには -keepsys オプションを使う事。出力ファイルの拡張子が.m4aの場合、MP4Box は自動的に iTunesが必要とする情報を書き込む。

　既存のIsoMedia fileを-addオ プ ションでインポートする際、MP4BoxはMPEG-4 または 3GPP(2)規格に適合しない全てのトラックを自動的に 除去す る。そうしたトラックも残したい場合は -keepall オプションを使う事。

テキストインポートに関する注意 ： SRT または SUB fileをインポートする際、MP4Boxはデフォルトで字幕が映像の下端に出るようにレイアウトオプションを指定する。したがって、ビデオトラックがま だ一つもないファイルに字幕ファイルをインポートするのは良く無い（デフォルトのSRT/SUBインポートは、デフォルトのserif フォント・フォントサイズ18・ディスプレイサイズ400x60になる）。3GPP timed textに関する詳細は、http://gpac.sourceforge.net/doc_ttxt.php。

　メディアをインポートする際に使える各メディア固有のオ プション。non-IsoMedia fileに使えるオプションは、対象のメディアトラックに -info オプションを使う事。例： MP4Box -info 2 file.mpg

-dref :
-sbr :
-sbrx :
-nodrop :
-packed:
-fps FrameRate :
-mpeg4 :
-agg N :

いっぺんに複数の track/sourceをインポートする際、全オプションが各ソースに（使える場合は）適用される。ストリーム単位で適用するには以下の書式を使う。
MP4Box -add stream[:opt1:...:optN] dest.mp4

使えるオプションは以下の通り：

• fps=N -fpsに同じ。インポートするメディアだけに適用。
• lang=language specifies the frame rate for the imported media.（＊？？？＊）
• delay=delta specifies the frame rate for the imported media.（＊？？？＊）
• dref  -drefに同じ。インポートする メディアだけに適用。
• nodrop -nodropに同じ。インポートするメディアだけ に適用。
• packed  -packedに同じ。イン ポートするメディアだけに適用。
• sbr  -sbrに同じ。インポートするメ ディアだけに適用。
• sbrx  -sbrxに同じ。インポートする メディアだけに適用。
• agg=val same as -agg, but only applies to the imported media.
• dur= 　インポートする メディアの分量指定。単位は秒。
• par=A:B& nbsp;インポートするメディアに Pixel Aspect Ratio を指定。"none"も可。（＊tag:アスペクト の一覧＊）
• name=Val インポートするメディアトラックのname指定。

OGG Supportに関する注意：MP4Box はVorbis audio や Theora videoの入ったOGG fileをインポートできる。この機能は実験的なもので、また、IsoMedia fileにこうしたものを入れる事は誰も規格化していない。この機能は開発・実験以外では使 うべきではなく、GPACでのサポートもなくなる可能性なしとしない。

MP4Box は IsoMedia fileをサイズや持続時間で分割できる。また、一部分を抽出して新しい IsoMedia file(s)にできる。このプロセスは、入力ファイルのうち、at most（＊少なくとも？＊）１トラックが定 期的なアクセスポイントを持っている必要がある（一般的にはビデオトラックat most（＊が望ましい？＊））。また、 MPEG-4 システムトラックとhintトラックは全て無視するが、private メディアトラックだけは分割を試みる。

*注意１：分割の際には、入力トラックに充分なランダムアクセスポイントがなければならない。従ってキーフレームが冒頭1フレームだ けのビデオファイルは分割できない。H263 videoの入った3GPファイルは多くの場合コレだ（＊訳注：x264で同様の設定も可。PSPで有用らしい＊）。 こうしたものを分割するには、本格的なビデオエディタを使い、映像を再エンコードする必要がある。
*注意２：単独のパスでファイルにメディアを追加し、さらに分割することも出来る。この場合、分割前の中間出力ファイルは保存されない。

-split time_in_seconds :
-splits size_in_kb :
-splitx StartTime:EndTime :
-cat a_file :

　IsoMedia File Hintingは、ファイルの中にトランスポート・プロトコル固有の情報を含んだ特殊トラックを作成する事です。また、多重化情報 （multiplexing information）を加える事もできます。
　こうしたトラックは、サーバが実際にネットワーク越しに伝送するパケットを作成する際に使います。ひらたく云うとパケット作成のヒントです。だから Hint Track。

　MP4Boxはマルチメディア・ストリーミングで最も幅広く使われているRTPプロトコル用のヒントトラックを作る事が出来る。生 成ファイルは AppleのQTSS/DSS serverのようなIsoMedia file format と hint trackを扱えるサーバからクライアントへストリーミングできる。

-hint :
-mtu size :
-multi [maxptime] :
-copy :
-rate clock_rate :
-mpeg4 :
-latm :
-static :
-sdp_ex string :
-unhint :

詳しい人向けの機能とし て、MP4BoxはMPEG-4 Generic RTP payload formatの特殊なオプションを指定できる。
-ocr:
-iod :
-rap :
-ts :
-size :
-idx :

　MP4Boxは可能な限りベストなpayloadを検出するよう試み、見つからない場合はMPEG-4 Generic payloadを使う。MPEG-4 Generic payloadのコンフィグレーションは極めて複雑なので、MP4Box は常に最善のコンフィグレーションを算出する。
例：

• ISMA streaming用途のmp4作成：MP4Box -isma -hint myfile.mp4
• サーバに最適化したmp4の作成：MP4Box -hint -copy -tight myfile.mp4
• ストリーミング用にBIFS付きの複雑な mp4を作成：MP4Box -ocr -iod -hint myfile.mp4
• safe streaming用に3GP/MP4を作成：MP4Box -nosys -hint myfile.3gp

Q&As:

MPEG4IPの mp4creatorで作ったMP4ファイルを GPACにストリーミングできますか？
ケースバイケースです。mp4creator はmp3オーディオのヒント付けを、mp3 stream固有のMPA または MPA-robust payload formatで行います。GPACはMPA-robustをサポートしておらず、今後の優先度も高くありません。我々はMPEG-4 streamにはRFC3640 payloadを使う事を強く好みます（＊we strongly prefer working with＊）が、no MPA-robust payloadを使えば双方のプレイヤ・ヒンターの相互運用ができます。

MP4Boxで作ったMP4ファイルは MPEG4IP playerにストリーミングできますか？
ケースバイケースです。MPEG4IP は ISMA / plain AV ファイルと共に動作します。ですからヒンティングする前にまずファイルをISMAにコンバートするべきです。

MP4Boxで作った complex（＊複雑な、としていいのか？ ＊） MPEG-4 プレゼンテーションはどんな playerにもストリーミングできますか ???
はいでもあり、いいえでもあります。GPACはMPEG-4 systems informationのストリーミングに RFC3640 を使います。そして大半のプレイヤはこれを受け付けません（一般的には自前の独自フォーマットを使います）。さらに、RTSPサーバは現在、単純な同期の プレゼンテーションしか扱えないものとして知られており、大半の MPEG-4 presentationはこのサーバで扱うには複雑すぎる timing を持っています。詳細を知りたければforumへ参加して下さい。

-info :
-info TrackID :
-std :
-diso :
-drtp :
-dcr :
-dts :
-sdp :
-ttxt :
-ttxt TrackID :
-srt :
-srt TrackID :

-raw TrackID :
-raws TrackID :
-avi TrackID :
-nhnt TrackID :
-nhml TrackID :
-qcp TrackID :
-aviraw track :
-single TrackID :
-saf :

　MP4BoxはMPEG-4 Scene Description（＊シーン記述＊）の エンコード・デコードに使える。またさまざまなテキストベースフォーマット、 BT, XMT-A, WRL (VRML97), X3D in XML or VRML format, LASeR and SVG、の相互変換もできる。こうした変換は必ずしもうまく行くとは限らない。というのはこれらの規格間には使用するノードのセットに違いがあるからだ。

-mp4 :
-def :
-log :
-ms :
-bt :
-xmt :
-wrl :
-x3d :
-x3dv :
-lsr :
-svg :
Note :

-resolution res :
-coord-bits bits :
-scale-bits bits :
-auto-quant res :

-carousel time :
-shadow time :
-sync time :

-crypt drm_file :
-decrypt drm_file :
-set-kms [trackID=]kms_uri :

-set-meta args :

• 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 :
-rem-item args :
-set-primary args :
-set-xml args :
-rem-xml [tk=ID] :
-dump-xml args :
-dump-item args :
-package :

-nodes :
-node NodeName :
-xnodes :
-xnode NodeName :
-snodes :
-snode NodeName :
-languages :