XR8.GlTextureRenderer.create()
XR8.GlTextureRenderer.create({ GLctx, vertexSource, fragmentSource, toTexture, flipY, mirroredDisplay })
概要
テクスチャからキャンバスや別のテクスチャにレンダリングするためのオブジェクトを作成します。
パラメータ
パラメータ | タイプ | デフォルト | 説明 |
---|---|---|---|
GLctx | WebGlRenderingContext または WebGl2RenderingContext | レンダリングに使用する WebGlRenderingContext (または WebGl2RenderingContext ) toTexture が指定されていない場合、このコンテキストのキャンバスに描画されます。 | |
vertexSource [Optional] | String | A no-op vertex shader | レンダリングに使用するバーテックスシ ェーダーソースです。 |
fragmentSource [Optional] | String | A no-op fragment shader | レンダリングに使用するフラグメントシェーダーソースです。 |
toTexture [Optional] | WebGlTexture | GLctx キャンバス | 描画するテクスチャです。 テクスチャを指定しない場合は、キャンバスへの描画となります。 |
flipY [Optional] | Boolean | false | trueの場合、レンダリングを上下反転させます。 |
mirroredDisplay [Optional] | Boolean | false | trueの場合、レンダリングを左右に反転させます。 |
戻り値
以下のオブジェクトを返します。 {render, destroy, shader}
プロパティ | 説明 |
---|---|
render({ renderTexture, viewport }) | 指定されたビューポートにレンダーテクスチャをレンダリングする関数です。 toTexture が渡されるかに応じて、ビューポートは GLctx を作成したキャンバス上にあるか、提供されたレンダーテクスチャに相対的であるかのどちらかになります。 |
destroy | この GlTextureRenderer に関連するリソースを解放します。 |
shader | テクスチャの描画に使用されているシェーダーハンドルを取得します。 |
render
関数は、以下のパラメータを持ちます。
パラメータ | 説明 |
---|---|
renderTexture | WebGlTexture (ソース)を描画します。 |
viewport | 描画するキャンバスまたは出力テクスチャの領域です。これは手動で構築するか、 XR8.GlTextureRenderer.fillTextureViewport() を使用して構築することができます。 |
ビューポートは、 { width, height, offsetX, offsetY } で指定します。
プロパティ | タイプ | 説明 |
---|---|---|
width | Number | 描画する幅(ピクセル単位)です。 |
height | Number | 描画する高さ(ピクセル単位)です。 |
offsetX [Optional] | Number | 描画する最小のX座標(ピクセル単位)です。 |
offsetY [Optional] | Number | 描画するY座標の最小値(ピクセル単位)です。 |