feat(image): support Transformer from raw rgba pixels

Author: Brooooooklyn

package.json

@@ -16,6 +16,7 @@
     "@types/node": "^17.0.23",
     "@types/sharp": "^0.30.1",
     "ava": "^4.1.0",
+    "blurhash": "^1.1.5",
     "lerna": "^4.0.0",
     "npm-run-all": "^4.1.5",
     "prettier": "^2.6.2",

packages/binding/__test__/blurhash.webp

@@ -3,10 +3,12 @@ import { join } from 'path'
 import { fileURLToPath } from 'url'
 
 import test from 'ava'
+import { decode } from 'blurhash'
 
 import { Transformer } from '../index.js'
 
-const ROOT_DIR = join(fileURLToPath(import.meta.url), '..', '..', '..', '..')
+const __DIRNAME = join(fileURLToPath(import.meta.url), '..')
+const ROOT_DIR = join(__DIRNAME, '..', '..', '..')
 
 const PNG = await fs.readFile(join(ROOT_DIR, 'un-optimized.png'))
 const JPEG = await fs.readFile(join(ROOT_DIR, 'un-optimized.jpg'))
@@ -38,3 +40,10 @@ test('should be able to encode into webp', async (t) => {
   const decoder = new Transformer(PNG)
   await t.notThrowsAsync(() => decoder.webp(75))
 })
+
+test('should be able to create transformer from raw rgba pixels', async (t) => {
+  const pixels = decode('LEHV6nWB2yk8pyo0adR*.7kCMdnj', 32, 32)
+  const webp = await Transformer.fromRgbaPixels(pixels, 32, 32).webpLossless()
+  const webpSnapshot = await fs.readFile(join(__DIRNAME, 'blurhash.webp'))
+  t.deepEqual(webp, webpSnapshot)
+})

packages/binding/__test__/decoder.spec.mjs.md

