Obsolete Members for Qt3DCore

Qt3DCore クラスの以下のメンバーは非推奨となっています。これらは、古いソースコードが動作し続けるように提供されているものです。新しいコードでの使用は強く推奨しません。

名前空間

クラス

名前空間

[deprecated] namespace Qt3DCore::Quick

この名前空間は非推奨となっています。新しいコードでの使用は強く推奨しません。

クラス

[deprecated] class Qt3DCore::QAbstractAspect

このクラスは非推奨となっています。新しいコードでの使用は強くお勧めしません。

[deprecated] class Qt3DCore::QAbstractFunctor

このクラスは非推奨です。新しいコードでの使用は強くお勧めしません。

QAbstractFunctor は、Qt3DCore モジュール内のすべてのファンクターおよびデータジェネレータの基底クラスとして使用されます。

ユーザーが新しいファンクタやジェネレータを定義する場合、QAbstractFunctor::id() メソッドを実装する必要があります。この実装は、クラス定義内でQT3D_FUNCTOR マクロを使用して行う必要があります。

[deprecated] class Qt3DCore::QAbstractSkeleton

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

このクラスを直接使用しないでください。ファイルからスケルトンデータを読み込む場合は（ほとんどの場合）、QSkeletonLoader を使用し、スケルトンやスキン付きメッシュデータを自分で作成する場合は（主にエディタやツールを作成する方向け）、QSkeleton を使用してください。

[deprecated] class Qt3DCore::QArmature

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

Armature コンポーネントはエンティティごとに集約され、スキニングされたメッシュを適切にレンダリングするために必要なスキニング変換行列のパレットを計算する機能を提供します。

スキニングされたメッシュの各頂点は、スケルトン内の最大4つのジョイントに関連付け（バインド）されています。 頂点に影響を与える各ジョイントについて、メッシュは、対応するジョイントの影響度を決定する重みも提供します。スキニングされた頂点の変換を実行するために使用されるスキニングパレットは、Armature によって提供され、参照されるスケルトンに含まれるジョイントから計算されます。

ジョイントのローカル変形を更新すると、スキニング行列が再計算され、そのジョイントにバインドされているスキニングメッシュの頂点がそれに応じて移動します。

[deprecated] class Qt3DCore::QAspectEngine

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

Qt3D のランループは、Qt3DRender::QAspectEngine によって制御されます。

Qt3DCore::QAbstractAspect サブクラスは、Qt3DCore::QAspectEngine::registerAspect() を呼び出すことで登録できます。これによりアスペクトの登録が処理され、その結果として Qt3DCore::QAbstractAspect::onRegistered() が呼び出されます。

シミュレーションループは、Qt3DCore::QAspectEngine にルートQt3DCore::QEntity が設定されるとすぐに開始されます。その後、各アスペクトのonEngineStartup()が呼び出され、各アスペクトがシミュレーション処理を開始できるようになります。

シミュレーションループは、ルートエンティティが Qt3DCore::QEntityPtr() に設定されると停止します。これにより、各アスペクトの onEngineShutdown() が呼び出され、各アスペクトはシミュレーション処理を停止します。

有効な新しいルートエンティティを設定すると、シミュレーションループが再開されます。

[deprecated] class Qt3DCore::QAspectJob

このクラスは非推奨となっています。新しいコードでの使用は強くお勧めしません。

[deprecated] class Qt3DCore::QAttribute

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

属性には3つの種類があります。

• VertexAttribute: 頂点ごとに読み込むデータを定義するために使用されます
• IndexAttribute: インデックス付き描画コールを使用する場合に、頂点インデックスを定義するために使用されます
• DrawIndirectAttribute: 間接描画コールを使用する場合に、使用する DrawIndirect バッファを指定するために使用されます

独自の属性を指定する場合、QAttribute::defaultPositionAttributeName() などのヘルパーを使用して属性に名前を付けるとよいでしょう。そうすることで、ジオメトリがQt3DExtras モジュールで提供されるピッキングや各種マテリアルと確実に互換性を持つようになります。

QBufferも参照してください 。

[deprecated] class Qt3DCore::QBackendNode

このクラスは非推奨となっています。新しいコードでの使用は強くお勧めしません。

[deprecated] class Qt3DCore::QBackendNodeMapper

このクラスは非推奨となっています。新しいコードでの使用は強くお勧めしません。

[since 6.0, deprecated] class Qt3DCore::QBoundingVolume

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

エンティティのバウンディングボリュームは、ピック操作やビューフラスタムカリングなど、多くの操作に使用されます。通常、これはレンダリングされるジオメトリを走査することで計算されます。

アプリケーション側でジオメトリの範囲が既知の場合、Qt 3D でそれを計算する必要がなくなるため、QBoundingVolumeを使用できます。

バウンディングボリュームは、最小および最大の範囲座標として指定するか、あるいはレンダリングされるメッシュを近似する、通常はより単純な別のジオメトリとして指定することができます。

最小および最大範囲を使用する場合、これらはジオメトリのローカル座標系において、軸整合バウンディングボックスの対角にある角とみなされます。

QBoundingVolume を使用すると、GeometryView の計算済みのバウンディングボリュームを照会することもできます。ジオメトリが変更されると、implicitMinPoint およびimplicitMaxPoint プロパティが更新されます。これはバックグラウンドスレッド上で非同期に行われるため、これらのプロパティを読み取る前に、implicitPointsValid の値を確認する必要があります。

updateImplicitBounds を呼び出すことで、暗黙的な範囲の更新を強制的に実行できます。この場合、結果が利用可能になるまで呼び出しスレッドでブロックされます。

このクラスは Qt 6.0 で導入されました。

[deprecated] class Qt3DCore::QBuffer

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

