jax 1.1.1 → 2.0.0

data/features/step_definitions/web_steps.rb

@@ -0,0 +1,223 @@
+# TL;DR: YOU SHOULD DELETE THIS FILE
+#
+# This file was generated by Cucumber-Rails and is only here to get you a head start
+# These step definitions are thin wrappers around the Capybara/Webrat API that lets you
+# visit pages, interact with widgets and make assertions about page content.
+#
+# If you use these step definitions as basis for your features you will quickly end up
+# with features that are:
+#
+# * Hard to maintain
+# * Verbose to read
+#
+# A much better approach is to write your own higher level step definitions, following
+# the advice in the following blog posts:
+#
+# * http://benmabey.com/2008/05/19/imperative-vs-declarative-scenarios-in-user-stories.html
+# * http://dannorth.net/2011/01/31/whose-domain-is-it-anyway/
+# * http://elabs.se/blog/15-you-re-cuking-it-wrong
+#
+
+
+require 'uri'
+require 'cgi'
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "support", "paths"))
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "support", "selectors"))
+
+module WithinHelpers
+  def with_scope(locator)
+    locator ? within(*selector_for(locator)) { yield } : yield
+  end
+end
+World(WithinHelpers)
+
+# Single-line step scoper
+When /^(.*) within (.*[^:])$/ do |step, parent|
+  with_scope(parent) { When step }
+end
+
+# Multi-line step scoper
+When /^(.*) within (.*[^:]):$/ do |step, parent, table_or_string|
+  with_scope(parent) { When "#{step}:", table_or_string }
+end
+
+Given /^(?:|I )am on (.+)$/ do |page_name|
+  visit path_to(page_name)
+end
+
+When /^(?:|I )go to (.+)$/ do |page_name|
+  visit path_to(page_name)
+end
+
+When /^(?:|I )press "([^"]*)"$/ do |button|
+  click_button(button)
+end
+
+When /^(?:|I )follow "([^"]*)"$/ do |link|
+  click_link(link)
+end
+
+When /^(?:|I )fill in "([^"]*)" with "([^"]*)"$/ do |field, value|
+  fill_in(field, :with => value)
+end
+
+When /^(?:|I )fill in "([^"]*)" for "([^"]*)"$/ do |value, field|
+  fill_in(field, :with => value)
+end
+
+# Use this to fill in an entire form with data from a table. Example:
+#
+#   When I fill in the following:
+#     | Account Number | 5002       |
+#     | Expiry date    | 2009-11-01 |
+#     | Note           | Nice guy   |
+#     | Wants Email?   |            |
+#
+# TODO: Add support for checkbox, select og option
+# based on naming conventions.
+#
+When /^(?:|I )fill in the following:$/ do |fields|
+  fields.rows_hash.each do |name, value|
+    When %{I fill in "#{name}" with "#{value}"}
+  end
+end
+
+When /^(?:|I )select "([^"]*)" from "([^"]*)"$/ do |value, field|
+  select(value, :from => field)
+end
+
+When /^(?:|I )check "([^"]*)"$/ do |field|
+  check(field)
+end
+
+When /^(?:|I )uncheck "([^"]*)"$/ do |field|
+  uncheck(field)
+end
+
+When /^(?:|I )choose "([^"]*)"$/ do |field|
+  choose(field)
+end
+
+When /^(?:|I )attach the file "([^"]*)" to "([^"]*)"$/ do |path, field|
+  attach_file(field, File.expand_path(path))
+end
+
+Then /^(?:|I )should see "([^"]*)"$/ do |text|
+  if page.respond_to? :should
+    page.should have_content(text)
+  else
+    assert page.has_content?(text)
+  end
+end
+
+Then /^(?:|I )should see \/([^\/]*)\/$/ do |regexp|
+  regexp = Regexp.new(regexp)
+
+  if page.respond_to? :should
+    page.should have_xpath('//*', :text => regexp)
+  else
+    assert page.has_xpath?('//*', :text => regexp)
+  end
+end
+
+Then /^(?:|I )should not see "([^"]*)"$/ do |text|
+  if page.respond_to? :should
+    page.should have_no_content(text)
+  else
+    assert page.has_no_content?(text)
+  end
+end
+
+Then /^(?:|I )should not see \/([^\/]*)\/$/ do |regexp|
+  regexp = Regexp.new(regexp)
+
+  if page.respond_to? :should
+    page.should have_no_xpath('//*', :text => regexp)
+  else
+    assert page.has_no_xpath?('//*', :text => regexp)
+  end
+end
+
+Then /^(?:|I )should see an? "([^"]*)" element$/ do |element_name|
+  page.should have_xpath("//#{element_name}")
+end
+
+Then /^(?:|I )should see an? "([^"]*)" element with attribute "([^"]*)" equal to "([^"]*)"$/ do |element_name, attribute_name, attribute_value|
+  page.should have_xpath("//#{element_name}[@#{attribute_name}='#{attribute_value}']")
+end
+
+Then /^(?:|I )should see an? "([^"]*)" element with attribute "([^"]*)" starting with "([^"]*)"$/ do |element_name, attribute_name, attribute_value|
+  page.should have_xpath("//#{element_name}[starts-with(@#{attribute_name},'#{attribute_value}')]")
+end
+
+Then /^the "([^"]*)" field(?: within (.*))? should contain "([^"]*)"$/ do |field, parent, value|
+  with_scope(parent) do
+    field = find_field(field)
+    field_value = (field.tag_name == 'textarea') ? field.text : field.value
+    if field_value.respond_to? :should
+      field_value.should =~ /#{value}/
+    else
+      assert_match(/#{value}/, field_value)
+    end
+  end
+end
+
+Then /^the "([^"]*)" field(?: within (.*))? should not contain "([^"]*)"$/ do |field, parent, value|
+  with_scope(parent) do
+    field = find_field(field)
+    field_value = (field.tag_name == 'textarea') ? field.text : field.value
+    if field_value.respond_to? :should_not
+      field_value.should_not =~ /#{value}/
+    else
+      assert_no_match(/#{value}/, field_value)
+    end
+  end
+end
+
+Then /^the "([^"]*)" checkbox(?: within (.*))? should be checked$/ do |label, parent|
+  with_scope(parent) do
+    field_checked = find_field(label)['checked']
+    if field_checked.respond_to? :should
+      field_checked.should be_true
+    else
+      assert field_checked
+    end
+  end
+end
+
+Then /^the "([^"]*)" checkbox(?: within (.*))? should not be checked$/ do |label, parent|
+  with_scope(parent) do
+    field_checked = find_field(label)['checked']
+    if field_checked.respond_to? :should
+      field_checked.should be_false
+    else
+      assert !field_checked
+    end
+  end
+end
+ 
+Then /^(?:|I )should be on (.+)$/ do |page_name|
+  current_path = URI.parse(current_url).path
+  if current_path.respond_to? :should
+    current_path.should == path_to(page_name)
+  else
+    assert_equal path_to(page_name), current_path
+  end
+end
+
+Then /^(?:|I )should have the following query string:$/ do |expected_pairs|
+  query = URI.parse(current_url).query
+  actual_params = query ? CGI.parse(query) : {}
+  expected_params = {}
+  expected_pairs.rows_hash.each_pair{|k,v| expected_params[k] = v.split(',')} 
+  
+  if actual_params.respond_to? :should
+    actual_params.should == expected_params
+  else
+    assert_equal expected_params, actual_params
+  end
+end
+
+Then /^show me the page$/ do
+  save_and_open_page
+end

