+++ /dev/null
-/*\r
-* Copyright (c) 2007-2010 SlimDX Group\r
-* \r
-* Permission is hereby granted, free of charge, to any person obtaining a copy\r
-* of this software and associated documentation files (the "Software"), to deal\r
-* in the Software without restriction, including without limitation the rights\r
-* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r
-* copies of the Software, and to permit persons to whom the Software is\r
-* furnished to do so, subject to the following conditions:\r
-* \r
-* The above copyright notice and this permission notice shall be included in\r
-* all copies or substantial portions of the Software.\r
-* \r
-* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
-* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r
-* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r
-* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r
-* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r
-* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\r
-* THE SOFTWARE.\r
-*/\r
-#pragma once\r
-\r
-#include "../design/Vector3Converter.h"\r
-\r
-#include "Vector4.h"\r
-\r
-using System::Runtime::InteropServices::OutAttribute;\r
-\r
-namespace SlimDX\r
-{\r
- value class Viewport;\r
- value class Matrix;\r
- value class Vector2;\r
- \r
- /// <summary>\r
- /// Defines a three component vector.\r
- /// </summary>\r
- /// <unmanaged>D3DXVECTOR3</unmanaged>\r
- [System::Serializable]\r
- [System::Runtime::InteropServices::StructLayout( System::Runtime::InteropServices::LayoutKind::Sequential, Pack = 4 )]\r
- [System::ComponentModel::TypeConverter( SlimDX::Design::Vector3Converter::typeid )]\r
- public value class Vector3 : System::IEquatable<Vector3>\r
- {\r
- public:\r
- /// <summary>\r
- /// Gets or sets the X component of the vector.\r
- /// </summary>\r
- /// <value>The X component of the vector.</value>\r
- float X;\r
-\r
- /// <summary>\r
- /// Gets or sets the Y component of the vector.\r
- /// </summary>\r
- /// <value>The Y component of the vector.</value>\r
- float Y;\r
-\r
- /// <summary>\r
- /// Gets or sets the Z component of the vector.\r
- /// </summary>\r
- /// <value>The Z component of the vector.</value>\r
- float Z;\r
- \r
- property float default[int]\r
- {\r
- float get( int index );\r
- void set( int index, float value );\r
- }\r
- \r
- /// <summary>\r
- /// Gets a <see cref="Vector3"/> with all of its components set to zero.\r
- /// </summary>\r
- /// <value>A <see cref="Vector3"/> that has all of its components set to zero.</value>\r
- static property Vector3 Zero { Vector3 get() { return Vector3(0, 0, 0); } }\r
-\r
- /// <summary>\r
- /// Gets the X unit <see cref="Vector3"/> (1, 0, 0).\r
- /// </summary>\r
- /// <value>A <see cref="Vector3"/> that has a value of (1, 0, 0).</value>\r
- static property Vector3 UnitX { Vector3 get() { return Vector3(1, 0, 0); } }\r
-\r
- /// <summary>\r
- /// Gets the Y unit <see cref="Vector3"/> (0, 1, 0).\r
- /// </summary>\r
- /// <value>A <see cref="Vector3"/> that has a value of (0, 1, 0).</value>\r
- static property Vector3 UnitY { Vector3 get() { return Vector3(0, 1, 0); } }\r
-\r
- /// <summary>\r
- /// Gets the Z unit <see cref="Vector3"/> (0, 0, 1).\r
- /// </summary>\r
- /// <value>A <see cref="Vector3"/> that has a value of (0, 0, 1).</value>\r
- static property Vector3 UnitZ { Vector3 get() { return Vector3(0, 0, 1); } }\r
-\r
- /// <summary>\r
- /// Gets the size of the <see cref="Vector3"/> type, in bytes.\r
- /// </summary>\r
- static property int SizeInBytes { int get() { return System::Runtime::InteropServices::Marshal::SizeOf(Vector3::typeid); } }\r
-\r
- /// <summary>\r
- /// Initializes a new instance of the <see cref="Vector3"/> class.\r
- /// </summary>\r
- /// <param name="value">The value that will be assigned to all components.</param>\r
- Vector3( float value ); \r
-\r
- /// <summary>\r
- /// Initializes a new instance of the <see cref="Vector3"/> class.\r
- /// </summary>\r
- /// <param name="value">A vector containing the values with which to initialize the X and Y components</param>\r
- /// <param name="z">Initial value for the Z component of the vector.</param>\r
- Vector3( Vector2 value, float z ); \r
-\r
- /// <summary>\r
- /// Initializes a new instance of the <see cref="Vector3"/> class.\r
- /// </summary>\r
- /// <param name="x">Initial value for the X component of the vector.</param>\r
- /// <param name="y">Initial value for the Y component of the vector.</param>\r
- /// <param name="z">Initial value for the Z component of the vector.</param>\r
- Vector3( float x, float y, float z ); \r
-\r
- /// <summary>\r
- /// Calculates the length of the vector.\r
- /// </summary>\r
- /// <returns>The length of the vector.</returns>\r
- float Length(); \r
-\r
- /// <summary>\r
- /// Calculates the squared length of the vector.\r
- /// </summary>\r
- /// <returns>The squared length of the vector.</returns>\r
- float LengthSquared(); \r
- \r
- /// <summary>\r
- /// Converts the vector into a unit vector.\r
- /// </summary>\r
- void Normalize();\r
- \r
- /// <summary>\r
- /// Adds two vectors.\r
- /// </summary>\r
- /// <param name="left">The first vector to add.</param>\r
- /// <param name="right">The second vector to add.</param>\r
- /// <returns>The sum of the two vectors.</returns>\r
- static Vector3 Add( Vector3 left, Vector3 right );\r
-\r
- /// <summary>\r
- /// Adds two vectors.\r
- /// </summary>\r
- /// <param name="left">The first vector to add.</param>\r
- /// <param name="right">The second vector to add.</param>\r
- /// <param name="result">When the method completes, contains the sum of the two vectors.</param>\r
- static void Add( Vector3% left, Vector3% right, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Subtracts two vectors.\r
- /// </summary>\r
- /// <param name="left">The first vector to subtract.</param>\r
- /// <param name="right">The second vector to subtract.</param>\r
- /// <returns>The difference of the two vectors.</returns>\r
- static Vector3 Subtract( Vector3 left, Vector3 right ); \r
-\r
- /// <summary>\r
- /// Subtracts two vectors.\r
- /// </summary>\r
- /// <param name="left">The first vector to subtract.</param>\r
- /// <param name="right">The second vector to subtract.</param>\r
- /// <param name="result">When the method completes, contains the difference of the two vectors.</param>\r
- static void Subtract( Vector3% left, Vector3% right, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Scales a vector by the given value.\r
- /// </summary>\r
- /// <param name="value">The vector to scale.</param>\r
- /// <param name="scale">The amount by which to scale the vector.</param>\r
- /// <returns>The scaled vector.</returns>\r
- static Vector3 Multiply( Vector3 value, float scale ); \r
-\r
- /// <summary>\r
- /// Scales a vector by the given value.\r
- /// </summary>\r
- /// <param name="vector">The vector to scale.</param>\r
- /// <param name="scale">The amount by which to scale the vector.</param>\r
- /// <param name="result">When the method completes, contains the scaled vector.</param>\r
- static void Multiply( Vector3% vector, float scale, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Modulates a vector by another.\r
- /// </summary>\r
- /// <param name="left">The first vector to modulate.</param>\r
- /// <param name="right">The second vector to modulate.</param>\r
- /// <returns>The modulated vector.</returns>\r
- static Vector3 Modulate( Vector3 left, Vector3 right ); \r
-\r
- /// <summary>\r
- /// Modulates a vector by another.\r
- /// </summary>\r
- /// <param name="left">The first vector to modulate.</param>\r
- /// <param name="right">The second vector to modulate.</param>\r
- /// <param name="result">When the moethod completes, contains the modulated vector.</param>\r
- static void Modulate( Vector3% left, Vector3% right, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Scales a vector by the given value.\r
- /// </summary>\r
- /// <param name="value">The vector to scale.</param>\r
- /// <param name="scale">The amount by which to scale the vector.</param>\r
- /// <returns>The scaled vector.</returns>\r
- static Vector3 Divide( Vector3 value, float scale ); \r
-\r
- /// <summary>\r
- /// Scales a vector by the given value.\r
- /// </summary>\r
- /// <param name="vector">The vector to scale.</param>\r
- /// <param name="scale">The amount by which to scale the vector.</param>\r
- /// <param name="result">When the method completes, contains the scaled vector.</param>\r
- static void Divide( Vector3% vector, float scale, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Reverses the direction of a given vector.\r
- /// </summary>\r
- /// <param name="value">The vector to negate.</param>\r
- /// <returns>A vector facing in the opposite direction.</returns>\r
- static Vector3 Negate( Vector3 value );\r
-\r
- /// <summary>\r
- /// Reverses the direction of a given vector.\r
- /// </summary>\r
- /// <param name="value">The vector to negate.</param>\r
- /// <param name="result">When the method completes, contains a vector facing in the opposite direction.</param>\r
- static void Negate( Vector3% value, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Returns a <see cref="Vector3"/> containing the 3D Cartesian coordinates of a point specified in Barycentric coordinates relative to a 3D triangle.\r
- /// </summary>\r
- /// <param name="value1">A <see cref="Vector3"/> containing the 3D Cartesian coordinates of vertex 1 of the triangle.</param>\r
- /// <param name="value2">A <see cref="Vector3"/> containing the 3D Cartesian coordinates of vertex 2 of the triangle.</param>\r
- /// <param name="value3">A <see cref="Vector3"/> containing the 3D Cartesian coordinates of vertex 3 of the triangle.</param>\r
- /// <param name="amount1">Barycentric coordinate b2, which expresses the weighting factor toward vertex 2 (specified in <paramref name="value2"/>).</param>\r
- /// <param name="amount2">Barycentric coordinate b3, which expresses the weighting factor toward vertex 3 (specified in <paramref name="value3"/>).</param>\r
- /// <returns>A new <see cref="Vector3"/> containing the 3D Cartesian coordinates of the specified point.</returns>\r
- static Vector3 Barycentric( Vector3 value1, Vector3 value2, Vector3 value3, float amount1, float amount2 ); \r
-\r
- /// <summary>\r
- /// Returns a <see cref="Vector3"/> containing the 3D Cartesian coordinates of a point specified in Barycentric coordinates relative to a 3D triangle.\r
- /// </summary>\r
- /// <param name="value1">A <see cref="Vector3"/> containing the 3D Cartesian coordinates of vertex 1 of the triangle.</param>\r
- /// <param name="value2">A <see cref="Vector3"/> containing the 3D Cartesian coordinates of vertex 2 of the triangle.</param>\r
- /// <param name="value3">A <see cref="Vector3"/> containing the 3D Cartesian coordinates of vertex 3 of the triangle.</param>\r
- /// <param name="amount1">Barycentric coordinate b2, which expresses the weighting factor toward vertex 2 (specified in <paramref name="value2"/>).</param>\r
- /// <param name="amount2">Barycentric coordinate b3, which expresses the weighting factor toward vertex 3 (specified in <paramref name="value3"/>).</param>\r
- /// <param name="result">When the method completes, contains the 3D Cartesian coordinates of the specified point.</param>\r
- static void Barycentric( Vector3% value1, Vector3% value2, Vector3% value3, float amount1, float amount2, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Performs a Catmull-Rom interpolation using the specified positions.\r
- /// </summary>\r
- /// <param name="value1">The first position in the interpolation.</param>\r
- /// <param name="value2">The second position in the interpolation.</param>\r
- /// <param name="value3">The third position in the interpolation.</param>\r
- /// <param name="value4">The fourth position in the interpolation.</param>\r
- /// <param name="amount">Weighting factor.</param>\r
- /// <returns>A vector that is the result of the Catmull-Rom interpolation.</returns>\r
- static Vector3 CatmullRom( Vector3 value1, Vector3 value2, Vector3 value3, Vector3 value4, float amount );\r
-\r
- /// <summary>\r
- /// Performs a Catmull-Rom interpolation using the specified positions.\r
- /// </summary>\r
- /// <param name="value1">The first position in the interpolation.</param>\r
- /// <param name="value2">The second position in the interpolation.</param>\r
- /// <param name="value3">The third position in the interpolation.</param>\r
- /// <param name="value4">The fourth position in the interpolation.</param>\r
- /// <param name="amount">Weighting factor.</param>\r
- /// <param name="result">When the method completes, contains the result of the Catmull-Rom interpolation.</param>\r
- static void CatmullRom( Vector3% value1, Vector3% value2, Vector3% value3, Vector3% value4, float amount, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Restricts a value to be within a specified range.\r
- /// </summary>\r
- /// <param name="value">The value to clamp.</param>\r
- /// <param name="min">The minimum value.</param>\r
- /// <param name="max">The maximum value.</param>\r
- /// <returns>The clamped value.</returns>\r
- static Vector3 Clamp( Vector3 value, Vector3 min, Vector3 max ); \r
-\r
- /// <summary>\r
- /// Restricts a value to be within a specified range.\r
- /// </summary>\r
- /// <param name="value">The value to clamp.</param>\r
- /// <param name="min">The minimum value.</param>\r
- /// <param name="max">The maximum value.</param>\r
- /// <param name="result">When the method completes, contains the clamped value.</param>\r
- static void Clamp( Vector3% value, Vector3% min, Vector3% max, [Out] Vector3% result ); \r
- \r
- /// <summary>\r
- /// Performs a Hermite spline interpolation.\r
- /// </summary>\r
- /// <param name="value1">First source position vector.</param>\r
- /// <param name="tangent1">First source tangent vector.</param>\r
- /// <param name="value2">Second source position vector.</param>\r
- /// <param name="tangent2">Second source tangent vector.</param>\r
- /// <param name="amount">Weighting factor.</param>\r
- /// <returns>The result of the Hermite spline interpolation.</returns>\r
- static Vector3 Hermite( Vector3 value1, Vector3 tangent1, Vector3 value2, Vector3 tangent2, float amount ); \r
- \r
- /// <summary>\r
- /// Performs a Hermite spline interpolation.\r
- /// </summary>\r
- /// <param name="value1">First source position vector.</param>\r
- /// <param name="tangent1">First source tangent vector.</param>\r
- /// <param name="value2">Second source position vector.</param>\r
- /// <param name="tangent2">Second source tangent vector.</param>\r
- /// <param name="amount">Weighting factor.</param>\r
- /// <param name="result">When the method completes, contains the result of the Hermite spline interpolation.</param>\r
- static void Hermite( Vector3% value1, Vector3% tangent1, Vector3% value2, Vector3% tangent2, float amount, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Performs a linear interpolation between two vectors.\r
- /// </summary>\r
- /// <param name="start">Start vector.</param>\r
- /// <param name="end">End vector.</param>\r
- /// <param name="amount">Value between 0 and 1 indicating the weight of <paramref name="end"/>.</param>\r
- /// <returns>The linear interpolation of the two vectors.</returns>\r
- /// <remarks>\r
- /// This method performs the linear interpolation based on the following formula.\r
- /// <code>start + (end - start) * amount</code>\r
- /// Passing <paramref name="amount"/> a value of 0 will cause <paramref name="start"/> to be returned; a value of 1 will cause <paramref name="end"/> to be returned. \r
- /// </remarks>\r
- static Vector3 Lerp( Vector3 start, Vector3 end, float amount ); \r
-\r
- /// <summary>\r
- /// Performs a linear interpolation between two vectors.\r
- /// </summary>\r
- /// <param name="start">Start vector.</param>\r
- /// <param name="end">End vector.</param>\r
- /// <param name="amount">Value between 0 and 1 indicating the weight of <paramref name="end"/>.</param>\r
- /// <param name="result">When the method completes, contains the linear interpolation of the two vectors.</param>\r
- /// <remarks>\r
- /// This method performs the linear interpolation based on the following formula.\r
- /// <code>start + (end - start) * amount</code>\r
- /// Passing <paramref name="amount"/> a value of 0 will cause <paramref name="start"/> to be returned; a value of 1 will cause <paramref name="end"/> to be returned. \r
- /// </remarks>\r
- static void Lerp( Vector3% start, Vector3% end, float amount, [Out] Vector3% result ); \r
- \r
- /// <summary>\r
- /// Performs a cubic interpolation between two vectors.\r
- /// </summary>\r
- /// <param name="start">Start vector.</param>\r
- /// <param name="end">End vector.</param>\r
- /// <param name="amount">Value between 0 and 1 indicating the weight of <paramref name="end"/>.</param>\r
- /// <returns>The cubic interpolation of the two vectors.</returns>\r
- static Vector3 SmoothStep( Vector3 start, Vector3 end, float amount ); \r
-\r
- /// <summary>\r
- /// Performs a cubic interpolation between two vectors.\r
- /// </summary>\r
- /// <param name="start">Start vector.</param>\r
- /// <param name="end">End vector.</param>\r
- /// <param name="amount">Value between 0 and 1 indicating the weight of <paramref name="end"/>.</param>\r
- /// <param name="result">When the method completes, contains the cubic interpolation of the two vectors.</param>\r
- static void SmoothStep( Vector3% start, Vector3% end, float amount, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Calculates the distance between two vectors.\r
- /// </summary>\r
- /// <param name="value1">The first vector.</param>\r
- /// <param name="value2">The second vector.</param>\r
- /// <returns>The distance between the two vectors.</returns>\r
- static float Distance( Vector3 value1, Vector3 value2 );\r
-\r
- /// <summary>\r
- /// Calculates the squared distance between two vectors.\r
- /// </summary>\r
- /// <param name="value1">The first vector.</param>\r
- /// <param name="value2">The second vector.</param>\r
- /// <returns>The squared distance between the two vectors.</returns>\r
- /// <remarks>Distance squared is the value before taking the square root. \r
- /// Distance squared can often be used in place of distance if relative comparisons are being made. \r
- /// For example, consider three points A, B, and C. To determine whether B or C is further from A, \r
- /// compare the distance between A and B to the distance between A and C. Calculating the two distances \r
- /// involves two square roots, which are computationally expensive. However, using distance squared \r
- /// provides the same information and avoids calculating two square roots.\r
- /// </remarks>\r
- static float DistanceSquared( Vector3 value1, Vector3 value2 );\r
-\r
- /// <summary>\r
- /// Calculates the dot product of two vectors.\r
- /// </summary>\r
- /// <param name="left">First source vector.</param>\r
- /// <param name="right">Second source vector.</param>\r
- /// <returns>The dot product of the two vectors.</returns>\r
- static float Dot( Vector3 left, Vector3 right );\r
- \r
- /// <summary>\r
- /// Calculates the cross product of two vectors.\r
- /// </summary>\r
- /// <param name="left">First source vector.</param>\r
- /// <param name="right">Second source vector.</param>\r
- /// <returns>The cross product of the two vectors.</returns>\r
- static Vector3 Cross( Vector3 left, Vector3 right ); \r
-\r
- /// <summary>\r
- /// Calculates the cross product of two vectors.\r
- /// </summary>\r
- /// <param name="left">First source vector.</param>\r
- /// <param name="right">Second source vector.</param>\r
- /// <param name="result">The cross product of the two vectors.</param>\r
- static void Cross( Vector3% left, Vector3% right, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Returns the reflection of a vector off a surface that has the specified normal. \r
- /// </summary>\r
- /// <param name="vector">The source vector.</param>\r
- /// <param name="normal">Normal of the surface.</param>\r
- /// <returns>The reflected vector.</returns>\r
- /// <remarks>Reflect only gives the direction of a reflection off a surface, it does not determine \r
- /// whether the original vector was close enough to the surface to hit it.</remarks>\r
- static Vector3 Reflect( Vector3 vector, Vector3 normal );\r
-\r
- /// <summary>\r
- /// Returns the reflection of a vector off a surface that has the specified normal. \r
- /// </summary>\r
- /// <param name="vector">The source vector.</param>\r
- /// <param name="normal">Normal of the surface.</param>\r
- /// <param name="result">When the method completes, contains the reflected vector.</param>\r
- /// <remarks>Reflect only gives the direction of a reflection off a surface, it does not determine \r
- /// whether the original vector was close enough to the surface to hit it.</remarks>\r
- static void Reflect( Vector3% vector, Vector3% normal, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Converts the vector into a unit vector.\r
- /// </summary>\r
- /// <param name="vector">The vector to normalize.</param>\r
- /// <returns>The normalized vector.</returns>\r
- static Vector3 Normalize( Vector3 vector );\r
-\r
- /// <summary>\r
- /// Converts the vector into a unit vector.\r
- /// </summary>\r
- /// <param name="vector">The vector to normalize.</param>\r
- /// <param name="result">When the method completes, contains the normalized vector.</param>\r
- static void Normalize( Vector3% vector, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Transforms a 3D vector by the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="vector">The source vector.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <returns>The transformed <see cref="SlimDX::Vector4"/>.</returns>\r
- static Vector4 Transform( Vector3 vector, Matrix transformation );\r
-\r
- /// <summary>\r
- /// Transforms a 3D vector by the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="vector">The source vector.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="result">When the method completes, contains the transformed <see cref="SlimDX::Vector4"/>.</param>\r
- static void Transform( Vector3% vector, Matrix% transformation, [Out] Vector4% result );\r
-\r
- /// <summary>\r
- /// Transforms an array of 3D vectors by the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="vectorsIn">The source vectors.</param>\r
- /// <param name="inputStride">The stride in bytes between vectors in the input.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="vectorsOut">The transformed <see cref="SlimDX::Vector4"/>s.</param>\r
- /// <param name="outputStride">The stride in bytes between vectors in the output.</param>\r
- /// <param name="count">The number of vectors to transform.</param>\r
- static void Transform( Vector3* vectorsIn, int inputStride, Matrix* transformation, Vector4* vectorsOut, int outputStride, int count );\r
-\r
- /// <summary>\r
- /// Transforms an array of 3D vectors by the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="vectorsIn">The source vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="vectorsOut">The transformed <see cref="SlimDX::Vector4"/>s.</param>\r
- /// <param name="count">The number of vectors to transform.</param>\r
- static void Transform( Vector3* vectorsIn, Matrix* transformation, Vector4* vectorsOut, int count ) { Transform( vectorsIn, (int) sizeof(Vector3), transformation, vectorsOut, (int) sizeof(Vector4), count ); }\r
-\r
- /// <summary>\r
- /// Transforms an array of 3D vectors by the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="vectorsIn">The source vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="vectorsOut">The transformed <see cref="SlimDX::Vector4"/>s.</param>\r
- /// <param name="offset">The offset at which to begin transforming.</param>\r
- /// <param name="count">The number of vectors to transform, or 0 to process the whole array.</param>\r
- static void Transform( array<Vector3>^ vectorsIn, Matrix% transformation, array<Vector4>^ vectorsOut, int offset, int count );\r
-\r
- /// <summary>\r
- /// Transforms an array of 3D vectors by the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="vectorsIn">The source vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="vectorsOut">The transformed <see cref="SlimDX::Vector4"/>s.</param>\r
- static void Transform( array<Vector3>^ vectorsIn, Matrix% transformation, array<Vector4>^ vectorsOut ) { Transform( vectorsIn, transformation, vectorsOut, 0, 0 ); }\r
-\r
- /// <summary>\r
- /// Transforms an array of 3D vectors by the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="vectors">The source vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <returns>The transformed <see cref="SlimDX::Vector4"/>s.</returns>\r
- static array<Vector4>^ Transform( array<Vector3>^ vectors, Matrix% transformation );\r
-\r
- /// <summary>\r
- /// Transforms a 3D vector by the given <see cref="SlimDX::Quaternion"/> rotation.\r
- /// </summary>\r
- /// <param name="vector">The vector to rotate.</param>\r
- /// <param name="rotation">The <see cref="SlimDX::Quaternion"/> rotation to apply.</param>\r
- /// <returns>The transformed <see cref="SlimDX::Vector4"/>.</returns>\r
- static Vector4 Transform( Vector3 vector, Quaternion rotation );\r
-\r
- /// <summary>\r
- /// Transforms a 3D vector by the given <see cref="SlimDX::Quaternion"/> rotation.\r
- /// </summary>\r
- /// <param name="vector">The vector to rotate.</param>\r
- /// <param name="rotation">The <see cref="SlimDX::Quaternion"/> rotation to apply.</param>\r
- /// <param name="result">When the method completes, contains the transformed <see cref="SlimDX::Vector4"/>.</param>\r
- static void Transform( Vector3% vector, Quaternion% rotation, [Out] Vector4% result );\r
-\r
- /// <summary>\r
- /// Transforms an array of 3D vectors by the given <see cref="SlimDX::Quaternion"/> rotation.\r
- /// </summary>\r
- /// <param name="vectors">The vectors to rotate.</param>\r
- /// <param name="rotation">The <see cref="SlimDX::Quaternion"/> rotation to apply.</param>\r
- /// <returns>The transformed <see cref="SlimDX::Vector4"/>.</returns>\r
- static array<Vector4>^ Transform( array<Vector3>^ vectors, Quaternion% rotation );\r
-\r
- /// <summary>\r
- /// Performs a coordinate transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="coordinate">The coordinate vector to transform.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <returns>The transformed coordinates.</returns>\r
- static Vector3 TransformCoordinate( Vector3 coordinate, Matrix transformation );\r
-\r
- /// <summary>\r
- /// Performs a coordinate transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="coordinate">The coordinate vector to transform.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="result">When the method completes, contains the transformed coordinates.</param>\r
- static void TransformCoordinate( Vector3% coordinate, Matrix% transformation, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Performs a coordinate transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="coordinatesIn">The source coordinate vectors.</param>\r
- /// <param name="inputStride">The stride in bytes between vectors in the input.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="coordinatesOut">The transformed coordinate <see cref="SlimDX::Vector3"/>s.</param>\r
- /// <param name="outputStride">The stride in bytes between vectors in the output.</param>\r
- /// <param name="count">The number of coordinate vectors to transform.</param>\r
- static void TransformCoordinate( Vector3* coordinatesIn, int inputStride, Matrix* transformation, Vector3* coordinatesOut, int outputStride, int count );\r
-\r
- /// <summary>\r
- /// Performs a coordinate transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="coordinatesIn">The source coordinate vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="coordinatesOut">The transformed coordinate <see cref="SlimDX::Vector3"/>s.</param>\r
- /// <param name="count">The number of coordinate vectors to transform.</param>\r
- static void TransformCoordinate( Vector3* coordinatesIn, Matrix* transformation, Vector3* coordinatesOut, int count ) { TransformCoordinate( coordinatesIn, (int) sizeof(Vector3), transformation, coordinatesOut, (int) sizeof(Vector3), count ); }\r
-\r
- /// <summary>\r
- /// Performs a coordinate transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="coordinatesIn">The source coordinate vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="coordinatesOut">The transformed coordinate <see cref="SlimDX::Vector3"/>s.</param>\r
- /// <param name="offset">The offset at which to begin transforming.</param>\r
- /// <param name="count">The number of coordinate vectors to transform, or 0 to process the whole array.</param>\r
- static void TransformCoordinate( array<Vector3>^ coordinatesIn, Matrix% transformation, array<Vector3>^ coordinatesOut, int offset, int count );\r
-\r
- /// <summary>\r
- /// Performs a coordinate transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="coordinatesIn">The source coordinate vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="coordinatesOut">The transformed coordinate <see cref="SlimDX::Vector3"/>s.</param>\r
- static void TransformCoordinate( array<Vector3>^ coordinatesIn, Matrix% transformation, array<Vector3>^ coordinatesOut ) { TransformCoordinate( coordinatesIn, transformation, coordinatesOut, 0, 0 ); }\r
-\r
- /// <summary>\r
- /// Performs a coordinate transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="coordinates">The coordinate vectors to transform.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <returns>The transformed coordinates.</returns>\r
- static array<Vector3>^ TransformCoordinate( array<Vector3>^ coordinates, Matrix% transformation ); \r
-\r
- /// <summary>\r
- /// Performs a normal transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="normal">The normal vector to transform.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <returns>The transformed normal.</returns>\r
- static Vector3 TransformNormal( Vector3 normal, Matrix transformation );\r
-\r
- /// <summary>\r
- /// Performs a normal transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="normal">The normal vector to transform.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="result">When the method completes, contains the transformed normal.</param>\r
- static void TransformNormal( Vector3% normal, Matrix% transformation, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Performs a normal transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="normalsIn">The source normals to transform.</param>\r
- /// <param name="inputStride">The stride in bytes between normals in the input.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="normalsOut">The transformed <see cref="SlimDX::Vector3"/>s.</param>\r
- /// <param name="outputStride">The stride in bytes between vectors in the output.</param>\r
- /// <param name="count">The number of vectors to transform.</param>\r
- static void TransformNormal( Vector3* normalsIn, int inputStride, Matrix* transformation, Vector3* normalsOut, int outputStride, int count );\r
-\r
- /// <summary>\r
- /// Performs a normal transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="normalsIn">The source normals to transform.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="normalsOut">The transformed <see cref="SlimDX::Vector3"/>s.</param>\r
- /// <param name="count">The number of vectors to transform.</param>\r
- static void TransformNormal( Vector3* normalsIn, Matrix* transformation, Vector3* normalsOut, int count ) { TransformNormal( normalsIn, (int) sizeof(Vector3), transformation, normalsOut, (int) sizeof(Vector3), count ); }\r
-\r
- /// <summary>\r
- /// Performs a normal transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="normalsIn">The source vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="normalsOut">The transformed <see cref="SlimDX::Vector3"/>s.</param>\r
- /// <param name="offset">The offset at which to begin transforming.</param>\r
- /// <param name="count">The number of vectors to transform, or 0 to process the whole array.</param>\r
- static void TransformNormal( array<Vector3>^ normalsIn, Matrix% transformation, array<Vector3>^ normalsOut, int offset, int count );\r
-\r
- /// <summary>\r
- /// Performs a normal transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="normalsIn">The source vectors.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <param name="normalsOut">The transformed <see cref="SlimDX::Vector3"/>s.</param>\r
- static void TransformNormal( array<Vector3>^ normalsIn, Matrix% transformation, array<Vector3>^ normalsOut ) { TransformNormal( normalsIn, transformation, normalsOut, 0, 0 ); }\r
-\r
- /// <summary>\r
- /// Performs a normal transformation using the given <see cref="SlimDX::Matrix"/>.\r
- /// </summary>\r
- /// <param name="normals">The normal vectors to transform.</param>\r
- /// <param name="transformation">The transformation <see cref="SlimDX::Matrix"/>.</param>\r
- /// <returns>The transformed normals.</returns>\r
- static array<Vector3>^ TransformNormal( array<Vector3>^ normals, Matrix% transformation );\r
-\r
- /// <summary>\r
- /// Projects a 3D vector from object space into screen space. \r
- /// </summary>\r
- /// <param name="vector">The vector to project.</param>\r
- /// <param name="x">The X position of the viewport.</param>\r
- /// <param name="y">The Y position of the viewport.</param>\r
- /// <param name="width">The width of the viewport.</param>\r
- /// <param name="height">The height of the viewport.</param>\r
- /// <param name="minZ">The minimum depth of the viewport.</param>\r
- /// <param name="maxZ">The maximum depth of the viewport.</param>\r
- /// <param name="worldViewProjection">The combined world-view-projection matrix.</param>\r
- /// <returns>The vector in screen space.</returns>\r
- static Vector3 Project( Vector3 vector, float x, float y, float width, float height, float minZ, float maxZ, Matrix worldViewProjection );\r
- \r
- /// <summary>\r
- /// Projects a 3D vector from object space into screen space. \r
- /// </summary>\r
- /// <param name="vector">The vector to project.</param>\r
- /// <param name="x">The X position of the viewport.</param>\r
- /// <param name="y">The Y position of the viewport.</param>\r
- /// <param name="width">The width of the viewport.</param>\r
- /// <param name="height">The height of the viewport.</param>\r
- /// <param name="minZ">The minimum depth of the viewport.</param>\r
- /// <param name="maxZ">The maximum depth of the viewport.</param>\r
- /// <param name="worldViewProjection">The combined world-view-projection matrix.</param>\r
- /// <param name="result">When the method completes, contains the vector in screen space.</param>\r
- static void Project( Vector3% vector, float x, float y, float width, float height, float minZ, float maxZ, Matrix% worldViewProjection, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Projects a 3D vector from screen space into object space. \r
- /// </summary>\r
- /// <param name="vector">The vector to project.</param>\r
- /// <param name="x">The X position of the viewport.</param>\r
- /// <param name="y">The Y position of the viewport.</param>\r
- /// <param name="width">The width of the viewport.</param>\r
- /// <param name="height">The height of the viewport.</param>\r
- /// <param name="minZ">The minimum depth of the viewport.</param>\r
- /// <param name="maxZ">The maximum depth of the viewport.</param>\r
- /// <param name="worldViewProjection">The combined world-view-projection matrix.</param>\r
- /// <returns>The vector in object space.</returns>\r
- static Vector3 Unproject( Vector3 vector, float x, float y, float width, float height, float minZ, float maxZ, Matrix worldViewProjection );\r
- \r
- /// <summary>\r
- /// Projects a 3D vector from screen space into object space. \r
- /// </summary>\r
- /// <param name="vector">The vector to project.</param>\r
- /// <param name="x">The X position of the viewport.</param>\r
- /// <param name="y">The Y position of the viewport.</param>\r
- /// <param name="width">The width of the viewport.</param>\r
- /// <param name="height">The height of the viewport.</param>\r
- /// <param name="minZ">The minimum depth of the viewport.</param>\r
- /// <param name="maxZ">The maximum depth of the viewport.</param>\r
- /// <param name="worldViewProjection">The combined world-view-projection matrix.</param>\r
- /// <param name="result">When the method completes, contains the vector in object space.</param>\r
- static void Unproject( Vector3% vector, float x, float y, float width, float height, float minZ, float maxZ, Matrix% worldViewProjection, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Returns a vector containing the smallest components of the specified vectors.\r
- /// </summary>\r
- /// <param name="value1">The first source vector.</param>\r
- /// <param name="value2">The second source vector.</param>\r
- /// <returns>A vector containing the smallest components of the source vectors.</returns>\r
- static Vector3 Minimize( Vector3 value1, Vector3 value2 );\r
-\r
- /// <summary>\r
- /// Returns a vector containing the smallest components of the specified vectors.\r
- /// </summary>\r
- /// <param name="value1">The first source vector.</param>\r
- /// <param name="value2">The second source vector.</param>\r
- /// <param name="result">When the method completes, contains an new vector composed of the smallest components of the source vectors.</param>\r
- static void Minimize( Vector3% value1, Vector3% value2, [Out] Vector3% result );\r
- \r
- /// <summary>\r
- /// Returns a vector containing the largest components of the specified vectors.\r
- /// </summary>\r
- /// <param name="value1">The first source vector.</param>\r
- /// <param name="value2">The second source vector.</param>\r
- /// <returns>A vector containing the largest components of the source vectors.</returns>\r
- static Vector3 Maximize( Vector3 value1, Vector3 value2 );\r
-\r
- /// <summary>\r
- /// Returns a vector containing the smallest components of the specified vectors.\r
- /// </summary>\r
- /// <param name="value1">The first source vector.</param>\r
- /// <param name="value2">The second source vector.</param>\r
- /// <param name="result">When the method completes, contains an new vector composed of the largest components of the source vectors.</param>\r
- static void Maximize( Vector3% value1, Vector3% value2, [Out] Vector3% result );\r
-\r
- /// <summary>\r
- /// Adds two vectors.\r
- /// </summary>\r
- /// <param name="left">The first vector to add.</param>\r
- /// <param name="right">The second vector to add.</param>\r
- /// <returns>The sum of the two vectors.</returns>\r
- static Vector3 operator + ( Vector3 left, Vector3 right );\r
-\r
- /// <summary>\r
- /// Subtracts two vectors.\r
- /// </summary>\r
- /// <param name="left">The first vector to subtract.</param>\r
- /// <param name="right">The second vector to subtract.</param>\r
- /// <returns>The difference of the two vectors.</returns>\r
- static Vector3 operator - ( Vector3 left, Vector3 right );\r
-\r
- /// <summary>\r
- /// Reverses the direction of a given vector.\r
- /// </summary>\r
- /// <param name="value">The vector to negate.</param>\r
- /// <returns>A vector facing in the opposite direction.</returns>\r
- static Vector3 operator - ( Vector3 value );\r
- \r
- /// <summary>\r
- /// Scales a vector by the given value.\r
- /// </summary>\r
- /// <param name="vector">The vector to scale.</param>\r
- /// <param name="scale">The amount by which to scale the vector.</param>\r
- /// <returns>The scaled vector.</returns>\r
- static Vector3 operator * ( Vector3 vector, float scale );\r
- \r
- /// <summary>\r
- /// Scales a vector by the given value.\r
- /// </summary>\r
- /// <param name="vector">The vector to scale.</param>\r
- /// <param name="scale">The amount by which to scale the vector.</param>\r
- /// <returns>The scaled vector.</returns>\r
- static Vector3 operator * ( float scale, Vector3 vector );\r
-\r
- /// <summary>\r
- /// Scales a vector by the given value.\r
- /// </summary>\r
- /// <param name="vector">The vector to scale.</param>\r
- /// <param name="scale">The amount by which to scale the vector.</param>\r
- /// <returns>The scaled vector.</returns>\r
- static Vector3 operator / ( Vector3 vector, float scale );\r
-\r
- /// <summary>\r
- /// Tests for equality between two objects.\r
- /// </summary>\r
- /// <param name="left">The first value to compare.</param>\r
- /// <param name="right">The second value to compare.</param>\r
- /// <returns><c>true</c> if <paramref name="left"/> has the same value as <paramref name="right"/>; otherwise, <c>false</c>.</returns>\r
- static bool operator == ( Vector3 left, Vector3 right );\r
-\r
- /// <summary>\r
- /// Tests for inequality between two objects.\r
- /// </summary>\r
- /// <param name="left">The first value to compare.</param>\r
- /// <param name="right">The second value to compare.</param>\r
- /// <returns><c>true</c> if <paramref name="left"/> has a different value than <paramref name="right"/>; otherwise, <c>false</c>.</returns>\r
- static bool operator != ( Vector3 left, Vector3 right );\r
-\r
- /// <summary>\r
- /// Converts the value of the object to its equivalent string representation.\r
- /// </summary>\r
- /// <returns>The string representation of the value of this instance.</returns>\r
- virtual System::String^ ToString() override;\r
-\r
- /// <summary>\r
- /// Returns the hash code for this instance.\r
- /// </summary>\r
- /// <returns>A 32-bit signed integer hash code.</returns>\r
- virtual int GetHashCode() override;\r
-\r
- /// <summary>\r
- /// Returns a value that indicates whether the current instance is equal to a specified object. \r
- /// </summary>\r
- /// <param name="obj">Object to make the comparison with.</param>\r
- /// <returns><c>true</c> if the current instance is equal to the specified object; <c>false</c> otherwise.</returns>\r
- virtual bool Equals( System::Object^ obj ) override;\r
-\r
- /// <summary>\r
- /// Returns a value that indicates whether the current instance is equal to the specified object. \r
- /// </summary>\r
- /// <param name="other">Object to make the comparison with.</param>\r
- /// <returns><c>true</c> if the current instance is equal to the specified object; <c>false</c> otherwise.</returns>\r
- virtual bool Equals( Vector3 other );\r
-\r
- /// <summary>\r
- /// Determines whether the specified object instances are considered equal. \r
- /// </summary>\r
- /// <param name="value1">The first value to compare.</param>\r
- /// <param name="value2">The second value to compare.</param>\r
- /// <returns><c>true</c> if <paramref name="value1"/> is the same instance as <paramref name="value2"/> or \r
- /// if both are <c>null</c> references or if <c>value1.Equals(value2)</c> returns <c>true</c>; otherwise, <c>false</c>.</returns>\r
- static bool Equals( Vector3% value1, Vector3% value2 );\r
- };\r
-}\r
OSDN Git Service
