Qt Quick 3D QML Types

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

以下の記述でQtQuick3Dモジュールをインポートしてください：

import QtQuick3D

QtQuick3D QML タイプ

AddDefine	パスのシェーダーコンパイルにプリプロセッサ定義を追加します
BakedLightmap	モデルのベイク済みライトマップ設定を指定します
Buffer	エフェクトのパスで使用されるカラーバッファを作成または参照します
BufferInput	エフェクトのパスの入力として使用される入力バッファを定義します
Camera	カメラの抽象基底クラスを定義します
ColorAttachment	レンダーパスのカラーアタッチメントを定義します
Command	エフェクトのパスの一部として実行されるコマンドのスーパークラス
ContentLayer	シーンノードのグループ化およびフィルタリング用のレイヤーフラグ定数を提供するシングルトン
CubeMapTexture	3Dシーンで使用するためのキューブマップテクスチャを定義します
CustomCamera	カスタム投影行列を持つカメラを定義する
CustomMaterial	モデルのシェーディングに使用されるカスタムマテリアルを作成するための基底コンポーネント
DebugSettings	デバッグ設定の構成に使用される
DepthStencilAttachment	RenderPass用の深度・ステンシルアタッチメントを定義します
DepthTextureAttachment	パスの深度テクスチャアタッチメントを定義します
DirectionalLight	シーン内の方向性ライトを定義します
Effect	ポストプロセッシングエフェクトを作成するためのベースコンポーネント
FileInstancing	ファイルからインスタンステーブルを読み込むことを可能にする
Fog	シーンのフォグ設定を指定します
FrustumCamera	カスタムフラスタムを持つPerspectiveCameraを定義します
Geometry	カスタムジオメトリの基底型
InstanceList	QMLでインスタンス化を手動で指定可能
InstanceListEntry	InstanceList内のインスタンスを指定します
Instancing	インスタンステーブルの基底型
Joint	スケルトンアニメーション階層内のノードを定義します
Light	すべてのライト用の、作成不可能な抽象基底型
Lightmapper	シーンのライトマップベイク設定を指定します
Loader3D	URLまたはコンポーネントから3Dサブツリーを動的に読み込むことを可能にする
Material	マテリアルに共通する機能を提供する抽象基底型
Model	3Dモデルデータをロードできるようにします
MorphTarget	モーフターゲットのプロパティを定義します
Node	3Dシーン内に存在するオブジェクトの基底コンポーネント
Object3D	すべての3Dノードおよびリソースの抽象基底型
OrthographicCamera	正射影行列を持つカメラを定義する
Pass	エフェクト内のレンダーパスを定義します
PerspectiveCamera	3Dシーンのコンテンツを表示するためのパースペクティブカメラを定義します
PipelineStateOverride	単一のパスに対するパイプライン状態のオーバーライドを定義する
PointLight	シーン内のポイントライトを定義します
PrincipledMaterial	メタル/ラフネスワークフローを使用して、3Dアイテムのマテリアルを定義できるようにします
Quaternion	クォータニオン用のユーティリティ関数を提供します
QuaternionAnimation	クォータニオン用のPropertyAnimation
ReflectionProbe	シーン内のリフレクションプローブを定義します
RenderExtension	レンダリング拡張機能用の、インスタンス化できない抽象基底型
RenderPass	3Dコンテンツのレンダリング用にカスタムレンダーパスを定義します
RenderPassTexture	パス内でレンダリングターゲットとして使用するテクスチャを定義します
RenderStats	シーンのレンダリングに関する情報を提供します
RenderablesFilter	パス内で影響を与えるレンダラブルを選択するためのフィルターを定義します
Repeater3D	提供されたモデルを使用して、複数のノードベースのコンポーネントをインスタンス化します
ResourceLoader	3Dリソースのプリロードを可能にします
SceneEnvironment	シーンのレンダリング方法を設定できるようにします
SetUniformValue	1回のパス中に設定される値を定義します
Shader	ポストプロセッシングエフェクトで使用されるシェーダーコードを定義するためのコンテナコンポーネント
Skeleton	スケルトンアニメーションの階層を定義します
Skin	スキニングアニメーションを定義します
SkyMaterial	プロシージャルな空をレンダリングし、画像ベースの照明データを生成します
SpecularGlossyMaterial	スペキュラー／光沢ワークフローを使用して、3D アイテムのマテリアルを定義できるようにします
SpotLight	シーン内でスポットライトを定義します
SubRenderPass	親のRenderPassと同じレンダリングターゲット内で、作業の一部をレンダリングします
Texture	3Dシーンで使用するテクスチャを定義します
TextureData	カスタムテクスチャデータの基本タイプ
TextureInput	CustomMaterialまたはEffectのシェーダーに公開されるテクスチャを指定します
TextureProviderExtension	テクスチャを生成するレンダリング拡張機能の抽象基底型
View3D	3Dシーンをレンダリングするためのビューポートを提供します

