QSGGeometry Class

struct MyPoint2D {
    float x;
    float y;
    float r;
    float g;
    float b;
    float a;

    void set(float x_, float y_, float r_, float g_, float b_, float a_) {
        x = x_;
        y = y_;
        r = r_;
        g = g_;
        b = b_;
        a = a_;
    }
};

QSGGeometry::Attribute MyPoint2D_Attributes[] = {
    QSGGeometry::Attribute::create(0, 2, FloatType, true),
    QSGGeometry::Attribute::create(1, 4, FloatType, false)
};

QSGGeometry::AttributeSet MyPoint2D_AttributeSet = {
    2,
    sizeof(MyPoint2D),
    MyPoint2D_Attributes
};

...

geometry = new QSGGeometry(MyPoint2D_AttributeSet, 2);
geometry->setDrawingMode(DrawLines);

MyPoint2D *vertices = static_cast<MyPoint2D *>(geometry->vertexData());
vertices[0].set(0, 0, 1, 0, 0, 1);
vertices[1].set(width(), height(), 0, 0, 1, 1);

멤버 함수 문서

QSGGeometry::QSGGeometry(const QSGGeometry::AttributeSet &attributes, int vertexCount, int indexCount = 0, int indexType = UnsignedShortType)

attributes 를 기반으로 지오메트리 객체를 생성합니다.

이 객체는 attributes 에 누적된 크기를 기준으로 vertexCount 의 정점들을 위한 공간을 할당하며, indexCount 에 대해서도 공간을 할당합니다.

indexType 는 UnsignedShortType 또는 UnsignedIntType 일 수 있습니다. 후자에 대한 지원 여부는 런타임에 사용되는 그래픽 API 구현에 따라 다르며, 항상 사용 가능한 것은 아닙니다.

Geometry 객체는 기본적으로 DrawTriangleStrip 을 그리기 모드로 설정하여 생성됩니다.

[virtual noexcept] QSGGeometry::~QSGGeometry()

지오메트리 객체와 해당 객체가 할당해 둔 정점 및 인덱스 데이터를 삭제합니다.

void QSGGeometry::allocate(int vertexCount, int indexCount = 0)

이 지오메트리 객체의 정점 및 인덱스 데이터를 vertexCount 정점과 indexCount 인덱스에 맞게 크기를 조정하고, 그에 따라 정점과 인덱스의 개수를 설정합니다.

allocate()를 다시 호출하지 않고도 setVertexCount() 또는 setIndexCount()를 사용하여 정점 또는 인덱스 수를 변경할 수 있습니다.

이 호출 후 버텍스 및 인덱스 데이터는 무효화되며, 호출자는 렌더러가 내부 버퍼를 업데이트할 수 있도록 node->markDirty(QSGNode::DirtyGeometry) 를 호출하여 관련 지오메트리 노드를 더티(dirty) 상태로 표시해야 합니다.

setVertexCount() 및 setIndexCount()도 참조하십시오 .

int QSGGeometry::attributeCount() const

이 지오메트리가 사용하는 속성 집합에 포함된 속성의 개수를 반환합니다.

const QSGGeometry::Attribute *QSGGeometry::attributes() const

이 지오메트리의 속성을 포함하는 배열을 반환합니다. 배열의 크기는 ` attributeCount()` 함수를 통해 지정됩니다.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_ColoredPoint2D()

버텍스별 색상이 지정된 2D 그리기에 사용될 속성을 반환하는 편의 함수입니다.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_Point2D()

2D 단색 도면에 사용할 속성을 반환하는 편의 함수입니다.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_TexturedPoint2D()

텍스처가 적용된 2D 그리기에 사용될 속성을 반환하는 편의 함수입니다.

unsigned int QSGGeometry::drawingMode() const

이 지오메트리의 그리기 모드를 반환합니다.

기본값은 ` DrawTriangleStrip`입니다.

setDrawingMode()도 참조하십시오 .

int QSGGeometry::indexCount() const

지오메트리 객체가 렌더링될 때 처리되는 인덱스의 개수를 반환합니다.

setIndexCount()도 참조하십시오 .

void *QSGGeometry::indexData()

이 지오메트리 객체의 원시 인덱스 데이터에 대한 포인터를 반환합니다.

indexDataAsUShort() 및 indexDataAsUInt()도 참조하십시오 .

const void *QSGGeometry::indexData() const

이 지오메트리 객체의 원시 인덱스 데이터에 대한 포인터를 반환합니다.

indexDataAsUShort() 및 indexDataAsUInt()도 참조하십시오 .

uint *QSGGeometry::indexDataAsUInt()

인덱스 데이터를 32비트 부호 없는 정수의 변경 가능한 배열로 접근할 수 있게 해주는 편리한 함수입니다.

