https://github.com/catdad-experiments/dcraw-vendored
👌 dcraw, already compiled for you
https://github.com/catdad-experiments/dcraw-vendored
darwin dcraw images linux macos npm-package photography windows
Last synced: 3 months ago
JSON representation
👌 dcraw, already compiled for you
- Host: GitHub
- URL: https://github.com/catdad-experiments/dcraw-vendored
- Owner: catdad-experiments
- Created: 2019-04-13T00:53:26.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-04-19T15:14:35.000Z (about 7 years ago)
- Last Synced: 2025-03-02T17:06:23.419Z (over 1 year ago)
- Topics: darwin, dcraw, images, linux, macos, npm-package, photography, windows
- Language: C
- Homepage:
- Size: 227 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# dcraw vendored
[![travis][travis.svg]][travis.link]
[![appveyor][appveyor.svg]][appveyor.link]
[travis.svg]: https://travis-ci.org/catdad-experiments/dcraw-vendored.svg?branch=master
[travis.link]: https://travis-ci.org/catdad-experiments/dcraw-vendored
[appveyor.svg]: https://ci.appveyor.com/api/projects/status/github/catdad-experiments/dcraw-vendored?branch=master&svg=true
[appveyor.link]: https://ci.appveyor.com/project/catdad/dcraw-vendored
This projects distributes the `dcraw` binary through a series of npm modules, in order to allow using the binaries through `child_process`. This project compiles and distributes binaries for the following operating systems:
* Linux: [dcraw-vendored-linux](https://www.npmjs.com/package/dcraw-vendored-linux)
* Windows: [dcraw-vendored-win32](https://www.npmjs.com/package/dcraw-vendored-win32)
* MacOS: [dcraw-vendored-darwin](https://www.npmjs.com/package/dcraw-vendored-darwin)
If you don't want to think about operating systems, consider installing [dcrawr](https://www.npmjs.com/package/dcrawr) instead, which integrates these modules.
All the modules can be in the following way:
```javascript
const dcraw = require('dcraw-vendored-linux');
const { promisify } = require('util');
const { execFile } = require('child_process');
// call dcraw with any command line arguments you want
// bonus points: it's a promise now
promisify(execFile)(dcraw, ['-w', '-W', 'my-image.dng'])
.then(result => {
console.log(result);
}).catch(err => {
console.error(err);
});
```
You might also want to get the image returned in standard out rather than written to a file. You can follow these general rules:
```javascript
const dcraw = require('dcraw-vendored-linux');
const { promisify } = require('util');
const { execFile } = require('child_process');
const fs = require('fs');
// -c will write the data to stdout
promisify(execFile)(dcraw, ['-c', 'my-image.dng'], {
// hide the extra window on Windows
windowsHide: true,
// we want the raw data, not a string
encoding: 'buffer',
// 8-bit PPMs are roughly 3x bigger than the original raw file
// so you should set this number fairly high
maxBuffer: 1024 * 1024 * 100
})
.then(result => {
// don't use the sync method... you get the idea though
fs.writeFileSync('./my-image.ppm', result.stdout);
}).catch(err => {
console.error(err);
});
```
## Versions
The versions of these packages will follow the versions of `dcraw` itself. For example, version `9.28` of `dcraw` will be published as `9.28.x`, with path versions reflecting updates to the surrounding module (likely related to the build, as there isn't much to the module itself). However, I do not know how `dcraw` itself is versioned, so I recommend pinning this dependency just in case.
All versions are compiled using `NODEPS`, so some functionality may not work. Please look at the original source code for information on what functionality is provided by dependencies. If you'd like to see any dependencies included, please feel free to submit a PR.
## License
The original [`dcraw` code by Dave Coffin](https://www.cybercom.net/~dcoffin/dcraw/) is compiled without modifications. Regardless of modification, these modules are distributed under the GPL version 2 license, because that is what the header in the source code says and I do not want to get in trouble.
To the extent possible under law, I am waiving all copyright and related or neighboring rights to the build scripts and build-related code in this repository.