Back to Qt.io
Contact Us Blog Download Qt

QPhongAlphaMaterial Class

class Qt3DExtras::QPhongAlphaMaterial

QPhongAlphaMaterial クラスは、アルファを使ったフォン照明効果のデフォルト実装を提供します。もっと詳しく...

Header: #include <QPhongAlphaMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Inherits: Qt3DRender::QMaterial
Status: Deprecated

このクラスは非推奨です。新しいコードで使用しないことを強くお勧めします。

プロパティ

パブリック関数

QPhongAlphaMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QPhongAlphaMaterial()
float alpha() const
QColor ambient() const
Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg() const
Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg() const
Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg() const
QColor diffuse() const
float shininess() const
Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg() const
Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg() const
QColor specular() const

パブリックスロット

void setAlpha(float alpha)
void setAmbient(const QColor &ambient)
void setBlendFunctionArg(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)
void setDestinationAlphaArg(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)
void setDestinationRgbArg(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)
void setDiffuse(const QColor &diffuse)
void setShininess(float shininess)
void setSourceAlphaArg(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)
void setSourceRgbArg(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)
void setSpecular(const QColor &specular)

シグナル

void alphaChanged(float alpha)
void ambientChanged(const QColor &ambient)
void blendFunctionArgChanged(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)
void destinationAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)
void destinationRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)
void diffuseChanged(const QColor &diffuse)
void shininessChanged(float shininess)
void sourceAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)
void sourceRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)
void specularChanged(const QColor &specular)

詳細説明

このクラスは非推奨です。代わりにQDiffuseSpecularMaterial を使ってください。

フォンの照明効果は、アンビエント、ディフューズ、スペキュラの3つの照明コンポーネントの組み合わせに基づいています。これらのコンポーネントの相対的な強さは、RGB 3連としてモデル化された反射率係数によって制御されます：

  • アンビエントは、他の光源がない場合に物体から発せられる色です。
  • ディフューズ（Diffuse）とは、ライトによる急激な表面反射に対して発せられる色です。
  • スペキュラ（Specular）とは、ライトによる表面の光沢のある反射に対して発せられる色です。
  • サーフェスの輝きは float プロパティで制御します。
  • Alphaは、0（完全に透明）から1（不透明）の間の表面の透明度です。

このマテリアルはシングルレンダリングパスアプローチでエフェクトを使用し、フラグメントごとにライティングを実行します。テクニックはOpenGL 2、OpenGL 3以上、OpenGL ES 2用に提供されています。

プロパティの説明

alpha : float

0から1の間で変化するオブジェクトのアルファ成分を保持します。

デフォルト値は0.5f。

アクセス関数：

float alpha() const
void setAlpha(float alpha)

通知シグナル

void alphaChanged(float alpha)

ambient : QColor

環境色を保持します。

アクセス関数

QColor ambient() const
void setAmbient(const QColor &ambient)

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

void ambientChanged(const QColor &ambient)

blendFunctionArg : Qt3DRender::QBlendEquation::BlendFunction

ブレンド方程式関数の引数を保持します。

アクセス関数

Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg() const
void setBlendFunctionArg(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)

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

void blendFunctionArgChanged(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)

Qt3DRender::QBlendEquation::BlendFunctionも参照 。

destinationAlphaArg : Qt3DRender::QBlendEquationArguments::Blending

ブレンド方程式のブレンド先のアルファブレンドの引数を保持します。

アクセス関数：

Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg() const
void setDestinationAlphaArg(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)

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

void destinationAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)

Qt3DRender::QBlendEquationArguments::Blendingも参照 。

destinationRgbArg : Qt3DRender::QBlendEquationArguments::Blending

ブレンド方程式の出力 RGB ブレンド引数を保持します。

アクセス関数：

Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg() const
void setDestinationRgbArg(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)

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

void destinationRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)

Qt3DRender::QBlendEquationArguments::Blendingも参照 。

diffuse : QColor

ディフューズカラーを保持します。

アクセス関数：

QColor diffuse() const
void setDiffuse(const QColor &diffuse)

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

void diffuseChanged(const QColor &diffuse)

shininess : float

輝度指数を保持します。

アクセス関数

float shininess() const
void setShininess(float shininess)

Notifierシグナル

void shininessChanged(float shininess)

sourceAlphaArg : Qt3DRender::QBlendEquationArguments::Blending

ブレンド方程式元アルファブレンド引数を保持します。

アクセス関数

Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg() const
void setSourceAlphaArg(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)

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

void sourceAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)

Qt3DRender::QBlendEquationArguments::Blendingも参照 。

sourceRgbArg : Qt3DRender::QBlendEquationArguments::Blending

ブレンド方程式元 RGB ブレンド引数を保持します。

アクセス関数：

Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg() const
void setSourceRgbArg(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)

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

void sourceRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)

Qt3DRender::QBlendEquationArguments::Blendingも参照 。

specular : QColor

スペキュラカラーを保持します。

アクセス関数：

QColor specular() const
void setSpecular(const QColor &specular)

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

void specularChanged(const QColor &specular)

メンバ関数 ドキュメント

[explicit] QPhongAlphaMaterial::QPhongAlphaMaterial(Qt3DCore::QNode *parent = nullptr)

親オブジェクトparent を持つ新しい QPhongAlphaMaterial インスタンスを構築します。

[virtual noexcept] QPhongAlphaMaterial::~QPhongAlphaMaterial()

QPhongAlphaMaterial を破棄します。

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