QOpenGLBuffer Class

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

QOpenGLBuffer::QOpenGLBuffer()

QOpenGLBuffer::VertexBuffer 型の新しいバッファオブジェクトを作成します。

注：このコンストラクタは、QOpenGLBufferのインスタンスを作成するだけです。OpenGLサーバー上の実際のバッファオブジェクトは、create()が呼び出されるまで作成されません。

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

[explicit] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer::Type type)

type の新しいバッファオブジェクトを作成します。

注：このコンストラクタは、QOpenGLBufferのインスタンスを作成するだけです。OpenGLサーバー上の実際のバッファオブジェクトは、create()が呼び出されるまで作成されません。

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

QOpenGLBuffer::QOpenGLBuffer(const QOpenGLBuffer &other)

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

注：QOpenGLBufferはコピーオンライト（copy-on-write）セマンティクスを実装していないため、コピーが変更されるたびにother にも影響が及びます。

[noexcept, since 6.5] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer &&other)

other から新しい QOpenGLBuffer をムーブコンストラクタで生成します。

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

[noexcept] QOpenGLBuffer::~QOpenGLBuffer()

このバッファオブジェクトを破棄します。これには、OpenGL サーバーで使用されているメモリ領域も含まれます。

void QOpenGLBuffer::allocate(const void *data, int count)

バッファにcount バイトの領域を割り当て、data の内容で初期化します。それ以前の内容はすべて削除されます。

このバッファに対してcreate() が呼び出されており、現在のコンテキストにバインドされていることが前提となります。

create()、read()、およびwrite()も参照してください 。

void QOpenGLBuffer::allocate(int count)

バッファにcount バイトの領域を割り当てます。それまでの内容はすべて削除されます。

このバッファに対してcreate()が呼び出されており、現在のコンテキストにバインドされていることが前提となります。

create() およびwrite()も参照してください 。

bool QOpenGLBuffer::bind()

このオブジェクトに関連付けられたバッファを、現在の OpenGL コンテキストにバインドします。バインドできなかった場合（通常は、この OpenGL 実装で `type()` がサポートされていないため）、false を返します。

バッファは、create() が呼び出された時点で有効だったQOpenGLContext と同じもの、またはそれと共有されている別のQOpenGLContext にバインドされている必要があります。そうでない場合、この関数はfalseを返します。

release() およびcreate()も参照してください 。

GLuint QOpenGLBuffer::bufferId() const

このバッファに関連付けられた OpenGL 識別子を返します。バッファが作成されていない場合は 0 を返します。

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

bool QOpenGLBuffer::create()

OpenGLサーバー内にバッファオブジェクトを作成します。オブジェクトが作成された場合はtrue を返し、そうでない場合はfalseを返します。

この関数は、現在のQOpenGLContext を引数として呼び出す必要があります。バッファはそのコンテキスト（またはそれと同じコンテキストを共有する他のコンテキスト）にバインドされ、そのコンテキスト内でのみ使用可能となります。

OpenGLの実装がバッファをサポートしていない場合、または現在のQOpenGLContext が存在しない場合、この関数はfalseを返します。

isCreated()、allocate()、write()、およびdestroy()も参照してください 。

void QOpenGLBuffer::destroy()

このバッファオブジェクトを破棄します。これには、OpenGL サーバーで使用されているメモリも含まれます。このバッファへのすべての参照は無効になります。

bool QOpenGLBuffer::isCreated() const

このバッファが作成されている場合は `true ` を返し、そうでない場合は `false` を返します。

create() およびdestroy()も参照してください 。

void *QOpenGLBuffer::map(QOpenGLBuffer::Access access)

このバッファの内容をアプリケーションのメモリ空間にマップし、そのポインタを返します。メモリマッピングができない場合はNULLを返します。access パラメータは、実行されるアクセスの種類を示します。

このバッファに対してcreate()が呼び出されており、かつ現在のコンテキストにバインドされていることが前提となります。

