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::NoTransform | 0x00 | テクスチャ座標は、ウィンドウ座標、つまり左上が原点となる座標系で方向付けられます。 |
QSGImageNode::MirrorHorizontally | 0x01 | テクスチャ座標は、ウィンドウ座標系に対して水平軸上で反転します。 |
QSGImageNode::MirrorVertically | 0x02 | テクスチャ座標は、ウィンドウ座標系に対して垂直軸で反転しています |
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.