QSGSimpleTextureNode Class

QSGSimpleTextureNode 클래스는 QML 씬 그래프를 사용하여 텍스처 콘텐츠를 쉽게 그릴 수 있도록 편의를 위해 제공됩니다. 더 보기...

Header: #include <QSGSimpleTextureNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
상속합니다: QSGGeometryNode

공용 타입

enum TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically }
flags TextureCoordinatesTransformMode

공용 함수

QSGSimpleTextureNode()
virtual ~QSGSimpleTextureNode() override
QSGTexture::Filtering filtering() const
bool ownsTexture() const
QRectF rect() const
void setFiltering(QSGTexture::Filtering filtering)
void setOwnsTexture(bool owns)
void setRect(const QRectF &r)
void setRect(qreal x, qreal y, qreal w, qreal h)
void setSourceRect(const QRectF &r)
void setSourceRect(qreal x, qreal y, qreal w, qreal h)
void setTexture(QSGTexture *texture)
void setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode)
QRectF sourceRect() const
QSGTexture *texture() const
QSGSimpleTextureNode::TextureCoordinatesTransformMode textureCoordinatesTransform() const

상세 설명

경고: 단순 텍스처 노드 클래스는 렌더링할 씬 그래프에 추가되기 전에 텍스처가 있어야 합니다.

경고: 이 유틸리티 클래스는 Qt Quick 시나리오 그래프의 기본 또는 소프트웨어 백엔드로 실행할 때만 작동합니다. 대신 QQuickWindow::createImageNode()을 통해 QSGImageNode 을 사용하는 것이 좋습니다. 그러나 이 독립형 클래스는 서브클래싱을 통해 사용하고 애플리케이션이 특별한 시나리오 백엔드가 관여하지 않는다는 것을 알고 있는 경우에도 여전히 유용합니다.

멤버 유형 문서

열거형 QSGSimpleTextureNode::TextureCoordinatesTransformFlag
플래그 QSGSimpleTextureNode::TextureCoordinatesTransformMode

텍스처 쿼드에 대한 텍스처 좌표 생성에 사용되는 모드를 지정하는 데 사용되는 TextureCoordinatesTransformFlag 열거형입니다.

상수설명
QSGSimpleTextureNode::NoTransform0x00텍스처 좌표의 방향은 창 좌표, 즉 원점이 왼쪽 상단에 있습니다.
QSGSimpleTextureNode::MirrorHorizontally0x01텍스처 좌표는 창 좌표에 대해 가로축에서 반전됩니다.
QSGSimpleTextureNode::MirrorVertically0x02텍스처 좌표가 창 좌표에 대해 세로 축에서 반전됩니다.

TextureCoordinatesTransformMode 유형은 QFlags<TextureCoordinatesTransformFlag>에 대한 typedef입니다. TextureCoordinatesTransformFlag 값의 OR 조합을 저장합니다.

멤버 함수 문서

QSGSimpleTextureNode::QSGSimpleTextureNode()

새로운 단순 텍스처 노드를 생성합니다.

[override virtual noexcept] QSGSimpleTextureNode::~QSGSimpleTextureNode()

텍스처 노드를 파괴합니다.

QSGTexture::Filtering QSGSimpleTextureNode::filtering() const

이 텍스처 노드에 현재 설정된 필터링을 반환합니다.

setFiltering()도 참조하세요 .

bool QSGSimpleTextureNode::ownsTexture() const

노드가 텍스처의 소유권을 가지면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setOwnsTexture()도 참조하세요 .

QRectF QSGSimpleTextureNode::rect() const

이 텍스처 노드의 타깃 렉트를 반환합니다.

setRect()도 참조하십시오 .

void QSGSimpleTextureNode::setFiltering(QSGTexture::Filtering filtering)

이 텍스처 노드에 사용할 필터링을 filtering 로 설정합니다.

부드러운 스케일링의 경우 QSGTexture::Linear 을 사용하고, 일반 스케일링의 경우 QSGTexture::Nearest 을 사용합니다.

filtering()도 참조하세요 .

void QSGSimpleTextureNode::setOwnsTexture(bool owns)

노드가 텍스처의 소유권을 owns 로 가져갈지 여부를 설정합니다.

기본적으로 노드는 텍스처의 소유권을 갖지 않습니다.

ownsTexture() 및 setTexture()도 참조하세요 .

void QSGSimpleTextureNode::setRect(const QRectF &r)

이 텍스처 노드의 타깃 렉트를 r 로 설정합니다.

rect()도 참조하세요 .

void QSGSimpleTextureNode::setRect(qreal x, qreal y, qreal w, qreal h)

이것은 오버로드된 함수입니다.

이 텍스처 노드의 직사각형이 (x, y)에서 시작하고 너비 w 와 높이 h 를 갖도록 설정합니다.

void QSGSimpleTextureNode::setSourceRect(const QRectF &r)

이 텍스처 노드의 소스 렉트를 r 로 설정합니다.

sourceRect()도 참조하세요 .

void QSGSimpleTextureNode::setSourceRect(qreal x, qreal y, qreal w, qreal h)

이것은 오버로드된 함수입니다.

이 텍스처 노드의 직사각형이 (x, y)의 텍스처를 표시하도록 설정하고 너비 w 와 높이 hQSGTexture::textureSize 에 상대적으로 갖도록 설정합니다.

void QSGSimpleTextureNode::setTexture(QSGTexture *texture)

이 텍스처 노드의 텍스처를 texture 로 설정합니다.

setOwnsTexture()를 사용하여 노드가 텍스처의 소유권을 가져갈지 여부를 설정합니다. 기본적으로 노드는 소유권을 갖지 않습니다.

경고: 텍스처 노드는 렌더링할 시나리오에 추가되기 전에 텍스처가 있어야 합니다.

texture()도 참조하세요 .

void QSGSimpleTextureNode::setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode)

텍스처 좌표 생성에 사용되는 메서드를 mode 로 설정합니다. 텍스처의 올바른 방향을 얻는 데 사용할 수 있습니다. 이 옵션은 일반적으로 타사 OpenGL 라이브러리를 사용하여 텍스처에 렌더링할 때 필요하며, OpenGL은 Qt Quick 에 대해 반전된 y축을 갖기 때문입니다.

textureCoordinatesTransform()도 참조하세요 .

QRectF QSGSimpleTextureNode::sourceRect() const

이 텍스처 노드의 소스 렉트를 반환합니다.

setSourceRect()도 참조하십시오 .

QSGTexture *QSGSimpleTextureNode::texture() const

이 텍스처 노드의 텍스처를 반환합니다.

setTexture()도 참조하세요 .

QSGSimpleTextureNode::TextureCoordinatesTransformMode QSGSimpleTextureNode::textureCoordinatesTransform() const

이 노드의 텍스처 좌표를 생성하는 데 사용되는 모드를 반환합니다.

setTextureCoordinatesTransform()도 참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.