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

アルファバッファサイズが0より大きい場合、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)

マルチサンプリングが有効な場合に、ピクセルあたりの好ましいサンプル数を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 が設定されていれば真を返し、そうでなければ偽を返す。

options()も参照 。

QPair<int, int> QSurfaceFormat::version() const

OpenGLのバージョンを表すQPair<int, int>を返す。

例えば、format.version() >= qMakePair(3, 2)のようなバージョンチェックに便利です。

setVersion()も参照 。

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

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