BillboardGui

Kiểm tra xem con cháu sẽ nhận những sự kiện nhập. Nếu UI có một GuiButton thì nút đó sẽ trở nên có thể nhấp chuột chỉ nếu Active được đặt thành true trên cả BillboardGui và nút.

BillboardGuis chỉ nhận được đầu vào của người dùng nếu chúng được phụ huynh với PlayerGui. Thẻ BillboardGui.Adornee có thể được sử dụng để mục tiêu một phần trong không gian làm việc khi UI chính đang ở trong PlayerGui .

Điều chỉnh phần mục tiêu hoặc kèm theo mà BillboardGui đang đặt vị trí. Nếu không có Adornee được cài đặt, thì Parent được sử dụng thay vào.

Xác định liệu BillboardGui sẽ hiển thị trên các nội dung 3D, hay bị che khuyết bởi nó.

Khi đặt là sai, BillboardGui sẽ render như các nội dung 3D khác, và sẽ bị che khỏi bởi các đối tượng 3D khác.

Khi đặt thành true, nó luôn được hiển thị trên cùng 3D content, và thay đổi nhìn rõ rệt:

• Màu sắc khớp nối đúng như họ xuất hiện bên trong một ScreenGui .
• Văn bản có thể xuất hiện sắc nét hơn trên các thiết bị DPI cao.
• BillboardGui.LightInfluence được xử lý như thể nó là 0.
• BillboardGui.Brightness không có hiệu lực.

Độ sáng định nghĩa hệ số thu nhỏ của ánh sáng được phát ra bởi GUI. Bởi mặc định, giá trị này là 1 và có thể được đặt bất kỳ số nào trên khoảng [0, 1000].

Bằng cách điều chỉnh độ sáng này, độ sáng hiển nhiên của một GUI có thể được phù hợp tốt hơn với môi trường của nó. Ví ví dụ / trường hợp, một bảng hiệu video như những gì được tìm thấy ở Times Square có thể được làm sáng hơn để hiển thị rõ ràng trong một ngày nắng.

Điều này không tạo ra bất kỳ hiệu ứng nào trong các tình huống sau đây mà GUI không phát ra ánh sáng.:

• Khi AlwaysOnTop là sự thật, màu của mỗi pixel là màu được hiển thị trên màn hình.
• Khi LightInfluence là 1, tất cả ánh sáng từ GUI đều được phản chiếu từ môi trường thay vì được phát.

Khi đặt vào true, các bộ phận của GuiObjects nằm ngoài giới hạn của bản vẽ BillboardGui sẽ không được vẽ.

Ngay cả khi điều này là sai, các đối tượng nằm hoàn toàn ngoài không gian trên của BillboardGui sẽ không được hiển thị.

Khoảng cách hiện tại ở dấu hiện tại của Class.BillboardGui từ máy ảnh của người chơi. Một sự kiện thay đổi không bắt lửa cho tính năng này trừ khi giá điều khiển của Class.BillboardGui BillboardGui.DistanceStep nhiều hơn 0.

Xác định khoảng cách trong studs mà một BillboardGui sẽ dừng thu nhỏ lớn hơn kích thước của người chơi so với máy ảnh hiện tại của người chơi. Nếu khoảng cách của gui dưới giá trị này, nó sẽ không được thu nhỏ hơn kích thước n

Xác định kích thước BillboardGui.CurrentDistance tăng và giảm trong studs khi máy ảnh của người chơi di chuyển gần hơn và xa hơn từ BillboardGui . Đặt giá trị mặc định là 0 và tròn từ BillboardGui.DistanceLowerLimit .

Ví dụ, nếu giá trị này được đặt 0,5 và máy ảnh của người chơi đang di chuyển xa khỏi gui bắt đầu từ 0 thì CurrentDistance sẽ tăng lên 0 -> 0,5 -> 1 -> 1.5 -> ... và như vậy.

Xác định khoảng cách trong studs mà một BillboardGui sẽ dừng thu nhỏ kích thước lúc nào so với máy ảnh của người chơi. Nếu khoảng cách của gui nằm trên giá trị này, nó sẽ không được thu nhỏ nhỏ hơn khi nó ở khoảng cách này.

Điều này bị lỗi nếu giá trị là dưới 0. Giá trị mặc định là -1, có nghĩa là thuộc tính được bỏ qua bởi mặc định.