QMLの値型

bounds	モデルの境界を指定します
pickResult	ピックの結果を含みます
renderTargetBlend	レンダリングパスの単一の色アタッチメントに対するブレンドパラメータを定義します

QtQuick3D.Helpers QML 型

次のステートメントを使用して、QtQuick3D.Helpers モジュールをインポートします:

import QtQuick3D.Helpers

AxisHelper	3Dシーン内で3つの軸とグリッドを表示するための視覚的なヘルパー
CapsuleGeometry	カプセルのジオメトリを提供します
ConeGeometry	円錐のジオメトリを提供します
CuboidGeometry	直方体のジオメトリを提供します
CylinderGeometry	円柱のジオメトリを提供します
DebugView	レンダリング統計を表示し、デバッグおよび開発者向けの操作を実行するためのビュー
ExtendedSceneEnvironment	一般的に使用されるレンダリング効果を提供するSceneEnvironment
ExtrudedTextGeometry	押し出しテキスト用のジオメトリを提供します
GridGeometry	グリッドをレンダリングするためのカスタムジオメトリプロバイダー
HeightFieldGeometry	高さフィールドのジオメトリ
InfiniteGrid	無限のグリッドを表示します
InstanceModel	インスタンステーブルに基づいたデータモデルを定義します
InstanceRange	RandomInstancing の範囲を指定します
InstanceRepeater	インスタンステーブルに基づいてコンポーネントをインスタンス化します
LodManager	詳細度の可視性の変更を処理するマネージャー
LookAtNode	常に別のノードを指し続けるように自動的に調整されるヘルパーノード
OrbitCameraController	原点を中心に回転するカメラコントローラー
PlaneGeometry	平面のジオメトリを提供します
ProceduralMesh	QMLからジオメトリを作成できるようにする
ProceduralMeshSubset	ProceduralMeshのサブセットを定義する
ProceduralSkyTextureData	HDRスカイボックスのキューブマップを生成する
ProceduralTextureData	QMLからTextureDataの作成および設定が可能
QuadTextureProvider	カスタムフラグメントシェーダーを使用してクワッドテクスチャをレンダリングするために使用されます
RandomInstancing	ランダムなインスタンス化テーブルを生成します
RenderOutputProvider	パスで提供されるテクスチャにアクセスするためのブリッジとして使用される
SimpleQuadRenderer	フルスクリーンのテクスチャ付きクワッドをメインのレンダリングターゲットにレンダリングします
SphereGeometry	球体のジオメトリを提供します
TorusGeometry	トーラスのジオメトリを提供する
WasdController	キーとマウスでノードの位置と向きを制御する

QtQuick3D.AssetUtils QML 型

次のステートメントを使用して、QtQuick3D.AssetUtils モジュールをインポートします:

import QtQuick3D.AssetUtils

RuntimeLoader

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

QtQuick3D.Particles3D QML タイプ

次の記述で QtQuick3D.Particles3D モジュールをインポートします:

import QtQuick3D.Particles3D

