QAbstract3DSeries Class

QAbstract3DSeries クラスは、すべてのデータ系列の基本クラスです。詳細...

Header: #include <QAbstract3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
In QML: Abstract3DSeries
Inherits: QObject
Inherited By:

QBar3DSeries, QScatter3DSeries, and QSurface3DSeries

パブリックタイプ

enum Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint }
enum SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface }

プロパティ

パブリック関数

virtual ~QAbstract3DSeries()
QColor baseColor() const
QLinearGradient baseGradient() const
Q3DTheme::ColorStyle colorStyle() const
bool isItemLabelVisible() const
bool isMeshSmooth() const
bool isVisible() const
QString itemLabel() const
QString itemLabelFormat() const
QAbstract3DSeries::Mesh mesh() const
QQuaternion meshRotation() const
QColor multiHighlightColor() const
QLinearGradient multiHighlightGradient() const
QString name() const
void setBaseColor(const QColor &color)
void setBaseGradient(const QLinearGradient &gradient)
void setColorStyle(Q3DTheme::ColorStyle style)
void setItemLabelFormat(const QString &format)
void setItemLabelVisible(bool visible)
void setMesh(QAbstract3DSeries::Mesh mesh)
void setMeshAxisAndAngle(const QVector3D &axis, float angle)
void setMeshRotation(const QQuaternion &rotation)
void setMeshSmooth(bool enable)
void setMultiHighlightColor(const QColor &color)
void setMultiHighlightGradient(const QLinearGradient &gradient)
void setName(const QString &name)
void setSingleHighlightColor(const QColor &color)
void setSingleHighlightGradient(const QLinearGradient &gradient)
void setUserDefinedMesh(const QString &fileName)
void setVisible(bool visible)
QColor singleHighlightColor() const
QLinearGradient singleHighlightGradient() const
QAbstract3DSeries::SeriesType type() const
QString userDefinedMesh() const

シグナル

void baseColorChanged(const QColor &color)
void baseGradientChanged(const QLinearGradient &gradient)
void colorStyleChanged(Q3DTheme::ColorStyle style)
void itemLabelChanged(const QString &label)
void itemLabelFormatChanged(const QString &format)
void itemLabelVisibilityChanged(bool visible)
void meshChanged(QAbstract3DSeries::Mesh mesh)
void meshRotationChanged(const QQuaternion &rotation)
void meshSmoothChanged(bool enabled)
void multiHighlightColorChanged(const QColor &color)
void multiHighlightGradientChanged(const QLinearGradient &gradient)
void nameChanged(const QString &name)
void singleHighlightColorChanged(const QColor &color)
void singleHighlightGradientChanged(const QLinearGradient &gradient)
void userDefinedMeshChanged(const QString &fileName)
void visibilityChanged(bool visible)

詳細説明

サポートされているシリーズタイプごとに継承されたクラスがあります:QBar3DSeries QScatter3DSeries およびQSurface3DSeries

詳細はQt Data Visualization のデータ処理を参照してください。

メンバ型のドキュメント

enum QAbstract3DSeries::Mesh

定義済みのメッシュタイプ。すべてのスタイルがすべての可視化タイプで使用できるわけではありません。

定数説明
QAbstract3DSeries::MeshUserDefined0ユーザー定義メッシュ。QAbstract3DSeries::userDefinedMesh プロパティで設定。
QAbstract3DSeries::MeshBar1基本的な長方形のバー。
QAbstract3DSeries::MeshCube2基本立方体。
QAbstract3DSeries::MeshPyramid3四角錐。
QAbstract3DSeries::MeshCone4基本円錐。
QAbstract3DSeries::MeshCylinder5基本円柱。
QAbstract3DSeries::MeshBevelBar6わずかに面取りされた(丸みを帯びた)長方形の棒。
QAbstract3DSeries::MeshBevelCube7わずかに面取りされた(丸みを帯びた)立方体。
QAbstract3DSeries::MeshSphere8球体。
QAbstract3DSeries::MeshMinimal9最小の3Dメッシュ:三角錐。Q3DScatter でのみ使用可能。
QAbstract3DSeries::MeshArrow10上向きの矢印。
QAbstract3DSeries::MeshPoint112D点。Q3DScatter でのみ使用可能。影はこのスタイルに影響しません。カラースタイルQ3DTheme::ColorStyleObjectGradient はこのスタイルではサポートされていません。