const uint *QSGGeometry::indexDataAsUInt() const

인덱스 데이터를 32비트 부호 없는 정수의 불변 배열로 접근할 수 있게 해주는 편리한 함수입니다.

quint16 *QSGGeometry::indexDataAsUShort()

인덱스 데이터를 16비트 부호 없는 정수의 가변 배열로 접근할 수 있게 해주는 편의 함수입니다.

const quint16 *QSGGeometry::indexDataAsUShort() const

인덱스 데이터를 16비트 부호 없는 정수의 불변 배열로 가져올 수 있는 편리한 함수입니다.

QSGGeometry::DataPattern QSGGeometry::indexDataPattern() const

이 지오메트리에서 인덱스의 사용 패턴을 반환합니다. 기본 패턴은 AlwaysUploadPattern 입니다.

setIndexDataPattern()도 참조하십시오 .

int QSGGeometry::indexType() const

이 지오메트리 객체에서 인덱스에 사용되는 기본 데이터형을 반환합니다.

float QSGGeometry::lineWidth() const

이 지오메트리에 사용될 현재 선 또는 점의 두께를 가져옵니다. 이 속성은 ‘ drawingMode ’가 ‘ DrawLines ’ 또는 ‘ DrawLineStrip ’일 때만 선 두께에 적용됩니다. 지원되는 경우, ‘ drawingMode ’가 ‘ DrawPoints ’일 때 점 크기에 대해서도 적용됩니다.

기본값은 1.0

setLineWidth() 및 drawingMode()도 참조하십시오 .

void QSGGeometry::markIndexDataDirty()

이 지오메트리의 정점이 변경되었으므로 다시 업로드해야 함을 표시하십시오.

이 함수는 정점의 사용 패턴이 StaticData이고, 이 지오메트리를 렌더링하는 렌더러가 해당 지오메트리를 VBO(Vertex Buffer Object)로 업로드하는 경우에만 효과가 있습니다.

void QSGGeometry::markVertexDataDirty()

이 지오메트리의 정점이 변경되었으므로 다시 업로드해야 함을 표시하십시오.

이 함수는 정점의 사용 패턴이 StaticData이고, 이 지오메트리를 렌더링하는 렌더러가 해당 지오메트리를 VBO(Vertex Buffer Object)로 업로드하는 경우에만 효과가 있습니다.

void QSGGeometry::setDrawingMode(unsigned int mode)

이 지오메트리를 그리는 데 사용할 mode 를 설정합니다.

기본값은 QSGGeometry::DrawTriangleStrip 입니다.

drawingMode() 및 DrawingMode도 참조하십시오 .

[since 6.10] void QSGGeometry::setIndexCount(int count)

지오메트리 오브젝트가 렌더링될 때마다 처리될 인덱스의 수를 설정합니다.

count 는 유효성 검증을 거치지 않으므로, 0과 할당된 인덱스 수 사이의 값만 지정되도록 하는 것은 사용자의 책임입니다.

이 호출 후 정점 및 인덱스 데이터는 무효화되지 않지만, 호출자는 렌더러가 내부 버퍼를 업데이트할 수 있도록 node->markDirty(QSGNode::DirtyGeometry) 을 호출하여 지오메트리 노드를 '더티' 상태로 표시해야 합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

indexCount()도 참조하십시오 .

void QSGGeometry::setIndexDataPattern(QSGGeometry::DataPattern p)

인덱스의 사용 패턴을 ‘ p ’로 설정합니다.

기본값은 ` AlwaysUploadPattern`입니다. 기본값 이외의 값으로 설정된 경우, 사용자는 ` QSGNode::DirtyGeometry`을 사용하여 ` QSGNode::markDirty()`를 호출하는 것 외에도, 인덱스 데이터를 변경한 후 ` markIndexDataDirty()`를 호출해야 합니다.

indexDataPattern()도 참조하십시오 .

void QSGGeometry::setLineWidth(float width)

이 지오메트리에 사용될 선 또는 점의 두께를 ` width`로 설정합니다. 이 속성은 ` drawingMode `가 ` DrawLines ` 또는 ` DrawLineStrip`일 때만 선 두께에 적용됩니다. 지원되는 경우, ` drawingMode `가 ` DrawPoints`일 때 점 크기에 대해서도 적용됩니다.

lineWidth() 및 drawingMode()도 참조하십시오 .

[since 6.10] void QSGGeometry::setVertexCount(int count)

렌더링할 정점의 수를 설정합니다.

count 는 유효성 검사를 거치지 않으므로, 0과 할당된 정점 수 사이의 값만 지정되도록 하는 것은 사용자의 책임입니다.

