Merge pull request #113 from vidartf/buffer_geom

Buffer attributes/geometry

Author: vidartf

README.md

@@ -1,44 +1,68 @@
-pythreejs
-=========
+# pythreejs
 
-This is a _significant_ re-work of the pythreejs extension that introduces an "autogen" script that generates the majority of the ipython-widget code to wrap each of three.js's types.  It also takes a different view towards the pythreejs API.  Whereas pythreejs adds custom functionality to the classes, sometimes renaming, etc., this approach attempts to mimic the low-level three.js API as closely as possible, opening up the possibility for others to build utility libraries on top of this.
 
-This branch does not support all the functionality of the current pythreejs, but it is a significant step forward in terms of the potential to support the majority of three.js's features.  Currently supported features:
-- Basic building blocks of a scene:
-  - Textures (both Image-based and Data-based)
-  - Materials
-  - Geometries
-  - Meshs
-  - Scene, Lights, Cameras, WebGLRenderer
+## Getting Started
+
+### Try it online with [Binder](http://mybinder.org/)
+
+[![Binder](http://mybinder.org/badge.svg)](http://mybinder.org:/repo/jovyan/pythreejs/notebooks/examples)
+
+### Installation
+
+Using pip:
+
+```bash
+pip install pythreejs
+jupyter nbextension install --py --symlink --sys-prefix pythreejs
+jupyter nbextension enable --py --sys-prefix pythreejs
+```
+
+Note for developers: the `--symlink` argument on Linux or OS X allows one to
+modify the JavaScript code in-place. This feature is not available
+with Windows.
+
+Using conda
+
+```bash
+conda install -c conda-forge pythreejs
+```
+
 
----
+## Developers
+
+### Autogen
+
+This is a _significant_ re-work of the pythreejs extension that introduces an "autogen" script that generates the majority of the ipython-widget code to wrap each of three.js's types.  It also takes a different view towards the pythreejs API.  Whereas pythreejs adds custom functionality to the classes, sometimes renaming, etc., this approach attempts to mimic the low-level three.js API as closely as possible, opening up the possibility for others to build utility libraries on top of this.
 
 The autogen script, `generate-wrappers.js`, takes advantage of a config file `three-class-config.js` to auto-generate both javascript and python files to define the ipywidget wrappers for each three.js class.  The generated javascript files will have `.autogen.js` as the extension.  The generated python files have `_autogen.py` as their extension.  The script uses the handlebars template system to generate the various code files.
 
 The autogen solution allows for overriding the default behavior of the generated classes.  E.g., if `Object3D.js` is present, then it will be loaded into the namespace as opposed to loading `Object3D.autogen.js`.  It is up to the author of the override classe to decide whether to inherit behavior from the autogen class or not.  Same goes for the python modules.  This allows for writing custom methods on both the python and javascript side when needed.
 
 The autogen script relies on a json-like config file (`three-class-config.js`) to describe the classes.  Reasonable defaults should take care of most, but it allows specifying the base class, constructor args, etc. for each of the wrappers.  A base version of this file can be generated by `generate-class-config.js`, but beware, it overwrites any customization to the config file that has already been done.
 
-## Setup
+#### Setup
 
-```
+```bash
 # Initial setup
 cd js
 npm install
 
 # Generate files
 npm run autogen
+pip install -e .
 
 # Build distribution files
 npm run build
+jupyter nbextension install --py --symlink --sys-prefix pythreejs
 
 # Clean out generated files
 npm run clean
+
 ```
 
 List of relevant files:
 
-```
+```bash
 js/package.json
 js/webpack.config.js
 
@@ -92,43 +116,3 @@ js/src/examples/controls/TrackballControls.js
 js/src/examples/renderers/CanvasRenderer.js
 js/src/examples/renderers/Projector.js
 ```
-
-
-TODO: Everything below here is probably outdated.
-
-Getting Started
----------------
-
-### Try it online with [Binder](http://mybinder.org/)
-
-[![Binder](http://mybinder.org/badge.svg)](http://mybinder.org:/repo/jovyan/pythreejs/notebooks/examples)
-
-Installation
-------------
-
-Using pip:
-
-```
-pip install pythreejs
-jupyter nbextension enable --py --sys-prefix pythreejs
-```
-
-Using conda
-
-```
-$ conda install -c conda-forge pythreejs
-```
-
-For a development installation (requires npm):
-
-```
-$ git clone https://github.com/jovyan/pythreejs.git
-$ cd pythreejs
-$ pip install -e .
-$ jupyter nbextension install --py --symlink --sys-prefix pythreejs
-$ jupyter nbextension enable --py --sys-prefix pythreejs
-```
-
-Note for developers: the `--symlink` argument on Linux or OS X allows one to
-modify the JavaScript code in-place. This feature is not available
-with Windows.