Pose

非推奨を表示

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

ポーズは、関連する CFrame に接続された Motor6D に適用された BasePart を保持します。制御されるパーツは、ポーズの名前に依存します。

ポーズはアニメーションの基本的な構築ブロックであり、Keyframes で、KeyframeSequences を構成します。

ポーズ、ジョイント、階層

ポーズは名前で BasePart に割り当てられていますが、アニメーション再生中に操作されるオブジェクトは、実際にはこの部分に接続されている Motor6D です。アニメーションリグは、そのようなジョイントを介してモデルの根部から分岐します。

R15 キャラクターリグでは、根部は HumanoidRootPart です。LowerTorso は、「Root」というモーターによって HumanoidRootPart に接続されています。ため、CFrame ポーズの名前 'LowerTorso' の Keyframe には、モーター 'Root' に適用され、LowerTorso 自体には適用されません。

ポーズは、共同の階層に基づいて Keyframe 配置されます。これは、ポーズの CFrame が、ポーズに関連するパーツをポーズの親に接続するモーターに適用されることを意味します。R15 キャラクターのポーズの構造の視覚的な例は以下を参照してください。

ポーズCフレーム

Roblox アニメーションシステムは、モーターの相対変形、Motor6D プロパティを操作して、対応する Motor6D.Transform に Pose.CFrame を適用します。オリジナルの C0 と C1 の値は変更されません。

コードサンプル

Keyframe Generate Poses
local function generateKeyframe(model)

	if not model.PrimaryPart then

		warn("No primary part set")

		return

	end



	local rootPart = model.PrimaryPart:GetRootPart()



	if not rootPart then

		warn("Root part not found")

		return

	end



	local partsAdded = {}

	partsAdded[rootPart] = true



	local function addPoses(part, parentPose)

		-- get all of the joints attached to the part

		for _, joint in pairs(part:GetJoints()) do

			-- we're only interested in Motor6Ds

			if joint:IsA("Motor6D") then

				-- find the connected part

				local connectedPart = nil

				if joint.Part0 == part then

					connectedPart = joint.Part1

				elseif joint.Part1 == part then

					connectedPart = joint.Part0

				end

				if connectedPart then

					-- make sure we haven't already added this part

					if not partsAdded[connectedPart] then

						partsAdded[connectedPart] = true

						-- create a pose

						local pose = Instance.new("Pose")

						pose.Name = connectedPart.Name

						parentPose:AddSubPose(pose)

						-- recurse

						addPoses(connectedPart, pose)

					end

				end

			end

		end

	end



	local keyframe = Instance.new("Keyframe")



	-- populate the keyframe

	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)
Keyframe Reset Poses
local function resetPoses(parent)

	-- both functions are equivalent to 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()

			-- recurse

			resetPoses(pose)

		end

	end

end

概要

プロパティ

  • CFrame:CFrame
    並列読み取り

    この は、 が変更されたときに対応する に適用されます。

PoseBase から継承した プロパティ
Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

プロパティ

CFrame

CFrame
並列読み取り

この は、 が変更されたときに対応する に適用されます。オリジナルの Motor6D.C0 と Motor6D.C1 の値は変更されません。

Pose オブジェクトは、共同の階層に基づいて Keyframe 配置されます。これは、Pose.CFrame が、ポーズに関連するパーツをポーズの親に接続するモーターに適用されることを意味します。

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

AddSubPose

()

親子関係を介して Pose を Pose に追加し、新しいポーズの Instance.Parent をポーズに設定すると機能的に同じです。

注: この機能は、Pose 以外のインスタンスがポーズパラメータとして指定され、成功して親になるときにエラーは発生しません。

パラメータ

pose: Instance

追加する Pose 。

既定値: ""

戻り値

()

コードサンプル

Keyframe Add/Remove Pose
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

GetSubPoses

Instances

返すのは、Poses に追加されたすべてのサブ Pose を含む配列です。これは機能的に Instance:GetChildren() 関数を使用することと同じです。Pose 。

注: この機能は、Pose 、非Pose 、Instances が存在する場合を含め、すべての子供を返します。


戻り値

Instances

子の配列 Poses 。

コードサンプル

Keyframe Reset Poses
local function resetPoses(parent)

	-- both functions are equivalent to 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()

			-- recurse

			resetPoses(pose)

		end

	end

end

RemoveSubPose

()

親子関係で Pose を削除して、Pose から nil を削除します。これは新しいポーズの Instance.Parent を nil に設定すると機能的に同じです。

注: 他の がパラメーターとして使用される場合、この関数はそれを削除し、エラーを提供しません。

パラメータ

pose: Instance

削除する Pose 。

既定値: ""

戻り値

()

コードサンプル

Keyframe Add/Remove Pose
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
Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

イベント

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示