The DinkVector

The DinkVector is a 3D vector implementation that parallels much of the functionality from most common vector implementations but is geared more toward plotting and navigating in three-dimensional space. It's a collection of calculations that I find myself having to rewrite more and more frequently in my personal projects and am now posting it here for anyone else coming across the same needs.

This is the sort of thing you either do or don't recognize its usefulness so I'll leave it at that.

The source is available on github here: DinkVector
I am providing source for my common languages: C#, javascript, lua, and a generated VB version for you VBers out there. (These will show up on github as I finish porting to them)

The basic interface is as follows:

1.     public class DinkVector
2.     {
3.         double X { get; set; }
4.         double Y { get; set; }
5.         double Z { get; set; }
7.         DinkVector() { }
9.         DinkVector(double x, double y, double z);
11.         DinkVector(DinkVector dinkVector);
13.         static DinkVector FromX(double xAngle, double length);
15.         static DinkVector FromY(double yAngle, double length);
17.         static DinkVector FromZ(double zAngle, double length);
19.         static DinkVector FromZX(double zAngle, double xAngle, double length);
21.         static DinkVector FromZY(double zAngle, double yAngle, double length);
23.         static DinkVector FromXY(double xAngle, double yAngle, double length);
25.         DinkVector Add(DinkVector dinkVector);
27.         DinkVector Add(double x, double y, double z);
29.         static DinkVector operator +(DinkVector left, DinkVector right);
31.         DinkVector Subtract(DinkVector dinkVector);
33.         DinkVector Subtract(double x, double y, double z);
35.         static DinkVector operator -(DinkVector left, DinkVector right);
37.         DinkVector Multiply(DinkVector dinkVector);
39.         DinkVector Multiply(double x, double y, double z);
41.         static DinkVector operator *(DinkVector left, DinkVector right);
43.         DinkVector Divide(DinkVector dinkVector);
45.         DinkVector Divide(double x, double y, double z);
47.         static DinkVector operator /(DinkVector left, DinkVector right);
49.         DinkVector Modulo(DinkVector dinkVector);
51.         DinkVector Modulo(double x, double y, double z);
53.         static DinkVector operator %(DinkVector left, DinkVector right);
55.         void Negate();
57.         void Normalize();
58. 
    
59.         double Length { get; set; }
61.         double GetLengthFrom(DinkVector dinkVector);
63.         double GetLengthFrom(double x, double y, double z);
65.         void SetLengthFrom(DinkVector dinkVector, double length);
67.         void SetLengthFrom(double x, double y, double z, double length);
69.         double ZAngle { get; set; }
71.         double GetZAngleFrom(DinkVector dinkVector);
73.         double GetZAngleFrom(double x, double y);
75.         void SetZAngleFrom(DinkVector dinkVector, double angle);
77.         void SetZAngleFrom(double x, double y, double angle);
79.         double XAngle { get; set; }
81.         double GetXAngleFrom(DinkVector dinkVector);
83.         double GetXAngleFrom(double z, double y);
85.         void SetXAngleFrom(DinkVector dinkVector, double angle);
87.         void SetXAngleFrom(double z, double y, double angle);
89.         double YAngle { get; set; }
91.         double GetYAngleFrom(DinkVector dinkVector);
93.         double GetYAngleFrom(double x, double z);
95.         void SetYAngleFrom(DinkVector dinkVector, double angle);
97.         void SetYAngleFrom(double x, double z, double angle);
98. 
    
99.         double ZAngleStep { get; }
101.         double XAngleStep { get; }
103.         double YAngleStep { get; }
104.     }