[MC&S] Spellchecked the source...
authortravil@travilmobile.wingroup.windeploy.ntdev.microsoft.com
Wed, 12 Dec 2012 02:21:37 -0800
changeset 311 65234ad9a31a
parent 310 4f4ba063f601
child 312 fee68c4239e3
[MC&S] Spellchecked the source...
media-stream-capture/proposals/SettingsAPI_respec.html
--- a/media-stream-capture/proposals/SettingsAPI_respec.html	Wed Dec 12 02:05:02 2012 -0800
+++ b/media-stream-capture/proposals/SettingsAPI_respec.html	Wed Dec 12 02:21:37 2012 -0800
@@ -59,7 +59,7 @@
         <p>EKR's comments about wondering what happens when multiple apps (or tabs within a browser) go to access and manipulate
             a source also resonated with me. He proposed that this either be not allowed (exclusive locks on devices by apps), or 
             that this be better defined somehow.</p>
-        <p>In thinking about this and wanting to have a better answer than the exclusive lock route, it occured to me that when choosing 
+        <p>In thinking about this and wanting to have a better answer than the exclusive lock route, it occurred to me that when choosing 
             to grant a second app access to the same device, we might offer more than one choice. One choice that we've assumed so far, 
             is to share one device among two apps with either app having the ability to modify the devices' settings. Another option
             that I explore in this proposal is the concept of granting a read-only version of the device. There may be a primary owner
@@ -71,12 +71,12 @@
             be read-only anyway--you wouldn't be allowed to adjust the meta-data of a video streaming from the user's hard drive anyway.
         </p>
         <p>So the "read-only" media source concept was born.</p>
-        <p>The set of source objects was now starting to grow. I could forsee it being difficult to rationalize/manage these objects, their
+        <p>The set of source objects was now starting to grow. I could foresee it being difficult to rationalize/manage these objects, their
             purpose and/or properties into the future, and I as thought about all of these points together, it became clear that having 
             an explicit object defined for various source devices/things was unnecessary overhead and complication.
         </p>
-        <p>As such, the source objects that came into existance in the v4 proposal as track sub-types, and were changed in v5 to be objects
-            tied to tracks, are now gone. Instead, track sources have been simplified into a sigle string itentifier on a track, which allows 
+        <p>As such, the source objects that came into existence in the v4 proposal as track sub-types, and were changed in v5 to be objects
+            tied to tracks, are now gone. Instead, track sources have been simplified into a single string identifier on a track, which allows 
             the app to understand how access to various things about a track behave given a certain type of source (or no source).
         </p>
         <p>In order to clarify the track's behavior under various source types, I also had to get crisp about the things called "settings" 
@@ -111,7 +111,7 @@
                     <tbody>
                         <tr><td>unknown-authorization</td><td>The source hasn't yet been authorized for use by the 
                             application. (Authorization occurs via the getUserMedia API.) All sources start out in this mode at the start of the
