TheImageDecoder() constructor creates a newImageDecoder object which unpacks and decodes image data.

Syntax

new ImageDecoder(init)

Parameters

init

An object containing the following members:

type

A string containing theMIME type of the image file to be decoded.

data

AnArrayBuffer, aTypedArray, aDataView, or aReadableStream of bytes representing an encoded image type as described bytype.

premultiplyAlphaOptional

Specifies whether the decoded image's color channels should be premultiplied by the alpha channel. If not provided set as"default":

• "none"
• "premultiply"
• "default"

colorSpaceConversionOptional

Specifies whether the image should be decoded using color space conversion. If not provided set as"default". The value"default" indicates that implementation-specific behavior is used:

• "none"
• "default"

desiredWidthOptional

An integer indicating the desired width for the decoded output. Has no effect unless the image codec supports variable resolution decoding.

desiredHeightOptional

An integer indicating the desired height for the decoded output. Has no effect unless the image codec supports variable resolution decoding.

preferAnimationOptional

ABoolean indicating whether the initial track selection should prefer an animated track.

transfer

An array ofArrayBuffers thatImageDecoder will detach and take ownership of. If the array contains theArrayBuffer backingdata,ImageDecoder will use that buffer directly instead of copying from it.

Examples

The following example creates a newImageDecoder with the required options.

let init = {  type: "image/png",  data: imageByteStream,};let imageDecoder = new ImageDecoder(init);

Specifications

Browser compatibility