BillboardGui

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

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

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

BillboardGui with a TextLabel describing the screen console it floats above.

คุณสมบัติของป้ายโฆษณา 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 .

  • อ่านพร้อมๆ กัน

    กำหนดว่าการรีเซ็ต LayerCollector จะเกิดขึ้น (ลบตัวเองและรีโคลนเข้าสู่ตัวละครของผู้เล่น PlayerGui ) ทุกครั้งที่ตัวละครของผู้เล่นเกิดใหม่

  • อ่านพร้อมๆ กัน

    ควบคุมวิธีที่ GuiObject.ZIndex จะทำงานกับทุกสายลูกของสิ่งนี้ LayerCollector

คุณสมบัติรับทอดมาจากGuiBase2d
  • อ่านอย่างเดียว
    ไม่ซ้ำ

    อธิบายตำแหน่งจอแสดงจริงขององค์ประกอบ GuiBase2d ในพิกเซล

  • อ่านอย่างเดียว
    ไม่ซ้ำ

    อธิบายการหมุนหน้าจอที่เกิดขึ้นจริงขององค์ประกอบ GuiBase2d ในองศา

  • อ่านอย่างเดียว
    ไม่ซ้ำ

    อธิบายขนาดหน้าจอที่เป็นจริงขององค์ประกอบ GuiBase2d ในพิกเซล

  • อ่านพร้อมๆ กัน

    เมื่อตั้งค่าเป็น true การแปลท้องถิ่นจะถูกใช้กับ GuiBase2d และบรรดาลูกหลานของมัน

  • อ่านพร้อมๆ กัน

    การอ้างอิงถึง LocalizationTable ที่จะใช้เพื่อใช้การแปลงภาษาท้องถิ่นอัตโนมัติกับ GuiBase2d และบรรดาลูกหลานของมัน

  • อ่านพร้อมๆ กัน

    ปรับพฤติกรรมการเลือกเกมแพดในทิศทางลง

  • อ่านพร้อมๆ กัน

    ปรับพฤติกรรมการเลือกเกมแพดในทิศทางซ้าย

  • อ่านพร้อมๆ กัน

    ปรับพฤติกรรมการเลือก gamepad ในทิศทางที่ถูกต้อง

  • อ่านพร้อมๆ กัน

    ปรับพฤติกรรมการเลือกเกมแพดในทิศทางขึ้น

  • อ่านพร้อมๆ กัน

    อนุญาตให้ปรับแต่งการเคลื่อนไหวการเลือกเกมแพดได้

อีเวนต์

อีเวนต์รับทอดมาจากGuiBase2d

คุณสมบัติ

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

วิธีการ

อีเวนต์