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.

== People Working On This Project Contributors==

* [[User:asalga | Andor Salga]]* Peter Callaghan* [[User:Pplam3 | Patrick Lam]] (Picking)* [[User:Jamesboston | James Boston]] (Garbage collection)* Mark Paruzel (CodeBot)

For the library, samples, and tutorials, go to [http://cs.senecacwww.onc3dl.caorg/~leung/canvas3d/canvas3d-0c3DL.2.0.xpi Andrew's patchorg] - this change to the canvas 3D extension allows the "simple" examples from Vlad's page to work with ati cards. This is intended for Windows only. Model viewer examples do not work yet.

== Links ==[http://littlesvrAs of c3dl 2.0, our library uses WebGL. Any WebGL enabled browser will be able to view our content. To get a WebGL enabled browser see Tutorial 1 from our website and you do not need any addons.ca/canvas3d/blog/ Our blog]

== 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/addon/nehe7171 (use suckmenot@mailinator.gamedevcom/bugmenot for authentication).net/ Nehe Tutorials on OpenGL]

== 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]

== Examples Links ==* INCOMPLETE[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 =Related Resources ==* IN PROGRESS === Math Helper ===* IN PROGRESS == Math Operations == === Vector Class ===A Vector basically describes a direction in the form of X, Y, and Z coordinates of a 3D world[http://www. Basic 3D math cannot exist without the utilization of spatial coordinates which the Vector Class encapsulateskhronos. The Vector Class will have the following members within it:org/webgl/ Khronos WebGL]

* Calculations** normalize() - '''Unit Normalization'''** dot() - '''Calculates the Dot ProductDocumentation can be found on our website: [http://www. Returns a number'''** length() - '''Returns the Length of Vector from (0, 0, 0)'''** lengthSq() - '''Returns the Squared value of Length'''** cross(vec) - '''Takes a Vector object and computes the Cross Product between the two valuesc3dl. Returns a Vector object that is the cross of the two'''** add(vec) - '''Takes a Vector object and adds its values to its own'''** subtract(vec) - '''Takes a Vector object and subtracts its values from its own'''** multiply(scalar) - '''Takes a number value and multiplies (x, y, z) by it'''** divide(scalar) - '''Takes a number value and divides (x, y, z) by it'''** isEqual(vec) - '''Takes a Vector object and compares it to its (x, y, z) valuesorg/index. Returns true if they match'''** multiplyByQuat(quat) - '''Takes a Quaternion and multiplies its orientation by (x, y, z)php/documentation/ c3DL.org]. It returns a new Vector orientation'''

==Ideas List = Matrix Class ===A Matrix Class is necessary to provide Matrix operations such as rotation, translation, and scaling to any point in the 3D world. It is composed of a 4x4 matrix of floating point values that can be applied to any Matrix operation. This matrix is stored in '''Row-Major''' format, meaning its first 4 values are in the first row. The Matrix Class has the following members:

* Getters** getMatrix() - '''Returns an array Here are the wishlist of 16 numbersthings we want to be able to do with the library.... Each value represents a location of If you want something add it to the matrix starting at the top left corner (Row-Major)'''list.

* Setters** setMatrix(newMatArray) 3D Asteroids - '''Takes an Array Good use of 16 numbers that represent the matrix in Row-Major format'''Collision detection, animation, particles, camera work, both mouse and keyboard controls.

* Calculations** identity() Solar System Explorer - '''Sets Pull the matrix up to be an identity matrix'''** transpose() - ''' Transposes the matrix to be in Column-Major format, positions of our planets from some sort of webservice and vice versa'''** inverse() - '''Calculates the Inverse of the matrix. Returns NULL if it failsdisplay them, else it returns an inverse matrix'''** determinant() - '''Returns a number that is the Matrices determinant'''** adjoint() - '''Returns the Hermitian transpose (Adjoint) of this matrix'''** multiplyByScalar(scalar) - '''Multiplies the values of the matrix by a number'''** divideByScalar(scalar) - '''Divides the values of the matrix by a number'''** multiplyByMatrix(mat) - '''Multiplies two matrices together. It returns a new matrix'''** multiplyByVector(vec) - '''Mutiplies the orientation of the matrix by the vector. This function returns the newly oriented Vector'''** addMatrix(mat) - '''Adds the values of two matrices together. It returns a new matrix'''** subtractMatrix(mat) - '''Subtracts the values of the two matricesallowing users to see their relative alignment. It return a new matrix'''

=== Quaternion Class ===* 3D graphsA Quaternion is a 4:* Display social networks and their relationships<br />:* Get earthquake Richter-Dimensional representation of an orientation. It consists of scale values from a unit-length axis service and an angle around that axis. It can function much like an orientation matrix but without the disadvantage of Gimble Lock. The Quaternion is stored as an array of 4 numbersshow graphs on a map<br />:* Display 3D graphs beside one another, represented in the order of (w, x, y, z). The Quaternion Class has the following membersgas prices along stock market values<br />:* 3D flowcharts<br />

* Getters** getW() 3D Traceroute - '''Returns the numerical W component graphical view of the Quaternion'''** getX() - ''an IP'Returns s path across the numerical X component of the Quaternion'''** getY() - '''Returns the numerical Y component of the Quaternion'''** getZ() internet. More details [http://www.c3dl.org/index.php/uncategorized/canvas3d- '''Returns the numerical Z component of the Quaternion'''** getMatrix() traceroute- '''Returns a Matrix object that reflects the orientation of the quaternion'''** getAxisAngle(axis, angle) - '''Takes idea/ in two values, a Vector object and a Number. Converts the orientation of the quaternion into an axis Vector and an angle around it'''this blog post]

* Setters** setFromQuat(quat) 3D Canvas Racing Demo - like [http://www.tapper- '''Sets ware.net/canvas3d/ this Quaternion with the same value as the one being passed in] but better, to show that it'''** setFromMatrixs both easier to use, more functionality is available, and runs much faster (mathopefully) - '''Creates a Quaternion orientation from the orientation of the Matrix object that is passed in'''

* Calculations** length() Molecule Viewer - '''Returns the length of the Quaternion'''** lengthSq() - '''Returns a number that represents the square of this Quaternion's length'''** addQuat(quat) - '''Takes a Quaternion object that will be added Rotate 3D molecules. Similar to [http://www.worldofmolecules.com/3D/bcarotene_3d.htm this Quaternion's internal (w, x, y, z) values'''** subtractQuat(quat) - '''Takes a Quaternion object where its values will be subtracted from this Quaternion's (w, x, y, z) values'''** multiplQuat(scalar) - '''Takes a number and multiplies its values by the Quaternion's (w, x, y, z) values'''** conjugate() - '''Returns a Quaternion that is this Quaternion's conjugate'''** dot(quat) - '''Takes a Quaternion and returns the Dot Product of the two'''** normalize() - '''Normalizes the quaternion'''** inverse() - '''Returns the inverse of this Quaternion''']

=== Pan Camera Class ===* INCOMPLETE3D Rubik's Cube

=== Fixed Camera Class ===* INCOMPLETEHouse Explorer/Designer - Load a mesh of a room or a house and allow users to navigate through the environment or design a room in a house.

=== Chase Camera Class ===* INCOMPLETE3D Photo Album - Download images and create a 3D photo album similar to [http://www.mypictures3d.com/images/screenshots/art_gallery/art4.jpg this].

=== Free Camera Class ===The Free Camera Class is a camera that can be translated and oriented. It cannot be attached to an item* Matrix - Query search engines for sites, chat logs, ratherblogs, it can be moved separately by the useretc. The camera also supports velocities (without friction) that are applied to and display all the object based on timetext in a matrix-like fashion. The Free Camera Class has the following Members:

* Getters** getPosition() - '''Returns a Vector Object that represents the position Really fancy animation of the Camera'''** getUp() - '''Returns a Vector Object that represents the orientation of Up''bar graph, with columns growing and arrow moving. Will be an instant hit with business people. Usable as easy as [http://code.google.com/apis/chart/ google's toy]** getDir() - '''Returns a Vector Object that is the direction the camera is facing'''** getLeft() - '''Returns a Vector Object that represents the orientation of Left'''** getLinearVel() - '''Returns a Vector that is the velocity that the camera is traveling at'''** getAngularVel() - '''Returns a Vector that contains the rotation velocity around the local (x, y, z) axis of the camera'''[[Image:higherhigher.jpg]]

* Setters** setPosition(vec) - '''Takes a Vector Generic model viewer application, with back/forward/index + zoom/rotate buttons that sets would download and display models from the camera's position'''** setLookAtPoint(vec) - '''Takes web. Would have to be able to convert 3dsmax models in JS. So a Vector that represents museum or such could just slap the point app on the camera will look at'''** setUpVector(vec) - '''Takes a vector that orients page and give it an array of URLs for the camera Up'''** setLinearVel(vec) - ''' Takes a vector that is the camera's linear velocity'''** setAngularVec(vec) - '''Takes a vector that represents the camera's rotational velocity around local (x, y, z) axis'''stuff to show.

* Other Functions** rotateOnAxis(axisPong. Should be fairly easy, angle) - '''Takes a vector and a number that represents a relative rotation we just need to code the camera's orientation'''** yaw(angle) - '''Takes a number that the camera will rotate around its Up vector'''** roll(angle) - '''Takes a number that the camera will rotate around its direction vector'''** pitch(angle) - '''Takes a number that the camera will rotate around its Left vector'''** update(timeElapsed) - '''Takes a number that represents the amount of milliseconds that passed since the last call to updatecollision detection. This function updates the position and rotation based on the set velocities'''