SurfaceGui
*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.
Cho phép hiển thị các thành phần GUI trên bề mặt của một phần trong thế giới 3D, trong khi cho phép cho phép người dùng cơ bản để xảy ra. SurfaceGuis phải là con cháu của PlayerGui để biết người dùng nào đang tương tác với nó.
Lưu trữ UI tĩnh cho hiệu suất
Sự xuất hiện của một Gui được lưu trữ cho đến khi một trong những sự kiện sau đây xảy ra:
- Một con cháu được thêm vào Gui.
- Một con cháu đã bị xóa khỏi Gui.
- Một thuộc tính của một con cháu của Gui thay đổi.
- Một thuộc tính của Gui thay đổi.
Nếu một trong những sự kiện này xảy ra, hiển thị Gui sẽ được tính toán lại trong khung hình tiếp theo nó được hiển thị.
Tóm Tắt
Thuộc Tính
Xác định liệu SurfaceGui sẽ luôn được hiển thị trên các đối tượng 3D khác.
Xác định hệ số thu nhỏ màn hình khi LightInfluence là 0.
Kích thước của một 'màn hình ảo', trong 'Pixel ảo tưởng', khiến SurfaceGuis tương thích với ScreenGuis.
Khi đặt về true, các bộ phận của GuiObjects nằm ngoài vùng vảy bề mặt sẽ không được vẽ.
Điều khiển mức độ mà SurfaceGui ảnh hưởng đến khi chiếu sáng trong thế giới trò chơi.
Điều khiển khoảng cách màn hình SurfaceGui có thể được hiển thị trước khi dừng hiển thị.
Xác định số lượng của pixel không gian màn hình trên một thế giới-空间 stud được sử dụng để hiển thị nội dung của SurfaceGui.
Xác định có phải điều chỉnh kích thước bề mặt để tạo mô hình kích thước thực tế hay không.
Điều chỉnh khoảng cách đã được nhấp vào bên trái màn hình thay vì công cụ đã giữ.
Lệch mặt nạ SurfaceGui so với bề mặt nó được kết nối.
Bật/tắt sự hiển thị của thành phần này.
Xác định nếu LayerCollector được đặt lại (xóa bản thân và sao chép lại vào PlayerGui của người chơi mỗi khi nhân vật người chơi respawns).
Điều khiển cách GuiObject.ZIndex hành xử trên tất cả các con cháu của this LayerCollector .
Mô tả vị trí màn hình thực tế của một thành phần UI, bằng cách đếm các pixel.
Mô tả sự quay màn hình thực tế của một thành phần UI, bằng độ.
Mô tả kích thước màn hình thực tế của một thành phần UI, bằng các pixel.
Khi đặt về true, localization sẽ được áp dụng cho GuiBase2d và những con cháu của nó.
Một tham khảo đến một LocalizationTable để ứng dụng hóa học hóa toàn bộ vào GuiBase2d và các con cháu của nó.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng dưới.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng bên trái.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng 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 của nút gamepad.
Sự Kiện
Sự Kiện kế thừa từ GuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Kích hoạt khi lựa chọn gamepad di chuyển đến, rời đi hoặc thay đổi trong khu vực GuiBase2d hoặc bất kỳ con cháu GuiObjects kế tiếp.
Thuộc Tính
AlwaysOnTop
Xác định liệu SurfaceGui sẽ rendu trên các nội dung 3D, hay bị che khuyết bởi nó.
Khi đặt về giá trị sai, SurfaceGui sẽ tạo ra như một nội dung 3D khác và sẽ bị che giấu bởi các thành phần 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.
- SurfaceGui.LightInfluence được xử lý như thể nó là 0.
- SurfaceGui.Brightness không có hiệu quả.
Brightness
Độ 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.
CanvasSize
Kích thước của một 'màn hình ảo', trong 'Pixel ảo tưởng', khiến SurfaceGuis tương thích với ScreenGuis.
ClipsDescendants
Khi đặt về true, các bộ phận của GuiObjects nằm ngoài vùng vảy bề mặt 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 khu vực trên của SurfaceGui sẽ không được hiển thị.
LightInfluence
Điều khiển mức độ mà SurfaceGui ảnh hưởng đến khi chiếu sáng trong thế giới trò chơi.
MaxDistance
Điều khiển khoảng cách màn hình SurfaceGui có thể được hiển thị trước khi dừng hiển thị. Một giá trị 0 có nghĩa là không có giới hạn, và nó sẽ hiển thị vô tận xa.
Đối với những trải nghiệm có nhiều SurfaceGuis, được khuyến nghị đặt giá này cho mỗi SurfaceGui. Giá trị mặc định khi đặt một SurfaceGui vào Studio là 1000, nên điều này sẽ tốt cho hầu hết các mục đích sử dụng.
Đối với các UI ở ngoài trời, bạn nên thiết lập MaxDistance càng xa càng tốt để UI nhỏ trên màn hình khi nó nhô ra, xung quanh 10 pixel. Điều này làm cho nó ít nhìn thấy hơn khi nó nhô ra hoặc vào.
Bạn có thể giảm thiểu hiệu ứng nổi tiếng hơn bằng cách thêm một decal tương tự dưới SurfaceGui hoặc bằng cách thay đổi màu part để khớp với màu nền của UI của bạn.
Đối với các không gian trong nhà, MaxDistance nên được đặt nhỏ hơn một chút so với kích thước của phòng, để UI không bị hiển thị khi người chơi ở một phòng khác.
PixelsPerStud
PixelsPerStud xác định độ dày của các pixel được sử dụng cho mỗi world-space stud để hiển thị nội dung của SurfaceGui.
Giá trị càng cao hơn sẽ khiến các thành phần trong GuiObject xuấ
SizingMode
Khi đặt để Enum.SurfaceGuiSizingMode.FixedSize, SurfaceGui tạo ra với một kích thước cố định được thiết lập bằng cách sử dụng SurfaceGui.CanvasSize .
Khi được thiết lập để Enum.SurfaceGuiSizingMode.PixelsPerStud, SurfaceGui hiển thị với kích thước biến thể dựa trên SurfaceGui.PixelsPerStud và kích thước của SurfaceGui trong studs.
ToolPunchThroughDistance
Điều chỉnh khoảng cách bên trái khi nhấp chuột bắt đầu hành động trên bề mặt gui thay vì công cụ đã giữ. Nếu một nhân vật ở trong khoảng cách này của gui bề mặt, thì công cụ sẽ không được kích hoạt khi nhấp chuột.