Skip to content

Latest commit

 

History

History
347 lines (247 loc) · 8.25 KB

README.md

File metadata and controls

347 lines (247 loc) · 8.25 KB
Raw

extractd

NPM version Downloads CircleCI

Extract previews from DSLR and mirrorless cameras' RAW files.

Installation

npm i extractd

Examples

Multiple examples can be located in examples directory

Usage

Workflow allows to extract previews directly from RAW files. Available options:

  • compact optional (boolean) - returns compact list of the preview files (defaults to false).
  • destination optional (string) - directory where preview image will be saved to; if destination does not exists it will be created (defaults to OS temp directory).
  • stream optional (boolean) - by default exif process generates the preview file in the temp directory in the OS or in destination if provided; once enabled preview is returned as a readeble stream which source will by automatically deleted after fully piped (defaults to false).
  • base64 optional (boolean) - returns base64 encoded preview string (defaults to false)
  • datauri optional (boolean) - returns datauri base64 encoded preview string (defaults to false).
  • persist optional (boolean) - by default exif process will be initialised and killed of per extractd call; with persist enabled same exif process can be used across all calls for single file and batch processing (defaults to false).

Orientation of extracted images will be corrected based on metadata available in the source file.

Basic usage

const extractd = require('extractd');

(async () => {

    const done = await extractd.generate('/directory/nikon_d850_01.nef');

})();

Response done (object) will be similar to:

  {
    preview: '/tempdirectory/nikon_d850_01.jpg',
    source: '/directory/nikon_d850_01.nef'
  }
  • preview - location of the preview image
  • source - location of the original RAW image

Base64 usage

const extractd = require('extractd');

(async () => {

    const done = await extractd.generate('/directory/nikon_d850_01.nef', {
        base64: true,
        datauri: true
    });

})();

Response done (object) will be similar to:

  {
    preview: 'data:image/jpeg;base64,/9j/2wCEAAQGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHR...',
    source: '/directory/nikon_d850_01.nef'
  }
  • preview - datauri base64 preview image
  • source - location of the original RAW image

Persistent status check

const done = await extractd.generate('/directory/nikon_d850_01.nef', {
  persist: true,
  destination: '/directory/'
});

const status = extractd.status();

const desist = await extractd.desist();

Response done (object) will be similar to:

  {
    preview: '/directory/nikon_d850_01.jpg',
    source: '/directory/nikon_d850_01.nef'
  }

Response status (object) will be similar to:

{
  persistent: true
}
  • persistent - status indicates that exif process is already live and additional calls can join in or next call should terminate it

Response desist (object) will be similar to:

{
  persistent: false
}
  • persistent - exif process has been killed off with desist and additional calls with persist would start new exif process

Basic stream usage

const extractd = require('extractd');
const pipeline = require('util').promisify(require('stream').pipeline);

(async () => {

    const done = await extractd.generate('/directory/nikon_d850_01.nef', {
        stream: true
    });

    await pipeline(done.preview, require('fs').createWriteStream('/my/new/directory/nikon_d850_01.jpg'));

})();

Response done (object) will be similar to:

  {
    preview: ReadStream,
    source: '/directory/nikon_d850_01.nef'
  }
  • preview - readable stream which source will be deleted once fully piped
  • source - location of the original RAW image

Base64 stream usage

const extractd = require('extractd');
const pipeline = require('util').promisify(require('stream').pipeline);

(async () => {

    const done = await extractd.generate('/directory/nikon_d850_01.nef', {
        stream: true,
        base64: true,
        datauri: true
    });

    await pipeline(done.preview, require('fs').createWriteStream('/my/new/directory/nikon_d850_01.txt'));

})();

Response done (object) will be similar to:

  {
    preview: ReadStream,
    source: '/directory/nikon_d850_01.nef'
  }
  • preview - readable datauri base64 stream
  • source - location of the original RAW image

Complex usage

const canon = await extractd.generate('/directory/canon_eos_5d_mark_iv_01.cr2', {
  compact: true,
  persist: true
});

const nikon = await extractd.generate('/directory/nikon_d850_01.nef', {
  compact: true,
  persist: true
});

const panasonic = await extractd.generate('/directory/panasonic_s1r_01.rw2', {
  compact: true
});

const done = [canon, nikon, panasonic];

Response done (array) will be similar to:

[
  '/tempdirectory/canon_eos_5d_mark_iv_01.jpg',
  '/tempdirectory/nikon_d850_01.jpg',
  '/tempdirectory/panasonic_s1r_01.jpg'
]

As persist option was used only single exif process was used across all three calls. Last item terminates exif process as persist defaults to false.

Batch usage

const extractd = require('extractd');

(async () => {

    const done = await extractd.generate([
      '/directory/nikon_d850_01.nef',
      '/directory/sony_a7r_iii_01.arw',
      '/directory/pentax_k_1_mark_ii_01.dng'
    ]);

})();

Response done (array) will be similar to:

  [
    {
      preview: '/tempdirectory/nikon_d850_01.jpg',
      source: '/directory/nikon_d850_01.nef'
    },
    {
      preview: '/tempdirectory/sony_a7r_iii_01.jpg',
      source: '/directory/sony_a7r_iii_01.arw'
    },
    {
      preview: '/tempdirectory/pentax_k_1_mark_ii_01.jpg',
      source: '/directory/pentax_k_1_mark_ii_01.dng'
    }
  ]

Advanced usage

const extractd = require('extractd');

(async () => {

    const batch = await extractd.generate([
      '/directory/nikon_d850_01.nef',
      '/directory/sony_a7r_iii_01.arw',
      '/directory/pentax_k_1_mark_ii_01.dng'
    ], {
      persist: true
    });

    const file01 = await extractd.generate('/directory/fujifilm_gfx_50s_01.raf', {
      persist: true
    });

    const file02 = await extractd.generate('/directory/panasonic_s1r_01.rw2');

    const done = [...batch, ...[file01], ...[file02]];

})();

Response done (array) will be similar to:

  [
    {
      preview: '/tempdirectory/nikon_d850_01.jpg',
      source: '/directory/nikon_d850_01.nef'
    },
    {
      preview: '/tempdirectory/sony_a7r_iii_01.jpg',
      source: '/directory/sony_a7r_iii_01.arw'
    },
    {
      preview: '/tempdirectory/pentax_k_1_mark_ii_01.jpg',
      source: '/directory/pentax_k_1_mark_ii_01.dng'
    },
    {
      preview: '/tempdirectory/fujifilm_gfx_50s_01.jpg',
      source: '/directory/fujifilm_gfx_50s_01.raf'
    },
    {
      preview: '/tempdirectory/panasonic_s1r_01.jpg',
      source: '/directory/panasonic_s1r_01.rw2'
    }
  ]

As persist option was used only single exif process was used across all three calls. Last item terminates exif process as persist defaults to false.

Errors

All erros are resolved and fallow similar convention:

const extractd = require('extractd');

(async () => {

    const done = await extractd.generate('/directory/dummyFile.nef');

})();

Response done (object) will be similar to:

{
  error: 'File not found',
  source: '/directory/dummyFile.nef'
}

Tests

To run all available tests

npm test

Test samples

All test samples are based on original raw files sourced from photography blog, hasselblad, and imaging-resource sites.

License

The MIT License (MIT). Please see license file for more information.