Obsolete Members for Qt3DExtras

Qt3DExtras クラスの以下のメンバーは非推奨となっています。これらは、古いソースコードが引き続き動作するように提供されているものです。新しいコードでの使用は強くお勧めしません。

クラス

(deprecated) class QAbstractCameraController
(deprecated) class QConeGeometry
(deprecated) class QConeGeometryView
(deprecated) class QConeMesh
(deprecated) class QCuboidGeometry
(deprecated) class QCuboidGeometryView
(deprecated) class QCuboidMesh
(deprecated) class QCylinderGeometry
(deprecated) class QCylinderGeometryView
(deprecated) class QCylinderMesh
(deprecated) class QDiffuseMapMaterial
(deprecated) class QDiffuseSpecularMapMaterial
(deprecated) class QDiffuseSpecularMaterial
(deprecated) class QExtrudedTextGeometry
(deprecated) class QExtrudedTextMesh
(deprecated) class QFirstPersonCameraController
(deprecated) class QForwardRenderer
(deprecated) class QGoochMaterial
(deprecated) class QMetalRoughMaterial
(deprecated) class QMorphPhongMaterial
(deprecated) class QNormalDiffuseMapAlphaMaterial
(deprecated) class QNormalDiffuseMapMaterial
(deprecated) class QNormalDiffuseSpecularMapMaterial
(deprecated) class QOrbitCameraController
(deprecated) class QPerVertexColorMaterial
(deprecated) class QPhongAlphaMaterial
(deprecated) class QPhongMaterial
(deprecated) class QPlaneGeometry
(deprecated) class QPlaneGeometryView
(deprecated) class QPlaneMesh
(deprecated) class QSkyboxEntity
(deprecated) class QSphereGeometry
(deprecated) class QSphereGeometryView
(deprecated) class QSphereMesh
(deprecated) class QText2DEntity
(deprecated) class QTextureMaterial
(deprecated) class QTorusGeometry
(deprecated) class QTorusGeometryView
(deprecated) class QTorusMesh

クラスクラス

[deprecated] class Qt3DExtras::QAbstractCameraController

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QAbstractCameraController は、キーボード、マウス、その他のデバイスからの入力を設定および処理します。QAbstractCameraController は抽象クラスであるため、それ自体をインスタンス化することはできません。このクラスは、カメラコントローラ向けの標準的なインターフェースを提供します。

[deprecated] class Qt3DExtras::QConeGeometry

このクラスは非推奨となっています。新しいコードでの使用は強く推奨しません。

QConeGeometry クラスは、主にQConeMesh 内部で使用されますが、カスタムQt3DRender::QGeometryRenderer サブクラスでも使用可能です。このクラスを使用すると、円錐および円錐台を作成することができます。

[deprecated] class Qt3DExtras::QConeGeometryView

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

* * * * * * *

[deprecated] class Qt3DExtras::QConeMesh

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

[deprecated] class Qt3DExtras::QCuboidGeometry

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QCuboidGeometryクラスは、主にQCuboidMesh 内部で使用されますが、カスタムQt3DRender::QGeometryRenderer サブクラスでも使用可能です。

[deprecated] class Qt3DExtras::QCuboidGeometryView

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

* * * * * * *

[deprecated] class Qt3DExtras::QCuboidMesh

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

[deprecated] class Qt3DExtras::QCylinderGeometry

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

QCylinderGeometryクラスは、主にQCylinderMesh 内部で使用されますが、Qt3DRender::QGeometryRenderer のカスタムサブクラスでも使用可能です。

[deprecated] class Qt3DExtras::QCylinderGeometryView

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

* * * * * * *

[deprecated] class Qt3DExtras::QCylinderMesh

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

このコンポーネントは、マテリアルコンポーネントと組み合わせて使用することで、円柱をレンダリングするために利用できます。