data/features/support/env.rb

@@ -0,0 +1,75 @@
+require 'bundler/setup'
+require 'jax'
+require 'jax/rails/application'
+
+# this will cause warnings but is necessary to ensure the #to_prepare blocks fire on each request.
+# note that since we are not (currently) using ActiveRecord, the warning can be ignored.
+Jax::Rails::Application.config.cache_classes = false
+
+# IMPORTANT: it is necessary to set this _prior_ to app initialization in order to pick up asset dirs
+::Rails.application.config.root = File.expand_path("../../tmp/rails-cukes", File.dirname(__FILE__))
+
+Jax::Rails::Application.initialize!
+
+require 'cucumber/rails/action_controller'
+
+if defined?(ActiveRecord::Base)
+  require 'rails/test_help'
+else
+  require 'action_dispatch/testing/test_process'
+  require 'action_dispatch/testing/integration'
+end
+
+if !Rails.application.config.cache_classes
+  warn "WARNING: You have set Rails' config.cache_classes to false (most likely in config/environments/cucumber.rb).  This setting is known to cause problems with database transactions. Set config.cache_classes to true if you want to use transactions.  For more information see https://rspec.lighthouseapp.com/projects/16211/tickets/165."
+end
+
+require 'cucumber/rails/world'
+require 'cucumber/rails/hooks'
+require 'cucumber/rails/capybara'
+
+require 'cucumber/web/tableish'
+
+World(Jax::Engine.routes.url_helpers)
+
+# Capybara defaults to XPath selectors rather than Webrat's default of CSS3. In
+# order to ease the transition to Capybara we set the default here. If you'd
+# prefer to use XPath just remove this line and adjust any selectors in your
+# steps to use the XPath syntax.
+Capybara.default_selector = :css
+
+# By default, any exception happening in your Rails application will bubble up
+# to Cucumber so that your scenario will fail. This is a different from how 
+# your application behaves in the production environment, where an error page will 
+# be rendered instead.
+#
+# Sometimes we want to override this default behaviour and allow Rails to rescue
+# exceptions and display an error page (just like when the app is running in production).
+# Typical scenarios where you want to do this is when you test your error pages.
+# There are two ways to allow Rails to rescue exceptions:
+#
+# 1) Tag your scenario (or feature) with @allow-rescue
+#
+# 2) Set the value below to true. Beware that doing this globally is not
+# recommended as it will mask a lot of errors for you!
+#
+ActionController::Base.allow_rescue = false
+
+#### We're not using the DB at this time but may move toward it eventually.
+# begin
+#   DatabaseCleaner.strategy = :transaction
+# rescue NameError
+#   raise "You need to add database_cleaner to your Gemfile (in the :test group) if you wish to use it."
+# end
+
+# You may also want to configure DatabaseCleaner to use different strategies for certain features and scenarios.
+# See the DatabaseCleaner documentation for details. Example:
+#
+#   Before('@no-txn,@selenium,@culerity,@celerity,@javascript') do
+#     DatabaseCleaner.strategy = :truncation, {:except => %w[widgets]}
+#   end
+#
+#   Before('~@no-txn', '~@selenium', '~@culerity', '~@celerity', '~@javascript') do
+#     DatabaseCleaner.strategy = :transaction
+#   end
+#

data/features/support/paths.rb

@@ -0,0 +1,30 @@
+module NavigationHelpers
+  # Maps a name to a path. Used by the
+  #
+  #   When /^I go to (.+)$/ do |page_name|
+  #
+  # step definition in web_steps.rb
+  #
+  def path_to(page_name)
+    case page_name
+
+    when /^the home\s?page$/
+      '/'
+    
+    when /^the WebGL start page$/
+      url_for(Jax.config.webgl_start)
+
+    else
+      begin
+        page_name =~ /^the (.*) page$/
+        path_components = $1.split(/\s+/)
+        self.send(path_components.push('path').join('_').to_sym)
+      rescue NoMethodError, ArgumentError
+        raise "Can't find mapping from \"#{page_name}\" to a path.\n" +
+          "Now, go and add a mapping in #{__FILE__}"
+      end
+    end
+  end
+end
+
+World(NavigationHelpers)

data/features/support/rails_environment.rb

@@ -0,0 +1,3 @@
+require 'jax/testing/rails_environment'
+
+World(Jax::Testing::RailsEnvironment)

data/features/support/selectors.rb

@@ -0,0 +1,39 @@
+module HtmlSelectorsHelpers
+  # Maps a name to a selector. Used primarily by the
+  #
+  #   When /^(.+) within (.+)$/ do |step, scope|
+  #
+  # step definitions in web_steps.rb
+  #
+  def selector_for(locator)
+    case locator
+
+    when "the page"
+      "html > body"
+
+    # Add more mappings here.
+    # Here is an example that pulls values out of the Regexp:
+    #
+    #  when /^the (notice|error|info) flash$/
+    #    ".flash.#{$1}"
+
+    # You can also return an array to use a different selector
+    # type, like:
+    #
+    #  when /the header/
+    #    [:xpath, "//header"]
+
+    # This allows you to provide a quoted selector as the scope
+    # for "within" steps as was previously the default for the
+    # web steps:
+    when /^"(.+)"$/
+      $1
+
+    else
+      raise "Can't find mapping from \"#{locator}\" to a selector.\n" +
+        "Now, go and add a mapping in #{__FILE__}"
+    end
+  end
+end
+
+World(HtmlSelectorsHelpers)

data/features/support/setup.rb

@@ -0,0 +1,17 @@
+$cucumber_root = FileUtils.pwd
+
+Before do
+  FileUtils.rm_rf File.join($cucumber_root, "tmp/cache").to_s
+  Jax.reset_config!
+end
+
+Before("@rails") do
+  setup_rails_environment
+  create_directory "app/assets/jax/shaders"
+  route "mount Jax::Engine => '/'"
+end
+
+After do
+  # clear out cache since I can't seem to disable it entirely. (Anybody know why???)
+  FileUtils.rm_rf File.expand_path("../../tmp/cache", File.dirname(__FILE__))
+end

data/jax.gemspec

@@ -10,25 +10,32 @@ Gem::Specification.new do |s|
   s.email       = ["sinisterchipmunk@gmail.com"]
   s.homepage    = "http://jaxgl.com"
   s.summary     = %q{Framework for creating rich WebGL-enabled applications using JavaScript and Ruby}
-  s.description = %q{Framework for creating rich WebGL-enabled applications using JavaScript and Ruby}
+  s.description = %q{
+    Framework for creating rich WebGL-enabled applications using JavaScript and Ruby.
+    Can be used stand-alone to create static JavaScript documents, or integrated
+    seamlessly with Ruby on Rails to build dynamic WebGL applications.
+  }
 
-  s.add_dependency 'rake',          '~> 0.9.2'
-  s.add_dependency 'bundler',       '~> 1.0.15'
-  s.add_dependency "thor",          '~> 0.14.6'
-  s.add_dependency 'jasmine',       '~> 1.0.2.0'
-  s.add_dependency 'railties',      '~> 3.0.8'
-  s.add_dependency 'sprockets',     '~> 1.0.2'
-  s.add_dependency 'rest-client',   '~> 1.6.3'
-  s.add_dependency 'minitar',       '~> 0.5.3'
+  s.add_dependency 'rails',          '~> 3.1.0'
+  s.add_dependency 'jquery-rails',   '~> 1.0.13'
+  s.add_dependency 'jasmine',        '~> 1.0.2.0'
+  s.add_dependency 'rest-client',    '~> 1.6.3'
   
-  s.add_development_dependency 'coderay',   '~> 0.9.7'
-  s.add_development_dependency 'fakeweb',   '~> 1.3.0'
+  s.add_development_dependency 'rspec',          '~> 2.6.0'
+  s.add_development_dependency 'coffee-rails',   '~> 3.1.0'
+  s.add_development_dependency 'coderay',        '~> 0.9.7'
+  s.add_development_dependency 'sqlite3',        '~> 1.3.4'
+  s.add_development_dependency 'sass-rails',     '~> 3.1.0'
+  s.add_development_dependency 'uglifier',       '~> 1.0.2'
+  s.add_development_dependency 'genspec',        '~> 0.2.3'
+  s.add_development_dependency 'selenium-webdriver', '~> 2.9.1'
+  s.add_development_dependency 'fakeweb',        '~> 1.3.0'
   s.add_development_dependency 'ansi'
-  s.add_development_dependency 'turn'
+  s.add_development_dependency 'cucumber-rails', '~> 1.0.2'
     
   # required by guides
   s.add_development_dependency 'RedCloth',       '~> 4.2'
