ViewportFrame

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

는 경계 내에서 3D 개체를 렌더링하고, 2D 공간에서 3D 개체를 표시하는 방법을 제공하는 입니다.이 개체에는 다음과 같은 제한 사항이 있습니다:

  • 그림자나 후처리 효과가 렌더링되지 않습니다.

  • Enum.Material.Neon 및 Enum.Material.Glass 재료는 가장 낮은 품질로 렌더링됩니다.

  • 중첩된 GuiObjects 는 지원되지 않습니다.

  • 기본적으로 내부 조명 은 마치 와 가 둘 다 설정되어 있는 것처럼 작동하므로, 이러한 필드에 의존하는 속성, 예를 들어 은 다르게 보일 수 있습니다.

  • 이 개체는 자식을 반사의 큐브맵으로 사용할 수 있으며, 이 경우에는 오직 개체의 여섯 가지 속성만 사용됩니다.이러한 속성이 유효하다고 가정하면, ViewportFrame 내의 조명은 Lighting.EnvironmentSpecularScale 및 Lighting.EnvironmentDiffuseScale 모두가 1으로 설정된 경우와 유사하게 작동합니다.자세한 내용은 여기에 참조하십시오.

코드 샘플

ViewportFrame - Create GUI
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)
ViewportFrame - Control Camera
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()

요약

속성

속성가 GuiObject에서 상속되었습니다속성가 GuiBase2d에서 상속되었습니다
Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

메서드

메서드가 GuiObject에서 상속되었습니다
Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

이벤트

이벤트가 GuiObject에서 상속되었습니다이벤트가 GuiBase2d에서 상속되었습니다
Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

속성

Ambient

Color3
병렬 읽기

이 속성은 ViewportFrame 내의 영역에 적용된 조명 색상을 결정합니다. 기본값은 Color3.fromRGB(200, 200, 200) (유령 회색).

CurrentCamera

Camera
복제되지 않음
병렬 읽기

Camera 자식 개체를 렌더링하는 데 사용되는 인스턴스. 기본값은 nil 입니다.

Camera 개체는 복제하지 않으므로 ViewportFrame.CurrentCamera도 복제하지 않습니다.이 속성을 설정하면 Camera.CFrame 및 Camera.FieldOfView 가 저장되고 내부적으로 ViewportFrame 로 복제되어 클라이언트가 프레임을 렌더링하지만 개체 Camera 없이 할 수 있습니다.

ImageColor3

Color3
병렬 읽기

이 속성은 렌더링된 뷰포트 이미지가 어떻게 색상이 지정되는지 결정하여 렌더링된 개체를 직접 수정하지 않고도 색상을 변경할 수 있습니다.기본 색상화 값은 Color3.new(1, 1, 1) (흰색)에서 색상 변경이 발생하지 않습니다.

또한 렌더링된 이미지의 투명도를 결정하는 ImageTransparency도 참조하십시오.

ImageTransparency

number
병렬 읽기

이 속성은 렌더링된 뷰포트 이미지의 투명도를 결정하여 렌더링된 개체를 직접 수정하지 않고도 투명도를 변경할 수 있습니다.기본값인 0 값은 완전히 불투명하고 1 값은 완전히 투명합니다(투명하지 않음).

또한 렌더링된 이미지가 어떻게 색상화될지 결정하는 ImageColor3도 참조하십시오.

LightColor

Color3
병렬 읽기

방출되는 빛의 색. 기본값은 Color3.fromRGB(140, 140, 140) (은색).

LightDirection

Vector3
병렬 읽기

위치 Vector3 에서 조명 소스 방향을 나타내는 A 입니다. 기본값은 입니다.

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

메서드

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

이벤트

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기