โหนดใบหน้า Augmented

คลาสสาธารณะ AugmentedFaceNode

โหนดที่ใช้แสดงผลเอฟเฟกต์ภาพบนใบหน้าด้วยฟีเจอร์ AugmentedFaceของ ARCore

เอฟเฟกต์ภาพประกอบด้วยองค์ประกอบ 2 อย่าง ได้แก่ ตาข่ายและพื้นที่ที่ใบหน้าแสดงผลได้

ตาข่ายใช้สําหรับแสดงภาพ 2 มิติที่เชื่อมโยงกับพื้นผิวของใบหน้า พื้นที่ใบหน้าที่แสดงผลได้ใช้สําหรับแสดงภาพวัตถุ 3 มิติ (เช่น จมูกและหูของสุนัขจิ้งจอก) ซึ่งจะย้ายไปยังบริเวณของใบหน้าที่ ARCore ติดตาม

เมื่อสร้างพื้นที่ใบหน้าที่แสดงได้ ภูมิภาคจะจับคู่กับกระดูกในโมเดล ใช้ไฟล์ .fbx ตัวอย่างที่ให้ไว้ เพื่อส่งออกเขตใบหน้าที่แสดงได้ในรูปแบบที่ถูกต้อง

โหนดนี้อยู่ในตําแหน่งให้ตรงกับท่าทางจาก getCenterPose()

ระบบจะปิดใช้เอฟเฟกต์ภาพเมื่อ AugmentedFace ไม่ติดตาม หรือตั้งค่า AugmentedFace เป็น Null

ผู้ผลิตก่อสร้าง

AugmentedFaceNode()
สร้าง AugmentedFaceNode โดยไม่ใช้ AugmentedFace
AugmentedFaceNode(AugmentedFace augmentedFace)
สร้าง AugmentedFaceNode ด้วย AugmentedFace ที่ระบุ

วิธีการสาธารณะ

AugmentedFace
getAugmentedFace()
แสดง AugmentedFace ที่โหนดนี้ใช้เอฟเฟกต์ภาพอยู่
วัสดุ
getFaceMeshMaterialการลบล้าง()
แสดงวัสดุที่ลบล้างวิธีแสดงผลตาข่ายหน้าอยู่ในขณะนี้
พื้นผิว
getFaceMeshTexture()
แสดงผลพื้นผิวที่แสดงผลบนตาข่าย
ModelRenderable
getFaceRegionsRenderable()
แสดงผล Renderable ที่แมปกับภูมิภาคที่ใบหน้า
เป็นโมฆะ
onActivate()
จัดการเมื่อโหนดนี้เริ่มทํางาน
เป็นโมฆะ
onUpdate(FrameTimeFrameTime)
จัดการเมื่ออัปเดตโหนดนี้
เป็นโมฆะ
setAugmentedFace(AugmentedFace ใบหน้า)
ตั้งค่า AugmentedFace ที่โหนดนี้ใช้เอฟเฟกต์ภาพ
เป็นโมฆะ
setFaceMeshMaterialOverride(วัสดุ Material)
ตั้งค่าวัสดุที่ใช้ในการแสดงผล Mesh Mesh
เป็นโมฆะ
setFaceMeshTexture(พื้นผิว พื้นผิว)
ตั้งค่าพื้นผิวที่แสดงผลบนตาข่าย
เป็นโมฆะ
setFaceRegionsRenderable(แสดงผลได้โดย ModelRenderable)
ตั้งค่า Renderable ที่แมปกับภูมิภาคของใบหน้า

วิธีการที่รับค่ามา

ผู้ผลิตก่อสร้าง

สาธารณะ AugmentedFaceNode ()

สร้าง AugmentedFaceNode โดยไม่ใช้ AugmentedFace

สาธารณะ AugmentedFaceNode (AugmentedFace augmentedFace)

สร้าง AugmentedFaceNode ด้วย AugmentedFace ที่ระบุ

