BillboardGui

Hiển Thị Bản Đã Lỗi Thời

*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.

BillboardGui with a TextLabel describing the screen console it floats above.

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ư ImageButtonsTextButtons 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

Thuộc Tính kế thừa từ LayerCollectorThuộc Tính kế thừa từ GuiBase2d

Sự Kiện

Sự Kiện kế thừa từ GuiBase2d

Thuộc Tính

Active

Đọc Song Song

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ư ImageButtonsTextButtons 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

Đọc Song Song

Đặt mục tiêu BasePart hoặc AttachmentBillboardGui được đặt tương quan với, vượt qua phần cha hoặc phụ kiện.

AlwaysOnTop

Đọc Song Song

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

Đọc Song Song

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 01000 .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

Đọc Song Song

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

Chỉ Đọc
Không Sao Chép
Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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 Song Song

Đượ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

Đọc Song Song

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

Đọc Song Song

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ướcGiả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

Đọc Song Song

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

Đọc Song Song

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 .

Phương Pháp

Sự Kiện