OffscreenCanvas - Revision history

Annevk at 17:36, 24 January 2018

2018-01-24T17:36:27Z

← Older revision		Revision as of 17:36, 24 January 2018
Line 1:		Line 1:
	{{obsolete\|spec=[https://html.spec.whatwg.org/multipage/~~scripting~~.html#the-offscreencanvas-interface <code>OffscreenCanvas</code> in the HTML Standard]}}		{{obsolete\|spec=[https://html.spec.whatwg.org/multipage/canvas.html#the-offscreencanvas-interface <code>OffscreenCanvas</code> in the HTML Standard]}}

	:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''		:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''

Annevk at 17:35, 24 January 2018

2018-01-24T17:35:57Z

← Older revision		Revision as of 17:35, 24 January 2018
Line 1:		Line 1:
	~~'''This proposal is no longer active. OffscreenCanvas is now in the HTML specification~~ [https://html.spec.whatwg.org/multipage/scripting.html#the-offscreencanvas-interface ~~here~~]~~.'''~~		{{obsolete\|spec=[https://html.spec.whatwg.org/multipage/scripting.html#the-offscreencanvas-interface <code>OffscreenCanvas</code> in the HTML Standard]}}

	:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''		:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''

Junov at 18:14, 30 November 2016

2016-11-30T18:14:50Z

← Older revision		Revision as of 18:14, 30 November 2016
Line 1:		Line 1:
	'''~~The specification~~ is ~~currently under review~~ in ~~this~~ [https://~~github~~.~~com~~/~~whatwg~~/html~~/pull/1876 GitHub pull request~~].'''		'''This proposal is no longer active. OffscreenCanvas is now in the HTML specification [https://html.spec.whatwg.org/multipage/scripting.html#the-offscreencanvas-interface here].'''

	:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''		:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''

Junov: Added link to pull request

2016-10-14T15:12:54Z

Added link to pull request

← Older revision		Revision as of 15:12, 14 October 2016
Line 1:		Line 1:
			'''The specification is currently under review in this [https://github.com/whatwg/html/pull/1876 GitHub pull request].'''
	:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''		:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''

Junov: Removed definition of ImageBitmapSource because it already includes OffscreenCanvas via CanvasImageSource

2016-09-27T16:58:03Z

Removed definition of ImageBitmapSource because it already includes OffscreenCanvas via CanvasImageSource

← Older revision		Revision as of 16:58, 27 September 2016
Line 77:		Line 77:
	ImageBitmap or		ImageBitmap or
	OffscreenCanvas) CanvasImageSource;		OffscreenCanvas) CanvasImageSource;

	~~typedef (CanvasImageSource or~~
	~~Blob or~~
	~~ImageData or~~
	~~OffscreenCanvas) ImageBitmapSource;~~

	[Exposed=Window, Worker]		[Exposed=Window, Worker]

Xidachen: /* Web IDL */

2016-09-07T15:36:20Z

Web IDL

← Older revision		Revision as of 15:36, 7 September 2016
Line 86:		Line 86:
	interface OffscreenCanvasRenderingContext2D {		interface OffscreenCanvasRenderingContext2D {
	// commit() can only be used when HTMLCanvasElement has transferred Control		// commit() can only be used when HTMLCanvasElement has transferred Control
	// to OffscreenCanvas. Otherwise, ~~Exception~~ will be ~~raised~~.		// to OffscreenCanvas. Otherwise, an InvalidStateError will be thrown.
	// commit() can be invoked on main thread or worker thread. When it is invoked,		// commit() can be invoked on main thread or worker thread. When it is invoked,
	// it is expected to see the image drawn to OffscreenCanvasRenderingContext2D		// it is expected to see the image drawn to OffscreenCanvasRenderingContext2D
Line 130:		Line 130:
	// to that canvas element. This has the same effect as returning		// to that canvas element. This has the same effect as returning
	// control to the main loop in a single-threaded application. Otherwise,		// control to the main loop in a single-threaded application. Otherwise,
	// ~~this call has no effect~~.		// an InvalidStateError will be thrown.
	void commit();		void commit();
	};		};

Junov: Bikeshed: getAsBlob -> convertToBlob, which sounds more async

2016-08-25T15:44:19Z

Bikeshed: getAsBlob -> convertToBlob, which sounds more async

← Older revision		Revision as of 15:44, 25 August 2016
Line 58:		Line 58:
	// Throws a SecurityError if the OffscreenCanvas's origin-clean flag		// Throws a SecurityError if the OffscreenCanvas's origin-clean flag
	// is set to false.		// is set to false.
	Promise<Blob> ~~getAsBlob~~(optional ImageEncodeOptions options);		Promise<Blob> convertToBlob(optional ImageEncodeOptions options);
	};		};

Junov: /* Web IDL */

2016-08-25T15:38:51Z

Web IDL

← Older revision		Revision as of 15:38, 25 August 2016
Line 60:		Line 60:
	Promise<Blob> getAsBlob(optional ImageEncodeOptions options);		Promise<Blob> getAsBlob(optional ImageEncodeOptions options);
	};		};

	dictionary ImageEncodeOptions {		dictionary ImageEncodeOptions {
	DOMString type = "image/png";		DOMString type = "image/png";

Junov: renamed toBlob -> getAsBlob. Make it use a dictionary so we can easily add more options in the future, such as colorApace, bitDepth, alpha, ...

2016-08-25T15:38:16Z

renamed toBlob -> getAsBlob. Make it use a dictionary so we can easily add more options in the future, such as colorApace, bitDepth, alpha, ...

← Older revision		Revision as of 15:38, 25 August 2016
Line 58:		Line 58:
	// Throws a SecurityError if the OffscreenCanvas's origin-clean flag		// Throws a SecurityError if the OffscreenCanvas's origin-clean flag
	// is set to false.		// is set to false.
	Promise<Blob> ~~toBlob~~(optional DOMString type~~, any~~..~~. arguments);~~		Promise<Blob> getAsBlob(optional ImageEncodeOptions options);
			};

			dictionary ImageEncodeOptions {
			DOMString type = "image/png";
			unrestricted double quality = 1.0; // Defaults to 1.0 if value is outside 0:1 range
	};		};

