Skip to content

Commit

Permalink
Add exposureTime property (#200)
Browse files Browse the repository at this point in the history 
* Add exposureTime property: See #199

* Make it clear that exposureCompensation is only for automatic exposure modes

* Added more links to exposure modes, and used {{ }} format

* Address review comments
  • Loading branch information
@bringert @yellowdoge
bringert authored and yellowdoge committed Mar 19, 2018
1 parent a97da94 commit 0c36042
Showing 1 changed file with 21 additions and 3 deletions.
24 changes: 21 additions & 3 deletions index.bs
View file
Expand Up @@ -359,6 +359,7 @@ This Section defines a number of new set of <a>Constrainable Properties</a> for
boolean pointsOfInterest = true;

boolean exposureCompensation = true;
boolean exposureTime = true;
boolean colorTemperature = true;
boolean iso = true;

Expand Down Expand Up @@ -387,6 +388,9 @@ This Section defines a number of new set of <a>Constrainable Properties</a> for
<dt><dfn dict-member for="MediaTrackSupportedConstraints"><code>exposureCompensation</code></dfn></dt>
<dd>Whether <a>exposure compensation</a> constraining is recognized.</dd>

<dt><dfn dict-member for="MediaTrackSupportedConstraints"><code>exposureTime</code></dfn></dt>
<dd>Whether <a>exposure time</a> constraining is recognized.</dd>

<dt><dfn dict-member for="MediaTrackSupportedConstraints"><code>iso</code></dfn></dt>
<dd>Whether <a>ISO</a> constraining is recognized.</dd>

Expand Down Expand Up @@ -429,6 +433,7 @@ This Section defines a number of new set of <a>Constrainable Properties</a> for
sequence&lt;DOMString> focusMode;

MediaSettingsRange exposureCompensation;
MediaSettingsRange exposureTime;
MediaSettingsRange colorTemperature;
MediaSettingsRange iso;

Expand Down Expand Up @@ -459,6 +464,9 @@ This Section defines a number of new set of <a>Constrainable Properties</a> for
<dt><dfn dict-member for="MediaTrackCapabilities"><code>exposureCompensation</code></dfn></dt>
<dd>This reflects the supported range of <a>exposure compensation</a>. The supported range can be, and usually is, centered around 0 EV.</dd>

<dt><dfn dict-member for="MediaTrackCapabilities"><code>exposureTime</code></dfn></dt>
<dd>This reflects the supported range of <a>exposure time</a>. Values are numeric. Increasing values indicate increasing exposure time.</dd>

<dt><dfn dict-member for="MediaTrackCapabilities"><code>iso</code></dfn></dt>
<dd>This reflects the permitted range of <a>ISO</a> values.</dd>

Expand Down Expand Up @@ -503,6 +511,7 @@ This Section defines a number of new set of <a>Constrainable Properties</a> for
ConstrainPoint2D pointsOfInterest;

ConstrainDouble exposureCompensation;
ConstrainDouble exposureTime;
ConstrainDouble colorTemperature;
ConstrainDouble iso;

Expand Down Expand Up @@ -536,6 +545,9 @@ This Section defines a number of new set of <a>Constrainable Properties</a> for
<dt><dfn dict-member for="MediaTrackConstraintSet"><code>exposureCompensation</code></dfn></dt>
<dd>See <a>exposure compensation</a> constrainable property.</dd>

<dt><dfn dict-member for="MediaTrackConstraintSet"><code>exposureTime</code></dfn></dt>
<dd>See <a>exposure time</a> constrainable property.</dd>

<dt><dfn dict-member for="MediaTrackConstraintSet"><code>iso</code></dfn></dt>
<dd>See <a>iso</a> constrainable property.</dd>

Expand Down Expand Up @@ -576,6 +588,7 @@ When the {{getSettings()}} method is invoked on a video stream track, the user a
sequence&lt;Point2D> pointsOfInterest;

double exposureCompensation;
double exposureTime;
double colorTemperature;
double iso;

Expand Down Expand Up @@ -604,7 +617,10 @@ When the {{getSettings()}} method is invoked on a video stream track, the user a
<dd><a>Color temperature</a> in use for the white balance calculation of the scene. This field is only significant if {{MediaTrackSettings/whiteBalanceMode}} is {{manual}}.</dd>

<dt><dfn dict-member for="MediaTrackSettings"><code>exposureCompensation</code></dfn></dt>
<dd>Current <a>exposure compensation</a> setting. A value of 0 EV is interpreted as no exposure compensation.</dd>
<dd>Current <a>exposure compensation</a> setting. A value of 0 EV is interpreted as no exposure compensation. This field is only significant if {{MediaTrackSettings/exposureMode}} is {{MeteringMode/continuous}} or {{MeteringMode/single-shot}}</dd>

<dt><dfn dict-member for="MediaTrackSettings"><code>exposureTime</code></dfn></dt>
<dd>Current <a>exposure time</a> setting. This field is only significant if {{MediaTrackSettings/exposureMode}} is {{manual}}.</dd>

<dt><dfn dict-member for="MediaTrackSettings"><code>iso</code></dfn></dt>
<dd>Current camera <a>ISO</a> setting.</dd>
Expand Down Expand Up @@ -680,15 +696,17 @@ When the {{getSettings()}} method is invoked on a video stream track, the user a
</table>
</li>

<li><i><dfn>Exposure</dfn></i> is the amount of time during which light is allowed to fall on the photosensitive device. Auto-exposure mode is a camera setting where the exposure levels are automatically adjusted by the implementation based on the subject of the photo.</li>
<li><i><dfn>Exposure</dfn></i> is the amount of light that is allowed to fall on the photosensitive device. In auto-exposure modes ({{MeteringMode/single-shot}} or {{MeteringMode/continuous}} {{MediaTrackSettings/exposureMode}}), the exposure time and/or camera aperture are automatically adjusted by the implementation based on the subject of the photo. In {{MeteringMode/manual}} {{MediaTrackSettings/exposureMode}}, these parameters are set to fixed absolute values.</li>

<li><dfn>Focus mode</dfn> describes the focus setting of the capture device (e.g. |auto| or |manual|). </li>

<li><dfn>Points of interest</dfn> describe the metering area centers used in other settings, e.g. <a>exposure</a>, <a>white balance mode</a> and <a>focus mode</a> each one being a {{Point2D}} (usually these three controls are modified simultaneously by the so-called <code>3A</code> algorithm: auto-focus, auto-exposure, auto-white-balance).

A {{Point2D}} Point of Interest is interpreted to represent a pixel position in a normalized square space (|{x,y} &isin; [0.0, 1.0]|). The origin of coordinates |{x,y} = {0.0, 0.0}| represents the upper leftmost corner whereas the |{x,y} = {1.0, 1.0}| represents the lower rightmost corner: the <a href="#dom-point2d-x"><code>x</code></a> coordinate (columns) increases rightwards and the <a href="#dom-point2d-y"><code>y</code></a> coordinate (rows) increases downwards. Values beyond the mentioned limits will be clamped to the closest allowed value.</li>

<li><i><dfn>Exposure Compensation</dfn></i> is a numeric camera setting that adjusts the exposure level from the current value used by the implementation. This value can be used to bias the exposure level enabled by auto-exposure, and usually is a symmetric range around 0 EV (the no-compensation value).</li>
<li><i><dfn>Exposure Compensation</dfn></i> is a numeric camera setting that adjusts the exposure level from the current value used by the implementation. This value can be used to bias the exposure level enabled by auto-exposure, and usually is a symmetric range around 0 EV (the no-compensation value). This value is only used in {{MeteringMode/single-shot}} and {{MeteringMode/continuous}} {{MediaTrackSettings/exposureMode}}.</li>

<li><i><dfn>Exposure Time</dfn></i> is a numeric camera setting that controls the length of time during which light is allowed to fall on the photosensitive device. This value is used in {{MeteringMode/manual}} {{MediaTrackSettings/exposureMode}} to control exposure. The value is in 100 microsecond units. That is, a value of 1.0 means an exposure time of 1/10000th of a second and a value of 10000.0 means an exposure time of 1 second.</li>

<li>The <i><dfn>ISO</dfn></i> setting of a camera describes the sensitivity of the camera to light. It is a numeric value, where the lower the value the greater the sensitivity. This value should follow the [[iso12232]] standard.</li>

Expand Down

0 comments on commit 0c36042

Please sign in to comment.