SurfaceGui
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
SurfaceGui ช่วยให้สามารถเรนเดอร์ไอเทม UI บนพื้นผิวของชิ้นส่วนในโลก 3D โดยยังอนุญาตให้การโต้ตอบของผู้ใช้พื้นฐานเกิดขึ้นได้คล้ายกับ และ , วัตถุ UI เช่น และ ถูกผูกกับใบหน้าเดียวกันกับพื้นที่ที่พวกเขาอยู่ สามารถแก้ไขได้ผ่านคุณสมบัติ
โปรดทราบว่าองค์ประกอบ UI โต้ตอบเช่น ImageButtons และ TextButtons ภายใน SurfaceGui จะได้รับการใส่ข้อมูลผู้ใช้เฉพาะเมื่อพวกเขาได้รับการสืบทอดจาก PlayerGui โดยปกติผ่านการวาง SurfaceGui ภายใน StarterGuiคุณสมบัติ Adornee สามารถใช้เพื่อเล็งไปที่ส่วนหนึ่งในโลก 3D ในขณะที่ SurfaceGui เองยังคงอยู่ใน PlayerGui
ดู UI ในประสบการณ์ สำหรับคู่มือในการทำงานกับ SurfaceGui คอนเทนเนอร์
พฤติกรรมการแคช
การดำเนินการการปรากฏตัวของ SurfaceGui จะถูกบันทึกไว้จนกว่าจะเกิดหนึ่งในสิ่งต่อไปนี้ หลังจากนั้นรูปลักษณ์ของมันจะถูกคำนวณใหม่ในกรอบการเรนเดอร์ถัดไป
- บุตรหลานถูกเพิ่มเข้าหรือลบออกจาก SurfaceGui
- คุณสมบัติของลูกหลานของ SurfaceGui การเปลี่ยนแปลง
- คุณสมบัติของ SurfaceGui ตัวเองเปลี่ยนแปลง
สรุป
คุณสมบัติ
กำหนดว่า SurfaceGui จะแสดงเสมอบนด้านบนของวัตถุ 3D อื่น ๆ
กำหนดตัวคูณที่แสงของคอนเทนเนอร์ SurfaceGui จะเพิ่มเมื่อ LightInfluence เป็น 0
ขนาดของ "หน้าจอเสมือน" ใน "พิกเซลเสมือน" ซึ่งทำให้ SurfaceGuis พิกเซล-ต่อ-พิกเซลสอดคล้องกับ ScreenGuis
ว่าส่วนใดของ GuiObjects ที่ตกออกนอกขอบแคนวาส SurfaceGui จะถูกวาด
ควบคุมว่า SurfaceGui ได้รับอิทธิพลจากแสงสว่างสิ่งแวดล้อมมากแค่ไหน
ควบคุมระยะทางที่ SurfaceGui สามารถแสดงได้ก่อนที่จะหยุดการเรนเดอร์
กำหนดความหนาแน่นของพิกเซลที่ใช้สําหรับแต่ละจุดในพื้นที่โลกเพื่อเรนเดอร์เนื้อหาของ SurfaceGui
กำหนดว่า SurfaceGui จะแสดงผลในขนาดคงที่หรือขนาดที่เพิ่มขึ้นตามขนาดในสตัดหรือไม่
ตั้งระยะทางที่การคลิกซ้ายเริ่มกระทำบน SurfaceGui แทนที่จะเป็น Tool ที่ถืออยู่
ชั้นนี้ SurfaceGui ในความสัมพันธ์กับอื่น SurfaceGuis บนใบหน้าเดียวกัน
BasePart บนซึ่งจะใช้ SurfaceGui เพื่อแทนที่การเชื่อมโยงพ่อแม่เริ่มต้น
Enum.NormalId ใบหน้าที่จะใช้ SurfaceGui
สลับการมองเห็นของสิ่งนี้ 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
คุณสมบัติ
AlwaysOnTop
คุณสมบัตินี้กำหนดว่า SurfaceGui จะแสดงเสมอบนด้านบนของวัตถุ 3D อื่น ๆ
เมื่อตั้งค่าเป็น (เริ่มต้น) รูปแบบจะแสดงเช่นเนื้อหา 3D อื่น ๆ และถูกปิดกั้นโดยวัตถุ 3D อื่น ๆเมื่อตั้งค่าเป็น true การแสดงผล SurfaceGui จะเสมอกับเนื้อหา 3D และการเปลี่ยนแปลงรูปลักษณ์มีนัยสําคัญ:
- สีจะจับคู่กับวิธีที่ปรากฏภายใน ScreenGui
- ข้อความอาจปรากฏคมชัดขึ้นบนอุปกรณ์ DPI สูง
- LightInfluence จะถูกปฏิบัติเหมือนว่ามันเป็น 0
- Brightness ไม่มีผล
Brightness
คุณสมบัตินี้กำหนดตัวคูณที่แสงของคอนเทนเนอร์ SurfaceGui จะเพิ่มขึ้นเมื่อ LightInfluence เป็น 0โดยค่าเริ่มต้นคุณสมบัตินี้คือ 1 และสามารถตั้งค่าเป็นตัวเลขใดก็ได้ระหว่าง 0 และ 1000โดยการแก้ไขคุณสมบัตินี้ ความสว่างที่ปรากฏของ SurfaceGui อินสแตนซ์บิลบอร์ดวิดีโอสามารถสว่างขึ้นภายในห้องมืดโดยเพิ่ม Brightness เป็น 10
โปรดทราบว่า Brightness ไม่สามารถเข้าถึงได้ใน Studio และไม่มีผลใดๆ เมื่อ LightInfluence เป็น 1 หรือ AlwaysOnTop เป็น true
CanvasSize
ขนาดของ "หน้าจอเสมือน" ใน "พิกเซลเสมือน" ซึ่งทำให้ SurfaceGuis พิกเซล-ต่อ-พิกเซลสอดคล้องกับ ScreenGuis
ClipsDescendants
เมื่อตั้งค่าเป็น true (ค่าเริ่มต้น) ส่วนของ GuiObjects ที่ตกอยู่นอกขอบแคนวาส SurfaceGui จะไม่ถูกวาด
แม้เมื่อคุณสมบัตินี้จะเป็น , ที่อยู่นอกแคนวาสทั้งหมดจะไม่แสดงผล
LightInfluence
ควบคุมว่า SurfaceGui ได้รับอิทธิพลจากแสงสว่างในสภาพแวดล้อมมากแค่ไหนในช่วงตั้งแต่ 0 ถึง 1การตั้งค่านี้เป็น 1 หมายความว่าแสงรอบๆ มีการควบคุมทั้งหมดเกี่ยวกับรูปลักษณ์ในขณะที่ตั้งค่าเป็น 0 หมายความว่าแสงไม่มีผล
MaxDistance
คุณสมบัตินี้ควบคุมระยะห่างจากกล้องที่ SurfaceGui จะแสดงก่อนหยุดการเรนเดอร์ค่า 0 หมายถึงไม่มีขีดจํากัดและจะแสดงผลได้ไม่มีที่สิ้นสุดไกลออกไปค่าเริ่มต้นของ 1000 ทำงานได้ดีสำหรับส่วนใหญ่กรณี
สำหรับ SurfaceGuis ที่ปรากฏในสภาพแวดล้อมภายนอก แนะนำให้ MaxDistance สูงพอที่จะให้แน่ใจว่า UI ของคอนเทนเนอร์มีขนาดเล็กพอที่จะให้แน่ใจว่าปรากฏหรือหายไปบนหน้าจอเมื่อปรากฏ ลดผลกระทบการป๊อปอิน/ออกอย่างกะทันหัน
PixelsPerStud
คุณสมบัตินี้กำหนดความหนาแน่นของพิกเซลที่ใช้สําหรับแต่ละจุดในพื้นที่โลกเพื่อเรนเดอร์เนื้อหาของ SurfaceGuiมูลค่าที่สูงกว่าจะทำให้ส่วนต่างๆ GuiObjects ภายในมีขนาดเล็กลงหากพวกเขาเก็บขนาดเดียวกันในทางกลับกันมูลค่าที่ต่ำกว่าจะทำให้วัตถุปรากฏใหญ่ขึ้นอย่างไรก็ตาม หาก GuiObjects ถูกขยายในอัตราส่วนผ่านการใช้ UIScale , GuiObject.Size , TextLabel.TextSize หรือคล้ายกัน คุณสมบัตินี้ช่วยให้สามารถใช้ความกำหนดที่สูงขึ้นได้
เป็นสิ่งสำคัญที่ต้องเลือกค่าตามที่คุณคาดว่าผู้เล่นจะดู SurfaceGui ได้ไกลแค่ไหนโปรดทราบด้วยว่าความหนาแน่นพิกเซลขนาดใหญ่อาจส่งผลเสียต่อประสิทธิภาพหากใบหน้าของชิ้นตกแต่งมีขนาดใหญ่พอ
SizingMode
เมื่อตั้งค่าเป็น Enum.SurfaceGuiSizingMode.PixelsPerStud (เริ่มต้น) การเรนเดอร์ SurfaceGui จะแสดงด้วยขนาดแปรตาม PixelsPerStud และขนาดพื้นในสตัด
เมื่อตั้งค่าเป็น Enum.SurfaceGuiSizingMode.FixedSize แล้ว SurfaceGui จะแสดงด้วยขนาดคงที่ที่กำหนดผ่าน CanvasSize
ToolPunchThroughDistance
ตั้งระยะทางที่การคลิกซ้ายเริ่มกระทำบน SurfaceGui แทนที่จะเป็น Tool ที่ถืออยู่หากตัวละครอยู่ในระยะนี้ของ SurfaceGui ตัวละคร Tool จะไม่เปิดใช้งานเมื่อคลิก
ZOffset
ชั้นนี้ SurfaceGui ในความสัมพันธ์กับคนอื่นบนใบหน้าเดียวกัน (การเปลี่ยนแปลงนี้ไม่ได้ "ยก" หรือ "จม" SurfaceGui จากพื้นผิว)