SurfaceGui는 3D 세계에서 부품 표면에 UI 개체를 렌더링하고 기본 사용자 상호 작용이 발생하도록 허용하면서도 기본 사용자 상호 작용이 발생하도록 허용합니다. 및 와 마찬가지로, 및 와 같은 UI 개체는 표면에서 동일한 방향을 향하며, 속성을 통해 편집할 수 있습니다.
상호 작용하는 UI 요소(예: 및 내의 )는 일반적으로 부모로 지정되는 를 통해 사용자 입력만 받을 수 있으며, 일반적으로 내부 에 배치하여 수행합니다.Adornee 속성을 사용하여 3D 세계에서 부품을 타겟으로 지정할 수 있으면서 SurfaceGui 자체는 PlayerGui에 남아 있습니다.
경험 내 UI에서 SurfaceGui와 작업하는 방법에 대한 가이드를 참조하십시오.
캐싱 행동
이행향상시키기 위해, SurfaceGui의 모양이 다음 중 하나가 발생할 때까지 캐시되어 다음에 모양이 다시 계산됩니다.
- 하위 요소가 추가되거나 제거되어 SurfaceGui에 추가됩니다.
- SurfaceGui의 후손의 속성이 변경됩니다.
- SurfaceGui 자체의 속성이 변경됩니다.
요약
속성
SurfaceGui 가 항상 다른 3D 개체 위에 렌더링될지 여부를 결정합니다.
컨테이너의 조명이 때 크기가 조정되는 요소를 결정합니다.
픽셀에서 픽셀로 호환되도록 만드는 "가상 픽셀"의 "가상 화면" 크기.
캔버스 경계 밖으로 떨어지는 부분이 그려질지 여부.
환경 조명의 영향을 받는 SurfaceGui의 정도를 제어합니다.
렌더링을 중지하기 전에 컨트롤이 SurfaceGui로 표시될 수 있는 거리를 제어합니다.
각 세계 공간 스터드에서 렌더링하는 내용을 표시하기 위해 사용되는 픽셀 밀도를 결정합니다. SurfaceGui .
SurfaceGui 가 스터드의 크기와 함께 고정된 크기나 크기 비율로 렌더링할지 여부를 결정합니다.
왼쪽 클릭이 길게 누르는 동작이 시작되는 거리를 SurfaceGui에서 대신 Tool로 설정합니다.
같은 얼굴에서 다른 와 관련하여 레이어를 배치합니다.
BasePart 에 적용할 SurfaceGui , 기본 부모 조합을 재정의하는 데
Enum.NormalId 에 적용할 SurfaceGui 얼굴.
이 LayerCollector 의 표시 여부를 전환합니다.
플레이어의 캐릭터가 재생성될 때마다 리셋(자체를 삭제하고 플레이어의 캐릭터로 다시 클론화)되는지 여부를 결정합니다.
이 GuiObject.ZIndex 의 모든 하위에서 어떻게 작동하는지 제어합니다. LayerCollector .
픽셀로 표시되는 실제 화면 위치의 GuiBase2d 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소
GuiBase2d 요소의 실제 화면 회전을 도 단위로 설명합니다.
픽셀로 표시되는 실제 화면 크기의 GuiBase2d 요소를 설명합니다.
true 로 설정되면 지역화가 이 GuiBase2d 및 그 하위에 적용됩니다.
이 GuiBase2d 및 그 하위에 자동화된 로캘리제이션을 적용하기 위해 사용할 LocalizationTable 참조.
아래쪽 방향으로 게임패드 선택 행동을 사용자 지정합니다.
왼쪽 방향에서 게임패드 선택 동작을 사용자 지정합니다.
오른쪽 방향으로 게임패드 선택 행동을 사용자 지정합니다.
위쪽으로 게임패드 선택 행동을 사용자 지정합니다.
게임패드 선택 이동을 사용자 지정할 수 있습니다.
이벤트
이벤트가 GuiBase2d에서 상속되었습니다- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
연결된 게임패드 선택이 이동하거나, 나가거나, 변경되면 발생합니다. GuiBase2d 또는 모든 하위 요소에서 GuiObjects 입니다.
속성
AlwaysOnTop
이 속성은 SurfaceGui가 항상 다른 3D 개체 위에 렌더링되는지 여부를 결정합니다.
기본값으로 설정되면 (기본값) 다른 3D 콘텐츠처럼 렌더링되고 다른 3D 개체에 의해 차단됩니다.true 으로 설정되면, SurfaceGui 항상 3D 콘텐츠 위에 렌더링되고 모양이 크게 변경됩니다.
- 색상은 내부에서 표시되는 방식과 일치합니다 ScreenGui.
- 텍스트는 높은 DPI 장치에서 더 날카롭게 표시될 수 있습니다.
- LightInfluence은 마치 0인 것처럼 처리됩니다.
- Brightness는 효과가 없습니다.
Brightness
이 속성은 컨테이너의 조명이 LightInfluence 때 크기가 조정되는 요소를 결정합니다.This property determines the factor by which the SurfaceGui container's light is scaled when is 0 .기본적으로 이 속성은 1 이며, 0 와 1000 사이의 모든 숫자로 설정할 수 있습니다.이 속성을 수정하여 SurfaceGui 의 명백한 밝기가 환경과 더 일치할 수 있습니다.예를 인스턴스, 비디오 광고판은 어두운 방 내에서 밝도를 높이기 위해 Brightness에서 10로 증가할 수 있습니다.
Studio에서 에 액세스할 수 없으며, 또는 이 인 경우 효과가 없습니다.
ClipsDescendants
기본값으로 설정되면 (기본값) 캔버스 경계 밖으로 떨어지는 부분이 그려지지 않습니다.
이 속성이 일 때에도 캔버스 밖에 있는 가 완전히 렌더링되지 않습니다.
LightInfluence
환경 조명의 영향을 받는 정도를 에서 에 이르는 범위에서 제어합니다.이것을 1 으로 설정하면 주변 조명이 모습완전히 제어할 수 있고, 0 으로 설정하면 조명이 영향을 미치지 않는다는 것을 의미합니다.
MaxDistance
이 속성은 렌더링이 중지되기 전에 카메라로부터 얼마나 멀리 SurfaceGui가 표시되는지 제어합니다.값 0 는 제한이 없으며 무한히 멀리 렌더링될 것을 의미합니다.기본값인 1000은 대부분의 경우 잘 작동합니다.
야외에 나타나는 경우 SurfaceGuis 컨테이너의 UI가 화면에 나타날 때 충분히 작아지도록 하기 위해 MaxDistance 가 충분히 높아야 하며, 갑작스런 팝업/아웃 효과를 최소화합니다.
PixelsPerStud
이 속성은 각 세계 공간 스터드에서 렌더링하는 내용을 표시하기 위해 사용되는 픽셀의 밀도를 결정합니다.This property determines the density of pixels used for each world-space stud to render the contents of the SurfaceGui .더 높은 값은 동일한 크기로 유지되면 다양한 GuiObjects 내부가 더 작게 표시되도록 합니다.반대로, 더 낮은 값은 개체가 더 커 보이게 만듭니다.그러나, GuiObjects 를 사용하여 비례적으로 크기가 조정되는 경우, UIScale , GuiObject.Size , TextLabel.TextSize 또는 유사한 경우, 이 속성을 사용하여 더 높은 정의를 사용할 수 있습니다.
플레이어가 보기를 예상하는 거리에 따라 값을 선택하는 것이 중요합니다.It's important to select a value based on how far away you expect a player to view the SurfaceGui .또한 장식된 부품의 얼굴이 충분히 크면 큰 픽셀 밀도가 성능에 부정적인 영향을 미칠 수 있음을 명심하십시오.
SizingMode
기본값으로 설정되면 (기본값)에서는 변수 크기를 기반으로 및 표면의 스터드 크기에 따라 렌더링됩니다.
Enum.SurfaceGuiSizingMode.FixedSize 로 설정되면 SurfaceGui 는 고정된 크기를 통해 렌더링됩니다.When set to , the renders with a fixed size set through CanvasSize .
ToolPunchThroughDistance
왼쪽 클릭이 길게 누르는 동작이 시작되는 거리를 SurfaceGui에서 대신 Tool로 설정합니다.캐릭터가 이 거리의 SurfaceGui 내에 있으면 클릭 시 Tool 가 활성화되지 않습니다.
ZOffset
같은 얼굴에 있는 다른 사람들과 관련하여 이 SurfaceGui 를 배치하십시오 (이를 변경하면 시각적으로 "들어 올리거나" "가라 앉히지" 않습니다 SurfaceGui 표면에서).