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