-                            application (though trusted hardware or software envirnments MAY automatically pre-authorize certain sources when 
+                            application (though trusted hardware or software environments MAY automatically pre-authorize certain sources when 
                             their use is requested via getUserMedia). Camera or microphone sources that are visible to the user agent can make 
                             their existence known to the application in this mode. Other sources like files on the local file system do not.</td></tr>
                         <tr><td>armed</td><td>the source has been granted use by the application and is on/ready, but not actively broadcasting 
@@ -122,7 +122,7 @@
                         <tr><td>streaming</td><td>The source has been granted use by the application and is actively streaming media. User agents 
                             should provide an indicator to the user that the source is on and streaming in this mode.</td></tr>
                         <tr><td>not-authorized</td><td>This source has been forbidden/rejected by the user.</td></tr>
-                        <tr><td>off</td><td>The source has been turned off, but is still detectable (its existance can still be confirmed) by the 
+                        <tr><td>off</td><td>The source has been turned off, but is still detectable (its existence can still be confirmed) by the 
                             application.</td></tr>
                     </tbody>
                 </table>
@@ -153,7 +153,7 @@
             <dt><dfn title="state">State</dfn></dt>
             <dt>Source State</dt>
             <dd>State refers to the immediate, current value of the source's [optionally constrained] capabilities. State is always read-only.
-                <p>A source's state can change dynamically over time due to envirnmental conditions, sink configurations, or constraint changes. A source's 
+                <p>A source's state can change dynamically over time due to environmental conditions, sink configurations, or constraint changes. A source's 
                     state must always conform to the current set of mandatory constraints that [each of] the tracks it is bound to have defined, and 
                     should do its best to conform to the set of optional constraints specified.
                 </p>
@@ -185,10 +185,10 @@
                 <p>Constraints are stored on the track object, not the source. Each track can be optionally initialized with constraints, or constraints can
                     be added afterward through the constraint APIs defined in this spec.
                 </p>
-                <p>Applying track level contraints to a source is conditional based on the type of source. For example, read-only sources
+                <p>Applying track level constraints to a source is conditional based on the type of source. For example, read-only sources
                     will ignore any specified constraints on the track.
                 </p>
-                <p>It is possible for two tracks that share a unique source to apply contradictory constraints. Under such contraditions, the implementation 
+                <p>It is possible for two tracks that share a unique source to apply contradictory constraints. Under such contradictions, the implementation 
                     may be forced to transition to the source to the "armed" state until the conflict is resolved.
                 </p>
                 <p>Events are available that allow the application to know when constraints cannot be met by the user agent. These typically occur when
@@ -231,7 +231,7 @@
         <section>
             <h2>Generic Tracks</h2>
 
-            <p>This section describes the <dfn>MediaStreamTrack</dfn> interface (currently in the Media Capture and Streams document), but makes targetted changes in order 
+            <p>This section describes the <dfn>MediaStreamTrack</dfn> interface (currently in the Media Capture and Streams document), but makes targeted changes in order 
                 to add the <code>"new"</code> state and associated event handler (<code>onstarted</code>). The definition is otherwise identical to the current definition except that the defined 
                 constants are replaced by strings (using an enumerated type).
             </p>
@@ -376,7 +376,7 @@
                         list constitute those sources that the user agent can identify at the time the API is called (the list can grow/shrink over time as sources may be added or 
                         removed). As a static method, <a>getSourceIds</a> can be queried without instantiating any <a>VideoStreamTrack</a> objects or without calling <code>getUserMedia</code>.
                         <p class="issue"><strong>Issue: </strong> This information deliberately adds to the fingerprinting surface of the UA. However, this information 
-                            will not be identifyable outside the scope of this application. could also be obtained via other round-about techniques using <code>getUserMedia</code>. This editor deems it worthwhile directly providing
+                            will not be identifiable outside the scope of this application. could also be obtained via other round-about techniques using <code>getUserMedia</code>. This editor deems it worthwhile directly providing
                             this data as it seems important for determining whether multiple devices of this type are available.
                         </p>
                     </dd>
@@ -742,14 +742,14 @@
                     <dt>notavailable</dt><dd>The exposure mode is not known or not available on this source.</dd>
                     <dt>auto</dt><dd>The exposure mode is automatically configured/adjusted at the source's discretion.</dd>
                     <dt>frame-average</dt><dd>The light sensor should average of light information from entire scene.</dd>
-                    <dt>center-weighted</dt><dd>The light sensor should bias sensitivity concentrated towards center of viewfinder.</dd>
+                    <dt>center-weighted</dt><dd>The light sensor should bias sensitivity concentrated toward center of viewfinder.</dd>
                     <dt>spot-metering</dt><dd>The light sensor should only consider a centered spot area for exposure calculations.</dd>
                 </dl>
             
                 <p><dfn>PhotoISOModeEnum</dfn> enumeration</p>
                 <dl class="idl" title="enum PhotoISOModeEnum">
-                    <dt>notavailable</dt><dd>The iso value is not known or not available on this source.</dd>
-                    <dt>auto</dt><dd>The iso value is automatically selected/adjusted at the source's discretion.</dd>
+                    <dt>notavailable</dt><dd>The ISO value is not known or not available on this source.</dd>
+                    <dt>auto</dt><dd>The ISO value is automatically selected/adjusted at the source's discretion.</dd>
                     <dt>100</dt><dd>An ASA rating of 100</dd>
                     <dt>200</dt><dd>An ASA rating of 200</dd>
                     <dt>400</dt><dd>An ASA rating of 400</dd>
@@ -851,7 +851,7 @@
                     </dd>
                 </dl>
 
-                <p>The following define the <dfn>MediaStreamTrackStateEvent</dfn> object and related initalizer.</p>
+                <p>The following define the <dfn>MediaStreamTrackStateEvent</dfn> object and related initializer.</p>
                 
                 <dl class="idl" title="[Constructor(DOMString type, optional MediaStreamTrackStateEventInit eventInitDict)] interface MediaStreamTrackStateEvent : Event">
                     <dt>readonly attribute DOMString[] states</dt>
@@ -935,7 +935,7 @@
     <section>
         <h1>Source Capabilities</h1>
 
-        <p>This section describes APIs for retrieving the capabilites of a given source. The return value of these APIs is contingent on
+        <p>This section describes APIs for retrieving the capabilities of a given source. The return value of these APIs is contingent on
             the track's <a>sourceType</a> value as summarized in the table below.
         </p>
 
@@ -1013,7 +1013,7 @@
                 <dt>(AllVideoCapabilities or AllAudioCapabilities) capabilities()</dt>
                 <dd>Returns a dictionary with all of the capabilities for the track type. If the track type is <a>VideoStreamTrack</a>, the 
                     <a>AllVideoCapabilities</a> dictionary is returned. If the track type is <a>AudioStreamTrack</a>, the 
-                    <a>AllAudioCapabilities</a> dictinoary is returned.
+                    <a>AllAudioCapabilities</a> dictionary is returned.
                     <p>The dictionaries are populated as if each <a>state</a> were requested individually using <code>getCapability()</code>,
                         and the results of that API are assigned as the value of each stateName in the dictionary. Notably, the returned values
                     </p>
@@ -1231,7 +1231,7 @@
         <section>
             <h2>Constraint Manipulation API Extensions to MediaStreamTrack</h2>
 
-            <p>Constraints are indpendent of sources. However, depending on the <a>sourceType</a> the track's constraints may or may not actually be considered by the user 
+            <p>Constraints are independent of sources. However, depending on the <a>sourceType</a> the track's constraints may or may not actually be considered by the user 
                 agent. The following table summarizes the expectations around track constraints given a <a>sourceType</a>.
             </p>
 
@@ -1338,7 +1338,7 @@
 					</dl>
                     <p>This method updates the value of a same-named existing constraint (if found) in either the mandatory or optional list, and otherwise sets 
                         the new constraint.</p>
-                    <p>This method searches the list of optional constraints from index <code>0</code> (hightest priority) to the end of the list (lowest priority)
+                    <p>This method searches the list of optional constraints from index <code>0</code> (highest priority) to the end of the list (lowest priority)
                         looking for matching constraints. Therefore, for multiple same-named optional constraints, this method will only update the
                         value of the highest-priority matching constraint.
                     </p>
@@ -1395,7 +1395,7 @@
                         result in also dispatching one or more "muted" events to affected tracks.
                     </p>
                     <p>The affected track(s) will remain un-usable (in the <code>"muted"</code> <a>readyState</a>) until the application adjusts the 
-                        constraints to accomodate the source's capabilities.</p>
+                        constraints to accommodate the source's capabilities.</p>
                     <p>The "overconstrained" event is a simple event of type <code>Event</code>; it carries no information about which constraints 
                         caused the source to be over-constrained (the application has all the necessary APIs to figure it out).
                     </p>
@@ -1441,7 +1441,7 @@
                     </thead>
                     <tbody>
                         <tr id="def-constraint-width">
-                            <td>witdh</td>
+                            <td>width</td>
                             <td>unsigned long or <a>MinMaxConstraint</a></td>
                             <td>Constrain the video source to the exact desired width or width range.</td>
                         </tr>
@@ -1500,8 +1500,8 @@
                             <td>unsigned long or <a>MinMaxConstraint</a></td>
                             <td>Constrain the video source to the exact desired sharpness or sharpness range.</td>
                         </tr>
-                        <tr id="def-constraint-photoWitdh">
-                            <td>photoWitdh</td>
+                        <tr id="def-constraint-photoWidth">
+                            <td>photoWidth</td>
                             <td>unsigned long or <a>MinMaxConstraint</a></td>
                             <td>Constrain the width of the photo produced by the <a>takePhoto</a> method to the exact desired width or width range.</td>
                         </tr>
@@ -1547,7 +1547,7 @@
                     </tbody>
                 </table>
 
-                <p>For constraints that accept ranges, the <a>MinMaxConstraits</a> dictionary is also defined. Note, that the type 
+                <p>For constraints that accept ranges, the <a>MinMaxConstraint</a> dictionary is also defined. Note, that the type 
                     of the value associated with <code>min</code> and <code>max</code> must be the same for both. The specific 
                     types associated with <code>min</code> and <code>max</code> are defined differently for each constraint name.</p>