Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/haxiomic/threehx-basic-scene

Porting three.js to Haxe by converting only the classes and functions involved in a very simple scene and building out from there
https://github.com/haxiomic/threehx-basic-scene

Last synced: 23 days ago
JSON representation

Porting three.js to Haxe by converting only the classes and functions involved in a very simple scene and building out from there

Awesome Lists containing this project

README

        

##Let's get [three.js](https://github.com/mrdoob/three.js/) ported to Haxe!
The current approach is to port just enough to run the most basic scene, this will allow us to test design considerations and ensure that the foundations are rock solid for future development. This initial attempt will aim to run a very basic scene in GL, Flash and Canvas, however further development will focus on GL alone

Much of the code is based on eskojones's [https://github.com/eskojones/ThreeHX](https://github.com/eskojones/ThreeHX) & Vujadin's [https://github.com/vujadin/ThreeHx/](https://github.com/vujadin/ThreeHx/) ports

###Design Decisions
- In three.js the renderer adds additional fields to objects, in haxe, this means objects have to be predefined with renderer specific fields. These fields should either be stored elsewhere or be define in a general, renderer agonistic manner on the object.
`Use foo3d as the interface to the renderer?`
- Easy upgrade path: needs to map well onto threejs codebase
`functions should be tagged with revision they were ported from?`

###Getting Involved
Execute `git clone --recursive https://github.com/haxiomic/ThreeHX-Basic-Scene.git` to clone the repo including the three.js submodule

The current ThreeHX library is in the ./threehx folder and the basic test scene is in ./basic-scene-hx, to build: `cd basic-scene-hx` and execute `lime test html5`

Mark todos or other important comments with a '!#' e.g. `//!# this bit needs finishing`, this makes them searchable later on.

If a file is incomplete, please put what you've done and what needs to be done at the top.

Mark the revision the file was ported from at the top e.g.: `//r66`, if a function is added from a different revision, add comment above it marking the revision - this should make updating much easier

Other three.js->hx porting projects
[https://github.com/vujadin/ThreeHx/](https://github.com/vujadin/ThreeHx/)
[https://github.com/eskojones/ThreeHX](https://github.com/eskojones/ThreeHX)
[https://github.com/haxiomic/ThreeHX](https://github.com/haxiomic/ThreeHX) (Fork of eskojones with more GLRender code)
[https://github.com/seacloud9/ThreeHX](https://github.com/seacloud9/ThreeHX)

**Dart & C++ port are, very useful for type information**
[https://github.com/threeDart/three.dart](https://github.com/threeDart/three.dart)
[https://github.com/jdduke/three_cpp](https://github.com/jdduke/three_cpp)

###Important notes
- math.Math has become math.MathUtils to avoid conflict with standard Math lib

###Files touched in the basic scene, roughly in order
Excluding the WebGLRenderer dependancies because it accesses everything! If you've got time on your hands, pick one of these to port :) . Not all are actually used, but all are referenced in the basic-scene.

- ~~**Three.js**~~
- ~~math/**Math.js**~~
- ~~math/**Vector2.js**~~
- math/**Vector3.js** *
- math/**Vector4.js** *
- ~~math/**Matrix3.js**~~
- math/**Matrix4.js** *
- math/**Box3.js**
- math/**Sphere.js**
- math/**Color.js**
- math/**Quaternion.js** *
- math/**Frustum.js**
- math/**Plane.js**
- math/**Euler.js** *
- core/**EventDispatcher.js**
- core/**Geometry.js**
- core/**Face3.js**
- core/**Object3D.js**
- lights/**Light.js**
- objects/**Bone.js**
- scenes/**Scene.js**
- cameras/**Camera.js**
- cameras/**PerspectiveCamera.js**
- extras/geometries/**BoxGeometry.js**
- materials/**Material.js**
- materials/**MeshBasicMaterial.js**
- objects/**Mesh.js**
- renderers/**WebGLRenderer.js**

#Complete

- **Three.hx**
- math/**MathUtils.hx**
- math/**Vector2.hx**
- math/**Matrix3.js**

#Incomplete

- math/**Color.hx**
- math/**Quaternion.hx**
- math/**Vector2.hx**
- math/**Vector3.hx**
- math/**Vector4.hx**
- math/**Euler.hx**
- math/**Line3.hx**
- math/**Box2.hx**
- math/**Box3.hx**
- math/**Matrix3.hx**
- math/**Matrix4.hx**
- math/**Ray.hx**
- math/**Sphere.hx**
- math/**Frustum.hx**
- math/**Plane.hx**
- math/**Spline.hx**
- math/**Triangle.hx**
- math/**Vertex.hx**
- math/**UV.hx**
- core/**Clock.hx**
- core/**EventDispatcher.hx**
- core/**Raycaster.hx**
- core/**Object3D.hx**
- core/**Projector.hx**
- core/**Face3.hx**
- core/**Face4.hx**
- core/**BufferGeometry.hx**
- core/**Geometry.hx**
- core/**Geometry2.hx**
- cameras/**Camera.hx**
- cameras/**OrthographicCamera.hx**
- cameras/**PerspectiveCamera.hx**
- lights/**Light.hx**
- lights/**AmbientLight.hx**
- lights/**AreaLight.hx**
- lights/**DirectionalLight.hx**
- lights/**HemisphereLight.hx**
- lights/**PointLight.hx**
- lights/**SpotLight.hx**
- loaders/**Loader.hx**
- loaders/**XHRLoader.hx**
- loaders/**ImageLoader.hx**
- loaders/**JSONLoader.hx**
- loaders/**LoadingManager.hx**
- loaders/**BufferGeometryLoader.hx**
- loaders/**Geometry2Loader.hx**
- loaders/**MaterialLoader.hx**
- loaders/**ObjectLoader.hx**
- loaders/**SceneLoader.hx**
- loaders/**TextureLoader.hx**
- materials/**Material.hx**
- materials/**LineBasicMaterial.hx**
- materials/**LineDashedMaterial.hx**
- materials/**MeshBasicMaterial.hx**
- materials/**MeshLambertMaterial.hx**
- materials/**MeshPhongMaterial.hx**
- materials/**MeshDepthMaterial.hx**
- materials/**MeshNormalMaterial.hx**
- materials/**MeshFaceMaterial.hx**
- materials/**ParticleSystemMaterial.hx**
- materials/**ShaderMaterial.hx**
- materials/**SpriteMaterial.hx**
- materials/**SpriteCanvasMaterial.hx**
- textures/**Texture.hx**
- textures/**CompressedTexture.hx**
- textures/**DataTexture.hx**
- objects/**ParticleSystem.hx**
- objects/**Line.hx**
- objects/**Mesh.hx**
- objects/**Bone.hx**
- objects/**SkinnedMesh.hx**
- objects/**MorphAnimMesh.hx**
- objects/**LOD.hx**
- objects/**Sprite.hx**
- scenes/**Scene.hx**
- scenes/**Fog.hx**
- scenes/**FogExp2.hx**
- renderers/**CanvasRenderer.hx**
- renderers/shaders/**ShaderChunk.hx**
- renderers/shaders/**UniformsUtils.hx**
- renderers/shaders/**UniformsLib.hx**
- renderers/shaders/**ShaderLib.hx**
- renderers/**WebGLRenderer.hx**
- renderers/**WebGLRenderTarget.hx**
- renderers/**WebGLRenderTargetCube.hx**
- renderers/renderables/**RenderableVertex.hx**
- renderers/renderables/**RenderableFace.hx**
- renderers/renderables/**RenderableObject.hx**
- renderers/renderables/**RenderableSprite.hx**
- renderers/renderables/**RenderableLine.hx**

*Currently porting from r66*