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 및 indexCount 에 누적된 크기를 기준으로 vertexCount 정점에 대한 공간을 할당합니다.

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

지오메트리 객체는 기본적으로 DrawTriangleStrip 을 그리기 모드로 사용하여 구성됩니다.

[virtual noexcept] QSGGeometry::~QSGGeometry()

지오메트리 개체와 그 개체에 할당된 버텍스 및 인덱스 데이터를 삭제합니다.

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

이 지오메트리 객체의 버텍스 및 인덱스 데이터를 vertexCount 버텍스와 indexCount 인덱스에 맞게 크기를 조정합니다.

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

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

이 지오메트리 객체에 있는 인덱스의 수를 반환합니다.

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()

이 지오메트리의 버텍스가 변경되었으므로 다시 업로드해야 함을 표시합니다.

이 함수는 버텍스의 사용 패턴이 정적 데이터이고 이 지오메트리를 렌더링하는 렌더러가 지오메트리를 VBO(버텍스 버퍼 오브젝트)에 업로드하는 경우에만 효과가 있습니다.

void QSGGeometry::markVertexDataDirty()

이 지오메트리의 버텍스가 변경되었으므로 다시 업로드해야 함을 표시합니다.

이 함수는 버텍스의 사용 패턴이 정적 데이터이고 이 지오메트리를 렌더링하는 렌더러가 지오메트리를 VBO(버텍스 버퍼 오브젝트)에 업로드하는 경우에만 효과가 있습니다.

void QSGGeometry::setDrawingMode(unsigned int mode)

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

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

drawingMode() 및 DrawingMode도 참조하세요 .

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()도 참조하세요 .

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)

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

이 함수는 지오메트리 객체에 QSGGeometry::ColoredPoint2D 정점으로 이루어진 단일 삼각형 스트립이 포함되어 있다고 가정합니다.

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

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

이 함수는 지오메트리 객체에 QSGGeometry::Point2D 정점으로 이루어진 단일 삼각형 스트립이 포함되어 있다고 가정합니다.

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

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

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

g 는 QSGGeometry::TexturedPoint2D 유형의 정점 4개로 이루어진 삼각형 스트립으로 가정합니다.

int QSGGeometry::vertexCount() const

이 지오메트리 오브젝트의 정점 수를 반환합니다.

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()도 참조하세요 .