Model

Đặt cấp độ chi tiết trên mô hình cho trải nghiệm với streaming hỗ trợ.

Khi đặt vào StreamingMesh, một màn hình "imposter" độ phân giải thấp (màu, mạng lưới thô thiết kế nhằm xung quanh tất cả các bộ phận con của mô hình) hiện thị bên ngoài vùng phát sóng.

Khi đặt để Disabled hoặc Automatic, thì các mạng lưới độ phân giải thấp sẽ không được hiển thị.

Điều khiển cách Models được phát sóng vào và ra khi phát sóng được bật. Hành vi phụ thuộc vào danh mục đã chọn. Không có hiệu lực khi phát sóng không được bật.

Điều này chỉ nên được thay đổi trong Studio qua cửa sổ Thông tin hữu dụng khi phát sóng được bật, hoặc ở Scripts , nhưng không bao giờ ở LocalScripts (điều này có thể dẫn đến hành vi không rõ định).

Chỉ mang đến phần chính của Model . Phần chính là BasePart , mà hoạt động như một tham chiếu vật lý cho trục của mô hình. Đó là, khi các bộ phận trong mô hình được di chuyển do simulazione hoặc các phương tiện khác, trục sẽ di

Lưu ý rằng Models không có PrimaryPart được cài đặt mặc định. Nếu bạn đang tạo một mô hình cần phải được hành động bởi vật lý, bạn nên thiết lập thuộc tính này trong

Lưu ý cũng rằng khi cài đặt thuộc tính này, nó phải là một BasePart đang là con cháu c

Quy tắc chung cho các mô hình là:

• Các mô hình có các bộ phận được kết hợp với nhau bằng các mối hàn vật lý như WeldConstraints hoặc Motor6Ds nên có một phần chính được giao. Ví dụ
• Các mô hình tĩnh (thường là Anchored ) mà ở một nơi nào đó trừ khi một script chuyển đến nó một cách rõ ràng không cần thiết phải có một Model.PrimaryPart và thường không bị hưởng lợi từ việc có một cài đặt.

-- Create a dice model with two halves and attach them together
local diceModel = Instance.new("Model")
diceModel.Name = "ChanceCube"

local diceTop = Instance.new("Part")
diceTop.Size = Vector3.new(4, 2, 4)
diceTop.Position = Vector3.new(0, 1, 0)
diceTop.Color = Color3.new(0, 0, 1)
diceTop.Parent = diceModel

local diceBottom = diceTop:Clone()
diceBottom.Position = Vector3.new(0, -1, 0)
diceBottom.Color = Color3.new(1, 0, 0)
diceBottom.Parent = diceModel

local weld = Instance.new("WeldConstraint")
weld.Part0 = diceTop
weld.Part1 = diceBottom
weld.Parent = diceModel

-- Put the dice up in the air above the workspace origin (does not require a primary part)
diceModel.Parent = workspace
diceModel:PivotTo(CFrame.new(0, 10, 0))

-- Assign the primary part before physical simulation
-- Without this line, the script will always output the same thing and the bounding box of the model will not change orientation
diceModel.PrimaryPart = diceTop

-- Wait a bit before rolling the dice (let it settle onto the floor)
for i = 5, 1, -1 do
	print("Rolling dice in...", i)
	task.wait(1)
end

diceTop:ApplyAngularImpulse(Vector3.new(15000, 1000, 5000))
diceTop:ApplyImpulse(Vector3.new(0, 3000, 0))
task.wait(1)

-- Wait for the roll to complete
while diceTop.AssemblyLinearVelocity.Magnitude > 0.1 or diceTop.AssemblyAngularVelocity.Magnitude > 0.1 do
	task.wait()
end

-- Get the dice orientation, impacted by the primary part
local orientation = diceModel:GetBoundingBox()
if orientation.YVector.Y > 0.5 then
	print("It's the boy!")
else
	print("It's his mother!")
end

Đặt thuộc tính này vào các cấu hình trong các cấu hình sẽ thiết lập mô hình như thể Model/ScaleTo đã được gọi trên nó, thiết lập tất cả các Instances con cháu trong mô hình để mô hình có thể có mức độ mở rộng tương đương với kích thước nguyên bản của nó.

Đặc tính này chỉ có sẵn trong Studio và sẽ thả một lỗi nếu được sử dụng trong một Script hoặc LocalScript . Model/ScaleTo và 1> Model/GetScale1> nên được sử dụng từ các script.

Điều này xác định vị trí pivot của một Model đó có không có set Model.PrimaryPart

Đối với một Model mới tạo, pivot của nó sẽ được điều trị như là trung tâm của hộp giới hạn của nội dung của nó cho đến khi lần đầu tiên tài sản Model.WorldPivot của nó được cài đ

