SurfaceGui
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
สามารถใช้เพื่อการเรนเดอร์ของ GUI บนพื้นผิวของชิ้นส่วนในโลก 3D ในขณะที่สามารถใช้งานได้อย่างเป็นปกติของผู้ใช้
การแคชรุ่น UI สถิติสำหรับประสิทธิภาพ
การปรากฏตัวของ Gui จะถูกบันทึกไว้จนกว่าจะเกิดเหตุการณ์ต่อไปนี้:
- ลูกหลานจะถูกเพิ่มลงใน Gui
- ลูกหลานจะถูกลบออกจาก Gui
- สมบัติของลูกหลานของ Gui เปลี่ยนแปลง
- สมบัติของ Gui เปลี่ยนแปลง
หากเหตุการณ์ใด ๆ เหล่านี้เกิดขึ้น Gui จะถูกรีคอมพิวต์รูปลักษณ์ในภาพต่อไปที่มันเรนเดอร์
สรุป
คุณสมบัติ
กำหนดว่า SurfaceGui จะเรนเดอร์บน 3D วัตถุอื่น ๆ เสมอหรือไม่
กำหนดปัจจัยที่ส่งผลให้แสงของ GUI มีขนาดเมื่อ LightInfluence เป็น 0
ขนาดของ 'หน้าจอเสมือน' ใน 'พิกเซลเสมือน' ซึ่งทำให้ SurfaceGuis เป็นข้อมูลพิกเซลที่เข้ากันได้กับ ScreenGuis
เมื่อตั้งค่าเป็น true จะไม่มีการวาดรายละเอียดส่วนของ GuiObjects ที่ตกออกจากขอบเขตของ SurfaceGui
ควบคุมว่า SurfaceGui ได้รับผลกระทบจากแสงในโลกเกมเท่าไหร่
ควบคุมระยะที่ SurfaceGui สามารถแสดงได้ก่อนที่จะหยุดเรนเดอร์
กำหนดจำนวนพิกเซลพื้นที่หน้าจอต่อหน้าจอโลกที่ใช้ในการเรนเดอร์เนื้อหาของ SurfaceGui
กำหนดว่าจะเรนเดอร์ SurfaceGui ในขนาดคงที่หรือขนาดของมันใน studs
ตั้งค่าระยะที่เหลือการคลิกจะเริ่มทำงานบนพื้นหน้าจอแทนเครื่องมือที่ถืออยู่
เปลี่ยน Offsets ของ SurfaceGui ให้เป็นปกติของพื้นผิวที่มันแนบมา
เปิด/ปิดการมองเห็นของ this LayerCollector
กำหนดว่า LayerCollector รีเซ็ต (ลบตัวเองและเรียกลูกไฟล์ใหม่ใน Class.PlayerGui) ทุกครั้งที่ตัวละครของผู้เล่นเกิดใหม่
ควบคุมวิธีการที่ GuiObject.ZIndex ปฏิสัมพันธ์กับลูกหลานของคลาสนี้ LayerCollector
อธิบายตำแหน่งหน้าจอที่เป็นไปเลยของรายการ UI ในพิกเซล
อธิบายการหมุนเวียนหน้าจริงของ UI โดยองศา
อธิบายขนาดหน้าจอที่เป็นไปจริงของรายการ UI
เมื่อตั้งค่าเป็น true จะใช้การแปลภาษาใน GuiBase2d และลูกหลานของมัน
การอ้างอิงถึง LocalizationTable ที่จะใช้ในการประยุกต์การแปลอัตโนมัติสู่ GuiBase2d และลูกหลานของมัน
ปรับแต่งพฤติกรรมการเลือกแพดพักในแนวลง
ปรับแต่งพฤติกรรมการเลือกแพดพานเกมในแนวโน้มทางซ้าย
ปรับแต่งพฤติกรรมการเลือกแพดพักเกมในทิศทางที่ถูกต้อง
ปรับแต่งพฤติกรรมการเลือกแพดพักในแนวตั้งขึ้น
ช่วยให้คุณสามารถปรับแต่งการเคลื่อนไหวของแผงควบคุมเกม
อีเวนต์
อีเวนต์รับทอดมาจากGuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
เกิดขึ้นเมื่อเลือกแผงควบคุมเกมเคลื่อนไปยัง, ออกหรือเปลี่ยนแปลงใน GuiBase2d หรือ GuiObjects ต้นได้
คุณสมบัติ
AlwaysOnTop
กำหนดว่า SurfaceGui จะเรนเดอร์ข้างบน 3D หรือไม่ หรือจะถูกปิดกั้นโดยมัน
เมื่อตั้งค่าไว้ที่ false จะทำให้ SurfaceGui เรนเดอร์เหมือนเนื้อหา 3D อื่น ๆ และจะถูกซ่อนโดยวัตถุ 3D อื่น ๆ
เมื่อตั้งค่าเป็น true มันจะเรนเดอร์เสมอด้านบน 3D เนื้อหาและการเปลี่ยนแปลงลักษณะที่มากขึ้น:
- สีตรงกับวิธีที่พวกเขาปรากฏภายใน ScreenGui
- ข้อความอาจปรากฏคมขึ้นในอุปกรณ์ DPI สูง
- SurfaceGui.LightInfluence ได้รับการรักษาเหมือนเป็น 0
- SurfaceGui.Brightness ไม่มีผล
Brightness
ความสว่าง กำหนดปัจจัยที่ว่าด้วยว่าแสงที่ปล่อยของ GUI จะปรับขนาดตาม โดยปกติ, ค่านี้คือ 1 และสามารถตั้งค่าได้ทุกตัวเลขในช่วง [0, 1000]
โดยการปรับแต่งค่านี้สามารถจัดการความสว่างที่ปรากฏของ GUI ให้เหมาะสมกับสภาพแวดล้อมของมันได้ เช่น บอร์ดโฆษณาวิดีโอเช่นที่พบใน Times Square สามารถทำให้สว่างขึ้นเพื่อให้มองเห็นได้ชัดเจนในวันที่สดใส
สมบัตินี้จะไม่สร้างผลใด ๆ ในสถานการณ์ต่อไปนี้ที่ GUI ไม่ได้ปล่อยแสง:
- เมื่อ AlwaysOnTop เป็นจริง สีของแต่ละพิกเซลจะเป็นสีที่ปรากฏบนหน้าจอ
- เมื่อ LightInfluence เป็น 1 ทั้งหมดของแสงจาก GUI จะสะท้อนจากสภาพแวดล้อมแทนที่จะเป็นการออกอากาศ
CanvasSize
ขนาดของ 'หน้าจอเสมือน' ใน 'พิกเซลเสมือน' ซึ่งทำให้ SurfaceGuis เป็นข้อมูลพิกเซลที่เข้ากันได้กับ ScreenGuis
ClipsDescendants
เมื่อตั้งค่าเป็น true จะไม่มีการวาดรายละเอียดส่วนของ GuiObjects ที่ตกออกจากขอบเขตของ SurfaceGui
แม้ว่าค่านี้จะเป็นประเภทเท็มเพียงใด ๆ ก็ไม่สามารถเรนเดอร์ได้เมื่อค่านี้เป็นประเภทเท็ม
MaxDistance
ควบคุมระยะที่ SurfaceGui สามารถแสดงได้ก่อนที่จะหยุดเรนเดอร์ มีค่า 0 หมายถึงไม่มีขีดจำกัด และมันจะเรนเดอร์ไปไกลเกินไป
สำหรับประสบการณ์ที่มีหลาย SurfaceGuis คุณจะต้องตั้งค่านี้ให้เป็นค่าที่เหมาะสมสำหรับแต่ละ SurfaceGui หมายเลขค่าเริ่มต้นเมื่อใส่ SurfaceGui ใน Studio คือ 1000 ซึ่งควรจะโอเคสำหรับการใช้งานส่วนใหญ่
สำหรับ UI ที่อยู่กลางแจ้ง คุณควรตั้งค่าระยะทางสูงสุดให้ไกลเกินไปเพื่อให้ UI เล็กในหน้าจอเมื่อมันปรากฏขึ้น รอบ 10 พิกเซล นี่ทำให้มันน่าสังเกตน้อยลงเมื่อมันปรากฏขึ้นหรือออก
คุณสามารถลดป๊อปอันได้มากขึ้นโดยการเพิ่มรายละเอียดที่ดูเหมือนกันใต้ SurfaceGui หรือการเปลี่ยนสีของชิ้นส่วนให้ตรงกับสีพื้นหลังของ UI ของคุณ
สำหรับพื้นที่ภายใน, ระยะทางสูงสุดควรจะตั้งให้เล็กกว่าขนาดห้องเพื่อให้ UI ไม่เรนเมื่อผู้เล่นอยู่ในห้องที่แตกต่างกัน
PixelsPerStud
PixelsPerStud กำหนดความหนาแน่นของพิกเซลที่ใช้สำหรับแต่ละโลก-พื้นที่เรนเดอร์เนอร์เนื้อหาของ SurfaceGui
มูลค่าที่สูงขึ้นจะทำให้ GuiObject ภายในปรากฏ
SizingMode
เมื่อตั้งค่าเป็น Enum.SurfaceGuiSizingMode.FixedSize ตัวอังเครื่องมือจะเรนเดอร์ด้วยขนาดตายตัวโดยใช้ SurfaceGui.CanvasSize
เมื่อตั้งค่าเป็น Enum.SurfaceGuiSizingMode.PixelsPerStud สีน้ำเงินจะปรากฏขึ้นด้วยขนาดตัวแปรขึ้นอยู่กับ SurfaceGui.PixelsPerStud และขนาดของ SurfaceGui ใน studs
ToolPunchThroughDistance
ตั้งค่าระยะที่เหลือการคลิกจะเริ่มทำงานบนหน้าจอกุยในแทนที่ของเครื่องมือที่ถืออยู่ หากตัวละครอยู่ในระยะนี้ของกุยหน้าจอ เครื่องมือจะไม่ได้รับการเปิดใช้งานเมื่อคลิก