このページでは

HeightMapSurfaceDataProxy QML Type

Surface3D の基本プロキシ型。もっと見る...

Import Statement: import QtDataVisualization 1.11
Since: QtDataVisualization 1.0
In C++: QHeightMapSurfaceDataProxy
Inherits:

SurfaceDataProxy

プロパティ

詳細説明

HeightMapSurfaceDataProxyは、サーフェスに関連する高さマップデータの処理を行う。これは、サーフェスプロットとして可視化される高さマップを与える方法を提供します。

より詳しい説明はQHeightMapSurfaceDataProxy を参照。

Qt Data Visualization データ処理も参照してください

プロパティ・ドキュメント

autoScaleY : real [since 6.3]

高さ値を Y 軸にスケーリングする。デフォルトはfalse です。このプロパティをtrue に設定すると、高さ値はminYValuemaxYValue の間の Y 軸に収まるようにスケーリングされます。

このプロパティは Qt 6.3 で導入されました。

heightMapFile : string

可視化する高さマップ画像のファイル。このプロパティを設定すると、現在のデータが高さマップデータに置き換えられます。

画像ファイルにはいくつかの形式がありますが、直接使用できる形式でない場合は変換が行われます。

注意: もし結果が間違っているようであれば、自動変換に失敗しているので、設定する前に自分で画像を変換してみてください。望ましい形式はグレースケールでQImage::Format_RGB32

画像の高さは、画像がグレースケールの場合はピクセルの赤成分から読み取られ、そうでない場合はピクセルの赤、緑、青成分から計算された平均値となります。グレースケール画像を使用すると、大きな画像のデータ変換速度が向上する可能性があります。

高さマップはX軸やZ軸の値を含まないので、それらの値はminXValue,maxXValue,minZValue,maxZValue プロパティを用いて個別に与える必要があります。X値は画像の水平方向に対応し、Z値は垂直方向に対応する。これらのプロパティのいずれかを設定すると、既存のハイトマップが非同期で再解析されます。

推奨されないフォーマット:すべてのモノ・フォーマット(例えばQImage::Format_Mono )。

maxXValue : real

生成されるサーフェス点の最大X値。デフォルトは10.0 。このプロパティを設定すると、必要に応じて対応する最小値が調整され、有効な範囲が維持されます。

maxYValue : real [since 6.3]

生成されるサーフェス点の最大Y値。デフォルトは10.0 です。このプロパティを設定すると、必要に応じて対応する最小値が調整され、有効な範囲が維持されます。

このプロパティは Qt 6.3 で導入されました。

maxZValue : real

生成されるサーフェス点のZ値の最大値。デフォルトは10.0 です。このプロパティを設定すると、必要に応じて対応する最小値が調整され、有効な範囲が維持されます。

minXValue : real

生成されるサーフェスポイントのX値の最小値。デフォルトは0.0 。このプロパティを設定すると、必要に応じて対応する最大値が調整され、有効な範囲が維持されます。

minYValue : real [since 6.3]

生成されるサーフェス点のY値の最小値。デフォルトは0.0 です。このプロパティを設定すると、必要に応じて対応する最大値が調整され、有効な範囲が維持されます。

このプロパティは Qt 6.3 で導入されました。

minZValue : real

生成されるサーフェス点のZ値の最小値。デフォルトは0.0 。このプロパティを設定すると、必要に応じて対応する最大値が調整され、有効な範囲が維持されます。

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