AugmentedFaceNode

パブリック クラス AugmentedFaceNode

ARCore の AugmentedFace 機能を使用して顔に視覚効果をレンダリングするために使用されるノード。

この視覚効果は、最大 2 つのコンポーネント（顔メッシュとレンダリング可能な顔領域）で構成されます。

顔メッシュは、人物の顔にマッピングされた 2D 画像を可視化するために使用されます。レンダリング可能な顔領域は、ARCore で追跡される顔の領域に沿って移動する 3D オブジェクト（キツネの鼻や耳など）を可視化するために使用されます。

Renderable の顔リージョンを作成すると、リージョンはモデル内のボーンにマッピングされます。提供されたサンプル .fbx ファイルを使用して、正しい形式でレンダリング可能な顔の領域をエクスポートします。

このノードは、getCenterPose() のポーズに合わせて配置されます。

AugmentedFace がトラッキングされていない場合、または AugmentedFace が null に設定されている場合、視覚効果は無効になります。

パブリック コンストラクタ

	AugmentedFaceNode() AugmentedFace を指定せずに AugmentedFaceNode を作成します。
	AugmentedFaceNode（AugmentedFaceenhancededFace） 指定された AugmentedFace を使用して AugmentedFaceNode を作成します。

パブリック メソッド

AugmentedFace	getAugmentedFace() このノードが視覚効果を適用している AugmentedFace を返します。
マテリアル	getFaceMeshMaterialOverride() 顔メッシュのレンダリング方法を現在オーバーライドしているマテリアルを返します。
テクスチャ	getFaceMeshTexture() 顔メッシュにレンダリングされたテクスチャを返します。
ModelRenderable	getFaceRegionsRenderable() 顔の領域にマッピングされた Renderable を返します。
void	onActivate() このノードがアクティブになった場合を処理します。
void	onUpdate（FrameTime frameTime） このノードが更新されたときを処理します。
void	setAugmentedFace（AugmentedFace 顔） このノードがビジュアル エフェクトを適用する AugmentedFace を設定します。
void	setFaceMeshMaterialOverride（マテリアル マテリアル） 顔メッシュのレンダリングに使用するマテリアルを設定します。
void	setFaceMeshTexture（テクスチャ テクスチャ） 顔メッシュにレンダリングされるテクスチャを設定します。
void	setFaceRegionsRenderable（ModelRenderable レンダリング可能） 顔の領域にマッピングされるレンダリング可能を設定します。

継承されるメソッド

クラス com.google.ar.sceneform.Node から

