ตัวเก็บ UI ในประสบการณ์

ตัวเก็บ UI ในประสบการณ์จะถือ GuiObjects ที่คุณต้องการแสดงในโลก 3 มิติของประสบการณ์ของคุณ

• SurfaceGui อนุญาตให้สามารถแสดง UI object ลงบนพื้นผิวของชิ้นส่วนในโลก 3 มิติ ขณะเดียวกันก็อนุญาตให้มีการโต้ตอบของผู้ใช้พื้นฐานได้
• BillboardGui เป็นตัวเก็บสำหรับ UI objects ที่จะแสดงในพื้นที่ 3 มิติ แต่จะหันไปทางกล้องเสมอ

UI พื้นผิว

คล้ายกับ Decals และ Textures, UI objects เช่น TextLabels และ ImageLabels ที่ถูกตั้งค่าให้เป็นลูกของ SurfaceGui จะหันไปในทิศทางเดียวกับพื้นผิวที่มันอยู่ โดยสามารถแก้ไขได้ผ่านคุณสมบัติ SurfaceGui.Face

ในการประยุกต์ใช้ SurfaceGui กับ BasePart ในประสบการณ์ ให้ตั้งเป็นลูกของชิ้นส่วนนั้นและตั้งค่าคุณสมบัติ SurfaceGui.Face คำสั่ง UI เป็นลูกสามารถปรากฏบนพื้นผิวของชิ้นส่วนหลักนั้นได้

หรือคุณสามารถวาง SurfaceGui ไว้ในตัวเก็บเช่น StarterGui และตั้งค่าคุณสมบัติ Adornee ให้กับชิ้นส่วน BasePart ใดๆ รวมถึง Face ที่ต้องการ การตั้งค่าคุณสมบัติ Adornee จะแทนที่การเชื่อมโยงโดยตรง ทำให้มีความยืดหยุ่นมากขึ้นในเรื่องการวาง เนื่องจากสามารถตั้งค่าได้จากสคริปต์ระหว่างการทำงาน

ขนาดและตำแหน่ง

"ผืนผ้าใบ" ของ SurfaceGui จะใช้พื้นที่ทั้งหมดของ Face ของพ่อแม่หรือชิ้นส่วน Adornee เป็นการปฏิบัติที่ดีที่สุด แนะนำให้ใช้ค่า scale สำหรับ ขนาด และ ตำแหน่ง ของ UI objects ลูกที่เป็นเช่น ImageLabels คุณยังสามารถใช้ UIAspectRatioConstraint กับลูกของ SurfaceGui เพื่อรักษาสัดส่วนที่ต้องการไม่ว่าจะมีการเปลี่ยนขนาดของพื้นผิวอย่างไร

โหมดการบัง

คุณสมบัติ AlwaysOnTop จะกำหนดว่าตัวเก็บ SurfaceGui จะเรนเดอร์เหนือเนื้อหา 3 มิติหรือถูกบังโดยเนื้อหานั้น เมื่อกำหนดเป็น false (ค่าเริ่มต้น) SurfaceGui จะทำงานเหมือนเนื้อหา 3 มิติอื่นๆ และจะถูกบังโดยวัตถุ 3 มิติอื่นๆ เมื่อกำหนดเป็น true, มันจะเรนเดอร์เหนือเนื้อหาบน 3 มิติเสมอและจะไม่ได้รับผลกระทบจาก ความสว่าง/แสง ในสภาพแวดล้อม 3 มิติ

ความสว่างและอิทธิพลของแสง

Brightness และ LightInfluence ทำงานร่วมกันเพื่อกำหนดว่าความสว่างของแสงที่มีอยู่จะส่งผลต่อเนื้อหา UI ของ SurfaceGui อย่างไร

Brightness จะกำหนดค่าที่ใช้ในการปรับสเกลความสว่างตั้งแต่ 0 ถึง 1000, ทำให้คุณสามารถจับคู่ SurfaceGui กับสภาพแวดล้อมได้ ตัวอย่างเช่น, วิดีโอบิลบอร์ดสามารถทำให้สว่างขึ้นภายในห้องมืดโดยการเพิ่ม Brightness เป็น 10

LightInfluence จะควบคุมว่า SurfaceGui จะได้รับอิทธิพลจากแสงในสถานที่มากน้อยเพียงใด ในช่วงตั้งแต่ 0 ถึง 1 การตั้งค่านี้เป็น 1 หมายความว่าความสว่างรอบๆ จะควบคุมลักษณะที่ปรากฏอย่างเต็มที่, ขณะที่การตั้งค่าที่ 0 หมายความว่าแสงไม่มีผลกระทบ

ความชัดของระยะทาง

MaxDistance ควบคุมว่าวัตถุ SurfaceGui จะปรากฏอยู่ห่างจากกล้องมากแค่ไหนก่อนที่มันจะหยุดการเรนเดอร์ ค่า 0 หมายความว่าไม่มีขีดจำกัดและมันจะเรนเดอร์ไปในระยะทางไม่สิ้นสุด ค่าเริ่มต้นคือ 1000 ทำงานได้ดีสำหรับกรณีส่วนใหญ่

สำหรับ SurfaceGuis ที่ปรากฏกลางแจ้ง, แนะนำว่าให้ MaxDistance มีค่าพอที่จะทำให้ UI ของตัวเก็บมีขนาดเล็กพอเมื่อปรากฏหรือหายไป, ลดผลกระทบการปรากฏขึ้น/หายไปทันที

