QSurfaceFormat Class

メンバ関数のドキュメント

QSurfaceFormat::QSurfaceFormat()

デフォルトの初期化が施された QSurfaceFormat を生成します。

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

指定されたフォーマット `options` を使用して、`QSurfaceFormat` を作成します。

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

other のコピーを作成します。

[noexcept] QSurfaceFormat::~QSurfaceFormat()

QSurfaceFormat を削除します。

int QSurfaceFormat::alphaBufferSize() const

カラーバッファのアルファチャンネルのサイズ（ビット単位）を取得します。

setAlphaBufferSize()も参照してください 。

int QSurfaceFormat::blueBufferSize() const

カラーバッファの青チャンネルのサイズ（ビット単位）を取得します。

setBlueBufferSize()も参照してください 。

const QColorSpace &QSurfaceFormat::colorSpace() const

色空間を返します。

setColorSpace()も参照してください 。

[static] QSurfaceFormat QSurfaceFormat::defaultFormat()

グローバルなデフォルトのサーフェス形式を返します。

setDefaultFormat() が呼び出されていない場合、これはデフォルト構築された `QSurfaceFormat` です。

setDefaultFormat()も参照してください 。

int QSurfaceFormat::depthBufferSize() const

深度バッファのサイズを返します。

setDepthBufferSize()も参照してください 。

int QSurfaceFormat::greenBufferSize() const

カラーバッファの緑チャンネルのサイズをビット単位で取得します。

setGreenBufferSize()も参照してください 。

bool QSurfaceFormat::hasAlpha() const

アルファバッファのサイズがゼロより大きい場合、true を返します。

これは、そのサーフェスがピクセル単位の半透明効果で使用される可能性があることを意味します。

int QSurfaceFormat::majorVersion() const

OpenGLのメジャーバージョンを返します。

デフォルトのバージョンは 2.0 です。

setMajorVersion()も参照してください 。

int QSurfaceFormat::minorVersion() const

OpenGLのマイナーバージョンを返します。

setMinorVersion()も参照してください 。

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

現在設定されているフォーマットオプションを返します。

setOption()、setOptions()、およびtestOption()も参照してください 。

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

設定済みの OpenGL コンテキストプロファイルを取得します。

要求された OpenGL のバージョンが 3.2 未満の場合、この設定は無視されます。

setProfile()も参照してください 。

int QSurfaceFormat::redBufferSize() const

カラーバッファの赤チャンネルのサイズをビット単位で取得します。

setRedBufferSize()も参照してください 。

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

レンダリング可能なタイプを取得します。

デスクトップOpenGL、OpenGL ES、およびOpenVG の中から選択します。

setRenderableType()も参照してください 。

int QSurfaceFormat::samples() const

マルチサンプリングが有効な場合はピクセルあたりのサンプル数を返し、マルチサンプリングが無効な場合は-1 を返します。デフォルトの戻り値は-1 です。

setSamples()も参照してください 。

void QSurfaceFormat::setAlphaBufferSize(int size)

カラーバッファのアルファチャンネルのビットに、希望するsize を設定します。

alphaBufferSize()も参照してください 。

void QSurfaceFormat::setBlueBufferSize(int size)

カラーバッファの青チャンネルのビットに、希望するsize を設定します。

blueBufferSize()も参照してください 。

[since 6.0] void QSurfaceFormat::setColorSpace(const QColorSpace &colorSpace)

優先されるcolorSpace を設定します。

たとえば、これにより、sRGBに対応しているプラットフォーム上で、sRGB対応のデフォルトフレームバッファを持つウィンドウを要求できるようになります。

この関数は Qt 6.0 で導入されました。

colorSpace()も参照してください 。

[static] void QSurfaceFormat::setDefaultFormat(const QSurfaceFormat &format)

グローバルなデフォルトのサーフェス「format 」を設定します。

このフォーマットは、QOpenGLContext 、QWindow 、QOpenGLWidget 、および類似のクラスでデフォルトで使用されます。

これは、当該クラス独自の setFormat() 関数を使用することで、インスタンスごとにいつでも上書きすることができます。 ただし、アプリケーションの起動時にすべてのウィンドウのフォーマットを一度に設定するほうが、多くの場合、便利です。また、この関数を使用してフォーマットを設定すると、Qt によって内部的に作成されたものを含め、すべてのコンテキストとサーフェスが同じフォーマットを使用することが保証されるため、共有コンテキストが必要な場合でも、適切な動作が保証されます。

defaultFormat()も参照してください 。

void QSurfaceFormat::setDepthBufferSize(int size)

深度バッファの最小サイズをsize に設定します。

depthBufferSize()も参照してください 。

void QSurfaceFormat::setGreenBufferSize(int size)

カラーバッファの緑チャンネルのビットに、希望するsize を設定します。

greenBufferSize()も参照してください 。

void QSurfaceFormat::setMajorVersion(int major)

指定したmajor のOpenGLバージョンを設定します。

majorVersion()も参照してください 。

void QSurfaceFormat::setMinorVersion(int minor)