Phổ biến nhất, di chuyển mô hình với các công cụ Studio, hoặc với các chức năng di chuyển mô hình như PVInstance:PivotTo() và Model:MoveTo() , sẽ thiết lập trụ cầu thế giới và do đó kết thúc hành vi mô hình mới này.

Mục đích của hành vi này là để cho phép mã Lua có được một pivot hợp lý chỉ bằng cách tạo một mô hình mới và phục vụ nó, tránh cần phải thiết lập Model.WorldPivot mỗi lần bạn tạo một mô hình trong mã.

local model = Instance.new("Model")
workspace.BluePart.Parent = model
workspace.RedPart.Parent = model
model.Parent = workspace

print(model:GetPivot())  -- Currently equal to the center of the bounding box containing "BluePart" and "RedPart"

model:PivotTo(CFrame.new(0, 10, 0))  -- This works without needing to explicitly set "model.WorldPivot"

local function resetPivot(model)
	local boundsCFrame = model:GetBoundingBox()
	if model.PrimaryPart then
		model.PrimaryPart.PivotOffset = model.PrimaryPart.CFrame:ToObjectSpace(boundsCFrame)
	else
		model.WorldPivot = boundsCFrame
	end
end

resetPivot(script.Parent)

Tham Số

Lợi Nhuận

Hàm này trả lại một mô tả của một khối lượng mà chứa tất cả các con BasePart trong một

Nếu không có PrimaryPart cho mô hình, hộp giới hạn sẽ được thiết lập theo các trụ cơ giới hạn.

local model = workspace.Model
local part = workspace.Part
local orientation, size = model:GetBoundingBox()

-- Thay đổi kích thước và vị trí của bộ phận bằng cách tương ứng với hộp giới hạn của mô hình
part.Size = size
part.CFrame = orientation

Lợi Nhuận

Điều chỉnh kích thước của hộp giới hạn nhỏ nhất mà chứa tất cả các BaseParts trong Model . Nếu Class.Model

Ghi chú rằng chức năng này chỉ trả về kích thước của chiếc hộp giới hạn nhỏ nhất, và nhà phát triển phải sử dụng phương pháp của riêng họ để có được vị trí của chiếc hộp giới hạn.

Lợi Nhuận

local model = Instance.new("Model")
model.Parent = workspace

local RNG = Random.new()

for _ = 1, 5 do
	local part = Instance.new("Part")
	part.Anchored = true
	part.Size = Vector3.new(RNG:NextNumber(0.05, 5), RNG:NextNumber(0.05, 5), RNG:NextNumber(0.05, 5))
	part.Parent = model
end

print(model:GetExtentsSize())

Khi gọi phương thức này từ một Script , nó sẽ trả lại tất cả các Player đối tượng mà mô hình này bền vững cho. Khi gọi từ một LocalScript, phương thức này chỉ kiểm tra nếu mô hình này bề

Lợi Nhuận

Các mô hình có một yếu tố thước đo liên tục, bắt đầu ở 1 cho các mô hình mới tạo và thay đổi khi mô hình được mở rộng bằng cách gọi Model/ScaleTo . Điều này trả lại yếu tố thước đo liên tục của mô hình hiện tại.

Tham số thước đo hiện tại không ảnh hưởng trực tiếp đến kích thước của Instances dưới mô hình. Nó được sử dụng cho mục đích lập trình và lập trình nội dung để nhớ rằng mô hình đã được thiết lập theo kích thước nguyên bản của nó.

Trong một phiên bản nhất định, mô hình sẽ lưu các thông tin kích thước chính xác của những Instances con cháu sau khi gọi đầu tiên Model/ScaleTo .

Yếu tố thước ảnh hưởng đến hành vi của động cơ một cách: Yếu tố thước của một mô hình sẽ được áp dụng cho các độ lùi dự phòng của animations được chơi trên một AnimationController dưới cùng đó, để các rạch động v

Lợi Nhuận

