Vertor3d类

 一个描述三维空间最基本的类,掌握这个类的原理和用法将能使你在构造3D模型中游刃有余

1. package {
2.   public class Vertor3d {
3.   //定义三维空间的点[x,y,z]
4.   public var x:Number=0;
5.   public var y:Number=0;
6.   public var z:Number=0;
7.   /**
8.   * 构造函数
9.   * @param dx 代表三维空间x轴上的点
10.   * @param dy 代表三维空间y轴上的点
11.   * @param dz 代表三维空间z轴上的点
12.   */
13.   function Vertor3d(dx:Number, dy:Number, dz:Number) {
14.     x = dx;
15.     y = dy;
16.     z = dz;
17.   }
18.   /**
19.   * 将类实例对象绕x轴旋转
20.   * @param angle 一个以度表示的角度(不是弧度)
21.   */
22.   public function rotateX(angle:Number) {
23.     var ca:Number = acosD(angle);
24.     var sa:Number = asinD(angle);
25.     var tempY:Number = y*ca-z*sa;
26.     var tempZ:Number = y*sa+z*ca;
27.     y = tempY;
28.     z = tempZ;
29.   }
30.   /**
31.   * 将类实例对象绕x轴旋转
32.   * @param ca 一个角度的余弦值
33.   * @param sa 一个角度的正弦值
34.   * 这个方法和rotateX的方法的作用是一样的，是为了提高效率而设置的
35.   */
36.   public function rotateXTrig(ca:Number, sa:Number) {
37.     var tempY:Number = y*ca+z*sa;
38.     var tempZ:Number = y*sa+z*ca;
39.     y = tempY;
40.     z = tempZ;
41.   }
42.   /**
43.   * 将类实例对象绕Y轴旋转
44.   * @param angle 一个以度表示的角度(不是弧度)
45.   */
46.   public function rotateY(angle:Number) {
47.     var ca:Number = acosD(angle);
48.     var sa:Number = asinD(angle);
49.     var tempX:Number = x*ca+z*sa;
50.     var tempZ:Number = x*-sa+z*ca;
51.     x = tempX;
52.     z = tempZ;
53.   }
54.   /**
55.   * 将类实例对象绕Y轴旋转
56.   * @param ca 一个角度的余弦值
57.   * @param sa 一个角度的正弦值
58.   * 这个方法和rotateY的方法的作用是一样的，是为了提高效率而设置的
59.   */
60.   public function rotateYTrig(ca:Number, sa:Number) {
61.     var tempX:Number = x*ca+z*sa;
62.     var tempZ:Number = x*-sa+z*ca;
63.     x = tempX;
64.     z = tempZ;
65.   }
66.   /**
67.   * 将类实例对象绕Z轴旋转
68.   * @param angle 一个以度表示的角度(不是弧度)
69.   */
70.   public function rotateZ(angle:Number) {
71.     var ca:Number = acosD(angle);
72.     var sa:Number = asinD(angle);
73.     var tempX:Number = x*ca+y*sa;
74.     var tempY:Number = x*-sa+y*ca;
75.     x = tempX;
76.     y = tempY;
77.   }
78.   /**
79.   * 将类实例对象绕Z轴旋转
80.   * @param ca 一个角度的余弦值
81.   * @param sa 一个角度的正弦值
82.   * 这个方法和rotateZ的方法的作用是一样的，是为了提高效率而设置的
83.   */
84.   public function rotateZTrig(ca:Number, sa:Number) {
85.     var tempX:Number = x*ca+y*sa;
86.     var tempY:Number = x*sa+y*ca;
87.     x = tempX;
88.     y = tempY;
89.   }
90.   /**
91.   * 将类实例对象同时绕X轴和Y轴旋转
92.   * @param angleX 绕X轴旋转的角度(一个以度表示的角度,不是弧度)
93.   * @param angleY 绕Y轴旋转的角度(一个以度表示的角度,不是弧度)
94.   */
95.   public function rotateXY(angleX:Number, angleY:Number) {
96.     var ca:Number = acosD(angleX);
97.     var sa:Number = asinD(angleX);
98.     var cb:Number = acosD(angleY);
99.     var sb:Number = asinD(angleY);
100.     var rz:Number = y*sa+z*ca;
101.     y = y*ca-z*sa;
102.     z = x*-sb+rz*cb;
103.     x = x*cb+rz*sb;
105.   }
106.   /**
107.    * 将类实例对象同时绕X轴和Y轴旋转
108.    * @param ca 绕X轴旋转角度的余弦值
109.    * @param sa 绕X轴旋转角度的正弦值
110.    * @param cb  绕Y轴旋转角度的余弦值
111.    * @param sb 绕Y轴旋转角度的正弦值
112.    */
113.   public function rotateXYTrig(ca:Number, sa:Number, cb:Number, sb:Number) {
114.     var rz:Number = y*sa+z*ca;
115.     y = y*ca-z*sa;
116.     z = x*-sb+rz*cb;
117.     x = x*cb+rz*sb;
118.   }
119.   /**
120.   * 将类实例对象同时绕X轴,Y轴和Z轴旋转
121.   * @param angleX 绕X轴旋转的角度(一个以度表示的角度,不是弧度)
122.   * @param angleY 绕Y轴旋转的角度(一个以度表示的角度,不是弧度)
123.   * @param angleZ 绕Z轴旋转的角度(一个以度表示的角度,不是弧度)
124.   */
125.   public function rotateXYZ(angleX:Number, angleY:Number,angleZ:Number) {
127.     rotateX(angleX);
128.     rotateY(angleY);
129.     rotateZ(angleZ);
130.   }
131.   /**
132.    * 将类实例对象同时绕X轴,Y轴和Z轴旋转
133.    * @param ca 绕X轴旋转角度的余弦值
134.    * @param sa 绕X轴旋转角度的正弦值
135.    * @param cb  绕Y轴旋转角度的余弦值
136.    * @param sb 绕Y轴旋转角度的正弦值
137.    * @param cc 绕Z轴旋转角度的余弦值
138.    * @param sc 绕Z轴旋转角度的正弦值
139.    */
140.   public function rotateXYZTrig(ca:Number, sa:Number, cb:Number, sb:Number, cc:Number, sc:Number) {
141.     var ry:Number = y*ca-z*sa;
142.     var rz:Number = y*sa+z*ca;
143.     var rx:Number = x*cb+rz*sb;
144.     z = x*-sb+rz*cb;
145.     x = rx*cc-ry*sc;
146.     y = rx*sc+ry*cc;
147.   }
148.   /**
149.   * 重新设置点属性
150.   * @param dx 代表三维空间x轴上的点
151.   * @paramdy:代表三维空间y轴上的点
152.   * @paramdz:代表三维空间z轴上的点
153.   */
154.   public function reset(dx:Number, dy:Number, dz:Number) {
155.     this.x = dx;
156.     this.y = dy;
157.     this.z = dz;
158.   }
159.   /**
160.   * 复制类自身并返回一个新类
161.   * @return   Vertor3d类实例对象
162.   */
163.   public function getClone():Vertor3d {
164.     return new Vertor3d(x,y,z);
165.   }
166.   /**
167.   * 比较两个Vertor3d类实例对象属性是否相等，即两个点是否处于三维空间的同一个位置
168.   * @param obj Vertor3d类实例对象
169.   * @return   Boolean
170.   */
171.   public function equals(obj:Vertor3d):Boolean {
173.     return (x == obj.x && y == obj.y && z == obj.z);
174.   }
175.   /**
176.   * 将类对象实例属性与另一个Vertor3d类实例对象属性相加(即x,y,z属性值)并返回新的类对象实例属性
177.   * @param obj Vertor3d类实例对象
178.   */
179.   public function plus(obj:Vertor3d) {
180.     x += obj.x;
181.     y += obj.y;
182.     z += obj.z;
183.   }
184.   /**
185.   * 将类对象实例属性与另一个Vertor3d类实例对象属性相加(即x,y,z属性值)并返回一个新的Vertor3d类实例对象(不改变原类对象实例)
186.   * @param obj Vertor3d类实例对象
187.   * @return   Vertor3d类实例对象
188.   */
189.   public function plusNew(obj:Vertor3d):Vertor3d {
190.     return new Vertor3d(x + obj.x,y + obj.y,z + obj.z);
191.   }
192.   /**
193.   * 将类对象实例属性与另一个Vertor3d类实例对象属性相减(即x,y,z属性值)并返回新的类对象实例属性
194.   * @param obj Vertor3d类实例对象
195.   */
196.   public function minus(obj:Vertor3d) {
197.     x -= obj.x;
198.     y -= obj.y;
199.     z -= obj.z;
200.   }
201.   /**
202.   * 将类对象实例属性与另一个Vertor3d类实例对象属性相减(即x,y,z属性值)并返回一个新的Vertor3d类实例对象(不改变原类对象实例)
203.   * @param obj Vertor3d类实例对象
204.   * @return   Vertor3d类实例对象
205.   */
206.   public function minusNew(obj:Vertor3d):Vertor3d {
207.     return new Vertor3d(x - obj.x,y - obj.y,z - obj.z);
208.   }
209.   /**
210.   * 将类实例对象绕原点旋转180度
211.   */
212.   public function negate() {
213.     x = -x;
214.     y = -y;
215.     z = -z;
216.   }
217.   /**
218.   * 返回一个与类实例对象通过原点对称的新的Vertor3d类实例对象(不改变原类对象实例)
219.   * @return   Vertor3d类实例对象
220.   */
221.   public function negateNew():Vertor3d {
222.     return new Vertor3d(- x,- y,- z);
223.   }
224.   /**
225.   * 将类对象实例属性进行等比例缩放(即x,y,z属性值)并返回新的类对象实例属性
226.   * @param quo 缩放比例
227.   */
228.   public function scale(quo:Number) {
229.     x *= quo;
230.     y *= quo;
231.     z *= quo;
232.   }
233.   /**
234.   * 将类对象实例属性进行等比例缩放(即x,y,z属性值)并返回新的Vertor3d类实例对象(不改变原类对象实例)
235.   * @param quo 缩放比例
236.   * @return   Vertor3d类实例对象
237.   */
238.   public function scaleNew(quo:Number):Vertor3d {
239.     return new Vertor3d(x * quo,y * quo,z * quo);
240.   }
241.   /**
242.   * 返回类对象实例与原点的距离
243.   * @return　Number
244.   */
245.   public function getLength():Number {
246.     return Math.sqrt(x * x + y * y + z * z);
247.   }
248.   /**
249.   * 重新设置类对象实例与原点的距离
250.   * @param len Number(len越大距离越大)
251.   */
252.   public function setLength(len:Number) {
253.     var r:Number = getLength();
254.     //如果r不为零
255.     if (r!=0) {
256.       scale(len/r);
257.     } else {
258.       x=len;
259.     }
260.     /**
261.     * 返回两个Vertor3d对象实例的点积
262.     * @param obj Vertor3d类实例对象
263.     * @return　　Number
264.     */
265.   }
266.   public function dot(obj:Vertor3d):Number {
267.     return x * obj.x + y * obj.y + z * obj.z;
268.   }
269.   /**
270.   * 返回两个Vertor3d对象实例的叉积并返回新的Vertor3d对象实例
271.   * @param obj Vertor3d类实例对象
272.   * @return　　Vertor3d类实例对象
273.   */
274.   public function cross(obj:Vertor3d) {
275.     var cx:Number = y*obj.z-z*obj.y;
276.     var cy:Number = z*obj.x-x*obj.z;
277.     var cz:Number = x*obj.y-y*obj.x;
278.     return new Vertor3d(cx,cy,cz);
279.   }
280.   /**
281.   * 计算两个Vertor3d对象实例之间形成的夹角
282.   * @param obj Vertor3d类实例对象
283.   * @return　　一个角度(Number)
284.   */
285.   public function angleBetween(obj:Vertor3d) {
286.     var dp:Number = dot(obj);
287.     var cosAngle:Number = dp/(getLength()*obj.getLength());
288.     return acosD(cosAngle);
289.   }
290.   /**
291.   * 计算一个物体缩放所需的透视比例
292.   * @param viewDist 默认值300(viewDist值越小产生的透视效果越好)
293.   * @return   透视值(Number)
294.   */
295.   public function getPerspective(viewDist:Number):Number {
296.     viewDist is Number ?  0: viewDist=300;
297.     if (z + viewDist<0) {
298.       return viewDist;
299.     }
300.     return viewDist /(z + viewDist);
302.   }
303.   /**
304.   * 产生类实例对象的透视投影点
305.   * @param p 透视比例值
306.   */
307.   public function persProject(p:Number) {
308.     if (!p is Number) {
309.       p = getPerspective(NaN);
310.     }
311.     x *=p
312.     y *=p;
313.     z *=p;
314.   }
315.   /**
316.   * 将类实例对象的透视投影点作为新的Vertor3d类实例对象返回
317.   * @param p 透视比例值
318.   * @return  Vertor3d类实例对象
319.   */
320.   public function persProjectNew(p:Number):Vertor3d {
321.     if (!p is Number) {
322.       p = getPerspective(NaN);
323.     }
324.     return new Vertor3d(p * x,p * y,0);
325.   }
326.   //重载从object继承的方法toString*/
327.   public function toString():String {
328.     var x:Number = Math.round(this.x*10000)/1000;
329.     var y:Number = Math.round(this.y*10000)/1000;
330.     var z:Number = Math.round(this.z*10000)/1000;
331.     return "[" + x + ":" + y + ":" + z + "]";
332.   }
333.   /**
334.   * 私有方法分别计算一个弧度的正弦对应的角度和余弦对象的角度
335.   * @param radian 一个弧度值
336.   */
337.   public function acosD(radian:Number):Number {
338.     return Math.cos(radian * Math.PI / 180);
339.   }
340.   public function asinD(radian:Number):Number {
341.     return Math.sin(radian * Math.PI / 180);
342.   }
343. }
344. }