Transformers.js documentation

utils/image

You are viewing main version, which requires installation from source. If you'd like regular npm install, checkout the latest stable version (v3.0.0).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

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.RawImage

Kind: static class of utils/image


new RawImage(data, width, height, channels)

Create a new RawImage object.

ParamTypeDescription
dataUint8ClampedArray | Uint8Array

The pixel data.

widthnumber

The width of the image.

heightnumber

The height of the image.

channels1 | 2 | 3 | 4

The number of channels.


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.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.

ParamTypeDescription
widthnumber

The width of the new image.

heightnumber

The height of the new image.

optionsObject

Additional options for resizing.

[options.resample]0 | 1 | 2 | 3 | 4 | 5 | string

The resampling method to use.


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.

ParamTypeDescription
numChannelsnumber

The number of channels. Must be 1, 3, or 4.


rawImage.save(path)

Save the image to the given path.

Kind: instance method of RawImage

ParamTypeDescription
pathstring

The path to save the image to.


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 
ParamType
inputRawImage | string | URL

RawImage.fromCanvas(canvas) β‡’ <code> RawImage </code>

Read an image from a canvas.

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

ParamTypeDescription
canvasHTMLCanvasElement | OffscreenCanvas

The canvas to read the image from.


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.

ParamTypeDescription
urlstring | URL

The URL or file path to read the image from.


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.

ParamTypeDescription
blobBlob

The blob to read the image from.


RawImage.fromTensor(tensor)

Helper method to create a new Image from a tensor

Kind: static method of RawImage

ParamType
tensorTensor

utils/image~CONTENT_TYPE_MAP

Mapping from file extensions to MIME types.

Kind: inner constant of utils/image


< > Update on GitHub