mtltojs

A nodejs module to parses WaveFront material (.mtl) files to javascript or JSON.

Overview

Parse WaveFront material file (.mtl) to a javascript object and/or JSON.

Option to save the parsed data to a JSON file which will also break down the data to segments and save each segment to it's own JSON file.

Installation

npm install mtltojs

Usage:

Returns a js object and optional JSON.

var parser = require("mtltojs");

// Async call
parser.parse(file, function(err, data){
  // do stuff with data
});

//Synchronous call
var data = parser.parseSync("C:/3d/materials/sample.mtl");

Methods

parse - Is an async method which takes in a filepath and optional options object. Returns a js objected of the parsed data. Options to save JSON and log information to a file. For options See below

parse(file[,options])

parseSync - Is a synchronous call which takes the same arguments as the asynchronous parse call..

parseSync(file[,options])

Parameters

These are the parameters for methods...

parse(file, options) and parseSync(file, options)

file - - full path to the .mtl file. options - - flags for events such as logging, saving to JSON files, etc...

Options

Is a js object that contains configurations for logging, saving JSON files, etc...

parseComments - bool (default: false) - flag to retain comments when parsing the file. verbose - bool (default: false) - flag to write parsing details to the nodejs console.
logging - bool (default: false) - flag to write and save parsing details to a log file.
returnJSON - bool (default: false) - flag to have the a JSON string of the parsed object returned with the js object.
saveJSON - bool (default: false) - flag to save the parsed data as a JSON string to file.

Default Option object if the options parameter is omitted...

options = {
  parseComments: false,
  verbose: false,
  logging: false,
  returnJSON: false,
  saveJSON: false
}

License

MIT

Release History

0.1.0 Initial Release
0.2.0 Better naming for header comments and folder creation. Bug fixes
0.2.1 Adding parsing for 'Ke' emission.

chrispalazzolo/mtltojs