경험 내 UI 컨테이너는 당신의 경험의 3D 세계 내에서 표시하고자 하는 GuiObjects를 포함합니다.
- SurfaceGui는 3D 세계의 파트 표면에 UI 객체를 렌더링할 수 있으며, 기본적인 사용자 상호작용이 가능하게 합니다.
- BillboardGui는 UI 객체가 3D 공간에 나타나지만 항상 카메라를 향하도록 하는 컨테이너입니다.
Surface UI
Decals 및 Textures와 유사하게, SurfaceGui에 부모가 되는 TextLabels 및 ImageLabels와 같은 UI 객체는 표면이 있는 방향을 향합니다. 이는 SurfaceGui.Face 속성을 통해 편집할 수 있습니다.
경험 내 BasePart에 SurfaceGui를 적용하려면, 해당 파트에 부모로 설정하고 SurfaceGui.Face 속성을 설정하면 됩니다. 자식 UI 객체는 부모 파트의 해당 표면에 나타납니다.
또는 StarterGui와 같은 컨테이너 내부에 SurfaceGui를 배치한 후, 해당 Adornee 속성을 임의의 BasePart 및 목표 Face로 설정할 수 있습니다. Adornee를 설정하면 직접 부모 연결을 무시하여 런타임 중 스크립트에서 설정할 수 있어 배치 유연성을 높입니다.
SurfaceGui 내에서 ImageButtons 및 TextButtons와 같은 인터랙티브 UI 요소는 플레이어의 PlayerGui에 부모가 되어야만 사용자 입력을 받을 수 있으며, 일반적으로는 위에서 언급한 대로 StarterGui 내부에 SurfaceGui를 배치해야 합니다. 또한, 파트의 CanQuery 속성이 true여야 인터랙티브 UI 요소가 입력을 받을 수 있습니다.
SurfaceGui에 대해 올바른 표면을 선택하는 데 도움이 되도록, 대상 파트를 마우스 오른쪽 버튼으로 클릭하고 Show Orientation Indicator를 선택하세요. 그러면 객체의 Front 면에 붙어 있는 F와 선이 있는 파란색 원이 표시되고, 객체의 Top 면 방향을 가리키는 녹색 화살표가 나타납니다.
크기 및 위치
SurfaceGui의 "캔버스"는 부모 또는 Adornee 파트의 전체 Face를 차지합니다. 모범 사례로서 자식 UI 객체인 ImageLabels의 크기 및 위치에는 스케일 값을 사용하는 것이 좋습니다. 또한 SurfaceGui의 자식에게 UIAspectRatioConstraint를 적용하여 면의 크기에 관계없이 원하는 종횡비를 유지할 수 있습니다.
가리기 모드
AlwaysOnTop 속성은 SurfaceGui가 3D 콘텐츠 위에 렌더링될지를 결정하며, 이는 다른 3D 객체에 의해 가려지지 않습니다. false(기본값)로 설정되면 SurfaceGui는 다른 3D 콘텐츠처럼 렌더링되고 다른 3D 객체에 의해 가려집니다. true로 설정되면 항상 3D 콘텐츠 위에 렌더링되며, 3D 환경의 밝기/빛 영향을 받지 않습니다.
밝기 및 조명 영향
Brightness 및 LightInfluence는 환경 조명이 SurfaceGui의 UI 콘텐츠에 어떤 영향을 미치는지를 결정하는 데 함께 작용합니다.
Brightness는 방출된 빛이 0에서 1000의 범위로 스케일되는 요소를 결정하여 SurfaceGui를 환경에 맞출 수 있게 합니다. 예를 들어, 어두운 방 안에서 비디오 게시판을 밝게 하려면 Brightness를 10으로 증가시키면 됩니다.
LightInfluence는 장소의 조명에 얼마나 영향을 받는지를 0에서 1의 범위로 제어합니다. 이를 1로 설정하면 주변 조명이 외관에 전적인 제어를 가지며, 0으로 설정하면 조명은 아무런 영향을 미치지 않습니다.
Brightness는 스튜디오에서 접근할 수 없으며, LightInfluence가 1이거나 AlwaysOnTop가 true일 경우에는 어떤 효과도 없습니다.
거리 가시성
MaxDistance는 카메라로부터 얼마나 멀리 떨어져 있는지를 제어하며 렌더링을 중지합니다. 값이 0이면 제한이 없으며 무한히 멀리 렌더링합니다. 기본값은 1000이며 대부분의 경우에 적합합니다.
야외에서 나타나는 SurfaceGuis의 경우, 컨테이너의 UI가 나타나거나 사라질 때 화면에서 충분히 작아지는 것을 보장하기 위해 MaxDistance가 충분히 높아야 합니다. 이로 인해 갑작스러운 팝인/팝아웃 효과를 최소화할 수 있습니다.
표시 순서
같은 면에 여러 개의 SurfaceGui 컨테이너가 존재하는 경우, ZOffset 속성을 통해 Z-인덱스로 레이어링할 수 있습니다(이를 변경한다고 해서 보이는 "올려지거나 내려가게" 되지는 않습니다).
Billboard UI
BillboardGui 컨테이너는 3D 공간에 UI 객체를 표시하지만, SurfaceGui와는 달리 BillboardGui의 자식은 항상 카메라를 향하도록 설정됩니다. 이 컨테이너는 건강 미터, 플레이어 캐릭터 위의 이름 및 3D 세계의 객체로 플레이어를 안내하기 위한 마커와 같이 경험 내 객체 위에 정면으로 표시되는 정보를 보여주는 데 유용합니다.
경험 내 BasePart 또는 Attachment에 BillboardGui를 연결하려면, 해당 파트나 첨부물에 부모로 설정하고 원하면 크기/위치를 조정하면 됩니다.
또는 BillboardGui를 StarterGui와 같은 컨테이너 내에 배치한 후, Adornee 속성을 임의의 BasePart 또는 Attachment로 설정할 수 있습니다. 이 방법은 Adornee를 런타임 중 스크립트에서 설정할 수 있어 배치 유연성을 더합니다. 예를 들어 런타임 중 플레이어 캐릭터의 머리 위에 BillboardGui를 배치할 수 있습니다.
BillboardGui 내부의 ImageButtons 및 TextButtons와 같은 인터랙티브 UI 요소는 플레이어의 PlayerGui에 부모가 되어야만 사용자 입력을 받을 수 있으며, 일반적으로는 위에서 언급한 대로 StarterGui 내부에 BillboardGui를 배치해야 합니다.
크기 및 위치
전시판 크기의 경우, Size 속성의 스케일 구성 요소는 3D 공간에서 전시판의 스터드(size) 크기를 설정합니다. 예를 들어, 설정값 {10, 0},{2, 0} (UDim2.fromScale(10, 2))는 카메라와의 거리 변화에 따라 더 커지거나 작아지는 10:2 종횡비의 전시판을 형성합니다.
위치를 위한 StudsOffset 속성은 카메라에 상대하여 전시판 캔버스를 X 축(왼쪽/오른쪽), Y 축(위/아래), 및 Z 축(앞/뒤) 방향으로 이동시킵니다.
TextLabel을 포함하는 크기 조정된 BillboardGui를 생성할 때, 해당 레이블의 TextScaled 속성을 활성화하면 텍스트가 카메라 거리 변화에 따라 전시판 캔버스와 함께 조정됩니다.
가리기 모드
AlwaysOnTop 속성은 BillboardGui가 3D 콘텐츠 위에서 렌더링될지를 결정하며, 이는 다른 3D 객체에 의해 가려지지 않습니다. false(기본값)로 설정되면, BillboardGui는 다른 3D 콘텐츠처럼 렌더링되며, 다른 3D 객체에 의해 가려집니다. true로 설정되면 항상 3D 콘텐츠 위에 렌더링되며, 3D 환경의 밝기/빛 영향을 받지 않습니다.
밝기 및 조명 영향
Brightness 및 LightInfluence는 환경 조명이 BillboardGui의 UI 콘텐츠에 어떤 영향을 미치는지를 결정하는 데 함께 작용합니다.
Brightness는 방출된 빛이 0에서 1000의 범위로 스케일되는 요소를 결정하여 BillboardGui를 환경에 맞출 수 있게 합니다. 예를 들어, 어두운 방 안에서 비디오 게시판을 밝게 하려면 Brightness를 10으로 증가시키면 됩니다.
LightInfluence는 장소의 조명에 얼마나 영향을 받는지를 0에서 1의 범위로 제어합니다. 이를 1로 설정하면 주변 조명이 외관에 전적인 제어를 가지며, 0으로 설정하면 조명은 아무런 영향을 미치지 않습니다.
Brightness는 스튜디오에서 접근할 수 없으며, LightInfluence가 1이거나 AlwaysOnTop가 true일 경우에는 어떤 효과도 없습니다.
거리 가시성
MaxDistance는 카메라로부터 얼마나 멀리 떨어져 있는지를 제어하며 렌더링을 중지합니다. 값이 0 또는 inf(기본값)이면 제한이 없으며 무한히 멀리 렌더링합니다.