Expose libvips recombination matrix operation #1477

docs/api-operation.md

@@ -254,6 +254,35 @@ Apply the linear formula a \* input + b to the image (levels adjustment)
 -   `b` **[Number][1]** offset (optional, default `0.0`)
 
 
+-   Throws **[Error][5]** Invalid parameters
+
+Returns **Sharp** 
+
+## recomb
+
+Recomb the image with the specified matrix.
+
+### Parameters
+
+-   `inputMatrix`  
+-   `3x3` **[Array][7]<[Array][7]<[Number][1]>>** Recombination matrix
+
+### Examples
+
+```javascript
+sharp(input)
+  .recomb([
+   [0.3588, 0.7044, 0.1368],
+   [0.2990, 0.5870, 0.1140],
+   [0.2392, 0.4696, 0.0912],
+  ])
+  .raw()
+  .toBuffer(function(err, data, info) {
+    // data contains the raw pixel data after applying the recomb
+    // With this example input, a sepia filter has been applied
+  });
+```
+
 -   Throws **[Error][5]** Invalid parameters
 
 Returns **Sharp** 

docs/changelog.md

@@ -25,6 +25,10 @@ Requires libvips v8.7.0.
   [#1475](https://github.com/lovell/sharp/pull/1475)
   [@jaubourg](https://github.com/jaubourg)
 
+* Expose libvips' recombination matrix operation.
+  [#1477](https://github.com/lovell/sharp/pull/1477)
+  [@fromkeith](https://github.com/fromkeith)
+
 #### v0.21.0 - 4<sup>th</sup> October 2018
 
 * Deprecate the following resize-related functions:

docs/index.md

@@ -120,6 +120,7 @@ the help and code contributions of the following people:
 * [Axel Eirola](https://github.com/aeirola)
 * [Freezy](https://github.com/freezy)
 * [Julian Aubourg](https://github.com/jaubourg)
+* [Keith Belovay](https://github.com/fromkeith)
 
 Thank you!