Offset BillboardGui từ bảng hiệu của mình là bao nhiêu so với bảng hiệu của bạn Adornee , đối với hướng và đơn vị của Camera - bảng hiệu bên trong khoảng cách giữa của model's 0> Class.Camera

Xem thêm:

• ExtentsOffsetWorldSpace , which works similarly except the offset orientation is relative to the global axes
• StudsOffset , which works similarly except the units are studs

ExtentsOffsetWorldSpace xác định cách BillboardGui được sao chép từ Class.BillboardGui.Adornee của nó, so với các trụ cột và đơn vị toàn cầu của khu vực giới hạn của model.

Xem thêm:

• ExtentsOffset , which works similarly except the offset orientation is relative to the Camera
• StudsOffsetWorldSpace , which works similarly except the units are studs

Điều khiển mức độ màn hình BillboardGui bị ảnh hưởng bởi ánh sáng trong môi trường.

Khi được cài đặt để 0, UI hành xử tương tự như một màn hình LCD, hoạt động như nguồn ánh sáng của riêng nó và xuất hiện như nhau bất kể ánh sáng xung quanh.

Khi đặt vào 1, UI sẽ hành xử tương tự như một tờ giấy, chỉ phản ánh ánh sáng từ một nguồn khác.

Thuộc tính MaxDistance của một BillboardGui đặt cách xa trong studs mà bảng hiệu có thể từ camera và vẫn được vẽ. Nếu máy ảnh và bảng hiệu được di chuyển xa hơn khỏi khoảng cách tối đa, thì bảng hiệu sẽ không hiển thị bất k

Nếu giá trị này được cài đặt dưới hoặc bằng 0, khoảng cách tối đa sẽ được điều chỉnh là vô tận và biển báo luôn luôn được rút ra.

Ví dụ

-- Đợi tải các tập lệnh máy ảnh / điều khiển mặc định
task.wait(5)

-- Tuyên bố và khởi tạo đối tượng
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")

-- Cài đặt đánh máymáy ảnh
camera.CameraType = Enum.CameraType.Scriptable

-- địa điểmvị trí và khóa của bộ phận
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true

-- Thiết lập bảng hiệu
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)

-- Tạo nhãn
label.Size = UDim2.fromScale(1, 1)

-- Đặt cha mẹ của đối tượng
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace

-- Di chuyển máy ảnh bên cạnh bộ phận. Đợi một chút và sau đó di chuyển máy ảnh
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)

-- Nội dung của bảng hiệu sẽ hiển thị ở đây
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

Được sử dụng bởi các tài liệu để ẩn BillboardGui của một người chơi cụ thể.

Để ẩn UI từ hơn một người chơi, hãy đặt BillboardGui vào StarterGui và sử dụng một

Điều khiển kích thước màn hình BillboardGui sẽ có.

Thành phần Scale của Size được hiểu là một kích thước bằng các cột, và UI sẽ tự động thay đổi kích thước bằng cách sử dụng giá trị Scale nếu giá trị Scale được sử dụng.

Các khu vực CẢI TIẾN và OFFSET của kích thước được thêm vào và có thể được sử dụng cùng nhau.

Một độ dịch chuyển 2D đối với các đơn vị kích thước tương đối lớn hơn mà hành động như một điểm móc. Điều này có thể được sử dụng tương tự như đối tượng GuiObject.AnchorPoint, nhưng giá trị khác nhau.

Giá trị thông thường

| Kích thước Offset | Giải thích | | 0.0, 0.0 | Mặc định. UI sẽ được kết dính ở trung tâm. | | 0.5, 0.5 Mặc định. UI sẽ kết dín

Xem thêm:

• StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffset0> , which are all other properties that work in 3D space instead

StudsOffset xác định cách BillboardGui bị lệch so với của nó Adornee ,相对于 Camera hướng với các đơn vị trong studs.

Xem thêm:

• StudsOffsetWorldSpace , which works similarly except the offset orientation is relative to the global axes
• ExtentsOffset , which works similarly except the units are half the dimensions of the model's Camera-aligned bounding box

StudsOffsetWorldSpace định vị cách BillboardGui được sao chép từ Class.BillboardGui.Adornee|Adornee của nó, so với các trụ cơ sở dữ liệu toàn cầu với các đơn vị trong studs.

Xem thêm:

• StudsOffset , which works similarly except the offset orientation is relative to the Camera
• ExtentsOffsetWorldSpace , which works similarly except the units are half the dimensions of the model's axis-aligned bounding box