<pc-entity>

<pc-entity>タグはエンティティを定義するために使用されます。

使用法

• それは<pc-scene>、別の<pc-entity>、または<pc-node>の直接の子でなければなりません。<pc-node>の下に置くと、読み込まれたモデル内のノードの下に親子付けされます。
• それは0からn個の<pc-entity>または<pc-model>の子を持つことができます。
• それはオプションで、各コンポーネントタイプの子を1つ持つことができます：<pc-button>、<pc-camera>、<pc-collision>、<pc-element>、<pc-gsplat>、<pc-layoutchild>、<pc-layoutgroup>、<pc-light>、<pc-listener>、<pc-particles>、<pc-render>、<pc-rigidbody>、<pc-screen>、<pc-scripts>、<pc-scrollbar>、<pc-scrollview>、<pc-sounds>。

属性

属性	タイプ	デフォルト	説明
enabled	Boolean	"true"	エンティティの有効状態
name	String	-	エンティティの名前識別子
position	Vector3	"0 0 0"	「X Y Z」値としてのローカル空間位置
rotation	Vector3	"0 0 0"	度単位の「X Y Z」オイラー角としてのローカル空間回転
scale	Vector3	"1 1 1"	「X Y Z」値としてのローカル空間スケール
tags	String	-	コンマ区切りのタグのリスト

イベント

これらのイベントは、addEventListener()を使用するか、このインターフェースのoneventnameプロパティにイベントリスナーを割り当てることでリッスンできます。

イベント	説明
pointerdown	ポインターがエンティティ上で押下されたときに発生します。
pointerenter	ポインターがエンティティに入ったときに発生します。
pointerleave	ポインターがエンティティを離れたときに発生します。
pointermove	ポインターがエンティティ上で移動したときに発生します。
pointerup	ポインターがエンティティから解放されたときに発生します。

これらのイベントは、インラインの onpointer* 属性を使って宣言的に処理することもできます。これらは標準のインラインイベントハンドラーであり、ブラウザ自身によってコンパイル・実行されるため、任意のHTML要素の onclick とまったく同じように動作します。属性を（実行時であっても）設定すると以前のハンドラーが置き換えられ、削除するとハンドラーが削除されます。ハンドラー内では、this は <pc-entity> 要素であり、event はディスパッチされたイベントです。

<pc-entity name="cube"
           onpointerenter="this.entity.script.tweener.play(0)"
           onpointerleave="this.entity.script.tweener.play(1)"
           onpointerdown="this.entity.script.tweener.play(2)">
    <pc-render type="box"></pc-render>
</pc-entity>

例

<pc-entity name="MyEntity" position="1 2 3" rotation="45 0 0" scale="2 2 2" tags="tag1,tag2">
    <!-- 子エンティティとコンポーネントはここに入ります -->
</pc-entity>

JavaScriptインターフェース

EntityElement APIを使用して、<pc-entity>要素をプログラムで作成および操作できます。