[deprecated] class Qt3DExtras::QDiffuseMapMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

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

  • アンビエントとは、他の光源がない状態でオブジェクトから放射される色です。
  • ディフューズとは、光が粗い表面で反射した際に発せられる色です。
  • スペキュラーは、光が光沢のある表面で反射した際に発せられる色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式の効果を使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 に対応した技術が提供されています。

[deprecated] class Qt3DExtras::QDiffuseSpecularMapMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

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

  • アンビエントは、他の光源がない状態でオブジェクトから放出される色です。
  • ディフューズは、光が粗い表面で反射した際に発せられる色です。
  • スペキュラーとは、光が光沢のある表面で反射した際に現れる色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式の効果を使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 向けの技術が提供されています。

[deprecated] class Qt3DExtras::QDiffuseSpecularMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

  • アンビエントとは、他の光源がない状態でオブジェクトから放出される色のことです。
  • ディフューズは、光が粗い表面で反射する際に発せられる色です。
  • スペキュラーは、光が光沢のある表面で反射した際に発せられる色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式の効果を使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 向けの技術が提供されています。

[deprecated] class Qt3DExtras::QExtrudedTextGeometry

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QExtrudedTextGeometryクラスは、主にQText3DMesh内部で使用されますが、カスタムのQt3DRender::QGeometryRenderer サブクラスでも使用することができます。

ジオメトリの原点は、テキストのベースラインの左後端です。

[deprecated] class Qt3DExtras::QExtrudedTextMesh

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

メッシュの原点は、テキストのベースラインの左後端です。

[deprecated] class Qt3DExtras::QFirstPersonCameraController

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

利用可能なオプションは以下の通りです:

Inputアクション
マウスの左ボタンマウスの左ボタンが押されている間、x軸方向へのマウス移動でカメラがパンし、y軸方向への移動でカメラがチルトします。
マウスのスクロールホイールビューの中心を変えずに、カメラをズームイン・ズームアウトします。
Shiftキー押している間は、微調整モードが有効になります。これにより、マウスのパンおよびチルトの感度が低下します。
矢印キーカメラのビューポートを基準に、カメラを水平方向に移動します。
Page Up キーおよび Page Down キーカメラのビューポートを基準に、カメラを垂直方向に移動します。
Escシーン全体がカメラのビューポートに収まるようにカメラを移動します。

[deprecated] class Qt3DExtras::QForwardRenderer

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

フォワードレンダリングは、OpenGLが従来から採用している方式です。オブジェクトを1つずつ処理し、それぞれにシェーディングを適用しながら、バックバッファに直接レンダリングします。

QForwardRenderer は、Qt3DRender::QViewport 、Qt3DRender::QCameraSelector 、およびQt3DRender::QClearBuffers を含む、単一のリーフであるFrameGraphツリーです。QForwardRenderer には、「renderingStyle」という名前で値が「forward」であるデフォルトの要件フィルターキーがあります。テクニックをフィルタリングする必要がある場合は、このフィルターキーに基づいて行う必要があります。

デフォルトでは、ビューポートは画面全体を占め、クリアカラーは白になります。また、フラスタムカリングも有効になっています。

[deprecated] class Qt3DExtras::QGoochMaterial

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

Gooch ライティングモデルは、3D サーフェスの曲率を表現するために色と輝度の両方を用います。これは、輝度の変化のみに依存する Phong モデルなどよりも、多くの場合、優れた結果をもたらします。 CADやCAMアプリケーションのように、フォトリアリズムが目的ではない状況では、グーチのシェーディングモデルに何らかのシルエットエッジのインク処理を組み合わせた手法が一般的な解決策として採用されています。

Gooch ライティングモデルについては、Gooch の原論文で詳しく解説されています。 Goochモデルは、オブジェクトの拡散色と、ユーザーが指定したクールカラーおよびウォームカラーを混合し、カラーランプの両端点を生成します。このカラーランプは、フラグメントから光源へのベクトルとフラグメントの法線ベクトルとの間の角度のコサインに基づいて、オブジェクトにシェーディングを施すために使用されます。 オプションで、その上にスペキュラーハイライトを追加することも可能です。拡散色がクールカラーおよびウォームカラーに与える相対的な寄与は、それぞれアルファおよびベータプロパティによって制御されます。