이 호출 후 정점 데이터는 무효화되지 않지만, 호출자는 node->markDirty(QSGNode::DirtyGeometry) 를 호출하여 지오메트리 노드를 '더티' 상태로 표시해야만 렌더러가 내부 버퍼를 업데이트할 수 있습니다.

이 함수는 Qt 6.10에서 도입되었습니다.

vertexCount()도 참조하십시오 .

void QSGGeometry::setVertexDataPattern(QSGGeometry::DataPattern p)

정점의 사용 패턴을 ` p`로 설정합니다.

기본값은 ` AlwaysUploadPattern`입니다. 기본값 이외의 값으로 설정된 경우, 사용자는 ` QSGNode::DirtyGeometry`을 사용하여 ` QSGNode::markDirty()`를 호출하는 것 외에도, 정점 데이터를 변경한 후 ` markVertexDataDirty()`를 호출해야 합니다.

vertexDataPattern()도 참조하십시오 .

int QSGGeometry::sizeOfIndex() const

인덱스 유형의 바이트 크기를 반환합니다.

이 값은 인덱스 유형이 ` UnsignedShortType`인 경우 ` 2 `이며, 인덱스 유형이 ` UnsignedIntType`인 경우 ` 4 `입니다.

int QSGGeometry::sizeOfVertex() const

하나의 정점의 크기를 바이트 단위로 반환합니다.

이 값은 속성에서 가져옵니다.

[static] void QSGGeometry::updateColoredRectGeometry(QSGGeometry *g, const QRectF &rect)

g 에 있는 지오메트리를 rect 에 있는 좌표로 업데이트합니다.

이 함수는 지오메트리 객체가 QSGGeometry::ColoredPoint2D 개의 정점으로 구성된 단일 삼각형 스트립을 포함하고 있다고 가정합니다.

[static] void QSGGeometry::updateRectGeometry(QSGGeometry *g, const QRectF &rect)

g 에 있는 지오메트리를 rect 에 있는 좌표로 업데이트합니다.

이 함수는 지오메트리 객체가 QSGGeometry::Point2D 개의 정점으로 구성된 단일 삼각형 스트립을 포함하고 있다고 가정합니다.

[static] void QSGGeometry::updateTexturedRectGeometry(QSGGeometry *g, const QRectF &rect, const QRectF &textureRect)

g 의 지오메트리를 rect 의 좌표와 textureRect 의 텍스처 좌표로 업데이트합니다.

textureRect 좌표는 정규화된 좌표여야 합니다.

g QSGGeometry::TexturedPoint2D 유형의 4개 정점으로 구성된 삼각형 스트립으로 가정합니다.

int QSGGeometry::vertexCount() const

렌더링할 수 있는 정점의 수를 반환하거나, 인덱스가 사용되는 경우 인덱스를 통해 액세스할 수 있는 정점의 수를 반환합니다.

setVertexCount()도 참조하십시오 .

void *QSGGeometry::vertexData()

이 지오메트리 객체의 원시 정점 데이터에 대한 포인터를 반환합니다.

vertexDataAsPoint2D() 및 vertexDataAsTexturedPoint2D()도 참조하십시오 .

const void *QSGGeometry::vertexData() const

이 지오메트리 객체의 원시 정점 데이터에 대한 포인터를 반환합니다.

vertexDataAsPoint2D() 및 vertexDataAsTexturedPoint2D()도 참조하십시오 .

QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D()

QSGGeometry::ColoredPoint2D 의 변경 가능한 배열 형태로 정점 데이터에 접근할 수 있게 해주는 편의 함수입니다.

const QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D() const

QSGGeometry::ColoredPoint2D 의 불변 배열 형태로 정점 데이터에 접근할 수 있게 해주는 편리한 함수입니다.

QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D()

QSGGeometry::Point2D 의 가변 배열 형태로 정점 데이터에 접근할 수 있는 편리한 함수입니다.

const QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D() const

QSGGeometry::Point2D 의 불변 배열 형태로 정점 데이터에 접근할 수 있게 해주는 편리한 함수입니다.

QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D()

QSGGeometry::TexturedPoint2D 의 가변 배열 형태로 정점 데이터에 접근할 수 있게 해주는 편리한 함수입니다.

const QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D() const

QSGGeometry::TexturedPoint2D 의 불변 배열 형태로 정점 데이터에 접근할 수 있게 해주는 편리한 함수입니다.

QSGGeometry::DataPattern QSGGeometry::vertexDataPattern() const

이 지오메트리의 정점에 대한 사용 패턴을 반환합니다. 기본 패턴은 ‘ AlwaysUploadPattern ’입니다.

setVertexDataPattern()도 참조하십시오 .