データは、QBuffer::setData() を使用して直接指定できます。

[deprecated] class Qt3DCore::QComponent

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

Qt3DCore::QComponent は、Qt3DCore::QEntity インスタンスに割り当てたり、場合によっては複数の インスタンス間で共有したりできる、動作の垂直的なスライスを提供します。

Qt3DCore::QComponent サブクラスは、多くの場合、集約するエンティティに有用な挙動を与えるグループとして集約されます。たとえば、Qt3D レンダラーによって描画されるエンティティを実現するには、そのエンティティはQt3DCore::QTransform 、Qt3DRender::QMesh 、およびQt3DRender::QMaterial コンポーネントを集約することが最も一般的です。

Qt3DCore::QEntityも参照してください 。

[since 6.0, deprecated] class Qt3DCore::QCoreSettings

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QCoreSettings コンポーネントは、シーンのルートエンティティのコンポーネントとして設定する必要があります（ただし、シーングラフ内のどこにでも配置可能です）。インスタンスは 1 つだけにしてください。

Qt 3D の動作の一部を制御するために使用できます。

このクラスは Qt 6.0 で導入されました。

[deprecated] class Qt3DCore::QEntity

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

Qt3DCore::QEntity 自体は、単なる空のシェルに過ぎません。Qt3DCore::QEntity オブジェクトの挙動は、それが参照するQt3DCore::QComponent オブジェクトによって定義されます。各Qt3Dバックエンドアスペクトは、エンティティがどのコンポーネントで構成されているかを認識することで、そのエンティティを解釈・処理することができます。あるアスペクトは、単一のQt3DCore::QTransform コンポーネントのみで構成されるエンティティのみを処理することに決定する一方、別のアスペクトはQt3DInput::QMouseHandler に焦点を当てることもあります。

Qt3DCore::QComponent およびQt3DCore::QTransformも参照してください 。

[deprecated] class Qt3DCore::QGeometry

このクラスは非推奨となっています。新しいコードでの使用は強く推奨しません。

Qt3DCore::QGeometry クラスは、Qt3DCore::QAttribute オブジェクトのリストをグループ化し、Qt3DがQt3DCore::QGeometryRendererを使用してレンダリング可能な幾何学的形状を形成するために使用されます。形状のバウンディングボリュームを計算するために、特別な属性を設定することができます。

[since 6.0, deprecated] class Qt3DCore::QGeometryView

このクラスは非推奨です。新しいコードでの使用は強くお勧めしません。

GeometryView は、Geometryを扱うために必要なすべての情報を保持しています。Geometryはジオメトリデータの座標を保持しており、GeometryView はそのデータの解釈方法を指定します。

このクラスはQt 6.0で導入されました。

[deprecated] class Qt3DCore::QJoint

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QJoint ノードは、Qt 3D におけるスキンメッシュ機能の一環として、スケルトンを構築するために使用されます。ジョイントは、スケール、回転、並進のプロパティによって変形させることができます。ジョイントにバインドされているメッシュの頂点については、その変形がそれに応じて更新されます。

[deprecated] class Qt3DCore::QNode

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QNode の所有関係は、ノード間のQObject による親子関係によって決定されます。QNode自体は、視覚的な外観も特定の意味も持ちません。これは、ノードベースのツリー構造を構築するための手段として存在しています。

QNodeインスタンスの親は、別のQNodeインスタンスのみとなります。

各 QNode インスタンスには一意の ID が付与されており、これにより他のインスタンスと区別することができます。

QNode のサブクラスでプロパティが定義されると、その NOTIFY シグナルによって、Qt3D バックエンドが受信する通知が自動的に生成されます。

QEntity およびQComponentも参照してください 。

[deprecated] class Qt3DCore::QNodeId

このクラスは非推奨となっています。新しいコードでの使用は強く控えることをお勧めします。

[deprecated] class Qt3DCore::QSkeleton

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

スキニングされたメッシュで使用するためのスケルトンのジョイントを手動で作成したい場合は、QSkeleton を使用してください。これは主に、エディタ、ツール、または動的なスケルトンを作成するユーザー向けです。Qt 3D アプリケーションでは、Blender などのデジタルコンテンツ作成ツールで作成された既存のスケルトンやスキニングされたメッシュをそのまま利用するのが一般的です。 このユースケースについては、QSkeletonLoader を参照してください。

[deprecated] class Qt3DCore::QSkeletonLoader

このクラスは非推奨となっています。新しいコードでの使用は強く推奨しません。

Skeleton や Joints を使用して手動でジョイントを作成するのではなく、ファイルからスケルトン全体を読み込みたい場合は、SkeletonLoader を使用してください。 スケルトンの作成や、メッシュの頂点をスケルトンにバインドする作業は、Blenderなどの3Dデジタルコンテンツ制作ツールで行うのが最も簡単です。作成されたスケルトンとメッシュは、Qt 3D で利用できるよう、glTF 2などの適切な形式でエクスポートできます。

[deprecated] class Qt3DCore::QTransform

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

QTransformコンポーネントは、複数のQEntity 間で共有することはできません。変換は、QVector3D （スケール）、QQuaternion （回転）、QVector3D （平行移動）の各コンポーネントとして保持されます。これらの変換は、その順序でメッシュに適用されます。QTransform::matrix プロパティが設定されると、それはこれらの変換コンポーネントに分解され、対応するシグナルが発信されます。

QTransformの設定には、いくつかのヘルパー関数が用意されています。fromAxisAndAngle およびfromAxesAndAngles は特定の軸周りの回転を設定するために使用でき、fromEulerAngles はオイラー角に基づいて回転を設定するために使用でき、rotateAround はローカル原点に対する特定の点を中心にオブジェクトを回転させるために使用できます。