@@ -74,7 +74,7 @@ box based on that box's size (as generated by the layout stage) and computed sty
7474This specification describes an API which allows developers to paint a part of a box in
7575response to size / computed style changes with an additional <<image>> function.
7676
77- Note: In a future version of the spec, support may be added for defining the clip, global alpha,
77+ Note: In a future version of the spec, support could be added for defining the clip, global alpha,
7878 filter on a portion of a box (for example on the background layers).
7979
8080Paint Invalidation {#paint-invalidation}
@@ -107,9 +107,9 @@ When the computed style for a |box| changes, the user agent <em>must</em> run th
107107Performing <a>draw a paint image</a> results in the <a>paint valid flag</a> for a <<paint()>>
108108function on a box to be set to <a>paint-valid</a> .
109109
110- Note: In a future version of the spec, support may be added for partial invalidation. The user agent
111- will be able to specify a region of the rendering context which needs to be re-painted by the
112- paint class.
110+ Note: In a future version of the spec, support could be added for partial invalidation. The user
111+ agent will be able to specify a region of the rendering context which needs to be re-painted by
112+ the paint class.
113113
114114Paint Worklet {#paint-worklet}
115115==============================
@@ -315,9 +315,9 @@ called, the user agent <em>must</em> run the following steps:
315315Note: The list of input properties should only be looked up once, the class doesn't have the
316316 opportunity to dynamically change its input properties.
317317
318- Note: In a future version of the spec, the author may be able to set an option to receive a
319- different type of RenderingContext. In particular the author may want a WebGL rendering context
320- to render 3D effects. There are complexities in setting up a WebGL rendering context to take the
318+ Note: In a future version of the spec, the author could have the ability to receive a different type
319+ of RenderingContext. In particular the author may want a WebGL rendering context to render 3D
320+ effects. There are complexities in setting up a WebGL rendering context to take the
321321 {{PaintSize}} and {{StylePropertyMap}} as inputs.
322322</div>
323323
@@ -438,7 +438,7 @@ negotiation</a> algorithm which is responsible for rendering an <<image>>.
438438For the purposes of the <a>object size negotiation</a> algorithm, the paint image has no
439439<a>intrinsic dimensions</a> .
440440
441- Note: In a future version of the spec, the author may be able to specify the <a>intrinsic
441+ Note: In a future version of the spec, the author could have the ability to specify the <a>intrinsic
442442 dimensions</a> of the paint image. This will probably be exposed as a callback allowing the
443443 author to define static <a>intrinsic dimensions</a> or dynamically updating the <a>intrinsic
444444 dimensions</a> based on computed style and size changes.
@@ -534,8 +534,8 @@ following steps:
534534 The user agent <em> may</em> also <a>create a WorkletGlobalScope</a> given the paint
535535 {{Worklet}} and use that.
536536
537- Note: The user agent <em> may </em> use any policy for which {{PaintWorkletGlobalScope}} to
538- select or create. It may use a single {{PaintWorkletGlobalScope}} or multiple and
537+ Note: The user agent can use any policy for which {{PaintWorkletGlobalScope}} to select or
538+ create. For example it could use a single {{PaintWorkletGlobalScope}} or multiple and
539539 randomly assign between them.
540540
541541 13. Run <a>invoke a paint callback</a> given |name|, |inputArguments|, |concreteObjectSize|,
@@ -565,10 +565,10 @@ When the user agent wants to <dfn>invoke a paint callback</dfn> given |name|, |i
565565
566566 2. Let the image output be an <a>invalid image</a> and abort all these steps.
567567
568- Note: This handles the case where there may be a paint worklet global scope which didn't
568+ Note: This handles the case where there could be a paint worklet global scope which didn't
569569 receive the {{registerPaint(name, paintCtor)}} for |name| (however another global scope
570- did). A paint callback which is invoked on the other global scope may succeed, but wont
571- succeed on a subsequent frame when <a>draw a paint image</a> is called.
570+ did). A paint callback which is invoked on the other global scope could succeed, but
571+ wont succeed on a subsequent frame when <a>draw a paint image</a> is called.
572572
573573 3. Let |definition| be the result of <a>get</a> |paintDefinitionMap|[|name|] .
574574
@@ -600,8 +600,8 @@ When the user agent wants to <dfn>invoke a paint callback</dfn> given |name|, |i
600600 - "height" - The height given by |concreteObjectSize|.
601601 - "alpha" - The <a for="paint definition">context alpha flag</a> given by |definition|.
602602
603- Note: The |renderingContext| must not be re-used between invocations of paint. Implicitly
604- this means that there is no stored data, or state on the |renderingContext| between
603+ Note: The |renderingContext| is not be re-used between invocations of paint. Implicitly this
604+ means that there is no stored data, or state on the |renderingContext| between
605605 invocations. For example you can't setup a clip on the context, and expect the same clip
606606 to be applied next time the paint method is called.
607607
@@ -622,13 +622,13 @@ When the user agent wants to <dfn>invoke a paint callback</dfn> given |name|, |i
622622
623623 If an exception is <a>thrown</a> the let the image output be an <a>invalid image</a> .
624624
625- Note: The user agent <em> should </em> consider long running paint functions similar to long running
626- script in the main execution context. For example, they <em> should </em> show a "unresponsive
627- script" dialog or similar. In addition user agents <em> should </em> provide tooling within their
628- debugging tools to show authors how expensive their paint classes are.
625+ Note: The user agent can consider long running paint functions similar to long running script in the
626+ main execution context. For example, they could show a "unresponsive script" dialog or similar.
627+ In addition user agents could provide tooling within their debugging tools to show authors how
628+ expensive their paint classes are.
629629
630- Note: The contents of the resulting image are not designed to be accessible. Authors <em> should </em>
631- communicate any useful information through the standard accessibility APIs.
630+ Note: The contents of the resulting image are not designed to be accessible. Authors can communicate
631+ any useful information through the standard accessibility APIs.
632632</div>
633633
634634Examples {#examples}
0 commit comments