A C++ module for node-js that converts RGB and RGBA buffers to a JPEG images (in memory).
This is a node.js module, writen in C++, that uses libjpeg to produce a JPEG image (in memory) from a buffer of RGBA or RGB values. Since JPEG has no notion of A (alpha), the module always uses just RGB values.
It was written by Peteris Krumins (firstname.lastname@example.org). His blog is at http://www.catonmat.net -- good coders code, great reuse.
The module exports three objects: Jpeg, FixedJpegStack, DynamicJpegStack.
Jpeg allows to create fixed size jpegs from RGB, BGR, RGBA or BGRA buffers. FixedJpegStack allows to push multiple jpegs to a fixed size canvas. DynamicJpegStack allows to push multiple jpegs to a dynamic size canvas (it grows as you push jpegs to it).
All objects provide synchronous and asynchronous interfaces.
Jpeg object that takes 4 arguments in its constructor:
var jpeg = buffer width height buffer_type;
The first argument,
buffer, is a nodee.js
Buffer filled with RGBA or RGB
The second argument is integer width of the image.
The third argument is integer height of the image.
The fourth argument is buffer type, either 'rgb' or 'rgba'. [Optional].
After you have constructed the object, call .encode() or .encodeSync to produce a jpeg:
var jpeg_image = jpegencodeSync; // synchronous encoding (blocks node.js)
jpegencode// jpeg image is in 'image';
examples/ directory for examples.
First you create a FixedJpegStack object of fixed width and height:
var stack = width height buffer_type;
Then you can push individual fragments to it, for example,
stackpushbuf1 10 11 100 200; // pushes buf1 to (x,y)=(10,11)// 100 and 200 are width and height.// more pushes
After you're done, call
.encode() to produce final jpeg asynchronously or
.encodeSync() (just like in Jpeg object). The final jpeg will be of size
width x height.
DynamicJpegStack is the same as FixedJpegStack except its canvas grows dynamically.
First, create the stack:
var stack = buffer_type;
Next push the RGB(A) buffers to it:
stackpushbuf1 5 10 100 40;stackpushbuf2 2 210 20 20;
Now you can call
encode to produce the final jpeg:
var jpeg = stackencodeSync;
Now let's see what the dimensions are,
var dims = stackdimensions;
stackencode// jpeg is the image// dims are its dimensions;
In this particular example:
The x position
dims.x is 2 because the 2nd jpeg is closer to the left.
The y position
dims.y is 10 because the 1st jpeg is closer to the top.
dims.width is 103 because the first jpeg stretches from x=5 to
x=105, but the 2nd jpeg starts only at x=2, so the first two pixels are not
necessary and the width is 105-2=103.
dims.height is 220 because the 2nd jpeg is located at 210 and
its height is 20, so it stretches to position 230, but the first jpeg starts
at 10, so the upper 10 pixels are not necessary and height becomes 230-10= 220.
##How to install?
To get it compiled, you need to have libjpeg and node installed. Then just run
node-waf configure build
to build the Jpeg module. It will produce a
jpeg.node file as the module.
See also http://github.com/pkrumins/node-png module that produces PNG images. See also http://github.com/pkrumins/node-gif module that produces GIF images.
Sincerely, Peteris Krumins http://www.catonmat.net