Plugins/Async Drawing: Difference between revisions

← Older edit

Plugins/Async Drawing (view source)

Revision as of 23:43, 5 March 2020

1,682 bytes added , 5 March 2020

→‎Windows

Dparks

7

edits

@@ Line 7: / Line 7: @@
 = Current WMODE Handling =
-Flash wmode definitions for Windows and Linux:
+== Linux ==
 {| class="wikitable" style="width:300px"
@@ Line 24: / Line 24: @@
 |}
-On OSX, Flash always uses a hybrid windowless mode.
+== OSX ==
+Flash always uses a hybrid windowless mode.
-Post Adobe Flash version 24, Flash internally switches to wmode opaque for windowed mode Flash and uses a new [https://wiki.mozilla.org/NPAPI:AsyncDrawing async rendering API] developed by Mozilla and Adobe.
+== Windows ==
+Windows supports three modes, none of which involve window-backed surfaces:
+* '''direct''': Post Adobe Flash version 24, Flash offers a new [https://wiki.mozilla.org/NPAPI:AsyncDrawing async rendering API] developed by Mozilla and Adobe.  This mode handles that behavior.  If <code>dom.ipc.plugins.allow_dxgi_surface=true</code> (the default) and the DirectX device supports it then hardware accelerated surfaces are used.  Otherwise, this mode uses in-memory (unaccelerated) surfaces.
+* '''opaque''': This mode always uses unaccelerated surfaces.  It is intended for plugins that opaquely cover any HTML elements.
+* '''transparent''': This mode always uses unaccelerated surfaces.  It is intended to blend with HTML elements.  For that reason, this mode is slower than opaque mode.
+Some wmode values are rewritten by Firefox to promote certain modes to more performant and stable modes.
+When <code>dom.ipc.plugins.forcedirect.enabled=true</code> (the default) [1] and <code>dom.ipc.plugins.asyncdrawing.enabled=true</code> (also the default) we use:
+{| class="wikitable" style="width:75%"
+|-
+! Requested WMODE !! Resulting WMODE !! Rendering Mode (GPU supports acceleration) !! Rendering Mode (GPU does not support acceleration)
+|-
+| window || direct || async (GPU accelerated) || async (in-memory bitmap) [2]
+|-
+| gpu || direct || async (GPU accelerated) || async (in-memory bitmap) [3]
+|-
+| unspecified || direct || async (GPU accelerated) || async (in-memory bitmap) [2]
+|-
+| opaque || opaque || not async (in-memory bitmap) || not async (in-memory bitmap)
+|-
+| transparent || transparent || not async (in-memory bitmap) || not async (in-memory bitmap)
+|}
+When <code>dom.ipc.plugins.asyncdrawing.enabled=false</code> we use [4]:
 {| class="wikitable" style="width:50%"
 |-
-! WMODE !! Mode (Accelerated) !! Mode (Non-accelerated)
+! Requested WMODE !! Resulting WMODE !! Rendering Mode
 |-
-| unspecified || async (bitmap) || async (bitmap)
+| window || opaque || not async (in-memory bitmap)
 |-
-| window || async (bitmap) || async (bitmap)
+| gpu || opaque || not async (in-memory bitmap)
 |-
-| direct || async (accelerated) || window [1]
+| unspecified || opaque || not async (in-memory bitmap)
 |-
-| opaque || async (bitmap) || async (bitmap)
+| opaque || opaque || not async (in-memory bitmap)
 |-
-| transparent || windowless (bitmap) || windowless (bitmap)
+| transparent || transparent || not async (in-memory bitmap)
 |}
-In addition to these changes in Flash, some wmode values are rewritten by Firefox to redirect certain modes to more performant and stable modes. Specifically:
+[1] {{bug|1620461}}<br/>
+[2] {{bug|1340276}}, {{bug|1359450}}<br/>
+[3] {{bug|1565980}}<br/>
+[4] {{bug|1620466}}
+= Telemetry Links =
 {| class="wikitable" style="width:50%"
 |-
-! WMODE !! Mode (Accelerated) !! Mode (Non-accelerated)
+! Telemetry Value !! Platform !! Type
+|-
+| 0 || Windows, Linux || child window
+|-
+| 1 || OSX || NPDrawingModelQuickDraw
 |-
-| unspecified || direct || no change (opaque) [2]
+| 2 || OSX || NPDrawingModelCoreGraphics
 |-
-| window || direct || no change (opaque) [2]
+| 3 || OSX || NPDrawingModelOpenGL
+|-
+| 4 || OSX || NPDrawingModelCoreAnimation
+|-
+| 5 || OSX || NPDrawingModelInvalidatingCoreAnimation
+|-
+| 6 || Windows || NPDrawingModelSyncWin
+|-
+| 7 || Linux || NPDrawingModelSyncX
+|-
+| 8 || Windows || NPDrawingModelAsyncBitmapSurface
+|-
+| 9 || Windows || NPDrawingModelAsyncWindowsDXGISurface
 |}
-[1] To be deprecated<br/>
+[https://mzl.la/2px2SZ5 PLUGIN_DRAWING_MODEL Nightly Evolution]
-[2] {{bug|1340276}}, {{bug|1359450}}
 = Testing =
@@ Line 61: / Line 109: @@
 To enable:
-* set dom.ipc.plugins.asyncdrawing.enabled=true
+* dom.ipc.plugins.asyncdrawing.enabled=true
+* dom.ipc.plugins.forcedirect.enabled=true (see {{bug|1620461}})
 * make sure you are running Flash version >= 23
-* set your sandbox level to 2 or less (security.sandbox.content.level <= 2)
-Async drawing is current <strong>disabled</strong> via a pref in Beta and Release. Nightly and Aurora have the feature <strong>enabled by default</strong>.
 = Main Bug List =