void	addLifecycleListener(Node.LifecycleListenerlifecycleListener) ノードのライフサイクル イベントが発生したときに呼び出されるリスナーを追加します。
void	addTransformChangedListener（Node.TransformChangedListener transformChangedListener） ノードの変換が変更されたときに呼び出されるリスナーを追加します。
void	callOnHierarchy(Consumer<Node> consumer) 階層を走査し、各ノード（このノードを含む）でメソッドを呼び出します。
最終ブール値	canAddChild（Node 子、StringBuilder failureReason）
ノード	findInHierarchy(Predicate<Node> condition) 階層を走査して、条件を満たす最初のノード（このノードを含む）を探します。
最終 Vector3	getBack() このノードのワールド空間バックベクトル（+z）を取得します。
CollisionShape	getCollisionShape() このノードとの衝突に使用するシェイプを取得します。
最終 Vector3	getDown() このノードの世界空間ダウン ベクトル（-y）を取得します。
最終 Vector3	getForward() このノードの世界空間フォワード ベクトル（-z）を取得します。
最終 Vector3	getLeft() このノードのワールド空間左ベクトル（-x）を取得します。
軽め	getLight() 現在のライトを取得します。これは可変です。
最終 Vector3	getLocalPosition() 親（ローカル空間）に対するノードの位置のコピーを取得します。
最終四分位	getLocalRotation() 親（ローカル空間）に対するノードの回転のコピーを取得します。
最終 Vector3	getLocalScale() 親（ローカル空間）を基準にしてスケールされるノードのコピーを取得します。
final 文字列	getName() ノードの名前を返します。
最終ノード	getParent() このノードの親を返します。
レンダリング可能	getRenderable() このノード用にレンダリングするレンダリング可能なものを取得します。
最終 Vector3	getRight() このノードのワールド空間右ベクトル（+x）を取得します。
最終 シーン	getScene() このノードが属しているシーンを返します。シーンの一部でない場合は null を返します。
最終 Vector3	getUp() このノードの世界空間上ベクトル（+y）を取得します。
最終 Vector3	getWorldPosition() ノードの世界空間位置のコピーを取得します。
最終四分位	getWorldRotation() ノードの世界空間回転のコピーを取得します。
最終 Vector3	getWorldScale() ノードの世界空間スケールのコピーを取得します。
最終ブール値	isActive() ノードがアクティブな場合は true を返します。
最終ブール値	isDescendantOf（NodeParent 祖先） 特定のノードの親がこのノードの祖先を再帰的かどうかを確認します。
最終ブール値	isEnabled() このノードの有効状態を取得します。
ブール値	isTopLevel() このノードが最上位である場合、true を返します。
最終 Vector3	localToWorldDirection（Vector3 方向） ルートがこのノードのローカル空間からワールド空間に変換されます。
最終 Vector3	localToWorldPoint（Vector3 ポイント） このノードのローカル空間内の点をワールド空間に変換します。
void	onActivate() このノードがアクティブになった場合を処理します。
final void	onAddChild（Node 子）
void	onActivate() このノードが無効になったときに対処します。
final void	onRemoveChild（Node 子）
ブール値	onTouchEvent（HitTestResult HitTestResult、MotionEvent motionEvent） このノードがタップされた場合を処理します。
void	onTransformChange（ノード送信元ノード） このノードの変換が変更された場合を処理します。
void	onUpdate（FrameTime frameTime） このノードが更新されたときを処理します。
void	removeLifecycleListener（Node.LifecycleListenerlifecycleListener） ノードのライフサイクル イベントが発生したときに呼び出されるリスナーを削除します。
void	removeTransformChangedListener（Node.TransformChangedListener transformChangedListener） ノードの変換が変更されたときに呼び出されるリスナーを削除します。
void	setCollisionShape（CollisionShape collisionShape） この Node との競合を検出するために使用される形状を設定します。
final void	setEnabled（ブール値が有効） このノードの有効状態を設定します。
void	setLight（Light ライト） 表示する Light を設定します。
void	setLocalPosition(Vector3 position) このノードを親（ローカル空間）に対する相対位置で設定します。
void	setLocalRotation（Quaternion ローテーション） このノードの親（ローカル空間）に対する回転を設定します。
void	setLocalScale（Vector3 スケール） このノードのスケールを親（ローカル空間）に対する相対値で設定します。
final void	setLookDirection（Vector3 lookDirection） ワールド空間内でノードが向いている方向を設定します。
final void	setLookDirection（Vector3 lookDirection、Vector3 upDirection） ワールド空間内でノードが向いている方向を設定します。
final void	setName（String 名） このノードの名前を設定します。
void	setOnTapListener（Node.OnTapListener onTapListener） このノードがタップされたときに呼び出されるコールバックを登録します。
void	setOnTouchListener（Node.OnTouchListener onTouchListener） タッチイベントがこのノードにディスパッチされたときに呼び出されるコールバックを登録します。
void	setParent（NodeParent の親） このノードの親ノードを変更します。
void	setRenderable（レンダリング可能レンダリング可能） このノードに表示する Renderable を設定します。
void	setWorldPosition（Vector3 の位置） このノードの世界空間の位置を設定します。
void	setWorldRotation（Quaternion ローテーション） このノードの世界空間の回転を設定します。
void	setWorldScale（Vector3 スケール） このノードの世界空間スケールを設定します。
文字列	toString()
最終 Vector3	worldToLocalDirection（Vector3 方向） 方向をワールド空間からこのノードのローカル空間に変換します。
最終 Vector3	worldToLocalPoint（Vector3 ポイント） ワールド空間内の点をこのノードのローカル空間に変換します。

