BillboardGui
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
BillboardGui เป็นคอนเทนเนอร์สำหรับวัตถุ UI ที่จะปรากฏในพื้นที่ 3D แต่เสมอสู่กล้องตำแหน่งของคอนเทนเนอร์เป็นเชิงเปรียบเทียบกับพ่อ BasePart หรือ Attachment (หรือ Adornee )สำหรับ BaseParts , คุณสมบัติ Position จะถูกใช้, ในขณะที่สำหรับ Attachments , คุณสมบัติ WorldPosition จะถูกใช้

คุณสมบัติของป้ายโฆษณา Size ทำงานแตกต่างเล็กน้อยจาก GuiObject.Sizeในขณะที่ส่วนประกอบ offset ทำงานเหมือนกัน ส่วนประกอบ scale จะถูกใช้เป็นขนาดสตัดในพื้นที่ 3D
เมื่อสร้างขนาดที่ปรับขนาดได้ BillboardGui ที่มีแท็ก TextLabel ก็เป็นประโยชน์ที่จะเปิดใช้งานคุณสมบัติ TextScaled ของฉลากเพื่อให้ข้อความของมันขยายตามความลึกของกล้องเมื่อระยะทางของกล้องเปลี่ยนไป
โปรดทราบว่าองค์ประกอบ UI โต้ตอบเช่น ImageButtons และ TextButtons ภายใน BillboardGui จะได้รับการใส่ข้อมูลผู้ใช้เฉพาะเมื่อพวกเขาได้รับการสืบทอดจาก PlayerGui โดยปกติผ่านการวาง BillboardGui ภายใน StarterGuiคุณสมบัติ Adornee สามารถใช้เพื่อเล็งไปที่ส่วนหรือส่วนประกอบในโลก 3D ในขณะที่ BillboardGui เองยังคงอยู่ใน PlayerGui
ดู UI ในประสบการณ์ สำหรับคู่มือในการทำงานกับ BillboardGui คอนเทนเนอร์
พฤติกรรมการแคช
การดำเนินการการปรากฏตัวของ BillboardGui จะถูกบันทึกไว้จนกว่าจะเกิดหนึ่งในสิ่งต่อไปนี้ หลังจากนั้นรูปลักษณ์ของมันจะถูกคำนวณใหม่ในกรอบการเรนเดอร์ถัดไป
- บุตรหลานถูกเพิ่มเข้าหรือลบออกจาก BillboardGui
- คุณสมบัติของลูกหลานของ BillboardGui การเปลี่ยนแปลง
- คุณสมบัติของ BillboardGui ตัวเองเปลี่ยนแปลง
สรุป
คุณสมบัติ
ควบคุมว่าบุตรหลานจะได้รับเหตุการณ์อินพุตหรือไม่
ตั้งส่วนหรือส่วนประกอบเป้าหมายที่ BillboardGui ตำแหน่งเป็นค่าสัมพันธ์กับ
กำหนดว่า BillboardGui จะแสดงเสมอบนด้านบนของวัตถุ 3D อื่น ๆ
กำหนดตัวคูณที่แสงของคอนเทนเนอร์ BillboardGui จะเพิ่มเมื่อ LightInfluence เป็น 0
ว่าส่วนใดของ GuiObjects ที่ตกออกนอกขอบแคนวาส BillboardGui จะถูกวาด
ระยะปัจจุบันในสตัดที่ BillboardGui อยู่จากกล้องของผู้เล่น
กำหนดระยะในสตัดที่ BillboardGui จะหยุดการขยายขนาดใหญ่ขึ้น
กำหนดขนาด CurrentDistance เพิ่มขึ้นและลดลงในสตัดเป็นค่าที่กล้องของผู้เล่นเคลื่อนใกล้และไกลจาก BillboardGui
กำหนดระยะในสตัดที่ BillboardGui จะหยุดการขยายขนาดเล็กลง
กำหนดวิธีที่ BillboardGui จะถูกลบออกจาก Adornee เมื่อเทียบกับการจัดตำแหน่ง Camera ในหน่วยที่มีขนาดครึ่งหนึ่งของกล่องจำกัดขอบของรูปแบบ Camera ที่สอดรับกัน
กำหนดวิธีที่ BillboardGui จะถูกหักออกจาก Adornee เมื่อเทียบกับแกนหลักของโลกในหน่วยที่มีขนาดเท่าครึ่งของกล่องการจับภาพที่สอดคล้องกับแกนของโมเดล
ควบคุมว่า BillboardGui ได้รับอิทธิพลจากแสงสว่างสิ่งแวดล้อมมากแค่ไหน
ควบคุมระยะทางที่ BillboardGui สามารถแสดงได้ก่อนที่จะหยุดการเรนเดอร์
ใช้โดยสคริปต์เพื่อซ่อน BillboardGui จากผู้เล่นรายเฉพาะ
ควบคุมขนาดที่ BillboardGui จะมีบนหน้าจอ
การเลื่อน 2D ในหน่วยที่เกี่ยวข้องกับขนาดที่ทำหน้าที่เป็นจุดยึด
กำหนดวิธีที่ BillboardGui จะถูกหักออกจาก Adornee ในสตัด เมื่อเทียบกับการจัดเรียง Camera
กำหนดวิธีที่ BillboardGui จะถูกหักออกจาก Adornee ในสตัด เมื่อเทียบกับแกนหลัก
สลับการมองเห็นของสิ่งนี้ LayerCollector .
กำหนดว่าการรีเซ็ต LayerCollector จะเกิดขึ้น (ลบตัวเองและรีโคลนเข้าสู่ตัวละครของผู้เล่น PlayerGui ) ทุกครั้งที่ตัวละครของผู้เล่นเกิดใหม่
ควบคุมวิธีที่ GuiObject.ZIndex จะทำงานกับทุกสายลูกของสิ่งนี้ LayerCollector
อธิบายตำแหน่งจอแสดงจริงขององค์ประกอบ GuiBase2d ในพิกเซล
อธิบายการหมุนหน้าจอที่เกิดขึ้นจริงขององค์ประกอบ GuiBase2d ในองศา
อธิบายขนาดหน้าจอที่เป็นจริงขององค์ประกอบ GuiBase2d ในพิกเซล
เมื่อตั้งค่าเป็น true การแปลท้องถิ่นจะถูกใช้กับ GuiBase2d และบรรดาลูกหลานของมัน
การอ้างอิงถึง LocalizationTable ที่จะใช้เพื่อใช้การแปลงภาษาท้องถิ่นอัตโนมัติกับ GuiBase2d และบรรดาลูกหลานของมัน
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางลง
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางซ้าย
ปรับพฤติกรรมการเลือก gamepad ในทิศทางที่ถูกต้อง
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางขึ้น
อนุญาตให้ปรับแต่งการเคลื่อนไหวการเลือกเกมแพดได้
อีเวนต์
อีเวนต์รับทอดมาจากGuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ไฟเมื่อการเลือกเกมแพดย้ายไปที่ ออก หรือเปลี่ยนภายในเชื่อมต่อ GuiBase2d หรือทายาทใดๆ GuiObjects
คุณสมบัติ
Active
ควบคุมว่าบุตรหลานจะได้รับเหตุการณ์อินพุตหรือไม่หาก มีปุ่ม ปุ่มนั้นจะกลายเป็นคลิกได้เฉพาะถ้า ถูกตั้งค่าเป็น ทั้งใน และ ปุ่ม
โปรดทราบว่าองค์ประกอบ UI โต้ตอบเช่น ImageButtons และ TextButtons ภายใน BillboardGui จะได้รับการใส่ข้อมูลผู้ใช้เฉพาะเมื่อพวกเขาได้รับการสืบทอดจาก PlayerGui โดยปกติผ่านการวาง BillboardGui ภายใน StarterGuiคุณสมบัติ Adornee สามารถใช้เพื่อเล็งไปที่ส่วนหรือส่วนประกอบในโลก 3D ในขณะที่ BillboardGui เองยังคงอยู่ใน PlayerGui
Adornee
ตั้งเป้าหมาย BasePart หรือ Attachment ที่ BillboardGui ตำแหน่งเป็นค่าสัมบูรณ์เมื่อเทียบกับส่วนหรือส่วนประกอบพ่วง โดยแทนที่ส่วนพ่วงหรือส่วนประกอบ
AlwaysOnTop
คุณสมบัตินี้กำหนดว่า BillboardGui จะแสดงเสมอบนด้านบนของวัตถุ 3D อื่น ๆ
เมื่อตั้งค่าเป็น (เริ่มต้น) รูปแบบจะแสดงเช่นเนื้อหา 3D อื่น ๆ และถูกปิดกั้นโดยวัตถุ 3D อื่น ๆเมื่อตั้งค่าเป็น true การแสดงผล BillboardGui จะเสมอที่ด้านบนของเนื้อหา 3D และการเปลี่ยนแปลงรูปลักษณ์มีความสำคัญอย่างมาก:
- สีจะจับคู่กับวิธีที่ปรากฏภายใน ScreenGui
- ข้อความอาจปรากฏคมชัดขึ้นบนอุปกรณ์ DPI สูง
- LightInfluence จะถูกปฏิบัติเหมือนว่ามันเป็น 0
- Brightness ไม่มีผล
Brightness
คุณสมบัตินี้กำหนดตัวคูณที่แสงของคอนเทนเนอร์ BillboardGui จะเพิ่มขึ้นเมื่อ LightInfluence เป็น 0โดยค่าเริ่มต้นคุณสมบัตินี้คือ 1 และสามารถตั้งค่าเป็นตัวเลขใดก็ได้ระหว่าง 0 และ 1000โดยการแก้ไขคุณสมบัตินี้ ความสว่างที่ปรากฏของ BillboardGui อินสแตนซ์บิลบอร์ดวิดีโอสามารถสว่างขึ้นภายในห้องมืดโดยเพิ่ม Brightness เป็น 10
โปรดทราบว่า Brightness ไม่สามารถเข้าถึงได้ใน Studio และไม่มีผลใดๆ เมื่อ LightInfluence เป็น 1 หรือ AlwaysOnTop เป็น true
ClipsDescendants
เมื่อตั้งค่าเป็น true (ค่าเริ่มต้น) ส่วนของ GuiObjects ที่ตกอยู่นอกขอบแคนวาส BillboardGui จะไม่ถูกวาด
แม้เมื่อคุณสมบัตินี้จะเป็น , ที่อยู่นอกแคนวาสทั้งหมดจะไม่แสดงผล
CurrentDistance
ระยะปัจจุบันในสตัดที่ BillboardGui อยู่จากกล้องของผู้เล่นอีเวนต์ที่เปลี่ยนแปลงไม่จะยิงสำหรับคุณสมบัตินี้ยกเว้น DistanceStep มากกว่า 0
DistanceLowerLimit
กำหนดระยะในสตัดที่ BillboardGui จะหยุดขยายขนาดใหญ่ขึ้นเมื่อเทียบกับกล้องปัจจุบันของผู้เล่นโดยมีค่าเริ่มต้นเป็น 0หาก CurrentDistance ของ BillboardGui ต่ำกว่ามูลค่านี้ มันจะไม่ขยายใหญ่กว่าที่จะเป็นที่นี่ DistanceLowerLimit ระยะทาง
DistanceStep
กำหนดขนาด CurrentDistance เพิ่มขึ้นและลดลงในสตัดเป็นค่าที่กล้องของผู้เล่นเคลื่อนใกล้และไกลจาก BillboardGuiค่าเริ่มต้นของคุณสมบัติคือ 0 และรอบขึ้นตั้งแต่ DistanceLowerLimit
DistanceUpperLimit
กำหนดระยะในสตัดที่ BillboardGui จะหยุดการขยายขนาดเล็กลงเมื่อเทียบกับกล้องปัจจุบันของผู้เล่นหาก CurrentDistance ของ BillboardGui อยู่เหนือมูลค่านี้แล้วจะไม่มีขนาดเล็กกว่าที่จะเป็นไปได้ในระยะทางนี้ DistanceUpperLimit
คุณสมบัตินี้จะถูกเพิกเฉยหากมูลค่าน้อยกว่า 0 ค่าเริ่มต้นคือ -1 ซึ่งหมายความว่าคุณสมบัติจะถูกเพิกเฉยโดยปกติ
ExtentsOffset
คุณสมบัตินี้กำหนดวิธีที่ BillboardGui จะถูกหักออกจาก Adornee ของมันเมื่อเทียบกับการจัดตำแหน่ง Camera ในหน่วยที่มีขนาดครึ่งหนึ่งของกล่องผูกขัดของรูปแบบ Camera ที่สอดรับกัน
ดูเพิ่มเติม StudsOffset ซึ่งทำงานคล้ายกัน แต่ใช้หน่วยสตัด หรือ ExtentsOffsetWorldSpace ซึ่งทำงานคล้ายกัน ยกเว้นการชดเชยทิศทางเป็นค่าเชิงบวกเมื่อเทียบกับแกนหลัก
ExtentsOffsetWorldSpace
คุณสมบัตินี้กำหนดวิธีที่ BillboardGui จะถูกหักออกจาก Adornee ของมันเมื่อเทียบกับแกนหมุนทั่วโลกในหน่วยครึ่งขนาดของกล่องกำหนดเส้นขอบของโมเดลที่สอดรับกับแกน
ดูเพิ่มเติม StudsOffset ซึ่งทำงานคล้ายกัน แต่ใช้หน่วยสตัด หรือ ExtentsOffset ซึ่งทำงานคล้ายกัน ยกเว้นการเอียงออฟเซ็ตเป็นค่าสัมพันธ์กับ Camera
LightInfluence
ควบคุมว่า BillboardGui ได้รับอิทธิพลจากแสงสว่างในสภาพแวดล้อมมากแค่ไหนในช่วงตั้งแต่ 0 ถึง 1การตั้งค่านี้เป็น 1 หมายความว่าแสงรอบๆ มีการควบคุมทั้งหมดเกี่ยวกับรูปลักษณ์ในขณะที่ตั้งค่าเป็น 0 หมายความว่าแสงไม่มีผล
MaxDistance
คุณสมบัตินี้ควบคุมระยะห่างจากกล้องที่ BillboardGui จะแสดงก่อนหยุดการเรนเดอร์ค่าของ 0 หรือ inf (เริ่มต้น) หมายความว่าไม่มีขีดจํากัดและจะแสดงผลได้ไม่มีที่สิ้นสุดไกล
สำหรับ BillboardGuis ที่ปรากฏในสภาพแวดล้อมภายนอก แนะนำให้ MaxDistance สูงพอที่จะให้แน่ใจว่า UI ของคอนเทนเนอร์มีขนาดเล็กพอที่จะให้แน่ใจว่าปรากฏหรือหายไปบนหน้าจอเมื่อปรากฏ ลดผลกระทบการป๊อปอิน/ออกอย่างกะทันหัน
PlayerToHideFrom
ใช้โดยสคริปต์เพื่อซ่อน BillboardGui จากผู้เล่นรายเฉพาะ
เพื่อซ่อน BillboardGui จากผู้เล่นมากกว่าหนึ่งคน, วางไว้ใน StarterGui และใช้สคริปต์เพื่อตั้งค่าคุณสมบัติ Enabled ตามว่า LocalPlayer ควรจะสามารถมองเห็นได้หรือไม่คุณสมบัติ Adornee สามารถใช้เพื่อติด BillboardGui กับ BasePart หรือ Attachment ใน Workspace แทนที่จะเลี้ยงมัน
Size
ควบคุมขนาดที่ BillboardGui จะมีบนหน้าจอไม่เหมือนกับ , ส่วนประกอบขนาดเล็กของคุณสมบัตินี้ตั้งขนาดสตัดของบิลบอร์ดในพื้นที่ 3D
SizeOffset
การเลื่อน 2D ในหน่วยที่เกี่ยวข้องกับขนาดที่ทำหน้าที่เป็นจุดยึดสิ่งนี้สามารถใช้ได้ในลักษณะเดียวกับคุณสมบัติ GuiObject.AnchorPoint แต่ค่าจะแตกต่างกัน
<tbody><tr><td><code>0, 0</code></td><td>ค่าเริ่มต้นที่ UI จะถูกยึดที่ศูนย์กลาง</td></tr><tr><td><code>0.5, 0.5</code></td><td>UI จะถูกยึดที่ด้านล่างซ้าย</td></tr><tr><td><code>0.5, -0.5</code></td><td>UI จะถูกยึดที่ด้านบนซ้าย</td></tr><tr><td><code>-0.5, 0.5</code></td><td>UI จะถูกยึดที่ด้านบนขวา</td></tr><tr><td><code>-0.5, -0.5</code></td><td>UI จะถูกยึดที่ด้านล่างขวา</td></tr></tbody>
ความเคลื่อนที่ขนาด | คําอธิบาย |
---|
ดูเพิ่มเติม StudsOffset , StudsOffsetWorldSpace , ExtentsOffset และ ExtentsOffsetWorldSpace ซึ่งเป็นคุณสมบัติที่ชดเชยที่ทำงานในพื้นที่ 3D แทน
StudsOffset
คุณสมบัตินี้กำหนดวิธีที่ BillboardGui จะถูกหักออกจาก Adornee ในสตัด เมื่อเทียบกับการจัดเรียง Camera
ดูเพิ่มเติม StudsOffsetWorldSpace ซึ่งทำงานคล้ายกันยกเว้นการชดเชยทิศทางเป็นเรื่องของแกนทางโลก
StudsOffsetWorldSpace
คุณสมบัตินี้กำหนดวิธีการที่ BillboardGui จะถูกหักออกจาก Adornee ในสตัด เมื่อเทียบกับแกนหลัก
ดูเพิ่มเติม StudsOffset ซึ่งทำงานคล้ายกันยกเว้นทิศทางการชดเชยเป็นค่าสัมพันธ์กับ Camera