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.
SurfaceGui cho phép hiển thị các đối tượng UI lên bề mặt của một phần trong thế giới 3D trong khi vẫn cho phép tương tác người dùng cơ bản xảy ra.Tương tự như và , các đối tượng UI như và có cha mẹ giống như bề mặt họ đang ở, có thể chỉnh sửa thông qua thuộc tính .
Lưu ý rằng các thành phần UI tương tác như ImageButtons và TextButtons bên trong một SurfaceGui 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 qua việc đặt SurfaceGui bên trong StarterGui .Thuộc tính Adornee có thể được sử dụng để mục tiêu một phần trong thế giới 3D trong khi chính SurfaceGui 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 SurfaceGui.
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 SurfaceGui đượ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 SurfaceGui .
- Một thuộc tính của một con cháu của SurfaceGui thay đổi.
- Một thuộc tính của SurfaceGui chính nó thay đổi.
Tóm Tắt
Thuộc Tính
Xác định xem SurfaceGui 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 SurfaceGui được phóng to khi LightInfluence được 0 .
Kích thước của một "màn hình ảo" trong "像素" mà làm cho SurfaceGuis pixel-to-pixel tương thích với ScreenGuis .
Liệu các phần của GuiObjects có rơi ra ngoài ranh giới bản vẽ SurfaceGui sẽ được vẽ hay không.
Kiểm soát mức độ SurfaceGui bị ảnh hưởng bởi ánh sáng môi trường.
Kiểm soát tầm xa mà SurfaceGui có thể được hiển thị trước khi dừng render.
Xác định độ dày của các điểm ảnh được sử dụng cho mỗi không gian thế giới để hiển thị nội dung của SurfaceGui .
Xác định xem SurfaceGui có được hiển thị với kích thước cố định hay kích thước với kích thước của nó trong studs.
Đặt khoảng cách mà nhấp chuột bên trái bắt đầu hoạt động trên SurfaceGui thay vì trên Tool đã giữ.
Xếp chồng lên này SurfaceGui trong mối quan hệ với các SurfaceGuis khác trên cùng một khuôn mặt.
BasePart trên đó để áp dụng SurfaceGui , vượt qua sự kết hợp cha mẹ mặc định.
Enum.NormalId mặt mà sẽ áp dụng SurfaceGui .
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
AlwaysOnTop
Tính chất này xác định xem SurfaceGui 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), SurfaceGui 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 , SurfaceGui 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 SurfaceGui đượ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 SurfaceGui 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à .
CanvasSize
Kích thước của một "màn hình ảo" trong "像素" mà làm cho SurfaceGuis pixel-to-pixel tương thích với ScreenGuis .
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ẽ SurfaceGui 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ị.
LightInfluence
Kiểm soát mức độ SurfaceGui đượ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à SurfaceGui sẽ được hiển thị trước khi dừng render.Một giá trị của 0 có nghĩa là không có giới hạn và nó sẽ hiển thị vô cực xa.Giá trị mặc định của 1000 hoạt động tốt cho hầu hết các trường hợp.
Đối với SurfaceGuis 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.
PixelsPerStud
Tính chất này xác định độ dày của các điểm ảnh được sử dụng cho mỗi không gian thế giới để vẽ nội dung của SurfaceGui .Các giá trị cao hơn sẽ khiến các GuiObjects khác nhau xuất hiện nhỏ hơn nếu chúng được giữ cùng kích cỡ.Ngược lại, các giá trị thấp hơn sẽ khiến các đối tượng trông lớn hơn.Tuy nhiên, nếu GuiObjects được mở rộng theo tỷ lệ thông qua sử dụng UIScale , GuiObject.Size , TextLabel.TextSize hoặc tương tự, tính năng này cho phép sử dụng định nghĩa cao hơn.
Thật quan trọng để chọn một giá trị dựa trên mức độ xa mà bạn mong đợi một người chơi xem SurfaceGui .Hãy lưu ý rằng mật độ пикселей lớn có thể ảnh hưởng tiêu cực đến hiệu suất nếu khuôn mặt của phần trang trí đủ lớn.
SizingMode
Khi được đặt thành Enum.SurfaceGuiSizingMode.PixelsPerStud (mặc định), SurfaceGui hiển thị với kích thước biến dựa trên PixelsPerStud và kích thước bề mặt bằng đinh tán.
Khi được đặt thành Enum.SurfaceGuiSizingMode.FixedSize , SurfaceGui hiển thị với một kích thước cố định được thiết lập thông qua CanvasSize .
ToolPunchThroughDistance
Đặt khoảng cách mà nhấp chuột bên trái bắt đầu hoạt động trên SurfaceGui thay vì trên Tool đã giữ.Nếu một nhân vật nằm trong khoảng cách này của SurfaceGui, Tool sẽ không kích hoạt khi nhấp vào.
ZOffset
Xếp các lớp này SurfaceGui đối với những người khác trên cùng một khuôn mặt (thay đổi này không thay đổi hình ảnh "nhặt" hoặc "chìm" một SurfaceGui từ bề mặt).