Yamyam: 1版をインポートしました

2018-06-28T20:47:25Z

1版をインポートしました

wiki>Sato: Created page with "{{Page/Header|2.5|Doc:JA/2.5/Manual/Game Engine/Python API/Bullet physics|Doc:JA/2.5/Manual/Game Engine/Features}} =The VideoTexture module= `VideoTexture`モジュ..."

2012-02-12T12:54:59Z

Created page with "{{Page/Header|2.5|Doc:JA/2.5/Manual/Game Engine/Python API/Bullet physics|Doc:JA/2.5/Manual/Game Engine/Features}} =The VideoTexture module= <code>VideoTexture</code>モジュ..."

新規ページ

{{Page/Header|2.5|Doc:JA/2.5/Manual/Game Engine/Python API/Bullet physics|Doc:JA/2.5/Manual/Game Engine/Features}}

=The VideoTexture module=
<code>VideoTexture</code>モジュールを使うと、ゲームの実行中にテクスチャを操作できます。テクスチャに使えるソースはいくつかあります、ビデオファイル、イメージファイル、ビデオキャプチャ、メモリバッファ、カメラレンダー、またはこれらの混合です。ビデオファイルとイメージファイルは、ファイル名の代わりにURLを指定することでインターネットからロードできます。さらに、それらのイメージをGPUに送る前にフィルタを適用し、blue screen、color band、gray、normal mapなどの映像効果をかけることもできます。<code>VideoTexture</code>はイメージやビデオをロードするのにFFmpegを使用しており、FFmpegがサポートしているフォーマットは<code>VideoTexture</code>でもすべてサポートされています。以下はサポートしているフォーマットの一部です。

*AVI
*Ogg
*Xvid
*Theora
*dv1394 camera
*video4linux capture card (this includes many webcams)
*videoForWindows capture card (this includes many webcams)
*JPG
{{clr}}

==動作の仕組み==
原理は簡単です。まず、すでに存在しているテクスチャをオブジェクトと名前によって指定し、次に動的コンテントを持ったテクスチャを作成して、二つのテクスチャをGPU内で入れ替えます。ゲームエンジンはテクスチャが交換されたことには気づかず、通常通りにオブジェクトを表示します。それでいて、あなたがテクスチャをコントロールできるようになっているわけです。使用を終えると、新しいテクスチャは削除され、古いテクスチャが復帰します。

このページでは簡単な例を使って<code>VideoTexture</code>モジュールを解説します。
{{clr}}

==ゲームの準備==
<code>VideoTexture</code>モジュールを使う前に、適切なテクスチャをもったオブジェクトがなくてはいけません。

たとえば、ゲームの中に、本物の番組を流しているテレビを配置したいとします。テレビのオブジェクトを作成し、画面の部分には別個のテクスチャをUVマッピングで適用します。たとえば“<code>tv.png</code>”というテクスチャだとしましょう。このテクスチャの内容はここでは重要ではありませんが、おそらく電源が切れている画面のような、暗いグレーにすると良いでしょう。テレビの電源を入れなければならないとき、ビデオキャプチャカードからの映像を使った動的テクスチャが作成されるようにします。それを<code>tv.png</code>と入れ替えれば、テレビは本物同様になります。

<code>VideoTexture</code>が入れ替えられるテクスチャの作り方は二通りあります。
#単純なUVテクスチャ。
#テクスチャチャンネルを持ったBlenderマテリアル。

<code>VideoTexture</code>はテクスチャのレベルで動作するので、ゲームエンジンがもっている凝ったテクスチャ機能も使えます。GLSL、multi-texture、custom shadersなど。
{{clr}}

==例==
たとえば、ゲーム内のあるオブジェクトが、一つまたはそれ以上の面に対してマテリアル／イメージを適用されており、そこにビデオを表示したいとします。

最初のステップは<code>Texture</code>オブジェクトの作成です。これは一度だけ実行されるスクリプトで行うことにしましょう。ゲームがスタートした時点では、ビデオはテクスチャを更新しない限り表示されないかもしれません。これについてはあとで触れます。通常、スクリプトはビデオを表示させるオブジェクトに付加します。そうするとオブジェクトの参照を簡単に取得できます。
<source lang="python">
import VideoTexture

