Qt Quick 3D QML Types

これは、空間レンダラーとシーングラフを使用するためのQMLフロントエンドです。今のところ、すべての3Dコンテンツは、Qt Quick のシーン（QQuickItem ）に合成できるように、オフスクリーン・テクスチャ（FBO）を経由します。

QtQuick3D モジュールをインポートするには、次のように記述します：

import QtQuick3D

QtQuick3D QML タイプ

BakedLightmap	モデルのベイクライトマップ設定を指定します。
Buffer	エフェクトのパスに使用するカラーバッファを作成または参照します。
BufferInput	Effectのパスの入力として使用する入力バッファを定義します。
Camera	カメラの抽象ベースを定義します。
Command	エフェクトのパスの一部として実行されるコマンドのスーパータイプ
CubeMapTexture	3Dシーンで使用するキューブマップテクスチャを定義します。
CustomCamera	カスタム投影行列を持つカメラを定義します。
CustomMaterial	モデルのシェーディングに使用するカスタムマテリアルを作成するためのベースコンポーネント
DebugSettings	デバッグ設定の構成に使用
DirectionalLight	シーン内の指向性ライトを定義します
Effect	ポスト処理エフェクトを作成するためのベースコンポーネントです。
FileInstancing	インスタンステーブルをファイルから読み込むことができます。
Fog	シーンのフォグ設定を指定します。
FrustumCamera	カスタムフラストラムを持つPerspectiveCameraを定義します。
Geometry	カスタムジオメトリのベースタイプ
InstanceList	QMLでインスタンスを手動で指定可能
InstanceListEntry	インスタンスリストでインスタンスを指定する
Instancing	インスタンステーブルの基本型
Joint	スケルタルアニメーション階層のノードを定義します。
Light	すべてのライトのための作成不可能な抽象ベースタイプ
Lightmapper	シーンのライトマップベイク設定を指定します。
Loader3D	URL またはコンポーネントから 3D サブツリーを動的にロードできます。
Material	マテリアルに共通する機能を提供する抽象ベースタイプ
Model	3Dモデルデータをロードできます。
MorphTarget	モーフターゲットのプロパティを定義
Node	3Dシーンに存在するオブジェクトのベースコンポーネント
Object3D	すべての3Dノードとリソースの抽象ベースタイプ
OrthographicCamera	正射投影行列を持つカメラを定義します。
Pass	エフェクトのレンダーパスを定義します。
PerspectiveCamera	3Dシーンのコンテンツを表示するためのパースペクティブカメラを定義します。
PointLight	シーン内のポイントライトを定義します。
PrincipledMaterial	メタル/ラフネスワークフローを使用して、3Dアイテムのマテリアルを定義できます。
Quaternion	クオータニオン用のユーティリティ関数を提供
QuaternionAnimation	クォータニオン用のPropertyAnimation
ReflectionProbe	シーン内の反射プローブの定義
RenderExtension	レンダリング拡張のための作成不可能な抽象ベースタイプ
RenderStats	シーンレンダリングの情報を提供
Repeater3D	提供されたモデルを使用して、多数のノードベースのコンポーネントをインスタンス化します。
ResourceLoader	3Dリソースのプリロードが可能
SceneEnvironment	シーンがどのようにレンダリングされるかを設定できます。
SetUniformValue	単一のパス中に設定される値を定義します。
Shader	ポスト処理エフェクトで使用されるシェーダコードを定義するためのコンテナコンポーネント
Skeleton	スケルタルアニメーション階層を定義
Skin	スキニングアニメーションを定義します。
SpecularGlossyMaterial	スペキュラ/グロッシーワークフローを使用して、3Dアイテムのマテリアルを定義します。
SpotLight	シーン内のスポットライトを定義
Texture	3Dシーンで使用するテクスチャを定義
TextureData	カスタムテクスチャデータのベースタイプ
TextureInput	CustomMaterialまたはEffectのシェーダに公開されるテクスチャを指定します。
View3D	3Dシーンをレンダリングするビューポートを提供します。

QML値タイプ

bounds	モデルの境界を指定する
pickResult	ピックの結果

QtQuick3D.Helpers QML タイプ

QtQuick3D.Helpersモジュールを以下の記述でインポートします：

import QtQuick3D.Helpers

AxisHelper	3Dシーンの3軸とグリッドを表示するためのビジュアルヘルパー
DebugView	レンダリングの統計情報を表示し、デバッグや開発者のアクションを実行するためのView
ExtendedSceneEnvironment	一般的に使用されるレンダリングエフェクトを提供するSceneEnvironment
GridGeometry	グリッドをレンダリングするためのカスタムジオメトリプロバイダ
HeightFieldGeometry	高さフィールドジオメトリ
InfiniteGrid	無限グリッドの表示
InstanceModel	インスタンステーブルに基づくデータモデルの定義
InstanceRange	RandomInstancing の範囲を指定する
InstanceRepeater	インスタンステーブルに基づいてコンポーネントをインスタンス化する
LodManager	詳細レベルの可視性の変更を処理するマネージャ
LookAtNode	自動的に別のノードを指し続けるヘルパーノード
OrbitCameraController	原点を中心に回転するカメラコントローラ
ProceduralMesh	QML からジオメトリを作成可能
ProceduralMeshSubset	ProceduralMesh のサブセットを定義します。
ProceduralSkyTextureData	HDRスカイボックスのキューブマップを生成
ProceduralTextureData	QMLからTextureDataの作成と配置が可能
RandomInstancing	ランダムなインスタンステーブルを生成
WasdController	キーとマウスでノードの位置と向きを制御

