Object3D QML Type
すべての3Dノードとリソースの抽象的な基本型。詳細...
Import Statement: | import QtQuick3D |
In C++: | QQuick3DObject |
Inherits: | |
Inherited By: | 16 typesEffect, Geometry, InstanceListEntry, InstanceModel, InstanceRange, Instancing, Material, MorphTarget, Node, Particle3D, RenderExtension, ResourceLoader, SceneEnvironment, Skin, Texture, and TextureData |
プロパティ
- children : list<Object3D>
- data : list<Object>
- parent : Object3D
- resources : list<Object>
- state : string
- states : list<State>
- transitions : list<Transition>
詳細説明
Object3D はQt Quick のすべての 3D タイプの基本クラスです。これには以下が含まれます:
- 3Dシーン内のオブジェクトを表す空間タイプは、通常、位置や方向を持つ。Model Camera Lightこのような型はNode を継承し、 は Object3D を継承する。
- リソース型は、それ自身が3D世界のオブジェクトを表すのではなく、Node のサブクラスのコンポーネントとして機能し、何らかのデータを提供する。これには、Material 、Geometry 、Texture などがあります。
上記のタイプに加え、Object3Dは、次のタイプの親としても機能します。 Qt Quick itemsまた、任意のQObject インスタンスの親としても機能します。3D シーンに 2D アイテムを追加する方法については、Qt Quick 3D Scenes with 2D Content を参照してください。
Nodeも参照して ください。
プロパティ ドキュメント
children プロパティには、このオブジェクトの視覚的な子のリストが含まれます。resources プロパティには、名前で参照したい視覚的でないリソースが含まれます。
通常、子オブジェクトやリソースを追加する際にこれらのプロパティを参照する必要はありません。デフォルトのdata プロパティは、子オブジェクトを自動的にchildren
とresources
プロパティに適切に割り当てるからです。詳しくは、QtQuick3D::Object3D::data のドキュメントを参照してください。
注意: QtQuick3D::Object3D::resources は、名前に反して 3D リソースのリストを返しません。QQuickItem3DリソースはQQuickObjec3Dのサブクラスなので、QtQuick3D::Objec3D::childrenのリストで返されます。
data : list<Object> |
data プロパティは、Object3D チルドレンとリソースをオブジェクトの中に自由に混在させることができます。データリストにObject3D を代入すると、それは子になり、他のオブジェクトタイプを代入すると、それはリソースとして追加されます。
ですから、次のように書くことができます:
Object3D { Node {} DirectionalLight {} Timer {} }
と書くことができます:
Item { children: [ Node {}, DirectionalLight {} ] resources: [ Timer {} ] }
data
プロパティはObject3D のデフォルト・プロパティであるため、すべての子オブジェクトは自動的にこのプロパティに割り当てられるので、一般的には参照する必要はないはずです。
parent : Object3D |
state : string |
このプロパティは、オブジェクトの現在の状態の名前を保持する。
アイテムがデフォルト状態、つまり明示的な状態が設定されていない場合、このプロパティは空の文字列を保持する。同様に、このプロパティに空の文字列を設定することで、アイテムをデフォルトの状態に戻すことができます。
Qt Quick 状態も参照してください 。
このプロパティは、このオブジェクトの可能な状態のリストを保持します。このオブジェクトの状態を変更するには、state プロパティをこれらの状態のいずれかに設定するか、state プロパティを空の文字列に設定してオブジェクトをデフォルトの状態に戻します。
このプロパティは、State オブジェクトのリストとして指定されます。例えば、以下は "above_state "と "below_state "の状態を持つQtQuick3D::Nodeです:
import QtQuick import QtQuick3D Node { id: root y: 0 states: [ State { name: "above_state" PropertyChanges { target: root; y: 100 } }, State { name: "below_state" PropertyChanges { target: root; y: -100 } } ] }
状態と遷移の詳細については、Qt Quick の「状態」と、 Qt Quick の「アニメーションと遷移」を参照してください。
Note: このプロパティはQtQuick::Item::statesと同じ働きをしますが、QtQuick3D::Object3DはQtQuick::Itemのサブクラスではないので必要です。
QtQuick3D::Object3D::transitionsも参照してください 。
transitions : list<Transition> |
このプロパティは、このオブジェクトの遷移のリストを保持します。これらは、オブジェクトがstate を変更するたびに適用されるトランジションを定義します。
このプロパティは、Transition オブジェクトのリストとして指定されます。例えば
import QtQuick import QtQuick3D Node { transitions: [ Transition { //... }, Transition { //... } ] }
ステートとトランジションの詳細については、Qt Quick ステートと アニメーションとトランジション(Qt Quick)を参照してください。
注意: このプロパティは、QtQuick::Item::transitions と同じ働きをしますが、QtQuick3D::Object3D は QtQuick::Item のサブクラスではないので必要です。
QtQuick3D::Object3D::statesも参照してください 。
© 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.