#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 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 Abs /// /// Applies component-wise absolute evaluation /// /// Absolute operation applies to this vector's components /// A vector whose components have absolute value of given vector public static Vector2i Abs(Vector2i value) { Vector2i result; Abs(ref value, out result); return result; } /// /// Applies component-wise absolute evaluation /// /// Absolute operation applies to this vector's components /// A vector whose components have absolute value of given vector public static void Abs(ref Vector2i value, out Vector2i result) { result = new Vector2i(Math.Abs(value.X), Math.Abs(value.Y)); } /// /// Applies component-wise absolute evaluation /// /// Absolute operation applies to this vector's components public static void Abs(ref Vector2i value) { Abs(ref value, out value); } #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 #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; } /// /// 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 } }