-  s.add_development_dependency 'w3c_validators', '~> 1.1.1'
+  s.add_development_dependency 'w3c_validators', '~> 1.2'
 
   # required by pdoc
   s.add_development_dependency 'treetop',   '~> 1.4.9'
@@ -36,11 +43,10 @@ Gem::Specification.new do |s|
 
   s.rubyforge_project = "jax"
 
-  # Don't include stuff used to build & document jax, the dist file is already built.
-  useless_files = `git ls-files -- public/* guides/* vendor/* src/* dist/* spec/example_app/* spec/*.js`.split("\n")
+  # Don't include stuff used to build & document jax, otherwise the gem will get huge
+  useless_files = `git ls-files -- public/* guides/*`.split("\n")
   
   s.files         = `git ls-files`.split("\n") - useless_files
-#                    `git ls-files -- spec/example_app/* public/images/*`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n") - useless_files
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]

data/lib/assets/javascripts/jax/anim_frame.js

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2010, Google Inc.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+
+/**
+ * Global#requestAnimFrame(callback, element) -> undefined
+ * - callback (Function): callback to be fired to initiate a render sequence
+ * - element (DOMElement): a DOM element to attach the animation state to
+ *
+ * Provides requestAnimationFrame in a cross browser way.
+ **/
+if (typeof(window) == "undefined") {
+  global.requestAnimFrame = (function() {
+    return global.requestAnimationFrame ||
+           global.webkitRequestAnimationFrame ||
+           global.mozRequestAnimationFrame ||
+           global.oRequestAnimationFrame ||
+           global.msRequestAnimationFrame ||
+           function(/* function FrameRequestCallback */ callback, /* DOMElement Element */ element) {
+             setTimeout(callback, 1000/60);
+           };
+  })();
+}
+else {
+  window.requestAnimFrame = (function() {
+    return window.requestAnimationFrame ||
+           window.webkitRequestAnimationFrame ||
+           window.mozRequestAnimationFrame ||
+           window.oRequestAnimationFrame ||
+           window.msRequestAnimationFrame ||
+           function(/* function FrameRequestCallback */ callback, /* DOMElement Element */ element) {
+             setTimeout(callback, 1000/60);
+           };
+  })();
+}
+

data/lib/assets/javascripts/jax/application.js

@@ -0,0 +1,16 @@
+/* Used by endpoints to pull in application-specific logic. */
+
+//= require "jax"
+//= require_everything_matching "helpers"
+//= require_everything_matching "models"
+//= require_everything_matching "views"
+//= require_everything_matching "controllers"
+//= require_everything_matching "shaders"
+//= require_everything_matching "resources"
+
+for (var shaderName in Jax._shader_data) {
+  if (!(Jax.shaders[shaderName] instanceof Jax.Shader)) {
+    var descriptor = Jax._shader_data[shaderName];
+    Jax.shaders[shaderName] = new Jax.Shader(descriptor);
+  }
+}

data/lib/assets/javascripts/jax/builtin/all.js

@@ -0,0 +1,21 @@
+/* meshes */
+//= require "jax/builtin/meshes/quad"
+//= require "jax/builtin/meshes/cube"
+//= require "jax/builtin/meshes/torus"
+//= require "jax/builtin/meshes/plane"
+//= require "jax/builtin/meshes/sphere"
+//= require "jax/builtin/meshes/teapot"
+
+//= require "shaders/texture/material"
+//= require "shaders/normal_map/material"
+//= require "shaders/shadow_map/material"
+//= require "shaders/depthmap/material"
+//= require "shaders/paraboloid/material"
+//= require "shaders/fog/material"
+//= require "shaders/picking/material"
+
+Jax.Material.create("basic");
+Jax.Material.create("default", {default_shader:'basic'});
+Jax.Material.create("depthmap", {default_shader:"depthmap"});
+Jax.Material.create("paraboloid-depthmap", {type:"Paraboloid",default_shader:"paraboloid",layers:[{type:"Depthmap"}]});
+Jax.Material.create("picking", {type:"Picking"});

data/lib/assets/javascripts/jax/builtin/meshes/cube.js

