Keyframe | Dokumentacja – Centrum twórców Roblox

Klasa silnika

Keyframe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Podsumowanie

Właściwości

Time:number

Metody

AddMarker(marker: Instance):()

AddPose(pose: Instance):()

GetMarkers():{KeyframeMarker}

GetPoses():{Pose}

RemoveMarker(marker: Instance):()

RemovePose(pose: Instance):()

Członkowie odziedziczeni

57 odziedziczonych od: Instance

6 odziedziczonych od: Object

Przykłady kodu

Generowanie pozy kluczowych

local function generateKeyframe(model)
	if not model.PrimaryPart then
		warn("Brak ustawionej części głównej")
		return
	end

	local rootPart = model.PrimaryPart:GetRootPart()

	if not rootPart then
		warn("Nie znaleziono części root")
		return
	end

	local partsAdded = {}
	partsAdded[rootPart] = true

	local function addPoses(part, parentPose)
		-- pobierz wszystkie stawy dołączone do części
		for _, joint in pairs(part:GetJoints()) do
			-- interesują nas tylko Motor6D
			if joint:IsA("Motor6D") then
				-- znajdź dołączoną część
				local connectedPart = nil
				if joint.Part0 == part then
					connectedPart = joint.Part1
				elseif joint.Part1 == part then
					connectedPart = joint.Part0
				end
				if connectedPart then
					-- upewnij się, że nie dodaliśmy już tej części
					if not partsAdded[connectedPart] then
						partsAdded[connectedPart] = true
						-- stwórz pozę
						local pose = Instance.new("Pose")
						pose.Name = connectedPart.Name
						parentPose:AddSubPose(pose)
						-- rekurencja
						addPoses(connectedPart, pose)
					end
				end
			end
		end
	end

	local keyframe = Instance.new("Keyframe")

	-- uzupełnij klatkę kluczową
	local rootPose = Instance.new("Pose")
	rootPose.Name = rootPart.Name
	addPoses(rootPart, rootPose)
	keyframe:AddPose(rootPose)

	return keyframe
end

local character = script.Parent

local keyframe = generateKeyframe(character)

print(keyframe)

Materiały referencyjne dotyczące interfejsów API

Właściwości

Time

Odczyt równoległy

Możliwości: Animation

Keyframe.Time:number

Przykłady kodu

Uzyskaj długość KeyframeSequence

local function getSequenceLength(keyframeSequence)
	local length = 0
	for _, keyframe in pairs(keyframeSequence:GetKeyframes()) do
		if keyframe.Time > length then
			length = keyframe.Time
		end
	end
	return length
end

local keyframeSequence = Instance.new("KeyframeSequence")

getSequenceLength(keyframeSequence)

Metody

AddMarker

Możliwości: Animation

Keyframe:AddMarker(marker:Instance):()

Parametry

marker:Instance

Zwroty

()

Przykłady kodu

Dodaj znacznik/Usuń znacznik

local keyframe = Instance.new("Keyframe")
keyframe.Parent = workspace

local marker = Instance.new("KeyframeMarker")
marker.Name = "FootStep"
marker.Value = 100

keyframe:AddMarker(marker) --marker.Parent = keyframe

task.wait(2)

keyframe:RemoveMarker(marker) --marker.Parent = nil

AddPose

Możliwości: Animation

Keyframe:AddPose(pose:Instance):()

Parametry

pose:Instance

Zwroty

()

Przykłady kodu

Generowanie pozy kluczowych

local function generateKeyframe(model)
	if not model.PrimaryPart then
		warn("Brak ustawionej części głównej")
		return
	end

	local rootPart = model.PrimaryPart:GetRootPart()

	if not rootPart then
		warn("Nie znaleziono części root")
		return
	end

	local partsAdded = {}
	partsAdded[rootPart] = true

	local function addPoses(part, parentPose)
		-- pobierz wszystkie stawy dołączone do części
		for _, joint in pairs(part:GetJoints()) do
			-- interesują nas tylko Motor6D
			if joint:IsA("Motor6D") then
				-- znajdź dołączoną część
				local connectedPart = nil
				if joint.Part0 == part then
					connectedPart = joint.Part1
				elseif joint.Part1 == part then
					connectedPart = joint.Part0
				end
				if connectedPart then
					-- upewnij się, że nie dodaliśmy już tej części
					if not partsAdded[connectedPart] then
						partsAdded[connectedPart] = true
						-- stwórz pozę
						local pose = Instance.new("Pose")
						pose.Name = connectedPart.Name
						parentPose:AddSubPose(pose)
						-- rekurencja
						addPoses(connectedPart, pose)
					end
				end
			end
		end
	end

	local keyframe = Instance.new("Keyframe")

	-- uzupełnij klatkę kluczową
	local rootPose = Instance.new("Pose")
	rootPose.Name = rootPart.Name
	addPoses(rootPart, rootPose)
	keyframe:AddPose(rootPose)

	return keyframe
