ViewportFrame은 카메라를 사용하여 3D 객체를 2D 뷰포트에 렌더링합니다. 이상적인 사용 사례는 다음과 같습니다:
- 사용자 화면 모서리에 직접 표시되는 경험의 미니맵.
- 인벤토리 메뉴의 항목에 대한 3D 모델.
- 캐릭터가 장착한 회전하는 객체.
뷰포트 구성
사용자가 ViewportFrame을 통해 보는 3D 객체는 카메라와 함께 이동하거나 고정되거나 ViewportFrame 내에서 회전할 수 있습니다. 이 객체는 반사를 위한 큐브맵으로 Sky 자식 요소를 포함할 수도 있습니다.
3D 객체가 카메라와 함께 움직이게 하려면:
보기 프레임 내에서 보고자 하는 객체가 보이도록 경험 내에서 카메라 뷰를 배치합니다.
화면에 새 ViewportFrame을 추가하고 Explorer에서 선택되었는지 확인합니다.
속성 창에서 CurrentCamera 속성을 카메라로 할당합니다:
- CurrentCamera 속성을 선택합니다. 커서가 변경됩니다.
- Explorer 창에서 최상위 Camera 객체를 클릭합니다.
원하는 3D 객체를 새 ViewportFrame에 부모로 설정합니다. 만약 경험 내에서 해당 객체를 계속 보고 싶다면, Workspace에서 복제한 후, 복제한 객체를 ViewportFrame에 부모로 설정해야 합니다.
카메라를 이동시키면, 객체도 ViewportFrame 내에서 함께 이동하게 됩니다.
ViewportFrame의 뷰를 업데이트하려면, 뷰 내의 객체가 아니라 카메라를 업데이트해야 합니다.
조명 및 외관
ViewportFrame 내의 조명은 세 가지 속성을 통해 제어됩니다:
| 속성 | 설명 |
|---|---|
| Ambient | 뷰포트 프레임 내에 적용되는 전체 조명 색조를 결정합니다. 기본값은 Color3.fromRGB(200, 200, 200) (유령 회색)입니다. |
| LightDirection | 위치 (0, 0, 0)에서 빛의 방향을 나타내는 Vector3입니다. 기본값은 (-1, -1, -1)입니다. |
| LightColor | 방향광의 색상입니다. 기본값은 Color3.fromRGB(140, 140, 140) (은색)입니다. |
또한, 다음 속성을 통해 뷰포트의 전체 렌더링 외관을 조정할 수 있습니다:
| 속성 | 설명 |
|---|---|
| ImageColor3 | 렌더링된 객체의 수정을 하지 않고 이미지 색상/틴트를 변경합니다. 기본 색상화 값은 Color3.new(1, 1, 1) (흰색)으로, 이 경우 색상 수정이 발생하지 않습니다. |
| ImageTransparency | 렌더링된 객체의 수정을 하지 않고 이미지 투명도를 변경합니다. 0 (기본값)은 완전히 불투명하고 1은 완전히 투명합니다 (보이지 않음). |