QtQuick3D.AssetUtilsのQMLタイプ

QtQuick3D.AssetUtilsモジュールを以下の記述でインポートします：

import QtQuick3D.AssetUtils

RuntimeLoader

実行時に3Dアセットをインポートする

QtQuick3D.Particles3D QML タイプ

QtQuick3D.Particles3Dモジュールをインポートします：

import QtQuick3D.Particles3D

Affector3D	アフェクタは、パーティクルのライフタイム中にパーティクルの属性を変更します。
Attractor3D	パーティクルを位置や形状に引き寄せます。
Direction3D	方向は、放出されたパーティクルの速度を割り当てます。
DynamicBurst3D	動的なエミッタバースト
EmitBurst3D	宣言型エミッタバースト
Gravity3D	パーティクルを指定された方向に指定された大きさのベクトルに加速する
LineParticle3D	ライン・パーティクル
ModelBlendParticle3D	パーティクル効果を3Dモデルとブレンド
ModelParticle3D	Qt Quick 3Dモデルを使ったパーティクル
Particle3D	抽象論理パーティクル
ParticleAbstractShape3D	パーティクル形状の抽象的な基本タイプ
ParticleCustomShape3D	エミッタとエフェクタ用のカスタムパーティクル形状をロード
ParticleEmitter3D	論理パーティクル用のエミッタ
ParticleModelShape3D	モデルからのパーティクル形状をエミッタとアフェクタに提供
ParticleShape3D	エミッタとエフェクタに3D形状を提供
ParticleSystem3D	パーティクル、エミッタ、アフェクタのタイプを含むシステム
ParticleSystem3DLogging	パーティクルシステムの情報を提供
PointRotator3D	ピボットポイントを中心にパーティクルを回転
Repeller3D	パーティクルリペラ
ScaleAffector3D	パーティクルスケールアフェクタ
SpriteParticle3D	2Dスプライトテクスチャを使用したパーティクル
SpriteSequence3D	スプライトパーティクルのイメージシーケンス機能を提供
TargetDirection3D	ターゲット位置に向かう方向の指定
TrailEmitter3D	他のパーティクルから論理的なパーティクルを放出するためのエミッタ
VectorDirection3D	ターゲット方向への方向指定
Wander3D	パーティクルにランダムな波カーブを適用

QtQuick3D.XrのQMLタイプ

QtQuick3D.Xrモジュールをインポートします：

import QtQuick3D.Xr

XrCamera	ユーザーがXRシーンを見る空間的な位置と方向を追跡する
XrController	入力コントローラの位置と向きを追跡する追跡空間ノード
XrErrorDialog	PCVRアプリケーション用のカスタム・エラー・ダイアログ
XrHandModel	手の3Dモデルを表す
XrInputAction	入力コントローラからのアクションを表現
XrItem	2Dユーザーインターフェースのコンテンツを保持できる3D空間の仮想サーフェス
XrOrigin	XrViewの原点位置
XrRuntimeInfo	XRランタイムに関する情報の表示
XrSpatialAnchor	実空間上の特定の場所やオブジェクトを追跡します。
XrSpatialAnchorListModel	空間アンカーを含むモデルの提供
XrView	Xrアプリケーションのビューを設定します。
XrVirtualMouse	3Dコントローラ入力を2Dアイテムのマウス入力にマッピングします。

廃止されたQMLタイプ

以下のQMLタイプは廃止されました。廃止されたQML型はメンテナンスされません。古いソースコードを動作させるために提供されていますが、将来のリリースで削除される可能性があります。これらのクラスを新しいコードで使用しないことを強くお勧めします。

A: AdditiveColorGradient

B: Blur; BrushStrokes

C: ChromaticAberration; ColorMaster

D: DefaultMaterial; DepthOfFieldHQBlur; Desaturate; DistortionRipple; DistortionSphere; DistortionSpiral

E: EdgeDetect; Emboss

F: Flip; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

廃止されたプロパティやメソッドを持つQML型

以下のQML型には、一つ以上の廃止されたプロパティやメソッドが含まれています。廃止されたメンバはもはや保守されていません。これらは古いソースコードを動作させるために提供されていますが、将来のリリースで削除される可能性があります。これらの廃止されたメンバを新しいコードで使用しないことを強くお勧めします。型をクリックすると、非推奨のメンバが表示されます。

A: Application

C: Canvas

D: DragHandler

G: Gravity

H: HeightFieldGeometry

L: Light; Locale

M: MouseEvent

P: PinchHandler

Q: Qt

S: Screen

T: TableView; Text; TouchPoint

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