BillboardGui

후손이 입력 이벤트를 받을지 여부를 제어합니다. 인터페이스에서 버튼을 클릭하려면 두 버튼 모두에서 GuiButton 이 버튼이 클릭 가능해야 합니다.

BillboardGuis는 PlayerGui에 부모로 지정된 경우에만 사용자 입력을 수신합니다. BillboardGui.Adornee 속성을 사용하여 작업 공간의 하나를 대상으로 할 수 있습니다. UI 자체가 PlayerGui 에 있는 동안에는 Class.BillboardGui.Adornee 을 사용할 수 없습니다.

BillboardGui가 배치된 대상 부품 또는 부착물을 설정합니다. 아도르니가 설정되지 않으면 대신 Parent가 사용됩니다.

BillboardGui가 3D 콘텐츠 위에 렌더링되는지 여부를 결정합니다.

BillboardGui를 false로 설정하면 다른 3D 콘텐츠처럼 렌더링되고 다른 3D 개체에 의해 가려질 수 있습니다.

설정을 참으로 설정하면 항상 3D 콘텐츠 위에 렌더링되며 모양이 크게 변경됩니다.

• 색상은 ScreenGui 내에서 표시되는 것과 일치합니다.
• 고해상도 디스플레이 장치에서 텍스트가 더 날카로울 수 있습니다.
• BillboardGui.LightInfluence는 0이라는 가상 숫자로 처리됩니다.
• BillboardGui.Brightness 에 효과가 없습니다.

밝기 는 GUI의 방출된 빛의 크기를 조정하는 요소를 결정합니다. 기본적으로 이 속성은 1이며 범위 [0, 1000]에 설정할 수 있습니다.

이 속성을 수정하면 사용자 인터페이스의 밝기가 환경과 더 잘 일치할 수 있습니다. 예를 인스턴스, Times Square와 같은 비디오 광고판은 밝은 날에 명확하게 표시되도록 더 밝게 만들 수 있습니다.

다음 시나리오에서는 GUI가 빛을 방출하지 않기 때문에 이 속성에 효과가 없습니다.

• Class.BillboardGui.AlwaysOnTop|AlwaysOnTop 이 진실로 되면 각 픽셀의 색은 화면에 표시된 색과 같습니다.
• Class.BillboardGui.LightInfluence|LightInfluence 가 1인 경우, 모든 조명이 대신 환경으로 반사되므로 배포되지 않습니다.

설정을 참으로 하면 BillboardGui의 캔버스 경계 밖으로 떨어지는 GuiObjects의 일부가 그려지지 않습니다.

이 속성이 false인 경우에도 배너 가이드의 캔버스 밖에 있는 개체는 렌더링되지 않습니다.

Class.BillboardGui 는 플레이어의 카메라에서 현재 거리를 기반으로 합니다. 변경된 이벤트는 이 속성에 대해 BillboardGui.DistanceStep 이 0보다 큰 경우에만 발생하지 않습니다.

Class.BillboardGui 가 플레이어의 현재 카메라와 비율적으로 크기를 조정하지 않고 크기를 조정하는 데 사용되는 스터드 값을 결정합니다. 구이의 길이가 이 값 아래에 있으면 해당 구이의 크기를 더 작게 조정하지 않습니다. 이 속성의 기본값은 0 스터드입니다.

플레이어의 카메라가 더 가까이 및 더 멀리 이동함에 따라 BillboardGui.CurrentDistance 증가 및 감소를 스터드 단위로 결정합니다. 속성은 기본적으로 0을 사용하고 시작 지점에서 BillboardGui까지 둥근 값을 반올림합니다.

예를 들어, 이 속성이 0.5로 설정되고 플레이어의 카메라가 0에서 멀리 이동하면 현재 거리가 0 -> 0.5 -> 1 -> 1.5 -> ... 및 이후로 증가합니다.

플레이어의 현재 카메라와 비율이 맞춤형 크기 조정기를 사용하여 크기를 조정하지 않고 작게 조정하는 경우 BillboardGui 의 크기를 줄이는 데 필요한 거리를 결정합니다. 구i의 크기가 이 값 위에 있으면 구i의 크기를 줄이지 않고 이 값 위에서 작게 조정할 수 없습니다.

이 속성은 값이 0보다 작다면 무시됩니다. 기본 값은 -1이므로 이 속성이 기본적으로 무시됩니다.

ExtentsOffset 는 모델의 Adornee 지향 및 단위와 관련하여 광고 가이드 기 는 전체 크기의 Camera 바인딩 박스의 절반 크기입니다.

또한 참조하십시오.

