Node-freeimage NPM

node-freeimage

Node.js wrapper around FreeImage. This package uses FFI, so the FreeImage dynamic library must be installed, see below. If you have any problems, questions or suggestions, please feel free to contact me.

Usage

var fi = require("node-freeimage");

console.log("FreeImage version:", fi.getVersion());

Requirements

Windows or Linux
Installed FreeImage dynamic library, version 3.16.0 or above

Installation

1. Install FreeImage

a) Windows

The FreeImage binary distribution won't work. All exported functions were compiled using the __stdcall calling convention and have names in the DLL like _FreeImage_GetVersion@0. The node-freeimage package assumes that function names are not mangled.

You need to download the source distribution, and compile it using Visual Studio. There are solution files for VS2003, VS2005 and VS2008, but more modern VS versions also work, just open VS2008.sln and let VS upgrade every project. The following settings are needed:

Select Release Mode.
On 32-bit Windows, compile for 32-bit (it's the default), but on 64-bit Windows, compile for 64-bit (MSDN).
In FreeImage.h, find this: #define DLL_CALLCONV __stdcall and replace __stdcall with __cdecl.
If you get errors referring to std::max and std::min, add #include <algorithm> to the #include list of the affected files.

After compilation succeeds, copy FreeImage.dll from the Release directory into the node-freeimage directory.

b) Linux

Download the source distribution, and compile it using GCC:

make

After successful compilation, install it:

sudo make install

2. Install `node-freeimage`

From npmjs.org:

npm install node-freeimage

From bitbucket.org:

npm install git+https://bitbucket.org/koldev/node-freeimage.git

Tests

npm test

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.

Release History

0.1.0 Initial release.
0.2.0 Added the desciption of installation steps.
0.3.0 Added assertions and unit tests for bitmap information functions.
0.4.0 Added assertions and unit tests for file type functions.
0.5.0 Added assertions and unit tests for pixel access functions.
0.6.0 Added assertions and unit tests for conversion functions.
0.7.0 Added assertions and unit tests for tone mapping operators.
0.8.0 Added assertions and unit tests for ICC profile functions.
0.9.0 Added assertions and unit tests for multipage functions.
0.10.0 Added assertions and unit tests for compression functions.
0.11.0 Added assertions and unit tests for helper functions.
0.12.0 Added assertions and unit tests for tag creation and destruction functions.
0.13.0 Added assertions and unit tests for tag accessor functions.
0.14.0 Added assertions and unit tests for metadata iterator functions.
0.15.0 Added assertions and unit tests for metadata accessor functions.
0.16.0 Added assertions and unit tests for metadata helper functions.
0.17.0 Added assertions and unit tests for rotation and flipping functions.
0.18.0 Added assertions and unit tests for up- and downsampling functions.
0.19.0 Added assertions and unit tests for color manipulation functions.
0.20.0 Added assertions and unit tests for channel processing functions.
0.21.0 Added assertions and unit tests for copy, paste, and composite routines.
0.22.0 Added assertions and unit tests for JPEG transformation functions.
0.23.0 Added assertions and unit tests for background filling functions.
0.24.0 Added assertions and unit tests for miscellaneous functions.