Qt GUIにおけるQOpenGLExtraFunctions::glSamplerParameteri()のトラブルシューティング

Qt GUIにおけるQOpenGLExtraFunctions::glSamplerParameteri()の解説

サンプラーオブジェクトは、テクスチャからテクセルを取得する方法を定義するOpenGLオブジェクトです。サンプラーオブジェクトは、テクスチャのどの部分を使用するか、どのようにフィルタリングするか、どのようにラップするかなどを設定することができます。

glSamplerParameteri()関数は、サンプラーオブジェクトのパラメータを設定するために使用されます。この関数は以下の引数を取ります。

• sampler: 設定するサンプラーオブジェクト
• pname: 設定するパラメータの名前
• param: パラメータの値

設定可能なパラメータ

glSamplerParameteri()関数で設定可能なパラメータは以下の通りです。

• GL_TEXTURE_MAG_FILTER: 拡大時のフィルタリング方法
• GL_TEXTURE_WRAP_S: テクスチャ座標S方向のラップ方法
• GL_TEXTURE_COMPARE_MODE: テクスチャ比較のモード
• GL_TEXTURE_COMPARE_FUNC: テクスチャ比較の比較関数

例

以下のコードは、サンプラーオブジェクト sampler の拡大時のフィルタリング方法をGL_LINEARに設定します。

QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_MAG_FILTER, GL_LINEAR);

補足

• glSamplerParameteri()関数は、OpenGL 3.0以降で使用できます。
• Qt GUIでOpenGLを使う場合は、QOpenGLWidgetクラスやQOpenGLWindowクラスを使用する必要があります。
• QOpenGLExtraFunctionsクラスの詳細については、Qtの公式ドキュメントを参照してください。

Qt GUIにおけるQOpenGLExtraFunctions::glSamplerParameteri()のサンプルコード

テクスチャの拡大・縮小時のフィルタリング

// テクスチャオブジェクトを作成
QOpenGLTexture texture;
texture.load("image.png");

// サンプラーオブジェクトを作成
QOpenGLSampler sampler;

// サンプラーオブジェクトのパラメータを設定
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_MIN_FILTER, GL_LINEAR);

// テクスチャをバインド
texture.bind();

// サンプラーオブジェクトをバインド
sampler.bind(0);

// テクスチャを描画
glBegin(GL_TRIANGLES);
glTexCoord2f(0.0f, 0.0f); glVertex3f(-1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 0.0f); glVertex3f( 1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 1.0f); glVertex3f( 1.0f,  1.0f, 0.0f);
glTexCoord2f(0.0f, 1.0f); glVertex3f(-1.0f,  1.0f, 0.0f);
glEnd();

// テクスチャとサンプラーオブジェクトのバインドを解除
texture.release();
sampler.release();

テクスチャ座標のラップ方法

// テクスチャオブジェクトを作成
QOpenGLTexture texture;
texture.load("image.png");

// サンプラーオブジェクトを作成
QOpenGLSampler sampler;

// サンプラーオブジェクトのパラメータを設定
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_WRAP_S, GL_REPEAT);
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_WRAP_T, GL_REPEAT);

// テクスチャをバインド
texture.bind();

// サンプラーオブジェクトをバインド
sampler.bind(0);

// テクスチャを描画
glBegin(GL_TRIANGLES);
glTexCoord2f(0.0f, 0.0f); glVertex3f(-1.0f, -1.0f, 0.0f);
glTexCoord2f(2.0f, 0.0f); glVertex3f( 1.0f, -1.0f, 0.0f);
glTexCoord2f(2.0f, 2.0f); glVertex3f( 1.0f,  1.0f, 0.0f);
glTexCoord2f(0.0f, 2.0f); glVertex3f(-1.0f,  1.0f, 0.0f);
glEnd();

// テクスチャとサンプラーオブジェクトのバインドを解除
texture.release();
sampler.release();

このコードは、テクスチャ "image.png" のテクスチャ座標S方向とT方向のラップ方法を GL_REPEAT に設定して描画します。

テクスチャ比較

