CanvasRenderingContext2D: imageSmoothingQuality property

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.

Value

One of the following:

• "low"
  • : Low quality.
• "medium"
  • : Medium quality.
• "high"
  • : High quality.

The default value is "low".

Examples

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_create_pattern.png";
img.onload = () => {
  ctx.imageSmoothingQuality = "low";
  ctx.drawImage(img, 0, 0, 300, 150);
};

Result

Specifications

Browser compatibility

See also

• The interface defining this property: CanvasRenderingContext2D
• imageSmoothingEnabled
• image-rendering