BillboardGui

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

BillboardGui는 UI 개체가 3D 공간에 나타나지만 항상 카메라를 향하는 컨테이너입니다.컨테이너의 위치는 부모 BasePart 또는 Attachment (또는 Adornee)에 대한 상대 위치입니다.For BaseParts 에는 Position 속성이 사용되고, For Attachments 에는 WorldPosition 속성이 사용됩니다.

BillboardGui with a TextLabel describing the screen console it floats above.

광고판의 Size 속성은 GuiObject.Size 와 약간 다르게 작동합니다. 오프셋 구성 요소는 동일하게 작동하지만, 스케일 구성 요소는 3D 공간에서 스터드 크기로 사용됩니다.

크기가 조정된 BillboardGuiTextLabel 가 포함되어 있을 때, 카메라 거리가 변경됨에 따라 레이블의 TextScaled 속성이 확장되도록 활성화하면 텍스트가 광고 캔버스와 함께 확장되는 것을 방지할 수 있습니다.

상호 작용하는 UI 요소(예: 및 내의 )는 일반적으로 부모로 지정되는 를 통해 사용자 입력만 받을 수 있으며, 일반적으로 내부 에 배치하여 수행합니다.Adornee 속성을 사용하여 3D 세계에서 부품이나 첨부 파일을 타겟으로 지정할 수 있으면서도 BillboardGui 자체는 PlayerGui에 남아 있습니다.

경험 내 UI에서 BillboardGui와 작업하는 방법에 대한 가이드를 참조하십시오.

캐싱 행동

이행향상시키기 위해, BillboardGui의 모양이 다음 중 하나가 발생할 때까지 캐시되어 다음에 모양이 다시 계산됩니다.

  • 하위 요소가 추가되거나 제거되어 BillboardGui에 추가됩니다.
  • BillboardGui의 후손의 속성이 변경됩니다.
  • BillboardGui 자체의 속성이 변경됩니다.

요약

속성

  • 병렬 읽기

    후손이 입력 이벤트를 받을지 여부를 제어합니다.

  • 병렬 읽기

    BillboardGui가 위치한 대상 부품이나 첨부 파일을 설정합니다.

  • 병렬 읽기

    BillboardGui 가 항상 다른 3D 개체 위에 렌더링될지 여부를 결정합니다.

  • 병렬 읽기

    컨테이너의 조명이 때 크기가 조정되는 요소를 결정합니다.

  • 캔버스 경계 밖으로 떨어지는 부분이 그려질지 여부.

  • 읽기 전용
    복제되지 않음
    병렬 읽기

    BillboardGui의 현재 거리는 플레이어의 카메라에서 온 스터드입니다.

  • BillboardGui가 크기가 커지는 것을 중지하는 스터드 거리를 결정합니다.

  • 병렬 읽기

    플레이어의 카메라가 더 가까이 또는 멀리 이동할 때 스터드의 크기 증가 및 감소를 결정합니다. CurrentDistance 스터드로 플레이어의 카메라가 이동할 때 크기 증가 및 감소를 결정합니다. BillboardGui

  • BillboardGui가 크기가 더 작아지는 것을 중지하는 스터드 거리를 결정합니다.

  • 병렬 읽기

    모델의 Camera 알맞은 크기의 바인딩 상자의 절반 차원으로, Adornee 방향에서 BillboardGui 가 어떻게 오프셋되는지 결정합니다, 모델의 Camera 정렬된 바인딩 상자의 절반 차원의 유닛.

  • 모델의 축 정렬된 바인딩 상자 너비의 절반 단위에서 전체 축에 대해 BillboardGui 가 어떻게 오프셋되는지 결정합니다. determines how the is offset from its Adornee , relative to the global axes, in units half the dimensions of the model's axis-aligned bounding box.

  • 병렬 읽기

    환경 조명의 영향을 받는 BillboardGui의 정도를 제어합니다.

  • 병렬 읽기

    렌더링을 중지하기 전에 컨트롤이 BillboardGui로 표시될 수 있는 거리를 제어합니다.

  • 스크립트에서 특정 플레이어로부터 BillboardGui를 숨기기 위해 사용됩니다.

  • 병렬 읽기

    BillboardGui가 화면에 가질 크기를 제어합니다.

  • 병렬 읽기

    크기 상대 단위의 2D 오프셋으로, 앵커 포인트처럼 작동합니다.

  • 병렬 읽기

    가 스터드에서 어떻게 오프셋되는지 결정하며, 이는 스터드에 대한 방향과 관련이 있습니다.

  • 글로벌 축에 대해 에서 오프셋이 어떻게 결정되는지, 스터드 단위로 스터드에 대해 결정합니다.