contr = GameLogic.getCurrentController()
obj = contr.owner

if not hasattr(GameLogic, 'video'):
</source>

“<code>video</code>”属性をチェックするのは、テクスチャの作成を一度だけにするためです。
{{clr}}

===マテリアルの取得===
<source lang="python">
matID = VideoTexture.materialID(obj, 'IMvideo.png')
</source>

<code>VideoTexture.materialID()</code>は便利な関数で、これにより<code>video.png</code>をテクスチャとして使っているマテリアルを取得します。この方法はBlenderマテリアルでもUVテクスチャでも使えます。UVテクスチャの場合は、そのテクスチャが適用されている面に付随する内部的なマテリアルを呼び出します。Blenderマテリアルの場合は、そのテクスチャを第一テクスチャとして使っているマテリアルを呼び出します。

“<code>IM</code>”の接頭辞は、探しているのがテクスチャであると示すためのものです。マテリアルの場合は“<code>MA</code>”を先頭につけます。たとえば、このオブジェクト上で<code>VideoMat</code>という名前のマテリアルを探す場合、コードは以下のようになります。
<source lang="python">
matID = VideoTexture.materialID(obj, 'MAVideoMat')
</source>
{{clr}}

===テクスチャの作成===
<code>VideoTexture.Texture</code>クラスは、動的テクスチャをGPUにロードする<code>Texture</code>オブジェクトを作成します。コンストラクタは必須の引数1つと、オプションの引数3つをとります。

;<code>gameObj</code>
:ゲームオブジェクト。

;<code>materialID</code>
:<code>VideoTexture.materialID()</code>で返されるのと同じマテリアルインデックス。0にすると最初のマテリアルになります。

;<code>textureID</code>
:複数のテクスチャが存在すす場合のテクスチャインデックス。0にすると最初のチャンネルになります。
:UVテクスチャの場合はこの値は常に0にします。

;<code>textureObj</code>
:再使用したいテクスチャを持つ<code>Texture</code>オブジェクト。
:この引数を使う場合、そのテクスチャ上にはいかなるソースも作成するべきではありません。また、テクスチャを更新する必要もありません。得られるテクスチャはマテリアルにもテクスチャにも使用できます。

<source lang="python">
GameLogic.video = VideoTexture.Texture(obj, matID)
</source>
{{clr}}

===テクスチャを永続的にする===
以前にオブジェクトに対して<code>GameLogic</code> “<code>video</code>”属性を割り当てましたが、その理由は、<code>Texture</code>はゲームの実行中に永続的でなければならないからです。ローカル変数はスクリプトの終わりで消去され、同時にGPUテクスチャも消去されます。<code>GameLogic</code>モジュールオブジェクトは永続的にしたいオブジェクトを保存するのに便利なのです。
{{clr}}

===ソースを作成する===
<code>Texture</code>オブジェクトを得ることができましたが、テクスチャのソースがないので、これだけでは何もできません。<code>VideoTexture</code>で使用可能な種類の中から、ソースオブジェクトを作成する必要があります。

;<code>VideoFFmpeg</code>
:動画。
:ビデオファイル、ビデオキャプチャ、ビデオストリーミング

;<code>ImageFFmpeg</code>
:静止画
:イメージファイル、ウェブ上のイメージ

;<code>ImageBuff</code>
:メモリ上のイメージ
:CGI、グラフィックアプリケーション

;<code>ImageViewport</code>
:ビューポートの全体または一部（つまりアクティブカメラによるレンダリングイメージ）

;<code>ImageRender</code>
:アクティブでないカメラによるレンダリングイメージ

;<code>ImageMix</code>
:上記のうちの二つ、またはそれ以上の混合

