Package Exports

ase-util

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ase-util) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ASE Util

Utility library to handle Adobe Swatch Exchange (ASE) files.

npm install ase-util

The package provides JavaScript functions and command line tools.

Command line tools

asedump

Dumps the colors and groups of an .ase file as JSON or LESS format.

Usage: asedump [options] filename.ase

Options:

--pretty Pretty print the output
--format Output format (json, less)

API

var ase = require("ase-util");

ase.read(buffer)

var fs = require("fs");
var result = ase.read(fs.readFileSync("myfile.ase"));

Reads a buffer with the ASE binary format; outputs an array with color or color group objects:

Color

There are four kinds of colors: RGB, CMYK, Lab, and Gray.

Color components in ASE files are stored using float values, for instance in RGB component values goes from 0 to 1 (instead of 0 to 255). For RGB and Gray colors, an convenient hex field with the HTML hex color format is included.

Each color value has a type field with the Spot/Process (Normal)/Process Global distinction made by Illustrator and InDesign (see https://helpx.adobe.com/illustrator/using/color.html).

RGB color example:

{
  type: 'color',
  name: 'Color Name',
  color: {model: 'RGB', r: 1, g: 0, b: 0, hex: 'FF0000', type: 'normal'}
}

CMYK color example:

{
  type: 'color',
  name: 'Color Name',
  color: {model: 'CMYK', c: 1, m: 0, y: 0, k: 0, type: 'spot'}
}

LAB color example:

{
  type: 'color',
  name: 'Color Name',
  color: {model: 'LAB', lightness: 1, a: 0, b: 0, type: 'normal'}
}

Gray color example:

{
  type: 'color',
  name: 'Color Name',
  color: {model: 'Gray', gray: 0, hex: '000000', type: 'normal'}
}

Group

Groups are named lists of colors:

{
  type: 'group',
  name: 'Group Name',
  entries: [] // Array of Colors
}

ase.formatAsLess(input)

Takes the output of the read function, and returns a string with LESS variable declarations for the colors.