속성LayerCollector에서 상속되었습니다속성GuiBase2d에서 상속되었습니다

이벤트

이벤트GuiBase2d에서 상속되었습니다

속성

Active

병렬 읽기

후손이 입력 이벤트를 받을지 여부를 제어합니다. 에 가 포함되어 있으면, 해당 버튼은 두 버튼 모두에서 로 설정된 경우에만 클릭할 수 있습니다.

상호 작용하는 UI 요소(예: 및 내의 )는 일반적으로 부모로 지정되는 를 통해 사용자 입력만 받을 수 있으며, 일반적으로 내부 에 배치하여 수행합니다.Adornee 속성을 사용하여 3D 세계에서 부품이나 첨부 파일을 타겟으로 지정할 수 있으면서도 BillboardGui 자체는 PlayerGui에 남아 있습니다.

Adornee

병렬 읽기

대상 BasePart 또는 Attachment 가 위치한 BillboardGui 에 대해 상대적으로 위치하도록 설정하여 부모 부품이나 부착물을 재정의합니다.

AlwaysOnTop

병렬 읽기

이 속성은 BillboardGui가 항상 다른 3D 개체 위에 렌더링되는지 여부를 결정합니다.

기본값으로 설정되면 (기본값) 다른 3D 콘텐츠처럼 렌더링되고 다른 3D 개체에 의해 차단됩니다.true 으로 설정되면, BillboardGui 항상 3D 콘텐츠 위에 렌더링되고 모양이 크게 변경됩니다.

  • 색상은 내부에서 표시되는 방식과 일치합니다 ScreenGui.
  • 텍스트는 높은 DPI 장치에서 더 날카롭게 표시될 수 있습니다.
  • LightInfluence은 마치 0인 것처럼 처리됩니다.
  • Brightness는 효과가 없습니다.

Brightness

병렬 읽기

이 속성은 컨테이너의 조명이 LightInfluence 때 크기가 조정되는 요소를 결정합니다.This property determines the factor by which the BillboardGui container's light is scaled when is 0 .기본적으로 이 속성은 1 이며, 01000 사이의 모든 숫자로 설정할 수 있습니다.이 속성을 수정하여 BillboardGui 의 명백한 밝기가 환경과 더 일치할 수 있습니다.예를 인스턴스, 비디오 광고판은 어두운 방 내에서 밝도를 높이기 위해 Brightness에서 10로 증가할 수 있습니다.

Studio에서 에 액세스할 수 없으며, 또는 이 인 경우 효과가 없습니다.

ClipsDescendants

병렬 읽기

기본값으로 설정되면 (기본값) 캔버스 경계 밖으로 떨어지는 부분이 그려지지 않습니다.

이 속성이 일 때에도 캔버스 밖에 있는 가 완전히 렌더링되지 않습니다.

CurrentDistance

읽기 전용
복제되지 않음
병렬 읽기

BillboardGui의 현재 거리는 플레이어의 카메라에서 온 스터드입니다.변경된 이벤트는 DistanceStep 이상이면 이 속성에 대해 발생하지 않으며, 0 이하이면 발생합니다.

DistanceLowerLimit

병렬 읽기

BillboardGui의 크기가 플레이어의 현재 카메라와 비교해 더 커지지 않는 거리(기본값: 0)에서 스터드 단위의 거리를 결정합니다.만약 의 가 이 값보다 작으면, 이 거리에서와 같이 더 크게 확장되지 않습니다.

DistanceStep

병렬 읽기

플레이어의 카메라가 더 가까이 또는 멀리 이동할 때 스터드의 크기 증가 및 감소를 결정합니다. CurrentDistance 스터드로 플레이어의 카메라가 이동할 때 크기 증가 및 감소를 결정합니다. BillboardGui속성은 기본값으로 0 로 설정되고 DistanceLowerLimit 에서 시작하는 라운드업됩니다.

DistanceUpperLimit

병렬 읽기

BillboardGui가 플레이어의 현재 카메라와 비교해 크기가 더 작아지는 것을 중지하는 스터드 거리를 결정합니다. 의 값이 이 값보다 높으면 이 거리에서와 같은 크기로 줄어들지 않습니다.

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

ExtentsOffset