// テクスチャオブジェクトを作成
QOpenGLTexture texture;
texture.load("image.png");

// サンプラーオブジェクトを作成
QOpenGLSampler sampler;

// サンプラーオブジェクトのパラメータを設定
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_COMPARE_MODE, GL_COMPARE_REF_TO_TEXTURE);
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_COMPARE_FUNC, GL_LEQUAL);

// テクスチャをバインド
texture.bind();

// サンプラーオブジェクトをバインド
sampler.bind(0);

// テクスチャを描画
glBegin(GL_TRIANGLES);
glTexCoord2f(0.0f, 0.0f); glVertex3f(-1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 0.0f); glVertex3f( 1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 1.

Qt GUIにおけるQOpenGLExtraFunctions::glSamplerParameteri()のその他の方法

QOpenGLShader::setUniform()関数を使う

// シェーダープログラムを作成
QOpenGLShaderProgram program;
program.addShaderFromSourceFile(QOpenGLShader::Vertex, "vertex.glsl");
program.addShaderFromSourceFile(QOpenGLShader::Fragment, "fragment.glsl");
program.link();

// サンプラーオブジェクトを作成
QOpenGLSampler sampler;

// サンプラーオブジェクトのパラメータを設定
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
QOpenGLExtraFunctions::glSamplerParameteri(sampler, GL_TEXTURE_MIN_FILTER, GL_LINEAR);

// テクスチャオブジェクトを作成
QOpenGLTexture texture;
texture.load("image.png");

// テクスチャとサンプラーオブジェクトをバインド
texture.bind();
sampler.bind(0);

// シェーダープログラムを有効化
program.bind();

// シェーダープログラムにテクスチャとサンプラーオブジェクトを渡す
program.setUniformValue("texture", 0);
program.setUniformValue("sampler", 0);

// テクスチャを描画
glBegin(GL_TRIANGLES);
glTexCoord2f(0.0f, 0.0f); glVertex3f(-1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 0.0f); glVertex3f( 1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 1.0f); glVertex3f( 1.0f,  1.0f, 0.0f);
glTexCoord2f(0.0f, 1.0f); glVertex3f(-1.0f,  1.0f, 0.0f);
glEnd();

// シェーダープログラムとテクスチャ、サンプラーオブジェクトのバインドを解除
program.release();
texture.release();
sampler.release();

このコードは、QOpenGLShader::setUniform()関数を使って、サンプラーオブジェクトのパラメータ GL_TEXTURE_MAG_FILTER と GL_TEXTURE_MIN_FILTER を GL_LINEAR に設定します。

QOpenGLContext::functions()関数を使って、glSamplerParameteri()関数へのポインタを取得することができます。

// サンプラーオブジェクトを作成
QOpenGLSampler sampler;

// QOpenGLContext::functions()を使ってglSamplerParameteri()関数へのポインタを取得
QOpenGLFunctions *functions = QOpenGLContext::currentContext()->functions();

// glSamplerParameteri()関数を呼び出す
functions->glSamplerParameteri(sampler, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
functions->glSamplerParameteri(sampler, GL_TEXTURE_MIN_FILTER, GL_LINEAR);

// テクスチャオブジェクトを作成
QOpenGLTexture texture;
texture.load("image.png");

// テクスチャとサンプラーオブジェクトをバインド
texture.bind();
sampler.bind(0);

// テクスチャを描画
glBegin(GL_TRIANGLES);
glTexCoord2f(0.0f, 0.0f); glVertex3f(-1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 0.0f); glVertex3f( 1.0f, -1.0f, 0.0f);
glTexCoord2f(1.0f, 1.0f); glVertex3f( 1.0f,  1.0f, 0.0f);
glTexCoord2f(0.0f, 1.0f); glVertex3f(-1.0f,  1.0f, 0.0f);
glEnd();

// テクスチャとサンプラーオブジェクトのバインドを解除
texture.release();
sampler.release();

このコードは、QOpenGLContext::functions()関数を使って、glSamplerParameteri()関数へのポインタを取得し、サンプラーオブジェクトのパラメータを設定します。

Qt GUI