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 와 연관된 버퍼를 해제합니다.

이 함수는 호출자가 어떤 ` QOpenGLBuffer `가 컨텍스트에 바인딩되었는지 알지 못하지만, 해당 버퍼가 반드시 해제되도록 보장하고자 할 때 사용하기 위해 ` glBindBuffer(type, 0) `를 직접 호출하는 것입니다.

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 `은 쓰기 시 복사(copy-on-write) 세манти크를 구현하지 않으므로, 복사본이 수정될 때마다 ` other `에도 변경 사항이 반영됩니다.