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 ของมัน โดยเฉลี่ยกับแกนและหน่วยในสตั๊ด

คุณสมบัติรับทอดมาจากLayerCollector
  • อ่านพร้อมๆ กัน

    เปิด/ปิดการมองเห็นของ this LayerCollector

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

    กำหนดว่า LayerCollector รีเซ็ต (ลบตัวเองและเรียกลูกไฟล์ใหม่ใน Class.PlayerGui) ทุกครั้งที่ตัวละครของผู้เล่นเกิดใหม่

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

    ควบคุมวิธีการที่ GuiObject.ZIndex ปฏิสัมพันธ์กับลูกหลานของคลาสนี้ LayerCollector

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

    อธิบายตำแหน่งหน้าจอที่เป็นไปเลยของรายการ 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.CurrentCamera
local 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 = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)
-- การตั้งค่าฉลาก
label.Size = UDim2.fromScale(1, 1)
-- ตั้งค่าพ่อแม่ของวัตถุ
label.Parent = billboard
billboard.Parent = part
part.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

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

StudsOffset กำหนดว่า BillboardGui จะเกิดขึ้นอย่างไรจาก Adornee ของมัน โดยเฉลี่ยกับการตั้งค่า Camera ด้วยหน่วยใน studs

ดูเพิ่มเติม:

  • StudsOffsetWorldSpace ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตำแหน่งออเฟ็กต์เป็นของโลกที่ความเคลื่อนที่เป็นค่าเชิงเส้น
  • ExtentsOffset ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าหน่วยมีขนาดครึ่งของขนาดของกล้องแนวตั้งของโมเดล

StudsOffsetWorldSpace

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

StudsOffsetWorldSpace กำหนดว่า BillboardGui จะเกิดขึ้นจาก Adornee โดยเฉลี่ยกับแกนหลักทั่วโลกที่มีหน่วยใน studs

ดูเพิ่มเติม:

  • StudsOffset ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตำแหน่งออเฟ็ตเป็นของเรียบร้อยการเปลี่ยนแปลงทางเดียวคือ Camera
  • ExtentsOffsetWorldSpace ซึ่งทำงานได้เช่นเดียวกับยกเว้นว่าตัวอักษรจะเป็นครึ่งของขนาดของกระดานขนาดของแม่พิมพ์

วิธีการ

อีเวนต์