enum QAbstract3DSeries::SeriesType

系列の種類。

定数説明
QAbstract3DSeries::SeriesTypeNone0シリーズタイプなし。
QAbstract3DSeries::SeriesTypeBar1Q3DBars
QAbstract3DSeries::SeriesTypeScatter2Q3DScatter のシリーズタイプ。
QAbstract3DSeries::SeriesTypeSurface4Q3DSurface のシリーズタイプ。

プロパティの説明

baseColor : QColor

このプロパティは、シリーズのベースカラーを保持する。

アクセス関数:

QColor baseColor() const
void setBaseColor(const QColor &color)

通知シグナル:

void baseColorChanged(const QColor &color)

colorStyle およびQ3DTheme::baseColorsも参照のこと

baseGradient : QLinearGradient

このプロパティは、系列のベースグラデーションを保持する。

アクセス関数:

QLinearGradient baseGradient() const
void setBaseGradient(const QLinearGradient &gradient)

ノーティファイアシグナル:

void baseGradientChanged(const QLinearGradient &gradient)

colorStyle およびQ3DTheme::baseGradientsも参照

colorStyle : Q3DTheme::ColorStyle

このプロパティは、系列のカラースタイルを保持します。

アクセス関数:

Q3DTheme::ColorStyle colorStyle() const
void setColorStyle(Q3DTheme::ColorStyle style)

ノーティファイアシグナル:

void colorStyleChanged(Q3DTheme::ColorStyle style)

Q3DTheme::ColorStyleも参照

[read-only, since QtDataVisualization 1.1] itemLabel : const QString

このプロパティはフォーマットされた項目ラベルを保持する。

選択項目がない場合、または選択項目が表示されていない場合は、空の文字列を返します。

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

アクセス関数

QString itemLabel() const

Notifier シグナル:

void itemLabelChanged(const QString &label)

itemLabelFormatも参照してください

itemLabelFormat : QString

このプロパティは、このシリーズのデータ項目のラベル形式を保持する。

このフォーマットは、項目が選択された時など、単一の項目ラベルに使用される。フォーマットがどのように解釈されるかは、シリーズタイプによって異なる:QBar3DSeries QScatter3DSeries,QSurface3DSeries

アクセス関数:

QString itemLabelFormat() const
void setItemLabelFormat(const QString &format)

Notifier シグナル:

void itemLabelFormatChanged(const QString &format)

[since QtDataVisualization 1.1] itemLabelVisible : bool

このプロパティは、グラフ内の項目ラベルの可視性を保持する。

true の場合、項目ラベルはグラフにフローティング・ラベルとして描画される。そうでない場合、項目ラベルは描画されない。外部コントロールに項目ラベルを表示するには、このプロパティをfalse に設定する。デフォルトはtrue

このプロパティは、QtDataVisualization 1.1 で導入されました。

アクセス関数:

bool isItemLabelVisible() const
void setItemLabelVisible(bool visible)

Notifier シグナル:

void itemLabelVisibilityChanged(bool visible)

itemLabelFormat およびitemLabelも参照してください

mesh : Mesh

このプロパティは、シリーズ内のアイテムのメッシュを保持する。

QSurface3DSeries の場合、このプロパティは選択ポインタを保持する。

メッシュがMeshUserDefined の場合、アイテムを正しくレンダリングするにはuserDefinedMesh プロパティも設定する必要があります。デフォルト値はグラフタイプによって異なります。

アクセス関数:

QAbstract3DSeries::Mesh mesh() const
void setMesh(QAbstract3DSeries::Mesh mesh)

通知シグナル:

void meshChanged(QAbstract3DSeries::Mesh mesh)

meshRotation : QQuaternion

このプロパティは、シリーズのすべてのアイテムに適用されるメッシュ回転を保持する。

