このページでは

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) からのテクスチャを表示するようにします。また、QSGTexture::textureSize に対する相対位置として、幅をw 、高さをh に設定します。

これはオーバーロードされた関数です。

[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.