jax 0.0.0.9 → 0.0.0.10

data/src/jax/events.js

@@ -1,234 +0,0 @@
-/**
- * Jax.EVENT_METHODS -> Object
- * Contains event handling methods which are added to +Jax.Context+.
- **/
-Jax.EVENT_METHODS = (function() {
-  function getCumulativeOffset(element) {
-    var valueT = 0, valueL = 0;
-    do {
-      valueT += element.offsetTop  || 0;
-      valueL += element.offsetLeft || 0;
-      valueT += Jax.Compatibility.offsetTop;
-      valueL += Jax.Compatibility.offsetLeft;
-      element = element.offsetParent;
-    } while (element);
-
-    var result = [valueL, valueT];
-    result.left = valueL;
-    result.top = valueT;
-    return result;
-  }
-
-  function buildKeyEvent(self, evt) {
-    var keyboard = self.keyboard;
-
-    evt = evt || window.event || {};
-    // we don't really need these since controllers have this.context
-//    evt.context = self;
-//    evt.canvas = self.canvas;
-    keyboard.last = evt;
-
-    /*
-    TODO track all keypresses and whatnot via @keyboard, so all keys can be queried at any given time
-     */
-
-    return evt;
-  }
-  
-  function fixEvent(event) {
-    // this borrowed from jQuery
-    // store a copy of the original event object
-		// and "clone" to set read-only properties
-		var originalEvent = event;
-		event = {type:originalEvent.type};
-		var props = "altKey attrChange attrName bubbles button cancelable charCode clientX clientY ctrlKey currentTarget data detail eventPhase fromElement handler keyCode layerX layerY metaKey newValue offsetX offsetY pageX pageY prevValue relatedNode relatedTarget screenX screenY shiftKey srcElement target toElement view wheelDelta which".split(" ");
-
-		for ( var i = props.length, prop; i; ) {
-			prop = props[ --i ];
-			event[ prop ] = originalEvent[ prop ];
-		}
-
-		// Fix target property, if necessary
-		if ( !event.target ) {
-			// Fixes #1925 where srcElement might not be defined either
-			event.target = event.srcElement || document;
-		}
-
-		// check if target is a textnode (safari)
-		if ( event.target.nodeType === 3 ) {
-			event.target = event.target.parentNode;
-		}
-
-		// Add relatedTarget, if necessary
-		if ( !event.relatedTarget && event.fromElement ) {
-			event.relatedTarget = event.fromElement === event.target ? event.toElement : event.fromElement;
-		}
-
-		// Calculate pageX/Y if missing and clientX/Y available
-		if ( event.pageX == null && event.clientX != null ) {
-			var eventDocument = event.target.ownerDocument || document,
-				doc = eventDocument.documentElement,
-				body = eventDocument.body;
-
-			event.pageX = event.clientX + (doc && doc.scrollLeft || body && body.scrollLeft || 0) - (doc && doc.clientLeft || body && body.clientLeft || 0);
-			event.pageY = event.clientY + (doc && doc.scrollTop  || body && body.scrollTop  || 0) - (doc && doc.clientTop  || body && body.clientTop  || 0);
-		}
-
-		// Add which for key events
-		if ( event.which == null && (event.charCode != null || event.keyCode != null) ) {
-			event.which = event.charCode != null ? event.charCode : event.keyCode;
-		}
-
-		// Add metaKey to non-Mac browsers (use ctrl for PC's and Meta for Macs)
-		if ( !event.metaKey && event.ctrlKey ) {
-			event.metaKey = event.ctrlKey;
-		}
-
-		// Add which for click: 1 === left; 2 === middle; 3 === right
-		// Note: button is not normalized, so don't use it
-		if ( !event.which && event.button !== undefined ) {
-			event.which = (event.button & 1 ? 1 : ( event.button & 2 ? 3 : ( event.button & 4 ? 2 : 0 ) ));
-		}
-
-		return event;
-  }
-
-  function buildMouseEvent(self, evt) {
-    var mouse = self.mouse;
-
-    evt = fixEvent(evt || window.event);
-    evt.context = self;
-    evt.canvas = self.canvas;
-    evt.offsetx = mouse.x;
-    evt.offsety = mouse.y;
-    evt.mouse = mouse;
-    
-    mouse.offsetx = evt.offsetx || 0;
-    mouse.offsety = evt.offsety || 0;
-
-    var cumulativeOffset = getCumulativeOffset(self.canvas);
-    mouse.x = evt.pageX - cumulativeOffset[0];
-    mouse.y = evt.pageY - cumulativeOffset[1];
-    mouse.y = self.canvas.height - mouse.y; // invert y
-
-    // calculate differences, useful for checking movement relative to last position
-    mouse.diffx = mouse.x - mouse.offsetx;
-    mouse.diffy = mouse.y - mouse.offsety;
-
-    // check for button presses
-    if (evt.type == "mousedown" || evt.type == "onmousedown") {
-      mouse.down = mouse.down || {count:0};
-      mouse.down["button"+evt.which] = {at:[mouse.x,mouse.y]};
-    } else if (evt.type == "mouseup" || evt.type == "onmouseup") {
-      if (mouse.down)
-      {
-        mouse.down.count--;
-        if (mouse.down.count <= 0) mouse.down = null;
-      }
-    }
-    
-    evt.x = mouse.x;
-    evt.y = mouse.y;
-    evt.diffx = mouse.diffx;
-    evt.diffy = mouse.diffy;
-    evt.down = mouse.down;
-
-    return evt;
-  }
-
-  function dispatchEvent(self, evt) {
-    var type = evt.type.toString();
-    if (type.indexOf("on") == 0) type = type.substring(2, type.length);
-    type = type.toLowerCase();
-    var target;
-    switch(type) {
-      case "click":     target = "mouse_clicked"; break;
-      case "mousemove":
-        if (evt.move_type == 'mousemove') target = "mouse_moved";
-        else                              target = "mouse_dragged";
-        break;
-      case "mousedown": target = "mouse_pressed"; break;
-      case "mouseout":  target = "mouse_exited";  break;
-      case "mouseover": target = "mouse_entered"; break;
-      case "mouseup":   target = "mouse_released";break;
-      case "keydown":   target = "key_pressed";   break;
-      case "keypress":  target = "key_typed";     break;
-      case "keyup":     target = "key_released";  break;
-      default: return true; // don't dispatch this event to the controller
-    }
-
-    if (self.current_controller[target]) {
-      var result = self.current_controller[target](evt);
-      if (result != undefined) return result;
-    }
-    return true;
-  }
-  
-  // Tag names which, when active, should cause key input to be IGNORED. The implication is that while
-  // one of these tags has focus, the user doesn't want to be controlling his character because s/he is
-  // trying to type something.
-  var ignoreKeyTagNames = [
-          'input', 'form', 'textarea', 'label', 'fieldset', 'legend', 'select', 'optgroup', 'option', 'button'
-  ];
-
-  return {
-    setupEventListeners: function() {
-      this.keyboard = {};
-      this.mouse = {};
-
-      var canvas = this.canvas;
-      var self = this;
-
-      var mousefunc     = function(evt) {
-        if (!self.current_controller) return;
-        evt = buildMouseEvent(self, evt);
-        return dispatchEvent(self, evt);
-      };
-      var mousemovefunc = function(evt) {
-        if (!self.current_controller) return;
-        evt = buildMouseEvent(self, evt);
-        if (self.mouse && self.mouse.down == null) // mouse is not being dragged
-          evt.move_type = "mousemove";
-        else
-          evt.move_type = "mousedrag";
-        return dispatchEvent(self, evt);
-      };
-      var keyfunc       = function(evt) {
-        if (evt.which) evt.str = String.fromCharCode(evt.which);
-        if (document.activeElement) {
-          if (ignoreKeyTagNames.indexOf(document.activeElement.tagName) != -1)
-          { // user is probably trying to type, so don't capture this input
-            return;
-          }
-        }
-        if (!self.current_controller) return;
-        evt = buildKeyEvent(self, evt);
-        return dispatchEvent(self, evt);
-      };
-
-      if (canvas.addEventListener) {
-        /* W3 */
-        canvas.addEventListener('click',     mousefunc,     false);
-        canvas.addEventListener('mousedown', mousefunc,     false);
-        canvas.addEventListener('mousemove', mousemovefunc, false);
-        canvas.addEventListener('mouseout',  mousefunc,     false);
-        canvas.addEventListener('mouseover', mousefunc,     false);
-        canvas.addEventListener('mouseup',   mousefunc,     false);
-        document.addEventListener('keydown',   keyfunc,       false);
-        document.addEventListener('keypress',  keyfunc,       false);
-        document.addEventListener('keyup',     keyfunc,       false);
-      } else {
-        /* IE */
-        canvas.attachEvent('onclick',     mousefunc    );
-        canvas.attachEvent('onmousedown', mousefunc    );
-        canvas.attachEvent('onmousemove', mousemovefunc);
-        canvas.attachEvent('onmouseout',  mousefunc    );
-        canvas.attachEvent('onmouseover', mousefunc    );
-        canvas.attachEvent('onmouseup',   mousefunc    );
-        document.attachEvent('onkeydown',   keyfunc      );
-        document.attachEvent('onkeypress',  keyfunc      );
-        document.attachEvent('onkeyup',     keyfunc      );
-      }
-    }
-  };
-})();

