Merge pull request #163 from kvark/constructor

Implemented short vector constructors

src/cgmath.rs

@@ -43,7 +43,7 @@ pub use matrix::{ToMatrix2, ToMatrix3, ToMatrix4};
 pub use quaternion::{Quaternion, ToQuaternion};
 pub use vector::{Vector, EuclideanVector};
 pub use vector::{Vector2, Vector3, Vector4};
-pub use vector::dot;
+pub use vector::{dot, vec2, vec3, vec4};
 
 pub use angle::{rad, deg};
 pub use angle::{Angle, Rad, Deg};

src/vector.rs

@@ -22,10 +22,10 @@
 //! vector are also provided:
 //!
 //! ```rust
-//! use cgmath::{Vector2, Vector3, Vector4, one, zero};
+//! use cgmath::{Vector2, Vector3, Vector4, one, zero, vec3};
 //!
 //! assert_eq!(Vector2::new(1.0f64, 0.0f64), Vector2::unit_x());
-//! assert_eq!(Vector3::new(0.0f64, 0.0f64, 0.0f64), zero());
+//! assert_eq!(vec3(0.0f64, 0.0f64, 0.0f64), zero());
 //! assert_eq!(Vector4::from_value(1.0f64), one());
 //! ```
 //!
@@ -177,7 +177,7 @@ pub trait Vector<S: BaseNum>: Array1<S> + Zero + One + Neg<Output=Self> {
 
 // Utility macro for generating associated functions for the vectors
 macro_rules! vec(
-    ($Self:ident <$S:ident> { $($field:ident),+ }, $n:expr) => (
+    ($Self:ident <$S:ident> { $($field:ident),+ }, $n:expr, $constructor:ident) => (
         #[derive(PartialEq, Eq, Copy, Clone, Hash, RustcEncodable, RustcDecodable, Rand)]
         pub struct $Self<S> { $(pub $field: S),+ }
 
@@ -189,6 +189,12 @@ macro_rules! vec(
             }
         }
 
+        /// The short constructor.
+        #[inline]
+        pub fn $constructor<S>($($field: S),+) -> $Self<S> {
+            $Self::new($($field),+)
+        }
+
         impl<$S: Copy> $Self<$S> {
             /// Construct a vector from a single value, replicating it.
             #[inline]
@@ -369,9 +375,9 @@ macro_rules! fold {
     ($method:ident, { $x:expr, $y:expr, $z:expr, $w:expr })  => { $x.$method($y).$method($z).$method($w) };
 }
 
-vec!(Vector2<S> { x, y }, 2);
+vec!(Vector2<S> { x, y }, 2, vec2);
-vec!(Vector3<S> { x, y, z }, 3);
+vec!(Vector3<S> { x, y, z }, 3, vec3);
-vec!(Vector4<S> { x, y, z, w }, 4);
+vec!(Vector4<S> { x, y, z, w }, 4, vec4);
 
 /// Operations specific to numeric two-dimensional vectors.
 impl<S: BaseNum> Vector2<S> {

tests/vector.rs

@@ -20,6 +20,13 @@ use cgmath::*;
 use std::f64;
 use std::num::Float;
 
+#[test]
+fn test_constructor() {
+    assert_eq!(vec2(1f32, 2f32), Vector2::new(1f32, 2f32));
+    assert_eq!(vec3(1f64, 2f64, 3f64), Vector3::new(1f64, 2f64, 3f64));
+    assert_eq!(vec4(1is, 2is, 3is, 4is), Vector4::new(1is, 2is, 3is, 4is));
+}
+
 #[test]
 fn test_from_value() {
     assert_eq!(Vector2::from_value(102i), Vector2::new(102i, 102i));