jax 0.0.0.9 → 0.0.0.10

data/src/jax/webgl/texture.js

@@ -1,312 +0,0 @@
-Jax.NORMAL_MAP = 1;
-
-
-/**
- * class Jax.Texture
- * Creates a managed WebGL texture.
- **/
-Jax.Texture = (function() {
-  function imageFailed(self, image) {
-    throw new Error("Texture image '"+self.image.src+"' failed to load!");
-  }
-  
-  function isPoT(s) {
-    return s && (s & -s) == s;
-  }
-  
-  function imageLoaded(self, isImageArray, img) {
-    var onload = self.options.onload || self.onload;
-    
-    if (!isPoT(img.width) || !isPoT(img.height)) {
-      self.options.mag_filter = GL_LINEAR;
-      self.options.min_filter = GL_LINEAR;
-      self.options.wrap_s = GL_CLAMP_TO_EDGE;
-      self.options.wrap_t = GL_CLAMP_TO_EDGE;
-      self.options.generate_mipmap = false;
-    }
-
-    if (!isImageArray) {
-      if (onload) onload.call(self, self.image);
-      self.loaded = true;
-    } else {
-      self.images.load_count++;
-      if (self.images.load_count == self.images.length) {
-        /* all done */
-        if (onload) onload.call(self, self.image);
-        self.loaded = true;
-      }
-    }
-  }
-  
-  function build(self, context) {
-    self.handles[context.id] = context.glCreateTexture();
-  }
-  
-  function generateTexture(context, self) {
-    var data_type = self.options.data_type, format = self.options.format, target = self.options.target;
-    if (self.image) {
-      switch(target) {
-        case GL_TEXTURE_2D:
-          context.glTexImage2D(target, 0, format, format, data_type, self.image);
-          break;
-        case GL_TEXTURE_CUBE_MAP:
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_POSITIVE_X, 0, format, format, data_type, self.image);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_POSITIVE_Y, 0, format, format, data_type, self.image);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_POSITIVE_Z, 0, format, format, data_type, self.image);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_NEGATIVE_X, 0, format, format, data_type, self.image);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, 0, format, format, data_type, self.image);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_NEGATIVE_Z, 0, format, format, data_type, self.image);
-          break;
-        default: throw new Error("Unexpected texture target "+target+"; use GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP");
-      }
-    } else if (self.images) {
-      switch(target) {
-        case GL_TEXTURE_2D:
-          context.glTexImage2D(target, 0, format, format, data_type, self.images[0]);
-          break;
-        case GL_TEXTURE_CUBE_MAP:
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_POSITIVE_X, 0, format, format, data_type, self.images[GL_TEXTURE_CUBE_MAP_POSITIVE_X] || self.images[0]);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_POSITIVE_Y, 0, format, format, data_type, self.images[GL_TEXTURE_CUBE_MAP_POSITIVE_Y] || self.images[1]);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_POSITIVE_Z, 0, format, format, data_type, self.images[GL_TEXTURE_CUBE_MAP_POSITIVE_Z] || self.images[2]);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_NEGATIVE_X, 0, format, format, data_type, self.images[GL_TEXTURE_CUBE_MAP_NEGATIVE_X] || self.images[3]);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, 0, format, format, data_type, self.images[GL_TEXTURE_CUBE_MAP_NEGATIVE_Y] || self.images[4]);
-          context.glTexImage2D(GL_TEXTURE_CUBE_MAP_NEGATIVE_Z, 0, format, format, data_type, self.images[GL_TEXTURE_CUBE_MAP_NEGATIVE_Z] || self.images[5]);
-          break;
-        default: throw new Error("Unexpected texture target "+target+"; use GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP");
-      }
-    } else {
-      // no images at all -- load the texture with empty data; it's probably for a framebuffer
-      var width = self.options.width, height = self.options.height;
-      if (!width || !height) throw new Error("Can't build an empty texture without at least a width and height");
-      
-      function ti2d(glEnum) {
-        try {
-          context.glTexImage2D(glEnum, 0, format, width, height, 0, format, GL_UNSIGNED_BYTE, null);
-        } catch (e) {
-          var tex = new Uint8Array(width*height*Jax.Util.sizeofFormat(format));
-          context.glTexImage2D(glEnum, 0, format, width, height, 0, format, GL_UNSIGNED_BYTE, tex);
-        }
-      }
-      
-      switch(target) {
-        case GL_TEXTURE_2D:
-          ti2d(GL_TEXTURE_2D);
-          break;
-        case GL_TEXTURE_CUBE_MAP:
-          ti2d(GL_TEXTURE_CUBE_MAP_POSITIVE_X);
-          ti2d(GL_TEXTURE_CUBE_MAP_POSITIVE_Y);
-          ti2d(GL_TEXTURE_CUBE_MAP_POSITIVE_Z);
-          ti2d(GL_TEXTURE_CUBE_MAP_NEGATIVE_X);
-          ti2d(GL_TEXTURE_CUBE_MAP_NEGATIVE_Y);
-          ti2d(GL_TEXTURE_CUBE_MAP_NEGATIVE_Z);
-          break;
-        default: throw new Error("Unexpected texture target "+target+"; use GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP");
-      }
-    }
-  }
-  
-  /* pushLevel/popLevel are used for automatic management of glActiveTexture's.
-    The general concept is that you can do something like:
-    
-      tex1.bind(context, function() {
-        tex2.bind(context, function() {
-          // render stuff.
-          // tex1 => GL_TEXTURE0, tex1.textureLevel => 0
-          // tex2 => GL_TEXTURE1, tex2.textureLevel => 1
-          
-          tex3.bind(context, 5, function() {
-            // tex3 => GL_TEXTURE5, tex3.textureLevel => 5
-          });
-        });
-      });
-   */
-  function pushLevel(self, level, context) {
-    if (level == null) level = Jax.Texture._level++;
-    self.textureLevel = level;
-    context.glActiveTexture(GL_TEXTURES[level]);
-  }
-  
-  function popLevel(self, context) {
-    Jax.Texture._level = self.textureLevel - 1;
-    if (Jax.Texture._level < 0) Jax.Texture._level = 0;
-    delete self.textureLevel;
-  }
-  
-  return Jax.Class.create({
-    /**
-     * new Jax.Texture(url[, options])
-     * - url (String): the URL or relative path to the image to be loaded.
-     * - options (Object): a generic object optionally consisting of the following properties:
-     * new Jax.Texture(urls[, options])
-     * - urls (Array): an array of URLs or relative paths to the images to be loaded. This is intended
-     *                 for use with cube maps. If used with a cube map, 6 paths must be provided.
-     *                 If used with a standard 2D texture, only the first path in the array will be used.
-     * - options (Object): a generic object optionally consisting of the following properties:
-     * new Jax.Texture(options)
-     * - options (Object): a generic object optionally consisting of the following properties, plus a mandatory
-     *                     _width_ and _height_ in pixels:
-     * 
-     *   * min_filter: GL_NEAREST
-     *   * mag_filter: GL_NEARETS
-     *   * generate_mipmap: true
-     *   * mipmap_hint: GL_DONT_CARE
-     *   * format: GL_RGBA
-     *   * target: GL_TEXTURE_2D
-     *   * data_type: GL_UNSIGNED_BYTE
-     *   * wrap_s: GL_REPEAT
-     *   * wrap_t: GL_REPEAT
-     *   * flip_y: false
-     *   * premultiply_alpha: false
-     *   * colorspace_conversion: true
-     *   * onload: null - a function to be called after the image has been loaded. This function
-     *                    will not be called if the image fails to load.
-     *                     
-     **/
-    initialize: function(path_or_array, options) {
-      this.handles = {};
-      this.loaded = false;
-      this.valid = [];
-      
-      if (!options && typeof(path_or_array) == "object" && path_or_array.length == undefined) {
-        options = path_or_array;
-        path_or_array = options.path || null;
-        delete options.path;
-      }
-      
-      var self = this;
-      this.options = Jax.Util.normalizeOptions(options, {
-        min_filter: GL_NEAREST,
-        mag_filter: GL_NEAREST,
-        generate_mipmap: true,
-        mipmap_hint: GL_DONT_CARE,
-        format: GL_RGBA,
-        target: GL_TEXTURE_2D,
-        data_type: GL_UNSIGNED_BYTE,
-        wrap_s: GL_REPEAT,
-        wrap_t: GL_REPEAT,
-        flip_y: false,
-        premultiply_alpha: false,
-        colorspace_conversion: true,
-        onload: null
-      });
-      
-      var i;
-      var enums = ['min_filter', 'mag_filter', 'mipmap_hint', 'format', 'target', 'data_type', 'wrap_s', 'wrap_t'];
-      for (i = 0; i < enums.length; i++)
-        if (typeof(this.options[enums[i]]) == "string")
-          this.options[enums[i]] = window[this.options[enums[i]]];
-
-      if (path_or_array) {
-        if (typeof(path_or_array) == "string") {
-          this.image = new Image();
-          this.image.onload = function() { imageLoaded(self, false, this); };
-          this.image.onerror = this.image.onabort = function() { imageFailed(self, this); };
-          this.image.src = path_or_array;
-        } else {
-          var onload = function() { imageLoaded(self, true, this); };
-          this.images = [];
-          this.images.load_count = 0;
-          for (i = 0; i < path_or_array.length; i++) {
-            this.images[i] = new Image();
-            this.images[i].onload = onload;
-            this.images[i].onerror = this.images[i].onabort = function() { imageFailed(self, this); };
-            this.images[i].src = path_or_array[i];
-          }
-        }
-      }
-      else {
-        // nothing to load
-        this.options.generate_mipmap = !!(options && options.generate_mipmap);
-        this.loaded = true;
-      }
-    },
-    
-    getTarget: function() { return this.options.target; },
-    getMinFilter: function() { return this.options.min_filter; },
-    getMagFilter: function() { return this.options.mag_filter; },
-    getGeneratesMipmaps: function() { return this.options.generate_mipmap; },
-    getMipmapHint: function() { return this.options.mipmap_hint; },
-    getFormat: function() { return this.options.format; },
-    getDataType: function() { return this.options.data_type; },
-    getWrapS: function() { return this.options.wrap_s; },
-    getWrapT: function() { return this.options.wrap_t; },
-    getFlipY: function() { return this.options.flip_y; },
-    getPremultipliesAlpha: function() { return this.options.premultiply_alpha; },
-    getDoesColorspaceConversion: function() { return this.options.colorspace_conversion; },
-    getOnloadFunc: function() { return this.options.onload; },
-    
-    refresh: function(context) {
-      if (!this.ready()) return;
-      
-      context.glBindTexture(this.options.target, this.getHandle(context));
-      generateTexture(context, this);
-      context.glTexParameteri(this.options.target, GL_TEXTURE_MAG_FILTER, this.options.mag_filter);
-      context.glTexParameteri(this.options.target, GL_TEXTURE_MIN_FILTER, this.options.min_filter);
-      context.glTexParameteri(this.options.target, GL_TEXTURE_WRAP_S, this.options.wrap_s);
-      context.glTexParameteri(this.options.target, GL_TEXTURE_WRAP_T, this.options.wrap_t);
-      context.glPixelStorei(GL_UNPACK_FLIP_Y_WEBGL, this.options.flip_y);
-      context.glPixelStorei(GL_UNPACK_PREMULTIPLY_ALPHA_WEBGL, this.options.premultiply_alpha);
-      context.glPixelStorei(GL_UNPACK_COLORSPACE_CONVERSION_WEBGL, this.options.colorspace_conversion ? GL_BROWSER_DEFAULT_WEBGL : GL_NONE);
-      
-      if (this.options.generate_mipmap) {
-        this.generateMipmap(context);
-      }
-      
-      context.glBindTexture(this.options.target, null);
-      this.valid[context.id] = true;
-    },
-    
-    generateMipmap: function(context) {
-      // FIXME why does this raise 1280 invalid enum?
-//      context.glHint(GL_GENERATE_MIPMAP_HINT, this.options.mipmap_hint);
-      context.glGenerateMipmap(this.options.target);
-    },
-    
-    invalidate: function() { this.valid.clear(); },
-    
-    dispose: function(context) {
-      context.glDeleteTexture(getHandle(context));
-      delete this.handles[context.id];
-    },
-    
-    getHandle: function(context) {
-      if (!this.handles[context.id]) {
-        build(this, context);
-        this.refresh(context);
-      }
-      return this.handles[context.id];
-    },
-    
-    isValid: function(context) {
-      return !!this.valid[context.id];
-    },
-    
-    bind: function(context, level, callback) {
-      if (!this.ready()) return; // no texture to display, yet... but not worth crashing over.
-      if (!this.isValid(context)) this.refresh(context);
-      
-      if (typeof(level) == "number")
-        pushLevel(this, level, context);
-      else if (typeof(level) == "function") { callback = level; pushLevel(this, null, context); }
-      
-      context.glBindTexture(this.options.target, this.getHandle(context));
-      if (callback)
-      {
-        callback.call(this, this.textureLevel);
-        this.unbind(context);
-      }
-    },
-    
-    unbind: function(context) {
-      if (this.textureLevel != undefined) context.glActiveTexture(GL_TEXTURES[this.textureLevel]);
-      context.glBindTexture(this.options.target, null);
-      popLevel(this, context);
-    },
-    
-    ready: function() {
-      return this.loaded;
-    }
-  });
-})();
-
-Jax.Texture._level = 0;