回転は正規化されたQQuaternion でなければならない。項目ごとの回転をサポートする系列タイプでは、回転は掛け合わされます。QBar3DSeries は、y軸周り以外の回転を無視します。QSurface3DSeries は、選択ポインタにのみ回転を適用します。デフォルトは回転なし。

アクセス関数:

QQuaternion meshRotation() const
void setMeshRotation(const QQuaternion &rotation)

通知シグナル:

void meshRotationChanged(const QQuaternion &rotation)

meshSmooth : bool

こ のプ ロパテ ィ は、 定義済み メ ッ シ ュ の ス ムーズバージ ョ ン を使用す る かど う かを保持 し ます。

true の場合、mesh プロパティで設定されたスムースバージョンが使用されます。こ のプ ロパテ ィ は、 メ ッ シ ュ がMeshUserDefined に設定 さ れてい る と き に使用 さ れ る カ ス タ ム メ ッ シ ュ には影響 し ません。デフォルトはfalse です。

アクセス関数:

bool isMeshSmooth() const
void setMeshSmooth(bool enable)

通知シグナル:

void meshSmoothChanged(bool enabled)

multiHighlightColor : QColor

このプロパティは、シリーズの複数項目のハイライト色を保持する。

アクセス関数:

QColor multiHighlightColor() const
void setMultiHighlightColor(const QColor &color)

Notifier シグナル:

void multiHighlightColorChanged(const QColor &color)

colorStyle およびQ3DTheme::multiHighlightColorも参照のこと

multiHighlightGradient : QLinearGradient

このプロパティはシリーズの複数項目のハイライトグラデーションを保持する。

アクセス関数:

QLinearGradient multiHighlightGradient() const
void setMultiHighlightGradient(const QLinearGradient &gradient)

ノーティファイアシグナル:

void multiHighlightGradientChanged(const QLinearGradient &gradient)

colorStyle およびQ3DTheme::multiHighlightGradient参照

name : QString

このプロパティはシリーズ名を保持する。

このシリーズ名は、@seriesName タグを使用して項目ラベル形式で使用することができる。

アクセス関数

QString name() const
void setName(const QString &name)

アクセス関数: Notifier シグナル:

void nameChanged(const QString &name)

itemLabelFormatも参照

singleHighlightColor : QColor

このプロパティは、シリーズの単一アイテムのハイライトカラーを保持する。

アクセス関数:

QColor singleHighlightColor() const
void setSingleHighlightColor(const QColor &color)

ノーティファイアシグナル:

void singleHighlightColorChanged(const QColor &color)

colorStyle およびQ3DTheme::singleHighlightColor参照

singleHighlightGradient : QLinearGradient

このプロパティはシリーズの単一アイテムのハイライトグラデーションを保持する。

アクセス関数:

QLinearGradient singleHighlightGradient() const
void setSingleHighlightGradient(const QLinearGradient &gradient)

ノーティファイアシグナル:

void singleHighlightGradientChanged(const QLinearGradient &gradient)

colorStyle およびQ3DTheme::singleHighlightGradient参照

[read-only] type : const SeriesType

このプロパティはシリーズのタイプを保持する。

アクセス関数:

QAbstract3DSeries::SeriesType type() const

userDefinedMesh : QString

このプロパティは、オブジェクト用のユーザー定義カスタムメッシュのファイル名を保持します。

カスタムメッシュは、meshMeshUserDefined の場合に使用されます。

注: ファイルは Wavefront OBJ フォーマットで、頂点、法線、UV を含む必要があります。また、三角形である必要があります。

アクセス関数

QString userDefinedMesh() const
void setUserDefinedMesh(const QString &fileName)

Notifier シグナル:

void userDefinedMeshChanged(const QString &fileName)

visible : bool

このプロパティは、シリーズの可視性を保持します。

このプロパティがfalse の場合、系列はレンダリングされません。デフォルトはtrue

アクセス関数:

bool isVisible() const
void setVisible(bool visible)

Notifierシグナル:

void visibilityChanged(bool visible)

メンバ関数 ドキュメント

[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()

抽象3D系列を削除します。

[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)

axisangle からメッシュ回転四元数を作成する便利な関数です。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

meshRotationも参照してください

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。