この例ではソースとしてシンプルなビデオファイルを使います。<code>VideoFFmpeg</code>コンストラクタはファイル名を引数に取ります。ファイルの場所についての混乱を避けるため、<code>GameLogic.expandPath()</code>を使ってファイルのフルパスを取得します。ここでビデオファイルは.blendファイルと同じディレクトリにあるとします。
<source lang="python">
movie = GameLogic.expandPath('//trailer_400p.ogg')
GameLogic.video.source = VideoTexture.VideoFFmpeg(movie)
</source>

ビデオソースオブジェクトを作ったら、それを<code>Texture</code>オブジェクトの<code>source</code>属性に割り当てることで、ソースのセットアップと永続化を行います。ソースオブジェクトそのものも永続的になります。

<code>Texture</code>のソースはいつでも変更できます。たとえばゲームの進行中に二つの映像を切り替えたい場合、以下のようにします。
<source lang="python">
GameLogic.mySources[0] = VideoTexture.VideoFFmpeg('movie1.avi')
GameLogic.mySources[1] = VideoTexture.VideoFFmpeg('movie2.avi')
</source>

そして実行中に再割り当てします。
<source lang="python">
GameLogic.video.source = GameLogic.mySources[movieSel]
</source>
{{clr}}

===ソースのセットアップ===
<code>VideoFFmpeg</code>ソースはムービーの再生をコントロールする属性がいくつかあります。

;<code>range</code>
:[start,stop] (''floats'').
:ビデオの再生範囲。始めからの秒数で指定します。デフォルトではビデオ全体です。

;<code>repeat</code>
:(''integer'').
:リピート回数。-1で無制限にリピートします。

;<code>framerate</code>
:(''float'').
:相対的なフレームレート。1.0より小さくすると遅くなり、大きくすると速くなります。

;<code>scale</code>
:(''bool'').
:Trueにすると高速なニアレストネイバーアルゴリズムで拡大します。
:テクスチャに使うビデオの幅と高さは2の乗数でなければいけません。そうでない場合、指定した方法でスケーリングされます。デフォルトでは正確ですが遅い<code>gluScaleImage()</code>関数を使います。一番良いのは最初からビデオを適切な大きさにしておくことです。そうすれば実行時にはスケーリングの必要がなくなります。

;<code>flip</code>
:(''bool'').
:Trueにするとイメージは上下に反転されます。
:FFmpegからのイメージは常に上限判定している状態なので、この属性はデフォルトでTrueになっています。

;<code>filter</code>
:ビデオをGPUに送る前にフィルタを適用します。
:<code>VideoTexture</code>フィルタオブジェクトのうちのひとつを指定します。デフォルトではイメージは何も変更されずにGPUに送られます。ビデオにアルファチャンネルが存在している場合は、それは自動的にロードされてGPUに送られます。

ここでは<code>scale</code>属性をTrueにしましょう。なぜなら<code>gluScaleImage()</code>は本当に遅くて、リアルタイムビデオには向いていないからです。ビデオの縦横がもともと2の乗数になっている場合は、この設定は何の影響もありません。
<source lang="python">
GameLogic.video.source.scale = True
</source>
{{clr}}

===Play the video===
これでビデオを再生する準備ができました。
<source lang="python">
GameLogic.video.source.play()
</source>

ビデオの再生はバックグラウンドプロセスではありません。テクスチャを更新して初めて再生されます。よって、毎フレーム実行されるスクリプトで<code>Texture</code>オブジェクトのcode>refresh()</code>メソッドを呼び出す必要があります。
<source lang="python">
if hasattr(GameLogic, 'video'):
GameLogic.video.refresh(True)
</source>

ビデオソースが停止している場合は、<code>refresh()</code>は何の効果もありません。<code>refresh()</code>の引数は、テクスチャを再計算する必要があるかどうかを指定するフラグです。ビデオ再生の場合は、あきらかにTrueでしょう。
{{clr}}

===ビデオのステータスをチェックする===

ビデオソースクラス（VideoFFMpegなど）は<code>status</code>という属性を持っています。ビデオが再生中の場合、この値は2です。停止している場合は3です。よっで今回の例では、
<source lang="python">
if GameLogic.video.source.status == 3:
#ビデオは止まっている
</source>

