utils/image

Helper module for image processing.

These functions and classes are only used internally, meaning an end-user shouldn’t need to access anything here.

• utils/image
  • static
    • .RawImage
      • new RawImage(data, width, height, channels)
      • instance
        • .size ⇒ *
        • .grayscale() ⇒ RawImage
        • .rgb() ⇒ RawImage
        • .rgba() ⇒ RawImage
        • .putAlpha(mask) ⇒ RawImage
        • .resize(width, height, options) ⇒ Promise.<RawImage>
        • .split() ⇒ Array.<RawImage>
        • .clone() ⇒ RawImage
        • .convert(numChannels) ⇒ RawImage
        • .save(path)
      • static
        • .read(input) ⇒ *
        • .fromCanvas(canvas) ⇒ RawImage
        • .fromURL(url) ⇒ Promise.<RawImage>
        • .fromBlob(blob) ⇒ Promise.<RawImage>
        • .fromTensor(tensor)
    • .load_image
  • inner
    • ~CONTENT_TYPE_MAP

utils/image.RawImage

Kind: static class of utils/image

• .RawImage
  • new RawImage(data, width, height, channels)
  • instance
    • .size ⇒ *
    • .grayscale() ⇒ RawImage
    • .rgb() ⇒ RawImage
    • .rgba() ⇒ RawImage
    • .putAlpha(mask) ⇒ RawImage
    • .resize(width, height, options) ⇒ Promise.<RawImage>
    • .split() ⇒ Array.<RawImage>
    • .clone() ⇒ RawImage
    • .convert(numChannels) ⇒ RawImage
    • .save(path)
  • static
    • .read(input) ⇒ *
    • .fromCanvas(canvas) ⇒ RawImage
    • .fromURL(url) ⇒ Promise.<RawImage>
    • .fromBlob(blob) ⇒ Promise.<RawImage>
    • .fromTensor(tensor)

new RawImage(data, width, height, channels)

Create a new RawImage object.

rawImage.size ⇒ <code> * </code>

Returns the size of the image (width, height).

Kind: instance property of RawImage
Returns: * - The size of the image (width, height).

rawImage.grayscale() ⇒ <code> RawImage </code>

Convert the image to grayscale format.

Kind: instance method of RawImage
Returns: RawImage - this to support chaining.

rawImage.rgb() ⇒ <code> RawImage </code>

Convert the image to RGB format.

Kind: instance method of RawImage
Returns: RawImage - this to support chaining.

rawImage.rgba() ⇒ <code> RawImage </code>

Convert the image to RGBA format.

Kind: instance method of RawImage
Returns: RawImage - this to support chaining.

rawImage.putAlpha(mask) ⇒ <code> RawImage </code>

Apply an alpha mask to the image. Operates in place.

Kind: instance method of RawImage
Returns: RawImage - The masked image.
Throws:

• Error If the mask is not the same size as the image.
• Error If the image does not have 4 channels.
• Error If the mask is not a single channel.

rawImage.resize(width, height, options) ⇒ <code> Promise. < RawImage > </code>

Resize the image to the given dimensions. This method uses the canvas API to perform the resizing.

Kind: instance method of RawImage
Returns: Promise.<RawImage> - this to support chaining.

rawImage.split() ⇒ <code> Array. < RawImage > </code>

Split this image into individual bands. This method returns an array of individual image bands from an image. For example, splitting an “RGB” image creates three new images each containing a copy of one of the original bands (red, green, blue).

Inspired by PIL’s Image.split() function.

Kind: instance method of RawImage
Returns: Array.<RawImage> - An array containing bands.

rawImage.clone() ⇒ <code> RawImage </code>

Clone the image

Kind: instance method of RawImage
Returns: RawImage - The cloned image

rawImage.convert(numChannels) ⇒ <code> RawImage </code>

Helper method for converting image to have a certain number of channels

Kind: instance method of RawImage
Returns: RawImage - this to support chaining.

rawImage.save(path)

Save the image to the given path.

Kind: instance method of RawImage

RawImage.read(input) ⇒ <code> * </code>

Helper method for reading an image from a variety of input types.

Kind: static method of RawImage
Returns: * - The image object.

Example: Read image from a URL.

let image = await RawImage.read('https://huggingface.co/datasets/Xenova/transformers.js-docs/resolve/main/football-match.jpg');
// RawImage 

RawImage.fromCanvas(canvas) ⇒ <code> RawImage </code>

Read an image from a canvas.

Kind: static method of RawImage
Returns: RawImage - The image object.

RawImage.fromURL(url) ⇒ <code> Promise. < RawImage > </code>

Read an image from a URL or file path.

Kind: static method of RawImage
Returns: Promise.<RawImage> - The image object.

RawImage.fromBlob(blob) ⇒ <code> Promise. < RawImage > </code>

Helper method to create a new Image from a blob.

Kind: static method of RawImage
Returns: Promise.<RawImage> - The image object.

RawImage.fromTensor(tensor)

Helper method to create a new Image from a tensor

Kind: static method of RawImage

utils/image.load_image

Helper function to load an image from a URL, path, etc.

Kind: static constant of utils/image

utils/image~CONTENT_TYPE_MAP

Mapping from file extensions to MIME types.

Kind: inner constant of utils/image