Skip to content

jeresig/node-parse-dimensions

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

Node.js Parse Dimensions

Parse physical object dimensions and convert them into a standardized form.

Example

const pd = require("parse-dimensions");

console.log(pd.parseDimension("4in x 5in"));
// { original: '4in x 5in', unit: 'mm', width: 101.6, height: 127 }

console.log(pd.parseDimension("4.2cm x 5.1cm"));
// { original: '4.2cm x 5.1cm', unit: 'mm', width: 42, height: 51 }

You can see a full list of all the types of dimension strings handled in the test file.

Created by John Resig for parsing dimensions from museums, universities, galleries, and dealers for Ukiyo-e.org.

Installation

npm install parse-dimensions

API

parseDimension(dimensionString, [flip])

Parse a string that holds some dimensions and returns an object representing the dimensions. By default it assumes that the width is first. Pass a boolean as the second argument to assume the height is first.

parseDimensions(dimensionsString, [flip])

Parse a string that holds a set of dimensions and returns an array of objects representing the dimensions. It assumes that the dimensions are separated by semicolons by default.

convertNumber(number, fromUnit, toUnit)

Convert a number from one dimension unit to another. For example: convertNumber(10, "mm", "cm") will return 1.

convertDimension(dimensionObject, toUnit)

Given a dimension object (as produced by parseDimension) convert it to use a different dimension. Returns the modified dimension object.

License

Released under an MIT license.

About

Parse physical object dimensions and convert them into a standardized form.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published