minor のOpenGLバージョンを指定します。

デフォルトのバージョンは 2.0 です。

minorVersion()も参照してください 。

void QSurfaceFormat::setOption(QSurfaceFormat::FormatOption option, bool on = true)

on がtrueの場合、フォーマットオプションoption を設定します。そうでない場合は、このオプションをクリアします。

オプションが反映されたことを確認するには、サーフェス／コンテキストの作成後に、実際のフォーマットと要求されたフォーマットを比較してください。

setOptions()、options()、およびtestOption()も参照してください 。

void QSurfaceFormat::setOptions(QSurfaceFormat::FormatOptions options)

フォーマットオプションをoptions に設定します。

オプションが正しく適用されたかどうかを確認するには、サーフェス／コンテキストの作成後に、実際のフォーマットと指定したフォーマットを比較してください。

options() およびtestOption()も参照してください 。

void QSurfaceFormat::setProfile(QSurfaceFormat::OpenGLContextProfile profile)

目的の OpenGL コンテキストprofile を設定します。

要求された OpenGL のバージョンが 3.2 未満の場合、この設定は無視されます。

profile()も参照してください 。

void QSurfaceFormat::setRedBufferSize(int size)

カラーバッファの赤チャンネルのビットに、希望するsize を設定します。

redBufferSize()も参照してください 。

void QSurfaceFormat::setRenderableType(QSurfaceFormat::RenderableType type)

目的のレンダラtype を設定します。

デスクトップ OpenGL、OpenGL ES、およびOpenVG の中から選択します。

renderableType()も参照してください 。

void QSurfaceFormat::setSamples(int numSamples)

マルチサンプリングが有効になっている場合、1ピクセルあたりの推奨サンプリング数を `numSamples` に設定します。デフォルトでは、マルチサンプリングは無効になっています。

samples()も参照してください 。

void QSurfaceFormat::setStencilBufferSize(int size)

ステンシルバッファの推奨サイズをsize ビットに設定します。

stencilBufferSize()も参照してください 。

void QSurfaceFormat::setStereo(bool enable)

enable がtrueの場合、ステレオバッファリングを有効にします。そうでない場合は、ステレオバッファリングを無効にします。

デフォルトでは、ステレオバッファリングは無効になっています。

ステレオバッファリングは、左眼用および右眼用の画像を生成するために追加のカラーバッファを提供します。

stereo()も参照してください 。

void QSurfaceFormat::setSwapBehavior(QSurfaceFormat::SwapBehavior behavior)

サーフェスのスワップbehavior を設定します。

スワップの挙動は、シングルバッファリング、ダブルバッファリング、またはトリプルバッファリングのいずれを行うかを指定します。デフォルトの `DefaultSwapBehavior` は、プラットフォームのデフォルトのスワップ挙動を採用します。

swapBehavior()も参照してください 。

void QSurfaceFormat::setSwapInterval(int interval)

優先スワップ間隔を設定します。スワップ間隔は、バッファのスワップが行われるまでに表示されるビデオフレームの最小数を指定します。これを使用することで、ウィンドウへのGL描画を画面の垂直リフレッシュレートに同期させることができます。

interval の値を0に設定すると、垂直リフレッシュ同期がオフになり、0より大きい値に設定すると、垂直同期がオンになります。interval の値を、例えば10のように大きく設定すると、バッファスワップごとに10回の垂直リトレースが行われることになります。

デフォルトの間隔は 1 です。

スワップ間隔の変更は、基盤となるプラットフォームでサポートされていない場合があります。その場合、リクエストは黙って無視されます。

swapInterval()も参照してください 。

void QSurfaceFormat::setVersion(int major, int minor)

major およびminor のOpenGLバージョンを希望の値に設定します。

デフォルトのバージョンは 2.0 です。

version()も参照してください 。

int QSurfaceFormat::stencilBufferSize() const

ステンシルバッファのサイズをビット単位で返します。

setStencilBufferSize()も参照してください 。

bool QSurfaceFormat::stereo() const

ステレオバッファリングが有効な場合は `true ` を返し、そうでない場合は `false` を返します。ステレオバッファリングはデフォルトで無効になっています。

setStereo()も参照してください 。

QSurfaceFormat::SwapBehavior QSurfaceFormat::swapBehavior() const

設定されたスワップの動作を返します。

setSwapBehavior()も参照してください 。

int QSurfaceFormat::swapInterval() const

スワップ間隔を返します。

setSwapInterval()も参照してください 。

bool QSurfaceFormat::testOption(QSurfaceFormat::FormatOption option) const

フォーマットオプション `option ` が設定されている場合は `true` を返し、そうでない場合は `false` を返します。

options()も参照してください 。

std::pair<int, int> QSurfaceFormat::version() const

OpenGLのバージョンを表す std::pair<int, int> を返します。

バージョンチェックに役立ちます。例：format.version() >= std::pair(3, 2)

setVersion()も参照してください 。

QSurfaceFormat &QSurfaceFormat::operator=(const QSurfaceFormat &other)

このオブジェクトにother を割り当てます。