data/src/jax/geometry.js

@@ -1,7 +0,0 @@
-/**
- * Jax.Geometry
- * Namespace containing geometric classes and functions
- **/
-Jax.Geometry = {};
-
-//= require "geometry/plane"

data/src/jax/geometry/plane.js

@@ -1,113 +0,0 @@
-/**
- * class Jax.Geometry.Plane
- *
- * Represents a plane in 3 dimensions.
- *
- * Examples:
- *
- *     new Jax.Geometry.Plane([0,0,0], [0,1,0], [1,0,0]);
- *     new Jax.Geometry.Plane([[0,0,0], [0,1,0], [1,0,0]]);
- *     new Jax.Geometry.Plane();
- *
- **/
-Jax.Geometry.Plane = (function() {
-  function innerProduct(a, x, y, z) {
-    return (a[0]*x + a[1]*y + a[2]*z);
-  }
-
-  return Jax.Class.create({
-    initialize: function(points) {
-      if (points) this.set.apply(this, arguments);
-    },
-    
-    /**
-     * Jax.Geometry.Plane#set(points) -> Jax.Geometry.Plane
-     * - points (Array): an array of 3 vectors.
-     * Jax.Geometry.Plane#set(point0, point1, point2) -> Jax.Geometry.Plane
-     * - point0 (vec3): the first of 3 vectors.
-     * - point1 (vec3): the second of 3 vectors.
-     * - point2 (vec3): the third of 3 vectors.
-     * 
-     * Sets this plane's coefficients based off of a set of three 3D points.
-     *
-     * This plane is returned.
-     **/
-    set: function(points) {
-      if (arguments.length == 3) points = [arguments[0], arguments[1], arguments[2]];
-      
-      this.normal = vec3.create();
-      var vec = vec3.create();
-      vec3.subtract(points[1], points[0], this.normal);
-      vec3.subtract(points[2], points[0], vec);
-      vec3.cross(this.normal, vec, this.normal);
-      vec3.normalize(this.normal);
-      
-      this.point = points[1];
-      this.d = -innerProduct(this.normal, this.point[0], this.point[1], this.point[2]);
-      
-      return this;
-    },
-    
-    /**
-     * Jax.Geometry.Plane#setCoefficients(a, b, c, d) -> Jax.Geometry.Plane
-     *
-     * Sets the four coefficients A, B, C, D for this plane.
-     *
-     * Returns this plane.
-     **/
-    setCoefficients: function(a, b, c, d) {
-      var len = Math.sqrt(a*a+b*b+c*c);
-      this.normal[0] = a/len;
-      this.normal[1] = b/len;
-      this.normal[2] = c/len;
-      this.d = d/len;
-      return this;
-    },
-    
-    /**
-     * Jax.Geometry.Plane#distance(point) -> Number
-     * - point (vec3): A 3D vector. Can be any type with values for indices [0..2] (e.g. an Array).
-     *
-     * Given a 3D point, returns the distance from this plane to the point. The point is expected
-     * to lie in the same 3D space as this plane.
-     **/
-    distance: function(point)
-    {
-      var x, y, z;
-      if (arguments.length == 3) { x = arguments[0]; y = arguments[1]; z = arguments[2]; }
-      else { x = point[0]; y = point[1]; z = point[2]; }
-      // same as ax + by + cz + d
-      return this.d + innerProduct(this.normal, x, y, z);
-    },
-    
-    /**
-     * Jax.Geometry.Plane#whereis(point) -> Number
-     * - point (vec3): A 3D vector. Can be any type with values for indices [0..2] (e.g. an Array).
-     *
-     * Given a point in 3D space, returns one of the following values based on the position
-     * of the point relative to this plane:
-     *
-     *     Jax.Geometry.Plane.FRONT
-     *     Jax.Geometry.Plane.BACK
-     *     Jax.Geometry.Plane.INTERSECT
-     *
-     * FRONT represents a point lying somewhere in the direction of the plane's normal.
-     * BACK represents the opposite, and INTERSECT represents a point lying directly
-     * parallel to this plane.
-     *
-     * The point is expected to lie in the same 3D space as this plane.
-     **/
-    whereis: function(point)
-    {
-      if (arguments.length == 3) point = [arguments[0], arguments[1], arguments[2]];
-      var d = this.distance(point);
-      if (d > 0) return Jax.Geometry.Plane.FRONT;
-      if (d < 0) return Jax.Geometry.Plane.BACK;
-      return Jax.Geometry.Plane.INTERSECT;
-    }
-  });
-})();
-
-Jax.Geometry.Plane.FRONT     = 1;
-Jax.Geometry.Plane.BACK      = 2;
-Jax.Geometry.Plane.INTERSECT = 3;