end

local character = script.Parent

local keyframe = generateKeyframe(character)

print(keyframe)

Dodawanie/Usuwanie Poz

local keyframe = Instance.new("Keyframe")
keyframe.Parent = workspace

local pose = Instance.new("Pose")
pose.EasingStyle = Enum.PoseEasingStyle.Cubic
pose.EasingDirection = Enum.PoseEasingDirection.Out

local pose2 = Instance.new("Pose")
pose2.EasingStyle = Enum.PoseEasingStyle.Cubic
pose2.EasingDirection = Enum.PoseEasingDirection.Out

keyframe:AddPose(pose) -- pose.Parent = keyframe

task.wait(2)

keyframe:RemovePose(pose) -- pose.Parent = nil

task.wait(2)

keyframe:AddPose(pose) -- pose.Parent = keyframe

task.wait(2)

pose:AddSubPose(pose2) -- pose2.Parent = pose

task.wait(2)

pose:RemoveSubPose(pose2) -- pose2.Parent = nil

GetMarkers

Możliwości: Animation

Keyframe:GetMarkers():{KeyframeMarker}

Zwroty

{KeyframeMarker}

Przykłady kodu

Pobierz znaczniki klatek kluczowych przypisane do klatki kluczowej

local keyframe = Instance.new("Keyframe")
keyframe.Parent = workspace

local marker1 = Instance.new("KeyframeMarker")
marker1.Name = "FootStep"
marker1.Value = 100

local marker2 = Instance.new("KeyframeMarker")
marker2.Name = "Wave"
marker2.Value = 100

keyframe:AddMarker(marker1) --znacznik.Parent = keyframe
keyframe:AddMarker(marker2) --znacznik.Parent = keyframe

local markers = keyframe:GetMarkers()
for _, marker in pairs(markers) do
	print(marker.Name)
end

GetPoses

Możliwości: Animation

Keyframe:GetPoses():{Pose}

Zwroty

{Pose}

Przykłady kodu

Resetowanie pozy klatek kluczowych

local function resetPoses(parent)
	-- obie funkcje są równoważne z GetChildren
	local poses = parent:IsA("Keyframe") and parent:GetPoses() or parent:IsA("Pose") and parent:GetSubPoses()

	for _, pose in pairs(poses) do
		if pose:IsA("Pose") then
			pose.CFrame = CFrame.new()
			-- rekurencja
			resetPoses(pose)
		end
	end
end

RemoveMarker

Możliwości: Animation

Keyframe:RemoveMarker(marker:Instance):()

Parametry

marker:Instance

Zwroty

()

Przykłady kodu

Dodaj znacznik/Usuń znacznik

local keyframe = Instance.new("Keyframe")
keyframe.Parent = workspace

local marker = Instance.new("KeyframeMarker")
marker.Name = "FootStep"
marker.Value = 100

keyframe:AddMarker(marker) --marker.Parent = keyframe

task.wait(2)

keyframe:RemoveMarker(marker) --marker.Parent = nil

RemovePose

Możliwości: Animation

Keyframe:RemovePose(pose:Instance):()

Parametry

pose:Instance

Zwroty

()

Przykłady kodu

Dodawanie/Usuwanie Poz

local keyframe = Instance.new("Keyframe")
keyframe.Parent = workspace

local pose = Instance.new("Pose")
pose.EasingStyle = Enum.PoseEasingStyle.Cubic
pose.EasingDirection = Enum.PoseEasingDirection.Out

local pose2 = Instance.new("Pose")
pose2.EasingStyle = Enum.PoseEasingStyle.Cubic
pose2.EasingDirection = Enum.PoseEasingDirection.Out

keyframe:AddPose(pose) -- pose.Parent = keyframe

task.wait(2)

keyframe:RemovePose(pose) -- pose.Parent = nil

task.wait(2)

keyframe:AddPose(pose) -- pose.Parent = keyframe

task.wait(2)

pose:AddSubPose(pose2) -- pose2.Parent = pose

task.wait(2)

pose:RemoveSubPose(pose2) -- pose2.Parent = nil

Keyframe