topical media & game development

topical media & game development

[] readme course(s) preface I 1 2 II 3 4 III 5 6 7 IV 8 9 10 V 11 12 afterthought(s) appendix reference(s) example(s) resource(s) _

student-ar-org-papervision3d-core-math-Number3D.ax

student-ar-org-papervision3d-core-math-Number3D.ax [swf] [flash] flex


  package org.papervision3d.core.math
{
        import org.papervision3d.Papervision3D;

* The @ax-student-ar-org-papervision3d-core-math-Number3D class represents a value in a three-dimensional coordinate system. * * Properties x, y and z represent the horizontal, vertical and z the depth axes respectively. *


  
public class @ax-student-ar-org-papervision3d-core-math-Number3D
{

* The horizontal coordinate value.


  
        public var x: Number;

* The vertical coordinate value.


  
        public var y: Number;

* The depth coordinate value.


  
        public var z: Number;

* pre-made @ax-student-ar-org-papervision3d-core-math-Number3D : used by various methods as a way to temporarily store @files.


  
        static private var temp : @ax-student-ar-org-papervision3d-core-math-Number3D = @ax-student-ar-org-papervision3d-core-math-Number3D.ZERO; 
        
        static public var toDEGREES :Number = 180/Math.PI;
        static public var toRADIANS :Number = Math.PI/180;

* Creates a new @ax-student-ar-org-papervision3d-core-math-Number3D object whose three-dimensional values are specified by the x, y and z parameters. If you call this constructor function without parameters, a @ax-student-ar-org-papervision3d-core-math-Number3D with x, y and z properties set to zero is created. * * @param x The horizontal coordinate value. The default value is zero. * @param y The vertical coordinate value. The default value is zero. * @param z The depth coordinate value. The default value is zero.


  
        public function @ax-student-ar-org-papervision3d-core-math-Number3D( x: Number=0, y: Number=0, z: Number=0 )
        {
                this.x = x;
                this.y = y;
                this.z = z;
        }

* Returns a new @ax-student-ar-org-papervision3d-core-math-Number3D object that is a clone of the original instance with the same three-dimensional values. * * @return A new @ax-student-ar-org-papervision3d-core-math-Number3D instance with the same three-dimensional values as the original @ax-student-ar-org-papervision3d-core-math-Number3D instance.


  
        public function clone():@ax-student-ar-org-papervision3d-core-math-Number3D
        {
                return new @ax-student-ar-org-papervision3d-core-math-Number3D( this.x, this.y, this.z );
        }

* Copies the values of this Number3d to the passed Number3d. *


  
        public function copyTo(n:@ax-student-ar-org-papervision3d-core-math-Number3D):void
        {
                n.x = x;
                n.y = y;
                n.z = z;
        }

* Copies the values of this Number3d to the passed Number3d. *


  
        public function copyFrom(n:@ax-student-ar-org-papervision3d-core-math-Number3D):void
        {
                x = n.x; 
                y = n.y; 
                z = n.z; 
        }

* Quick way to set the properties of the @ax-student-ar-org-papervision3d-core-math-Number3D *


  
        public function reset(newx:Number = 0, newy:Number = 0, newz:Number = 0):void
        {
                x = newx; 
                y = newy; 
                z = newz; 
        }

        // ______________________________________________________________________ MATH

* Modulo


  

        public function get modulo() : Number
        {
                return Math.sqrt( this.x*this.x + this.y*this.y + this.z*this.z );
        }

* Add


  
        public static function add( v:@ax-student-ar-org-papervision3d-core-math-Number3D, w:@ax-student-ar-org-papervision3d-core-math-Number3D ):@ax-student-ar-org-papervision3d-core-math-Number3D
        {
                return new @ax-student-ar-org-papervision3d-core-math-Number3D
                (
                        v.x + w.x,
                        v.y + w.y,
                        v.z + w.z
                );
        }

* Subtract.


  
        public static function sub( v:@ax-student-ar-org-papervision3d-core-math-Number3D, w:@ax-student-ar-org-papervision3d-core-math-Number3D ):@ax-student-ar-org-papervision3d-core-math-Number3D
        {
                return new @ax-student-ar-org-papervision3d-core-math-Number3D
                (
                        v.x - w.x,
                        v.y - w.y,
                        v.z - w.z
                );
        }

* Dot product.


  
        public static function dot( v:@ax-student-ar-org-papervision3d-core-math-Number3D, w:@ax-student-ar-org-papervision3d-core-math-Number3D ):Number
        {
                return ( v.x * w.x + v.y * w.y + w.z * v.z );
        }

* Cross product. Now optionally takes a target @ax-student-ar-org-papervision3d-core-math-Number3D to put the change into. So we're not constantly making new number3Ds. * Maybe make a crossEq function?


  
        public static function cross( v:@ax-student-ar-org-papervision3d-core-math-Number3D, w:@ax-student-ar-org-papervision3d-core-math-Number3D, targetN:@ax-student-ar-org-papervision3d-core-math-Number3D = null ):@ax-student-ar-org-papervision3d-core-math-Number3D
        {
                if(!targetN) targetN = ZERO; 
                 
                targetN.reset((w.y * v.z) - (w.z * v.y), (w.z * v.x) - (w.x * v.z), (w.x * v.y) - (w.y * v.x));
                return targetN; 
        }

* Normalize.


  
        public function normalize():void
        {
                var mod:Number = this.modulo;

                if( mod != 0 && mod != 1)
                {
                        this.x /= mod;
                        this.y /= mod;
                        this.z /= mod;
                }
        }

* Multiplies the vector by a number. The same as the *= operator


  
        public function multiplyEq(n:Number):void
        {
                x*=n; 
                y*=n;
                z*=n;         
        }

* Adds the vector passed to this vector. The same as the += operator.


  
        public function plusEq(v:@ax-student-ar-org-papervision3d-core-math-Number3D):void
        {
                x+=v.x; 
                y+=v.y; 
                z+=v.z;         
        }

* Subtracts the vector passed to this vector. The same as the -= operator.


  
        
        public function minusEq(v:@ax-student-ar-org-papervision3d-core-math-Number3D):void
        {
                x -= v.x; 
                y -= v.y; 
                z -= v.z;         
                
        }

        // ______________________________________________________________________

* Super fast modulo(length, magnitude) comparisons. * *


  
        public function isModuloLessThan(v:Number):Boolean
        {
                        
                return (moduloSquared<(v*v)); 
                
        }
        
        public function isModuloGreaterThan(v:Number):Boolean
        {
                        
                return (moduloSquared>(v*v)); 
                
        }
        public function isModuloEqualTo(v:Number):Boolean
        {
                        
                return (moduloSquared==(v*v)); 
                
        }
                
        public function get moduloSquared():Number
        {
                return ( this.x*this.x + this.y*this.y + this.z*this.z );
        }
        
        
        // ______________________________________________________________________

* Returns a @ax-student-ar-org-papervision3d-core-math-Number3D object with x, y and z properties set to zero. * *
returns: A @ax-student-ar-org-papervision3d-core-math-Number3D object. */ static public function get ZERO():@ax-student-ar-org-papervision3d-core-math-Number3D { return new @ax-student-ar-org-papervision3d-core-math-Number3D( 0, 0, 0 ); } /** * Returns a string value representing the three-dimensional values in the specified @ax-student-ar-org-papervision3d-core-math-Number3D object. * * @return A string. */ public function toString(): String { return 'x:' + Math.round(x*100)/100 + ' y:' + Math.round(y*100)/100 + ' z:' + Math.round(z*100)/100; } //------- TRIG FUNCTIONS /** * * * */ public function rotateX(angle:Number) :void { if(Papervision3D.useDEGREES) angle*= toRADIANS; var cosRY:Number = Math.cos(angle); var sinRY:Number = Math.sin(angle); temp.copyFrom(this); this.y = (temp.y*cosRY)-(temp.z*sinRY); this.z = (temp.y*sinRY)+(temp.z*cosRY); } public function rotateY(angle:Number) :void { if(Papervision3D.useDEGREES) angle*= toRADIANS; var cosRY:Number = Math.cos(angle); var sinRY:Number = Math.sin(angle); temp.copyFrom(this); this.x= (temp.x*cosRY)+(temp.z*sinRY); this.z= (temp.x*-sinRY)+(temp.z*cosRY); } public function rotateZ(angle:Number) :void { if(Papervision3D.useDEGREES) angle*= toRADIANS; var cosRY:Number = Math.cos(angle); var sinRY:Number = Math.sin(angle); temp.copyFrom(this); //this.x= temp.x; this.x= (temp.x*cosRY)-(temp.y*sinRY); this.y= (temp.x*sinRY)+(temp.y*cosRY); } }}

[] readme course(s) preface I 1 2 II 3 4 III 5 6 7 IV 8 9 10 V 11 12 afterthought(s) appendix reference(s) example(s) resource(s) _

(C) Æliens 04/09/2009
You may not copy or print any of this material without explicit permission of the author or the publisher. In case of other copyright issues, contact the author.