BillboardGui
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
BillboardGuis เป็นคอนเทนเนอร์สำหรับ GuiObjects ที่ปรากฏในพื้นที่ 3D บิลบอร์ดGuis มักจะหน้ากล้องและสามารถเปลี่ยนขนาดด้วยระยะห่างหรือเหลือขนาดเดียวกันในหน้าจอตา
ตําแหน่งของพวกเขาเกี่ยวข้องกับ BillboardGui.Adornee หากไม่มี Adornee ใด ๆ ก็จะใช้พ่อของ BillboardGui เป็น adornee
สมบัติของ Size ของ BillboardGui ทำงานเล็กน้อยกว่า GuiObject.Size ในทางกลับกัน ส่วน Offset ทำงานเหมือนกัน แต่ส่วน Scale ใช้เป็นขนาดใน studs ในพื้นที่ 3D
ขนาดของ UDim2.fromScale(4, 5) คือ 4x5 สตัด, ขนาด UI ใหญ่ขึ้นและเล็กลงขึ้นอยู่กับระยะทางจากกล้อง ขนาดของ UDim2
เมื่อสร้าง BillboardGuis ขนาดเค้าโครง สิ่งสำคัญคือต้องให้แน่ใจว่าผู้ใช้ทั้งหมดภายในใช้ Scale ขนาดและข้อความทั้งหมดมี TextLabel.TextScaled เปิดใช้งานเพื่อให้เครื่องชี้วัดที่ถูกต้อง
สมบัติที่แสดงผลของ BillboardGui และบรรดาลูกหลานทั้งหมดของมันจะอยู่ในมุมด้านบนซ้ายของพระเครื่องของมัน และดังนั้นจึงเป็นเสมอ 0, 0 สำหรับตัวอินสแตนซ์ BillboardGui
การแคชรุ่น UI สถิติ
การปรากฏตัวของ Gui จะถูกบันทึกไว้จนกว่าจะเกิดเหตุการณ์ต่อไปนี้:
- ลูกหลานจะถูกเพิ่มลงใน Gui
- ลูกหลานจะถูกลบออกจาก Gui
- สมบัติของลูกหลานของ Gui เปลี่ยนแปลง
- สมบัติของ Gui เปลี่ยนแปลง
หากเหตุการณ์ใด ๆ เหล่านี้เกิดขึ้น Gui จะถูกรีคอมพิวต์รูปลักษณ์ในภาพต่อไปที่มันเรนเดอร์
สรุป
คุณสมบัติ
ควบคุมว่าลูกหลานจะได้รับการป้อนข้อมูลหรือไม่
ตั้งค่าส่วนหรืออุปกรณ์เป้าหมายที่ BillboardGui ตำแหน่งเดียวกับ
กำหนดว่า BillboardGui จะเรนเดอร์ต่อหน้าเนื้อหา 3D หรือหลังมัน
กำหนดปัจจัยที่ส่งผลให้แสงของ GUI มีขนาดเมื่อ LightInfluence เป็น 0
เมื่อตั้งค่าเป็น true จะไม่มีการวาดรูปของ GuiObjects บางส่วนที่ตกออกจากขอบพระราชันย์
ระยะที่แท้จริงใน studs ที่ BillboardGui อยู่จากกล้องของผู้เล่น
กำหนดระยะทางใน studs ที่ BillboardGui จะหยุดปรับเครื่องชี้วัดขนาดใหญ่ขึ้น
ระยะทางจะถูกรอบเพื่อเพิ่มขึ้นของค่านี้
กำหนดระยะทางใน studs ที่ BillboardGui จะหยุดปรับเครื่องชี้วัดขนาดให้เล็กลงในที่สุด
กำหนดวิธีการที่ BillboardGui เป็นออเฟ็ตจาก Class.BillboardGui.Adornee|Adornee ของมัน โดยเฉลี่ยกับการเรียงตำแหน่ง และหน่วยของ Adornee ตรงกับกรอบ Camera ของมัน - กำหนดการเรียงตำ
กำหนดวิธีการที่ BillboardGui เป็นออเซ็ตจาก Class.BillboardGui.Adornee|Adornee ของมัน โดยเฉลี่ยกับแกนและหน่วยของโลกคือครึ่งของขนาดของกระดานของโมเดล
ควบคุมว่า BillboardGui ได้รับผลกระทบจากแสงในสภาพแวดล้อมเท่าไหร่
ตั้งค่าระยะที่สูงสุดที่บิลบอร์ดสามารถอยู่จากกล้องและยังคงวาด
ใช้โดยสคริปต์เพื่อซ่อน BillboardGui จากผู้เล่นที่เฉพาะ
ควบคุมขนาดที่ BillboardGui จะมีบนหน้าจอ
ค่าเฉลี่ยขนาดในหน่วยที่เป็นขนาดสัมพันธ์ซึ่งทำงานเหมือนจุดโยน
กำหนดวิธีการที่ BillboardGui เป็นออเฟ็ตจาก Class.BillboardGui.Adornee|Adornee ของมัน โดยเฉลี่ยกับการเรียงของ Camera และหน่วยใน studs
กำหนดวิธีการที่ BillboardGui เป็นออเฟ็ตจาก Class.BillboardGui.Adornee|Adornee ของมัน โดยเฉลี่ยกับแกนและหน่วยในสตั๊ด
เปิด/ปิดการมองเห็นของ 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 ต้นได้
คุณสมบัติ
Active
ควบคุมว่าลูกหลานจะได้รับการรับการป้อนข้อมูลหรือไม่ หาก UI มี GuiButton แล้วปุ่มนั้นจะกลายเป็นปุ่มคลิกได้เฉพาะถ้าเปิดใช้งานที่ Class.GuiButton และปุ่ม
BillboardGuis จะได้รับการป้อนข้อมูลของผู้ใช้เท่านั้นหากพวกเขาเป็นลูกของ PlayerGui สมบัติทรัพย์ BillboardGui.Adornee สามารถใช้เพื่อเป้าหมาย Part ในพื้นที่ทำงานขณะที่ UI เองอยู่ใน PlayerGui
Adornee
ตั้งค่าส่วนหรืออุปกรณ์ที่ BillboardGui ตำแหน่งเดียวกับ หากไม่มี Adornee ตั้งค่าจะใช้ Parent แทน
AlwaysOnTop
กำหนดว่า BillboardGui จะเรนเดอร์ข้างบน 3D เนื้อหา หรือจะถูกปิดกั้นโดยมัน
เมื่อตั้งค่าเป็น false บิลบอร์ดกุยจะเรนเดอร์เหมือนเนื้อหา 3D อื่น ๆ และจะถูกซ่อนโดยวัตถุ 3D อื่น ๆ
เมื่อตั้งค่าเป็น true มันจะเรนเดอร์เสมอด้านบน 3D เนื้อหาและการเปลี่ยนแปลงลักษณะที่มากขึ้น:
- สีตรงกับวิธีที่พวกเขาปรากฏภายใน ScreenGui
- ข้อความอาจปรากฏคมขึ้นในอุปกรณ์ DPI สูง
- BillboardGui.LightInfluence ได้รับการรักษาเหมือนว่ามันเป็น 0
- BillboardGui.Brightness ไม่มีผล
Brightness
ความสว่าง กำหนดปัจจัยที่ว่าด้วยว่าแสงที่ปล่อยของ GUI จะปรับขนาดตาม โดยปกติ, ค่านี้คือ 1 และสามารถตั้งค่าได้ทุกตัวเลขในช่วง [0, 1000]
โดยการปรับแต่งค่านี้สามารถจัดการความสว่างที่ปรากฏของ GUI ให้เหมาะสมกับสภาพแวดล้อมของมันได้ เช่น บอร์ดโฆษณาวิดีโอเช่นที่พบใน Times Square สามารถทำให้สว่างขึ้นเพื่อให้มองเห็นได้ชัดเจนในวันที่สดใส
สมบัตินี้จะไม่สร้างผลใด ๆ ในสถานการณ์ต่อไปนี้ที่ GUI ไม่ได้ปล่อยแสง:
- เมื่อ AlwaysOnTop เป็นจริง สีของแต่ละพิกเซลจะเป็นสีที่ปรากฏบนหน้าจอ
- เมื่อ LightInfluence เป็น 1 ทั้งหมดของแสงจาก GUI จะสะท้อนจากสภาพแวดล้อมแทนที่จะเป็นการออกอากาศ
ClipsDescendants
เมื่อตั้งค่าเป็น true จะไม่มีการวาดรูปของ GuiObjects บางส่วนที่ตกออกจากขอบพระราชันย์
แม้ว่าค่านี้จะเป็นประเภทเท็มเมาร์ที่อยู่นอกขอบเขตของ BillboardGui ก็ไม่สามารถเรนเดอร์ได้
CurrentDistance
ระยะทางปัจจุบันในสตั๊ดที่ BillboardGui อยู่จากกล้องของผู้เล่น การเปลี่ยนแปลงอีเว้นท์จะไม่ได้รับการเปิดตัวสำหรับสมบัตินี้ยกเว้น BillboardGui.DistanceStep ของ gui เป็นมากกว่า 0
DistanceLowerLimit
กำหนดระยะที่เรียกว่า ใน studs ที่ BillboardGui จะหยุดการเพิ่มขนาดใหญ่ขึ้นในขนาดของผู้เล่นที่เกี่ยวข้องกับกล้องปัจจุบันของผู้เล่น หากระยะของ gui ต่ำกว่าค่านี้จะ
DistanceStep
กำหนดขนาด BillboardGui.CurrentDistance เพิ่มขึ้นและลดลงใน studs ตามที่กล้องผู้เล่นเคลื่อนไหวใกล้และไกลจาก BillboardGui สถานที่มีค่าเริ่มต้นที่ 0 และรอบตั้งแต่ Class.Toolbar
เช่นเดียวกับกรณีที่ค่านี้ตั้งไว้ที่ 0.5 และกล้องของผู้เล่นกำลังเคลื่อนออกจาก gui เริ่มตั้งแต่ 0 แล้ว CurrentDistance จะเพิ่มขึ้น 0 -> 0.5 -> 1 -> 1.5 -> ... และเป็นเช่นนี้ต่อไป
DistanceUpperLimit
กำหนดระยะที่เรียบเรียงใน studs ที่ BillboardGui จะหยุดปรับเครื่องชี้วัดขนาดให้เล็กลงในขนาดของผู้เล่น หากระยะของ gui เกินค่านี้จะไม่ปรับเครื่องชี้วัดขนาดให้เล็กลงกว่าที่จ
ค่านี้จะไม่ถูกนับถ้ามีค่าน้อยกว่า 0 ค่าเริ่มต้นคือ -1 ซึ่งหมายถึงว่าค่านี้จะถูกนับไม่เป็นปกติ
ExtentsOffset
เอ็กซ์เทนต์เซ็ตออฟเซ็ต กำหนดว่า BillboardGui จะออเฟ็ตจาก Class.BillboardGui.Adornee|Adornee ของมันโดยสัดส่วนกับการเรียงลำดับของ Adornee และหน่วยเป็นครึ่งของขนาดขอ
ดูเพิ่มเติม:
- ExtentsOffsetWorldSpace ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตำแหน่งเหลี่ยมของออเรนจ์เป็นค่าเฉลี่ยของแกนหลัก
- StudsOffset ซึ่งทำงานได้เช่นกันยกเว้นว่าจะเป็นหน่วย
ExtentsOffsetWorldSpace
ExtentsOffsetWorldSpace กำหนดว่า BillboardGui จะออกจาก Class.BillboardGui.Adornee|Adornee ของมัน โดยเฉลี่ยกับแกนและหน่วยของโลกคือครึ่งของขนาดของกระดานของโมเดล
ดูเพิ่มเติม:
- ExtentsOffset ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตำแหน่งออเฟ็กซ์เป็นของเรียบร้อยกับ Camera
- StudsOffsetWorldSpace ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าหน่วยเป็น studs
LightInfluence
ควบคุมว่า BillboardGui ได้รับผลกระทบจากแสงในสภาพแวดล้อมเท่าไหร่
เมื่อตั้งค่าไว้ที่ 0 UI จะทำงานเช่นเดียวกับหน้าจอ LCD โดยการเป็นแหล่งไฟของตัวเองและปรากฏเหมือนกันไม่ว่าจะมีแสงสว่างรอบ ๆ หรือไม่
เมื่อตั้งค่าไว้ที่ 1 UI จะทำงานเช่นกับก้อนกระดาษ แหล่งที่มา
MaxDistance
คุณสมบัติ MaxDistance ของ BillboardGui ตั้งค่าว่าตัวแผงโฆษณาสามารถอยู่ไกลเท่าไหร่ในสตั๊ดที่ภาพประกาศสามารถเห็นได้และยังคงวาด หากกล้องและภาพประกาศถูกย้า
หากค่านี้ตั้งไว้น้อยกว่าหรือเท่ากับ 0 จะได้รับการรักษาระยะทางสูงสุดเป็นล้านและป้ายจะถูกวาดเสมอ
ตัวอย่าง
-- รอให้สคริปต์กล้อง/การควบคุมเริ่มต้นโหลดtask.wait(5)-- ยืนยันและเริ่มต้นวัตถุlocal camera = workspace.CurrentCameralocal part = Instance.new("Part")local billboard = Instance.new("BillboardGui")local label = Instance.new("TextLabel")-- พิมพ์camera.CameraType = Enum.CameraType.Scriptable-- สถานที่part.CFrame = CFrame.new(0, 10, 0)part.Anchored = true-- ติดตั้งป้ายbillboard.MaxDistance = 10billboard.Adornee = partbillboard.AlwaysOnTop = truebillboard.Size = UDim2.fromOffset(50, 50)-- การตั้งค่าฉลากlabel.Size = UDim2.fromScale(1, 1)-- ตั้งค่าพ่อแม่ของวัตถุlabel.Parent = billboardbillboard.Parent = partpart.Parent = workspace-- ย้ายกล้องไปที่ด้านข้างของชิ้นส่วน รอสักครู่แล้วย้ายกล้องlocal cameraPosition0 = part.Position + Vector3.new(0, 0, 10)local cameraPosition1 = part.Position + Vector3.new(0, 0, 20)camera.CFrame = CFrame.lookAt(cameraPosition0, part.Position)-- เนื้อหาของบิลบอร์ดจะปรากฏให้เห็นที่นี่task.wait(2)camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)-- Contents of billboard will no longer be visible (outside MaxDistance)
PlayerToHideFrom
ใช้โดยสคริปต์เพื่อซ่อน BillboardGui จากผู้เล่นที่เฉพาะ
เพื่อซ่อน UI จากผู้เล่นมากกว่าคนให้สถิติเกี่ยวกับ StarterGui
Size
ควบคุมขนาดที่ BillboardGui จะมีบนหน้าจอ
ส่วนประกอบขนาดของ Scale ถูกตีความในขนาดใน studs และ UI จะปรับขนาดโดยอัตโนมัติตามระยะหากใช้ Scale มีค่า
ส่วนขนาดขนาดเล็กและเอกสารอ้างอิงจะถูกเพิ่มขึ้นด้วยกันและสามารถใช้ได้ในเวลาเดียวกัน
SizeOffset
ค่าเปลี่ยนแปลง 2D ในหน่วยขนาดที่เป็นจุดศูนย์กลาง ที่สามารถใช้เหมือนจุดสกรีนแอนค์เกอร์ ค่านี้สามารถใช้ได้เช่นเดียวกับสมบัติสมบัติ GuiObject.AnchorPoint แต่มีค่าที่แตกต่างกัน
ค่าทั่วไป
| SizeOffset | คำอธิบาย | | ปานกลาง: | | 0.0, 0.0 | ค่าเริ่มต้น UI จะติดอยู่ที่ศูนย์กลางของมัน | 0.5, 0.5
ดูเพิ่มเติม:
- StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffset0> , ซึ่งเป็นพรรคอื่นที่ทำงาน
StudsOffset
StudsOffset กำหนดว่า BillboardGui จะเกิดขึ้นอย่างไรจาก Adornee ของมัน โดยเฉลี่ยกับการตั้งค่า Camera ด้วยหน่วยใน studs
ดูเพิ่มเติม:
- StudsOffsetWorldSpace ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตำแหน่งออเฟ็กต์เป็นของโลกที่ความเคลื่อนที่เป็นค่าเชิงเส้น
- ExtentsOffset ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าหน่วยมีขนาดครึ่งของขนาดของกล้องแนวตั้งของโมเดล
StudsOffsetWorldSpace
StudsOffsetWorldSpace กำหนดว่า BillboardGui จะเกิดขึ้นจาก Adornee โดยเฉลี่ยกับแกนหลักทั่วโลกที่มีหน่วยใน studs
ดูเพิ่มเติม:
- StudsOffset ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตำแหน่งออเฟ็ตเป็นของเรียบร้อยการเปลี่ยนแปลงทางเดียวคือ Camera
- ExtentsOffsetWorldSpace ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตัวอักษรจะเป็นครึ่งของขนาดของกระดานขนาดของแม่พิมพ์