ViewportFrame は、カメラを使用して3Dオブジェクトを2Dビューポートにレンダリングします。理想的な使用例には以下が含まれます:
- ユーザーの画面の隅に直接表示される体験のミニマップ。
- インベントリメニュー内のアイテムの3Dモデル。
- キャラクターが装備している回転するオブジェクト。
ビューポートの設定
ユーザーが ViewportFrame を介して見る3Dオブジェクトは、カメラと一緒に移動、静止、または ViewportFrame 内で回転させることができます。このオブジェクトには反射用のキューブマップとして Sky 子オブジェクトを含めることもできます。
3Dオブジェクトをカメラと一緒に移動させたい場合:
ビューポートフレーム内で見るオブジェクトが見えるように、体験内にカメラの視点を配置します。
新しい ViewportFrame を 画面 に追加し、Explorer で選択されていることを確認します。
Properties ウィンドウで、CurrentCamera プロパティにカメラを割り当てます:
- CurrentCamera プロパティを選択します。カーソルが変更されます。
- Explorer ウィンドウで、最上位の Camera オブジェクトをクリックします。
新しい ViewportFrame に望ましい3Dオブジェクトを親にします。体験内でオブジェクトをまだ表示したい場合、Workspace でオブジェクトを複製し、複製したオブジェクトを ViewportFrame に親にする必要があります。
カメラを移動させると、オブジェクトも ViewportFrame 内で移動します。
ライティングと外観
ViewportFrame 内のライティングは、次の3つのプロパティによって制御されます:
| プロパティ | 説明 |
|---|---|
| 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 は完全に透明(見えない)です。 |