기본 사용자 상호 작용이 발생할 수 있도록 허용하는 한 부의 표면에 GUI 요소를 렌더링하고 기본 사용자 상호 작용을 허용합니다. 서피스Guis는 플레이어가 상호 작용하는 플레이어를 알 수 있도록 PlayerGui의 하위인 해야 합니다.
성능 향상을 위해 정적 UI 캐싱
다음 이벤트 중 하나가 발생할 때까지 Gui의 모양이 캐시됩니다.
- 후손이 Gui에 추가됩니다.
- 후손은 Gui에서 제거됩니다.
- Descendant of the Gui 속성의 하위 변경.
- GUI의 속성이 변경됩니다.
이 이벤트 중 하나가 발생하면 Gui의 모양이 다음 프레임에 표시될 때 재계산됩니다.
요약
속성
SurfaceGui가 항상 다른 3D 개체 위에 렌더링되는지 여부를 결정합니다.
Class.SurfaceGui.LightInfluence|LightInfluence가 0일 때 기준 조명 빛이 얼마나 크게 조정되는지 결정합니다.
가상 화면의 크기를 말합니다(가상 픽셀), 즉, 서피스 가이드와 호환되는 가상 화면 간의 픽셀 간 호환성을 가능하게 합니다.
설정을 참으로 하면 서면 GUI의 캔버스 경계 밖으로 떨어지는 구체 개체의 일부가 그려지지 않습니다.
게임 세계의 조명과 관련된 표면 가이드의 영향을 제어합니다.
표시 전에 서피스 가이드를 얼마나 멀리 표시할 수 있는지 제어합니다.
표면 가이드 콘텐츠를 렌더링하는 데 사용된 세계 공간 스터드 수를 결정합니다.
SurfaceGui가 고정 크기로 렌더링되거나 스터드 크기로 확장되는지 여부를 결정합니다.
들어 있는 도구가 아닌 표면 가이드에서 시작하는 클릭 거리를 설정합니다.
지상에 부착된 표면의 일반에 대해 SurfaceGui를 오프셋합니다.
이 LayerCollector 의 가시성을 전환합니다.
플레이어의 캐릭터가 재생성할 때마다 LayerCollector를 다시 클론하는지 여부를 결정합니다.
이 GuiObject.ZIndex 의 모든 후손에 대해 LayerCollector 가 어떻게 동작하는지 제어합니다.
UI 요소의 실제 화면 위치를 픽셀로 설명합니다.
UI 요소의 실제 화면 회전을 정도로 설명합니다.
UI 요소의 실제 화면 크기를 픽셀로 설명합니다.
설정을 사용하면 이 GuiBase2d와 그 후손에 대해 현지화가 적용됩니다.
이 GuiBase2d와 그 후손에 자동화 로컬화를 적용하기 위한 LocalizationTable 참조.
아래로 향하는 게임 패드 선택 동작을 사용자 정의합니다.
왼쪽 방향에서 게임 패드 선택 동작을 사용자 정의합니다.
오른쪽 방향으로 게임 패드 선택 동작을 사용자 정의합니다.
게임 패드 선택 동작을 위쪽으로 사용자 정의합니다.
게임 패드 선택 이동을 사용자 정의할 수 있습니다.
이벤트
이벤트가 GuiBase2d에서 상속되었습니다- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
게임 패드 선택이 이동하거나 떠나거나 연결된 GuiBase2d 또는 모든 하위 GuiObjects 내에서 변경되면 화면에 표시됩니다.
속성
AlwaysOnTop
SurfaceGui가 3D 콘텐츠 위에 렌더링되는지 여부를 결정합니다.
설정을 거짓으로 설정하면 표면 가이드가 다른 3D 콘텐츠와 마찬가지로 렌더링되고 다른 3D 개체에 의해 가려질 것입니다.
설정을 참으로 설정하면 항상 3D 콘텐츠 위에 렌더링되며 모양이 크게 변경됩니다.
- 색상은 ScreenGui 내에서 표시되는 것과 일치합니다.
- 고해상도 디스플레이 장치에서 텍스트가 더 날카로울 수 있습니다.
- SurfaceGui.LightInfluence는 0이라는 가상 숫자로 처리됩니다.
- SurfaceGui.Brightness 에 효과가 없습니다.
Brightness
밝기 는 GUI의 방출된 빛의 크기를 조정하는 요소를 결정합니다. 기본적으로 이 속성은 1이며 범위 [0, 1000]에 설정할 수 있습니다.
이 속성을 수정하면 사용자 인터페이스의 밝기가 환경과 더 잘 일치할 수 있습니다. 예를 인스턴스, Times Square와 같은 비디오 광고판은 밝은 날에 명확하게 표시되도록 더 밝게 만들 수 있습니다.
다음 시나리오에서는 GUI가 빛을 방출하지 않기 때문에 이 속성에 효과가 없습니다.
- Class.SurfaceGui.AlwaysOnTop|AlwaysOnTop 이 진실로 되면 각 픽셀의 색은 화면에 표시된 색과 같습니다.
- Class.SurfaceGui.LightInfluence|LightInfluence 가 1인 경우, 모든 GUI 빛이 환경으로 반사되어 방출되지 않습니다.
ClipsDescendants
설정을 참으로 하면 서면 GUI의 캔버스 경계 밖으로 떨어지는 구체 개체의 일부가 그려지지 않습니다.
이 속성이 false인 경우에도 대상의 지면 가이드 캔버스 밖에 있는 개체는 렌더링되지 않습니다.
MaxDistance
표시 전에 서피스 가이드를 얼마나 멀리 표시할 수 있는지 제어합니다. 값이 0인 경우 제한이 없으므로 무한에 걸쳐 멀리 표시됩니다.
많은 표면 가이드가 있는 경우 각 표면 가이드에 대해 적절한 값을 설정하는 것이 좋습니다. Studio에서 서면 가이드를 삽입할 때의 기본 값은 1000이지만 대부분의 사용 사례에는 괜찮을 것입니다.
야외에 있는 UI의 경우 최대 거리를 충분히 설정하여 화면에서 나오면 작은 크기의 UI가 표시되도록 합니다. 이렇게 하면 화면에서 나오거나 들어올 때 덜 잘 알려지게 됩니다.
표면 가이드 아래에 유사한 데칼을 추가하거나 UI 색상과 일치하는 부품 색상을 변경하여 팝업을 더 줄일 수 있습니다.You can reduce the pop in effect even more by adding a similar looking decal underneath the SurfaceGui, or by changing the part color to match the background color of your UI.
실내 공간의 경우 MaxDistance는 방의 크기보다 약간 더 커야 하므로 플레이어가 다른 방에 있을 때 UI가 렌더링되지 않습니다.
PixelsPerStud
픽셀 정보 조사기 는 서면 가이드의 콘텐츠를 렌더링하기 위해 사용된 픽셀의 밀도를 결정합니다.
더 높은 값은 다른 GuiObject 내에 있는 개체가 같은 크기로 유지되면
SizingMode
Class.SurfaceGui.CanvasSize를 사용하여 고정 크기 설정을 사용하면 서피스 가이드가 고정 크기를 사용하여 렌더링됩니다.
Class.SurfaceGui.PixelsPerStud로 설정하면 서피스 가이드가 스터드 기반의 변수 크기를 기반으로 렌더링됩니다. SurfaceGui.PixelsPerStud와 서피스 가이드의 크기를 스터드 단위로 지정합니다.
ToolPunchThroughDistance
설정된 도구가 아닌 표면 가이드에서 클릭하면 표면 가이드에서 작동하는 도구를 설정합니다. 만약 특정 캐릭터가 이 도구의 범위 내에 있다면, 도구는 클릭할 때 활성화되지 않습니다.