/three-obj

Compiler of 3D OBJ files to Three.js JSON as a node.js module

Primary LanguageJavaScript

Three OBJ

A node module to convert OBJ files to Three.js JSON format

Install

Using npm:

npm install three-obj

Usage

Include to a script as a dependency

var threeOBJ = require("three-obj")( options );

where options can be an bject to override the defaults

then load any OBJ file to convert it to a JSON object

threeOBJ.load("obj/palm.obj", function( response ){

	console.log("DATA:", response );

});

Note that the MTL file is currently expected to be is the same folder.

View the examples folder for more specific use cases

Methods

These are the main methods to interact with the lib

load( file, callback )

Loads an OBJ file and creates a JavaScript object

convert( source, destination, callback )

One liner to load & output to ascii JSON

minify( source, destination, callback)

Same as convert but saves to binary format

set( options)

Update the options used during the processing (like scale, shading, align).

Internal methods

In addition there are some methods used internally that you might want to use at certain cases:

parse( obj )

Accepts a raw OBJ file and returns it as a JavaScript object

compress( json , callback)

Get the JSON input and convert it to binary format

output( json, callback )

Simply saves the data to a JSON file.

Credits

Created by Makis Tracend ( @tracend )

Based on: OBJLoader, MTLLoader, convert_obj_three

Distributed through Makesites.org

Released under the MIT license