Skip to content

Commit 8f608a0

Browse files
authored
Sync changes from generated to dist (#194)
1 parent b3acacb commit 8f608a0

File tree

1 file changed

+23
-6
lines changed

1 file changed

+23
-6
lines changed

dist/index.d.ts

Lines changed: 23 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -756,7 +756,18 @@ interface GPUCanvasConfiguration {
756756
/**
757757
* The tone mapping determines how the content of textures returned by
758758
* {@link GPUCanvasContext#getCurrentTexture} are to be displayed.
759-
* Note: If an implementation doesn't support HDR WebGPU canvases, it should also not expose this member, to allow for feature detection. See {@link GPUCanvasContext#getConfiguration}.
759+
* <div class=note heading>
760+
* This is a required feature, but user agents might not yet implement it,
761+
* effectively supporting only the default {@link GPUCanvasToneMapping}.
762+
* In such implementations, this member **should not** exist in its implementation of
763+
* {@link GPUCanvasConfiguration}, to make feature detection possible using
764+
* {@link GPUCanvasContext#getConfiguration}.
765+
* This is especially important in implementations which otherwise have HDR capabilities
766+
* (where a <l>'@media/dynamic-range'</l> of <l>''@media/dynamic-range/high''</l> would be
767+
* exposed).
768+
* If an implementation exposes this member and a `high` dynamic range, it **should** render the
769+
* canvas as an HDR element, not clamp values to the SDR range of the HDR display.
770+
* </div>
760771
*/
761772
toneMapping?: GPUCanvasToneMapping;
762773
/**
@@ -855,7 +866,7 @@ interface GPUCopyExternalImageDestInfo
855866
* Otherwise, the results are clamped to the target texture format's range.
856867
* Note:
857868
* If {@link GPUCopyExternalImageDestInfo#colorSpace} matches the source image,
858-
* conversion may not be necessary. See {@link https://www.w3.org/TR/webgpu/#color-space-conversion-elision}.
869+
* conversion might not be necessary. See {@link https://www.w3.org/TR/webgpu/#color-space-conversion-elision}.
859870
*/
860871
colorSpace?: PredefinedColorSpace;
861872
/**
@@ -866,7 +877,7 @@ interface GPUCopyExternalImageDestInfo
866877
* corresponding alpha values.
867878
* Note:
868879
* If {@link GPUCopyExternalImageDestInfo#premultipliedAlpha} matches the source image,
869-
* conversion may not be necessary. See {@link https://www.w3.org/TR/webgpu/#color-space-conversion-elision}.
880+
* conversion might not be necessary. See {@link https://www.w3.org/TR/webgpu/#color-space-conversion-elision}.
870881
*/
871882
premultipliedAlpha?: boolean;
872883
}
@@ -2271,6 +2282,7 @@ interface GPUCanvasContext {
22712282
/**
22722283
* Configures the context for this canvas.
22732284
* This clears the drawing buffer to transparent black (in [$Replace the drawing buffer$]).
2285+
* See {@link GPUCanvasContext#getConfiguration} for information on feature detection.
22742286
* @param configuration - Desired configuration for the context.
22752287
*/
22762288
configure(
@@ -2281,7 +2293,11 @@ interface GPUCanvasContext {
22812293
*/
22822294
unconfigure(): undefined;
22832295
/**
2284-
* Returns the context configuration.
2296+
* Returns the context configuration, or `null` if the context is not configured.
2297+
* Note:
2298+
* This method exists primarily for feature detection of members (and sub-members) of
2299+
* {@link GPUCanvasConfiguration}; see those members for details.
2300+
* For supported members, it returns the originally-supplied values.
22852301
*/
22862302
getConfiguration(): GPUCanvasConfigurationOut | null;
22872303
/**
@@ -3110,8 +3126,8 @@ interface GPUShaderModule
31103126
readonly __brand: "GPUShaderModule";
31113127
/**
31123128
* Returns any messages generated during the {@link GPUShaderModule}'s compilation.
3113-
* The locations, order, and contents of messages are implementation-defined
3114-
* In particular, messages may not be ordered by {@link GPUCompilationMessage#lineNum}.
3129+
* The locations, order, and contents of messages are implementation-defined.
3130+
* In particular, messages aren't necessarily ordered by {@link GPUCompilationMessage#lineNum}.
31153131
*/
31163132
getCompilationInfo(): Promise<GPUCompilationInfo>;
31173133
}
@@ -3170,6 +3186,7 @@ interface GPUSupportedLimits {
31703186

31713187
declare var GPUSupportedLimits: {
31723188
prototype: GPUSupportedLimits;
3189+
new (): never;
31733190
};
31743191

31753192
interface GPUTexture

0 commit comments

Comments
 (0)