Vector2.cs

浏览该文件的文档.

namespace Engine {
    public struct Vector2 : IEquatable<Vector2> {
        public float X;
 
        public float Y;
 
        public static readonly Vector2 Zero = new(0f);
 
        public static readonly Vector2 One = new(1f);
 
        public static readonly Vector2 UnitX = new(1f, 0f);
 
        public static readonly Vector2 UnitY = new(0f, 1f);
 
        public Vector2 YX {
            get => new(Y, X);
            set {
                Y = value.X;
                X = value.Y;
            }
        }
 
        public Vector2(float v) {
            X = v;
            Y = v;
        }
 
        public Vector2(float x, float y) {
            X = x;
            Y = y;
        }
 
        public Vector2(Point2 p) {
            X = p.X;
            Y = p.Y;
        }
 
        public static implicit operator Vector2((float X, float Y) v) => new(v.X, v.Y);
 
        public override bool Equals(object obj) => obj is Vector2 && Equals((Vector2)obj);
 
        public override int GetHashCode() => X.GetHashCode() + Y.GetHashCode();
 
        public override string ToString() => $"{X},{Y}";
 
        public bool Equals(Vector2 other) => X == other.X && Y == other.Y;
 
        public static Vector2 CreateFromAngle(float angle) {
            float y = MathF.Cos(angle);
            return new Vector2(0f - MathF.Sin(angle), y);
        }
 
        public static float Distance(Vector2 v1, Vector2 v2) => MathF.Sqrt(DistanceSquared(v1, v2));
 
        public static float DistanceSquared(Vector2 v1, Vector2 v2) => MathUtils.Sqr(v1.X - v2.X) + MathUtils.Sqr(v1.Y - v2.Y);
 
        public static float Dot(Vector2 v1, Vector2 v2) => v1.X * v2.X + v1.Y * v2.Y;
 
        public static float Cross(Vector2 v1, Vector2 v2) => v1.X * v2.Y - v1.Y * v2.X;
 
        public static Vector2 Perpendicular(Vector2 v) => new(0f - v.Y, v.X);
 
        public static Vector2 Rotate(Vector2 v, float angle) {
            float num = MathF.Cos(angle);
            float num2 = MathF.Sin(angle);
            return new Vector2(num * v.X + num2 * v.Y, (0f - num2) * v.X + num * v.Y);
        }
 
        public float Length() => MathF.Sqrt(X * X + Y * Y);
 
        public float LengthSquared() => X * X + Y * Y;
 
        public static Vector2 Floor(Vector2 v) => new(MathF.Floor(v.X), MathF.Floor(v.Y));
 
        public static Vector2 Ceiling(Vector2 v) => new(MathF.Ceiling(v.X), MathF.Ceiling(v.Y));
 
        public static Vector2 Round(Vector2 v) => new(MathF.Round(v.X), MathF.Round(v.Y));
 
        public static Vector2 Min(Vector2 v, float f) => new(MathF.Min(v.X, f), MathF.Min(v.Y, f));
 
        public static Vector2 Min(Vector2 v1, Vector2 v2) => new(MathF.Min(v1.X, v2.X), MathF.Min(v1.Y, v2.Y));
 
        public static Vector2 Max(Vector2 v, float f) => new(MathF.Max(v.X, f), MathF.Max(v.Y, f));
 
        public static Vector2 Max(Vector2 v1, Vector2 v2) => new(MathF.Max(v1.X, v2.X), MathF.Max(v1.Y, v2.Y));
 
        public static Vector2 Clamp(Vector2 v, float min, float max) => new(Math.Clamp(v.X, min, max), Math.Clamp(v.Y, min, max));
 
        public static Vector2 Saturate(Vector2 v) => new(MathUtils.Saturate(v.X), MathUtils.Saturate(v.Y));
 
        public static Vector2 Lerp(Vector2 v1, Vector2 v2, float f) => new(MathUtils.Lerp(v1.X, v2.X, f), MathUtils.Lerp(v1.Y, v2.Y, f));
 
        public static Vector2 CatmullRom(Vector2 v1, Vector2 v2, Vector2 v3, Vector2 v4, float f) => new(
            MathUtils.CatmullRom(v1.X, v2.X, v3.X, v4.X, f),
            MathUtils.CatmullRom(v1.Y, v2.Y, v3.Y, v4.Y, f)
        );
 
        public static Vector2 Normalize(Vector2 v) {
            float num = v.Length();
            return !(num > 0f) ? UnitX : v / num;
        }
 
        public static Vector2 LimitLength(Vector2 v, float maxLength) {
            float num = v.LengthSquared();
            return num > maxLength * maxLength ? v * (maxLength / MathF.Sqrt(num)) : v;
        }
 
        public static float Angle(Vector2 v1, Vector2 v2) {
            float num = MathF.Atan2(v1.Y, v1.X);
            float num2 = MathF.Atan2(v2.Y, v2.X) - num;
            if (num2 > (float)Math.PI) {
                num2 -= (float)Math.PI * 2f;
            }
            else if (num2 <= -(float)Math.PI) {
                num2 += (float)Math.PI * 2f;
            }
            return num2;
        }
 
