- From: Anssi Kostiainen via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 15 May 2012 06:45:39 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/camera
In directory hutz:/tmp/cvs-serv18669
Modified Files:
Overview.html
Log Message:
move terminology into its own section; specify unspecified term capture control type; various non-normative editorial changes
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/camera/Overview.html,v
retrieving revision 1.127
retrieving revision 1.128
diff -u -d -r1.127 -r1.128
--- Overview.html 14 May 2012 18:11:14 -0000 1.127
+++ Overview.html 15 May 2012 06:45:35 -0000 1.128
@@ -26,7 +26,8 @@
<section id="abstract">
The HTML Media Capture specification defines HTML form extensions that
- facilitate users' access to media capture capabilities of the hosting device.
+ facilitate users' access to media capture capabilities of the hosting
+ device.
</section>
<section id="sotd">
@@ -35,12 +36,13 @@
<section class="informative">
<h2>Introduction</h2>
<p>
- This specification extends the <code>HTMLInputElement</code> with a new
- <code>capture</code> attribute. The attribute enables content authors
- to give hints of preferred means to capture local media such as images,
- video, and sound, that is to be subsequently uploaded. Conformant user
- agents provide their users more seamless access to the above-mentioned
- media capture capabilities of the hosting device.
+ This specification extends the <code><a>HTMLInputElement</a></code>
+ interface with a new <code><a>capture</a></code> attribute. The
+ attribute enables content authors to give hints of preferred means to
+ capture local media such as images, video, and sound, that is to be
+ subsequently uploaded. Conformant user agents provide their users more
+ seamless access to the above-mentioned media capture capabilities of
+ the hosting device.
</p>
<p>
Access to media streams from the hosting device is out of scope for
@@ -61,7 +63,37 @@
as this specification uses that specification and terminology.
</p>
</section>
-
+
+ <section>
+ <h2>Terminology</h2>
+ <p>
+ The
+ <a href="http://dev.w3.org/html5/spec/the-input-element.html#the-input-element">
+ <code><dfn>input</dfn></code> element</a> and the
+ <a href="http://dev.w3.org/html5/spec/the-input-element.html#htmlinputelement">
+ <code><dfn>HTMLInputElement</dfn></code></a> interface are defined in
+ [[!HTML5]].
+ </p>
+ <p>
+ The
+ <a href="http://dev.w3.org/html5/spec/states-of-the-type-attribute.html#file-upload-state-type-file">
+ <dfn>File Upload</dfn></a> <a>state</a> is defined in [[!HTML5]].
+ </p>
+ <p>
+ The
+ <a href="http://dev.w3.org/html5/spec/common-microsyntaxes.html#enumerated-attribute">
+ <dfn>enumerated attribute</dfn></a> microsyntax, and associated terms
+ and concepts <dfn>keyword</dfn>, <dfn>state</dfn>, <dfn>invalid value
+ default</dfn>, and <dfn>missing value default</dfn>, are defined in
+ [[!HTML5]].
+ </p>
+ <p>
+ In this specification, the term <dfn>capture control type</dfn>
+ refers to a specialized type of a file picker control that is
+ optimized, for the user, for capturing media of a specified type.
+ </p>
+ </section>
+
<section id="security">
<h2>Security and privacy considerations</h2>
<p>
@@ -80,81 +112,84 @@
</p>
</section>
- <section id="captureparam">
+ <section>
<h2>The capture attribute</h2>
<p>This section is normative.</p>
<p>
- When an <code>input</code> element's <code>type</code> attribute is in the
- <a href="http://dev.w3.org/html5/spec/states-of-the-type-attribute.html#file-upload-state-type-file">
- File Upload</a> state [[!HTML5]], the rules in this section apply.
+ When an <code><a>input</a></code> element's <code>type</code> attribute is in
+ the <a>File Upload</a> <a>state</a>, the rules in this section apply.
</p>
<dl title="partial interface HTMLInputElement" class="idl">
- <dt>attribute DOMString capture</dt>
+ <dt>attribute DOMString <dfn>capture</dfn></dt>
<dd>
</dd>
</dl>
<p>
- The <code>capture</code> attribute is used as a hint to the
- <a>user agent</a> to invoke a file picker with a specific capture
- <a>control type</a>.
+ The <code><dfn>capture</dfn></code> attribute is used as a hint to the
+ <a>user agent</a> to invoke a file picker of a specific <a>capture
+ control type</a>.
</p>
<p>
- The <code>capture</code> attribute controls the capture <a>state</a>
- (and associated file picker control) of the element. It is an
- <a href="http://dev.w3.org/html5/spec/common-microsyntaxes.html#keywords-and-enumerated-attributes">
- enumerated attribute</a> [[!HTML5]]. The following table lists the
- <a>keyword</a>s, <a>state</a>s, and corresponding <a>control type</a>s
- for the attribute.
+ The <code><a>capture</a></code> attribute controls the capture
+ <a>state</a> (and associated <a>capture control type</a>) of the
+ element. It is an <a>enumerated attribute</a>. The following table
+ lists the <a>keyword</a>s, <a>state</a>s, and corresponding <a>capture
+ control type</a>s for the attribute. The <a>keyword</a>s
+ <code><dfn>camera</dfn></code>, <code><dfn>camcorder</dfn></code>,
+ <code><dfn>microphone</dfn></code>, and <code><dfn>filesystem
+ </dfn></code> map to the corresponding <a>state</a>s:
+ <dfn>Image Capture</dfn>, <dfn>Video Capture</dfn>, <dfn>Sound
+ Capture</dfn>, and <a>File Upload</a> respectively.
</p>
<table class="simple">
<tr>
- <th><dfn>Keyword</dfn></th>
- <th><dfn>State</dfn></th>
- <th><dfn>Control type</dfn></th>
+ <th><a>Keyword</a></th>
+ <th><a>State</a></th>
+ <th><a>Capture control type</a></th>
</tr>
<tr>
- <td><code><dfn>camera</dfn></code></td>
- <td><dfn>Image Capture</dfn></td>
+ <td><code><a>camera</a></code></td>
+ <td><a>Image Capture</a></td>
<td>A camera</td>
</tr>
<tr>
- <td><code><dfn>camcorder</dfn></code></td>
- <td><dfn>Video Capture</dfn></td>
+ <td><code><a>camcorder</a></code></td>
+ <td><a>Video Capture</a></td>
<td>A video camera</td>
</tr>
<tr>
- <td><code><dfn>microphone</dfn></code></td>
- <td><dfn>Sound Capture</dfn></td>
+ <td><code><a>microphone</a></code></td>
+ <td><a>Sound Capture</a></td>
<td>A sound recorder</td>
</tr>
<tr>
- <td><code><dfn>filesystem</dfn></code></td>
- <td><dfn>File Upload</dfn> [[!HTML5]]</td>
+ <td><code><a>filesystem</a></code></td>
+ <td><a>File Upload</a></td>
<td>A generic file picker</td>
</tr>
</table>
<p>
- The <code>capture</code> attribute's <em>invalid value default</em> and
- <em>missing value default</em> is the <a>File Upload</a> state.
+ The <code><a>capture</a></code> attribute's <em><a>invalid value
+ default</a></em> and <em><a>missing value default</a></em> is the
+ <a>File Upload</a> <a>state</a>.
</p>
<p>
The <code>HTMLInputElement</code> interface's <code>accept</code>
- attribute takes precedence over the <code>capture</code> attribute.
- That is, if the <code>accept</code> attribute's value is set to a
- MIME type that is not accepted in a defined capture <a>state</a>, the
- <a>user agent</a> MUST act as if there was no <code>capture</code>
- attribute.
+ attribute takes precedence over the <code><a>capture</a></code>
+ attribute. That is, if the <code>accept</code> attribute's value is set
+ to a MIME type that is not accepted in a defined capture <a>state</a>,
+ the <a>user agent</a> MUST act as if there was no <code><a>capture
+ </a></code> attribute.
</p>
<div class="note">
- This specification complements the following behavior defined in
- <a href="http://dev.w3.org/html5/spec/states-of-the-type-attribute.html#file-upload-state-type-file">
- File Upload State</a> [[!HTML5]]: User agents may use the value of
- [the <code>accept</code>] attribute to display a more appropriate user
- interface than a generic file picker. For instance, given the value
- <code>image/*</code>, a user agent could offer the user the option of
- using a local camera or selecting a photograph from their photo
- collection; given the value <code>audio/*, </code> a user agent could
- offer the user the option of recording a clip using a headset
+ This specification complements the following behavior defined in the
+ <a>File Upload</a> <a>state</a> [[!HTML5]]: User agents may use the
+ value of [the <code>accept</code>] attribute to display a more
+ appropriate user interface than a generic file picker. For instance,
+ given the value <code>image/*</code>, a user agent could offer the user
+ the option of using a local camera or selecting a photograph from their
+ photo collection; given the value <code>audio/*, </code> a user agent
+ could offer the user the option of recording a clip using a headset
microphone.
</div>
</section>
@@ -162,22 +197,23 @@
<section class="appendix informative">
<h2>Examples</h2>
<p>
- The following example indicates that the user is expected to take a
- picture using the device's camera, and upload the picture taken:
+ The following example gives a hint that it is preferred for the user to
+ take a picture using the device's local camera, and upload the picture
+ taken:
</p>
<pre class="example sh_html">
<input type="file" accept="image/*" capture="camera">
</pre>
<p>
- When an <code>input</code> element's <code>capture</code> attribute is
- in the <a>Image Capture</a> state, the file picker may render as
- presented on the right side. When the attribute is in the <a>File
- Upload</a> state, the generic file picker may render as represented on
- the left side.
+ When an <code><a>input</a></code> element's <code><a>capture</a></code>
+ attribute is in the <a>Image Capture</a> <a>state</a>, the file picker
+ may render as presented on the right side. When the attribute is in the
+ <a>File Upload</a> <a>state</a>, the generic file picker may render as
+ represented on the left side.
</p>
<p>
- <img alt="A File picker with camera support"
- src="capture-api-file-picker-concept.png">
+ <img alt="A File picker control in the File Upload (left) and Image
+ Capture state (right)." src="capture-api-file-picker-concept.png">
</p>
</section>
Received on Tuesday, 15 May 2012 06:45:42 UTC