CanvasRenderingContext2D: imageSmoothingQuality property

{{APIRef("Canvas API")}}

The imageSmoothingQuality property of the {{domxref("CanvasRenderingContext2D")}} interface, part of the Canvas API, lets you set the quality of image smoothing.

[!NOTE] For this property to have an effect, {{domxref("CanvasRenderingContext2D.imageSmoothingEnabled", "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

{{ EmbedLiveSample('Setting_image_smoothing_quality', 700, 180) }}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• The interface defining this property: {{domxref("CanvasRenderingContext2D")}}
• {{domxref("CanvasRenderingContext2D.imageSmoothingEnabled")}}
• {{cssxref("image-rendering")}}