local CollectionService = game:GetService("CollectionService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Find all the models with the tag we want to replace
local items = CollectionService:GetTagged("Tree")
local newModel = ReplicatedStorage.FancyTreeReplacementModel
for _, item in items do
	-- Make the new item and scale / position it where the old one was
	local newItem = newModel:Clone()
	newItem:ScaleTo(item:GetScale())
	newItem:PivotTo(item:GetPivot())

	-- Add the same tag to the replacement
	CollectionService:AddTag(newItem, "Tree")

	-- Delete the old item and parent the new one
	newItem.Parent = item.Parent
	item:Destroy()
end

Di chuyển PrimaryPart đến vị trí đã được xác định. Nếu một phần chính chưa được xác định, phần chính của mô hình sẽ được sử dụng, nhưng phần chính không định dạng và được khuyến nghị bạn lu

Nếu có bất kỳ rào chắn nào mà mô hình được di chuyển, chẳng hạn như Terrain hoặc các bộ phận BaseParts khác, mô hình sẽ được di chuyển theo chiều dọc cho đến khi không có gì trên

Lưu ý rằng không phải tất cả các lần di chuyển một mô hình với MoveTo() đều được giữ lại. Nên sử dụng TranslateBy() hoặc PVInstance:PivotTo() nếu bạn cần phải giữ lại

Tham Số

Lợi Nhuận

local START_POSITION = Vector3.new(-20, 10, 0)
local END_POSITION = Vector3.new(0, 10, 0)

local model = Instance.new("Model")
model.Parent = workspace

local part1 = Instance.new("Part")
part1.Size = Vector3.new(4, 4, 4)
part1.Position = START_POSITION
part1.Anchored = true
part1.BrickColor = BrickColor.new("Bright yellow")
part1.Parent = model

local part2 = Instance.new("Part")
part2.Size = Vector3.new(2, 2, 2)
part2.Position = START_POSITION + Vector3.new(0, 3, 0)
part2.Anchored = true
part2.BrickColor = BrickColor.new("Bright blue")
part2.Parent = model

model.PrimaryPart = part1
model.Parent = workspace

local obstruction = Instance.new("Part")
obstruction.Name = "Obstruction"
obstruction.Size = Vector3.new(10, 10, 10)
obstruction.Position = Vector3.new(0, 10, 0)
obstruction.Anchored = true
obstruction.BrickColor = BrickColor.new("Bright green")
obstruction.Parent = workspace

task.wait(3)

model:MoveTo(END_POSITION)

Tham Số

Lợi Nhuận

Các mô hình có một yếu tố thước đo duy nhất, bắt đầu ở 1 cho các mô hình mới tạo. Điều này kéo dài mô hình, xung quanh vị trí pivot, so với cách nó sẽ xem một yếu tố thước đo 1. Để làm điều này, nó làm hai điều:

• Điều chỉnh hệ số thước đo hiện tại của mô hình đến giá trị được xác định
• Thay đổi kích thước và định vị lại tất cả các Instances con của nó theo thứ tự

Điều chỉnh vị trí được thực hiện xung quanh vị trí trung tâm.

Tất cả các thuộc tính "geometric" của Instances con cháu sẽ được thiết lập lại. Điều này rõ ràng bao gồm các kích thước của các bộ phận, nhưng đây là một số ví dụ khác của các thuộc tính được thiết lập lại:

• Độ dài của các khớp nối như WeldConstraints và Class.Rope|Ropes
• Tốc độ và lực lý vật lý như Hinge.MaxServoTorque
• Các thuộc tính thị giác như kích thước của các thiết bị phát hạt
• Các thuộc tính khác như Sound.RollOffMinDistance

Tham Số

Lợi Nhuận

Đổi một Model bằng cách đưa ra một Vector3 Offset, giữ gìn hướng của mô hình. Nếu một BasePart hoặc 1> Class.Terrain1> đã tồn tại ở vị trí mới thì

Việc dịch được áp dụng trong không gian thế giới chứ không phải trong không gian mô hình, ngay cả khi các bộ phận của mô hình được xoay theo nhiều hướng khác nhau nó vẫn sẽ di chuyển theo trục tiêu chuẩn.

Tham Số

Lợi Nhuận

local START_POSITION = Vector3.new(-20, 10, 0)
local END_POSITION = Vector3.new(0, 10, 0)

local model = Instance.new("Model")

local part1 = Instance.new("Part")
part1.Size = Vector3.new(4, 4, 4)
part1.CFrame = CFrame.new(START_POSITION) * CFrame.Angles(0, math.rad(45), 0)
part1.Anchored = true
part1.BrickColor = BrickColor.new("Bright yellow")
part1.Parent = model

local part2 = Instance.new("Part")
part2.Size = Vector3.new(2, 2, 2)
part2.CFrame = part1.CFrame * CFrame.new(0, 3, 0)
part2.Anchored = true
part2.BrickColor = BrickColor.new("Bright blue")
part2.Parent = model

model.PrimaryPart = part1
model.Parent = workspace

local obstruction = Instance.new("Part")
obstruction.Name = "Obstruction"
obstruction.Size = Vector3.new(10, 10, 10)
obstruction.Position = Vector3.new(0, 10, 0)
obstruction.Transparency = 0.5
obstruction.Anchored = true
obstruction.BrickColor = BrickColor.new("Bright green")
obstruction.Parent = workspace

task.wait(3)
-- use TranslateBy to shift the model into the obstruction
model:TranslateBy(END_POSITION - START_POSITION)