===高度なワークフロー===
<code>Texture.refresh()</code>メソッドでTrueを指定すると、一度GPUに送られたイメージは次のフレームでは無効化され、ソースから新しくロードされます。このやり方では、Pythonでイメージが使用できなくなるという副作用があります。よってソースの<code>refresh()</code>メソッドを手動で呼び出すという方法もあります。

高度なワークフローの例は以下のようになります。
*Pythonでイメージバッファを使う（テクスチャには影響しない）:
<source lang="python">
GameLogic.video.refresh(False)
image = GameLogic.video.source.image
# imageはRGBAピクセルのバイナリ列
# ... imageを使う
# 次のフレームのため無効にする
GameLogic.video.source.refresh()
</source>

*Pythonで使うため、GPUにはダウンロードせずにイメージをソースからロードする:
# テクスチャのほうのrefreshを呼んでいないことに注意
# テクスチャオブジェクトを使わずにソースオブジェクトだけを作成することもできます
<source lang="python">
image = GameLogic.video.source.image
# ... imageを使う
GameLogic.video.source.refresh()
</source>

*もしメッシュに適用されているマテリアルが二つ以上あり、特定のマテリアルのテクスチャを修正したい場合、マテリアルのIDを取得します。
<source lang="python">
matID=VideoTexture.materialID(gameobj,"MAmat.001")
</source>
GLSLマテリアルは2チャンネル以上のテクスチャを持つことができます。テクスチャはテクスチャスロットの順番に応じて特定されます。ここでは2としましょう。
<source lang="python">
tex=VideoTexture.Texture(gameobj, matID, 2)
</source>
{{clr}}

===デモのダウンロード===
[http://home.scarlet.be/~tsi46445/blender/VideoTextureDemo.zip デモファイル]をダウンロードできます。
{{clr}}
[[Category:Script]]

==高度なデモ==
[http://www.graphicall.org/ftp/ben2610/VideoTextureDemo2video.blend このデモ]は、同じテクスチャ上で二つのビデオを交互に使うデモンストレーションです。このデモを使うにはelephant dreamの予告編（teaser）のビデオファイルが必要です。他のファイルで置き換えることもできます。

[http://www.graphicall.org/ftp/ben2610/VideoTextureDemo2videoMix.blend このデモ]は<code>ImageMix</code>ソースを使ったデモンストレーションです。<code>ImageMix</code>は他の<code>Texture</code>ソースを必要とします。たとえば<code>VideoFFmpeg</code>、<code>ImageFFmpeg</code>、<code>ImageRender</code>など。これらのソースを<code>setSource()</code>でセットして、<code>setWeight()</code>でそれぞれの相対的な重みを設定します。重みは0から255で、すべてのソースの重みの合計が255にならなければいけません。<code>ImageMix</code>はすべてのソースを重みに応じて合成します。元になる複数のソースは、すべて同じサイズ（一番近い2の乗数にスケーリングされた後で）でなけれはいけません。そうでない場合、コンソールでPythonのエラーが出ます。

{{clr}}

{{Page/Footer|Doc:JA/2.5/Manual/Game Engine/Python API/Bullet physics|Doc:JA/2.5/Manual/Game Engine/Features}}

[[Category:Game engine]]
[[Category:Python]]
[[Category:API's]]

← 古い版	2018年6月28日 (木) 20:47時点における版
(相違点なし)

Doc:JA/2.6/Manual/Game Engine/Python API/VideoTexture - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Sato: Created page with "{{Page/Header|2.5|Doc:JA/2.5/Manual/Game Engine/Python API/Bullet physics|Doc:JA/2.5/Manual/Game Engine/Features}} =The VideoTexture module= VideoTextureモジュ..."

Yamyam: 1版をインポートしました

wiki>Sato: Created page with "{{Page/Header|2.5|Doc:JA/2.5/Manual/Game Engine/Python API/Bullet physics|Doc:JA/2.5/Manual/Game Engine/Features}} =The VideoTexture module= `VideoTexture`モジュ..."