Skip to content

Commit

Permalink
Merge pull request #303 from w3c/devicedescription-permission
Browse files Browse the repository at this point in the history 
SHA: b40cae2
Reason: push, by jan-ivar

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
@jan-ivar @github-actions
jan-ivar and github-actions[bot] committed Oct 26, 2023
1 parent 5d4c4a8 commit e3ae985
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
<meta content="Bikeshed version 82ce88815, updated Thu Sep 7 16:33:55 2023 -0700" name="generator">
<link href="https://www.w3.org/TR/image-capture/" rel="canonical">
<meta content="35734a5c5919937bf456aed1316ebcc9b9a65e7f" name="document-revision">
<meta content="b40cae2a7a967c5fbb4b9100f60c7bf5953ab352" name="document-revision">
<style>
table {
border-collapse: collapse;
Expand Down Expand Up @@ -665,7 +665,7 @@
<div class="head">
<p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
<h1 class="p-name no-ref" id="title">MediaStream Image Capture</h1>
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2023-10-10">10 October 2023</time></p>
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2023-10-26">26 October 2023</time></p>
<details open>
<summary>More details about this document</summary>
<div data-fill-with="spec-metadata">
Expand Down Expand Up @@ -1384,19 +1384,19 @@ <h2 class="heading settled" data-level="10" id="constrainable-properties"><span
<li>
<dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="pan">Pan</dfn> is a numeric camera setting that controls the pan of the camera. The setting represents pan in arc seconds, which are 1/3600th of a degree. Values are in the range from -180*3600 arc seconds to +180*3600 arc seconds. Positive values pan the camera clockwise as viewed from above, and negative values pan the camera counter clockwise as viewed from above.
<p>Constraints on pan influence camera selection through <a data-link-type="dfn" href="https://w3c.github.io/mediacapture-main/#dfn-fitness-distance" id="ref-for-dfn-fitness-distance">fitness distance</a> toward cameras with the ability to pan. To exert this influence without overwriting the current pan setting, pan may be constrained to true. Conversely, constraining it to false disfavors cameras with the ability to pan.</p>
<p>Any algorithm which uses a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediatrackconstraintset" id="ref-for-dom-mediatrackconstraintset③">MediaTrackConstraintSet</a></code> object whose <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-pan" id="ref-for-dom-mediatrackconstraintset-pan①">pan</a></code> dictionary member exists with a value other than false MUST either <a data-link-type="dfn" href="https://w3c.github.io/permissions/#dfn-request-permission-to-use" id="ref-for-dfn-request-permission-to-use⑥">request permission to use</a> (as defined in <a data-link-type="biblio" href="#biblio-permissions" title="Permissions">[permissions]</a>) a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/permissions/#dom-permissiondescriptor" id="ref-for-dom-permissiondescriptor⑥">PermissionDescriptor</a></code> with its name member set to <a class="idl-code" data-link-type="permission" href="https://w3c.github.io/mediacapture-main/#dfn-camera" id="ref-for-dfn-camera⑥">camera</a> and its <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-cameradevicepermissiondescriptor-pantiltzoom" id="ref-for-dom-cameradevicepermissiondescriptor-pantiltzoom⑥">panTiltZoom</a></code> member set to true, and, optionally, consider its <code class="idl"><a data-link-type="idl">deviceId</a></code> member set to any appropriate device’s deviceId, or decide not to expose the pan setting.</p>
<p>Any algorithm which uses a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediatrackconstraintset" id="ref-for-dom-mediatrackconstraintset③">MediaTrackConstraintSet</a></code> object whose <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-pan" id="ref-for-dom-mediatrackconstraintset-pan①">pan</a></code> dictionary member exists with a value other than false MUST either <a data-link-type="dfn" href="https://w3c.github.io/permissions/#dfn-request-permission-to-use" id="ref-for-dfn-request-permission-to-use⑥">request permission to use</a> (as defined in <a data-link-type="biblio" href="#biblio-permissions" title="Permissions">[permissions]</a>) a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/permissions/#dom-permissiondescriptor" id="ref-for-dom-permissiondescriptor⑥">PermissionDescriptor</a></code> with its name member set to <a class="idl-code" data-link-type="permission" href="https://w3c.github.io/mediacapture-main/#dfn-camera" id="ref-for-dfn-camera⑥">camera</a> and its <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-cameradevicepermissiondescriptor-pantiltzoom" id="ref-for-dom-cameradevicepermissiondescriptor-pantiltzoom⑥">panTiltZoom</a></code> member set to true, or decide not to expose the pan setting.</p>
<p>If the <code class="idl"><a data-link-type="idl" href="https://html.spec.whatwg.org/multipage/interaction.html#dom-document-visibilitystate" id="ref-for-dom-document-visibilitystate">visibilityState</a></code> of the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/document-sequences.html#top-level-browsing-context" id="ref-for-top-level-browsing-context">top-level browsing context</a> value is "hidden", the <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediastreamtrack-applyconstraints" id="ref-for-dom-mediastreamtrack-applyconstraints②">applyConstraints()</a></code> algorithm MUST throw a <code class="idl"><a data-link-type="idl" href="https://webidl.spec.whatwg.org/#securityerror" id="ref-for-securityerror">SecurityError</a></code> if <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-pan" id="ref-for-dom-mediatrackconstraintset-pan②">pan</a></code> dictionary member exists with a value other than false.</p>
<p></p>
<li>
<dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="tilt">Tilt</dfn> is a numeric camera setting that controls the tilt of the camera. The setting represents tilt in arc seconds, which are 1/3600th of a degree. Values are in the range from -180*3600 arc seconds to +180*3600 arc seconds. Positive values tilt the camera upward when viewed from the front, and negative values tilt the camera downward as viewed from the front.
<p>Constraints on tilt influence camera selection through <a data-link-type="dfn" href="https://w3c.github.io/mediacapture-main/#dfn-fitness-distance" id="ref-for-dfn-fitness-distance①">fitness distance</a> toward cameras with the ability to tilt. To exert this influence without overwriting the current tilt setting, tilt may be constrained to true. Conversely, constraining it to false disfavors cameras with the ability to tilt.</p>
<p>Any algorithm which uses a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediatrackconstraintset" id="ref-for-dom-mediatrackconstraintset④">MediaTrackConstraintSet</a></code> object whose <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-tilt" id="ref-for-dom-mediatrackconstraintset-tilt①">tilt</a></code> dictionary member exists with a value other than false MUST either <a data-link-type="dfn" href="https://w3c.github.io/permissions/#dfn-request-permission-to-use" id="ref-for-dfn-request-permission-to-use⑦">request permission to use</a> (as defined in <a data-link-type="biblio" href="#biblio-permissions" title="Permissions">[permissions]</a>) a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/permissions/#dom-permissiondescriptor" id="ref-for-dom-permissiondescriptor⑦">PermissionDescriptor</a></code> with its name member set to <a class="idl-code" data-link-type="permission" href="https://w3c.github.io/mediacapture-main/#dfn-camera" id="ref-for-dfn-camera⑦">camera</a> and its <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-cameradevicepermissiondescriptor-pantiltzoom" id="ref-for-dom-cameradevicepermissiondescriptor-pantiltzoom⑦">panTiltZoom</a></code> member set to true, and, optionally, consider its <code class="idl"><a data-link-type="idl">deviceId</a></code> member set to any appropriate device’s deviceId, or decide not to expose the tilt setting.</p>
<p>Any algorithm which uses a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediatrackconstraintset" id="ref-for-dom-mediatrackconstraintset④">MediaTrackConstraintSet</a></code> object whose <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-tilt" id="ref-for-dom-mediatrackconstraintset-tilt①">tilt</a></code> dictionary member exists with a value other than false MUST either <a data-link-type="dfn" href="https://w3c.github.io/permissions/#dfn-request-permission-to-use" id="ref-for-dfn-request-permission-to-use⑦">request permission to use</a> (as defined in <a data-link-type="biblio" href="#biblio-permissions" title="Permissions">[permissions]</a>) a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/permissions/#dom-permissiondescriptor" id="ref-for-dom-permissiondescriptor⑦">PermissionDescriptor</a></code> with its name member set to <a class="idl-code" data-link-type="permission" href="https://w3c.github.io/mediacapture-main/#dfn-camera" id="ref-for-dfn-camera⑦">camera</a> and its <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-cameradevicepermissiondescriptor-pantiltzoom" id="ref-for-dom-cameradevicepermissiondescriptor-pantiltzoom⑦">panTiltZoom</a></code> member set to true, or decide not to expose the tilt setting.</p>
<p>If the <code class="idl"><a data-link-type="idl" href="https://html.spec.whatwg.org/multipage/interaction.html#dom-document-visibilitystate" id="ref-for-dom-document-visibilitystate①">visibilityState</a></code> of the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/document-sequences.html#top-level-browsing-context" id="ref-for-top-level-browsing-context①">top-level browsing context</a> value is "hidden", the <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediastreamtrack-applyconstraints" id="ref-for-dom-mediastreamtrack-applyconstraints③">applyConstraints()</a></code> algorithm MUST throw a <code class="idl"><a data-link-type="idl" href="https://webidl.spec.whatwg.org/#securityerror" id="ref-for-securityerror①">SecurityError</a></code> if <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-tilt" id="ref-for-dom-mediatrackconstraintset-tilt②">tilt</a></code> dictionary member exists with a value other than false.</p>
<div class="note" role="note"> There is no defined order when applying <a data-link-type="dfn" href="#pan" id="ref-for-pan①①">pan</a> and <a data-link-type="dfn" href="#tilt" id="ref-for-tilt①①">tilt</a>, the UA is allowed to apply them in any order. In practice this should not matter since these values are absolute, so order will not affect the final position. However, if applying pan and tilt is slow enough, the order in which they are applied may be visually noticeable. </div>
<li>
<dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="zoom">Zoom</dfn> is a numeric camera setting that controls the focal length of the lens. The setting usually represents a ratio, e.g. 4 is a zoom ratio of 4:1. The minimum value is usually 1, to represent a 1:1 ratio (i.e. no zoom).
<p>Constraints on zoom influence camera selection through <a data-link-type="dfn" href="https://w3c.github.io/mediacapture-main/#dfn-fitness-distance" id="ref-for-dfn-fitness-distance②">fitness distance</a> toward cameras with the ability to zoom. To exert this influence without overwriting the current zoom setting, zoom may be constrained to true. Conversely, constraining it to false disfavors cameras with the ability to zoom.</p>
<p>Any algorithm which uses a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediatrackconstraintset" id="ref-for-dom-mediatrackconstraintset⑤">MediaTrackConstraintSet</a></code> object whose <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-zoom" id="ref-for-dom-mediatrackconstraintset-zoom①">zoom</a></code> dictionary member exists with a value other than false MUST either <a data-link-type="dfn" href="https://w3c.github.io/permissions/#dfn-request-permission-to-use" id="ref-for-dfn-request-permission-to-use⑧">request permission to use</a> (as defined in <a data-link-type="biblio" href="#biblio-permissions" title="Permissions">[permissions]</a>) a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/permissions/#dom-permissiondescriptor" id="ref-for-dom-permissiondescriptor⑧">PermissionDescriptor</a></code> with its name member set to <a class="idl-code" data-link-type="permission" href="https://w3c.github.io/mediacapture-main/#dfn-camera" id="ref-for-dfn-camera⑧">camera</a> and its <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-cameradevicepermissiondescriptor-pantiltzoom" id="ref-for-dom-cameradevicepermissiondescriptor-pantiltzoom⑧">panTiltZoom</a></code> member set to true, and, optionally, consider its <code class="idl"><a data-link-type="idl">deviceId</a></code> member set to any appropriate device’s deviceId, or decide not to expose the zoom setting.</p>
<p>Any algorithm which uses a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediatrackconstraintset" id="ref-for-dom-mediatrackconstraintset⑤">MediaTrackConstraintSet</a></code> object whose <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-zoom" id="ref-for-dom-mediatrackconstraintset-zoom①">zoom</a></code> dictionary member exists with a value other than false MUST either <a data-link-type="dfn" href="https://w3c.github.io/permissions/#dfn-request-permission-to-use" id="ref-for-dfn-request-permission-to-use⑧">request permission to use</a> (as defined in <a data-link-type="biblio" href="#biblio-permissions" title="Permissions">[permissions]</a>) a <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/permissions/#dom-permissiondescriptor" id="ref-for-dom-permissiondescriptor⑧">PermissionDescriptor</a></code> with its name member set to <a class="idl-code" data-link-type="permission" href="https://w3c.github.io/mediacapture-main/#dfn-camera" id="ref-for-dfn-camera⑧">camera</a> and its <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-cameradevicepermissiondescriptor-pantiltzoom" id="ref-for-dom-cameradevicepermissiondescriptor-pantiltzoom⑧">panTiltZoom</a></code> member set to true, or decide not to expose the zoom setting.</p>
<p>If the <code class="idl"><a data-link-type="idl" href="https://html.spec.whatwg.org/multipage/interaction.html#dom-document-visibilitystate" id="ref-for-dom-document-visibilitystate②">visibilityState</a></code> of the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/document-sequences.html#top-level-browsing-context" id="ref-for-top-level-browsing-context②">top-level browsing context</a> value is "hidden", the <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/mediacapture-main/#dom-mediastreamtrack-applyconstraints" id="ref-for-dom-mediastreamtrack-applyconstraints④">applyConstraints()</a></code> algorithm MUST throw a <code class="idl"><a data-link-type="idl" href="https://webidl.spec.whatwg.org/#securityerror" id="ref-for-securityerror②">SecurityError</a></code> if <code class="idl"><a data-link-type="idl" href="#dom-mediatrackconstraintset-zoom" id="ref-for-dom-mediatrackconstraintset-zoom②">zoom</a></code> dictionary member exists with a value other than false.</p>
<p></p>
<li><dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="fill-light-mode">Fill light mode</dfn> describes the flash setting of the capture device (e.g. <code>auto</code>, <code>off</code>, <code>on</code>). <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="torch">Torch</dfn> describes the setting of the source’s fill light as continuously connected, staying on as long as <code class="idl"><a data-link-type="idl" href="#dom-imagecapture-track" id="ref-for-dom-imagecapture-track①⑤">track</a></code> is active.
Expand Down

0 comments on commit e3ae985

Please sign in to comment.