Model

Ustawia poziom szczegółowości na modelu dla doświadczeń z instancją streamingową włączoną.

Gdy ustawiono na StreamingMesh , niższa rozdzielczość siatki "impostera" (kolorowa, gruba siatka, która owija wszystkie części dziecka modelu) renderuje się poza zasięgiem strumienia.

Gdy ustawiono na Disabled lub Automatic, niższa rozdzielczość siatek nie będzie wyświetlana.

Kontroluje, w jaki sposób Models są przesyłane i odbierane, gdy włączono transmisję instancji streamingowej.Zachowanie zależy od wybranego enum.Nie ma wpływu, gdy transmisja nie jest włączona.

Właściwość ta powinna być zmieniana w Studio za pośrednictwem okna Właściwości tylko w przypadku włączenia transmisji, lub w Scripts , ale nigdy w LocalScripts (czyniąc tak można doprowadzić do niedefiniowanego zachowania).

Wskazuje na główną część Model .Główną częścią jest BasePart, która działa jako odniesienie fizyczne dla osi obrotu modelu.Oznacza to, że kiedy części w modelu są przenoszone z powodu symulacji fizycznej lub innych środków, osie będą się poruszać w zgodzie z główną częścią.

Zauważ, że Models nie ma domyślnie ustawionego PrimaryPart .Jeśli tworzysz model, który musi być działany przez fizykę, powinieneś ręcznie ustawić tę właściwość w Studio lub w skrypcie.Jeśli część główna jest nie ustawiać, pivot pozostanie w tym samym miejscu w przestrzeni świata, nawet jeśli części w modelu zostaną przeniesione.

Zauważ też, że podczas ustawiania tej właściwości musi to być BasePart że jest potomkiem modelu.Jeśli próbujesz ustawić na , które jest nie potomkiem modelu, zostanie ustawione do tej części, ale zostanie zresetowane podczas następnego kroku symulacji — jest to starsze zachowanie wspierające skrypty, które domniemają, że mogą tymczasowo ustawić główną część na , która nie jest potomkiem modelu.

Ogólną zasadą dla modeli jest to:

• Modele, których części są połączone za pomocą fizycznych połączeń, takich jak WeldConstraints lub Motor6Ds, powinny mieć przypisany główny element.Na przykład modele postaci Roblox mają domyślnie ustawione Model.PrimaryPart do HumanoidRootPart .
• Statyczne (zwykle Anchored ) modele, które pozostają w jednym miejscu, chyba że skrypt wyraźnie je przeniesie, nie wymagają Model.PrimaryPart i nie mają tendencji do korzystania z jednego ustawiać.

-- 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

Ustawienie tej właściwości w oknie właściwości rozmiaru zmniejszy model tak, jakby Model/ScaleTo został wezwany na nim, skalując wszystkie potomne instancje w modelu tak, aby model miał określony czynnik skali względem swojego pierwotnego rozmiaru.

Właściwość ta jest dostępna tylko w Studio i wyświetli błąd, jeśli zostanie użyta w Script lub LocalScript.Model/ScaleTo i Model/GetScale powinny być używane z skryptów.

Właściwość ta określa, gdzie znajduje się osień , który nie ma ustawionego nie zestawu .Jeśli ma , punkt obrotowy tej podstawowej części jest równy punktowi obrotowemu tej podstawowej części zamiast tego, a ta właściwość jest ignorowana.

Dla nowo utworzonego Model jego osi będzie traktowany jako centrum pudełka zakresu jego zawartości, dopóki po raz pierwszy nie zostanie ustawiaćjego właściwość Model.WorldPivot.Gdy światowy pivot zostanie ustawiony po raz pierwszy, nie można przywrócić tego początkowego zachowania.

Najczęściej przenoszenie modelu za pomocą narzędzi Studio lub za pomocą funkcji przenoszenia modelu, takich jak PVInstance:PivotTo() i Model:MoveTo(), ustawi pivot świata i zakończy tym nowe zachowanie modelu.

Celem tego zachowania jest umożliwienie kodowi Luau uzyskania rozsądnego pivotu po prostu poprzez utworzenie nowego modelu i przypisanie mu obiektów, unikając potrzeby wyraźnego ustawienia każdym razem, gdy tworzysz model w kodzie.

local Workspace = game:GetService("Workspace")

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)

Parametry

Zwroty

Funkcja ta zwraca opis woluminu, który zawiera wszystkie BasePart dzieci wewnątrz Model .Orientacja głośności opiera się na orientacji PrimaryPart i pasuje do pola wyboru renderowanego w Studio, gdy model jest wybrany.Odbijając zachowanie Terrain:FillBlock(), zwraca CFrame reprezentujące centrum tej ramki i Vector3 reprezentujące jej rozmiar.

Jeśli nie ma PrimaryPart dla modelu, pudełko granicowe zostanie wyśrodkowane w osiach świata.

local Workspace = game:GetService("Workspace")

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