• ExtentsOffsetWorldSpace , 즉 오프셋 방향은 글로벌 축에 대해 상대적으로 오프셋이 있음에 따라 작동합니다.
• StudsOffset , 이는 단위가 스터드가 아닌 경우에도 작동합니다.

ExtentsOffsetWorldSpace 은 광고판 가이드라인 세계에서 광고판 가이드라인 세계의 축과 단위의 크기에 대해 광고판 가이드라인 세계의 축 정렬 바인딩 박스의 절반 크기입니다.

또한 참조하십시오.

• ExtentsOffset , 이는 오프셋 방향이 Camera 에 대해 상대적으로 작동합니다.
• StudsOffsetWorldSpace , 이는 단위가 스터드가 아닌 경우에만 작동합니다.

BillboardGui가 환경의 조명에 얼마나 영향을 받는지 제어합니다.

0으로 설정하면 사용자 인터페이스가 LCD 화면과 동일하게 작동하며 주변 조명에 관계없이 동일하게 표시됩니다.

1로 설정되면 UI는 종이 조각과 동일하게 행동하며 다른 소스빛만 반사합니다.

Class.BillboardGui의 최대 거리 속성은 광고판이 카메라에서 얼마나 멀리 떨어져 있는지 설정하고 여전히 그려질 수 있습니다. 카메라와 광고판이 최대 거리를 초과하면 광고판이 여전히 표시되지 않습니다. 이 속성의 기본 값은 무한입니다.

이 값이 0보다 작거나 같으면 최대 거리가 무한으로 처리되고 광고판은 항상 그리기 가능합니다.

예시

-- 기본 카메라/컨트롤 스크립트 로드를 불러오다
task.wait(5)

-- 개체 선언 및 초기화
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")

-- 카메라 유형 입력
camera.CameraType = Enum.CameraType.Scriptable

-- 부품 위치 설정 및 잠금 플레이스
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true

-- 간단한 광고판 설치
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)

-- 레이블 설정
label.Size = UDim2.fromScale(1, 1)

-- 개체의 부모 설정
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace

-- 카메라를 부품 옆에 이동합니다. 잠깐 기다리고 카메라를 이동합니다.
local cameraPosition0 = part.Position + Vector3.new(0, 0, 10)
local cameraPosition1 = part.Position + Vector3.new(0, 0, 20)
camera.CFrame = CFrame.lookAt(cameraPosition0, part.Position)

-- 간단한 광고판 내용은 여기에 표시됩니다
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

특정 플레이어에게서 BillboardGui를 숨기는 데 사용됩니다.

UI를 하나 이상의 플레이어에게 숨기려면 BillboardGui를 StarterGui 에 배치하고 스크립트를 사용하여

BillboardGui의 화면에 표시되는 크기를 제어합니다.

크기의 크기 구성 요소는 스터드 단위의 크기로 해석되며, 크기 값이 사용되면 자동으로 거리에 따라 크기가 조정됩니다.

크기의 크기 및 오프셋 부분이 함께 추가되며 동시에 사용할 수 있습니다.

크기 상대 단위의 2D 오프셋이 앵커 포인트 역할을 하는 경우. 이 오프셋은 GuiObject.AnchorPoint 속성과 동일하게 사용할 수 있지만 값은 다릅니다.

일반적인 값

| 크기 조정 | 설명 | | 0.0, 0.0 | 기본. UI는 센터에 고정됩니다. | | 0.5, 0.5 | 기본. UI는 왼쪽 하단에 고정됩니다. | | 0.5, -0.5 |

또한 참조하십시오.

• StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffset0> , which are all other 오프셋 속성은 3D 공간에서 작동합니

StudsOffset 은 단위를 스터드 기준으로 Adornee 와 Camera 의 방향을 비교하여 광고판 가이드의 오프셋을 결정합니다.

또한 참조하십시오.

• StudsOffsetWorldSpace , 즉 오프셋 방향은 글로벌 축에 대해 상대적으로 오프셋이 있음에 따라 작동합니다.
• ExtentsOffset , 이는 단위가 모델의 카메라 정렬 바 중 절반 크기만큼 작다는 점을 제외하고 동작합니다.

StudsOffsetWorldSpace 는 광고판 가이드라인 기준 지역 축과 비율에 대해 광고판 가이드라인 기준 지역 축의 상대적인 위치를 결정합니다.

또한 참조하십시오.

• StudsOffset , 셋째 경우 오프셋 방향은 Camera에 대해 상대적이지 않습니다.
• ExtentsOffsetWorldSpace , 이는 단위가 모델 축 정렬 바인딩 박스의 절반 크기인 경우에만 작동합니다.