QHeightMapSurfaceDataProxy Class
Q3DSurfaceWidgetItem の基底プロキシクラス。詳細...
| ヘッダー: | #include <QHeightMapSurfaceDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML内: | HeightMapSurfaceDataProxy |
| 継承元: | QSurfaceDataProxy |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QHeightMapSurfaceDataProxyは、Qt Graphs の3D用C++クラスの一部です。
プロパティ
|
パブリック関数
| QHeightMapSurfaceDataProxy(QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr) | |
| virtual | ~QHeightMapSurfaceDataProxy() override |
| bool | autoScaleY() const |
| QImage | heightMap() const |
| QString | heightMapFile() const |
| float | maxXValue() const |
| float | maxYValue() const |
| float | maxZValue() const |
| float | minXValue() const |
| float | minYValue() const |
| float | minZValue() const |
| void | setAutoScaleY(bool enabled) |
| void | setHeightMap(const QImage &image) |
| void | setHeightMapFile(const QString &filename) |
| void | setMaxXValue(float max) |
| void | setMaxYValue(float max) |
| void | setMaxZValue(float max) |
| void | setMinXValue(float min) |
| void | setMinYValue(float min) |
| void | setMinZValue(float min) |
| void | setValueRanges(float minX, float maxX, float minZ, float maxZ) |
シグナル
| void | autoScaleYChanged(bool enabled) |
| void | heightMapChanged(const QImage &image) |
| void | heightMapFileChanged(const QString &filename) |
| void | maxXValueChanged(float value) |
| void | maxYValueChanged(float value) |
| void | maxZValueChanged(float value) |
| void | minXValueChanged(float value) |
| void | minYValueChanged(float value) |
| void | minZValueChanged(float value) |
詳細な説明
QHeightMapSurfaceDataProxy は、サーフェスに関連するハイトマップデータの処理を担当します。ハイトマップをサーフェスプロットとして可視化します。
ハイトマップには X 軸や Z 軸の値が含まれていないため、これらの値は、minXValue 、maxXValue 、minZValue 、およびmaxZValue プロパティを使用して個別に指定する必要があります。X 値は画像の水平方向に対応し、Z 値は垂直方向に対応します。これらのプロパティのいずれかを設定すると、既存のハイトマップの非同期的な再解像処理がトリガーされます。
「 QSurfaceDataProxy 」 および「Qt Graphs Data Handling with 3D」も参照してください 。
プロパティのドキュメント
autoScaleY : bool
高さ値をY軸に合わせてスケーリングします。
デフォルトはfalse です。
このプロパティがtrue に設定されている場合、高さの値はminYValue からmaxYValue までの範囲に収まるようにY軸に沿ってスケーリングされます。
アクセス関数:
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
通知シグナル:
| void | autoScaleYChanged(bool enabled) |
「 minYValue 」および「maxYValue 」も参照してください 。
heightMap : QImage
このプロパティには、可視化する高さマップ画像が格納されます。
アクセス関数:
| QImage | heightMap() const |
| void | setHeightMap(const QImage &image) |
通知シグナル:
| void | heightMapChanged(const QImage &image) |
heightMapFile : QString
このプロパティには、表示される高さマップ画像を含むファイル名が格納されます。
アクセス関数:
| QString | heightMapFile() const |
| void | setHeightMapFile(const QString &filename) |
通知シグナル:
| void | heightMapFileChanged(const QString &filename) |
maxXValue : float
このプロパティは、生成されるサーフェスポイントの最大X値を保持します。
デフォルト値は10.0 です。
このプロパティを設定すると、範囲が有効な状態を維持できるよう、必要に応じて対応する最小値が調整されます。
アクセス関数:
| float | maxXValue() const |
| void | setMaxXValue(float max) |
通知シグナル:
| void | maxXValueChanged(float value) |
maxYValue : float
このプロパティには、生成されるサーフェスポイントの最大Y値が格納されます。
デフォルト値は10.0 です。
このプロパティを設定すると、範囲が有効な範囲内にとどまるよう、必要に応じて対応する最小値が調整されます。
アクセス関数:
| float | maxYValue() const |
| void | setMaxYValue(float max) |
通知シグナル:
| void | maxYValueChanged(float value) |
「autoScaleY」も参照してください 。
maxZValue : float
このプロパティは、生成されるサーフェスポイントの最大Z値を保持します。
デフォルト値は10.0 です。
このプロパティを設定すると、範囲が有効な状態を維持できるよう、必要に応じて対応する最小値が調整されます。
アクセス関数:
| float | maxZValue() const |
| void | setMaxZValue(float max) |
通知シグナル:
| void | maxZValueChanged(float value) |
minXValue : float
このプロパティは、生成されるサーフェスポイントの最小X値を保持します。
デフォルト値は0.0 です。
このプロパティを設定すると、範囲が有効な範囲内にとどまるよう、必要に応じて対応する最大値が調整されます。
アクセス関数:
| float | minXValue() const |
| void | setMinXValue(float min) |
通知信号:
| void | minXValueChanged(float value) |
minYValue : float
このプロパティは、生成されるサーフェスポイントの最小Y値を保持します。
デフォルト値は0.0 です。
このプロパティを設定すると、範囲が有効なままになるよう、必要に応じて対応する最大値が調整されます。
アクセス関数:
| float | minYValue() const |
| void | setMinYValue(float min) |
通知シグナル:
| void | minYValueChanged(float value) |
「autoScaleY」も参照してください 。
minZValue : float
このプロパティには、生成されるサーフェスポイントの最小Z値が格納されます。
デフォルト値は0.0 です。
このプロパティを設定すると、範囲が有効な範囲内にとどまるよう、必要に応じて対応する最大値が調整されます。
アクセス関数:
| float | minZValue() const |
| void | setMinZValue(float min) |
通知シグナル:
| void | minZValueChanged(float value) |
メンバ関数のドキュメント
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
指定されたparent を使用して、QHeightMapSurfaceDataProxyを生成します。
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
指定されたimage およびparent を用いて、QHeightMapSurfaceDataProxyを構築します。ハイトマップは、image を引数としてsetHeightMap()を呼び出すことで設定されます。
heightMapも参照してください 。
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
指定された画像filename およびparent から、QHeightMapSurfaceDataProxyを構築します。ハイトマップは、filename を引数としてsetHeightMapFile()を呼び出すことで設定されます。
heightMapFileも参照してください 。
[override virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
QHeightMapSurfaceDataProxy を削除します。
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
現在のデータを、image で指定された高さマップデータに置き換えます。
image にはいくつかの形式で指定できますが、直接使用可能な形式でない場合は変換が行われます。
注: 結果が間違っていると思われる場合は 、自動変換に失敗したため、設定する前にimage を自分で変換してみてください。推奨される形式は、グレースケールのQImage::Format_RGB32 です。
image がグレースケールの場合、image の高さはピクセルの赤成分から読み取られます。それ以外の場合は、ピクセルの赤、緑、青の各成分から算出された平均値となります。グレースケール画像を使用すると、大きな画像のデータ変換速度が向上する場合があります。
推奨されないフォーマット:すべてのモノクロフォーマット(例:QImage::Format_Mono )。
ハイトマップは非同期で解決されます。データの解決が完了すると、QSurfaceDataProxy::arrayReset() が発行されます。
注: プロパティ `heightMap`のセッター 関数です。
heightMap()も参照してください 。
void QHeightMapSurfaceDataProxy::setHeightMapFile(const QString &filename)
現在のデータを、filename で指定されたファイルのハイトマップデータに置き換えます。
注: プロパティ `heightMapFile`のセッター 関数です。
関連項目: heightMapFile() およびheightMap 。
void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)
すべての最小値(minX およびminZ )と最大値(maxX およびmaxZ )を同時に設定するための便利な関数です。最小値は、対応する最大値よりも小さくなければなりません。そうでない場合、値が有効となるよう調整されます。
© 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.