พารามิเตอร์
ใบหน้าที่เพิ่มประสิทธิภาพ

วิธีการสาธารณะ

สาธารณะ AugmentedFace getAugmentedFace ()

แสดง AugmentedFace ที่โหนดนี้ใช้เอฟเฟกต์ภาพอยู่

สาธารณะ Material getFaceMeshMaterialOverride ()

แสดงวัสดุที่ลบล้างวิธีแสดงผลตาข่ายหน้าอยู่ในขณะนี้ ค่าเริ่มต้นคือ Null

สาธารณะ พื้นผิว getFaceMeshTexture ()

แสดงผลพื้นผิวที่แสดงผลบนตาข่าย ค่าเริ่มต้นคือ Null

หมายเหตุ: การดําเนินการนี้จะใช้เฉพาะในกรณีที่ไม่มีการลบล้างวัสดุที่โครงตาข่าย

สาธารณะ ModelRenderable getFaceRegionsRenderable ()

แสดงผล Renderable ที่แมปกับภูมิภาคที่ใบหน้า เครื่องมือชิ้นนี้ต้องใช้กระดูกที่หนาและตรงกับภูมิภาคของใบหน้า ใช้ไฟล์ .fbx ตัวอย่างที่ให้ไว้ เพื่อส่งออกพื้นที่ใบหน้าที่แสดงผลในรูปแบบที่ถูกต้อง

โฟลเดอร์สาธารณะ onActivate ()

จัดการเมื่อโหนดนี้เริ่มทํางาน โหนดจะทํางานหากเปิดใช้ เป็นส่วนหนึ่งของฉาก และโหนดหลักทํางานอยู่

ลบล้างเพื่อดําเนินการตั้งค่าที่จําเป็นเมื่อเปิดใช้งานโหนด

สาธารณะ null onUpdate (FrameTimeframeTime)

จัดการเมื่ออัปเดตโหนดนี้ ระบบจะอัปเดตโหนดก่อนแสดงผลแต่ละเฟรม การดําเนินการนี้เรียกใช้เฉพาะเมื่อโหนดทํางานอยู่

ลบล้างเพื่อดําเนินการอัปเดตที่จําเป็นต้องเกิดขึ้นในแต่ละเฟรม

พารามิเตอร์
เวลาที่ใช้ในการแสดงผลเฟรม ให้ข้อมูลเวลาของเฟรมปัจจุบัน

โฟลเดอร์สาธารณะ setAugmentedFace (AugmentedFace))

ตั้งค่า AugmentedFace ที่โหนดนี้ใช้เอฟเฟกต์ภาพ

พารามิเตอร์
ใบหน้า

สาธารณะ null setFaceMeshMaterialOverride (Material Material)

ตั้งค่าวัสดุที่ใช้ในการแสดงผล Mesh Mesh เนื้อหาที่ใช้การลบล้างจะไม่ใช้ getFaceMeshTexture() ตั้งค่าเป็น Null เพื่อเปลี่ยนกลับไปใช้เนื้อหาเริ่มต้น

พารามิเตอร์
วัสดุ

สาธารณะ null setFaceMeshTexture (พื้นผิว)

ตั้งค่าพื้นผิวที่แสดงผลบนตาข่าย

หมายเหตุ: การดําเนินการนี้จะใช้เฉพาะในกรณีที่ไม่มีการลบล้างวัสดุที่โครงตาข่าย

พารามิเตอร์
พื้นผิว

สาธารณะ null setFaceRegionsRenderable (ModelRenderable ที่แสดงผลได้)

ตั้งค่า Renderable ที่แมปกับภูมิภาคของใบหน้า เครื่องมือชิ้นนี้ต้องใช้กระดูกที่หนาและตรงกับภูมิภาคของใบหน้า ใช้ไฟล์ .fbx ตัวอย่างที่ให้ไว้ เพื่อส่งออกพื้นที่ใบหน้าที่แสดงผลในรูปแบบที่ถูกต้อง

พารามิเตอร์
แสดงผลได้