このマテリアルは、シングル・レンダー・パス方式の効果を使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 向けのテクニックが用意されています。

[deprecated] class Qt3DExtras::QMetalRoughMaterial

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

この資料では、シングルレンダーパス方式の効果を使用し、フラグメントごとのライティング処理を行います。OpenGL 3 および OpenGL ES 3 向けのテクニックが紹介されています。

[deprecated] class Qt3DExtras::QMorphPhongMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

  • アンビエントとは、他の光源がない状態でオブジェクトから放出される色のことです。
  • ディフューズは、光が粗い表面で反射した際に発せられる色です。
  • スペキュラーは、光が光沢のある表面で反射した際に発せられる色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式のエフェクトを使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 に対応した技術が提供されています。

[deprecated] class Qt3DExtras::QNormalDiffuseMapAlphaMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

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

  • アンビエントとは、他の光源がない状態でオブジェクトから放出される色のことです。
  • ディフューズは、光が粗い表面で反射した際に放出される色です。
  • スペキュラーは、光が光沢のある表面で反射した際に放出される色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式の効果を使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 に対応した技術が提供されています。

[deprecated] class Qt3DExtras::QNormalDiffuseMapMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

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

  • アンビエントとは、他の光源が存在しない状態でオブジェクトから放射される色です。
  • ディフューズは、粗い表面が光を受けて反射する際に発せられる色です。
  • スペキュラーは、光が光沢のある表面で反射した際に放出される色です。
  • 表面の光沢度は、float 型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式のエフェクトを使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 に対応した技術が提供されています。

[deprecated] class Qt3DExtras::QNormalDiffuseSpecularMapMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

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

  • アンビエントとは、他の光源がない状態でオブジェクトから放出される色のことです。
  • ディフューズは、光が粗い表面で反射した際に発せられる色です。
  • スペキュラーは、光が光沢のある表面で反射した際に発せられる色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式の効果を使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 向けの技術が提供されています。

[deprecated] class Qt3DExtras::QOrbitCameraController

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

利用可能なオプションは以下の通りです:

Inputアクション
マウスの左ボタンマウスの左ボタンが押されている間、x軸に沿ってマウスを動かすとカメラが左右に動き、y軸に沿って動かすと上下に動きます。
マウスの右ボタン右マウスボタンを押している間、x 軸に沿ってマウスを動かすとカメラがビューの中心を軸にパンし、y 軸に沿って動かすとカメラがビューの中心を軸にチルトします。
マウスの左ボタンと右ボタンの両方マウスの左ボタンと右ボタンの両方を押している間、Y軸に沿ってマウスを動かすと、ビューの中心を変えずにカメラのズームイン・ズームアウトが行われます。
マウスのスクロールホイールビューの中心位置を変えずに、カメラのズームイン・ズームアウトを行います。
矢印キーカメラのビューポートを基準に、カメラを垂直方向および水平方向に移動させます。
Page Up キーおよび Page Down キーカメラを前後に移動します。
Shiftキー上矢印キーと下矢印キーの動作を変更し、ビューの中心位置を変えずにカメラをズームイン・ズームアウトします。その他の移動キーは無効になります。
Altキー矢印キーの動作を変更し、ビューの中心を基準にカメラをパンおよびチルトさせます。Page Up キーと Page Down キーは無効になります。
Escキーカメラを移動させ、シーン全体がカメラのビューポートに収まるようにします。

[deprecated] class Qt3DExtras::QPerVertexColorMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

この照明効果は、「アンビエント」と「ディフューズ」という 2 つの照明コンポーネントの組み合わせに基づいています。アンビエントは頂点カラーによって設定されます。ディフューズは、各頂点の法線分布を考慮に入れます。

  • アンビエントとは、他の光源がない状態でオブジェクトから発せられる色のことです。
  • ディフューズとは、光が粗い表面で反射した際に発せられる色のことです。

