ViewportFrame
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
は、境界内の 3D オブジェクトをレンダリングし、3D オブジェクトを 2D 空間に表示する方法を提供する です。このオブジェクトには次の注意事項があります：
シャドウや ポストプロセッシング 効果はレンダリングされません。
Enum.Material.Neon と Enum.Material.Glass のマテリアルは最低品質でレンダリングされます。
ネストされた GuiObjects はサポートされていません。
デフォルトでは、ViewportFrame 内の照明は、Lighting.EnvironmentSpecularScale と Lighting.EnvironmentDiffuseScale が両方とも 0 に設定されているかのように機能し、これらのフィールドに依存するプロパティ、例えば SurfaceAppearance.MetalnessMap は、異なる外観になる可能性があります。
このオブジェクトは、Sky 子を反射のキューブマップとして使用でき、その場合、Sky オブジェクトの 6つのSkybox[…] プロパティのみが使用されます。これらのプロパティが有効であると仮定して、ViewportFrame 内の照明は、Lighting.EnvironmentSpecularScale と Lighting.EnvironmentDiffuseScale の両方が 1 に設定されている場合と同様に行動します。詳細は、ここを参照してください。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
local viewportFrame = Instance.new("ViewportFrame")
viewportFrame.Size = UDim2.new(0.3, 0, 0.4, 0)
viewportFrame.Position = UDim2.new(0, 15, 0, 15)
viewportFrame.BackgroundColor3 = Color3.new(0, 0, 0)
viewportFrame.BorderColor3 = Color3.new(0.6, 0.5, 0.4)
viewportFrame.BorderSizePixel = 2
viewportFrame.BackgroundTransparency = 0.25
viewportFrame.Parent = screenGui
local part = Instance.new("Part")
part.Material = Enum.Material.Concrete
part.Color = Color3.new(0.25, 0.75, 1)
part.Position = Vector3.new(0, 0, 0)
part.Parent = viewportFrame
local viewportCamera = Instance.new("Camera")
viewportFrame.CurrentCamera = viewportCamera
viewportCamera.Parent = viewportFrame
viewportCamera.CFrame = CFrame.new(Vector3.new(0, 2, 12), part.Position)local Players = game:GetService("Players")
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
local TweenService = game:GetService("TweenService")
local viewportFrame = Instance.new("ViewportFrame")
viewportFrame.Size = UDim2.new(0.3, 0, 0.4, 0)
viewportFrame.Position = UDim2.new(0, 15, 0, 15)
viewportFrame.BackgroundColor3 = Color3.new(0, 0, 0)
viewportFrame.BorderColor3 = Color3.new(0.6, 0.5, 0.4)
viewportFrame.BorderSizePixel = 2
viewportFrame.BackgroundTransparency = 0.25
viewportFrame.Parent = screenGui
local part = Instance.new("Part")
part.Material = Enum.Material.Concrete
part.Color = Color3.new(0.25, 0.75, 1)
part.Position = Vector3.new(0, 0, 0)
part.Parent = viewportFrame
local viewportCamera = Instance.new("Camera")
viewportFrame.CurrentCamera = viewportCamera
viewportCamera.Parent = viewportFrame
viewportCamera.CFrame = CFrame.new(Vector3.new(0, 2, 12), part.Position)
task.wait(2)
local cameraGoal = {
CFrame = CFrame.new(Vector3.new(0, 6, 4), part.Position),
}
local tweenInfo = TweenInfo.new(2, Enum.EasingStyle.Quad, Enum.EasingDirection.Out)
local tween = TweenService:Create(viewportCamera, tweenInfo, cameraGoal)
tween:Play()概要
プロパティ
領域内の ViewportFrame に適用される照明色。
Camera 子オブジェクトをレンダリングするのに使用されるもの。
レンダリングされたビューポート画像の色付け方を決定します。
レンダリングされたビューポート画像の透明度を決定します。
放出された光の色。
A Vector3 光ソースの方向を表す。
このUI 要素が入力を受け取るかどうかを決定します。
絶対サイズに対して、GuiObject の起源ポイントを決定します。
子コンテンツに基づいてサイズ変更が発生するかどうかを決定します。
背景色を GuiObject 決定します。
GuiObject 背景とボーダーの透明度を決定します。
GuiObject ボーダーの色を決定します。
GuiObject ボーダーがどのように配置されるかを決定し、そのサイズに対して。
GuiObject ボーダーのピクセル幅を決定します。
親の GUI 要素の境界内で描画するかどうか、子孫 GuiObjects が決定します。
プレイヤーのマウスが GuiObject にアクティブに押されているかどうかを決定します。
GuiButton が相互作用できるかどうか、または GuiState の GuiObject が変更されているかどうかを決定します。
GuiObject を使用すると、ソート順序が制御されます。UIGridStyleLayout と一緒に使用すると、ソート順序が制御されます。
ゲームパッドセレクターが下向きに移動されると、選択される GuiObject を設定します。
ゲームパッドセレクターが左に移動されると選択される GuiObject を設定します。
ゲームパッドセレクターが右に移動されると選択される GuiObject を設定します。
ゲームパッドセレクターが上に移動したときに選択される GuiObject を設定します。
GuiObject のピクセルとスカラー位置を決定します。
GuiObject が回転する度数の数を決定します。
ゲームパッドで GuiObject が選択できるかどうかを決定します。
ゲームパッド用のデフォルトの選択装飾をオーバーライドします。
ゲームパッド UI の選択によって選択された GuiObjects の順序。
GuiObject のピクセルとスカラーサイズを決定します。
BackgroundTransparency と TextTransparency の混合プロパティ。
GuiObject とその子孫がレンダリングされるかどうかを決定します。
GuiObject が他のものに対してレンダリングされる順序を決定します。
ピクセルで、GuiBase2d 要素の実際の画面位置を説明します。
GuiBase2d 要素の実際のスクリーン回転を度数で説明します。
ピクセルで、GuiBase2d 要素の実際の画面サイズを説明します。
true に設定すると、ローカライゼーションがこの GuiBase2d とその子孫に適用されます。
この LocalizationTable とその子孫に自動翻訳を適用するために使用する GuiBase2d の参照。
下方向のゲームパッド選択動作をカスタマイズします。
左方向でゲームパッドの選択動作をカスタマイズします。
右向きにゲームパッドの選択動作をカスタマイズします。
上向きのゲームパッド選択動作をカスタマイズします。
ゲームパッドの選択動作をカスタマイズできます。
方法
GuiObject から継承した 方法- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
スムーズにGUIを新しい UDim2 に移動します。
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
GUIを新しいサイズと位置にスムーズに移動します。
イベント
GuiObject から継承した イベントユーザーが人間-コンピューターインターフェイス装置 (マウスボタンダウン、タッチ開始、キーボードボタンダウンなど) を介して交流を開始するときに発射されます。
ユーザーが人間-コンピューターインターフェイスデバイス (マウスボタンダウン、タッチ開始、キーボードボタンダウンなど) を介して対話する方法を変更したときに発射されます。
ユーザーが人間-コンピューターインターフェイス装置 (マウスボタンダウン、タッチ開始、キーボードボタンダウンなど) を介して交流を停止すると発射されます。
ユーザーがマウスをGUI 要素に移動させると発火します。
ユーザーがGUI 要素からマウスを移動すると発火します。
GUI 要素内にいる間、ユーザーがマウスを移動するたびに発火します。
ユーザーがマウスホイールを戻すときに、マウスがGUI 要素の上にあるときに発火します。
ユーザーがマウスホイールを前方にスクロールすると、マウスがGUI 要素の上にあるときに発火します。
ゲームパッドセレクターで GuiObject が焦点合致されているときに発火します。
ゲームパッドセレクターが GuiObject に焦点を合わせるのをやめたときに発火します。
プレイヤーが開始し、続行し、UI 要素を長押しし続けると、発火します。
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
プレイヤーがUI 要素に指を動かすと発火します。
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
UI 要素の 2 本の指を使用してピンチや引っ張りジェスチャーを実行すると、発火します。
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
UI 要素の 2 本の指を使用して回転ジェスチャーを実行すると、プレイヤーが炎上します。
プレイヤーがUI 要素にスワイプジェスチャーを実行すると発火します。
プレイヤーがUI 要素にタップジェスチャーを実行すると発火します。
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ゲームパッドの選択が移動し、離れ、または接続された またはその子孫の中で変更されると、炎が発生します。
プロパティ
CurrentCamera
Camera 子オブジェクトをレンダリングするために使用されるインスタンス。デフォルトは nil 。
Camera オブジェクトは複製しないので、ViewportFrame.CurrentCamera も複製しません。このプロパティを設定すると、Camera.CFrame と Camera.FieldOfView が保存され、内部で ViewportFrame で再複製されるため、クライアントは Camera オブジェクトなしでフレームをレンダリングできます。
ImageColor3
このプロパティは、レンダリングされたビューポート画像の色を決定し、レンダリングオブジェクトを直接変更せずに色を変更できます。デフォルトの色化値は
レンダリングされた画像の透明度を決定する ImageTransparency も参照してください。
ImageTransparency
このプロパティは、レンダリングされたビューポート画像の透明度を決定し、レンダリングオブジェクトを直接変更せずに透明度を変更できます。値 0 （デフォルト）は完全に不透明で、値 1 は完全に透明 (見えない)です。
また、レンダリングされた画像の色付け方を決定する ImageColor3 も参照してください。