ViewportFrame은 카메라를 사용하여 3D 객체를 2D 뷰포트에 렌더링합니다. 이상적인 사용 사례는 다음과 같습니다:
- 사용자의 화면 모서리에 직접 표시되는 게임의 미니맵.
- 인벤토리 메뉴의 아이템 3D 모델.
- 캐릭터가 장착한 회전하는 객체.
뷰포트 구성
사용자가 ViewportFrame을 통해 보는 3D 객체는 카메라와 함께 이동하거나 정적 상태를 유지하거나 ViewportFrame 내에서 회전할 수 있습니다. 이 객체는 반사를 위한 큐브맵으로 Sky 자식을 포함할 수도 있습니다.
3D 객체가 카메라와 함께 이동하도록 하려면:
게임 내에서 카메라 뷰를 배치하여 프레임 내에서 보고 싶은 객체가 보이도록 합니다.
화면에 새로운 ViewportFrame을 추가하고 Explorer에서 선택되었는지 확인합니다.
Properties 창에서 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은 완전히 투명합니다 (보이지 않음). |