このマテリアルは、シングルレンダーパス方式によるエフェクトを使用し、フラグメントライティングを形成します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 に対応した技術が提供されています。

[deprecated] class Qt3DExtras::QPhongAlphaMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

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

  • アンビエントとは、他の光源がない状態でオブジェクトから放出される色のことです。
  • ディフューズは、粗い表面が光を受けて反射する際に放出される色です。
  • スペキュラーは、光が光沢のある表面で反射した際に発せられる色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。
  • アルファは、0(完全に透明)から1(不透明)までの範囲で表面の透明度を表します。

このマテリアルは、シングル・レンダー・パス方式のエフェクトを使用し、フラグメントごとのライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 に対応した技術が提供されています。

[deprecated] class Qt3DExtras::QPhongMaterial

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

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

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

  • アンビエントとは、他の光源がない状態でオブジェクトから放出される色です。
  • ディフューズは、光が粗い表面で反射した際に発せられる色です。
  • スペキュラーは、光が光沢のある表面で反射した際に放たれる色です。
  • 表面の光沢度は、float型のプロパティによって制御されます。

このマテリアルは、シングルレンダーパス方式の効果を使用し、フラグメント単位のライティングを実行します。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 向けの技術が提供されています。

[deprecated] class Qt3DExtras::QPlaneGeometry

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QPlaneGeometryクラスは、主にQPlaneMesh 内部で使用されていますが、カスタムのQt3DRender::QGeometryRenderer サブクラスでも使用可能です。

[deprecated] class Qt3DExtras::QPlaneGeometryView

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

* * * * * * *

[deprecated] class Qt3DExtras::QPlaneMesh

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

[deprecated] class Qt3DExtras::QSkyboxEntity

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

ベース名と拡張子を指定することで、Qt3DExtras::QSkyboxEntity が実行時にレンダリングされるTextureCubeMap の生成を自動的に行います。ソースディレクトリ内の画像は、以下のパターンに一致している必要があります:ベース名+ * "_posx|_posy|_posz|_negx|_negy|_negz" + 拡張子

デフォルトでは、拡張子は .png になります。

スカイボックスのレンダリングが行われるFrameGraphでは、必ずフラスタムカリングを無効にしてください。

注: スカイボックスを正射影でレンダリングしようとしないでください 。

[deprecated] class Qt3DExtras::QSphereGeometry

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

QSphereGeometryクラスは、主にQSphereMesh 内部で使用されますが、カスタムのQt3DRender::QGeometryRenderer サブクラスでも使用可能です。

[deprecated] class Qt3DExtras::QSphereGeometryView

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

* * * * * * *

[deprecated] class Qt3DExtras::QSphereMesh

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

[deprecated] class Qt3DExtras::QText2DEntity

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QText2DEntity は、テキストを XY 平面上の三角形として描画します。ジオメトリは、指定された幅と高さの矩形内に収められます。結果として得られるジオメトリが指定された幅よりも広い場合、残りの部分は改行されて描画されます。

トランスフォームコンポーネントを追加することで、シーン内にこのエンティティを配置できます。

QText2DEntity は、グリフの形状に基づいてジオメトリを作成し、指定された色を使用したソリッドマテリアルを適用します。

[deprecated] class Qt3DExtras::QTextureMaterial

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

この資料では、単一のレンダリングパスによるアプローチを用いたエフェクトを取り上げています。OpenGL 2、OpenGL 3 以降、および OpenGL ES 2 向けのテクニックが紹介されています。

[deprecated] class Qt3DExtras::QTorusGeometry

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QTorusGeometryクラスは、主にQTorusMesh 内部で使用されますが、カスタムのQt3DRender::QGeometryRenderer サブクラスでも使用可能です。

[deprecated] class Qt3DExtras::QTorusGeometryView

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

* * * * * * *

[deprecated] class Qt3DExtras::QTorusMesh

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

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