SurfaceGui

SurfaceGui : SurfaceGuiBase

Overview

SurfaceGui는 3D 공간에 2D UI 요소(GuiObject)를 배치하면서도 항상 카메라를 향하도록 표시해 주는 UI 컨테이너입니다. 이 컨테이너의 위치는 연결된 BasePart 또는 지정된 Adornee를 기준으로 결정됩니다.

또한 성능 최적화를 위해 SurfaceGui는 내부적으로 렌더링 결과를 캐싱하여 변화가 없을 때는 이를 재사용합니다. 그러나 SurfaceGui 자체의 속성 변화, 자식 요소의 속성 변경, 또는 자식 요소의 추가/삭제가 발생하면 캐시가 무효화되며, 다음 렌더링 프레임에서 화면 정보가 다시 계산됩니다.

SurfaceGui는 클라이언트 환경에서만 제어할 수 있습니다.

Properties

Face

Enum.NormalId

SurfaceGui를 렌더링되는 오브젝트의 어떤 면에 표시할지를 지정합니다.

Code Samples

local SurfaceGui = script.Parent

SurfaceGui.Face = Enum.NormalId.Top

ZOffset

number

동일한 면에 배치된 여러 SurfaceGui가 어떤 순서로 겹쳐 그려질지를 지정합니다.

Code Samples

local SurfaceGui = script.Parent

SurfaceGui.ZOffset = 2

Methods

Events

See also

GUI