MDN wants to learn about developers like you:

Наши волонтёры ещё не перевели данную статью на Русский. Присоединяйтесь к нам и помогите сделать эту работу!
Вы можете также прочитать эту статью на English (US).

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

The CanvasRenderingContext2D.imageSmoothingEnabled property of the Canvas 2D API can be set to change if images are smoothed (true, default) or not (false). On getting the imageSmoothingEnabled property, the last value it was set to, is returned.

This property is useful for pixel-art themed games, when scaling the canvas for example. The default resizing algorithm can create blurry effects and ruins the beautiful pixels. Set this property to false in that case. See also the CSS image-rendering property.


ctx.imageSmoothingEnabled = value;


A Boolean indicating whether to smooth images or not.


Using the imageSmoothingEnabled property

This is just a simple code snippet using the imageSmoothingEnabled property with a scaled image.


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


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

var img = new Image();
img.src = '';
img.onload = function() {
 ctx.mozImageSmoothingEnabled = false;
 ctx.webkitImageSmoothingEnabled = false;
 ctx.msImageSmoothingEnabled = false;
 ctx.imageSmoothingEnabled = false;
 ctx.drawImage(img, 0, 0, 400, 200);

Edit the code below and see your changes update live in the canvas:


Specification Status Comment
HTML Living Standard
The definition of 'CanvasRenderingContext2D.imageSmoothingEnabled' in that specification.
Living Standard  

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support


Yes — 30 webkit



Yes — 51 moz

Yes ? ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support30 ? Yes


Yes — 51 moz

? ? ?

See also

Метки документа и участники

 Внесли вклад в эту страницу: fscholz, mattwojo, nmve, teoli
 Обновлялась последний раз: fscholz,