1IM_RECOMB(3) Library Functions Manual IM_RECOMB(3)
2
3
4
6 im_recomb - matrix recombination of image
7
9 #include <vips/vips.h>
10
11 int im_recomb(imagein, imageout, mat)
12 IMAGE *imagein, *imageout;
13 DOUBLEMASK *mat;
14
15
17 im_recomb() recombines the elements of an m band image to form an n
18 band image using mat, an m by n matrix of floating point numbers.
19
20 It calculates
21
22 A = B x C
23
24 where A is an n band output image, C is an m band input image and B is
25 an m by n matrix of floats. Can be used with a 3 by 3 matrix to perform
26 simple colour space transforms; 7 by 30 matrix to shrink 3rd order
27 development of 3 filter system to XYZ etc.
28
29 The output type is float unless the input type is double, in which case
30 the output type is double. It does not work for complex image types.
31 All intermediates are calculated as double. Note that the width of the
32 matrix should be equal to the number of bands in the input image.
33
34
36 The function returns 0 on success and -1 on error.
37
39 im_read_dmask(3), im_matinv(3), im_lintra(3)
40
42 National Gallery and Birkbeck College, 1990 - 1996
43
44
45
46 11 April 1990 IM_RECOMB(3)