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)

Move-constructs new QOpenGLBuffer fromother.

この関数は 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コンテキストにバインドする。バインドできなかった場合はfalse を返します。通常、type() がこの OpenGL 実装でサポートされていないためです。

バッファは、create （）が呼び出されたときと同じQOpenGLContext 現在にバインドされているか、それと共有されている別のQOpenGLContext にバインドされていなければなりません。そうでない場合、この関数からfalseが返されます。

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

GLuint QOpenGLBuffer::bufferId() const

バッファが作成されていない場合は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 current で呼び出されなければならない。

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)

Move-assignother をこのQOpenGLBuffer インスタンスに割り当てる。

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

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

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

注意:QOpenGLBuffer は copy-on-write セマンティクスを実装していないので、コピーが変更されるたびにother は影響を受ける。