クラス com.google.ar.sceneform.NodeParent から

final void	addChild（Node 子） この NodeParent の子としてノードを追加します。
void	callOnHierarchy(Consumer<Node> consumer) 階層を走査し、各ノードでメソッドを呼び出します。
ブール値	canAddChild（Node 子、StringBuilder failureReason）
ノード	findByName（String 名） 階層を走査して、指定した名前の最初のノードを探します。
ノード	findInHierarchy(Predicate<Node> condition) 階層を走査して、条件を満たす最初のノードを見つける。
最終リスト<ノード>	getChildren() この親の子の不変のリストを返します。
void	onAddChild（Node 子）
void	onRemoveChild（Node 子）
final void	removeChild（Node 子） この NodeParent の子からノードを削除します。

java.lang.Object クラスから

オブジェクト	clone()
ブール値	equals(Object arg0)
void	finalize()
finalClass<PLURALgt;	getClass()
整数	hashCode()
final void	notify()
final void	notifyAll()
文字列	toString()
final void	wait(long arg0, int arg1)
final void	wait（long arg0）
final void	wait()

パブリック コンストラクタ

public AugmentedFaceNode ()

AugmentedFace を指定せずに AugmentedFaceNode を作成します。

public AugmentedFaceNode （AugmentedFaceenhancededFace）

指定された AugmentedFace を使用して AugmentedFaceNode を作成します。

パラメータ

EnhancedFace

パブリック メソッド

public AugmentedFace getAugmentedFace ()

このノードが視覚効果を適用している AugmentedFace を返します。

public Material getFaceMeshMaterialOverride ()

顔メッシュのレンダリング方法を現在オーバーライドしているマテリアルを返します。デフォルトは null です。

public Texture getFaceMeshTexture ()

顔メッシュにレンダリングされたテクスチャを返します。デフォルトは null です。

注: これは、顔メッシュのマテリアルがオーバーライドされていない場合にのみ使用されます。

public ModelRenderable getFaceRegionsRenderable ()

顔の領域にマッピングされた Renderable を返します。顔の領域に一致するボーンで整形する必要があります。提供されたサンプル .fbx ファイルを使用して、正しい形式でレンダリング可能な顔領域をエクスポートします。

public void onActivate ()

このノードがアクティブになった場合を処理します。ノードが有効で、シーンの一部であり、その親がアクティブである場合、ノードはアクティブになります。

ノードがアクティブになったときに行う必要がある設定をオーバーライドします。

public void onUpdate (FrameTime frameTime)

このノードが更新されたときを処理します。各フレームをレンダリングする前にノードが更新されます。この関数は、ノードがアクティブの場合にのみ呼び出されます。

各フレームで必要な更新を実行するには、オーバーライドします。

パラメータ

フレーム時間	現在のフレームの時間情報を提供します。

public void setAugmentedFace (AugmentedFace 顔)

このノードがビジュアル エフェクトを適用する AugmentedFace を設定します。

パラメータ

顔

public void setFaceMeshMaterialOverride (Material マテリアル)

顔メッシュのレンダリングに使用するマテリアルを設定します。オーバーライド マテリアルでは getFaceMeshTexture() を使用しません。null に戻して、デフォルトのマテリアルに戻します。

パラメータ

material

public void setFaceMeshTexture (テクスチャ テクスチャ)

顔メッシュにレンダリングされるテクスチャを設定します。

注: これは、顔メッシュのマテリアルがオーバーライドされていない場合にのみ使用されます。

パラメータ

質感

public void setFaceRegionsRenderable (ModelRenderable レンダリング可能)

顔の領域にマッピングされるレンダリング可能を設定します。顔の領域に一致するボーンで整形する必要があります。提供されたサンプル .fbx ファイルを使用して、正しい形式でレンダリング可能な顔領域をエクスポートします。

パラメータ

レンダリング可能