CanvasRenderingContext2D.imageSmoothingQuality

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The imageSmoothingQuality property of the CanvasRenderingContext2D interface, part of the Canvas API, lets you set the quality of image smoothing.

Note: For this property to have an effect, imageSmoothingEnabled must be true.

Syntax

ctx.imageSmoothingQuality = "low" || "medium" || "high"

Options

Possible values:

"low"

Low quality.

"medium"

Medium quality.

"high"

High quality.

Example

Setting image smoothing quality

This example uses the imageSmoothingQuality property with a scaled image.

HTML

<canvas id="canvas"></canvas>

JavaScript

const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');

let img = new Image();
img.src = 'canvas_createpattern.png';
img.onload = function() {
  ctx.imageSmoothingQuality = 'low';
  ctx.drawImage(img, 0, 0, 300, 150);
};

Result

Specifications

Specification
HTML Standard (HTML)
# dom-context-2d-imagesmoothingquality-dev

Browser compatibility

BCD tables only load in the browser

See also