![]() |
![]() |
Tutorial WWW 2012De $1_
IntroductionIn this tutorial, you will learn how to write a multi-participant Paint program in pure HTML5. Required toolsThe recommend tools are :
Download lab exercicesAll the source files you will need are included in this archive (4Mo). Unzip, go in the "Paint_HTML5_Multi_Tutorial". You will find subdirectories step1, step2, etc... corresponding to each step described in this document. Step 1 : a very simple paint !Go into the step 2 directory. You may try the example by opening paint.html in your browser. Notice the first lines of this file : <!DOCTYPE HTML> <!-- Note : in HTML5 the DOCTYPE can be memorized by a normal human being --> <!-- Common mistake : if we put a comment before the doctype element, Internet Explorer will not consider the document as a HTML5 document and the canvas tag for example, will not be displayed ! --> The DOCTYPE is the brand new ultra-simple HTML5 DOCTYPE, yeah ! Notice that if you write ANYTHING before this DOCTYPE line, IE9 will not consider the file as HTML5, and you will no be able to run the example ! The <canvas> tag in the page will be ignored. Other browsers will however do nothing nasty if you write some comment at the top of the document. Then, we declare a CSS and some JavaScript scripts. Yep, we will use jQuery for most DOM manipulation and event handling. HTML5 proposes the new document.querySelector(...) that behaves closely like jQuery selectors but is so much longer than $(...), and jQuery uses querySelector internally... <link rel="stylesheet" href="css/paint.css"/> <script src="js/jquery-1.7.2.min.js"></script> <script src="js/utils.js"></script> <script src="js/paint.js"></script> paint.js holds most of the code for a small "draw when mouse moves" paint program, while utils.js contains a utility function for getting correct mouse cursor position. When the document if fully loaded and the DOM ready, we create a Paint object, that will hold most of our JavaScript code. <script type="text/javascript"> // Run when the DOM is ready $(document).ready(function () { // Create the pseudo object which will handle the main canvas paint = new PaintObject("canvasMain"); }); </script> The parameter ("canvasMain") is the Id of the <canvas> tag you will find in the HTML part of the page : <canvas id="canvasMain"> <p>Canvas tag not supported by your browser</p> </canvas> Let' have a look at the PaintObject code in the paint.js file... First we get a reference on the canvas element and secondly we get a context object in order to draw in the canvas : function PaintObject(canvas) { // get handle of the main canvas, as a DOM object, not as a jQuery Object. var mainCanvas = $("#"+canvas).get(0); var mainContext = mainCanvas.getContext('2d'); ... We also bind a mouse move listener to the canvas : // Bind event on the canvas $("#canvasMain").mousemove(this.mouseMoveListener); The mouse listener is a method of the PaintObject that draw a line at each mouse move, from the previous mouse position to the current one : // Mouse motion listener for drawing lines this.mouseMoveListener = function (event) { // we delegate the computation of the mouse position // to a utility function (in utils.js) as this is not so trivial // we must take into account insets, etc. var mousePos = getMousePos(mainCanvas, event); // Let's draw some lines that follow the mouse pos if (!started) { previousMousePos = mousePos; started = true; } else { mainContext.beginPath(); mainContext.moveTo(previousMousePos.x, previousMousePos.y); mainContext.lineTo(mousePos.x, mousePos.y); mainContext.closePath(); // draws as wireframe the drawing orders between beginPath() and closePath() mainContext.stroke(); previousMousePos = mousePos; } }; Notice that in order to draw a line we declare a path, we move to a position, we draw a line to another position, we close the path. The path is drawn at the mainContext.stroke() call. It will be drawn with the current mainContext.strokeStyle value, which is defaulted to Black. Be careful : just forget to close the path and at every mouse move you will draw the whole path from the beginning ! Indeed : mainContext.stroke() draws every draw primitive declared since the context.beginPath() call... if a beginPath() is called while a path is not closed, it is ... ignored. Notice the trick we use in order to set the size of the canvas depending on the size of the browser. Instead of using CSS percentages on canvas width and height, that produce ugly scaling of canvas content, we adjust the size from a JavaScript piece of code : // Canvas doesnt scale well with '%' in CSS so we use a little trick. // We give them the size of one of their parent node which can be scalable. mainCanvas.height = $("#content")[0].clientHeight; mainCanvas.width = $("#content")[0].clientWidth; Step 2 : manage mouseUp, mouseMove, mouseDown, define a pencil drawing objectGo into the step 2 directory. You may try the example by opening paint.html in your browser. This time we draw only when the mouse moves while a mouse button is pressed ! We also separated the code that draws from the initialisation of the PaintObject. the file drawingtools.js will hold "drawing objects" like pencil, line, rectangle, circle and so on... while paint.js will just do the job for creating contexts, binding events, etc. We used jQuery to bind different mouse events to the canvas (paint.js) // Create the drawing tool var drawingTool = new pencilDrawingTool(); // Bind events on the canvas $("#canvasMain").mousedown(drawingTool.mouseDownListener); $("#canvasMain").mousemove(drawingTool.mouseMoveListener); $("#canvasMain").mouseup(drawingTool.mouseUpListener); and here is the drawingtool.js content with only a tool that draws like a pencil (notice the 3 listener methods for mouseDown, mouseMove and mouseUp events) : // Previous position of the mouse var previousMousePos; // Drawing tool object function pencilDrawingTool() { this.mouseDownListener = function (event) { paint.started = true; previousMousePos = getMousePos(paint.getFrontCanvas(), event); }; this.mouseMoveListener = function (event) { // we delegate the computation of the mouse position // to a utility function as this is not so trivial var mousePos = getMousePos(paint.getMainCanvas(), event); // Let's draw some lines that follow the mouse pos if (paint.started) { paint.getMainContext().beginPath(); paint.getMainContext().moveTo(previousMousePos.x, previousMousePos.y); paint.getMainContext().lineTo(mousePos.x, mousePos.y); paint.getMainContext().closePath(); paint.getMainContext().stroke(); } previousMousePos = mousePos; }; this.mouseUpListener = function (event) { paint.started = false; } };
|
Powered by MindTouch Deki Open Source Edition v.8.08 |