Affector3D	アフェクターは、パーティクルのライフサイクル中にその属性を変更します
Attractor3D	粒子を位置または形状に向かって引き寄せます
Direction3D	Directionsは、放出されるパーティクルに速度を割り当てます
DynamicBurst3D	動的エミッターバースト
EmitBurst3D	宣言型エミッターバースト
Gravity3D	粒子を、指定された方向の指定された大きさのベクトルまで加速します
LineParticle3D	ラインパーティクル
ModelBlendParticle3D	パーティクルエフェクトを3Dモデルと合成します
ModelParticle3D	Qt Quick の3Dモデルを使用したパーティクル
Particle3D	抽象論理パーティクル
ParticleAbstractShape3D	パーティクル形状の抽象基底型
ParticleCustomShape3D	エミッターおよびアフェクター用にカスタムパーティクル形状を読み込みます
ParticleEmitter3D	論理パーティクル用のエミッタ
ParticleModelShape3D	エミッターおよびアフェクター向けに、モデルからパーティクル形状を提供
ParticleSceneShape3D	エミッタおよびアフェクタ向けに、シーンからパーティクル形状を提供
ParticleShape3D	エミッターおよびアフェクター向けに3D形状を提供する
ParticleSystem3D	パーティクル、エミッター、アフェクターの各タイプを含むシステム
ParticleSystem3DLogging	パーティクルシステムに関する情報を提供する
PointRotator3D	ピボット点を軸にパーティクルを回転させる
Repeller3D	パーティクルリペラー
ScaleAffector3D	パーティクル・スケール・アフェクター
SpriteParticle3D	2Dスプライトテクスチャを使用するパーティクル
SpriteSequence3D	Spriteパーティクル向けの画像シーケンス機能を提供します
TargetDirection3D	ターゲット位置への方向を指定するため
TrailEmitter3D	他のパーティクルからの論理パーティクル用エミッター
VectorDirection3D	ターゲット方向への向きを指定するために使用します
Wander3D	パーティクルにランダムな波状の曲線を適用します

QtQuick3D.Xr QML タイプ

次のステートメントで QtQuick3D.Xr モジュールをインポートします:

import QtQuick3D.Xr

XrCamera	ユーザーがXRシーンを閲覧する空間上の位置と向きを追跡します
XrController	入力コントローラの位置と向きを追跡する、追跡対象の空間ノード
XrErrorDialog	PCVRアプリケーション用のカスタムエラーダイアログ
XrHandModel	手の3Dモデルを表します
XrHapticEffect	ハプティック効果を表します
XrHapticFeedback	XRコントローラーのハプティックフィードバックを制御する
XrInputAction	入力コントローラーからのアクションを表す
XrItem	2Dユーザーインターフェースコンテンツを表示できる、3D空間内の仮想サーフェス
XrOrigin	XrViewの原点位置
XrRuntimeInfo	XRランタイムに関する情報を表示します
XrSimpleHapticEffect	振幅、持続時間、周波数を用いてコントローラーのハプティックを設定可能
XrSpatialAnchor	実空間内の特定の位置またはオブジェクトを追跡します
XrSpatialAnchorListModel	空間アンカーを含むモデルを提供する
XrView	XRアプリケーションのビューを設定します
XrVirtualMouse	3Dコントローラーの入力を2Dアイテムのマウス入力に変換する

廃止された QML タイプ

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

A: AdditiveColorGradient

B: Blur; BrushStrokes

C: ChromaticAberration; ColorMaster

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

E: EdgeDetect; Emboss

F: Flip; FunctionSorter; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

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

以下のQML型には、現在非推奨となっているプロパティまたはメソッドが1つ以上含まれています。非推奨のメンバは、もはやメンテナンスされていません。これらは古いソースコードが動作し続けるように提供されていますが、将来のリリースで削除される可能性があります。新しいコードでは、これらの非推奨メンバを使用しないことを強く推奨します。型をクリックすると、その型の非推奨メンバを確認できます。

A: Application

B: BakedLightmap

C: Canvas

D: DragHandler

G: Gravity

H: HeightFieldGeometry

L: Light; Locale

M: Model; MouseEvent

P: PinchHandler

Q: Qt

S: Screen; SortFilterProxyModel

T: TableView; Text; TouchPoint

X: XrInputAction

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