BillboardGui
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
BillboardGui là một thùng chứa cho các đối tượng UI xuất hiện trong không gian 3D nhưng luôn luôn đối mặt với máy ảnh.Vị trí của thùng chứa là tương đối với cha BasePart hoặc Attachment (hoặc Adornee ).Đối với BaseParts , thuộc tính Position được sử dụng, trong khi đối với Attachments , thuộc tính WorldPosition được sử dụng.

Tính chất của một biển báo Size khác một chút so với GuiObject.Size .Trong khi các thành phần offset hoạt động giống nhau, các thành phần scale được sử dụng như kích thước đinh tán trong không gian 3D.
Khi tạo một kích thước có thước đo BillboardGui chứa một TextLabel , có ích khi bật chức năng thẻ TextScaled để kích thước văn bản tăng theo kích thước bảng quảng cáo khi khoảng cách máy ảnh thay đổi.
Lưu ý rằng các thành phần UI tương tác như ImageButtons và TextButtons bên trong một BillboardGui sẽ chỉ nhận được đầu vào của người dùng nếu chúng được gán cho PlayerGui , thông thường thông qua việc đặt BillboardGui bên trong StarterGui .Thuộc tính Adornee có thể được sử dụng để mục tiêu một phần hoặc phụ kiện trong thế giới 3D trong khi chính BillboardGui vẫn còn ở trong PlayerGui .
Xem Giao diện người dùng trong trải nghiệm để có hướng dẫn về việc làm việc với BillboardGui.
Hành vi lưu trữ
Để giúp cải thiện hiệu lực, sự xuất hiện của một BillboardGui được lưu trữ cho đến khi một trong những điều sau xảy ra, sau đó sự xuất hiện của nó sẽ được tính toán lại trên khung hiển thị tiếp theo.
- Một con cháu được thêm vào hoặc bị xóa khỏi BillboardGui .
- Một thuộc tính của một con cháu của BillboardGui thay đổi.
- Một thuộc tính của BillboardGui chính nó thay đổi.
Tóm Tắt
Thuộc Tính
Kiểm soát xem con cháu có nhận được sự kiện nhập hay không.
Đặt phần mục tiêu hoặc phụ kiện mà BillboardGui được vị trí so với.
Xác định xem BillboardGui có luôn luôn được hiển thị trên cùng của các đối tượng 3D khác hay không.
Xác định yếu tố mà ánh sáng của thùng chứa BillboardGui được phóng to khi LightInfluence được 0 .
Liệu các phần của GuiObjects có rơi ra ngoài ranh giới bản vẽ BillboardGui sẽ được vẽ hay không.
Khoảng cách hiện tại bằng đinh tán trong đó BillboardGui từ máy ảnh của người chơi.
Xác định khoảng cách bằng đinh tán ở đó BillboardGui sẽ dừng tăng kích thước lớn hơn.
Xác định các tăng và giảm kích thước CurrentDistance trong đinh tán là máy ảnh của người chơi di chuyển gần hơn và xa hơn từ BillboardGui .
Xác định khoảng cách bằng đinh tán ở đó BillboardGui sẽ ngừng phóng to hơn về kích thước.
Xác định cách BillboardGui bị mất cân bằng so với Adornee , theo hướng Camera , trong các đơn vị bằng một nửa kích thước của hộp giới hạn mô hình Camera -phù hợp.
Xác định cách BillboardGui bị trừ đi từ Adornee của nó, so với trục toàn cầu, trong các đơn vị bằng một nửa kích thước của hộp giới hạn dọc theo trục của mô hình.
Kiểm soát mức độ BillboardGui bị ảnh hưởng bởi ánh sáng môi trường.
Kiểm soát tầm xa mà BillboardGui có thể được hiển thị trước khi dừng render.
Được sử dụng bởi các tập lệnh để che giấu BillboardGui từ một người chơi cụ thể.
Kiểm soát kích thước mà BillboardGui sẽ có trên màn hình.
Một chênh lệch 2D trong các đơn vị có kích thước tương đối hành động như một điểm neo.
Xác định cách BillboardGui bị mất cân bằng so với Adornee trong đinh tán, so với hướng Camera .
Xác định cách BillboardGui bị mất cân bằng so với Adornee trong đinh tán, so với trục toàn cầu.
Bật/tắt sự hiển thị của điều này LayerCollector .
Xác định xem có phải LayerCollector đặt lại (tự xóa bản thân và sao chép lại vào nhân vật của người chơi PlayerGui) mỗi khi nhân vật của người chơi hồi sinh.
Kiểm soát cách GuiObject.ZIndex hành xử trên tất cả các con trai của điều này LayerCollector .
Mô tả vị trí màn hình thực của một thành phần GuiBase2d , trong điểm ảnh.
Mô tả sự xoay màn hình thực sự của một thành phần GuiBase2d , trong độ.
Mô tả kích thước màn hình thực của một thành phần GuiBase2d , bằng像素.
Khi được đặt thành true , bản địa hóa sẽ được áp dụng cho GuiBase2d và con cháu của nó.
Một tham chiếu đến một LocalizationTable để được sử dụng để áp dụng lok hóa tự động cho GuiBase2d và con cháu của nó.
Tùy chỉnh hành vi lựa chọn gamepad theo chiều xuống.
Tùy chỉnh hành vi lựa chọn gamepad theo hướng bên trái.
Tùy chỉnh hành vi lựa chọn gamepad theo hướng bên phải.
Tùy chỉnh hành vi lựa chọn gamepad trong hướng lên.
Cho phép tùy chỉnh chuyển động lựa chọn gamepad.
Sự Kiện
Sự Kiện kế thừa từ GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Bắt lửa khi lựa chọn gamepad di chuyển đến, rời hoặc thay đổi trong khu vực kết nối GuiBase2d hoặc bất kỳ con trai nào GuiObjects .
Thuộc Tính
Active
Kiểm soát xem con cháu có nhận được sự kiện nhập hay không.Nếu chứa một , nút đó sẽ trở nên có thể nhấp vào chỉ khi được đặt thành trên cả và nút.
Lưu ý rằng các thành phần UI tương tác như ImageButtons và TextButtons bên trong một BillboardGui sẽ chỉ nhận được đầu vào của người dùng nếu chúng được gán cho PlayerGui , thông thường thông qua việc đặt BillboardGui bên trong StarterGui .Thuộc tính Adornee có thể được sử dụng để mục tiêu một phần hoặc phụ kiện trong thế giới 3D trong khi chính BillboardGui vẫn còn ở trong PlayerGui .
Adornee
Đặt mục tiêu BasePart hoặc Attachment mà BillboardGui được đặt tương quan với, vượt qua phần cha hoặc phụ kiện.
AlwaysOnTop
Tính chất này xác định xem BillboardGui có luôn luôn hiển thị trên cùng của các đối tượng 3D khác hay không.
Khi được đặt thành false (mặc định), BillboardGui hiển thị giống như các nội dung 3D khác và bị che khuất bởi các đối tượng 3D khác.Khi được đặt thành true , BillboardGui luôn hiển thị trên cùng của nội dung 3D và thay đổi trông đáng kể:
- Màu sắc phù hợp với cách xuất hiện bên trong 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.
- LightInfluence được xử lý như thể nó là 0 .
- Brightness không có hiệu lực.
Brightness
Thuộc tính này xác định yếu tố mà ánh sáng của thùng chứa BillboardGui được phóng to khi LightInfluence được 0 .Mặc định, thuộc tính này là 1 và có thể được đặt thành bất kỳ số nào giữa 0 và 1000 .Bằng cách sửa đổi thuộc tính này, độ sáng rõ ràng của một BillboardGui có thể phù hợp hơn với môi trường của nó.Ví ví dụ / trường hợp, một biển quảng cáo video có thể được làm sáng bên trong một phòng tối bằng cách tăng Brightness đến 10.
Lưu ý rằng không thể truy cập trong Studio và không có hiệu lực khi hoặc không phải là .
ClipsDescendants
Khi được đặt thành true (mặc định), các phần của GuiObjects không nằm trong giới hạn của bản vẽ BillboardGui sẽ không được vẽ.
Ngay cả khi thuộc tính này là , những thứ ở bên ngoài bản vẽ sẽ không được hiển thị.
CurrentDistance
Khoảng cách hiện tại bằng đinh tán trong đó BillboardGui từ máy ảnh của người chơi.Một sự kiện đã thay đổi không bắn cho thuộc tính này trừ khi DistanceStep lớn hơn 0.
DistanceLowerLimit
Xác định khoảng cách bằng đinh tán ở đó BillboardGui sẽ dừng phóng to hơn về kích thước so với máy ảnh hiện tại của người chơi, với một mặc định là 0 .Nếu CurrentDistance của BillboardGui nằm dưới giá trị này, nó sẽ không phóng to hơn mức sẽ xảy ra tại khoảng cách này DistanceLowerLimit.
DistanceStep
Xác định các tăng và giảm kích thước CurrentDistance trong đinh tán là máy ảnh của người chơi di chuyển gần hơn và xa hơn từ BillboardGui .Thuộc tính mặc định là 0 và vòng lên bắt đầu từ DistanceLowerLimit .
DistanceUpperLimit
Xác định khoảng cách bằng đinh tán ở đó BillboardGui sẽ dừng phóng to hơn về kích thước so với máy ảnh hiện tại của người chơi.Nếu CurrentDistance của BillboardGui nằm trên giá trị này, nó sẽ không thể thay đổi nhỏ hơn so với khoảng cách này DistanceUpperLimit.
Thuộc tính này bị bỏ qua nếu giá trị nhỏ hơn 0 . Giá trị mặc định là -1 , có nghĩa là thuộc tính bị bỏ qua mặc định.
ExtentsOffset
Tính chất này xác định cách BillboardGui bị mất cân bằng so với Adornee , theo hướng Camera , trong các đơn vị bằng một nửa kích thước của hộp giới hạn mô hình Camera -phù hợp.
Xem thêm StudsOffset hoạt động tương tự nhưng sử dụng các đơn vị khối, hoặc ExtentsOffsetWorldSpace hoạt động tương tự nhưng chiều mất cân bằng là tương đối với các trục toàn cầu.
ExtentsOffsetWorldSpace
Tính chất này xác định cách BillboardGui bị trừ đi từ Adornee của nó, so với trục toàn cầu, trong các đơn vị bằng một nửa kích thước của hộp giới hạn theo trục của mô hình.
Xem thêm StudsOffset hoạt động tương tự nhưng sử dụng các đơn vị khối, hoặc ExtentsOffset hoạt động tương tự nhưng chiều bù trừ là tương đối với Camera .
LightInfluence
Kiểm soát mức độ BillboardGui được ảnh hưởng bởi ánh sáng môi trường, trong phạm vi từ 0 đến 1 .Đặt điều này thành 1 có nghĩa là ánh sáng xung quanh có kiểm soát hoàn toàn về ngoại hình, trong khi đặt nó thành 0 có nghĩa là ánh sáng không có hiệu ứng.
MaxDistance
Tính chất này kiểm soát cách xa camera mà BillboardGui sẽ được hiển thị trước khi dừng render.Một giá trị của 0 hoặc inf (mặc định) có nghĩa là không có giới hạn và nó sẽ hiển thị vô cực xa.
Đối với BillboardGuis những thứ xuất hiện ngoài trời, được khuyến nghị rằng MaxDistance phải đủ cao để đảm bảo rằng giao diện người dùng của thùng chứa đủ nhỏ trên màn hình khi xuất hiện hoặc biến mất, giảm thiểu tác động bật lên/xuống đột ngột.
PlayerToHideFrom
Được sử dụng bởi các tập lệnh để che giấu BillboardGui từ một người chơi cụ thể.
Để ẩn một BillboardGui từ nhiều hơn một người chơi, đặt nó vào StarterGui và sử dụng một kịch bản để đặt thuộc tính Enabled theo cách mà LocalPlayer có thể nhìn thấy nó hay không.Thuộc tính Adornee có thể được sử dụng để gắn BillboardGui vào BasePart hoặc Attachment trong Workspace, thay vì nuôi nó.
Size
Kiểm soát kích thước mà BillboardGui sẽ có trên màn hình.Không giống như GuiObject.Size , các thành phần quy mô của bộ đặt tính năng này đặt kích thước đinh tán của biển báo trong không gian 3D.
SizeOffset
Một chênh lệch 2D trong các đơn vị có kích thước tương đối hành động như một điểm neo.Điều này có thể được sử dụng tương tự như thuộc tính GuiObject.AnchorPoint, nhưng các giá trị khác nhau.
<tbody><tr><td><code>0, 0</code></td><td>Mặc định mà UI sẽ được neo tại trung tâm.</td></tr><tr><td><code>0.5, 0.5</code></td><td>Giao diện người dùng sẽ neo ở phía dưới bên trái.</td></tr><tr><td><code>0.5, -0.5</code></td><td>Giao diện người dùng sẽ neo ở phía trên bên trái.</td></tr><tr><td><code>-0.5, 0.5</code></td><td>Giao diện người dùng sẽ neo ở phía trên bên phải.</td></tr><tr><td><code>-0.5, -0.5</code></td><td>Giao diện người dùng sẽ neo ở phía dưới bên phải.</td></tr></tbody>
Bù trừ kích thước | Giải thích |
---|
Xem thêm StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , và ExtentsOffsetWorldSpace , đó là các thuộc tính bị trừ đi hoạt động trong không gian 3D thay vào đó.
StudsOffset
Tính chất này xác định cách BillboardGui bị mất cân bằng từ Adornee trong studs, so với hướng Camera .
Xem thêm StudsOffsetWorldSpace mà hoạt động tương tự ngoại trừ hướng bù trừ là tương quan đến trục toàn cầu.
StudsOffsetWorldSpace
Tính chất này xác định cách BillboardGui bị trừ đi từ Adornee trong studs, so với trục toàn cầu.
Xem thêm StudsOffset mà hoạt động tương tự ngoại trừ hướng bù trừ là tương đối với Camera .