data/src/jax/webgl/world.js

@@ -1,240 +0,0 @@
-//= require "scene"
-
-/**
- * class Jax.World
- * 
- * A +Jax.World+ represents a scene in the graphics engine. All objects to be rendered (or at least,
- * all objects that you do not want to manually control!) should be added to the world. Each instance
- * of +Jax.Context+ has its own +Jax.World+, and the currently-active +Jax.World+ is delegated into
- * controllers and views as the +this.world+ property.
- *
- **/
-Jax.World = (function() {
-  function getPickBuffer(self) {
-    if (self.pickBuffer) return self.pickBuffer;
-    return self.pickBuffer = new Jax.Framebuffer({
-      width:self.context.canvas.width,
-      height:self.context.canvas.height
-    });
-  }
-  
-  return Jax.Class.create({
-    initialize: function(context) {
-      this.context  = context;
-      this.lighting = new Jax.Scene.LightManager(context);
-      this.objects  = [];
-      this.shadow_casters = [];
-    },
-    
-    /**
-     * Jax.World#addLightSource(light) -> Jax.Scene.LightSource
-     * - light (Jax.Scene.LightSource) : the instance of Jax.Scene.LightSource to add to this world.
-     *
-     * Adds the light to the world and then returns the light itself unchanged.
-     **/
-    addLightSource: function(light)   { this.lighting.add(light); },
-    
-    /**
-     * Jax.World#addObject(object) -> Jax.Model
-     * - object (Jax.Model) : the instance of Jax.Model to add to this world.
-     *
-     * Adds the model to the world and then returns the model itself unchanged.
-     *
-     **/
-    addObject: function(object) {
-      this.objects.push(object);
-      if (object.isLit() || object.isShadowCaster())
-        this.lighting.addObject(object);
-      return object;
-    },
-    
-    /**
-     * Jax.World#getObject(index) -> Jax.Model
-     * - index (Number) : the world index of this object
-     *
-     * Returns the object with the specified world index, or undefined.
-     **/
-    getObject: function(index) { return this.objects[index]; },
-    
-    /**
-     * Jax.World#removeObject(object_or_index) -> Jax.Model
-     * - object_or_index (Number|Jax.Model) : the model instance to remove, or its world index
-     *
-     * If the model or its index cannot be found, nothing happens and the return value is undefined.
-     * Otherwise, the object is removed from this World and then returned.
-     **/
-    removeObject: function(object_or_index) {
-      if (this.objects[object_or_index]) {
-        var obj = this.objects[object_or_index];
-        this.objects.splice(object_or_index, 1);
-        this.lighting.removeObject(obj);
-        return obj;
-      }
-      else
-        for (var i = 0; i < this.objects.length; i++)
-          if (this.objects[i] == object_or_index)
-          {
-            this.objects.splice(i, 1);
-            this.lighting.removeObject(this.objects[i]);
-            return this.objects[i];
-          }
-    },
-    
-    /**
-     * Jax.World#pickRegionalIndices(x1, y1, x2, y2[, ary]) -> Array
-     * - x1 (Number): the screen X coordinate of the first corner of the 2D rectangle within which to pick
-     * - y1 (Number): the screen Y coordinate of the first corner of the 2D rectangle within which to pick
-     * - x2 (Number): the screen X coordinate of the second corner of the 2D rectangle within which to pick
-     * - y2 (Number): the screen Y coordinate of the second corner of the 2D rectangle within which to pick
-     * - ary (Array): an optional array to populate. A new one will be created if this is not specified.
-     *                (Note: the array's contents will be cleared.)
-     * 
-     * Picks all visible object indices within the specified rectangular regions and returns them as elements in
-     * an array.
-     *
-     * An object's index matches its position in the world's object list. That is, the following code is
-     * valid:
-     *
-     *     this.world.getObjects(this.world.pickRegionalIDs(0,0, 100,100));
-     *
-     **/
-    pickRegionalIndices: function(x1, y1, x2, y2, ary) {
-      var w = Math.abs(x2 - x1), h = Math.abs(y2 - y1);
-      if (ary) ary.clear();
-      else ary = new Array();
-      var world = this, pickBuffer = getPickBuffer(this), context = this.context;
-      var data = new Uint8Array(w*h*4);
-
-      pickBuffer.bind(context, function() {
-        pickBuffer.viewport(context);
-         context.glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
-         context.glDisable(GL_BLEND);
-         world.render({material:"picking"});
-         // read it back in
-         context.glReadPixels(x1, y1, w, h, GL_RGBA, GL_UNSIGNED_BYTE, data);
-         if (data.data) data = data.data;
-      });
-      
-      // restore the visible viewport and blending
-      context.glViewport(0, 0, context.canvas.width, context.canvas.height);
-      context.glEnable(GL_BLEND);
-      
-      var index;
-      for (var i = 2; i < data.length; i += 4) {
-        if (data[i] > 0) { // blue key exists, we've found an object
-          index = Jax.Util.decodePickingColor(data[i-2], data[i-1], data[i], data[i+1]);
-          if (index != undefined) {
-            ary.push(index);
-          }
-        }
-      }
-      
-      return ary;
-    },
-    
-    /**
-     * Jax.World#pickRegion(x1, y1, x2, y2) -> Array
-     * - x1 (Number): the screen X coordinate of the first corner of the 2D rectangle within which to pick
-     * - y1 (Number): the screen Y coordinate of the first corner of the 2D rectangle within which to pick
-     * - x2 (Number): the screen X coordinate of the second corner of the 2D rectangle within which to pick
-     * - y2 (Number): the screen Y coordinate of the second corner of the 2D rectangle within which to pick
-     * - ary (Array): an optional array to populate. A new one will be created if this is not specified.
-     *                (Note: the array's contents will be cleared.)
-     *
-     * Picks all visible objects within the specified rectangular regions and returns them as elements in
-     * an array.
-     **/
-    pickRegion: function(x1, y1, x2, y2, ary) {
-      var result = this.pickRegionalIndices(x1, y1, x2, y2);
-      for (var i = 0; i < result.length; i++)
-        result[i] = this.getObject(i);
-      return result;
-    },
-    
-    /**
-     * Jax.World#pickIndex(x, y) -> Number | undefined
-     * - x (Number): the screen X coordinate to pick at
-     * - y (Number): the screen Y coordinate to pick at
-     *
-     * Picks the visible object at the specified position and returns its index as used by
-     * +Jax.World#getObject+. If no object is visible at the given position, the special value
-     * +undefined+ is returned.
-     **/
-    pickIndex: function(x, y) {
-      this._pick_ary = this._pick_ary || new Array();
-      return this.pickRegionalIndices(x, y, x+1, y+1, this._pick_ary)[0];
-    },
-    
-    /**
-     * Jax.World#pick(x, y) -> Jax.Model | undefined
-     * - x (Number): the screen X coordinate to pick at
-     * - y (Number): the screen Y coordinate to pick at
-     *
-     * Picks the visible object at the specified position and returns it. If no object is visible
-     * at the given position, the special value +undefined+ is returned.
-     **/
-    pick: function(x, y) {
-      var index = this.pickIndex(x, y);
-      if (index != undefined)
-        return this.getObject(index);
-      return index;
-    },
-    
-    /**
-     * Jax.World#countObjects() -> Number
-     * Returns the number of objects currently registered with this World.
-     **/
-    countObjects: function() {
-      return this.objects.length;
-    },
-    
-    getShadowCasters: function() { return this.lighting.getShadowCasters(); },//return this.shadow_casters; },
-    
-    render: function(options) {
-      var i;
-      
-      /* this.current_pass is used by the material */
-
-      this.context.current_pass = Jax.Scene.AMBIENT_PASS;
-      this.context.glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
-      var unlit = Jax.Util.normalizeOptions(options, {unlit:true});
-      
-      if (this.lighting.isEnabled() && (!unlit.material || unlit.material.supportsLighting())) {
-        /* ambient pass - unlit objects only because lit objects get ambient+diffuse+specular in one pass */
-        for (i = 0; i < this.objects.length; i++)
-          if (!this.objects[i].isLit()) {
-            unlit.model_index = i;
-            this.objects[i].render(this.context, unlit);
-          }
-      
-        /* illumination pass */
-        this.context.current_pass = Jax.Scene.ILLUMINATION_PASS;
-        this.lighting.illuminate(this.context, options);
-      } else {
-        for (i = 0; i < this.objects.length; i++) {
-          unlit.model_index = i;
-          this.objects[i].render(this.context, unlit);
-        }
-      }
-    },
-    
-    update: function(timechange) {
-      for (var i = this.objects.length-1; i >= 0; i--)
-        if (this.objects[i].update)
-          this.objects[i].update(timechange);
-    },
-      
-    dispose: function() {
-      var i, o;
-      
-      for (i = this.objects.length-1; i >= 0; i--)
-      /*
-        actually, we may not want to dispose the objects just yet. What if the user has a handle to them?
-        Maybe better to let JS GC take care of this one.
-      */
-        (o = this.objects.pop());// && o.dispose();
-      
-      this.lighting = new Jax.Scene.LightManager(this.context);
-    }
-  });
-})();