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 が真の場合、フォーマット・オプション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

format オプションoption が設定されている場合は true を返し、設定されていない場合は false を返します。

options()も参照 。

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

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

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

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

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

このオブジェクトにother を代入します。