#region --- License --- /* Copyright (c) 2006 - 2008 The Open Toolkit library. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #endregion using System; using System.Runtime.InteropServices; namespace OpenTK { /// Represents a 2D vector using two 32-bit integer values. /// /// The Vector2i structure is suitable for interoperation with unmanaged code requiring two consecutive integers. /// [Serializable] public struct Vector2i : IEquatable { #region Fields /// /// The X component of the Vector2i. /// public int X; /// /// The Y component of the Vector2i. /// public int Y; #endregion #region Constructors /// /// Constructs a new Vector2i. /// /// The x coordinate of the net Vector2i. /// The y coordinate of the net Vector2i. public Vector2i(int x, int y) { X = x; Y = y; } #endregion #region Public Members #region Instance #region public Vector2i PerpendicularRight /// /// Gets the perpendicular vector on the right side of this vector. /// public Vector2i PerpendicularRight { get { return new Vector2i(Y, -X); } } #endregion #region public Vector2i PerpendicularLeft /// /// Gets the perpendicular vector on the left side of this vector. /// public Vector2i PerpendicularLeft { get { return new Vector2i(-Y, X); } } #endregion #endregion #region Static #region Fields /// /// Defines a unit-length Vector2i that points towards the X-axis. /// public static readonly Vector2i UnitX = new Vector2i(1, 0); /// /// Defines a unit-length Vector2i that points towards the Y-axis. /// public static readonly Vector2i UnitY = new Vector2i(0, 1); /// /// Defines a zero-length Vector2i. /// public static readonly Vector2i Zero = new Vector2i(0, 0); /// /// Defines an instance with all components set to 1. /// public static readonly Vector2i One = new Vector2i(1, 1); /// /// Defines the size of the Vector2i struct in bytes. /// public static readonly int SizeInBytes = Marshal.SizeOf(new Vector2i()); #endregion #region Add /// /// Adds two vectors. /// /// Left operand. /// Right operand. /// Result of operation. public static Vector2i Add(Vector2i a, Vector2i b) { Add(ref a, ref b, out a); return a; } /// /// Adds two vectors. /// /// Left operand. /// Right operand. /// Result of operation. public static void Add(ref Vector2i a, ref Vector2i b, out Vector2i result) { result = new Vector2i(a.X + b.X, a.Y + b.Y); } #endregion #region Subtract /// /// Subtract one Vector from another /// /// First operand /// Second operand /// Result of subtraction public static Vector2i Subtract(Vector2i a, Vector2i b) { Subtract(ref a, ref b, out a); return a; } /// /// Subtract one Vector from another /// /// First operand /// Second operand /// Result of subtraction public static void Subtract(ref Vector2i a, ref Vector2i b, out Vector2i result) { result = new Vector2i(a.X - b.X, a.Y - b.Y); } #endregion #region Multiply /// /// Multiplies a vector by a scalar. /// /// Left operand. /// Right operand. /// Result of the operation. public static Vector2i Multiply(Vector2i vector, int scale) { Multiply(ref vector, scale, out vector); return vector; } /// /// Multiplies a vector by a scalar. /// /// Left operand. /// Right operand. /// Result of the operation. public static void Multiply(ref Vector2i vector, int scale, out Vector2i result) { result = new Vector2i(vector.X * scale, vector.Y * scale); } /// /// Multiplies a vector by the components a vector (scale). /// /// Left operand. /// Right operand. /// Result of the operation. public static Vector2i Multiply(Vector2i vector, Vector2i scale) { Multiply(ref vector, ref scale, out vector); return vector; } /// /// Multiplies a vector by the components of a vector (scale). /// /// Left operand. /// Right operand. /// Result of the operation. public static void Multiply(ref Vector2i vector, ref Vector2i scale, out Vector2i result) { result = new Vector2i(vector.X * scale.X, vector.Y * scale.Y); } #endregion #region Divide /// /// Divides a vector by a scalar. /// /// Left operand. /// Right operand. /// Result of the operation. public static Vector2i Divide(Vector2i vector, int scale) { Divide(ref vector, scale, out vector); return vector; } /// /// Divides a vector by a scalar. /// /// Left operand. /// Right operand. /// Result of the operation. public static void Divide(ref Vector2i vector, int scale, out Vector2i result) { result = new Vector2i(vector.X / scale, vector.Y / scale); } /// /// Divides a vector by the components of a vector (scale). /// /// Left operand. /// Right operand. /// Result of the operation. public static Vector2i Divide(Vector2i vector, Vector2i scale) { Divide(ref vector, ref scale, out vector); return vector; } /// /// Divide a vector by the components of a vector (scale). /// /// Left operand. /// Right operand. /// Result of the operation. public static void Divide(ref Vector2i vector, ref Vector2i scale, out Vector2i result) { result = new Vector2i(vector.X / scale.X, vector.Y / scale.Y); } #endregion #region ComponentMin /// /// Calculate the component-wise minimum of two vectors /// /// First operand /// Second operand /// The component-wise minimum public static Vector2i ComponentMin(Vector2i a, Vector2i b) { a.X = a.X < b.X ? a.X : b.X; a.Y = a.Y < b.Y ? a.Y : b.Y; return a; } /// /// Calculate the component-wise minimum of two vectors /// /// First operand /// Second operand /// The component-wise minimum public static void ComponentMin(ref Vector2i a, ref Vector2i b, out Vector2i result) { result.X = a.X < b.X ? a.X : b.X; result.Y = a.Y < b.Y ? a.Y : b.Y; } #endregion #region ComponentMax /// /// Calculate the component-wise maximum of two vectors /// /// First operand /// Second operand /// The component-wise maximum public static Vector2i ComponentMax(Vector2i a, Vector2i b) { a.X = a.X > b.X ? a.X : b.X; a.Y = a.Y > b.Y ? a.Y : b.Y; return a; } /// /// Calculate the component-wise maximum of two vectors /// /// First operand /// Second operand /// The component-wise maximum public static void ComponentMax(ref Vector2i a, ref Vector2i b, out Vector2i result) { result.X = a.X > b.X ? a.X : b.X; result.Y = a.Y > b.Y ? a.Y : b.Y; } #endregion #region Clamp /// /// Clamp a vector to the given minimum and maximum vectors /// /// Input vector /// Minimum vector /// Maximum vector /// The clamped vector public static Vector2i Clamp(Vector2i vec, Vector2i min, Vector2i max) { vec.X = vec.X < min.X ? min.X : vec.X > max.X ? max.X : vec.X; vec.Y = vec.Y < min.Y ? min.Y : vec.Y > max.Y ? max.Y : vec.Y; return vec; } /// /// Clamp a vector to the given minimum and maximum vectors /// /// Input vector /// Minimum vector /// Maximum vector /// The clamped vector public static void Clamp(ref Vector2i vec, ref Vector2i min, ref Vector2i max, out Vector2i result) { result.X = vec.X < min.X ? min.X : vec.X > max.X ? max.X : vec.X; result.Y = vec.Y < min.Y ? min.Y : vec.Y > max.Y ? max.Y : vec.Y; } #endregion #region Dot /// /// Calculate the dot (scalar) product of two vectors /// /// First operand /// Second operand /// The dot product of the two inputs public static int Dot(Vector2i left, Vector2i right) { return left.X * right.X + left.Y * right.Y; } /// /// Calculate the dot (scalar) product of two vectors /// /// First operand /// Second operand /// The dot product of the two inputs public static void Dot(ref Vector2i left, ref Vector2i right, out int result) { result = left.X * right.X + left.Y * right.Y; } #endregion #endregion #region Operators /// /// Adds the specified instances. /// /// Left operand. /// Right operand. /// Result of addition. public static Vector2i operator +(Vector2i left, Vector2i right) { left.X += right.X; left.Y += right.Y; return left; } /// /// Subtracts the specified instances. /// /// Left operand. /// Right operand. /// Result of subtraction. public static Vector2i operator -(Vector2i left, Vector2i right) { left.X -= right.X; left.Y -= right.Y; return left; } /// /// Negates the specified instance. /// /// Operand. /// Result of negation. public static Vector2i operator -(Vector2i vec) { vec.X = -vec.X; vec.Y = -vec.Y; return vec; } /// /// Multiplies the specified instance by a scalar. /// /// Left operand. /// Right operand. /// Result of multiplication. public static Vector2i operator *(Vector2i vec, int scale) { vec.X *= scale; vec.Y *= scale; return vec; } /// /// Multiplies the specified instance by a scalar. /// /// Left operand. /// Right operand. /// Result of multiplication. public static Vector2i operator *(int scale, Vector2i vec) { vec.X *= scale; vec.Y *= scale; return vec; } /// /// Divides the specified instance by a scalar. /// /// Left operand /// Right operand /// Result of the division. public static Vector2i operator /(Vector2i vec, int scale) { vec.X /= scale; vec.Y /= scale; return vec; } /// /// Compares the specified instances for equality. /// /// Left operand. /// Right operand. /// True if both instances are equal; false otherwise. public static bool operator ==(Vector2i left, Vector2i right) { return left.Equals(right); } /// /// Compares the specified instances for inequality. /// /// Left operand. /// Right operand. /// True if both instances are not equal; false otherwise. public static bool operator !=(Vector2i left, Vector2i right) { return !left.Equals(right); } #endregion #region Overrides #region public override string ToString() /// /// Returns a System.String that represents the current Vector2i. /// /// public override string ToString() { return String.Format("({0}, {1})", X, Y); } #endregion #region public override int GetHashCode() /// /// Returns the hashcode for this instance. /// /// A System.Int32 containing the unique hashcode for this instance. public override int GetHashCode() { return X.GetHashCode() ^ Y.GetHashCode(); } #endregion #region public override bool Equals(object obj) /// /// Indicates whether this instance and a specified object are equal. /// /// The object to compare to. /// True if the instances are equal; false otherwise. public override bool Equals(object obj) { if (!(obj is Vector2i)) return false; return this.Equals((Vector2i)obj); } #endregion #endregion #endregion #region IEquatable Members /// Indicates whether the current vector is equal to another vector. /// A vector to compare with this vector. /// true if the current vector is equal to the vector parameter; otherwise, false. public bool Equals(Vector2i other) { return X == other.X && Y == other.Y; } #endregion } }