Unity插件FinalIK部分说明书翻译

/*
全身BipedIK
    Final IK 為採用biped骨骼的角色提供了一個極端靈活、強大且高效的全身IK解算器。FBBIK先把Biped角色映射到一個低解析度的多反應器角色IK綁定，解算它，然後重新把結果映射角色。這個過程在LateUpdate進行，在Mecanim/Legacy動畫完成之後，所以它跟animator系統完全分離。

鏈：
    內部，每個肢體和軀幹都是FBIKChain類的實例。軀幹是根鏈，只包含一個node，軀幹是它的子鏈。這種設置形成一個圍繞根鏈的多反應器IK樹。

節點：
    node是鏈的組成部分。比如，手臂鏈包括3個節點-上臂、前臂、手。每個節點維護一個到骨骼的引用（node.transform）。當解算器運行或者結束后，解算出的骨骼位置會保存在node.solverPosition。

反應器：
    FBBIK有3種反應器-【末端反應器】（手、腳），【中間反應器】（肩膀、大腿）和【多反應器】（軀幹）。當旋轉【中間反應器】和【多反應器】無效的時候可以轉動【末端反應器】。旋轉【末端反應器】同樣會改變軀幹的彎曲方向（除非你用彎曲目標覆蓋它）。軀幹反應器是一個【多反應器】，意味著它拖動2個大腿反應器（簡化軀幹定位）。反應器有positionOffset屬性可以非常簡單的操控下層動畫。反應器會在每次解算結束之後將postionOffset重置為Vector3.zero。
 
拉和伸：
    每個鏈都有pull屬性。當pull=1，pull權重跟肢體一樣。這意味著你觸到所有反應器是沒有保障的，太遠的會接觸不到。可以通過修改reach參數，或增加解算迭代次數，或這每幀多次解算，來調整或者改進這個結果。但是，如果你把左臂鏈的pull權重設置到1然後其他都為0，那麼你可以拉角色的左手到無限遠而不丟失聯繫。

映射：
    IKSolverFullBodyBiped解算一個非常低分辨率的快速軀殼。雖然你的角色有多得多的脊椎骨，他可能有兩倍的骨骼在手臂和肩膀或者臀部骨骼等等。因此，在解算之前，解算器需要映射高分辨率的骨架到低分辨率的解算骨架，在解算完成之後再逆向操作。有3種映射器，1.IKMappingSpine用來映射盆骨和脊柱；2.IKMappingLimb映射軀幹；3.IKMappingBone映射頭部；你可以通過IKSolverFullBody.spineMappingIKSolverFullBody.limbMappings和IKSolverFullBody.boneMappings訪問他們。
    
限制：
    1.FullBodyBipedIK沒有頭部反應器。因為頭部只有一個骨頭，你可以再FullBodyIK結束之後隨意轉動，而且，只有極少的情況你需要抓住頭部拉動角色。即使如此，它可以通過拉動肩膀來很好的模擬。這是一個讓程序更快、更穩定的優化措施。
    2.FullBodyBipedIK沒有手指和腳趾反應器。解算手指IK似乎有點過分使用IK了，因為極少有遊戲對手指做綁定。使用104段CCD或者FABRIK鏈控制手指，可能這樣浪費寶貴的毫秒數並不是你想要的。你可以參考DrivingRigdemo了解如何快速擺手指到物體上。
    3.FullBodyBipedIK採樣角色的初始pose（在Start()函數，當每次你重新初始化解算器的時候）找到以什麼方式彎曲肢體。從此，限制-角色的肢體需要被彎曲到自然的方向。有些角色可能是處於T-Pose，他們的肢體是伸直的。有些角色的肢體可能還輕微的往反向彎曲（有些Mixamo綁定的角色）。FullBodyBipedIK會警告你這些問題可能發生。你需要手動在SceneView稍微旋轉骨骼到正確的彎曲方向。因為，這些旋轉會在播放的時候被動畫覆蓋，所以你不用擔心搞壞你的角色。
    4.FullBodyBipedIK 沒有肘部、膝部反應器。這功能在將來如果確實需要的話可能增加。仍然支持通過彎曲目標改變肘部、膝蓋的位置。
    5.Optimize Game Objects 需要關閉，或者至少所有解算器需要的骨骼要引入（FullBodyBipedIK.references）。
    6.支持只有扭曲動畫的額外骨骼。如果額外骨骼有擺動動畫，比如翅膀擺動。那麼FBBIK將不能正確解算。
    7.FullBodyBipedIK 需要角色開啟animatePhysics。這是Mecanim系統的一個bug，它不允許運行時改變animatePhysics，那麼FullBodyBipedIK需要根據初始animatePhysics進行刷新。
    8.FullBodyBipedIK不會在拉動手的時候旋轉肩膀。這樣可以維護胸部動畫的。大多數情況，這沒有問題，但有時候，特別是抓取或者有東西高於頭部的時候，讓肩膀跟著旋轉會更真實。這種情況，你不僅需要一個底層的抬起動畫，還需要肩膀骨骼在IK解算器讀取pose之前，能用腳本旋轉它。這裡同樣有一個腳本包括這個demo，它叫ShoulderRotator。
    9.當你移動【末端反應器】並且反應器權重=0，FBBIK將在動畫的時候嘗試修復肢體的彎曲方向，當肢體旋轉接近180度的時候你將體驗到肢體的轟響，就是說，解算器無法知道在這個奇點上如何旋轉。比如，你有一個行走動畫，手下垂，而你想要夠到頭頂正上方的某個物體，這時候無論你做反應器旋轉動畫或者使用彎曲目標，要在接近180度生硬旋轉中確保手臂不翻轉都會很麻煩。這並不是一個bug，如果我們想要保持默認動畫彎曲方向，這在邏輯上是必然會發生的。
    10.FullBodyBipedIK認定手肘和膝蓋關節是鉸鏈關節，就是說前臂不能相對上臂扭動。在最常見的綁定，像3dsMaxbiped上這沒問題，因為這些綁定阻止這類動畫出現。然而如果綁定允許這種扭曲。這不會導致FBBIK解算器失效，相反，FBBIK解算器會強制手肘和膝蓋約束到鉸鏈關節，即使它沒有反應器。這不會改變肢體末端，它會輕微的改變肢體彎曲方向，和骨骼的扭曲。
開始教程：
    1.添加FullBodyBipedIK組件到角色根節點（與Animator/Animation組件相同）
    2.確認自動檢測到的biped references正確。
    3.確認跟節點正確檢測到。它應該是脊柱下端的骨骼。
    4.看下SceneView，確認FBBIK骨架在角色上顯示。
    5.按Play，操控解算器。
*/
//訪問反應器：
    public FullBodyBipedIK ik;
    void LateUpdate () {
        ik.solver.leftHandEffector.position = something; // 設置左手反應器位置（世界坐標）。如果把權重設置到0，反應器會沒有效果。
        ik.solver.leftHandEffector.rotation = something; // 設置左手反應器旋轉（世界坐標）。如果把權重設置到0，反應器會沒有效果。
        ik.solver.leftHandEffector.positionWeight = 1f;  // 反應器位置權重，這裡設為1，左手位置會被固定到ik.solver.leftHandEffector.position.
        // 反應器旋轉權重，這裡設為1，左手和手臂旋轉會被固定到ik.solver.leftHandEffector.rotation.
        // 注意：如果你想要旋轉手，同時不改變手臂綁定
        // 最好在FBBIK更新結束之後，再直接旋轉手（使用委託事件OnPostUpdate）
        ik.solver.leftHandEffector.rotationWeight = 1f;
        // 使手便宜它的動畫位置，如果反應器的positionWeight為1, 它沒有作用。
        // 注意：在反應器每幀更新完之後他會重置positionOffset 到 Vector3.zero所以你必須另外設置它.
        // This enables you to easily edit the value by more than one script.
        ik.solver.leftHandEffector.positionOffset += something;
        // 反應器模式用來改變肢體行為方式，當沒有參與的時候。The effector mode is for changing the way the limb behaves when not weighed in.
        // Free 表示node完全有solver決定。Free means the node is completely at the mercy of the solver.
        // 如果你碰到動作平滑問題，你可以試試把手的模式改為MaintainAnimatedPosition 或 MaintainRelativePosition
        // MaintainAnimatedPosition在每次迭代解算的時候，重置node到骨骼動畫位置
        // 這對腳非常有用，因為一般你需要他們在動畫位置上。
        // MaintainRelativePositionWeight 維護相關部位的相對位置，胸部相對手臂，臀部相對腿。maintains the limb's position relative to the chest for the arms and hips for the legs.
        // 所以，如果你從左手拉動角色，右手臂會隨著胸部運動。
        // 一般你不需要把這個行為應用到腿部。
        ik.solver.leftHandEffector.maintainRelativePositionWeight = 1f;
        // 軀體反應器是一個【多反應器】，表示在解算器裡它跟其他node一起操控，明確的說是左右大腿。
        // 所以，你可以帶著大腿骨骼移動軀體反應器。如果我們設置effectChildNodes 為 false，大腿node就不會被軀體反應器改變。
        ik.solver.body.effectChildNodes = false;
        // 其他反應器：rightHandEffector, leftFootEffector, rightFootEffector, leftShoulderEffector, rightShoulderEffector,leftThighEffector, rightThighEffector, bodyEffector
        // 你也可以通過下面的方法找到反應器：
        ik.solver.GetEffector(FullBodyBipedEffector effectorType);
        ik.solver.GetEffector(FullBodyBipedChain chainType);
        ik.solver.GetEndEffector(FullBodyBipedChain chainType); // 值返回手或腳反應器
    }
    
    
    // 訪問鏈:
    public FullBodyBipedIK ik;
    void LateUpdate () {
        ik.solver.leftArmChain.pull = 1f; // 改變左臂pull值
        ik.solver.leftArmChain.reach = 0f; // 改變左臂Reach值
        // 其他鏈：rightArmChain, leftLegChain, rightLegChain, chain (根鏈)
        // 你可以用下面的方法找到鏈：
        ik.solver.GetChain(FullBodyBipedChain chainType);
        ik.solver.GetChain(FullBodyBipedEffector effectorType);
    }

    
    //訪問映射:
    public FullBodyBipedIK ik;
    void LateUpdate () {
        ik.solver.spineMapping.iterations = 2; // 改變脊柱映射迭代次數
        ik.solver.leftArmMapping.maintainRotationWeight = 1f; // 使左手處理旋轉與動畫保持一致。Make the left hand maintain it's rotation as animated.
        ik.solver.headMapping.maintainRotationWeight = 1f; // 使頭部旋轉處理與動畫一致。Make the head maintain it's rotation as animated.
    }
    
    
    //運行時添加 FullBodyBipedIK (UMA):
    using RootMotion; // 需要先包含RootMotion 命名空間，因為BipedReferences類
    FullBodyBipedIK ik;
    // 任何時候可以調用下面的方法
    // 注意，FBBIK初始化的時候要採樣角色pose，所以再調用這個方法的時候肢體需要被彎曲到自然方向
    void AddFBBIK (GameObject go, BipedReferences references = null) {
        if (references == null) { // 還沒有定義biped的時候，自動檢測它
            BipedReferences.AutoDetectReferences(ref references, go.transform, BipedReferences.AutoDetectParams.Default);
        }
        ik = go.AddComponent<FullBodyBipedIK>(); // 添加組件
        // 設置FBBIK到references. 第二個參數可以為空(root node) 如果你信任FBBIK自動檢測到根節點在正確的脊柱骨骼上
        ik.SetReferences(references, null);
    }
    
    
    //優化FullBodyBipedIK:
    //如果角色沒有顯示，可以使用renderer.isVisible來顯示
    //大部分時間你不需要這麼的solver迭代和脊椎映射迭代。注意： 如果只有一次迭代，角色的肩膀和大腿拉動手和腳的時候可能想脫臼
    //如果不需要“Reach”值，請保持它為0。它默認=0.05f來提高精度。
    //保持Spine Twist 權重=0。如果你不需要他。
    //同樣設置"Spine Stiffness", "Pull Body Vertical" and/or "Pull Body Horizontal" =0 可以提高性能。
    
    
    //肢體：
    // LimbIK 繼承 TrigonometricIK 來定義3段 類似手臂和腿的肢體。
    // LimbIK由以下幾個修Bend改器組成：
    // Animation: 嘗試按動畫控制彎曲方向
    // Target: 根據目標IKRotation旋轉彎曲方向
    // Parent: 根據父物體旋轉彎曲方向（盆骨或鎖骨）
    // Arm: 保持在生物統計學的鬆弛位置彎曲手臂（相對上面的，它的消耗更大）
    // 如果所有的bend修改器都不適合你的要求，那麼你可以添加彎曲目標，簡單如下；
    using RootMotion.FinalIK;
    public LimbIK limbIK;
    void LateUpdate () {
        limbIK.solver.SetBendGoalPosition(transform.position);
    }
    // 這會使limb彎曲到 從第一個bone指向goal位置的方向
    // IKSolverLimb.maintainRotationWeight 屬性允許操控最後一個骨骼，使它保持在肢體解算器前的世界左邊旋轉值
    // 當你需要復位腳的時候這非常有用，但This is most useful when we need to reposition a foot, but maintain it's rotation as it was animated to ensure proper alignment with the ground surface.
    // 開始:
    // 添加LimbIK 組件到角色跟物體（角色需要朝前）
    // 添加骨骼到LimbIK組件 bone1, bone2 and bone3
    // 按play
    // 用腳本實現：
    public LimbIK limbIK;
    void LateUpdate () {
        // 改變目標位置、旋轉、權重
        limbIK.solver.IKPosition = something;
        limbIK.solver.IKRotation = something;
        limbIK.solver.IKPositionWeight = something;
        limbIK.solver.IKRotationWeight = something;
        // 改變自動bend修改器
        limbIK.solver.bendModifier = IKSolverLimb.BendModifier.Animation; // 按動畫控制彎曲方向
        limbIK.solver.bendModifier = IKSolverLimb.BendModifier.Target; // 按目標旋轉控制彎曲
        limbIK.solver.bendModifier = IKSolverLimb.BendModifier.Parent; // 根據父骨骼控制彎曲方向（盆骨、肩膀）
        // 嘗試按生物學鬆弛狀態控制手臂彎曲方向
        // 腿部不會受這個影響
        limbIK.solver.bendModifier = IKSolverLimb.BendModifier.Arm;
    }
    //運行時添加LimbIK:
    //通過腳本添加
    LimbIK.solver.SetChain()
    
    
    //旋轉限制：
    //所有旋轉約束和其他FinalIK組件都是基於Quaternion（四元數）和Axis-Angle（軸角）以確保一致性，連續性和最小化奇異問題。FinalIK沒有包含簡單歐拉角選項。
    //所有旋轉約束基於local rotation 並且像Physics 關節一樣使用初始local rotation 作為引用。這使它軸獨立，并容易設置。
    //所有旋轉約束可以在SceneView 可以undo
    //所有旋轉約束支持與IK解算器聯合工作
    
    
    //角度mode
    //簡單的角度擺動和扭動限制
    
    //鉸鏈mode
    //鉸鏈旋轉限制限制限制關節只繞某個軸旋轉一定角度。它旋轉值可以超過360度。
    
    
    
    
    //多邊形mode
    // 使用一個球面多邊形來限制旋轉範圍，這是普遍存在的球窩使關節。 A reach cone is specified as a spherical polygon on the surface of a a reach sphere that defines all
    // positions the longitudinal segment axis beyond the joint can take.
    // twist limit 參數定義了圍繞主軸最大扭轉角度
    // 這個類基於論文：
    // "Fast and Easy Reach-Cone Joint Limits"
    // Jane Wilhelms and Allen Van Gelder. Computer Science Dept., University of California, Santa Cruz, CA 95064. August 2, 2001
    // 多邊形角度限制模式提供方便快速編輯SceneView工具，來編輯、克隆和修改reachcone點
    
    //樣條線mode
    // 使用樣條線限制普遍的球窩關節的旋轉範圍
    // 通過AnimationCurve正交投影到球面獲得光滑、快速的限制範圍。
    // twist limit 參數定義了圍繞主軸最大扭轉角度
    // 樣條線角度限制模式提供方便快速編輯SceneView工具，來編輯、克隆和修改reachcone點
    
    
    
    //擴展Final IK
    // FinalIK的IK解算器和旋轉限制架構基於可擴展思想搭建。
    // FinalIK的一些組件比如BipedIK, 本質上僅僅是IK解算器的收集器
    // 自定義IK組件：
    // 在你發掘出FinalIK全部能力之前，了解一些它的架構非常重要。
    // IK組件和IK解算器之間的區別：
    // 架構上，IK解算器類包括反向關節功能，而IK組件只是擁有、初始化、更新他的解算器然後提供SceneView操作手柄和自定義inspector。
    // 因此，IK解算器完全獨立於他的組件，並且可以完全脫離直接引用來使用：
    using RootMotion.FinalIK;
    public IKSolverCCD spine = new IKSolverCCD();
    public IKSolverLimb limb = new IKSolverLimb();
    void Start() {
        // 基於多種原因，根transform引用在IK解算器初始化的時候引用。
        // 啟發式解算器（CCD） IKSolverCCD, IKSolverFABRIK and IKSolverAim 只需要用它作為警告log的上下文。
        // 角色解算器 IKSolverLimb, IKSolverLookAt, BipedIK and IKSolverFullBodyBiped 用它來定義相對與角色的方向。
        // IKSolverFABRIKRoot 使用它作為所有FABRIK鏈的根
        spine.Initiate(transform);
        limb.Initiate(transform);
    }
    void LateUpdate() {
        // 按順序更新IK解算器
        // 在多IK解算器擁有骨骼層次，先初始化的它的父物體比較好。
        spine.Update();
        limb.Update();
    }
    // 你現在有了一個自己的IK組件
    // 如果你想把自己的功能全部放在單個組件里，像 BipedIK，所以你不會管理很多不同的IK組件在你的場景裡
    
    // 寫自定義旋轉限制：
    // 所有旋轉限制都繼承抽象類RotationLimit 構建自己的類同樣需要繼承這個基類，并覆蓋抽象方法。
    protected abstract Quaternion LimitRotation(Quaternion rotation);
    // 這個方法里你需要應用約束，并返回輸入Quaternion
    // 注意：比較重要，Quaternion已經轉換為物體的默認的local rotation空間，意味著如果你返回Quaternion.identity，物體會總是會被修正到他的初始local rotation
    // 下面的代碼是一個創建自定義旋轉限制的模板：
    using RootMotion.FinalIK;
    // 聲明類并繼承RotationLimit.cs
    public class RotationLimitCustom: RotationLimit {
        // 在實例Transform的local空間限制旋轉
        protected override Quaternion LimitRotation(Quaternion rotation) {
            return MyLimitFunction(rotation);
        }
    }
    // 新旋轉限制由所有可約束的IK解算器認可并自動應用。
    // 組合IK組件：
    // 當創建更複雜的IK系統時，你可能需要完全控制解算器的更新順序。要這麼做，你只要禁用他們的組件，并用外部腳本管理他們的解算器
    // 所有IK組件繼承類IK，而所有IK解算器繼承抽象類IKSolver。這讓你很容易的掌控和替代解算器，而不需要知道特別的解算器類型
    // 控制多重IK組件的更新順序
    using RootMotion.FinalIK;
    // IK組件數組，你可以從inspector賦值
    // IK是抽象類，所以你不用使用的是考慮那個特別的IK組件類型 is abstract, so it does not matter which specific IK component types are used.
    public IK[] components;
    void Start() {
        // 禁用所有其他IK組件，這樣他們不會更新解算器。使用 Disable() 代替=false 後者不能保證初始化。
        foreach (IK component in components) component.Disable();
    }
    void LateUpdate() {
        // 按順序更新IK解算器
        foreach (IK component in components) component.GetIKSolver().Update();
    }