Line 128:		Line 133:
	void commit();		void commit();
	};		};

	== Proposed Solutions ==		== Proposed Solutions ==

Junov: Cleaning-out parts of the proposal that have already been added to the spec.

2016-08-18T21:24:12Z

Cleaning-out parts of the proposal that have already been added to the spec.

@@ Line 1: / Line 1: @@
-:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal.''
+:''Provides more control over how canvases are rendered. This is a follow-on to the [[WorkerCanvas]] proposal and will be merged once agreement is reached.''
 == Use Case Description ==
@@ Line 62: / Line 62: @@
   OffscreenCanvas implements Transferable;
   partial interface HTMLCanvasElement {
     OffscreenCanvas transferControlToOffscreen();
   };
@@ Line 103: / Line 83: @@
     // to OffscreenCanvas. Otherwise, Exception will be raised.
     // commit() can be invoked on main thread or worker thread. When it is invoked,
-    // it is expected to see the image drawn in OffscreenCanvasRenderingContext2D
+    // it is expected to see the image drawn to OffscreenCanvasRenderingContext2D
-    // being displayed in the associated HTMLCanvasElement.
+    // be displayed in the associated HTMLCanvasElement.
     void commit();
     // back-reference to the canvas
@@ Line 115: / Line 95: @@
   OffscreenCanvasRenderingContext2D implements CanvasFillStrokeStyles;
   OffscreenCanvasRenderingContext2D implements CanvasShadowStyles;
   OffscreenCanvasRenderingContext2D implements CanvasFilters;
   OffscreenCanvasRenderingContext2D implements CanvasRect;
   OffscreenCanvasRenderingContext2D implements CanvasDrawPath;
   OffscreenCanvasRenderingContext2D implements CanvasText;
   OffscreenCanvasRenderingContext2D implements CanvasDrawImage;
@@ Line 146: / Line 129: @@
   };
 == Proposed Solutions ==