OverlapParams

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ประเภทข้อมูล OverlapParams เก็บพารามิเตอร์สำหรับใช้กับฟังก์ชันการค้นหาขอบเขต WorldRoot โดยเฉพาะอย่างยิ่ง WorldRoot:GetPartBoundsInBox() , WorldRoot:GetPartBoundsInRadius() และ WorldRoot:GetPartsInPart()คุณสมบัติ OverlapParams.FilterDescendantsInstances เก็บคอลเลกชันของวัตถุที่จะใช้เป็นรายการรวมหรือรายการยกเว้นตามรายการเลือก OverlapParams.FilterType และคุณสมบัติ OverlapParams.CollisionGroup สามารถกำหนดกลุ่มการชนกันสำหรับการดำเนินการคำถามเส้นขอบได้

ไม่เหมือนกับประเภทข้อมูลส่วนใหญ่ใน Luau คุณสามารถเปลี่ยนสมาชิกทั้งหมดของ OverlapParams โดยไม่ต้องสร้างวัตถุใหม่ ทำให้คุณสามารถนำวัตถุเดียวกันซ้ำแล้วซ้ำอีกได้

สรุป

คอนสตรัคเตอร์

คุณสมบัติ

  • ชุดของวัตถุที่ลูกหลานถูกใช้ในการกรองผู้สมัคร

  • กำหนดวิธีการใช้รายการ OverlapParams.FilterDescendantsInstances

  • จํานวนชิ้นส่วนสูงสุดที่จะถูกส่งคืนโดยคําถาม

  • กลุ่มการชนที่ใช้สำหรับการดำเนินการ

  • กำหนดว่าการดำเนินการตรวจสอบขอบจะพิจารณามูลค่าคุณสมบัติของส่วน BasePart.CanCollide หรือไม่เกี่ยวกับมูลค่าของมันเหนือค่า BasePart.CanQuery ของมัน

  • เมื่อเปิดใช้งานแล้ว คำสอบถามจะเพิกเฉยคุณสมบัติการชนกันของส่วนทั้งหมดและดำเนินการตรวจสอบด้วยกำลังทางกายภาพกับทุกส่วน

วิธีการ

คอนสตรัคเตอร์

new

ส่งคืนวัตถุว่างเปล่า OverlapParamsไม่เหมือนกับตัวสร้างประเภทข้อมูลอื่นๆ ตัวสร้างนี้ไม่มีพารามิเตอร์ใดๆ ดังนั้นคุณควรตั้งค่าคุณสมบัติของมันอย่างเหมาะสม

คุณสมบัติ

FilterDescendantsInstances

ชุดของวัตถุที่ลูกหลานถูกใช้ในการกรองผู้สมัคร

กำหนดวิธีการใช้แอร์ราย์ OverlapParams.FilterDescendantsInstances ขึ้นอยู่กับที่ Enum.RaycastFilterType ให้ไว้ ค่าเริ่มต้นคือ Enum.RaycastFilterType.Exclude

MaxParts

จํานวนชิ้นส่วนสูงสุดที่จะถูกส่งคืนโดยคำถาม ค่าเริ่มต้นของศูนย์ ( 0 ) ไม่มีขีดจํากัด

CollisionGroup

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

RespectCanCollide

คุณสมบัตินี้, ถ้า true , ทำให้การดำเนินการตรวจสอบขอบใช้มูลค่า BasePart.CanCollide ของส่วนที่ซ้อนทับในความโปรดของมูลค่า BasePart.CanQuery เมื่อกำหนดว่าส่วนนั้นรวมอยู่ในอาร์เรย์ของผลการค้นหาในพื้นที่หรือไม่

BruteForceAllSlow

เมื่อเปิดใช้งานแล้ว คำสอบถามจะเพิกเฉยคุณสมบัติการชนกันของส่วนทั้งหมดและดำเนินการตรวจสอบด้วยกำลังทางกายภาพกับทุกส่วนจะส่งผลเสียต่อประสิทธิภาพและไม่ควรใช้ในประสบการณ์สด

วิธีการ

AddToFilter

()
เขียนพร้อมๆ กัน

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

พารามิเตอร์

instances: Instance | Array

ตัวอย่างหรือคอลเลกชันที่มีตัวอย่างเพื่อเพิ่ม

ส่งค่ากลับ

()