- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 16 Dec 2011 12:39:58 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/canvas-extensions
In directory hutz:/tmp/cvs-serv24005
Modified Files:
Overview.html
Log Message:
pull update from steve
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/canvas-extensions/Overview.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Overview.html 14 Dec 2011 12:49:27 -0000 1.9
+++ Overview.html 16 Dec 2011 12:39:55 -0000 1.10
@@ -79,7 +79,7 @@
<link charset="utf-8" type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/W3C-ED"></head>
- <body style="display: inherit;"><div class="head"><p><a href="http://www.w3.org/"><img src="http://www.w3.org/Icons/w3c_home" alt="W3C" height="48" width="72"></a></p><h1 class="title" id="title">HTML Canvas 2D Context Extensions</h1><h2 id="w3c-editor-s-draft-14-december-2011">W3C Editor's Draft 14 December 2011</h2><dl><dt>(acting) Editor:</dt><dd><span>Steve Faulkner</span>, The Paciello Group <span class="ed_mailto"><a href="mailto:sfaulkner@paciellogroup.com">sfaulkner@paciellogroup.com</a></span> </dd>
+ <body style="display: inherit;"><div class="head"><p><a href="http://www.w3.org/"><img src="http://www.w3.org/Icons/w3c_home" alt="W3C" height="48" width="72"></a></p><h1 class="title" id="title">HTML Canvas 2D Context Extensions</h1><h2 id="w3c-editor-s-draft-14-december-2011">W3C Editor's Draft 16 December 2011</h2><dl><dt>(acting) Editor:</dt><dd><span>Steve Faulkner</span>, The Paciello Group <span class="ed_mailto"><a href="mailto:sfaulkner@paciellogroup.com">sfaulkner@paciellogroup.com</a></span> </dd>
</dl><hr></div>
<div class="introductory section" id="abstract"><h2>Abstract</h2>
<p>This specification extends and overrides the
@@ -296,7 +296,7 @@
This method
only draws the focus ring if the element is focused or is a descendant
- of the element with focus. </p><dl class="domintro"><dt><var title="">SHOULDDraw</var> = <var title="">context</var> . <code title="dom-context-2d-drawFocusRing"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-drawfocusring">drawFocusRing</a></code>(<var title="">element</var>, [ <var title="">canDrawCustom</var> ])</dt>
+ of the element with focus. </p><dl class="domintro"><dt><var>shouldDraw</var> = <var>context</var> . <code title="dom-context-2d-drawFocusRing"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-drawfocusring">drawFocusRing</a></code>(<var>element</var>, [ <var>canDrawCustom</var> ])</dt>
<dd>
@@ -304,12 +304,12 @@
current path, following the platform conventions for focus
rings. </p>
- <p>If the <var title="">canDrawCustom</var> argument is true, then
+ <p>If the <var>canDrawCustom</var> argument is true, then
the focus ring is only drawn if the user has configured his system
to draw focus rings in a particular manner. (For example, high
contrast focus rings.)</p>
- <p>Returns true if the given element is focused, the <var title="">canDrawCustom</var> argument is true, and the user has
+ <p>Returns true if the given element is focused, the <var>canDrawCustom</var> argument is true, and the user has
not configured his system to draw focus rings in a particular
manner. Otherwise, returns false.</p>
@@ -328,10 +328,10 @@
[<cite><a href="#bib-WAI-ARIA" rel="biblioentry" class="bibref">WAI-ARIA</a></cite>]
for the targeted element.</p>
- <p>The <dfn id="dom-context-2d-drawfocusring" title="dom-context-2d-drawFocusRing"><code>drawFocusRing(<var title="">element</var>, [<var title="">canDrawCustom</var>])</code></dfn>
+ <p>The <dfn id="dom-context-2d-drawfocusring" title="dom-context-2d-drawFocusRing"><code>drawFocusRing(<var>element</var>, [<var>canDrawCustom</var>])</code></dfn>
method, when invoked, MUST run the following steps:</p>
- <ol><li><p>If the <var title="">element</var> is not focused or is not a
+ <ol><li><p>If the <var>element</var> is not focused or is not a
descendant of the element with whose context the method is
associated, then return false and abort these steps.</p></li>
@@ -340,7 +340,7 @@
<li>
<p>If the user has requested the use of particular focus rings
- (e.g. high-contrast focus rings), or if the <var title="">canDrawCustom</var> argument is absent or false, then
+ (e.g. high-contrast focus rings), or if the <var>canDrawCustom</var> argument is absent or false, then
draw a focus ring of the appropriate style along the path,
following platform conventions, return false, and abort these
steps.</p>
@@ -384,20 +384,20 @@
<p>To access the system caret blink rate in canvas use the
<code title="dom-context-2d-caretBlinkRate"><a href="#dom-context-2d-caretBlinkRate">caretBlinkRate()</a></code> method</p>
- <dl class="domintro"><dt><var title="">success</var> = <var title="">context</var> .
- <code title="dom-context-2d-setCaretSelectionRect"><a href="#dom-context-2d-setCaretSelectionRect">setCaretSelectionRect</a></code>(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>)</dt>
+ <dl class="domintro"><dt><var>success</var> = <var>context</var> .
+ <code title="dom-context-2d-setCaretSelectionRect"><a href="#dom-context-2d-setCaretSelectionRect">setCaretSelectionRect</a></code>(<var>element</var>, <var>x</var>, <var>y</var>, <var>w</var>, <var>h</var>)</dt>
<dd>
<p>Returns true if the given element is focused or a document descendant of an element with focus. Otherwise, returns false.</p>
<!--
- <p>The given coordinates (<var title="">x</var>, <var title="">y</var>) are relative to the outer edge of the caret or selection position where the edge represents the left or right edge in the direction of the user's selection.</p>
- <p>The <var title="">w</var> and <var title="">h</var> are supplied to indicate the respective width of the caret and height of the caret or selection point. Authors should compute the height based on the font height of the associated character, in pixels, and the width of the caret or nearest associated selected character.</p>
- <p>The top left pixel coordinate of the caret or selection position must be given in the <var title="">x</var> and <var title="">y</var> arguments. When this coordinate is the selection position, the top left pixel coordinate must be positioned equivalent to the top left pixel location of the last character selected. Additionally, the <var title="">w</var> and <var title="">h</var> are supplied to indicate the width and height of the caret or selection point. Authors must compute the height based on the font height of the associated character, in pixels. In the case of a caret, authors must compute the width based on the caret's with in pixels. In the case of a selected character the width must correspond to the width of the last selected character in pixels. </p>
+ <p>The given coordinates (<var>x</var>, <var>y</var>) are relative to the outer edge of the caret or selection position where the edge represents the left or right edge in the direction of the user's selection.</p>
+ <p>The <var>w</var> and <var>h</var> are supplied to indicate the respective width of the caret and height of the caret or selection point. Authors should compute the height based on the font height of the associated character, in pixels, and the width of the caret or nearest associated selected character.</p>
+ <p>The top left pixel coordinate of the caret or selection position must be given in the <var>x</var> and <var>y</var> arguments. When this coordinate is the selection position, the top left pixel coordinate must be positioned equivalent to the top left pixel location of the last character selected. Additionally, the <var>w</var> and <var>h</var> are supplied to indicate the width and height of the caret or selection point. Authors must compute the height based on the font height of the associated character, in pixels. In the case of a caret, authors must compute the width based on the caret's with in pixels. In the case of a selected character the width must correspond to the width of the last selected character in pixels. </p>
-->
</dd>
- <dt><var title="">rate</var> = <var title="">context</var> . <code title="dom-context-2d-caretBlinkRate"><a href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-caretBlinkRate">caretBlinkRate</a></code>()</dt>
+ <dt><var>rate</var> = <var>context</var> . <code title="dom-context-2d-caretBlinkRate"><a href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-caretBlinkRate">caretBlinkRate</a></code>()</dt>
<dd>
@@ -415,20 +415,20 @@
<!--
<p>For user agents that support an accessibility API, these coordinates are converted to screen coordinates within the user agent and used to notify the assistive technology of the change in either the current caret or selection position.</p>
<p>The caret position is typically the last rendered screen position of either the end of the last visible selected character, or the caret position when the associated text has focus or is a descendant of an element that has focus.</p>
- <p class="note">Some systems follow a convention whereby caret position does not track the selected text, in which case the last drawn position must be tracked. Furthermore, when <var title="">element</var> is a descendent of an element with focus there must be only one descendent of the element with focus that has either a caret or selection position and the last call to this function must be for the last caret or selection drawn. </p>
+ <p class="note">Some systems follow a convention whereby caret position does not track the selected text, in which case the last drawn position must be tracked. Furthermore, when <var>element</var> is a descendent of an element with focus there must be only one descendent of the element with focus that has either a caret or selection position and the last call to this function must be for the last caret or selection drawn. </p>
-->
- <p>The <dfn id="dom-context-2d-setCaretSelectionRect" title="dom-context-2d-setCaretSelectionRect"><code>setCaretSelectionRect(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>)</code></dfn>
+ <p>The <dfn id="dom-context-2d-setCaretSelectionRect" title="dom-context-2d-setCaretSelectionRect"><code>setCaretSelectionRect(<var>element</var>, <var>x</var>, <var>y</var>, <var>w</var>, <var>h</var>)</code></dfn>
method, when invoked, MUST run the following steps:</p>
<ol>
- <li><p>If <var title="">element</var> does not have selected content and is not focused return false and abort these steps.</p></li>
- <!-- <li><p>If <var title="">element</var> does have a caret but is not focused then return false and abort these steps </p></li> -->
+ <li><p>If <var>element</var> does not have selected content and is not focused return false and abort these steps.</p></li>
+ <!-- <li><p>If <var>element</var> does have a caret but is not focused then return false and abort these steps </p></li> -->
<li><p>If the element is not a descendant of the element with whose context the method is associated, then return false and abort these step.</p></li>
- <li><p>Transform the given point (<var title="">x</var>, <var title="">y</var>), the width <var title="">w</var>, and the height <var title="">h</var> according to the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#transformations" title="dom-context-2d-transformation">current transformation matrix</a>.</p></li>
+ <li><p>Transform the given point (<var>x</var>, <var>y</var>), the width <var>w</var>, and the height <var>h</var> according to the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#transformations" title="dom-context-2d-transformation">current transformation matrix</a>.</p></li>
<li><p>If the user agent supports a platform accessibility API the user agent MUST use the element, transformed coordinates and transformed bounding box, and provide it through the supported accessibility API implementation.
<!--
The element used to determine the corresponding accessible object for purposes of supporting the accessibility API. This is for the purposes of driving screen magnification.
@@ -444,7 +444,7 @@
<li><p>Return true.</p></li>
</ol></div>
- <p>If the user resizes or moves the user agent window the user agent report MUST reflect the revised (<var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>) position (or rectangle) in the accessibility API mapping. </p>
+ <p>If the user resizes or moves the user agent window the user agent report MUST reflect the revised (<var>x</var>, <var>y</var>, <var>w</var>, <var>h</var>) position (or rectangle) in the accessibility API mapping. </p>
<div class="impl">
@@ -488,22 +488,22 @@
interface, for the purpose of returning the vertical offset of a text anchor point.</p>
<dl class="domintro">
-<dt><var title="">metrics</var> .
+<dt><var>metrics</var> .
<code title="dom-textmetrics-baseline"><a href="#dom-textmetrics-baseline">baseline</a></code></dt>
<dd>
- <p>Returns the vertical offset of the <var title="">anchor point</var> for the text that was passed to the
+ <p>Returns the vertical offset of the <var>anchor point</var> for the text that was passed to the
<code title="dom-context-2d-measureText"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-measuretext">measureText()</a></code>
method.</p>
</dd>
</dl>
<p>The <dfn id="dom-context-2d-measuretext" title="dom-context-2d-measureText"><code>measureText()</code></dfn>
- method takes one argument, <var title="">text</var>. When the method
+ method takes one argument, <var>text</var>. When the method
is invoked, the user agent MUST replace all the <span title="space
- character">space characters</span> in <var title="">text</var> with
+ character">space characters</span> in <var>text</var> with
U+0020 SPACE characters, and then MUST form a hypothetical
infinitely wide CSS line box containing a single inline box
- containing the text <var title="">text</var>, with all the
+ containing the text <var>text</var>, with all the
properties at their initial values except the 'font' property of the
inline element set to the current font of the context, as given by
the <code title="dom-context-2d-font"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-font">font</a></code> attribute, and
@@ -511,7 +511,7 @@
<code title="dom-textmetrics-width"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-textmetrics-width">width</a></code> attribute set to
the width of that inline box, in CSS pixels and its
<code title="dom-textmetrics-baseline"><a href="#dom-textmetrics-baseline">baseline</a></code> attribute
- set to the <var title="">anchor point</var>'s vertical position as determined by the current
+ set to the <var>anchor point</var>'s vertical position as determined by the current
<code title="dom-context-2d-textBaseline"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-textbaseline">textBaseline</a></code> value,
in CSS pixels. [<cite><a href="#bib-CSS21" rel="biblioentry" class="bibref">CSS21</a></cite>]</p>
</div>
Received on Friday, 16 December 2011 12:40:00 UTC