@@ -0,0 +1,83 @@
+/**
+ * class Jax.Mesh.Cube < Jax.Mesh
+ *
+ * Constructs a 6-sided Cube mesh.
+ *
+ * Options:
+ *
+ * * width : the width of the cube in units. Defaults to +size+.
+ * * height : the height of the cube in units. Defaults to +size+.
+ * * depth : the depth of the cube in units. Defaults to +size+.
+ * * size : a value to use for any of the other options if
+ * they are unspecified. Defaults to 1.0.
+ *
+ * Example:
+ *
+ *     new Jax.Mesh.Cube();                  //=> 1x1x1
+ *     new Jax.Mesh.Cube({size:2});          //=> 2x2x2
+ *     new Jax.Mesh.Cube({width:2});         //=> 2x1x1
+ *     new Jax.Mesh.Cube({width:2,depth:3}); //=> 2x1x3
+ *
+ **/
+Jax.Mesh.Cube = Jax.Class.create(Jax.Mesh, {
+  initialize: function($super, options) {
+    var size = options && options.size || 1.0;
+    options = Jax.Util.normalizeOptions(options, {
+      width: size,
+      depth: size,
+      height: size
+    });
+    this.draw_mode = GL_TRIANGLES;
+    $super(options);
+    
+    var w = options.width, h = options.height, d = options.depth;
+    this.sides = {};
+
+    this.sides.left = new Jax.Model({mesh: new Jax.Mesh.Quad(d, h)});
+    this.sides.left.camera.reorient([-1,0,0], [-w/2,0,0]);
+
+    this.sides.right = new Jax.Model({mesh: new Jax.Mesh.Quad(d, h)});
+    this.sides.right.camera.reorient([1,0,0], [w/2,0,0]);
+
+    this.sides.front = new Jax.Model({mesh: new Jax.Mesh.Quad(w, h)});
+    this.sides.front.camera.reorient([0,0,1], [0,0,d/2]);
+
+    this.sides.back = new Jax.Model({mesh: new Jax.Mesh.Quad(w, h)});
+    this.sides.back.camera.reorient([0,0,-1], [0,0,-d/2]);
+
+    this.sides.top = new Jax.Model({mesh: new Jax.Mesh.Quad(w, d)});
+    this.sides.top.camera.reorient([0,1,0], [0,h/2,0]);
+
+    this.sides.bottom = new Jax.Model({mesh: new Jax.Mesh.Quad(w, d)});
+    this.sides.bottom.camera.reorient([0,-1,0], [0,-h/2,0]);
+  },
+  
+  init: function(verts, colors, texes, norms) {
+    // we need to get each quad's vertices, but then transform them by the object's
+    // local transformation, which includes the position offset and direction.
+    
+    var matrix;
+    for (var i in this.sides)
+    {
+      var qverts = [], qcolor = [], qtex = [], qnorm = [];
+      this.sides[i].mesh.init(qverts, qcolor, qtex, qnorm, []);
+      matrix = this.sides[i].camera.getTransformationMatrix();
+
+      // unfortunately quads are rendered in triangle strips; we need to translate that
+      // into triangles, because there's no support at this time for ending one triangle
+      // strip and beginning another.
+      function push(verti) {
+        var i1 = verti*3, i2 = verti*3+1, i3 = verti*3+2;
+        var vert = mat4.multiplyVec3(matrix, [qverts[i1], qverts[i2], qverts[i3]]);
+        var norm = mat4.multiplyVec3(matrix, [qnorm[i1], qnorm[i2], qnorm[i3]]);
+        
+        verts.push(vert[0], vert[1], vert[2]);
+        norms.push(norm[0], norm[1], norm[2]);
+        if (qcolor.length != 0) colors.push(qcolor[verti*4], qcolor[verti*4+1], qcolor[verti*4+2], qcolor[verti*4+3]);
+        if (qtex.length != 0) texes. push(-qtex [verti*2], qtex[verti*2+1]);//, qtex [i3]);
+      }
+      push(0); push(1); push(2); // tri1
+      push(2); push(1); push(3); // tri2
+    }
+  }
+});