|
102 | 102 | ==========================
|
103 | 103 |
|
104 | 104 | : <dfn>Codec</dfn>
|
105 |
| -:: Refers generically to an instance of AudioDecoder, AudioEncoder, |
106 |
| - VideoDecoder, or VideoEncoder. |
| 105 | +:: Refers generically to an instance of {{AudioDecoder}}, {{AudioEncoder}}, |
| 106 | + {{VideoDecoder}}, or {{VideoEncoder}}. |
107 | 107 |
|
108 | 108 | : <dfn lt="Key Chunk|Key Frame">Key Chunk</dfn>
|
109 | 109 | :: An encoded chunk that does not depend on any other frames for decoding. Also
|
|
188 | 188 |
|
189 | 189 | This section describes threading behaviors as they are visible from the
|
190 | 190 | perspective of web authors. Implementers can choose to use more threads, as
|
191 |
| - long as the exernally visible behaviors of blocking and sequencing are |
| 191 | + long as the externally visible behaviors of blocking and sequencing are |
192 | 192 | maintained as follows.
|
193 | 193 | </div>
|
194 | 194 |
|
|
290 | 290 | {{AudioDecoder/[[control message queue]]}} is blocked by a pending
|
291 | 291 | [=control message=]. See [=[[message queue blocked]]=].
|
292 | 292 | : <dfn attribute for=AudioDecoder>[[codec implementation]]</dfn>
|
293 |
| -:: Underlying decoder implementation provided by the User Agent. |
| 293 | +:: Underlying decoder implementation provided by the User Agent. See |
| 294 | + [=[[codec implementation]]=]. |
294 | 295 | : <dfn attribute for=AudioDecoder>[[codec work queue]]</dfn>
|
295 | 296 | :: A [=parallel queue=] used for running parallel steps that reference the
|
296 | 297 | {{AudioDecoder/[[codec implementation]]}}. See [=[[codec work queue]]=].
|
297 | 298 | : <dfn attribute for=AudioDecoder>[[codec saturated]]</dfn>
|
298 |
| -:: A boolean indicating when the [[codec implementation]] is unable to accept |
299 |
| - additional decoding work. |
| 299 | +:: A boolean indicating when the {{AudioDecoder/[[codec implementation]]}} is |
| 300 | + unable to accept additional decoding work. |
300 | 301 | : <dfn attribute for=AudioDecoder>[[output callback]]</dfn>
|
301 | 302 | :: Callback given at construction for decoded outputs.
|
302 | 303 | : <dfn attribute for=AudioDecoder>[[error callback]]</dfn>
|
|
616 | 617 | {{VideoDecoder/[[control message queue]]}} is blocked by a pending
|
617 | 618 | [=control message=]. See [=[[message queue blocked]]=].
|
618 | 619 | : <dfn attribute for=VideoDecoder>[[codec implementation]]</dfn>
|
619 |
| -:: Underlying decoder implementation provided by the User Agent. |
| 620 | +:: Underlying decoder implementation provided by the User Agent. See |
| 621 | + [=[[codec implementation]]=]. |
620 | 622 | : <dfn attribute for=VideoDecoder>[[codec work queue]]</dfn>
|
621 | 623 | :: A [=parallel queue=] used for running parallel steps that reference the
|
622 | 624 | {{VideoDecoder/[[codec implementation]]}}. See [=[[codec work queue]]=].
|
623 | 625 | : <dfn attribute for=VideoDecoder>[[codec saturated]]</dfn>
|
624 |
| -:: A boolean indicating when the [[codec implementation]] is unable to accept |
625 |
| - additional decoding work. |
| 626 | +:: A boolean indicating when the {{VideoDecoder/[[codec implementation]]}} is |
| 627 | + unable to accept additional decoding work. |
626 | 628 | : <dfn attribute for=VideoDecoder>[[output callback]]</dfn>
|
627 | 629 | :: Callback given at construction for decoded outputs.
|
628 | 630 | : <dfn attribute for=VideoDecoder>[[error callback]]</dfn>
|
|
736 | 738 |
|
737 | 739 | NOTE: {{VideoDecoder}} requires that frames are output in the order they
|
738 | 740 | expect to be presented, commonly known as presentation order. When using
|
739 |
| - some {{VideoDecoder/[[codec implementation]]}}s the User Agent will have to |
| 741 | + some {{VideoDecoder/[[codec implementation]]}}s the User Agent will have |
740 | 742 | to reorder outputs into presentation order.
|
741 | 743 |
|
742 | 744 | When invoked, run these steps:
|
|
971 | 973 | {{AudioEncoder/[[control message queue]]}} is blocked by a pending
|
972 | 974 | [=control message=]. See [=[[message queue blocked]]=].
|
973 | 975 | : <dfn attribute for=AudioEncoder>[[codec implementation]]</dfn>
|
974 |
| -:: Underlying encoder implementation provided by the User Agent. |
| 976 | +:: Underlying encoder implementation provided by the User Agent. See |
| 977 | + [=[[codec implementation]]=]. |
975 | 978 | : <dfn attribute for=AudioEncoder>[[codec work queue]]</dfn>
|
976 | 979 | :: A [=parallel queue=] used for running parallel steps that reference the
|
977 | 980 | {{AudioEncoder/[[codec implementation]]}}. See [=[[codec work queue]]=].
|
978 | 981 | : <dfn attribute for=AudioEncoder>[[codec saturated]]</dfn>
|
979 |
| -:: A boolean indicating when the [[codec implementation]] is unable to accept |
980 |
| - additional encoding work. |
| 982 | +:: A boolean indicating when the {{AudioEncoder/[[codec implementation]]}} is |
| 983 | + unable to accept additional encoding work. |
981 | 984 | : <dfn attribute for=AudioEncoder>[[output callback]]</dfn>
|
982 | 985 | :: Callback given at construction for encoded outputs.
|
983 | 986 | : <dfn attribute for=AudioEncoder>[[error callback]]</dfn>
|
|
1343 | 1346 | {{VideoEncoder/[[control message queue]]}} is blocked by a pending
|
1344 | 1347 | [=control message=]. See [=[[message queue blocked]]=].
|
1345 | 1348 | : <dfn attribute for=VideoEncoder>[[codec implementation]]</dfn>
|
1346 |
| -:: Underlying encoder implementation provided by the User Agent. |
| 1349 | +:: Underlying encoder implementation provided by the User Agent. See |
| 1350 | + [=[[codec implementation]]=]. |
1347 | 1351 | : <dfn attribute for=VideoEncoder>[[codec work queue]]</dfn>
|
1348 | 1352 | :: A [=parallel queue=] used for running parallel steps that reference the
|
1349 | 1353 | {{VideoEncoder/[[codec implementation]]}}. See [=[[codec work queue]]=].
|
1350 | 1354 | : <dfn attribute for=VideoEncoder>[[codec saturated]]</dfn>
|
1351 |
| -:: A boolean indicating when the [[codec implementation]] is unable to accept |
1352 |
| - additional encoding work. |
| 1355 | +:: A boolean indicating when the {{VideoEncoder/[[codec implementation]]}} is |
| 1356 | + unable to accept additional encoding work. |
1353 | 1357 | : <dfn attribute for=VideoEncoder>[[output callback]]</dfn>
|
1354 | 1358 | :: Callback given at construction for encoded outputs.
|
1355 | 1359 | : <dfn attribute for=VideoEncoder>[[error callback]]</dfn>
|
|
2617 | 2621 | object.
|
2618 | 2622 |
|
2619 | 2623 | {{VideoFrame}}.{{VideoFrame/close()}} and {{AudioData}}.{{AudioData/close()}}
|
2620 |
| -will clear their [[resource reference]] slot, releasing the reference their |
| 2624 | +will clear their `[[resource reference]]` slot, releasing the reference their |
2621 | 2625 | [=media resource=].
|
2622 | 2626 |
|
2623 | 2627 | A [=media resource=] <em class="rfc2119">MUST</em> remain alive at least as long
|
|
3672 | 3676 | |output| in pixels.
|
3673 | 3677 | 8. Let |visibleLeft|, |visibleTop|, |visibleWidth|, and |visibleHeight| be
|
3674 | 3678 | the left, top, width and height for the visible rectangle of |output|.
|
3675 |
| - 7. Let |displayWidth| and |displayHeight| be the the display size of |
| 3679 | + 7. Let |displayWidth| and |displayHeight| be the display size of |
3676 | 3680 | |output| in pixels.
|
3677 | 3681 | 8. If |displayAspectWidth| and |displayAspectHeight| are provided,
|
3678 | 3682 | increase |displayWidth| or |displayHeight| until the ratio of
|
|
4087 | 4091 |
|
4088 | 4092 | Color space conversion during {{ImageBitmap}} construction is controlled by
|
4089 | 4093 | {{ImageBitmapOptions}} {{ImageBitmapOptions/colorSpaceConversion}}. Setting this
|
4090 |
| -value to "none" disables color space conversion. |
| 4094 | +value to {{ColorSpaceConversion/"none"}} disables color space conversion. |
4091 | 4095 |
|
4092 | 4096 | VideoFrame CopyTo() Options {#videoframe-copyto-options}
|
4093 | 4097 | ------------------------------------------------------------
|
|
4105 | 4109 | NOTE: The steps of {{VideoFrame/copyTo()}} or {{VideoFrame/allocationSize()}}
|
4106 | 4110 | will enforce the following requirements:
|
4107 | 4111 | * The coordinates of {{VideoFrameCopyToOptions/rect}} are
|
4108 |
| - sample-aligned as determiend by {{VideoFrame/[[format]]}}. |
| 4112 | + sample-aligned as determined by {{VideoFrame/[[format]]}}. |
4109 | 4113 | * If {{VideoFrameCopyToOptions/layout}} [=map/exists=], a {{PlaneLayout}}
|
4110 | 4114 | is provided for all planes.
|
4111 | 4115 | </div>
|
|
4128 | 4132 |
|
4129 | 4133 | DOMRects in VideoFrame {#videoframe-domrect}
|
4130 | 4134 | --------------------------------------------
|
4131 |
| -The {{VideoFrame}} interfaces uses {{DOMRect}}s to specify the position and |
| 4135 | +The {{VideoFrame}} interface uses {{DOMRect}}s to specify the position and |
4132 | 4136 | dimensions for a rectangle of pixels. {{DOMRectInit}} is used with
|
4133 | 4137 | {{VideoFrame/copyTo()}} and {{VideoFrame/allocationSize()}} to describe the
|
4134 | 4138 | dimensions of the source rectangle. {{VideoFrame}} defines
|
|
4145 | 4149 | {{PlaneLayout}}s <em class="rfc2119">MAY</em> be provided to {{VideoFrame}}'s
|
4146 | 4150 | {{VideoFrame/copyTo()}} to specify how the plane is laid out in the destination
|
4147 | 4151 | {{BufferSource}}}. Alternatively, callers can inspect {{VideoFrame/copyTo()}}'s
|
4148 |
| -returned sequence of {{PlaneLayout}}s to learn the the offset and stride for |
| 4152 | +returned sequence of {{PlaneLayout}}s to learn the offset and stride for |
4149 | 4153 | planes as decided by the User Agent.
|
4150 | 4154 |
|
4151 | 4155 | <xmp class='idl'>
|
|
4691 | 4695 | `true`.
|
4692 | 4696 |
|
4693 | 4697 | : <dfn attribute for=ImageDecoder>[[codec implementation]]</dfn>
|
4694 |
| -:: An underlying image decoder implementation provided by the User Agent. |
| 4698 | +:: An underlying image decoder implementation provided by the User Agent. See |
| 4699 | + [=[[codec implementation]]=]. |
4695 | 4700 |
|
4696 | 4701 | : <dfn attribute for=ImageDecoder>[[encoded data]]</dfn>
|
4697 | 4702 | :: A [=byte sequence=] containing the encoded image data to be decoded.
|
|
4712 | 4717 | {{ImageDecoder/[[ImageTrackList]]}}.
|
4713 | 4718 |
|
4714 | 4719 | : <dfn attribute for=ImageDecoder>\[[closed]]</dfn>
|
4715 |
| -:: A boolean indicating that the ImageDecoder is in a permanent closed state |
| 4720 | +:: A boolean indicating that the {{ImageDecoder}} is in a permanent closed state |
4716 | 4721 | and can no longer be used.
|
4717 | 4722 |
|
4718 | 4723 | : <dfn attribute for=ImageDecoder>[[progressive frame generations]]</dfn>
|
|
5604 | 5609 | realtime media or in contended main thread environments are encouraged to ensure their
|
5605 | 5610 | media pipelines operate in worker contexts entirely independent of the main
|
5606 | 5611 | thread where possible. For example, realtime media processing of {{VideoFrame}}s
|
5607 |
| - are generally be done in a worker context. |
| 5612 | + are generally to be done in a worker context. |
5608 | 5613 |
|
5609 | 5614 | The main thread has significant potential for high contention and jank that can
|
5610 | 5615 | go unnoticed in development, yet degrade inconsistently across devices and User
|
|
0 commit comments