Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

icodec

Package Overview
Dependencies
Maintainers
1
Versions
8
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

icodec

WebAssembly image encoders & decoders

  • 0.3.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
3
decreased by-83.33%
Maintainers
1
Weekly downloads
 
Created
Source

icodec

NPM Version

Image encoders & decoders built with WebAssembly.

ModuleEncoderDecoder
jpegMozJPEG
pngOxiPNG + imagequantimage-png
qoiqoi
webplibwebp
heiclibheif + x265libheif + libde265
aviflibavif + aom
jxllibjxl
wp2libwebp2

[!WARNING] Since libheif does not support specify thread count for x265 encoder, call encode of the heic module must in webworker, and it does not support Node.

Usage

Requirement: The target environment must support WebAssembly SIMD.

pnpm add icodec

Use in browser:

// All codec modules (see the table above) are named export.
import { avif, jxl } from "icodec";

const response = await fetch("https://raw.githubusercontent.com/Kaciras/icodec/master/test/snapshot/image.avif")

// This should be called once before you invoke `decode()`
await avif.loadDecoder();

// Decode AVIF to ImageData.
const image = avif.decode(await response.arrayBuffer());

// Encode the image to JPEG XL, also need to load the encoder WASM first.
await jxl.loadEncoder();

/*
 * The image parameter must have properties:
 * {
 *     width: number;
 *     height: number;
 *     data: Uint8Array | Uint8ClampedArray;
 * }
 */
const encoded = jxl.encode(image, /*{ options }*/);

Each codec module exports:

  • loadEncoder(input?): Load the encoder WASM file, must be called once before encode, it accepts an optional argument:

    • If pass a string, it's the URL of WASM file to fetch.
    • If pass a ArrayBuffer or ArrayBufferView, it will be treated as the WASM bytes.

    This function returns the underlying WASM module, which is not part of the public API and can be changed at any time.

  • encode(imageData, options?): Encode an image with RGBA pixels data.

  • loadDecoder(input?): Like loadEncoder, but for decode.

  • decode(uint8Array): Convert the image to RGBA data, the return value is an ImageData type.

  • mimeType: The MIME type string of the codec.

  • extension: File extension of the format.

  • defaultOptions: The default options for encode function.

  • type Options: Type definition of the encode options.

The png module export extra members:

  • reduceColors(imageData, options?): Reduces the colors used in the image at a slight loss, returns Uint8Array.
  • type QuantizeOptions: Type definition of the options in reduceColors.

To use icodec in Node, just change the import specifier to icodec/node, and loadEncoder/loadDecoder will use readFileSync instead of fetch.

import { avif, jxl } from "icodec/node";

If your bundler requires special handing of WebAssembly, you can pass the URL of WASM files to load* function. WASM files are exported in the format icodec/<codec>-<enc|dec>.wasm.

import { avif, jxl } from "icodec";

// Example for Vite
import AVIFEncWASM from "icodec/avif-enc.wasm?url";
import JxlDecWASM from "icodec/jxl-dec.wasm?url";

await avif.loadDecoder(AVIFEncWASM);
await jxl.loadEncoder(JxlDecWASM);

Contribute

To build WASM modules, you will need to install:

Run the build script:

node build.js

TODOs:

  • Could it be possible to remove HEIC encoder dependency on pthread, or limit the number of threads?
  • vvenc cannot be compiled with Emscripten.

Rnn tests:

pnpm exec tsc
node --test test/test-*.js

Start web demo:

node start-demo.js

Keywords

FAQs

Package last updated on 12 Aug 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc