SDHK_Tool.Dynamic.SD_Motor_Vector2 二维移动电机

 

* 作者：闪电Y黑客

* 日期： 2019.6.16

* 功能：集合二维移动方法

 

using UnityEngine;
using SDHK_Tool.Static;

/*
 * 作者：闪电Y黑客
 * 
 * 日期： 2019.6.16
 * 
 * 功能：集合二维移动方法
 */

namespace SDHK_Tool.Dynamic
{

    /// <summary>
    /// 二维移动电机
    /// </summary>
    public class SD_Motor_Vector2
    {

        /// <summary>
        /// 电机激活
        /// </summary>
        public bool MotorActivation = true;
        /// <summary>
        /// 电机速度
        /// </summary>
        public float MotorSpeed = 10;
        /// <summary>
        /// 限制器激活
        /// </summary>
        public bool MotorConstraint = false;
        /// <summary>
        /// 限制轴激活
        /// </summary>
        public Vector2 MotorConstraint_Shaft = Vector2.one;
        /// <summary>
        /// 限制数：最小限制
        /// </summary>
        public Vector2 Limit_Min = Vector2.zero;
        /// <summary>
        /// 限制数：最大限制
        /// </summary>
        public Vector2 Limit_Max = Vector2.zero;
        /// <summary>
        /// 范围半径限制【用于范围限制】
        /// </summary>
        public float Limit_Radius = 0;
        /// <summary>
        /// 范围自由半径限制【用于自定义范围限制】
        /// </summary>
        public Vector2 Limit_RadiusFree = Vector2.zero;
        /// <summary>
        /// 目标位置
        /// </summary>
        public Vector2 MotorTarget;
        /// <summary>
        /// 电机运行后的位置
        /// </summary>
        public Vector2 MotorSave;
        /// <summary>
        /// 平滑运行返回的速度
        /// </summary>
        public Vector2 MotorVelocity;



        #region 数值赋值



        /// <summary>
        /// 设置电机激活
        /// </summary>
        /// <param name="Activation">激活</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorActivation(bool Activation)
        {
            MotorActivation = Activation;
            return this;
        }

        /// <summary>
        /// 设置限制器激活
        /// </summary>
        /// <param name="Constraint">激活</param>
        /// <returns></returns>
        public SD_Motor_Vector2 Set_MotorConstraint(bool Constraint)
        {
            MotorConstraint = Constraint;
            return this;
        }

        /// <summary>
        /// 设置限制轴激活
        /// </summary>
        /// <param name="Constraint_Shaft">轴激活</param>
        /// <returns></returns>
        public SD_Motor_Vector2 Set_MotorConstraint_Shaft(Vector2 Constraint_Shaft)
        {
            MotorConstraint_Shaft = Constraint_Shaft;
            return this;
        }

        /// <summary>
        /// 设置电机限制半径
        /// </summary>
        /// <param name="Radius">半径值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorConstraint_Radius(float Radius)
        {
            Limit_Radius = Radius;
            return this;
        }

        /// <summary>
        /// 设置电机限制半径（自由半径）
        /// </summary>
        /// <param name="Radius">半径值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorConstraint_Radius(Vector2 RadiusFree)
        {
            Limit_RadiusFree = RadiusFree;
            return this;
        }

        /// <summary>
        /// 设置电机限制值
        /// </summary>
        /// <param name="Limit_Min">最小值</param>
        /// <param name="Limit_Max">最大值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorConstraint_Limit(Vector2 Limit_Min, Vector2 Limit_Max)
        {
            this.Limit_Min = Limit_Min;
            this.Limit_Max = Limit_Max;
            return this;
        }

        /// <summary>
        /// 设置电机速度
        /// </summary>
        /// <param name="Speed">速度值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorSpeed(float Speed)
        {
            MotorSpeed = Speed;
            return this;
        }

        /// <summary>
        /// 设置电机目标
        /// </summary>
        /// <param name="Value">目标值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorTarget(Vector2 Value)
        {
            MotorTarget = Value;
            return this;
        }

        /// <summary>
        /// 设置电机位置
        /// </summary>
        /// <param name="Value">位置值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorSave(Vector2 Value)
        {
            MotorSave = Value;
            return this;
        }

        /// <summary>
        /// 设置电机目标和位置
        /// </summary>
        /// <param name="Value">值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Set_MotorValue(Vector2 Value)
        {
            MotorTarget = Value;
            MotorSave = Value;
            return this;
        }



        #endregion



        #region 电机操控



        /// <summary>
        /// 设置电机移动差值
        /// </summary>
        /// <param name="VectorDelta">移动差值</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 SetTarget_VectorDelta(Vector2 VectorDelta)
        {
            if (MotorActivation) MotorTarget += VectorDelta;
            return this;
        }

