概要
Movie File In TOPは、ムービー、イメージ、またはイメージのシーケンスをTOPに読み込みます。 .jpg、.gif、.tif、または.bmp形式のイメージを読み込みます。 QuickTimeの.mov、.mp4、.mpg、.mpeg、.avi、.wmv、.dpx、CineformおよびHap Q（Hap Q with Alphaを含む）のムービーファイルを読み取ります。
また、NotchLCコーデック、EXRファイル（.exr）、一部の.swfおよび.flv Flashファイル、DXT1、3、および5の圧縮.DDSファイルもサポートしています。 イメージやムービーは、http：//を使用してURLを指定することにより、ウェブから取得することもできます。
TuneページのHardware Decodeパラメーターを使用して、Nvidia GPUのハードウェアデコーダーにアクセスします。 これは、16ビットピクセルチャネルに変換された、サポートハードウェア上の10および12ビットH264 / H265およびYUV 444ファイルをサポートします。
10ビット/ 16ビット/ 32ビットなどのより高いビット深度をサポートするファイル形式を読み込む場合、CommonページのPixel FormatメニューがUse Inputである限り、適切なピクセル形式が自動的に使用されます。 例えば、16ビットのファイルでは、各ピクセルがカラーチャネルごとに16ビットを自動的に持つようになります。
詳細なフォーマットのリストについては、File Typesの章を参照してください。
TOPにムービーファイルの状態を確認するには、それにInfo CHOPを接続します（Info CHOPを参照）。 これにより、ムービーの長さ、解像度、秒間フレーム数、オーディオの有無などの情報が表示されます。 また、ムービーのオープンステータス、現在のフレーム、先読みフレームとキューサイズ、ドロップされたフレームカウント、CPUデコード時間、GPUアップロード時間などの動的な情報も表示されます。
Movie File In TOPの最適化についてMovie Playbackの章、およびHap、Movie File Out TOP およびCineformの章も参照してください。
パラメータ – Play ページ
File / file
読み込むイメージまたはムービーのパスとファイル名を設定します。イメージやムービーの形式は、File Typesの章に記載されているものを使用します。 http：// …を使用してインターネット上のファイルを指定することができます。
イメージを置いたフォルダを 1 つのムービーのように扱うには、ファイル名の代わりに画像を含むフォルダを指定します。すべてのファイルは同じ解像度でなければなりません。そのフォルダ内のすべての静止画/動画をそれぞれがムービーの1フレームであるかのように扱います。イメージの順番は英数字で指定します。デフォルトでは、ファイル名に関わらず、1枚目のイメージのインデックスは0、2枚目は1となります。
Trimパラメータページでサンプルレートを上書きすると、任意のフレームレートでイメージシーケンスを再生できます。
イメージ シーケンスを含むフォルダでinfo.xmlファイルを使用すると、1秒あたりのフレーム数と、シーケンスで使用するオーディオファイルを指定できます。
URLを使用して、イメージやムービーを取得できます。 イメージまたはムービーがユーザーのDerivative tempフォルダにダウンロードされ、Movie File In TOPに読み込まれます。
Reload / reload
0から1に変更（offからon）すると、イメージを強制的にリロードします。これは、ファイルが変更されたか、最初は存在しなかった場合に役立ちます。
Reload Pulse / reloadpulse
リロードパルスを送信します。
Play Mode / playmode
ムービーの再生に使用する方法を設定します。3つのオプションがあります。
- Locked to Timeline / locked
このモードは、ムービーの位置をタイムラインにロックします。 タイムラインでスクラブまたはジャンプすると、それに応じてムービーの再生位置が変わります。 このモードでは、タイムラインがムービーの再生位置に直接関連付けられているため、Play、Reset、Speed、Indexの各パラメーターは無効になります。
- Specify Index / specify
このモードでは、ユーザーは以下のIndexパラメーターを使用して、ムービー内の特定の位置を指定再生できます。 このモードを使用して、ムービーの任意の場所にランダムにアクセスします。
- Sequential / sequential
このモードは、タイムラインの位置に関係なく継続して再生されます（Index パラメータは無効）。以下のResetとSpeedパラメータが有効になり、ある程度のコントロールが可能になります。
Play / play
1で再生、0で停止します。
Speed / speed
これは、Play ModeがSequentialの場合にのみ機能するスピード倍率です。1はデフォルトの再生速度です。値が2の場合は倍速、0.5の場合は半速となります。マイナスの値を設定すると、ムービーは逆再生されます。
Cue / cue
1に設定すると、Cue Pointで設定したインデックスにジャンプします。Play ModeがSequentialの場合にのみ使用できます。
Cue Pulse / cuepulse
キュー パルスを送信します。
Cue Point / cuepoint
ムービー内の任意のインデックスをジャンプ先として設定します。
Cue Point Unit / cuepointunit
Cue Pointパラメータの単位を設定します。
Cue Behavior / cuebehavior
Cueパラメータの動作をカスタマイズします。
- On Release, Repeat Cued Frame / repeat
キューパラメータをリリースすると、すぐに次のフレームが再生されます。
- On Release, Play Next Frame / play
キューパラメータをリリースすると、最初にCue Pointのフレームから再生してから、次のフレームの再生を続けます。
Index / index
このパラメータは、Play ModeがSpecify Indexに設定されている場合に、ムービーの再生位置を明示的に設定します。右側の単位メニューでは、Index Unitの単位でインデックスを指定することができます。単位はIndex, Frames, Seconds, Fraction (パーセンテージ)です。例えば、内部的に25fpsのムービーと60fpsのタイムラインがあるとします。Units を Index に設定し、パラメータ値を 25 に設定すると、ムービーの 1 秒目のイメージが表示されます。Units を Frames に設定し、パラメータ値を 60 に設定すると、同じく、ムービーの 1 秒目のイメージが表示されます。
Index Unit / indexunit
Indexパラメータの単位を設定します。
Loop Crossfade / loopcrossfade
ムービーの開始点と終了点をクロスフェードして、ループするときにスムーズなトランジションを作ります。ムービーが Trim オプションを使用している場合、Trim Start と Trim End の位置をクロスフェードします。
Loop Crossfade Unit / loopcrossfadeunit
Loop Crossfadeパラメータの単位を設定します。
Step Size / stepsize
次のフレームを表示する前にスキップするフレーム数を設定します。 たとえば、StepSizeが30の場合、30フレームごとに表示されます。 この動画再生のタイミングは変化しないため、ステップサイズが30、サンプルレートが30の場合、新しいフレームが毎秒表示されます。
Audio Loop / audioloop
このメニューは、ムービーの終了点に近づいてきたとき、オーディオをどのように扱うかを設定します。これは、Play ModeをIndexに設定している時のように、ムービーを再生する多くの場合、TOPはループするかどうかを判断しないため、必要なメニューです。
- Silence / silence
ムービーが終了するとオーディオは無音になります。
- Fade / fade
ムービーが終了するとオーディオはフェードアウトします。
- Match Start to End / match
タイムラインのStartとEndに合わせます。
Image Sequence Indexing / imageindexing
イメージ シーケンスの順序付け方法を設定します。
- Zero Based / zero
英数字順に並べ替えた後、0から始まるイメージのシーケンスにインデックスを付けます。
- Filename Based / filename
ファイル名の最後にある番号を使用して、イメージのシーケンスにインデックスを付けます。 例えば、flower400.tiffという名前のファイルは、その前のフォルダに他のファイルがあるかどうかに関係なく、フレームインデックス400になります。
パラメータ – Image ページ
Interpolate Frames / interp
正確な時間に基づいてフレーム間を補間します。例えば、インデックス（フレーム数）が1.5であれば、フレーム1とフレーム2は半々でブレンドされます。インデックスが1.7であれば、フレーム1の30%とフレーム2の70%がブレンドされます。
Deinterlace / deinterlace
フィールドとして保存されるムービーの場合、各イメージは2つのイメージが交互にインターリーブされて構成されます。 1秒あたり30フレームのムービーには、1秒あたり60フィールドが含まれます。 各ムービーについて、1番目のフィールドの偶数走査線は、2番目のフィールドの奇数走査線と交互配置されます。 Movie File In TOPはこれに対処するいくつかの方法を持っています：
- Off / off
ムービーをそのまま出力します。
- Even / even
イメージの偶数のスキャンラインだけを取り、偶数のスキャンラインの間を補間して奇数のスキャンラインを作成します。(歴史的な理由から、走査線 0 はインターレース解除のために画像の一番上にあります)。
- Odd / odd
イメージの奇数のスキャンラインだけを取り、奇数のスキャンラインの間を補間して遇数のスキャンラインを作成します。
Field Precedence / precedence
フィールドが一度に1つずつ抽出される場合、デフォルトでは偶数フィールドが最初に抽出されます。それ以外の場合は、奇数フィールドが最初に抽出されます。 ビデオ業界はどちらか一方を標準化していません。
Bottom Half is Alpha (AAA) / bottomhalfalpha
有効にすると、イメージ/ムービーの高さが半分になり、下半分のピクセルからのRチャネルが上半分のアルファチャネルであるかのように処理されます。 イメージ フォーマットがアルファをネイティブにサポートしていない場合に役立ちます。
Multiply RGB by Alpha / multalpha
イメージを事前に倍数化します。
- Off / off
- On / on
- Automatic / automatic
Input is sRGB / inputsrgb
入力画像が 8 ビットで sRGB 色空間の場合は、そのように扱うことができるようにします。
Loading/Error Image / loadingerrorimage
- Colored Bottom Right Square / coloredbottomright
- Zero / zero
パラメータ – Trim ページ
Trim / trim
Trim操作を有効にします。
Trim Start / tstart
トリムする開始点を設定します。
Trim Start Unit / tstartunit
Trim Startパラメータの単位を設定します。
Trim End / tend
トリムする終了点を設定します・
Trim End Unit / tendunit
Trim Endパラメータの単位を設定します。
Extend Left / textendleft
Movie File In TOPがTrim Start フレームより前にあるムービー位置を処理する方法を設定します。 たとえば、Trim Startが1に設定されていて、ムービーの現在のインデックスが-10の場合、Extend Leftメニューでムービーの再生位置の計算方法を設定します。
- Hold / hold
Trim Start以前のフレームについては、ムービー範囲の最初のフレーム（Trim Startで設定したフレーム）を表示します。
- Cycle / cycle
Trim Start以前のフレームについては、ムービー範囲を継続的にループします。
- Mirror / mirror
ムービー範囲をジグザグパターンでループします。 たとえば、Trim Startのフレームから逆方向に再生すると、ムービーはTrim Endに向かって再生し、その後、再びTrim Startに向かって再生し、ムービーが逆方向に再生される間、ジグザグ（ミラー）の再生を続けます。
- Black / black
Trim Start以前のフレームについては、黒いイメージを表示します。
- Zero / zero
Trim Start以前のフレームについては、イメージが無い状態になります。
Extend Right / textendright
Movie File In TOPがTrim End フレームより後にあるムービー位置を処理する方法を設定します。たとえば、Trim End が20に設定されていて、ムービーの現在のインデックスが25の場合、Extend Rightメニューでムービーの再生位置の計算方法を設定します。
- Hold / hold
Trim End以降のフレームについては、ムービー範囲の最後のフレーム（Trim Endで設定したフレーム）を表示します。
- Cycle / cycle
Trim End以降のフレームについては、ムービー範囲を継続的にループします。
- Mirror / mirror
ムービー範囲をジグザグパターンでループします。 たとえば、Trim Endのフレームから順方向に再生すると、ムービーはTrim Startに向かって再生し、その後、再びTrim Endに向かって再生し、ムービーが再生される間、ジグザグ（ミラー）の再生を続けます。
- Black / black
Trim End以降のフレームについては、黒いイメージを表示します。
- Zero / zero
Trim End以降のフレームについては、イメージが無い状態になります。
Override Sample Rate / overridesample
サンプルレートをオーバーライドします。
Sample Rate / samplerate
オーバーライドするサンプルレートを設定します。
パラメータ – Tune ページ
Pre-Read Frames / prereadframes
TouchDesignerが先に読み込んでメモリに保存するビデオフレーム数を設定します。これにより、フレームの1部でデコードに時間がかかりすぎたり、他のリソースがハードドライブにアクセスしたり、ムービーがループしたことで、再生時にフレームが飛んだり、フレームがカタついたりするのを防ぐことができます。イメージ シーケンスを読み込む際に、より多くのプリリードフレームを設定することで、複数の画像を同時にデコードすることができます。これにより、マシンに十分な CPU コアがあれば、.exr のような重いファイル形式をリアルタイムで再生することができます。
Frame Read Timeout / frametimeout
TouchDesignerがハードドライブからのフレーム読み込みを待つ時間（ミリ秒単位）を設定します。ディスク読み取りのタイムアウト時間に達すると、そのフレームはスキップされます。これは、http:// を介してダウンロードするネットワークファイルにも適用されます。
Always Load Initial Frame / alwaysloadinitial
このパラメータをオンにすると、最初にロードされたフレームでは、Frame Read Timeoutは無視され、ノードが常に有効なイメージで起動するように、常に最初のフレームを待ちます。
File Open Timeout / opentimeout
TouchDesignerがムービーを開くまでの待ち時間をミリ秒単位で設定します。ディスクを開くタイムアウトに達すると、TOPのムービーファイルは待機を停止し、右下にグレーの四角が入った真っ黒なイメージになります。TOPが次にcookしてもファイルが開かない場合は、再度待機して同じことをします。これは、ファイルが開かれるか、開かないかのどちらかになるまで、この動作を続けます。
On Timeout, use Latest Avail / uselatestontimeout
オンの場合、ディスク読み取りタイムアウトに達すると、TouchDesignerはスキップされたフレームの代わりに、利用可能な最新のフレームを使用します。
Use Global CPU Cache / usecpucache
CPUキャッシュを使用して、画像をメインメモリに格納します。 Global CPU Cacheのサイズは、Edit> Preferences> TOPで設定します。 このCPUキャッシュは、単一のムービーをループするような非常に特殊な状況でのみ機能します。 ムービーのフレームをCPUキャッシュに格納しますが、ムービー全体がキャッシュに収まる必要があります。そうしないと、プッシュされます。 この機能を定期的に使用することはありません。使用する必要があると思われる場合は、詳細についてサポートに連絡することをお勧めします。
Async Upload to GPU / asyncupload
有効にすると、OpenGL機能を使用して、非同期的にGPUにムービーイメージをアップロードします。これにより、Movie File In TOPのcook時間が大幅に短縮されます（パフォーマンスモニターでは、Uploading Image to GPUと書かれている行はほぼゼロになります）。ただし、この機能を使用するにはGPUメモリコストがかかります。この機能を使用すると、GPUメモリをさらに(幅×高さ×4×先読みサイズ)バイト消費してしまいます。この機能を使用してもうまくいかない場合は、グラフィックドライバが最新のものであることを確認してください。
Update Image / updateimage
0に設定すると画像は更新されません。 ムービーのインデックスは進み続けますが、出力されるイメージは更新されません。これは、Movie Audio CHOPを使ってムービーから音声を取得しているが、ビデオは使用しない場合に便利です。
Max Decode CPUs / maxdecodecpus
H264 / H265やCineformなど、マルチCPUデコードが可能な特定のビデオコーデックのデコードに使用するCPUの最大数を制限します。 これはイメージシーケンス再生のマルチスレッドデコードには影響せず、代わりにPre-Read Frameパラメーターを増やすことで制御されることに注意してください。
High Performance Read / highperfread
高解像度(4K以上)のHAP Qファイルなど、SSDの読み込み速度が非常に速いファイルを再生する場合に使用します。このような場合、読み込みパフォーマンスが大幅に向上します。1080p H264 ファイルのような低解像度または低データレートのファイルには使用しないでください。
High Performance Read Factor / highperfreadfactor
High Performance Readを行う場合、このパラメータはディスク上で行われるリード操作のサイズを制御します。コーデックが実行するように要求する最大の操作が何であれ、読み取り係数に乗算され、後続のすべての読み取りは、代わりにその分のデータを先行して読み取ることになります。これは、ドライブによってはより高いスループットをもたらす可能性があります。例えば、1MB の読み込みを要求され、読み込み係数が 3 に設定されている場合、ディスクから 3MB 読み込み、余分に読み込んだ 2MB分が次のフレームの準備が完了し、CPU RAM には次の 2 フレームが既に利用可能な状態になっている可能性があります。
パラメータ – Common ページ
参照：共通 Common ページ
