forked from pkrumins/node-image
/
readme.txt
68 lines (42 loc) · 2.08 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
This is a node.js module that unifies node-png, node-gif and node-jpeg modules.
It was written by Peteris Krumins (peter@catonmat.net).
His blog is at http://www.catonmat.net -- good coders code, great reuse.
------------------------------------------------------------------------------
Overview
--------
Node-image module abstracts over node-png, node-gif and node-jpeg modules.
Currently it exports `Image` and `Stack` objects.
Use the `Image` object to encode individual images of a specific width
and height. For example:
var Image = require('image');
var png = new Image('png').encode(buffer, width, height);
var gif = new Image('gif').encode(buffer, widht, height);
var jpeg = new Image('jpeg').encode(buffer, width, height);
The buffers must be of node's `Buffer` type and they must hold either RGB, BGR,
RGBA or BGRA values. The `Image` object defaults to RGB, to use a differnet
buffer type, pass it as the 2nd argument to `Image's` constructor:
var png = new Image('png', 'bgra').encode(buffer, 800, 600);
The `Stack` object is used to create dynamic stacks of images. What I mean by
that is that you can push an image to position (x, y) = (20, 40) and then push
another image to position (x, y) = (1000, 2000), and the image will grow
dynamically. Here is hot to use it:
var Stack = require('image').Stack;
var pngStack = new Stack('png');
pngStack.push(buffer, x, y, width, height);
var png = pngStack.encode();
Dependencies
------------
This module depends on:
* node-png: http://github.com/pkrumins/node-png
* node-gif: http://github.com/pkrumins/node-gif
* node-jpeg: http://github.com/pkrumins/node-jpeg
Each of these modules comes with documentation. Follow the installation steps
to get them installed.
The steps for all the modules are all the same, run:
node-waf configure build
in each module's directory.
------------------------------------------------------------------------------
Have fun producing images!
Sincerely,
Peteris Krumins
http://www.catonmat.net