- From: poot <cvsmail@w3.org>
- Date: Tue, 06 Mar 2012 18:30:00 -0500
- To: public-html-diffs@w3.org
2Dapi; hixie: Minor tweaks to the path stuff (whatwg r7018) http://dev.w3.org/cvsweb/html5/2dcontext/Overview.html?r1=1.124&r2=1.125&f=h http://html5.org/tools/web-apps-tracker?from=7017&to=7018 =================================================================== RCS file: /sources/public/html5/2dcontext/Overview.html,v retrieving revision 1.124 retrieving revision 1.125 diff -u -d -r1.124 -r1.125 --- Overview.html 6 Mar 2012 23:28:35 -0000 1.124 +++ Overview.html 6 Mar 2012 23:29:53 -0000 1.125 @@ -481,12 +481,13 @@ <li><a href="#shadows"><span class="secno">7 </span>Shadows</a></li> <li><a href="#simple-shapes-rectangles"><span class="secno">8 </span>Simple shapes (rectangles)</a></li> <li><a href="#complex-shapes-paths"><span class="secno">9 </span>Complex shapes (paths)</a></li> - <li><a href="#text"><span class="secno">10 </span>Text</a></li> - <li><a href="#images"><span class="secno">11 </span>Images</a></li> - <li><a href="#pixel-manipulation"><span class="secno">12 </span>Pixel manipulation</a></li> - <li><a href="#drawing-model"><span class="secno">13 </span>Drawing model</a></li> - <li><a href="#best-practices"><span class="secno">14 </span>Best practices</a></li> - <li><a href="#examples"><span class="secno">15 </span>Examples</a></li> + <li><a href="#the-current-default-path"><span class="secno">10 </span>The current default path</a></li> + <li><a href="#text"><span class="secno">11 </span>Text</a></li> + <li><a href="#images"><span class="secno">12 </span>Images</a></li> + <li><a href="#pixel-manipulation"><span class="secno">13 </span>Pixel manipulation</a></li> + <li><a href="#drawing-model"><span class="secno">14 </span>Drawing model</a></li> + <li><a href="#best-practices"><span class="secno">15 </span>Best practices</a></li> + <li><a href="#examples"><span class="secno">16 </span>Examples</a></li> <li><a class="no-num" href="#references">References</a></li> <li><a class="no-num" href="#acknowledgements">Acknowledgements</a></ol> <hr><h2 id="conformance-requirements"><span class="secno">1 </span>Conformance requirements</h2><p>This specification is an HTML specification. All the conformance @@ -534,7 +535,7 @@ void <a href="#dom-context-2d-fillrect" title="dom-context-2d-fillRect">fillRect</a>(double x, double y, double w, double h); void <a href="#dom-context-2d-strokerect" title="dom-context-2d-strokeRect">strokeRect</a>(double x, double y, double w, double h); - // default path API (see also <a href="#canvaspathmethods">CanvasPathMethods</a>) + // current default path API (see also <a href="#canvaspathmethods">CanvasPathMethods</a>) void <a href="#dom-context-2d-beginpath" title="dom-context-2d-beginPath">beginPath</a>(); void <a href="#dom-context-2d-fill" title="dom-context-2d-fill">fill</a>(); void <a href="#dom-context-2d-stroke" title="dom-context-2d-stroke">stroke</a>(); @@ -1877,7 +1878,7 @@ - </div><hr><p>The context always has a current default path. There is only one + </div><h2 id="the-current-default-path"><span class="secno">10 </span>The current default path</h2><p>The context always has a current default path. There is only one current default path, it is not part of the <a href="#drawing-state">drawing state</a>. The current default path is a <a href="#path">path</a>, as described in the previous section.<dl class="domintro"><dt><var title="">context</var> . <code title="dom-context-2d-beginPath"><a href="#dom-context-2d-beginpath">beginPath</a></code>()</dt> @@ -2197,7 +2198,7 @@ </script></pre> - </div><h2 id="text"><span class="secno">10 </span>Text</h2><dl class="domintro"><dt><var title="">context</var> . <code title="dom-context-2d-font"><a href="#dom-context-2d-font">font</a></code> [ = <var title="">value</var> ]</dt> + </div><h2 id="text"><span class="secno">11 </span>Text</h2><dl class="domintro"><dt><var title="">context</var> . <code title="dom-context-2d-font"><a href="#dom-context-2d-font">font</a></code> [ = <var title="">value</var> ]</dt> <dd> @@ -2563,7 +2564,7 @@ </div><p class="note">A future version of the 2D context API may provide a way to render fragments of documents, rendered using CSS, straight to the canvas. This would be provided in preference to a dedicated - way of doing multiline layout.<h2 id="images"><span class="secno">11 </span>Images</h2><p>To draw images onto the canvas, the <dfn id="dom-context-2d-drawimage" title="dom-context-2d-drawImage"><code>drawImage</code></dfn> method + way of doing multiline layout.<h2 id="images"><span class="secno">12 </span>Images</h2><p>To draw images onto the canvas, the <dfn id="dom-context-2d-drawimage" title="dom-context-2d-drawImage"><code>drawImage</code></dfn> method can be used.<p>This method can be invoked with three different sets of arguments:<ul class="brief"><li><code title="">drawImage(<var title="">image</var>, <var title="">dx</var>, <var title="">dy</var>)</code> <li><code title="">drawImage(<var title="">image</var>, <var title="">dx</var>, <var title="">dy</var>, <var title="">dw</var>, <var title="">dh</var>)</code> <li><code title="">drawImage(<var title="">image</var>, <var title="">sx</var>, <var title="">sy</var>, <var title="">sw</var>, <var title="">sh</var>, <var title="">dx</var>, <var title="">dy</var>, <var title="">dw</var>, <var title="">dh</var>)</code> @@ -2687,7 +2688,7 @@ subject to <a href="#shadows" title="shadows">shadow effects</a>, <a href="#dom-context-2d-globalalpha" title="dom-context-2d-globalAlpha">global alpha</a>, the <a href="#clipping-region" title="clipping region">clipping region</a>, and <a href="#dom-context-2d-globalcompositeoperation" title="dom-context-2d-globalCompositeOperation">global composition operators</a>.</p> - </div><h2 id="pixel-manipulation"><span class="secno">12 </span><dfn>Pixel manipulation</dfn></h2><dl class="domintro"><dt><var title="">imagedata</var> = <var title="">context</var> . <code title="dom-context-2d-createImageData"><a href="#dom-context-2d-createimagedata">createImageData</a></code>(<var title="">sw</var>, <var title="">sh</var>)</dt> + </div><h2 id="pixel-manipulation"><span class="secno">13 </span><dfn>Pixel manipulation</dfn></h2><dl class="domintro"><dt><var title="">imagedata</var> = <var title="">context</var> . <code title="dom-context-2d-createImageData"><a href="#dom-context-2d-createimagedata">createImageData</a></code>(<var title="">sw</var>, <var title="">sh</var>)</dt> <dd> @@ -3014,7 +3015,7 @@ </div><div class="impl"> - <h2 id="drawing-model"><span class="secno">13 </span><dfn>Drawing model</dfn></h2> + <h2 id="drawing-model"><span class="secno">14 </span><dfn>Drawing model</dfn></h2> <p>When a shape or image is painted, user agents must follow these steps, in the order given (or act as if they do):</p> @@ -3042,7 +3043,7 @@ region</a> over the current canvas bitmap using the current composition operator.</li> - </ol></div><h2 id="best-practices"><span class="secno">14 </span>Best practices</h2><p><i>This section is non-normative.</i><p>When a canvas is interactive, authors should include focusable + </ol></div><h2 id="best-practices"><span class="secno">15 </span>Best practices</h2><p><i>This section is non-normative.</i><p>When a canvas is interactive, authors should include focusable elements in the element's fallback content corresponding to each focusable part of the canvas, as in the <a href="#drawCustomFocusRingExample">example above</a>.<p>To indicate which focusable part of the canvas is currently focused, authors should use the <code title="dom-context-2d-drawSystemFocusRing"><a href="#dom-context-2d-drawsystemfocusring">drawSystemFocusRing()</a></code> @@ -3091,7 +3092,7 @@ encouraged to avoid doing any of it by instead using the <code>input</code> element, the <code>textarea</code> element, or the <code title="attr-contenteditable">contenteditable</code> - attribute.<h2 id="examples"><span class="secno">15 </span>Examples</h2><p><i>This section is non-normative.</i><div class="example"> + attribute.<h2 id="examples"><span class="secno">16 </span>Examples</h2><p><i>This section is non-normative.</i><div class="example"> <p>Here is an example of a script that uses canvas to draw <a href="data:text/html;charset=utf-8;base64,PCFET0NUWVBFIEhUTUw%2BDQo8aHRtbCBsYW5nPSJlbiI%2BDQogPGhlYWQ%2BDQogIDx0aXRsZT5QcmV0dHkgR2xvd2luZyBMaW5lczwvdGl0bGU%2BDQogPC9oZWFkPg0KIDxib2R5Pg0KPGNhbnZhcyB3aWR0aD0iODAwIiBoZWlnaHQ9IjQ1MCI%2BPC9jYW52YXM%2BDQo8c2NyaXB0Pg0KDQogdmFyIGNvbnRleHQgPSBkb2N1bWVudC5nZXRFbGVtZW50c0J5VGFnTmFtZSgnY2FudmFzJylbMF0uZ2V0Q29udGV4dCgnMmQnKTsNCg0KIHZhciBsYXN0WCA9IGNvbnRleHQuY2FudmFzLndpZHRoICogTWF0aC5yYW5kb20oKTsNCiB2YXIgbGFzdFkgPSBjb250ZXh0LmNhbnZhcy5oZWlnaHQgKiBNYXRoLnJhbmRvbSgpOw0KIHZhciBodWUgPSAwOw0KIGZ1bmN0aW9uIGxpbmUoKSB7DQogICBjb250ZXh0LnNhdmUoKTsNCiAgIGNvbnRleHQudHJhbnNsYXRlKGNvbnRleHQuY2FudmFzLndpZHRoLzIsIGNvbnRleHQuY2FudmFzLmhlaWdodC8yKTsNCiAgIGNvbnRleHQuc2NhbGUoMC45LCAwLjkpOw0KICAgY29udGV4dC50cmFuc2xhdGUoLWNvbnRleHQuY2FudmFzLndpZHRoLzIsIC1jb250ZXh0LmNhbnZhcy5oZWlnaHQvMik7DQogICBjb250ZXh0LmJlZ2luUGF0aCgpOw0KICAgY29udGV4dC5saW5lV2lkdGggPSA1ICsgTWF0aC5yYW5kb20oKSAqIDEwOw0KICAgY29udGV4dC5tb3ZlVG8obGFzdFgsIGxhc3RZKTsCiAgIGxhc3RYID0gY29udGV4dC5jYW52YXMud2lkdGggKiBNYXRoLnJhbmRvbSgpOw0KICAgbGFzdFkgPSBjb250ZXh0LmNhbnZhcy5oZWlnaHQgKiBNYXRoLnJhbmRvbSgpOw0KICAgY29udGV4dC5iZXppZXJDdXJ2ZVRvKGNvbnRleHQuY2FudmFzLndpZHRoICogTWF0aC5yYW5kb20oKSwNCiAgICAgICAgICAgICAgICAgICAgICAgICBjb250ZXh0LmNhbnZhcy5oZWlnaHQgKiBNYXRoLnJhbmRvbSgpLA0KICAgICAgICAgICAgICAgICAgICAgICAgIGNvbnRleHQuY2FudmFzLndpZHRoICogTWF0aC5yYW5kb20oKSwNCiAgICAgICAgICAgICAgICAgICAgICAgICBjb250ZXh0LmNhbnZhcy5oZWlnaHQgKiBNYXRoLnJhbmRvbSgpLA0KICAgICAgICAgICAgICAgICAgICAgICAgIGxhc3RYLCBsYXN0WSk7DQoNCiAgIGh1ZSA9IGh1ZSArIDEwICogTWF0aC5yYW5kb20oKTsNCiAgIGNvbnRleHQuc3Ryb2tlU3R5bGUgPSAnaHNsKCcgKyBodWUgKyAnLCA1MCUsIDUwJSknOw0KICAgY29udGV4dC5zaGFkb3dDb2xvciA9ICd3aGl0ZSc7DQogICBjb250ZXh0LnNoYWRvd0JsdXIgPSAxMDsNCiAgIGNvbnRleHQuc3Ryb2tlKCk7DQogICBjb250ZXh0LnJlc3RvcmUoKTsNCiB9DQogc2V0SW50ZXJ2YWwobGluZSwgNTApOw0KDQogZnVuY3Rpb24gYmxhbmsoKSB7DQogICBjb250ZXh0LmZpbGxTdHlsZSA9ICdyZ2JhKDAsMCwwLDAuMSknOw0KICAgY29udGV4dC5maWxsUmVjdCgwLCAwLCBjb250ZXh0LmNhbnZhcy53aWR0aCwgY29udGV4dC5jYW52YXMuaGVpZ20KTsNCiB9DQogc2V0SW50ZXJ2YWwoYmxhbmssIDQwKTsNCg0KPC9zY3JpcHQ%2BDQogPC9ib2R5Pg0KPC9odG1sPg0K">pretty glowing lines</a>.</p>
Received on Tuesday, 6 March 2012 23:30:03 UTC