        /// <summary>
        /// 设置电机移动目标
        /// </summary>
        /// <param name="Vector">移动目标</param>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 SetTarget_Vector(Vector2 Vector)
        {
            if (MotorActivation) MotorTarget = Vector;
            return this;
        }



        #endregion



        #region 电机运行



        /// <summary>
        /// 电机运行 ： 匀速移动（速度越大越快，需要较大的值）
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Run_MoveTowards()
        {
            MotorSave = Vector2.MoveTowards(MotorSave, MotorTarget, MotorSpeed * Time.deltaTime);
            return this;
        }

        /// <summary>
        /// 电机运行 ： 差值移动（速度越大越快）
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Run_Lerp()
        {
            MotorSave = Vector2.Lerp(MotorSave, MotorTarget, MotorSpeed * Time.deltaTime);
            return this;
        }

        /// <summary>
        /// 电机运行 ： 平滑移动（速度越小越快）
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Run_SmoothDamp()
        {
            MotorSave = Vector2.SmoothDamp(MotorSave, MotorTarget, ref MotorVelocity, MotorSpeed, Mathf.Infinity, Time.deltaTime);
            return this;
        }

        //===[自轴移动]======
        /// <summary>
        /// 电机运行：自轴移动操控式（相对于自身坐标系的轴移动）
        /// </summary>
        /// <param name="Origin">物体位置（transform.position）</param>
        /// <param name="direction">方向（transform.forward为正前方）</param>
        /// <returns>return : 电机组件</returns>
        public SD_Motor_Vector2 Run_ShaftDelta(Vector2 Origin, Vector2 direction)
        {
            if (MotorActivation)
            {
                MotorSave = Origin + direction * MotorSpeed * Time.deltaTime;
            }
            return this;
        }



        #endregion



        #region 限制器



        /// <summary>
        /// 移动限制器 ： 本地限制【注：需要限制数值】
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Constraint_Vector_Local()
        {
            if (MotorConstraint) MotorSave = SS_VectorConstraint.Constraint_Vector2(MotorSave, Limit_Min, Limit_Max, MotorConstraint_Shaft);
            return this;
        }

        /// <summary>
        /// 移动限制器 ： 本地范围限制(圆形范围限制)【注：需要半径值】
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Constraint_Vector_Local_Scope()
        {
            if (MotorConstraint) MotorSave = SS_VectorConstraint.Constraint_Vector2_Scope(MotorSave, Vector2.zero, Limit_Radius);
            return this;
        }

        /// <summary>
        /// 移动限制器 ： 本地范围限制（自由范围限制）【注：需要自由半径值】
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Constraint_Vector_Local_Scope_Free()
        {
            if (MotorConstraint) MotorSave = SS_VectorConstraint.Constraint_Vector2(MotorSave, -Limit_RadiusFree, Limit_RadiusFree, MotorConstraint_Shaft);
            return this;
        }

        /// <summary>
        /// 移动限制器 ： 目标限制【注：需要限制数值】
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Constraint_Vector_Target()
        {
            if (MotorConstraint) MotorSave = SS_VectorConstraint.Constraint_Vector2(MotorSave, MotorTarget + Limit_Min, MotorTarget + Limit_Max, MotorConstraint_Shaft);
            return this;
        }

        /// <summary>
        /// 移动限制器 ： 目标范围限制（圆形半径范围限制）【注：需要半径值】
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Constraint_Vector_Target_Scope()
        {
            if (MotorConstraint) MotorSave = SS_VectorConstraint.Constraint_Vector2_Scope(MotorSave, MotorTarget, Limit_Radius);
            return this;
        }

        /// <summary>
        /// 移动限制器 ： 目标范围限制（自由半径范围限制）【注：需要自由半径值】
        /// </summary>
        /// <returns>电机</returns>
        public SD_Motor_Vector2 Constraint_Vector_Target_Scope_Free()
        {
            if (MotorConstraint) MotorSave = SS_VectorConstraint.Constraint_Vector2(MotorSave, MotorTarget - Limit_RadiusFree, MotorTarget + Limit_RadiusFree, MotorConstraint_Shaft);
            return this;
        }



        #endregion



        #region 数值获取



        /// <summary>
        /// 获取电机当前位置
        /// </summary>
        /// <returns>return : 电机位置</returns>
        public Vector2 Get_MotorSave()
        {
            return MotorSave;
        }

        /// <summary>
        /// 判断电机运行完成
        /// </summary>
        /// <param name="Deviation">偏差值</param>
        /// <returns>bool</returns>
        public bool If_MotorRunFinish(float Deviation)
        {
            return (MotorTarget - MotorSave).magnitude < Deviation;
        }



        #endregion


    }


}