        public static Vector2 Transform(Vector2 v, Matrix m) => new(v.X * m.M11 + v.Y * m.M21 + m.M41, v.X * m.M12 + v.Y * m.M22 + m.M42);
 
        public static void Transform(ref Vector2 v, ref Matrix m, out Vector2 result) {
            result = new Vector2(v.X * m.M11 + v.Y * m.M21 + m.M41, v.X * m.M12 + v.Y * m.M22 + m.M42);
        }
 
        public static Vector2 Transform(Vector2 v, Quaternion q) {
            float num = q.X + q.X;
            float num2 = q.Y + q.Y;
            float num3 = q.Z + q.Z;
            float num4 = q.W * num3;
            float num5 = q.X * num;
            float num6 = q.X * num2;
            float num7 = q.Y * num2;
            float num8 = q.Z * num3;
            return new Vector2(v.X * (1f - num7 - num8) + v.Y * (num6 - num4), v.X * (num6 + num4) + v.Y * (1f - num5 - num8));
        }
 
        public static void Transform(ref Vector2 v, ref Quaternion q, out Vector2 result) {
            float num = q.X + q.X;
            float num2 = q.Y + q.Y;
            float num3 = q.Z + q.Z;
            float num4 = q.W * num3;
            float num5 = q.X * num;
            float num6 = q.X * num2;
            float num7 = q.Y * num2;
            float num8 = q.Z * num3;
            result = new Vector2(v.X * (1f - num7 - num8) + v.Y * (num6 - num4), v.X * (num6 + num4) + v.Y * (1f - num5 - num8));
        }
 
        public static void Transform(Vector2[] sourceArray,
            int sourceIndex,
            ref Matrix m,
            Vector2[] destinationArray,
            int destinationIndex,
            int count) {
            for (int i = 0; i < count; i++) {
                Vector2 vector = sourceArray[sourceIndex + i];
                destinationArray[destinationIndex + i] = new Vector2(
                    vector.X * m.M11 + vector.Y * m.M21 + m.M41,
                    vector.X * m.M12 + vector.Y * m.M22 + m.M42
                );
            }
        }
 
        public static Vector2 TransformNormal(Vector2 v, Matrix m) => new(v.X * m.M11 + v.Y * m.M21, v.X * m.M12 + v.Y * m.M22);
 
        public static void TransformNormal(ref Vector2 v, ref Matrix m, out Vector2 result) {
            result = new Vector2(v.X * m.M11 + v.Y * m.M21, v.X * m.M12 + v.Y * m.M22);
        }
 
        public static void TransformNormal(Vector2[] sourceArray,
            int sourceIndex,
            ref Matrix m,
            Vector2[] destinationArray,
            int destinationIndex,
            int count) {
            for (int i = 0; i < count; i++) {
                Vector2 vector = sourceArray[sourceIndex + i];
                destinationArray[destinationIndex + i] = new Vector2(vector.X * m.M11 + vector.Y * m.M21, vector.X * m.M12 + vector.Y * m.M22);
            }
        }
 
        public static bool operator ==(Vector2 v1, Vector2 v2) => v1.Equals(v2);
 
        public static bool operator !=(Vector2 v1, Vector2 v2) => !v1.Equals(v2);
 
        public static Vector2 operator +(Vector2 v) => v;
 
        public static Vector2 operator -(Vector2 v) => new(0f - v.X, 0f - v.Y);
 
        public static Vector2 operator +(Vector2 v1, Vector2 v2) => new(v1.X + v2.X, v1.Y + v2.Y);
 
        public static Vector2 operator -(Vector2 v1, Vector2 v2) => new(v1.X - v2.X, v1.Y - v2.Y);
 
        public static Vector2 operator *(Vector2 v1, Vector2 v2) => new(v1.X * v2.X, v1.Y * v2.Y);
 
        public static Vector2 operator *(Vector2 v, float s) => new(v.X * s, v.Y * s);
 
        public static Vector2 operator *(float s, Vector2 v) => new(v.X * s, v.Y * s);
 
        public static Vector2 operator /(Vector2 v1, Vector2 v2) => new(v1.X / v2.X, v1.Y / v2.Y);
 
        public static Vector2 operator /(Vector2 v, float d) {
            float num = 1f / d;
            return new Vector2(v.X * num, v.Y * num);
        }
 
        public static Vector2 operator /(float d, Vector2 v) => new(d / v.X, d / v.Y);
 
        public static Vector2 FixNaN(Vector2 v) {
            if (float.IsNaN(v.X)) {
                v.X = 0;
            }
            if (float.IsNaN(v.Y)) {
                v.Y = 0;
            }
            return v;
        }
 
        public Vector2 FixNaN() {
            if (float.IsNaN(X)) {
                X = 0;
            }
            if (float.IsNaN(Y)) {
                Y = 0;
            }
            return this;
        }
 
        public unsafe Span<float> AsSpan() {
            fixed (float* ptr = &X) {
                return new Span<float>(ptr, 2);
            }
        }
 
        public unsafe float* AsPointer() {
            fixed (float* ptr = &X) {
                return ptr;
            }
        }
    }
}