Home

Awesome

Toxiclibsjs

an open-source library for computational design tasks with JavaScript.

Spherical Harmonics in three.js polar_unravel attraction2d

Toxiclibs.js is a port of Karsten Schmidt's Toxiclibs for Java and Processing. Toxiclibs.js provides powerful datatypes for the browser and node. It works well for manipulating any DOM element, including Canvas and SVG.

The plethora of examples demonstrate its use for geometry and color manipulation as well as physics, automata and more. The examples pair with such fine libraries as: Processing.js, Three.js, D3.js or Raphael.js.

What it is…

Getting Started with Toxiclibs.js

Toxiclibs.js can be used in the following ways:

Use the build

copy the file build/toxiclibs.js:

<script type="text/javascript" src="js/toxiclibs.js"></script>
<script type="text/javascript">
	var myVector = new toxi.geom.Vec2D(window.innerWidth,window.innerHeight).scaleSelf(0.5);
	var myColor = toxi.color.TColor.newRGB(128/255,64/255,32/255);
</script>

Use with RequireJS or other AMD loader

copy the contents of lib/:

require(['toxi/geom/Vec2D', toxi/color/TColor], function(Vec2D, TColor){
	var myVector = new Vec2D(window.innerWidth,window.innerHeight).scaleSelf(0.5);
	var myColor = TColor.newRGB(128/255,64/255,32/255);
});

Use with Node.js:

npm install toxiclibsjs

then:

var	toxi = require('toxiclibsjs'),
	myVector = new toxi.geom.Vec2D(0.5,0.5),
	myColor = toxi.color.TColor.newRGB(128/255,64/255,32/255);

For comprehensive documentation, read the original libraries javadocs. As the library is still growing, you can compare that documentation to this list of implemented classes.

Toxiclibs.js follows the original package structure

The following objects are returned when loading the entire library

Creating Builds

Run make to generate new versions of the existing builds. There are additional targets defined in the Makefile

Custom builds

If you are working with the build/ files you may wish to create a custom build that only includes the modules you are using in order to save file size. If you are using the files as AMD modules there is no need for this.

To generate a custom build, space-delimit the modules you want:

./bin/toxiclibsjs --include "toxi/geom/Vec2D toxi/physics2d" --minify --out "./build/toxiclibsjs-custom.min.js"

Run the tests

Run make test to run the suite of tests.

Contributing

Contributions to toxiclibs.js are appreciated, please read more here

Toxiclibs.js was initiated on 1/5/2011 by Kyle Phillips http://haptic-data.com

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

http://creativecommons.org/licenses/LGPL/2.1/

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA