GPU Shader Module(gpu)の翻訳

カテゴリ：blender

このモジュールは Python から GPU を扱うためのラッパーを提供する。より抽象度の高い機能は gpu_extras モジュールにある。

以下のサブモジュールがある。

GPU Types(gpu.types)
GPU Shader(gpu.shader)
GPU Matrix(gpu.matrix)
GPU Select(gpu.select)

ジオメトリバッチ

ジオメトリはバッチ処理される。バッチには描画に必要なデータを格納する必要がある。頂点バッファは常に必要となるが、インデックスバッファはなくてもよい。それらは今後のセクションで解説する。バッチは描画タイプも指定する。典型的な描画タイプは点（POINTS）、線（LINES）、三角形（TRIS）だ。描画タイプはデータの解釈方法と描画方法とを決めるのに使われる。

頂点バッファ

頂点バッファオブジェクト（VBO）（gpu.types.GPUVertBuf）はシェーダの描画に必要な情報を格納する。位置・法線・色・UV 等がよく使われる。頂点バッファはそれぞれ頂点フォーマット（gpu.types.GPUVertFormat）と、バッファ内の頂点数を指定する長さパラメータを持つ。頂点フォーマットは頂点ひとつあたりのデータの解釈方法を記述する。

以下のコードは６つの頂点を含む頂点バッファの作成方法を示している。頂点それぞれに位置と法線との情報を格納している。

import gpu
vertex_positions = [(0, 0, 0), ...]
vertex_normals = [(0, 0, 1), ...]

fmt = gpu.types.GPUVertFormat()
fmt.attr_add(id="pos", comp_type='F32', len=3, fetch_mode='FLOAT')
fmt.attr_add(id="normal", comp_type='F32', len=3, fetch_mode='FLOAT')

vbo = gpu.types.GPUVertBuf(len=6, format=fmt)
vbo.attr_fill(id="pos", data=vertex_positions)
vbo.attr_fill(id="normal", data=vertex_normals)

この頂点バッファは６つの点、３つの独立した線、５つの連続した線、２つの独立した三角形等のどれかを描画できる。頂点バッファがどのようなポリゴンとしてレンダリングされるかはバッチ作成時に指定する。

インデックスバッファ

三角形や線がひとつ以上の頂点を共有することはよくある。頂点バッファのみでこれをレンダリングする場合、同じ頂点属性を複数回複製する必要がある。これは効率が悪い。なぜなら閉じた三角形メッシュは、平均して６回同じ頂点が使われるからだ。このような場合はインデックスバッファ（IBO）（gpu.types.GPUIndexBuf）（エレメントバッファ）を使うと効率的だ。インデックスバッファは頂点バッファ内の頂点を指すインデックスを格納する配列だ。

例えば、ふたつの三角形からなる四角形を描画するとき、以下のようにしてインデックスバッファを利用できる。

positions = (
    (-1, 1), (1, 1),
    (-1, -1), (1, -1))

indices = ((0, 1, 2), (2, 1, 3))
ibo = gpu.types.GPUIndexBuf(type='TRIS', seq=indices)

indices の最初のタプルは最初の三角形がどの頂点を使っているかを示している。対角線の頂点１と２とがふたつの三角形で共有されていることに注目してほしい。

シェーダ

シェーダは GPU で実行されるプログラムだ。Blender では GLSL を使って書く。シェーダにはいくつかの種類がある。最も重要なものは頂点シェーダとフラグメントシェーダだ。普通、複数のシェーダはプログラム（Program）にまとめられる。しかし、Blender Python API ではシェーダは OpenGL プログラムを指す。すべての gpu.types.GPUShader は頂点シェーダ・フラグメントシェーダ・オプションのジオメトリシェーダからなる。よく使う描画タスクは gpu.shader.from_builtin にあるシェーダが使える。それには 2D_UNIFORM_COLOR や 3D_FLAT_COLOR のような識別子がついている。

すべてのシェーダは、シェーダ内で使用できる属性（attributes）や uniforms を定義できる。属性は頂点バッファから設定され、個別の頂点とは異なっている。uniforms はドローコール（draw call）ごとに設定できる定数だ。uniforms はシェーダがバインドされた後で、shader.uniform_* 関数を使って設定できる。

バッチの作成

バッチの作成には頂点バッファとインデックスバッファとが必要になる。しかし gpu_extras.batch.batch_for_shader 関数の使用を推奨する。それはシェーダが要求する頂点の属性が存在することを自動で検証してくれる。batch_for_shader が引数にシェーダを要求するのはそれが理由だ。

バッチは可能ならばキャッシュしておいて再利用すべきだ。