QHeightMapSurfaceDataProxy Class

Q3DSurface のベースプロキシクラスです。さらに...

ヘッダ #include <QHeightMapSurfaceDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
以来:QtDataVisualization 1.0
QML で: HeightMapSurfaceDataProxy
継承: QSurfaceDataProxy

プロパティ

パブリック機能

QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
virtual ~QHeightMapSurfaceDataProxy()
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 Data Visualization データ処理も参照してください

プロパティの説明

[since 6.3] autoScaleY : bool

高さの値を Y 軸にスケーリングする。

デフォルトはfalse

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

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

アクセス関数

bool autoScaleY() const
void setAutoScaleY(bool enabled)

Notifier シグナル:

void autoScaleYChanged(bool enabled)

minYValuemaxYValueも参照してください

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)

[since 6.3] maxYValue : float

このプロパティは、生成されるサーフェスポイントの最大Y値を保持します。

デフォルトは10.0 です。

このプロパティを設定すると、必要に応じて対応する最小値が調整され、有効な範囲が維持されます。

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

アクセス関数

float maxYValue() const
void setMaxYValue(float max)

Notifier シグナル:

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)

[since 6.3] minYValue : float

このプロパティは、生成されたサーフェスポイントのY値の最小値を保持します。

デフォルトは0.0 です。

このプロパティを設定すると、必要に応じて対応する最大値が調整され、有効な範囲が維持されます。

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

アクセス関数

float minYValue() const
void setMinYValue(float min)

Notifier シグナル:

void minYValueChanged(float value)

autoScaleYも参照してください

minZValue : float

このプロパティは、生成されたサーフェス点のZ値の最小値を保持します。

デフォルトは0.0 です。

このプロパティを設定すると、必要に応じて対応する最大値が調整され、有効な範囲が維持されます。

アクセス関数

float minZValue() const
void setMinZValue(float min)

Notifierシグナル:

void minZValueChanged(float value)

メンバ関数 ドキュメント

[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)

与えられたparent で QHeightMapSurfaceDataProxy を構築する。

[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)

与えられたimageparent で QHeightMapSurfaceDataProxy を構築します。 高さマップは、imagesetHeightMap() を呼び出すことで設定されます。

heightMapも参照してください

[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)

与えられた画像filenameparent から QHeightMapSurfaceDataProxy を構築します. 高さマップは,filename とともにsetHeightMapFile() を呼び出すことで設定されます.

heightMapFileも参照してください

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

すべての最小値 (minXminZ) と最大値 (maxXmaxZ) を同時に設定するための便利な関数。最小値は対応する最大値より小さくなければならない。そうでない場合、値は有効であるように調整されます。

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