Changes

Jump to: navigation, search

Canvas3D JS Library

5,743 bytes removed, 19:42, 26 January 2014
no edit summary
{{Admon/obsolete}}
 
== Introduction ==
The Canvas 3D JS Libary (C3DL) is a javascript Javascript library that will make it easier to write 3D applications using canvas 3dWebGL. It will provide provides a set of math, scene, and 3d object classes to make the canvas more accessible for developers that want to develop 3D content in browser.
== Contributors ==
* Catherine Leung
* [[User:asalga | Andor Salga]]* Peter Callaghan* [[User:Pplam3 | Patrick Lam]] (Picking)* [[User:Jamesboston | James Boston]] (Garbage collection)* Mark Paruzel (CodeBot)
* Andrew Smith
* Chris Bishop (Javascript)* Andor SalgaJeremy Giberson* [[User:Pplam3 | Patrick Lam]] (Picking - Javascript)Joe Drew* [[User:Jamesboston | James Boston]] (Garbage collection)Matthew Postill 
== Downloads ==
You can get the extension from https://addons.mozilla.org/en-US/firefox/addon/7171 (use suckmenot@mailinator.com/bugmenot for authentication).
For the library, samples, and tutorials, go to [http://www.c3dl.org/c3DL.org].
== Links ==* [http://www.As of c3dl2.org Our Web Site]<!-- * [http://littlesvr.ca/canvas3d/blog/ Our blog] dead link -->* Our SVN Repo: svn://cdot.senecac.on0, our library uses WebGL.ca/canvas3d* [http://vlad Any WebGL enabled browser will be able to view our content.off To get a WebGL enabled browser see Tutorial 1 from our website and you do not need any addons.net/hg/canvas3d/ canvas3d source code] in Vlad's hg repo
== Related Resources ==For all older versions of c3dl, you will need the canvas 3D addon available here:* [httpYou can get the extension from https://wwwaddons.openglmozilla.org/documentation open gl documentation]* [http:en-US/firefox/nehe.gamedev.netaddon/ Nehe Tutorials on OpenGL]* [http://shape.cs.princeton7171 (use suckmenot@mailinator.edu/benchmarkcom/ bugmenot for authentication).off (object file format) format info]
== Prototype ==* [httpNOTE://img126It is HIGHLY recommended that you do not use the older version of our library but to use version 2.imageshack0 or higher.us/img126/3032/layoutqe4.jpg Canvas 3D API - Class Design]
== Canvas3D Helper Classes Links ==* [http://www.c3dl.org c3DL.org]* [http://github.com/cathyatseneca/c3dl GitHub Repo]* [svn://cdot.senecac.on.ca/canvas3d Old SVN Repo]* [http://en.wikipedia.org/wiki/C3DL Wikipedia page]
=== Scene Class ===
* IN PROGRESS
=== Math Helper =Related Resources ==* IN PROGRESS     == World Objects == === Shape Class ====== Primitive Class ====== Model Class ===[http://www.khronos.org/webgl/ Khronos WebGL]
== TO DO ==
* find out about exposing of open gl 1.1 calls** Should the OpenGL 1.1 calls be exposed to the Canvas3D web2.0 architecture. Mainly, for those functions that make 3D math easy (ie. gluLookAt, glMatrixMode, etc).== Documentation ==
== Bug List ==Documentation can be found on our website: [http://www.c3dl.org/index.php/documentation/ c3DL.org].
* Cube
** setDims function does change the vector holding the cube's dimensions but the vector is not used to change the actual size or shape of the cube.
** <del>the rotation function has a problem. I think its because the axis isn't being orthonormalized properly after a rotation. This is causing distortions and worse... it will eventually lead to an object's implosion/explosion. This can be very easily seen when you look increase the angular velocity. Definitely should be fixed.</del>
 
* Camera
** Added Sept 3, 2008 - The setLookat is broken when using the vector of ( 0, -1, 0 ). I haven't confirmed if this is intended functionality. ( Chris )
** When increasing or decreasing the X Axis for the camera's position it does move in the current direction but also starts to rotate around the vector (0,0,0).
** Rotate function is still broken
* Rendering
** <del>( The depth buffer is not working, objects aren't properly occluded.)[http://matrix.senecac.on.ca/~asalga/canvas3d/teapot.jpg teapot handle drawn after teapot body] The rendering of objects seems to be based on their order in the object list in the scene. The problem arises when a cube is behind another cube. The cube in the back should only have the parts showing drawn, however if this cube is drawn after the closer cube then the behind cube is drawn on top of the closer cube. Hard to describe.</del> FIX: Enabled the depth buffer and properly cleared the depth buffer by passing in the correct argument to clear(...)
** When I open main.js, then put the mac to sleep, then wake it up: i get a fast stream of js errors in the console, canvas warnings on the page, and no rendering is done.
* Linear Velocity
** <strike>Setting the Linear Velocity does not do anything.</strike>
* Cube
** <strike>setDims uses obsolete Vector function - setFromVector</strike>
* setLookAtPoint - May 14
** Objects at 0,0,0 are not displayed when setLookAtPoint is passed (0,0,0). However, if called with cam.setLookAtPoint(new Vector(0.0, 0.0, 0.00000001)) , it will work.
* Scene Object
** <del>Currently you can only have 1 scene. There is a global var called thisScn, does this reallly need to be global? Can it not be a local variable?</del> thisScn was made into a local variable call getScene() to get thisScn.
** Currently the scene cannot be resized. The 3d graph needed the scene to grow or shrink with respect to the table cell it was in. The needed functions has unofficially been added to a copy of Scene.js used only by the 3d graph demo.
** Add functions to start and stop animations ( start and stop the scene timer ).
** Callback functions for Update / Keyboard / Mouse can be set but cannot be unset.
* Primitive Object
** The render function uses obsolete Vector Functions.
** <del>All Get functions have obsolete Vector functions ex. getX()</del>
** <del>The update function has obsolete Vector function ( Multiply ).</del> obsolete code was replaced with new code.
* Textures
** <del>textures are not always displayed. Seems like textured object needs to be moving or at least another object in the scene needs to be moving.</del> FIX: Scene was rendering only one frame if nothing moved, but the textures are loaded after the scene is rendered, so objects were not textured. Now scene renders regardless if objects move or not.
** very strange bug, when creating a texture in ms paint and a the entire texture is one solid color, the browser will crash as soon as the image is loaded. If there is at least one pixel which is not the color of the 'solid color', there are no problems. Likely due to the format openGL is expecting the file to be.
** <del>not a bug, but the context should not be passed into the Texture's setTexture method.</del> Model.setTexture() changed.
** if two contexts are used, 2.0 and 1.1, textures in 1.1 don't appear.
* Model Object
** When applying a texture to a cube some of the faces are upside down.
** The primitive functions are not working. The update or render of the primitive object appears to not be called.
* General
** Currently attempts to use an 'out' variable to prevent memory allocations do not work. see [http://www.c3dl.org/index.php/c3dl-dev/more-memory-usage-improvements/ link]
== Ideas List ==
Here are the wishlist of things we want to be able to do with the library.... If you want something add it to the list.
* 3D Asteroids - Good use of Collision detection, animation, particles, camera work, both mouse and keyboard controls.
* 3D graphs
&nbsp;&nbsp;&nbsp;&nbsp;- :* Display social networks and their relationships<br />&nbsp;&nbsp;&nbsp;&nbsp;- :* Get earthquake Richter-scale values from a service and show graphs on a map<br />&nbsp;&nbsp;&nbsp;&nbsp;- :* Display 3D graphs beside one another, gas prices along stock market values<br />&nbsp;&nbsp;&nbsp;&nbsp;- :* 3D flowcharts<br />
* 3D Traceroute - graphical view of an IP's path across the internet. More details [http://www.c3dl.org/index.php/uncategorized/canvas3d-traceroute-idea/ in this blog post]
* 3D Canvas Racing Demo - like [http://www.tapper-ware.net/canvas3d/ this] but better, to show that it's both easier to use, more funcionality functionality is available, and runs much faster (hopefully)
* Molecule Viewer - Rotate 3D molecules. Similar to [http://www.worldofmolecules.com/3D/bcarotene_3d.htm this]
* Matrix - Query search engines for sites, chat logs, blogs, etc. and display all the text in a matrix-like fashion.
* Really fancy animation of a bar graph, with columns growing and arrow moving. Will be an instant hit with businessmenbusiness people. Usable as easy as [http://code.google.com/apis/chart/ google's toy]
[[Image:higherhigher.jpg]]
* multi-player network air hockey. Supports up to 8 players. Create an arena based on number of players . Each wall has a hole and a paddle that players can move left and right. A ball is randomly sent flying and each time it goes through a hole, the player loses a point. Lose 10 points and that player is eliminated. Last person alive wins.
=== Meeting Summaries === ====May 29====* 2 Player Online ChessFor next week:* Orbit camera can be used to orbit around the board.<br /> Mark: Add * Effects can be used to library and do some bug fixes based on change what Chris found Chris: Work on putting his apps on site Andrew: Work on making material the libraries work with shaders. Provide a method for detecting capability of client to pieces and board use a 2such as metal, wood, etc.0 context and switch<br /> Andor: was absent but will work on shaders ====June 04==== Mark:  Cathy: send andrew * Picking can be used to allow a simple model interface to play with. Add equivalent of hello world tutorial for library. Begin documentation Chris: * Release Version 2 of move the Type Gamepieces. New feature is vertical movement. Andrew: figure out how to load files form http:// in javascript to be able to load Either clicking on two tiles can move a piece or clicking on a model from the internet; piece and display then a model that's in some ascii format Andor:* Get textures applied to cubes (no uv's yet) in 1.1 contexttile can move the piece.<br />:* Investigate box skewing problem in 2.0 contextFurther research is needed to determine the best server-side language to use to share board state between players.<br />:* Get camera working in 2.0 contextAnimation can be achieved simply by setting velocities of pieces.<br />* Clean up shader code converter and upload to repo.  ====June 12====General goal: establish a format for models.0.3 release date goal: end of june. Cathy: Work on more tutorials involving keyboard and camera control. Look for bugs, document the functions Mark: test changes with the basic demo (especially involving 2.0 context) when changing rendering. Chris: studying for midterms Andrew: Fix the 2.0 rendering. Work on loading and displaying models. Give Andor some idea about the preffered format. Andor: figure out the model format, get model and texture working in 1.1 context, get texture working in 2.0 context(?) ====June 19====Cathy: continue on tutorials. Mark: Chris: back from Exams. Updated demo to use latest API. Working on adding vertical movement for the cubes. Andrew:
Andor: Add textures to benchmarking, get rendering in Model work with same file with different contexts, get Model scaling to work, fix bugs.
[[Category:Open Source Communities]]

Navigation menu