ลำดับการแสดงผล

หากมีตัวเก็บ SurfaceGui หลายตัวที่อยู่บนพื้นผิวเดียวกัน, คุณสามารถชั้นพวกมันตามดัชนี Z ผ่านคุณสมบัติ ZOffset (การเปลี่ยนแปลงนี้ไม่ได้ "ยก" หรือ "จม" ตัวเก็บจากพื้นผิว)

UI บิลบอร์ด

ตัวเก็บ BillboardGui จะแสดง UI objects ในพื้นที่ 3 มิติ แต่ไม่เหมือนกับ SurfaceGui, ลูกของ BillboardGui จะหันไปทางกล้องเสมอ ตัวเก็บนี้มีประโยชน์สำหรับการแสดงข้อมูลที่หันหน้าไปทางด้านหน้าบนวัตถุในประสบการณ์ เช่นเมตรสุขภาพหรือลิงก์ไปยังวัตถุในโลก 3 มิติ และอื่น ๆ

ในการเชื่อมโยง BillboardGui ไปยัง BasePart หรือ Attachment ในประสบการณ์ ให้ตั้งเป็นลูกของชิ้นส่วนนั้นหรือการยึด และหากต้องการ สามารถปรับ ขนาด/ตำแหน่ง ได้

หรือคุณสามารถวาง BillboardGui ไว้ในตัวเก็บเช่น StarterGui และตั้งค่าคุณสมบัติ Adornee ให้กับชิ้นส่วน BasePart หรือ Attachment ใดๆ วิธีนี้จะช่วยให้มีความยืดหยุ่นมากขึ้นในการวาง เนื่องจาก Adornee สามารถตั้งค่าได้จากสคริปต์ระหว่างการทำงาน เช่น เพื่อตั้งตำแหน่ง BillboardGui เหนือศีรษะของตัวละครผู้เล่นระหว่างการทำงาน

ขนาดและตำแหน่ง

สำหรับการจัดขนาดบิลบอร์ด, ส่วนประกอบ สเกล ของคุณสมบัติ Size จะตั้งขนาดของบิลบอร์ดในพื้นที่ 3 มิติ ตัวอย่างเช่น การตั้งค่า {10, 0},{2, 0} (UDim2.fromScale(10, 2)) จะทำให้บิลบอร์ดมีอัตราส่วน 10:2 ที่ปรับขนาดใหญ่ขึ้นหรือลดลงตามระยะห่างจากกล้อง

สำหรับการจัดตำแหน่ง, คุณสมบัติ StudsOffset จะเคลื่อนย้ายผืนผ้าใบบิลบอร์ดในแกน X (ซ้าย/ขวา), แกน Y (ขึ้น/ลง), และแกน Z (ไปข้างหน้า/ไปข้างหลัง) ตามกล้อง

โหมดการบัง

คุณสมบัติ AlwaysOnTop จะกำหนดว่าตัวเก็บ BillboardGui จะเรนเดอร์เหนือเนื้อหา 3 มิติหรือถูกบังโดยเนื้อหานั้น เมื่อกำหนดเป็น false (ค่าเริ่มต้น) BillboardGui จะทำงานเหมือนเนื้อหา 3 มิติอื่นๆ และจะถูกบังโดยวัตถุ 3 มิติอื่นๆ เมื่อกำหนดเป็น true, มันจะเรนเดอร์เหนือเนื้อหาบน 3 มิติเสมอและจะไม่ได้รับผลกระทบจาก ความสว่าง/แสง ในสภาพแวดล้อม 3 มิติ

ความสว่างและอิทธิพลของแสง

Brightness และ LightInfluence ทำงานร่วมกันเพื่อกำหนดว่าความสว่างของแสงที่มีอยู่จะส่งผลต่อเนื้อหา UI ของ BillboardGui อย่างไร

Brightness จะกำหนดค่าที่ใช้ในการปรับสเกลความสว่างตั้งแต่ 0 ถึง 1000, ทำให้คุณสามารถจับคู่ BillboardGui กับสภาพแวดล้อมได้ ตัวอย่างเช่น, วิดีโอบิลบอร์ดสามารถทำให้สว่างขึ้นภายในห้องมืดโดยการเพิ่ม Brightness เป็น 10

LightInfluence จะควบคุมว่า BillboardGui จะได้รับอิทธิพลจากแสงภายในสถานที่มากน้อยแค่ไหน ในช่วงตั้งแต่ 0 ถึง 1 การตั้งค่านี้เป็น 1 หมายความว่าความสว่างรอบๆ จะควบคุมลักษณะที่ปรากฏอย่างเต็มที่ ขณะที่การตั้งค่าที่ 0 หมายความว่าแสงไม่มีผลกระทบ

ความชัดของระยะทาง

MaxDistance ควบคุมว่าวัตถุ BillboardGui จะปรากฏอยู่ห่างจากกล้องมากแค่ไหนก่อนที่จะหยุดการเรนเดอร์ ค่า 0 หรือ inf (ค่าเริ่มต้น) หมายความว่าไม่มีขีดจำกัดและมันจะเรนเดอร์ไปในระยะทางไม่สิ้นสุด