Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/foo123/mod3

3D Modifier Library in JavaScript, port of AS3DMod ActionScript 3D Modifier Library
https://github.com/foo123/mod3
3d-engine bend skew twist
Last synced: 10 days ago
JSON representation
3D Modifier Library in JavaScript, port of AS3DMod ActionScript 3D Modifier Library
Host: GitHub
URL: https://github.com/foo123/mod3
Owner: foo123
Created: 2011-12-17T22:56:15.000Z (almost 13 years ago)
Default Branch: master
Last Pushed: 2024-10-04T07:54:45.000Z (about 1 month ago)
Last Synced: 2024-10-20T09:13:14.558Z (17 days ago)
Topics: 3d-engine, bend, skew, twist
Language: JavaScript
Homepage: https://foo123.github.io/examples/flipbook3/
Size: 7.48 MB
Stars: 77
Watchers: 14
Forks: 27
Open Issues: 1
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project

README

        # MOD3

**3D Modifier Library for JavaScript**

This is a port of the [AS3dMod Modifier Library for ActionScript 3](http://code.google.com/p/as3dmod/) to JavaScript.

**version: 1.0.0**

**supports: Three.js, CubicVR.js, OSG.js, J3D, Copperlicht, Pre3d**

[![MOD3.js](/flipbook2.png)](https://foo123.github.io/examples/flipbook3/)

It is an almost complete port. All Modifiers found in AS3DMod are scheduled to be ported.

Also the API architecture is setup for more modifiers to be added (even custom ones).

### Contents

* [Live Examples](#live-examples)

* [3D Engines Support](#support-for-3d-javascript-engines)

* [3D Modifiers Support](#modifiers-supported-up-to-present)

* [Source Code License](#source-code-license)

* [API Reference](/api-reference.md)

* [Todo](#todo)

* [How to debug](#how-to-debug)

* [ChangeLog](#changelog)

### Source Code License

[MIT Open Source License](http://opensource.org/licenses/mit-license.php) like the original [AS3dMod Modifier Library for ActionScript 3](http://code.google.com/p/as3dmod/).

### Live Examples

* [3D flipbook](https://foo123.github.io/examples/flipbook3/) (Three.js, MOD3.js and Tween.js)

* [Dancing Box](https://foo123.github.io/examples/dancing-box/)  (a simple blend of 3D manipulation and sound visualization)

### Support for 3D JavaScript engines

* [Three.js](https://github.com/mrdoob/three.js/) with examples (r78)

* [OSG.js](https://github.com/cedricpinson/osgjs) with examples (0.2.5)

* [CubicVR](https://github.com/cjcliffe/CubicVR.js/) with examples

* [J3D](https://github.com/drojdjou/J3D) with examples (Build 51)

* [Copperlicht](https://github.com/Sebmaster/copperlicht) with examples

* [Pre3d](https://github.com/deanm/pre3d) with examples (pre3d examples are a little blurry but you'll get the picture)

### Modifiers supported (up to present)

* Pivot (note: Pivot does not work with Pre3d)

* Bend

* Twist

* Taper

* Skew

* Noise

* Wheel

* Bloat

* Break

* Perlin

* DisplaceMap

### TODO

* possible generic way to use (at least some) 3D modifiers directly in GLSL for all supported engines (??)

* add custom modifiers except the defaults found in AS3dMod library

* optimize (math ops, caching, modifier chain calls etc..) [DONE partially]

* port the modifiers that use Perlin Noise (using instead the simpler and faster Simplex Noise routine for JavaScript, [noisejs](https://github.com/josephg/noisejs) , or [simplex-noise.js](https://github.com/jwagner/simplex-noise.js)) [DONE partially]

* keep up with JavaScript 3D Engines updates (will try)

### How to debug

1. If the problem is in one 3D engine, while the other engines work correctly for this example/modifier, then the problem is probably with that engine's proxy classes (plugins/3DENGINENAME/3DENGINENAME.js)

2. If the specific example/modifier does not work in any 3D engine, but other modifiers/examples do work, then the problem is probably with that modifier's code (modifiers/MODIFIERNAME.js)

3. If no example works for any engine, then the problem is probably in the core classes, or some class throws a js error which stops the whole execution

### Changelog

* 1.0.0 refactor, simplify and minify code, remove classy dependency

* 0.6.0  3d engine plugins have been removed from the final build to make packaged code lighter, include the appropriate 3D plugin **manualy in your application** after the main **mod3** script (see examples), modifiers are independent of the underlying modifiable mesh (it is a parameter), and this enables them to be shared (if the exact same modifier is needed) across multiple different modifierStacks for different underlying meshes, support for OSG.js, further refactoring and optimisations, some method changes

* 0.5.0  parallel processing through workers is dropped, add support for OSG.js (in progress), update support for Three.js r78, some refactoring and optimisations

* 0.4  support parallel modifiers with web workers transparently, code refactor, optimizations, examples updates

* 0.3.5  DisplaceMap modifier added, edits / optimizations

* 0.3.4  update classy.js, code refactor / optimizations, Perlin modifier added

* 0.3.2-0.3.3  update buildtools, api-reference, classy.js, Three.js revision (r66)

* 0.3.1  update buildtools, api-reference, use classy.js for OOP

* 0.3  code refactoring, extension framework, various optimizations, tidy up repo, new build scripts, project stopped

* added support for CubicVR.js 3D Engine, minor optimizations for all engines

* added support for Three.js revision (r58)

* added support for Three.js revision (r53)

**see also:**

* [ModelView](https://github.com/foo123/modelview.js) a simple, fast, powerful and flexible MVVM framework for JavaScript

* [Contemplate](https://github.com/foo123/Contemplate) a fast and versatile isomorphic template engine for PHP, JavaScript, Python

* [HtmlWidget](https://github.com/foo123/HtmlWidget) html widgets, made as simple as possible, both client and server, both desktop and mobile, can be used as (template) plugins and/or standalone for PHP, JavaScript, Python (can be used as [plugins for Contemplate](https://github.com/foo123/Contemplate/blob/master/src/js/plugins/plugins.txt))

* [Paginator](https://github.com/foo123/Paginator)  simple and flexible pagination controls generator for PHP, JavaScript, Python

* [ColorPicker](https://github.com/foo123/ColorPicker) a fully-featured and versatile color picker widget

* [Pikadaytime](https://github.com/foo123/Pikadaytime) a refreshing JavaScript Datetimepicker that is ightweight, with no dependencies

* [Timer](https://github.com/foo123/Timer) count down/count up JavaScript widget

* [InfoPopup](https://github.com/foo123/InfoPopup) a simple JavaScript class to show info popups easily for various items and events (Desktop and Mobile)

* [Popr2](https://github.com/foo123/Popr2) a small and simple popup menu library

* [area-select.js](https://github.com/foo123/area-select.js) a simple JavaScript class to select rectangular regions in DOM elements (image, canvas, video, etc..)

* [area-sortable.js](https://github.com/foo123/area-sortable.js) simple and light-weight JavaScript class for handling smooth drag-and-drop sortable items of an area (Desktop and Mobile)

* [css-color](https://github.com/foo123/css-color) simple class for manipulating color values and color formats for css, svg, canvas/image

* [jquery-plugins](https://github.com/foo123/jquery-plugins) a collection of custom jQuery plugins

* [jquery-ui-widgets](https://github.com/foo123/jquery-ui-widgets) a collection of custom, simple, useful jQueryUI Widgets

* [touchTouch](https://github.com/foo123/touchTouch) a variation of touchTouch jQuery Optimized Mobile Gallery in pure vanilla JavaScript

* [Imagik](https://github.com/foo123/Imagik) fully-featured, fully-customisable and extendable Responsive CSS3 Slideshow

* [Carousel3](https://github.com/foo123/Carousel3) HTML5 Photo Carousel using Three.js

* [Rubik3](https://github.com/foo123/Rubik3) intuitive 3D Rubik Cube with Three.js

* [MOD3](https://github.com/foo123/MOD3) 3D Modifier Library in JavaScript

* [Geometrize](https://github.com/foo123/Geometrize) Computational Geometry and Rendering Library for JavaScript

* [Plot.js](https://github.com/foo123/Plot.js) simple and small library which can plot graphs of functions and various simple charts and can render to Canvas, SVG and plain HTML

* [Abacus](https://github.com/foo123/Abacus) advanced Combinatorics and Algebraic Number Theory Symbolic Computation library for JavaScript, Python

* [TensorView](https://github.com/foo123/TensorView) view array data as multidimensional tensors of various shapes efficiently

* [RT](https://github.com/foo123/RT) unified client-side real-time communication for JavaScript using XHR polling / BOSH / WebSockets / WebRTC

* [AjaxListener.js](https://github.com/foo123/AjaxListener.js): Listen to any AJAX event on page with JavaScript, even by other scripts

* [asynchronous.js](https://github.com/foo123/asynchronous.js) simple manager for asynchronous, linear, parallel, sequential and interleaved tasks for JavaScript

* [classy.js](https://github.com/foo123/classy.js) Object-Oriented mini-framework for JavaScript

* [CanvasLite](https://github.com/foo123/CanvasLite) an html canvas implementation in pure JavaScript

* [Rasterizer](https://github.com/foo123/Rasterizer) stroke and fill lines, rectangles, curves and paths, without canvaσ

* [Gradient](https://github.com/foo123/Gradient) create linear, radial, conic and elliptic gradients and image patterns without canvas

* [HAAR.js](https://github.com/foo123/HAAR.js) image feature detection based on Haar Cascades in JavaScript (Viola-Jones-Lienhart et al Algorithm)

* [HAARPHP](https://github.com/foo123/HAARPHP) image feature detection based on Haar Cascades in PHP (Viola-Jones-Lienhart et al Algorithm)

* [FILTER.js](https://github.com/foo123/FILTER.js) video and image processing and computer vision Library in pure JavaScript (browser and node)