이 페이지에서

QSGImageNode Class

QSGImageNode 클래스는 QML 장면 그래프를 사용하여 텍스처가 적용된 콘텐츠를 손쉽게 그릴 수 있도록 편의성을 위해 제공됩니다. 더 보기...

헤더: #include <QSGImageNode>
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

공개 함수

virtual ~QSGImageNode() override
virtual QSGTexture::AnisotropyLevel anisotropyLevel() const = 0
virtual QSGTexture::Filtering filtering() const = 0
virtual QSGTexture::Filtering mipmapFiltering() const = 0
virtual bool ownsTexture() const = 0
virtual QRectF rect() const = 0
virtual void setAnisotropyLevel(QSGTexture::AnisotropyLevel level) = 0
virtual void setFiltering(QSGTexture::Filtering filtering) = 0
virtual void setMipmapFiltering(QSGTexture::Filtering filtering) = 0
virtual void setOwnsTexture(bool owns) = 0
virtual void setRect(const QRectF &rect) = 0
void setRect(qreal x, qreal y, qreal w, qreal h)
virtual void setSourceRect(const QRectF &rect) = 0
void setSourceRect(qreal x, qreal y, qreal w, qreal h)
virtual void setTexture(QSGTexture *texture) = 0
virtual void setTextureCoordinatesTransform(QSGImageNode::TextureCoordinatesTransformMode mode) = 0
virtual QRectF sourceRect() const = 0
virtual QSGTexture *texture() const = 0
virtual QSGImageNode::TextureCoordinatesTransformMode textureCoordinatesTransform() const = 0

정적 공용 멤버

void rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode)

상세 설명

경고: 이미지 노드클래스는 렌더링될 장면 그래프에 추가되기 전에 텍스처를 가지고 있어야 합니다.

멤버 유형 문서

enum QSGImageNode::TextureCoordinatesTransformFlag
flags QSGImageNode::TextureCoordinatesTransformMode

TextureCoordinatesTransformFlag 열거형은 텍스처가 적용된 사각형에 대한 텍스처 좌표를 생성하는 데 사용되는 모드를 지정하는 데 사용됩니다.

상수값설명
QSGImageNode::NoTransform0x00텍스처 좌표는 창 좌표계, 즉 왼쪽 상단을 원점으로 하는 좌표계를 기준으로 정렬됩니다.
QSGImageNode::MirrorHorizontally0x01텍스처 좌표는 창 좌표계를 기준으로 수평축에서 반전됩니다.
QSGImageNode::MirrorVertically0x02텍스처 좌표는 수직축에서 창 좌표계에 대해 반전됩니다.

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

멤버 함수 설명서

[override virtual noexcept default] QSGImageNode::~QSGImageNode()

QSGImageNode 의 인스턴스를 소멸시킵니다. 이 소멸자는 가상 소멸자입니다.

[pure virtual] QSGTexture::AnisotropyLevel QSGImageNode::anisotropyLevel() const

이 이미지 노드의 이방성 수준을 반환합니다.

setAnisotropyLevel()도 참조하십시오 .

[pure virtual] QSGTexture::Filtering QSGImageNode::filtering() const

이 이미지 노드에 적용된 필터링 정보를 반환합니다.

setFiltering()도 참조하십시오 .

[pure virtual] QSGTexture::Filtering QSGImageNode::mipmapFiltering() const

이 이미지 노드에 대한 밉맵 필터링 정보를 반환합니다.

setMipmapFiltering()도 참조하십시오 .

[pure virtual] bool QSGImageNode::ownsTexture() const

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

setOwnsTexture()도 참조하십시오 .

[static] void QSGImageNode::rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode)

g 지오메트리를 texture 의 모티프, rect 의 좌표, 그리고 sourceRect 의 텍스처 좌표로 업데이트합니다.

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

texCoordMode sourceRect 를 정규화하는 데 사용됩니다.

[pure virtual] QRectF QSGImageNode::rect() const

이 이미지 노드의 대상 사각형을 반환합니다.

setRect()도 참조하십시오 .

[pure virtual] void QSGImageNode::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

이 이미지 노드의 이방성 수준을 level 로 설정합니다.

anisotropyLevel()도 참조하십시오 .

[pure virtual] void QSGImageNode::setFiltering(QSGTexture::Filtering filtering)

이 이미지 노드에 적용할 필터링을 ‘ filtering ’로 설정합니다.

부드러운 크기 조정을 하려면 ` QSGTexture::Linear`을 사용하십시오. 일반적인 크기 조정을 하려면 ` QSGTexture::Nearest`을 사용하십시오.

filtering()도 참조하십시오 .

[pure virtual] void QSGImageNode::setMipmapFiltering(QSGTexture::Filtering filtering)

이 이미지 노드에 사용할 밉맵 필터링을 filtering 로 설정합니다.

밉맵 간 부드러운 크기 조정을 원할 경우 ` QSGTexture::Linear`를 사용하십시오. 일반적인 크기 조정을 원할 경우 ` QSGTexture::Nearest`를 사용하십시오.

mipmapFiltering()도 참조하십시오 .

[pure virtual] void QSGImageNode::setOwnsTexture(bool owns)

노드가 텍스처의 소유권을 갖도록 설정하는지 여부를 ` owns`로 설정합니다.

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

ownsTexture()도 참조하십시오 .

[pure virtual] void QSGImageNode::setRect(const QRectF &rect)

이 이미지 노드의 대상 사각형을 rect 로 설정합니다.

rect()도 참조하십시오 .

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

이 이미지 노드의 직사각형이 (x, y)에서 시작하고, 너비는 w, 높이는 h 이 되도록 설정합니다.

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

[pure virtual] void QSGImageNode::setSourceRect(const QRectF &rect)

이 이미지 노드의 소스 사각형을 rect 로 설정합니다.

sourceRect()도 참조하십시오 .

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

이 이미지 노드의 사각형을 (x, y)에서 텍스처를 표시하도록 설정하며, 너비 w, 높이 h 로 지정하고, QSGTexture::textureSize 를 기준으로 상대적인 위치를 갖도록 합니다.

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

[pure virtual] void QSGImageNode::setTexture(QSGTexture *texture)

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

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

경고: 이미지노드는 렌더링되려면 씬그래프에 추가되기 전에 텍스처를 가지고 있어야 합니다.

texture()도 참조하십시오 .

[pure virtual] void QSGImageNode::setTextureCoordinatesTransform(QSGImageNode::TextureCoordinatesTransformMode mode)

텍스처 좌표를 생성하는 데 사용되는 방식을 ` mode`로 설정합니다. 이를 통해 텍스처의 올바른 방향을 얻을 수 있습니다. OpenGL은 ` Qt Quick`에 비해 y축이 반전되어 있으므로, 타사 OpenGL 라이브러리를 사용하여 텍스처에 렌더링할 때 일반적으로 이 설정이 필요합니다.

textureCoordinatesTransform()도 참조하십시오 .

[pure virtual] QRectF QSGImageNode::sourceRect() const

이 이미지 노드의 소스 사각형을 반환합니다.

setSourceRect()도 참조하십시오 .

[pure virtual] QSGTexture *QSGImageNode::texture() const

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

setTexture()도 참조하십시오 .

[pure virtual] QSGImageNode::TextureCoordinatesTransformMode QSGImageNode::textureCoordinatesTransform() const

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

setTextureCoordinatesTransform()도 참조하십시오 .

© 2026 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.