WIP

Author: sasha240100

.gitignore

@@ -1,4 +1,5 @@
 bullet3/build
 bullet_old/build
+node_modules/
 *.diff
 

LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2011 ammo.js contributors
+
+This software is provided 'as-is', without any express or implied
+warranty.  In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+   claim that you wrote the original software. If you use this software
+   in a product, an acknowledgment in the product documentation would be
+   appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+   misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.
+
+---
+
+See AUTHORS for list of contributors.
+

README.markdown

@@ -0,0 +1,173 @@
+ammo.js
+=======
+
+
+# Demos
+
+ * [Cubes](http://kripken.github.com/ammo.js/examples/webgl_demo/ammo.html)
+ * [SoftBody-Rope](http://kripken.github.com/ammo.js/examples/webgl_demo_softbody_rope/index.html)
+ * [SoftBody-Cloth](http://kripken.github.com/ammo.js/examples/webgl_demo_softbody_cloth/index.html)
+ * [SoftBody-Volume](http://kripken.github.com/ammo.js/examples/webgl_demo_softbody_volume/index.html)
+ * [Heightmap](http://kripken.github.com/ammo.js/examples/webgl_demo_terrain/index.html)
+
+# Overview
+
+**Example code to give you an idea of the API: https://github.com/kripken/ammo.js/blob/master/examples/webgl_demo/ammo.html#L14**
+
+ammo.js is a direct port of the [Bullet physics engine](http://bulletphysics.org/) to JavaScript, using Emscripten. The source code is translated directly to JavaScript, without human rewriting, so functionality should be identical to the original Bullet.
+
+**Note: ammo.js has just been updated to a new porting approach. If you find some part of the Bullet API that is not supported that you need, please see https://github.com/kripken/ammo.js/issues/60**
+
+'ammo' stands for "Avoided Making My Own js physics engine by compiling bullet from C++" ;)
+
+ammo.js is zlib licensed, just like Bullet.
+
+Discussion takes place on IRC at #emscripten on Mozilla's server (irc.mozilla.org)
+
+
+Instructions
+------------
+
+`builds/ammo.js` contains a prebuilt version of ammo.js. This is probably what you want.
+
+You can also build ammo.js yourself, as follows:
+
+ * Get Emscripten
+
+      http://emscripten.org
+
+   and set it up. See
+
+      https://github.com/kripken/emscripten/wiki/Getting-started
+
+ * Run the build script,
+
+      `python make.py`
+
+   which should generate builds/ammo.js.
+
+ * Optionally, run the automatic tests,
+
+      `python test.py`
+
+
+Usage
+-----
+
+The most straightforward thing is if you want to write your code in C++, and
+run that on the web. If so, then compile your code into LLVM, link it with
+bullet, and compile that to JavaScript using emscripten. (The easiest way to
+link it is to add your .bc file to the llvm-link command in make.py.)
+
+If, on the other hand, you want to write code in JavaScript, you can use the
+autogenerated binding code. A complete example appears in
+
+  `examples/hello_world.js`
+
+That is HelloWorld.cpp from Bullet, translated to JavaScript. Other examples
+in that directory might be useful as well. In particular see the WebGL
+demo code in
+
+  `examples/webgl_demo/ammo.html`
+
+
+Bindings API
+============
+
+ammo.js autogenerates its API from the Bullet source code, so it should
+be basically identical. There are however some differences and things
+to be aware of:
+
+  * See https://github.com/kripken/emscripten/wiki/WebIDL-Binder
+    for a description of the bindings tool we use here, which includes
+    instructions for how to use the wrapped objects.
+
+  * All ammo.js elements should be accessed through `Ammo.*`. For example,
+    `Ammo.btVector3`, etc., as you can see in the example code.
+
+  * Member variables of structs and classes can be accessed through
+    setter and getter functions, that are prefixed with `|get_|` or `|set_|`.
+    For example,
+
+      `rayCallback.get_m_rayToWorld()`
+
+    will get `m_rayToWorld` from say a `ClosestRayResultCallback`. Native
+    JavaScript getters and setters could give a slightly nicer API here,
+    however their performance is potentially problematic.
+
+  * Functions returning or getting `float&` or `btScalar&` are converted to
+    float. The reason is that `float&` is basically `float*` with nicer syntax
+    in C++, but from JavaScript you would need to write to the heap every
+    time you call such a function, making usage very ugly. With this change,
+    you can do `|new btVector3(5, 6, 7)|` and it will work as expected. If
+    you find a case where you need the float& method, please file an issue.
+
+  * Not all classes are exposed, as only what is described in ammo.idl is
+    wrapped. Please submit pull requests with extra stuff that you need
+    and add.
+
+  * There is experimental support for binding operator functions. The following
+    might work:
+         
+    | Operator  | Name in JS  |
+    |---|---|
+    | `=`  | `op_set`  |
+    | `+`  | `op_add`  |
+    | `-`  | `op_sub`  |
+    | `*`  | `op_mul`  |
+    | `/`  | `op_div`  |
+    | `[]`  | `op_get`  |
+    | `==`  | `op_eq`  |
+
+
+Troubleshooting
+===============
+
+  * It's easy to forget to write |new| when creating an object, for
+    example
+
+      `var vec = Ammo.btVector3(1,2,3); // This is wrong! Need 'new'!`
+
+    This can lead to error messages like the following:
+
+      `Cannot read property 'a' of undefined`
+      `Cannot read property 'ptr' of undefined`
+
+    This is an annoying aspect of JavaScript, sadly.
+
+
+Reporting Issues
+================
+
+If you find a bug in ammo.js and file an issue, please include a script
+that reproduces the problem. That way it is easier to debug, and we can
+then include that script in our automatic tests.
+
+
+Release Process
+===============
+
+Pushing a new build in `builds/ammo.js` should be done only after the
+following steps:
+
+  * Build a safe build and make sure it passes all automatic tests. Safe
+    builds contain a lot of runtime assertions that can catch potential
+    bugs (similar to the sort of things valgrind can catch).
+
+  * Build a fast build and make sure it passes all automatic tests.
+
+  * Run closure compiler on that fast build and make sure it passes
+    all automatic tests.
+
+  * Make sure that the stress test benchmark did not regress
+    compared to the old build.
+
+  * Run the WebGL demo in examples/webgl_demo and make sure it looks
+    ok.
+
+
+Upstream Version
+================
+
+Bullet 2.82
+

bullet3/Extras/CMakeLists.txt

@@ -0,0 +1,11 @@
+SUBDIRS( Serialize ConvexDecomposition HACD GIMPACTUtils )
+
+IF(BUILD_BULLET3)
+	SUBDIRS( InverseDynamics)
+ENDIF()
+
+#Maya Dynamica plugin is moved to http://dynamica.googlecode.com
+
+#IF (USE_GLUT AND GLUT_FOUND)
+#	SUBDIRS (glui)
+#ENDIF ()

bullet3/Extras/ConvexDecomposition/CMakeLists.txt

@@ -0,0 +1,64 @@
+INCLUDE_DIRECTORIES(
+ ${BULLET_PHYSICS_SOURCE_DIR}/Extras/ConvexDecomposition ${BULLET_PHYSICS_SOURCE_DIR}/src
+)
+
+SET(ConvexDecomposition_SRCS
+	bestfitobb.cpp
+	ConvexBuilder.cpp
+	cd_wavefront.cpp
+	fitsphere.cpp
+	meshvolume.cpp
+	raytri.cpp
+	vlookup.cpp
+	bestfit.cpp
+	cd_hull.cpp
+	ConvexDecomposition.cpp
+	concavity.cpp
+	float_math.cpp
+	planetri.cpp
+	splitplane.cpp
+)
+
+SET(ConvexDecomposition_HDRS
+	ConvexDecomposition.h
+	cd_vector.h
+	concavity.h
+	bestfitobb.h
+	ConvexBuilder.h
+	cd_wavefront.h
+	fitsphere.h
+	meshvolume.h
+	raytri.h
+	vlookup.h
+	bestfit.h
+	cd_hull.h
+)
+
+ADD_LIBRARY(ConvexDecomposition ${ConvexDecomposition_SRCS} ${ConvexDecomposition_HDRS})
+SET_TARGET_PROPERTIES(ConvexDecomposition PROPERTIES VERSION ${BULLET_VERSION})
+SET_TARGET_PROPERTIES(ConvexDecomposition PROPERTIES SOVERSION ${BULLET_VERSION})
+
+IF (BUILD_SHARED_LIBS)
+  TARGET_LINK_LIBRARIES(ConvexDecomposition BulletCollision LinearMath)
+ENDIF (BUILD_SHARED_LIBS)
+
+IF (INSTALL_EXTRA_LIBS)
+	IF (NOT INTERNAL_CREATE_DISTRIBUTABLE_MSVC_PROJECTFILES)
+		#FILES_MATCHING requires CMake 2.6
+		IF (${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION} GREATER 2.5)
+			IF (APPLE AND BUILD_SHARED_LIBS AND FRAMEWORK)
+				INSTALL(TARGETS ConvexDecomposition DESTINATION .)
+			ELSE (APPLE AND BUILD_SHARED_LIBS AND FRAMEWORK)
+				INSTALL(TARGETS ConvexDecomposition DESTINATION lib${LIB_SUFFIX})
+				INSTALL(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+DESTINATION ${INCLUDE_INSTALL_DIR} FILES_MATCHING PATTERN "*.h"  PATTERN
+".svn" EXCLUDE PATTERN "CMakeFiles" EXCLUDE)
+			ENDIF (APPLE AND BUILD_SHARED_LIBS AND FRAMEWORK)
+		ENDIF (${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION} GREATER 2.5)
+
+		IF (APPLE AND BUILD_SHARED_LIBS AND FRAMEWORK)
+			SET_TARGET_PROPERTIES(ConvexDecomposition PROPERTIES FRAMEWORK true)
+			SET_TARGET_PROPERTIES(ConvexDecomposition PROPERTIES PUBLIC_HEADER "${ConvexDecomposition_HDRS}")
+		ENDIF (APPLE AND BUILD_SHARED_LIBS AND FRAMEWORK)
+	ENDIF (NOT INTERNAL_CREATE_DISTRIBUTABLE_MSVC_PROJECTFILES)
+ENDIF (INSTALL_EXTRA_LIBS)