Qt Quick 3D
Qt Quick 3Dは、3Dコンテンツや3Dユーザー・インターフェースを作成するための高レベルのAPIを提供します。 Qt Quick.Qt Quick 3Dは、同期の問題や抽象度のレイヤーを追加する外部エンジンを使用するのではなく、既存のQt Quick Scene Graphを空間コンテンツ用に拡張し、その拡張シーングラフ用のレンダラーを提供します。空間シーングラフを使用すると、Qt Quick 2Dコンテンツと3Dコンテンツを混在させることができる。
Qt Quick 3Dはまた、Qt Quick 3D XrでXRとVRアプリケーションを提供する。
モジュールの使用
QML API
モジュールの QML タイプは、QtQuick3D インポートから利用できます。型を使用するには、.qml ファイルに以下の import ステートメントを追加してください：
import QtQuick3D
以下のモジュールのインポートは、追加機能を提供します：
import QtQuick3D.AssetUtils import QtQuick3D.Helpers import QtQuick3D.Particles3D import QtQuick3D.Xr
C++ API
Qt モジュールの C++ API を使用するには、モジュール・ライブラリに対して直接、または他の依存関係を通 じてリンクする必要があります。CMakeや qmakeなど、いくつかのビルドツールはこのための専用サポートを持っています。
CMake でのビルド
find_package() コマンドを使用して、必要なモジュール・コンポーネントをQt6 パッケージから探します：
find_package(Qt6 REQUIRED COMPONENTS Quick3D) target_link_libraries(mytarget PRIVATE Qt6::Quick3D)
詳細については、CMakeによるビルドの概要を参照してください。
qmakeでのビルド
モジュールをqmakeでビルドするように設定するには、プロジェクトの.proファイルにQT 変数の値としてモジュールを追加します：
QT += quick3d
ソースからのビルド
Qt Quick ソースからビルドする場合、qtdeclarativeとqtshadertoolsリポジトリのモジュールとツールが最初にビルドされていることを確認してください。qtquicktimeline が利用可能であることも強く推奨します。そうしないと、キーフレームベースのアニメーションが利用できなくなるからです。
さらに、いくつかのサンプルはQt Quick Controls に依存しています。
モジュールの進化
Qt Quick 3D の変更点には、Qt 6 シリーズの Qt で行われたモジュール API と機能の重要な変更が記載されています。
記事とガイド
- Qt Quick 3D 導入の例
- Qt Quick glTF アセットを使用した 3D 導入
- Qt Quick 3D グラフィックスの要件
- Qt Quick 3Dアーキテクチャ
- バルサムアセットインポートツール
- 3Dアセットの最適化
- 物理ベースのレンダリング
- イメージベースライティングの使用
- アンチエイリアシングのベストプラクティス
- Qt Quick 2Dコンテンツによる3Dシーン
- プログラム可能なマテリアル、エフェクト、ジオメトリ、テクスチャデータ
- ビルドタイムマテリアル
- スケルトンアニメーション
- モーフィングアニメーション
- インスタンスレンダリング
- 詳細レベル
- カスタムマテリアルエディタ
- ライトマップとグローバルイルミネーション
- シャドウマッピング
- Qt Quick 3D Xr
- マルチビューレンダリング
レンダリング例
- はじめに
- 複数のビューポートを持つView3D
- ライトとシャドウ
- 動的モデルの作成
- 原則的なマテリアル
- 内蔵エフェクトとトーンマッピング
- Qt Quick 3Dシーン内のアイテム
- カスタムマテリアル
- シェーディングされていないカスタムマテリアル
- カスタムポストプロセッシングエフェクトの記述
- C++からのカスタムジオメトリの追加
- C++からカスタムテクスチャデータを追加する
- ベイクドライトマップの使用
- 簡単なVRシーンのセットアップを実演
- VRにおけるコントローラー入力のデモンストレーション
- VRにおける空間アンカーのデモ
- すべての例
リファレンス
- Qt Quick 3D QML Types
- Qt Quick 3D C++ Classes
- Qt Quick 3D Helpers QML Types
- Qt Quick 3D Asset Utility QML Types
- Qt Quick 3D Particles3D QML Types
- Qt Quick 3D Xr
関連モジュール
Qt アカデミーコース
- Qt Quick 3D: アニメーション
- Qt Quick 3D: アセットとリソース
- Qt Quick 3D: カスタムマテリアル、レンダリング設定、ポストプロセス
- Qt Quick 3D: インタラクションとパフォーマンス管理
- Qt Quick 3D: ライティングとカメラ
- Qt Quick 3D: ビュー、シーン、ノード
ライセンスと使用許諾
Qt Quick 3Dは、Qt Companyの商用ライセンスの下で利用可能です。また、GNU General Public License, version 3でも利用可能です。詳しくはQtライセンスについてをご覧ください。
さらに、Qt Quick 3Dは、以下の寛容なライセンスのサードパーティモジュールを含む可能性があります：
MITライセンス | |
MITライセンス | |
Apache ライセンス 2.0 | |
MITライセンス | |
MITライセンス | |
BSD 3条項「新規」または「改訂」ライセンス | |
Apache ライセンス 2.0 | |
BSD 3条項「新規」または「改訂」ライセンス | |
MITライセンス | |
MITライセンス |
© 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.
