Media types and the canvas

Basic loading and playing a video on the canvas
The canvas can be used to display videos from a variety of sources. This example shows how to load a video as a file resource, display it and add a simple click on screenplay/pause toggle. This StackOverflow self answered the question How do I display a video using HTML5 canvas tag shows the following example code in action.
Just an image
A video is just an image as far as the canvas is concerned. You can draw it like any image. The difference being the video can play and has sound.
Get canvas and basic setup
// It is assumed you know how to add a canvas and correctly size it.
var canvas = document.getElementById("myCanvas"); // get the canvas from the page
var ctx = canvas.getContext("2d");
var videoContainer; // object to hold video and associated info
Creating and loading the video
var video = document.createElement("video"); // create a video element
video.src = "urlOffVideo.webm";
// the video will now begin to load.
// As some additional info is needed we will place the video in a
// containing object for convenience
video.autoPlay = false; // ensure that the video does not auto play
video.loop = true; // set the video to loop.
videoContainer = { // we will add properties as needed
video : video,
ready : false,
};
Unlike images elements, videos don't have to be fully loaded to be displayed on the canvas. Videos also provide a host of extra events that can be used to monitor status of the video. In this case, we wish to know when the video is ready to play. on can play means that enough of the video has loaded to play some of it, but there may not be enough to play to the end.
video.oncanplay = readyToPlayVideo; // set the event to the play function that can be found below
Alternatively you can use oncanplaythrough which will fire when enough of the video has loaded so that it can be played to the end.
video.oncanplaythrough = readyToPlayVideo;
Only use one of the canPlay events not both.
The can play event (equivalent to image onload)
function readyToPlayVideo(event) { // this is a reference to the video
// the video may not match the canvas size so find a scale to fit
videoContainer.scale = Math.min(
canvas.width / this.videoWidth, canvas.height / this.videoHeight);
videoContainer.ready = true;
// the video can be played so hand it off to the display function
requestAnimationFrame(undateCanvas);
}
Displaying
The video will not play itself on the canvas. You need to draw it for every new frame. As it is difficult to know the exact frame rate and when they occur the best approch is to display the video as if running at 60fps. If the frame rate is lower then w just render the same frame twice. If the frame rate is higher then there is nothing that can be
don to see the extra frames so we just ignore them. The video element is just a image element and can be draw like any image, you can scale, rotate, pan the video, mirror it, fade it, clip it and display only parts, draw it twice the second time with a global composite mode to add FX like lighten, screen, etc..
function updateCanvas() {
ctx.clearRect(0, 0, canvas.width, canvas.height); // Though not always needed
// you may get bad pixels from
// previous videos so clear to be
// safe
// only draw if loaded and ready
if (videoContainer !== undefined && videoContainer.ready) {
// find the top left of the video on the canvas
var scale = videoContainer.scale;
var vidH = videoContainer.video.videoHeight;
var vidW = videoContainer.video.videoWidth;
var top = canvas.height / 2 - (vidH / 2) * scale;
var left = canvas.width / 2 - (vidW / 2) * scale;
// now just draw the video the correct size
ctx.drawImage(videoContainer.video, left, top, vidW * scale, vidH * scale);
if (videoContainer.video.paused) { // if not playing show the paused screen
drawPayIcon();
}
}
// all done for display
// request the next frame in 1/60th of a second
requestAnimationFrame(updateCanvas);
}
Basic play pause control
Now we have the video loaded and displayed all we need is the play control. We will make it as a click toggle play on the screen. When the video is playing and the user clicks the video is paused. When paused the click resumes play. We will add a function to darken the video and draw an play icon (triangle).
function drawPayIcon() {
ctx.fillStyle = "black"; // darken display
ctx.globalAlpha = 0.5;
ctx.fillRect(0, 0, canvas.width, canvas.height);
ctx.fillStyle = "#DDD"; // colour of play icon
ctx.globalAlpha = 0.75; // partly transparent
ctx.beginPath(); // create the path for the icon
var size = (canvas.height / 2) * 0.5; // the size of the icon
ctx.moveTo(canvas.width / 2 + size / 2, canvas.height / 2); // start at the pointy end
ctx.lineTo(canvas.width / 2 - size / 2, canvas.height / 2 + size);
ctx.lineTo(canvas.width / 2 - size / 2, canvas.height / 2 - size);
ctx.closePath();
ctx.fill();
ctx.globalAlpha = 1; // restore alpha
}
Summary
Playing a video is very easy using the canvas, adding effect in real time is also easy. There are however some limitations on formats, how you can play and seek. MDN HTMLMediaElement is the place to get the full reference to the video object. Once the image has been drawn on the canvas you can use ctx.getImageData to access the pixels it contains. Or you can use canvas.toDataURL to snap a still and download it. (Only if the video is from a trusted source and does not taint the canvas). Note if the video has sound then playing it will also play the sound.
Capture canvas and Save as webM video
Creating a WebM video from canvas frames and playing in canvas, or upload, or downloading.
Example capture and play canvas
name = "CanvasCapture"; // Placed into the Mux and Write Application Name fields of the WebM header
quality = 0.7; // good quality 1 Best < 0.7 ok to poor
fps = 30; // I have tried all sorts of frame rates and all seem to work
// Do some test to workout what your machine can handle as there
// is a lot of variation between machines.
var video = new Groover.Video(fps, quality, name)
function capture() {
if (video.timecode < 5000) { // 5 seconds
setTimeout(capture, video.frameDelay);
} else {
var videoElement = document.createElement("video");
videoElement.src = URL.createObjectURL(video.toBlob());
document.body.appendChild(videoElement);
video = undefined; // DeReference as it is memory hungry.
return;
}
// first frame sets the video size
video.addFrame(canvas); // Add current canvas frame
}
capture(); // start capture
Rather than put in a huge effort only to be rejected, this is a quick insert to see if acceptable. Will Give full details if accepted. Also include additional capture options for better HD capture rates (removed from this version, Can capture HD 1080 at 50fps on good machines.)This was inspired by Wammy but is a complete rewrite with encode as you go methodology, greatly reducing the memory required during capture. Can capture more than 30 seconds better data, handling algorithms.
Note frames are encoded into webP images. Only Chrome supports webP canvas encoding. For other browsers (Firefox and Edge) you will need to use a 3rd party webP encoder such as Libwebp Javascript Encoding WebP images via Javascript is slow. (will include addition of raw webp images support if accepted).
Drawing an svg image
To draw a vector SVG image, the operation is not different from a raster image : You first need to load your SVG image into an HTMLImage element, then use the drawImage() method.
var image = new Image();
image.onload = function(){
ctx.drawImage(this, 0,0);
}
image.src = "someFile.SVG";
SVG images have some advantages over raster ones, since you won't loose quality, whatever the scale you'll draw it on your canvas. But beware, it may also be a bit slower than drawing a raster image.
However, SVG images come with more restrictions than raster images.
- For security purpose, no external content can be loaded from an SVG image referenced in an HTMLImageElement(<img>) No external stylesheet, no external image referenced in SVGImage (<image/>) elements, no external filter or element linked by the xlink:href attribute (<use xlink:href="anImage.SVG#anElement"/>) or the funcIRI (url()) attribute method etc. Also, stylesheets appended in the main document won't have any effect on the SVG document once referenced in an HTMLImage element. Finally, no script will be executed inside the SVG Image. Workaround : You'll need to append all external elements inside the SVG itself before referrencing to the HTMLImage element. (for images or fonts, you need to append a dataURI version of your external resources).
- The root element (<svg>) must have its width and height attributes set to an absolute value. If you were to use relative length (e.g %), then the browser won't be able to know to what it is relative. Some browsers (Blink) will try to make a guess, but most will simply ignore your image and won't draw anything, without a warning.
- Some browsers will taint the canvas when an SVG image has been drawn to it. Specifically, Internet-Explorer < Edge in any case, and Safari 9 when a <foreignObject> is present in the SVG image.
Loading and displaying an Image
To load an image and place it on the canvas
var image = new Image(); // see note on creating an image
image.src = "imageURL";
image.onload = function(){
ctx.drawImage(this,0,0);
}
Creating an image
There are several ways to create an image
- new Image()
- document.createElement("img")
- <img src = 'imageUrl' id='myImage'> As part of the HTML body and retrieved with document.getElementById('myImage')
Image.src property
The image srccan be any valid image URL or encoded dataURL. See this topic's Remarks for more information on
image formats and support.
- image.src = "http://my.domain.com/images/myImage.jpg"
- image.src = "data:image/gif;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs=" *
Remarks on loading and errors
The image will begin loading when its src property is set. The loading is syncriouse but the onload event will not be called until the function or code has exited/returned.
If you get an image from the page (for example document.getElementById("myImage")) and its src is set it may or may not have loaded. You can check on the status of the image with HTMLImageElement.complete which will be true if complete. This does not mean the image has loaded, it means that it has either
- loaded
- there was an error
- src property has not been set and is equal to the empty String ""
If the image is from an unreliable source and may not be accessible for a variety of reasons it will generate an error event. When this happens the image will be in a broken state. If you then attempt to draw it onto the canvas it will throw the following error
ATutorialHub Related Guide
Comments (9)
User Comments

panduranga gupta
2021-07-05 07:03:13good website for learning and help me a lot

raju
2021-09-25 14:58:47The awsome website i am looking like for a long time, good work atutorialhub team keep doing

Shivani
2021-09-01 15:03:56Learning a lot from the courses present on atutorialhub. The courses are very well explained. Great experience

Harshitha
2021-09-10 15:05:45It is very helpful to students and easy to learn the concepts

Sowmya
2021-09-14 15:06:41Great job Tutorials are easy to understand Please make use of it

Zain Khan
2021-09-18 15:07:23Great content and customized courses.

Rudrakshi Bhatt
2021-09-09 15:08:10Well structured coursed and explained really well!

Pavana Somashekar
2021-09-11 15:09:08Good platform for beginners and learn a lot on this website

Sax
2021-09-25 19:35:50Nice website
Leave a Comment