Qt Quick 3D

Qt Quick 3D は、Qt Quick をベースに 3D コンテンツや 3D ユーザーインターフェースを作成するためのハイレベルな API を提供します。Qt Quick 3D は、同期の問題や抽象化のレイヤーを追加する外部エンジンを使用するのではなく、既存のQt Quick Scene Graphsを空間コンテンツ用に拡張し、その拡張シーングラフ用のレンダラーを提供します。空間シーングラフを使用すると、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

ソースからのビルド

ソースからビルドする場合、qtdeclarativeqtshadertoolsリポジトリのモジュールとツールが最初にビルドされていることを確認してください。qtquicktimeline が利用可能であることも強く推奨します。そうしないと、キーフレームベースのアニメーションが利用できません。

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

モジュールの進化

Qt Quick 3D の変更点には、Qt 6 シリーズの Qt で行われたモジュール API と機能の重要な変更が記載されています。

記事とガイド

例題

リファレンス

Qt アカデミーコース

ライセンスと使用許諾

Qt Quick 3D は、The Qt Company の商用ライセンスの下で利用可能です。また、GNU General Public License, version 3 の下でも利用可能です。詳細はQt ライセンスをご覧ください。

さらに、Qt Quick 3Dは以下のライセンスでサードパーティモジュールを含む可能性があります:

Godot Engine: Fog

MITライセンス

Godot Engine: ProceduralSky

MITライセンス

Intel Embree, version 3.13.3

Apache ライセンス 2.0

Java Native Interface for C++, version 1.0.0

MITライセンス

JsonCpp, version 1.9.5

MIT ライセンス

Open Asset Import Library, version 5.4.3

BSD 3条項「新規」または「改訂」ライセンス

OpenXR SDK, version 1.0.34

Apache ライセンス 2.0

Tiny OpenEXR, version v1.0.9

BSD 3条項「新規」または「改訂」ライセンス

meshoptimizer, version v0.18

MITライセンス

xatlas, version 16ace528acd2cf1f16a7c0dde99c42c486488dbe

MIT ライセンス

©2024 The Qt Company Ltd. ここに含まれる文書の著作権はそれぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。