Changes

Jump to: navigation, search

Canvas3D JS Library

4,136 bytes removed, 20: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.
== People Working On This Project 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
* Jeremy Giberson
* Joe Drew
* Matthew Postill
 
== Downloads ==
NOTE: these downloads are mostly meant for in-house testing and not really polished. It may also only work on a specific platform only. please read the note regarding the download.
<BR>
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/nehe.gamedev.netaddon/ Nehe Tutorials on OpenGL]== Prototype ==* [http://img126.imageshack7171 (use suckmenot@mailinator.us/img126/3032com/layoutqe4bugmenot for authentication).jpg Canvas 3D API - Class Design]
== Examples ==* INCOMPLETENOTE: It is HIGHLY recommended that you do not use the older version of our library but to use version 2.0 or higher.
== 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 == Math Operations ==[http://www.khronos.org/webgl/ Khronos WebGL]
=== Vector Class ===
A Vector basically describes a direction in the form of X, Y, and Z coordinates of a 3D world. Basic 3D math cannot exist without the utilization of spatial coordinates which the Vector Class encapsulates. The Vector Class will have the following members within it:
* Getters** getX() - '''Retrieves the X value'''** getY() - '''Retrieves the Y value'''** getZ() - '''Retrieves the Z value'''== Documentation ==
* Setters** set(newX, newY, newZ) - '''This sets new (x, y, z) values to the Vector'''** setX(newX) - '''Takes a number value as the new value for X'''** setY(newY) - '''Takes a number value as the new value for Y'''** setZ(newZ) - '''Takes a number value as the new value for Z'''** setFromVector(vec) - '''Takes a Vector object as the new value for this Vector'''Documentation can be found on our website: [http://www.c3dl.org/index.php/documentation/ c3DL.org].
* Calculations
** normalize() - '''Unit Normalization'''
** dot() - '''Calculates the Dot Product. 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 values. 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) values. Returns true if they match'''
** multiplyByQuat(quat) - '''Takes a Quaternion and multiplies its orientation by (x, y, z). It returns a new Vector orientation'''
== Ideas List ==
=== Matrix Class ===A Matrix Class is necessary Here are the wishlist of things we want to provide Matrix operations such as rotation, translation, and scaling be able to any point in do with the 3D worldlibrary. It is composed of a 4x4 matrix of floating point values that can be applied ... If you want something add it to any Matrix operation. This matrix is stored in '''Row-Major''' format, meaning its first 4 values are in the first rowlist. The Matrix Class has the following members:
* Getters** getMatrix() 3D Asteroids - '''Returns an array Good use of 16 numbersCollision detection, animation, particles, camera work, both mouse and keyboard controls. Each value represents a location of the matrix starting at the top left corner (Row-Major)'''
* Setters** setMatrix(newMatArray) Solar System Explorer - '''Takes an Array Pull the positions of our planets from some sort of 16 numbers that represent the matrix in Row-Major format'''webservice and display them, allowing users to see their relative alignment.
* Calculations** identity() - '''Sets the matrix up to be an identity matrix'''** transpose() - ''' Transposes the matrix to be in Column-Major format, and vice versa'''** inverse() - '''Calculates the Inverse Simulation of the matrix. Returns NULL if it fails, 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 matrices. It return a new matrix'''3D path finding
* 3D graphs
:* Display social networks and their relationships<br />
:* Get earthquake Richter-scale values from a service and show graphs on a map<br />
:* Display 3D graphs beside one another, gas prices along stock market values<br />
:* 3D flowcharts<br />
=== Quaternion Class ===A Quaternion is a 4* 3D Traceroute -Dimensional representation graphical view of an orientationIP's path across the internet. It consists of a unit-length axis and an angle around that axisMore details [http://www.c3dl. It can function much like an orientation matrix but without the disadvantage of Gimble Lockorg/index. The Quaternion is stored as an array of 4 numbers, represented php/uncategorized/canvas3d-traceroute-idea/ in the order of (w, x, y, z). The Quaternion Class has the following members:this blog post]
* Getters** getW() 3D Canvas Racing Demo - '''Returns the numerical W component of the Quaternion'''** getX() like [http://www.tapper- '''Returns the numerical X component of the Quaternion'''** getY() - '''Returns the numerical Y component of the Quaternion'''** getZ() - '''Returns the numerical Z component of the Quaternion'''** getMatrix() - '''Returns a Matrix object ware.net/canvas3d/ this] but better, to show that reflects the orientation of the quaternion''it'** getAxisAngle(axiss both easier to use, angle) - '''Takes in two valuesmore functionality is available, a Vector object and a Number. Converts the orientation of the quaternion into an axis Vector and an angle around it'''runs much faster (hopefully)
* Setters** setFromQuat(quat) Molecule Viewer - '''Sets Rotate 3D molecules. Similar to [http://www.worldofmolecules.com/3D/bcarotene_3d.htm this Quaternion with the same value as the one being passed in'''** setFromMatrix(mat) - '''Creates a Quaternion orientation from the orientation of the Matrix object that is passed in''']
* Calculations** length() - '''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 to 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'''3D Sudoku
== Camera ==* 3D Rubik's Cube
=== Pan 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.
=== Fixed 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].
=== Chase Camera Class ===* INCOMPLETEMatrix - Query search engines for sites, chat logs, blogs, etc. and display all the text in a matrix-like fashion.
=== Free Camera Class ===The Free Camera Class is * Really fancy animation of a camera that can be translated bar graph, with columns growing and orientedarrow moving. It cannot Will be attached to an item, rather, it can be moved separately by the userinstant hit with business people. Usable as easy as [http://code. The camera also supports velocities (without friction) that are applied to the object based on timegoogle. The Free Camera Class has the following Memberscom/apis/chart/ google's toy][[Image:higherhigher.jpg]]
* Getters** getPosition() - '''Returns a Vector Object that represents the position of the Camera'''** getUp() - '''Returns a Vector Object that represents the orientation of Up'''** 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 Generic model viewer application, with back/forward/index + zoom/rotate buttons that would download and display models from the camera is traveling at'''** getAngularVel() - '''Returns web. Would have to be able to convert 3dsmax models in JS. So a Vector that contains museum or such could just slap the rotation velocity around app on the local (x, y, z) axis page and give it an array of URLs for the camera'''stuff to show.
* Setters** setPosition(vec) - '''Takes a Vector that sets the camera's position'''** setLookAtPoint(vec) - '''Takes a Vector that represents the point the camera will look at'''** setUpVector(vec) - '''Takes a vector that orients the camera Up'''** setLinearVel(vec) - ''' Takes a vector that is the camera's linear velocity'''** setAngularVec(vec) - '''Takes a vector that represents Pong. Should be fairly easy, we just need to code the camera's rotational velocity around local (x, y, z) axis'''collision detection.
* Other Functions** rotateOnAxis(axis, angle) multi- '''Takes player network air hockey. Supports up to 8 players. Create an arena based on number of players . Each wall has a vector hole and a number paddle that represents players can move left and right. A ball is randomly sent flying and each time it goes through a relative rotation to hole, the camera's orientation'''** yaw(angle) - '''Takes player loses a number point. Lose 10 points and 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 updateplayer is eliminated. Last person alive wins. This function updates the position and rotation based on the set velocities'''
== World Objects ==* 2 Player Online Chess:* Orbit camera can be used to orbit around the board.<br />:* Effects can be used to change what material the pieces and board use such as metal, wood, etc.<br />:* Picking can be used to allow a simple interface to move the pieces. Either clicking on two tiles can move a piece or clicking on a piece and then a tile can move the piece.<br />:* Further research is needed to determine the best server-side language to use to share board state between players.<br />:* Animation can be achieved simply by setting velocities of pieces.<br />
=== Shape Class ====== Primitive Class ====== Model Class ===[[Category:Open Source Communities]]

Navigation menu