Share via


Vector2 Structure

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Defines a vector with two components.

Namespace:  Microsoft.Xna.Framework
Assembly:  Microsoft.Xna.Framework.Math (in Microsoft.Xna.Framework.Math.dll)

Syntax

'Declaration
Public Structure Vector2
public struct Vector2

The Vector2 type exposes the following members.

Constructors

  Name Description
Public method Vector2(Single) Creates a new instance of Vector2.
Public method Vector2(Single, Single) Initializes a new instance of Vector2.

Top

Properties

  Name Description
Public propertyStatic member One Gets a Vector2 with both of its components set to one.
Public propertyStatic member UnitX Gets the unit vector for the x-axis.
Public propertyStatic member UnitY Gets the unit vector for the y-axis.
Public propertyStatic member Zero Gets a Vector2 with all of its components set to zero.

Top

Methods

  Name Description
Public methodStatic member Add(Vector2, Vector2) Adds two vectors.
Public methodStatic member Add(Vector2%, Vector2%, Vector2%) Adds two vectors.
Public methodStatic member Barycentric(Vector2, Vector2, Vector2, Single, Single) Returns a Vector2 containing the 2D Cartesian coordinates of a point specified in barycentric (areal) coordinates relative to a 2D triangle.
Public methodStatic member Barycentric(Vector2%, Vector2%, Vector2%, Single, Single, Vector2%) Returns a Vector2 containing the 2D Cartesian coordinates of a point specified in barycentric (areal) coordinates relative to a 2D triangle.
Public methodStatic member CatmullRom(Vector2, Vector2, Vector2, Vector2, Single) Performs a Catmull-Rom interpolation using the specified positions.
Public methodStatic member CatmullRom(Vector2%, Vector2%, Vector2%, Vector2%, Single, Vector2%) Performs a Catmull-Rom interpolation using the specified positions.
Public methodStatic member Clamp(Vector2, Vector2, Vector2) Restricts a value to be within a specified range.
Public methodStatic member Clamp(Vector2%, Vector2%, Vector2%, Vector2%) Restricts a value to be within a specified range.
Public methodStatic member Distance(Vector2, Vector2) Calculates the distance between two vectors.
Public methodStatic member Distance(Vector2%, Vector2%, Single%) Calculates the distance between two vectors.
Public methodStatic member DistanceSquared(Vector2, Vector2) Calculates the distance between two vectors squared.
Public methodStatic member DistanceSquared(Vector2%, Vector2%, Single%) Calculates the distance between two vectors squared.
Public methodStatic member Divide(Vector2, Vector2) Divides the components of a vector by the components of another vector.
Public methodStatic member Divide(Vector2, Single) Divides a vector by a scalar value.
Public methodStatic member Divide(Vector2%, Vector2%, Vector2%) Divides the components of a vector by the components of another vector.
Public methodStatic member Divide(Vector2%, Single, Vector2%) Divides a vector by a scalar value.
Public methodStatic member Dot(Vector2, Vector2) Calculates the dot product of two vectors. If the two vectors are unit vectors, the dot product returns a floating point value between -1 and 1 that can be used to determine some properties of the angle between two vectors. For example, it can show whether the vectors are orthogonal, parallel, or have an acute or obtuse angle between them.
Public methodStatic member Dot(Vector2%, Vector2%, Single%) Calculates the dot product of two vectors and writes the result to a user-specified variable. If the two vectors are unit vectors, the dot product returns a floating point value between -1 and 1 that can be used to determine some properties of the angle between two vectors. For example, it can show whether the vectors are orthogonal, parallel, or have an acute or obtuse angle between them.
Public method Equals(Object) Determines whether the specified Object is equal to the current Vector2. (Overrides ValueType.Equals(Object).)
Public method Equals(Vector2) Determines whether the specified Vector2 is equal to the current Vector2.
Public method GetHashCode Gets the hash code of the vector object. (Overrides ValueType.GetHashCode().)
Public methodStatic member Hermite(Vector2, Vector2, Vector2, Vector2, Single) Performs a Hermite spline interpolation.
Public methodStatic member Hermite(Vector2%, Vector2%, Vector2%, Vector2%, Single, Vector2%) Performs a Hermite spline interpolation.
Public method Length Calculates the length of the vector.
Public method LengthSquared Calculates the length of the vector squared.
Public methodStatic member Lerp(Vector2, Vector2, Single) Performs a linear interpolation between two vectors.
Public methodStatic member Lerp(Vector2%, Vector2%, Single, Vector2%) Performs a linear interpolation between two vectors.
Public methodStatic member Max(Vector2, Vector2) Returns a vector that contains the highest value from each matching pair of components.
Public methodStatic member Max(Vector2%, Vector2%, Vector2%) Returns a vector that contains the highest value from each matching pair of components.
Public methodStatic member Min(Vector2, Vector2) Returns a vector that contains the lowest value from each matching pair of components.
Public methodStatic member Min(Vector2%, Vector2%, Vector2%) Returns a vector that contains the lowest value from each matching pair of components.
Public methodStatic member Multiply(Vector2, Vector2) Multiplies the components of two vectors by each other.
Public methodStatic member Multiply(Vector2, Single) Multiplies a vector by a scalar value.
Public methodStatic member Multiply(Vector2%, Vector2%, Vector2%) Multiplies the components of two vectors by each other.
Public methodStatic member Multiply(Vector2%, Single, Vector2%) Multiplies a vector by a scalar value.
Public methodStatic member Negate(Vector2) Returns a vector pointing in the opposite direction.
Public methodStatic member Negate(Vector2%, Vector2%) Returns a vector pointing in the opposite direction.
Public method Normalize() Turns the current vector into a unit vector. The result is a vector one unit in length pointing in the same direction as the original vector.
Public methodStatic member Normalize(Vector2) Creates a unit vector from the specified vector. The result is a vector one unit in length pointing in the same direction as the original vector.
Public methodStatic member Normalize(Vector2%, Vector2%) Creates a unit vector from the specified vector, writing the result to a user-specified variable. The result is a vector one unit in length pointing in the same direction as the original vector.
Public methodStatic member Reflect(Vector2, Vector2) Determines the reflect vector of the given vector and normal.
Public methodStatic member Reflect(Vector2%, Vector2%, Vector2%) Determines the reflect vector of the given vector and normal.
Public methodStatic member SmoothStep(Vector2, Vector2, Single) Interpolates between two values using a cubic equation.
Public methodStatic member SmoothStep(Vector2%, Vector2%, Single, Vector2%) Interpolates between two values using a cubic equation.
Public methodStatic member Subtract(Vector2, Vector2) Subtracts a vector from a vector.
Public methodStatic member Subtract(Vector2%, Vector2%, Vector2%) Subtracts a vector from a vector.
Public method ToString Retrieves a string representation of the current object. (Overrides ValueType.ToString().)
Public methodStatic member Transform(Vector2, Matrix) Transforms the vector (x, y, 0, 1) by the specified matrix.
Public methodStatic member Transform(Vector2, Quaternion) Transforms a single Vector2, or the vector normal (x, y, 0, 0), by a specified Quaternion rotation.
Public methodStatic member Transform(Vector2%, Matrix%, Vector2%) Transforms a Vector2 by the given Matrix.
Public methodStatic member Transform(Vector2%, Quaternion%, Vector2%) Transforms a Vector2, or the vector normal (x, y, 0, 0), by a specified Quaternion rotation.
Public methodStatic member Transform(array<Vector2[], Matrix%, array<Vector2[]) Transforms an array of Vector2 instances by a specified Matrix.
Public methodStatic member Transform(array<Vector2[], Quaternion%, array<Vector2[]) Transforms an array of Vector2 instances by a specified Quaternion.
Public methodStatic member Transform(array<Vector2[], Int32, Matrix%, array<Vector2[], Int32, Int32) Transforms a specified range in an array of Vector2 instances by a specified Matrix and places the results in a specified range in a destination array.
Public methodStatic member Transform(array<Vector2[], Int32, Quaternion%, array<Vector2[], Int32, Int32) Transforms a specified range in an array of Vector2 instances by a specified Quaternion and places the results in a specified range in a destination array.
Public methodStatic member TransformNormal(Vector2, Matrix) Transforms a 2D vector normal by a matrix.
Public methodStatic member TransformNormal(Vector2%, Matrix%, Vector2%) Transforms a 2D vector normal by a matrix.
Public methodStatic member TransformNormal(array<Vector2[], Matrix%, array<Vector2[]) Transforms an array of Vector2 vector normals by a specified Matrix.
Public methodStatic member TransformNormal(array<Vector2[], Int32, Matrix%, array<Vector2[], Int32, Int32) Transforms a specified range in an array of Vector2 vector normals by a specified Matrix and places the results in a specified range in a destination array.

Top

Operators

  Name Description
Public operatorStatic member Addition Adds two vectors.
Public operatorStatic member Division(Vector2, Vector2) Divides the components of a vector by the components of another vector.
Public operatorStatic member Division(Vector2, Single) Divides a vector by a scalar value.
Public operatorStatic member Equality Tests vectors for equality.
Public operatorStatic member Inequality Tests vectors for inequality.
Public operatorStatic member Multiply(Single, Vector2) Multiplies a vector by a scalar value.
Public operatorStatic member Multiply(Vector2, Vector2) Multiplies the components of two vectors by each other.
Public operatorStatic member Multiply(Vector2, Single) Multiplies a vector by a scalar value.
Public operatorStatic member Subtraction Subtracts a vector from a vector.
Public operatorStatic member UnaryNegation Returns a vector pointing in the opposite direction.

Top

Fields

  Name Description
Public field X Gets or sets the x-component of the vector.
Public field Y Gets or sets the y-component of the vector.

Top

Version Information

Silverlight

Supported in: 5

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.