ViewportFrame
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
ViewportFrame là một GuiObject có thể tạo ra 3D objects bên trong giới hạn của nó, cung cấp một cách để hiển thị 3D objects trong một không gian 2D như một ScreenGui . Đối tượng này có những hạn chế sau:
- Không có bóng tối hoặc hiệu ứng post-Processing .
- Enum.Material.Neon và Enum.Material.Glass材料 được hiển thị với chất lượng thấp nhất.
- Nested GuiObjects are not supported.
- Bởi mặc định, chiếu sáng bên trong một ViewportFrame act as if Lighting.EnvironmentSpecularScale and Lighting.EnvironmentDiffuseScale are both set to 0, so properties that rely on these fields, such as 1> Class.Surface1> , may look different.
Mẫu mã
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()
Tóm Tắt
Thuộc Tính
Độ sáng được ứng dụng cho khu vực trong ViewportFrame .
Camera được sử dụng để tạo những đối tượng con cái.
Xác định cách màu sắc hình ảnh được tạo.
Xác định độ trong suốt của hình ảnh đã tạo.
Màu của ánh sáng phát ra.
Một Vector3 đại diện hướng của nguồn ánh sáng.
Xác định whether this UI element sinks input.
Xác định điểm nguồn của một GuiObject , so với kích thước tương đối của nó.
Xác định xem resize có xảy ra dựa trên nội dung con hay không.
Xác định màu nền GuiObject .
Xác định độ trong suốt của GuiObject hình ảnh và biên giới.
Xác định màu của GuiObject border.
Xác định cách mà GuiObject biên giới được phân bố đối với kích thước của nó.
Xác định chiều rộng pixel của GuiObject biên giới.
Xác định nếu con cháu GuiObjects nằm ngoài giới hạn của một thành phần GUI cha mẹ nên tạo ra.
Xác định apakah chuột của người chơi đang được nhấn chủ động trên GuiObject hay không.
Xác định có thể hay không tương tác với GuiButton , hoặc liệu GuiState của GuiObject đang thay đổi hay không.
Điều khiển thứ tự sắp xếp của GuiObject khi được sử dụng với một UIGridStyleLayout .
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển xuống.
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển sang bên trái.
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển sang phải.
Điều chỉnh GuiObject được chọn khi gamepad selector di chuyển lên trên.
Xác định vị trí pixel và vị trí trục của GuiObject .
Xác định số độ bằng mà GuiObject được quay.
Xác định có thể chọn GUI bằng gamepad.
Làm cho trang trí chọn mặc định của gamepad bị tắt.
Thứ tự của GuiObjects được chọn bởi gamepad UI lựa chọn.
Xác định kích thước pixel và kích thước trục của GuiObject .
Điều chỉnh các trục Size mà GuiObject sẽ dựa trên, so với kích thước của cha mình.
Một tính chất hỗn hợp của BackgroundTransparency và TextTransparency .
Xác định có phải GuiObject và con cháu của nó sẽ được xử lý.
Xác định thứ tự mà một GuiObject tạo gần những người khác.
Mô tả vị trí màn hình thực tế của một thành phần UI, bằng cách đếm các pixel.
Mô tả sự quay màn hình thực tế của một thành phần UI, bằng độ.
Mô tả kích thước màn hình thực tế của một thành phần UI, bằng các pixel.
Khi đặt về true, localization sẽ được áp dụng cho GuiBase2d và những con cháu của nó.
Một tham khảo đến một LocalizationTable để ứng dụng hóa học hóa toàn bộ vào GuiBase2d và các con cháu của nó.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng dưới.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng bên trái.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng phải.
Tùy chỉnh hành vi lựa chọn gamepad trong hướng lên.
Cho phép tùy chỉnh chuyển động của nút gamepad.
Phương Pháp
Phương Pháp kế thừa từ GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Di chuyển một GUI mượt mà đến một new UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Điều chỉnh mượt mà một GUI lên một new Datatype.UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Di chuyển một GUI một cách mượt mà đến kích thước và vị trí mới.
Sự Kiện
Sự Kiện kế thừa từ GuiObjectĐược kích hoạt khi một người bắt đầu tương tác thông qua một thiết bị giao tiếp người-máy (chuột bên dưới, chạm bắt đầu, nút bàn phím xuống, v.v.v).
Bị kích động khi một người thay đổi cách họ tương tác thông qua thiết bị giao tiếp Người-Máy (chuột, bắt đầu, nhấn bàn phím, v.v..).
Đã kết thúc khi một người dừng tương tác thông qua thiết bị Giao tiếp Người-Máy (chuột bên dưới, chạm bắt đầu, nút bàn phím xuống, v.v.);.
Bắt đầu khi người dùng di chuyển chuột vào một thành phần GUI.
Bắt đầu khi người dùng di chuyển chuột khỏi một thành phần GUI.
Bắt lửa mỗi khi một người dịch chuột trong khi nó ở trong một thành phần GUI.
Bắt đầu khi người dùng cuộn chuột chuột của họ trở lại khi chuột đang ở trên một thành phần GUI.
Bắt đầu khi người dùng di chuyển bánh xe chuột của họ khi chuột ở trên một thành phần GUI.
Được kích hoạt khi GuiObject đang được tập trung với GamepadSelector.
Bị kích hoạt khi GamepadSelector ngưng tập trung vào GuiObject.
Lửa khi người chơi bắt đầu, tiếp tục và dừng lại sau khi nhấn mạnh UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Bắt đầu khi người chơi di chuyển ngón tay của họ trên thành phần UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Bắt lửa khi người chơi thực hiện một hành động nhấn hoặc kéo dùng hai ngón tay trên thành phần UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Bắt đầu khi người chơi thực hiện một hành động quay bằng hai ngón tay trên thành phần UI.
Bắt đầu khi người chơi thực hiện một động tác trượt tuyết trên một thành phần UI.
Bắt đầu khi người chơi thực hiện một hành động nhấn chuột trên thành phần UI.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Kích hoạt khi lựa chọn gamepad di chuyển đến, rời đi hoặc thay đổi trong khu vực GuiBase2d hoặc bất kỳ con cháu GuiObjects kế tiếp.
Thuộc Tính
Ambient
Đặc tính này xác định màu chiếu sáng được ứng dụng cho khu vực trong ViewportFrame . Mặc định để Color3.fromRGB(200, 200, 200) (màu trắng bóng).
CurrentCamera
Camera instância được sử dụng để render đối tượng con cái. Mặc định là nil .
Đối tượng Camera không sao chép, vì vậy ViewportFrame.CurrentCamera cũng không sao chép. Khi bạn thiết lập thuộc tính này, Class
ImageColor3
Điều này xác định cách mà hình ảnh được màu, cho phép bạn thay đổi màu hình ảnh mà không cần phải chỉnh sửa trực tiếp hình ảnh. Giá trị colorization mặc định là Color3.new(1, 1, 1) (màu trắng) tại đó không có sự thay đổi màu.
Xem thêm ImageTransparency để xác định độ trong suốt của hình ảnh đã tạo.
ImageTransparency
Điều này xác định độ trong suốt của hình ảnh đang xem, cho phép bạn thay đổi độ trong suốt của hình ảnh mà không cần phải chỉnh sửa trực tiếp hình ảnh. Một giá trị 0 (mặc định) là hoàn toàn bị ẩn và một giá trị 1 là hoàn toàn trong suốt (hiển thị).
Xem thêm ImageColor3 để xác định cách mà một hình ảnh được thiết lập màu sắc.
LightDirection
Một Vector3 đại diện hướng của nguồn ánh sáng từ vị trí Vector3.new(0, 0, 0) . Mặc định đến Vector3.new(-1, -1, -1) .