-- Zmień rozmiar i pozycję części równej obudowie pudełka modelu
part.Size = size
part.CFrame = orientation

Zwroty

Zwraca rozmiar najmniejszego pudełka ograniczającego, które zawiera całe BaseParts w Model.Jeśli Model.PrimaryPart istnieje, to pudełko graniczne zostanie wyśrodkowane w tej części.Jeśli część główna nie została ustawiona, funkcja wybierze część w modelu, do której dostosuje pudełko granicowe.Ponieważ wybór tej części nie jest deterministyczny, zaleca się ustawienie Model.PrimaryPart, aby uzyskać spójne wyniki z tą funkcją.

Zauważ, że ta funkcja zwraca tylko rozmiar najmniejszego pudełka granicznego, a programista musi wykorzystać własną metodę, aby uzyskać pozycję pudełka granicznego.

Zwroty

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())

Gdy ta metoda jest wywoływana z Script, zwraca wszystkie obiekty Player, które są trwałe dla tego modelu.Gdy jest wezwany z LocalScript, ta metoda sprawdza tylko, czy ten model jest trwały dla LocalPlayer.

Zwroty

Modele zawierają trwały skalarny czynnik skali, który zaczyna się od 1 dla nowo utworzonych modeli i zmienia się, gdy model jest skalowany za pomocą wezwania Model/ScaleTo.Funkcja ta zwraca obecny skalarny czynnik skali modelu.

Obecny czynnik skali nie ma bezpośredniego wpływu na rozmiar instancji w ramach modelu bezpośrednio.Służy do celów pisania treści i skryptowania, aby zapamiętać, jak model został skalowany w stosunku do jego pierwotnego rozmiaru.

W ramach danej sesjamodel zapamięta dokładne informacje o pierwotnym rozmiarze odpowiednich Instancji potomnych po pierwszym wezwaniu Model/ScaleTo.Oznacza to, że wezwanie ScaleTo(x) połączone z ScaleTo(1) otrzyma cię powrót dokładnie oryginalnej konfiguracji modelu bez przepięć punktów zmienionych.Unikanie drgań punktów zwrotnych jest motywem posiadania funkcji Skala Do zamiast funkcji Skala Przez .

Czynnik skali wpływa na zachowanie silnika w jeden sposób: czynnik skali modelu zostanie zastosowany do wspólnych odległości odtwarzanych na podstawie tego modelu, tak aby animowane rygły prawidłowo odtwarzały animacje nawet po skalowaniu.

Zwroty

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

Przesuwa PrimaryPart do danej pozycji.Jeśli nie zaznaczono głównej części, zostanie użyta część korzenna modelu, ale część korzenna nie jest deterministyczna i zaleca się, aby zawsze ustawiać główną część przy użyciu MoveTo().

Jeśli wystąpią jakiekolwiek przeszkody, w których model ma być przeniesiony, takie jak Terrain lub inne BaseParts, model zostanie przesunięty w górę wzdłuż osi pionowej, dopóki nie będzie nic na drodze.Jeśli zachowanie to nie jest pożądane, należy zamiast tego użyć PVInstance:PivotTo().

Zauważ, że rotacja nie jest zachowana przy przesuwaniu modelu za pomocą MoveTo().Zaleca się użycie TranslateBy() lub PVInstance:PivotTo(), jeśli obecna rotacja modelu musi zostać zachowana.

Parametry

Zwroty

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)

Parametry

Zwroty

Modele zawierają trwały skalarny czynnik skali, który zaczyna się od 1 dla nowo utworzonych modeli.Funkcja ta skaluje model, wokół położenia pivotowego, w stosunku do tego, jak wyglądałby przy skali wynoszącej 1.Aby to osiągnąć, robi dwie rzeczy:

• Ustawia obecny czynnik skali modelu na określoną wartość
• Zmienia rozmiary i przesuwa wszystkie potomne instancje odpowiednio

Skalowanie lokalizacji odbywa się wokół lokalizacji pivotowej.

Wszystkie " geometryczne " właściwości potomnych instancji zostaną skalowane.Obejmuje to oczywiście rozmiary części, ale oto kilka innych przykładów właściwości, które są skalowane:

• Długość stawów takich jak WeldConstraints i Class.Rope|Ropes
• Fizyczne prędkości i siły, takie jak Hinge.MaxServoTorque
• Wizualne właściwości, takie jak rozmiary emitentów cząstek
• Inne właściwości długości, takie jak Sound.RollOffMinDistance

Parametry

Zwroty

Przesuwa Model przez podany odległość Vector3, zachowując orientację modelu.Jeśli istnieje już inny BasePart lub Terrain w nowej pozycji, wtedy Model pokryje powiedziany obiekt.

Tłumaczenie jest stosowane w przestrzeni świata, a nie w przestrzeni obiektów, co oznacza, że nawet jeśli części modelu są skierowane w różny sposób, nadal będą się poruszać wzdłuż standardowego osi.

Parametry

Zwroty

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)