関連項目： unmap()、create()、bind()、およびmapRange()。

void *QOpenGLBuffer::mapRange(int offset, int count, QOpenGLBuffer::RangeAccessFlags access)

このバッファの内容のうち、offset およびcount で指定された範囲をアプリケーションのメモリ空間にマッピングし、そのポインタを返します。メモリマッピングが不可能な場合はNULLを返します。access パラメータは、アクセスフラグの組み合わせを指定します。

このバッファに対してcreate()が呼び出されており、かつ現在のコンテキストにバインドされていることが前提となります。

関連項目： unmap()、create()、およびbind()。

bool QOpenGLBuffer::read(int offset, void *data, int count)

このバッファのoffset から始まるcount バイトをdata に読み込みます。成功した場合はtrue を返し、バッファからの読み込みがサポートされていない場合はfalseを返します。OpenGL/ESではバッファの読み込みはサポートされていません。

このバッファは、現在のコンテキストにバインド済みであることが前提となります。

write() およびbind()も参照してください 。

void QOpenGLBuffer::release()

このオブジェクトに関連付けられているバッファを、現在の OpenGL コンテキストから解放します。

この関数は、そのバッファに対してbind()が呼び出されたときと同じQOpenGLContext が指定された状態で呼び出す必要があります。

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

[static] void QOpenGLBuffer::release(QOpenGLBuffer::Type type)

現在のQOpenGLContext において、type に関連付けられたバッファを解放します。

この関数は、glBindBuffer(type, 0) への直接呼び出しであり、呼び出し元がどのQOpenGLBuffer がコンテキストにバインドされているかを知らないが、確実に解放したい場合に使用します。

QOpenGLBuffer::release(QOpenGLBuffer::VertexBuffer);

void QOpenGLBuffer::setUsagePattern(QOpenGLBuffer::UsagePattern value)

このバッファオブジェクトの使用パターンをvalue に設定します。この関数は、allocate()またはwrite()を呼び出す前に呼び出す必要があります。

usagePattern()、allocate()、およびwrite()も参照してください 。

int QOpenGLBuffer::size() const

読み取り操作において、このバッファ内のデータのサイズを返します。バッファサイズの取得がサポートされていない場合、またはバッファが作成されていない場合は、-1 を返します。

このバッファは、現在のコンテキストにバインドされているものとみなされます。

isCreated() およびbind()も参照してください 。

[noexcept, since 6.5] void QOpenGLBuffer::swap(QOpenGLBuffer &other)

このバッファをother と入れ替えます。この操作は非常に高速で、失敗することはありません。

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

QOpenGLBuffer::Type QOpenGLBuffer::type() const

このオブジェクトが表すバッファの型を返します。

bool QOpenGLBuffer::unmap()

以前にmap()を呼び出してアプリケーションのメモリ空間にマップされたバッファのマップを解除します。マップの解除に成功した場合はtrue を返し、失敗した場合はfalseを返します。

このバッファは現在のコンテキストにバインドされており、以前にmap() によってマップされていることが前提となります。

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

QOpenGLBuffer::UsagePattern QOpenGLBuffer::usagePattern() const

このバッファオブジェクトの使用パターンを返します。デフォルト値は `StaticDraw` です。

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

void QOpenGLBuffer::write(int offset, const void *data, int count)

このバッファのoffset から始まるcount バイトを、data の内容で置き換えます。バッファ内のそれ以外のバイトは変更されません。

このバッファに対してcreate() が呼び出されており、現在のコンテキストにバインドされていることが前提となります。

create()、read()、およびallocate()も参照してください 。

[noexcept, since 6.5] QOpenGLBuffer &QOpenGLBuffer::operator=(QOpenGLBuffer &&other)

other をこのQOpenGLBuffer インスタンスに代入します。

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

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

other の浅いコピーをこのオブジェクトに割り当てます。

注：QOpenGLBuffer はコピーオンライトのセマンティクスを実装していないため、コピーが変更されるたびにother も影響を受けます。