Qt Quick 3D

Qt Quick 3Dは、以下に基づいて3Dコンテンツや3Dユーザーインターフェースを作成するための高レベルAPIを提供します Qt Quick。同期の問題や追加の抽象化レイヤーを引き起こす外部エンジンを使用する代わりに、Qt Quick 3Dは、空間コンテンツ向けの既存のQt Quick シーングラフへの拡張機能と、その拡張されたシーングラフ用のレンダラーを提供します。空間シーングラフを使用することで、Qt Quick の2Dコンテンツと3Dコンテンツを混在させることが可能です。

Qt Quick また、Qt Quick 3D Xr により、3DはXRおよびVRアプリケーションにも対応しています。

モジュールの使用方法

QML API

このモジュールのQML型は、QtQuick3D によるインポートを通じて利用可能です。これらの型を使用するには、.qmlファイルに次のインポート文を追加してください：

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

ソースからのビルド

ソースからのビルドを行う際は、qtdeclarativeおよびqtshadertoolsリポジトリのモジュールとツールが先にビルドされていることを確認してください。これらがなければ、Qt Quick 3D を使用することはできません。また、キーフレームベースのアニメーションを利用するにはqtquicktimelineが利用可能であることが強く推奨されます。

さらに、一部のサンプルはQt Quick Controlsに依存しています。

モジュールの進化

「Qt Quick 3D の変更点」では、Qt 6 シリーズに向けて行われた、モジュールの API および機能に関する重要な変更点をまとめています。

記事とガイド

• Qt Quick 3D 入門例
• Qt Quick glTFアセットを用いた3D入門
• Qt Quick 3Dグラフィックスの要件
• Qt Quick 3Dアーキテクチャ
• Balsam アセットインポートツール
• 3Dアセットの最適化
• 物理ベースレンダリング
• 画像ベースのライティングの使用
• アンチエイリアシングのベストプラクティス
• Qt Quick 2Dコンテンツを含む3Dシーン
• プログラム可能なマテリアル、エフェクト、ジオメトリ、およびテクスチャデータ
• スケルトンアニメーション
• モーフィングアニメーション
• インスタンス化レンダリング
• ディテールレベル
• カスタムマテリアルエディタ
• ライトマップとグローバルイルミネーション
• シャドウマッピング
• Qt Quick 3D XR
• マルチビュー・レンダリング
• シェーダーのディスクベースのキャッシュ

例

• はじめに
• 複数のビューポートを備えたView3D
• 光と影
• 動的なモデルの作成
• Principledマテリアル
• 組み込みエフェクトとトーンマッピング
• 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 Quick

Qt Academyのコース

• Qt Quick 3D: アニメーション
• Qt Quick 3D：アセットとリソース
• Qt Quick 3D: カスタムマテリアル、レンダリング設定、ポストプロセッシング
• Qt Quick 3D：インタラクションとパフォーマンス管理
• Qt Quick 3D：ライティングとカメラ
• Qt Quick 3D：ビュー、シーン、ノード

ライセンスおよび帰属表示

Qt Quick Qt 3Dは、The Qt Companyの商用ライセンスに基づいて利用可能です。さらに、GNU General Public License（バージョン3）の下でも利用可能です。詳細については、「Qtのライセンス」を参照してください。

さらに、Qt Quick の3Dには、以下の寛容なライセンスの下で提供されるサードパーティ製モジュールが含まれている可能性があります：