data/src/jax/mvc/controller.js

@@ -1,195 +0,0 @@
-/**
- * class Jax.Controller
- * 
- * Controllers are a major component of the Jax framework, because they are in
- * charge of receiving input from the user, setting up a scene, tearing it down,
- * and deciding when is the right time to transition to a different controller.
- * 
- * Controllers need to be either registered with Jax.routes or invoked using
- * Jax.Controller.invoke(). They are not intended to be instantiated directly,
- * so you should avoid doing this in your code and instead rely on the route set.
- * 
- * Methods added to controllers are called actions. You can name actions whatever
- * you want, but some action names serve special purposes. They are as follows:
- * 
- *   * *index*          - called when the action name is omitted from a route.
- *   * *destroy*        - called when leaving the current controller.
- *   * *mouse_clicked*  - called when the mouse is clicked within the canvas.
- *   * *mouse_entered*  - called when the mouse enters the canvas.
- *   * *mouse_exited*   - called when the mouse exits the canvas.
- *   * *mouse_moved*    - called when the mouse is moved, unless a button is pressed.
- *   * *mouse_dragged*  - called when the mouse is moved while a button is pressed.
- *   * *mouse_pressed*  - called when a mouse button has been pressed.
- *   * *mouse_released* - called when a mouse button has been released.
- *   * *mouse_clicked*  - called when a mouse button has been clicked.
- *   * *key_pressed*    - called when a keyboard button has been pressed.
- *   * *key_released*   - called when a keyboard button has been released.
- *   * *key_typed*      - called when a keyboard button has been typed.
- *   * *update*         - called (approximately) every 60 milliseconds for as long
- *   as a controller is active. Time difference in seconds is passed as an arguments.
- *   
- * Example:
- * 
- *     var WelcomeController = Jax.Controller.Create("welcome", ApplicationController, {
- *       index: function() {
- *         // ...
- *       },
- *       
- *       mouse_clicked: function(event) {
- *         // ...
- *       },
- *       
- *       update: function(timechange) {
- *        // it's been [timechange] seconds since last update
- *       }
- *     });
- *
- * With the exception of event actions, which will be fired every time an event occurs,
- * controller actions are only triggered once for a given controller unless they
- * explicitly trigger other actions by calling them directly. They differ from their
- * corresponding views (see Jax.View) in this way, as a view is rendered many times
- * -- up to a target rate of 60 passes per second.
- *
- **/
-(function() {
-  var protected_instance_method_names = [
-    'initialize', 'toString', 'getControllerName', 'constructor', 'isKindOf', 'fireAction',
-    'eraseResult'
-  ];
-  
-  function is_protected(method_name) {
-    for (var i = 0; i < protected_instance_method_names.length; i++)
-      if (protected_instance_method_names[i] == method_name)
-        return true;
-    return false;
-  }
-  
-  Jax.Controller = (function() {
-    function setViewKey(self) {
-      self.view_key = self.getControllerName()+"/"+self.action_name;
-      self.rendered_or_redirected = true;
-    }
-    
-    return Jax.Class.create({
-      /**
-       * Jax.Controller#fireAction(action_name) -> Jax.Controller
-       *
-       * Erases the results of the last action, then calls the specified action. If it doesn't exist,
-       * an error is raised. Finally, unless the action redirects to a different action or renders
-       * a different action directly, the specified action becomes the focus of the current view.
-       *
-       * Returns this controller.
-       **/
-      fireAction: function(action_name) {
-        this.eraseResult();
-        this.action_name = action_name;
-
-        if (this[action_name])
-          this[action_name].call(this, []);
-        else throw new Error("Call to missing action: '"+action_name+"' in controller '"+this.getControllerName()+"'");
-        
-        if (!this.rendered_or_redirected)
-          setViewKey(this);
-        return this;
-      },
-      
-      /**
-       * Jax.Controller#eraseResults() -> Jax.Controller
-       *
-       * Erases the results of the most recent render action. That is, whether or not it rendered
-       * a different action or caused a redirect to a different action or controller is reset, and
-       * the current view is set to +null+, indicating that no view will be rendered.
-       *
-       * Returns this controller.
-       **/
-      eraseResult: function() {
-        this.rendered_or_redirected = false;
-        this.view_key = null;
-        return this;
-      }
-    });
-  })();
-
-  var controller_class_methods = {
-    /**
-     * Jax.Controller.invoke(action_name, context) -> Jax.Controller
-     * - action_name (String): The name of the action to fire after initialization
-     * - context (Jax.Context): The context to attach to the instantiated controller
-     *
-     * Creates a new instance of the specified controller, sets up its references to
-     * +this.context+, +this.world+, and so on; and finally, fires the action given by
-     * +action_name+.
-     *
-     * Returns the newly-constructed controller.
-     **/
-    invoke: function(action_name, context) {
-      var instance = new this();
-      instance.context = context;
-      instance.world = context && context.world;
-      instance.player = context && context.player;
-      instance.fireAction(action_name);
-      return instance;
-    }
-  };
-
-  /**
-   * Jax.Controller.create(controllerName, methods) -> Class
-   * Jax.Controller.create(controllerName, superclass, methods) -> Class
-   * - controllerName (String): the short name of this controller
-   * - superclass (Class): a parent class to inherit from
-   * - methods (Object): a set of methods to be added to the Class
-   * 
-   * The controllerName must be the short name of the controller, as represented
-   * in Jax.RouteSet. An example controller name for a WelcomeController would be
-   * "welcome".
-   * 
-   * If superclass is not given, Jax.Controller is used as the superclass instead.
-   * 
-   * The methods object follows the same structure as Prototype.
-   * 
-   * Example:
-   * 
-   *     var WelcomeController = Jax.Controller.Create("welcome", ApplicationController, {
-   *       index: function() {
-   *         // ...
-   *       },
-   *       
-   *       mouse_clicked: function(event) {
-   *         // ...
-   *       }
-   *     });
-   **/
-  Jax.Controller.create = function(controller_name, superclass, inner) {
-    if (typeof(controller_name) != "string")
-    {
-      inner = superclass;
-      superclass = controller_name;
-      controller_name = "generic";
-    }
-    
-    var klass;
-    if (inner) klass = Jax.Class.create(superclass,     inner);
-    else       klass = Jax.Class.create(Jax.Controller, superclass);
-    
-    /**
-     * Jax.Controller.getControllerName() -> String
-     *
-     * Returns the name of the controller in question, as it is represented in +Jax.routes+.
-     **/
-    Object.extend(klass, controller_class_methods);
-    Object.extend(klass, { getControllerName: function() { return controller_name; } });
-    klass.addMethods({getControllerName: function() { return controller_name; } });
-    
-    // we already know the controller name and all its actions, so may as well
-    // set up routing here.
-    for (var method_name in klass.prototype)
-    {
-      if (!is_protected(method_name)) {
-        // it's not a protected name, so treat it as an action
-        Jax.routes.map(controller_name+"/"+method_name, klass, method_name);
-      }
-    }
-
-    return klass;
-  };
-})();