@@ -0,0 +1,48 @@
+# Snapshot report for `packages/binding/__test__/transformer.spec.mjs`
+
+The actual snapshot is saved in `transformer.spec.mjs.snap`.
+
+Generated by [AVA](https://avajs.dev).
+
+## should be able to get exif from jpg
+
+> Snapshot 1
+
+    {
+      Orientation: 'Unknown (5)',
+      'Resolution Unit': 'in',
+      'This image has an Exif SubIFD': '90',
+      'X Resolution': '72 pixels per in',
+      'Y Resolution': '72 pixels per in',
+    }
+
+## should be able to create transformer from raw rgba pixels
+
+> Snapshot 1
+
+    Buffer @Uint8Array [
+      52494646 f8020000 57454250 5650384c ec020000 2f1fc007 004d1069 dba0a1d7
+      bfe28b88 e87f46f9 6141a46d 33ff2a0b 0f2f67e0 09b26de6 4f778422 1ca1ff31
+      1152ce80 03c00000 421b4992 2467f387 b1382bf6 1e101222 497224c9 a3e7d4b3
+      12fc593c 8cdfde74 104992d0 f43ce05f 573c1136 f2f3ef27 cbb2c71e eff1cef6
+      e11d7bf6 8e9dad39 1366da7a ebead6ab 5eddfbea 9eeee99e eed5bb76 bc031980
+      3081a106 b5d85436 016019e1 4f4d0c95 0095b229 6600888d 00408d0a 444a9991
+      94819204 d4b6801a 40b300cd 82444808 7594a100 2115508d 39761462 34a0b94d
+      8c44c188 d1094ac8 a94a880d 9d9c8961 c440abb0 4d299952 89e88449 15555509
+      61468201 8419d46e a554a522 22d580a2 54e9a299 0e1fca36 02038866 b2754985
+      aa52a953 15552ac7 952d0310 0c0304c6 593089a5 0d4b282c 982aae4e 283ec702
+      ff068d6a 97989551 30d250aa aa529d82 21662136 9259dac8 944dabb6 756c6a86
+      2390d2e9 389005c0 400cd6a2 0c76f21f 56a05942 50c5aaea ead2d97e d586dac8
+      9618ca60 02160246 1a08562a 56c5fd86 4c6c28a3 3619c856 99663983 00088e0a
+      5529557f 64b04930 8011b664 04ad00c8 268d8222 9d4aa7fe ce578ce5 c53fa660
+      2de4cc2b b358655b 6404c394 2d694631 c3000831 1a009aa5 91010a26 304803c8
+      68460c62 404c1930 3d8001b1 4c19886d a4910d00 65340b40 19812d41 00831623
+      6d541a46 b377140c 10230620 a3b28ba1 01d5a634 6096960c c200c55a 6b2d606a
+      5bd9d296 6c4b621a 80b46065 9b3f4062 162361b4 d8d4a87d 5c406c43 876dd0d2
+      5a30c50a c32c2d01 9306196c 127b2dd9 0a690298 a1f6b97a a76d8455 620031d4
+      6032830c 80cdc144 56abb1da 1ad50006 a1d810b3 c846e4e3 e6b31844 9443c678
+      4bb386a2 11234680 0543f059 2c318403 32566a35 26990ca0 d8940162 4b2cb3b4
+      b6114644 89c8f2e6 c98c5888 b6550032 9b624066 63398051 a2d41863 2cad4103
+      65c44610 cc6400c2 1d005132 53430d6b 014000c4 c4080d86 c50c6898 c2466d3c
+      a62d6104 60024b6c 0433a4c5 08c38420 0a6a400d 0b10d848 6c0acc12 d6e01f03
+    ]

packages/binding/__test__/decoder.spec.mjs.snap

@@ -129,6 +129,7 @@ export interface Metadata {
 }
 export class Transformer {
   constructor(input: Buffer)
+  static fromRgbaPixels(input: Buffer | Uint8ClampedArray, width: number, height: number): Transformer
   metadata(withExif?: boolean | undefined | null, signal?: AbortSignal | undefined | null): Promise<Metadata>
   /** Rotate with exif orientation */
   rotate(): this

…ckages/binding/__test__/decoder.spec.mjs …es/binding/__test__/transformer.spec.mjspackages/binding/__test__/decoder.spec.mjs renamed to packages/binding/__test__/transformer.spec.mjs packages/binding/__test__/decoder.spec.mjs renamed to packages/binding/__test__/transformer.spec.mjs

@@ -342,12 +342,50 @@ pub struct Transformer {
 #[napi]
 impl Transformer {
   #[napi(constructor)]
-  pub fn new(input: Buffer) -> Result<Transformer> {
-    Ok(Self {
+  pub fn new(input: Buffer) -> Transformer {
+    Self {
       dynamic_image: Arc::new(ThreadSafeDynamicImage::new(input)),
       rotate: false,
       resize: (None, None),
-    })
+    }
+  }
+
+  #[napi]
+  pub fn from_rgba_pixels(
+    input: Either<Buffer, Uint8ClampedArray>,
+    width: u32,
+    height: u32,
+  ) -> Result<Transformer> {
+    if let Some(image) = image::RgbaImage::from_vec(
+      width,
+      height,
+      match input {
+        Either::A(a) => a.to_vec(),
+        Either::B(b) => b.to_vec(),
+      },
+    ) {
+      let image_meta = Box::new(Some(ImageMetaData {
+        color_type: ColorType::Rgba8,
+        orientation: None,
+        image: DynamicImage::ImageRgba8(image),
+        exif: HashMap::new(),
+        format: ImageFormat::Png,
+        has_parsed_exif: true,
+      }));
+      Ok(Self {
+        dynamic_image: Arc::new(ThreadSafeDynamicImage {
+          raw: vec![0].into(),
+          image: Box::into_raw(image_meta),
+        }),
+        rotate: false,
+        resize: (None, None),
+      })
+    } else {
+      Err(Error::new(
+        Status::InvalidArg,
+        format!("Input buffer is not matched the width and height"),
+      ))
+    }
   }
 
   #[napi]

packages/binding/__test__/transformer.spec.mjs.md

@@ -1618,6 +1618,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"blurhash@npm:^1.1.5":
+  version: 1.1.5
+  resolution: "blurhash@npm:1.1.5"
+  checksum: 8a647024948552e7250d4f123a0dc2a56941be476811c1c999b182cde01e6e15cc6938a8c523f1a2fea8c0dc12c1fffc1cf2001b86683e196bed03e88e176af2
+  languageName: node
+  linkType: hard
+
 "brace-expansion@npm:^1.1.7":
   version: 1.1.11
   resolution: "brace-expansion@npm:1.1.11"
@@ -3417,6 +3424,7 @@ __metadata:
     "@types/node": ^17.0.23
     "@types/sharp": ^0.30.1
     ava: ^4.1.0
+    blurhash: ^1.1.5
     lerna: ^4.0.0
     npm-run-all: ^4.1.5
     prettier: ^2.6.2