병렬 읽기

이 속성은 모델의 알맞은 바인딩 상자의 차원 절반 단위에서 에 대해 어떻게 오프셋되는지를 결정합니다, 모델의 방향과 관련하여, 모델의 바인딩 상자의 길이의 절반 단위에서.

유사하지만 스터드 단위를 사용하는 StudsOffset 또는 오프셋 방향이 전체 글로벌 축에 대한 것인 대신 ExtentsOffsetWorldSpace 을 사용하는 것과 마찬가지로 작동하는 것도 참조하십시오.

ExtentsOffsetWorldSpace

병렬 읽기

이 속성은 모델의 축 정렬된 바인딩 상자 차원의 절반 단위에서 글로벌 축에 대해 BillboardGui 가 어떻게 오프셋되는지 결정합니다.This property determines how the is offset from its Adornee , relative to the global axes, in units half the dimensions of the model's axis-aligned bounding box.

유사하지만 스터드 단위를 사용하는 StudsOffset 또는 오프셋 방향이 ExtentsOffset 에 대한 것임을 제외하고 유사하게 작동하는 Camera 을 참조하십시오.

LightInfluence

병렬 읽기

환경 조명의 영향을 받는 정도를 에서 에 이르는 범위에서 제어합니다.이것을 1 으로 설정하면 주변 조명이 모습완전히 제어할 수 있고, 0 으로 설정하면 조명이 영향을 미치지 않는다는 것을 의미합니다.

MaxDistance

병렬 읽기

이 속성은 렌더링이 중지되기 전에 카메라로부터 얼마나 멀리 BillboardGui가 표시되는지 제어합니다.값 0 또는 inf (기본값)은 제한이 없으며 무한히 멀리 렌더링될 것을 의미합니다.

야외에 나타나는 경우 BillboardGuis 컨테이너의 UI가 화면에 나타날 때 충분히 작아지도록 하기 위해 MaxDistance 가 충분히 높아야 하며, 갑작스런 팝업/아웃 효과를 최소화합니다.

PlayerToHideFrom

병렬 읽기

스크립트에서 특정 플레이어로부터 BillboardGui를 숨기기 위해 사용됩니다.

한 명 이상의 플레이어에서 BillboardGui 를 숨기려면 StarterGui 에 배치하고 스크립트를 사용하여 Enabled 속성을 설정하여 해당 LocalPlayer 가 볼 수 있는지 여부에 따라 설정합니다.속성을 사용하여 부모로 지정하는 대신 에 연결할 수 있습니다 또는 에 연결할 수 있습니다 또는 에 연결할 수 있습니다 대신 부모로 지정합니다.

Size

병렬 읽기

BillboardGui가 화면에 가질 크기를 제어합니다.GuiObject.Size 와 달리, 이 속성의 크기 조정 구성 요소는 광고판의 스터드 크기를 3D 공간에 설정합니다.

SizeOffset

병렬 읽기

크기 상대 단위의 2D 오프셋으로, 앵커 포인트처럼 작동합니다.이는 GuiObject.AnchorPoint 속성과 비슷하게 사용할 수 있지만 값이 다릅니다.


<tbody>
<tr>
<td><code>0, 0</code></td>
<td>UI가 중앙에 고정되는 기본값.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>UI는 왼쪽 하단에 고정됩니다.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>UI는 왼쪽 상단에 고정됩니다.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>UI는 오른쪽 상단에 고정됩니다.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>UI는 오른쪽 하단에 고정됩니다.</td>
</tr>
</tbody>
크기 오프셋설명

또한 참조하십시오 StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 그리고 ExtentsOffsetWorldSpace 는 3D 공간에서 작동하는 오프셋 속성입니다.

StudsOffset

병렬 읽기

이 속성은 스터드에서 가 어떻게 오프셋되는지 결정하며, 이는 방향과 관련이 있습니다.

또한 오프셋 방향이 전체 글로벌 축에 대한 상대적인 것이 아닌 점을 제외하고 유사한 작동 방식의 StudsOffsetWorldSpace도 참조하십시오.

StudsOffsetWorldSpace

병렬 읽기

이 속성은 글로벌 축에 대해 BillboardGui에서 오프셋되는 방법을 결정하며, 관련 스터드에 대해 Adornee입니다.

또한 참조하십시오 StudsOffset 오프셋 방향이 Camera에 대해 상대적인 것을 제외하고 비슷하게 작동합니다.

메서드

이벤트