Add a group policy for hardware acceleration.

components/policy/resources/policy_templates.json

 {
 # policy_templates.json - Metafile for policy templates
 #
 # The content of this file is evaluated as a Python expression.
 #
 # This file is used as input to generate the following policy templates:
 # ADM, ADMX+ADML, MCX/plist and html documentation.
 #
 # Policy templates are user interface definitions or documents about the
 # policies that can be used to configure Chrome. Each policy is a name-value
@@ skipping 105 matching lines @@
 #   templates and documentation. The policy definition list that Chrome sees
 #   will include policies marked with 'future'. If a WIP policy isn't meant to
 #   be seen by the policy providers either, the 'supported_on' key should be set
 #   to an empty list.
 #
 # IDs:
 #   Since a Protocol Buffer definition is generated from this file, unique and
 #   persistent IDs for all fields (but not for groups!) are needed. These are
 #   specified by the 'id' keys of each policy. NEVER CHANGE EXISTING IDs,
 #   because doing so would break the deployed wire format!
-#   For your editing convenience: highest ID currently used: 302
+#   For your editing convenience: highest ID currently used: 303
 #
 # Placeholders:
 #   The following placeholder strings are automatically substituted:
 #     $1 -> Google Chrome / Chromium
 #     $2 -> Google Chrome OS / Chromium OS
 #     $3 -> Google Chrome Frame / Chromium Frame
 #     $6 is reserved for doc_writer
 #
 # Device Policy:
 #   An additional flag device_only (optional, defaults to False) indicates
@@ skipping 7253 matching lines @@
       'desc': '''Grants access to corporate keys to extensions.
 
       Keys are designated for corporate usage if they're generated using the chrome.platformKeys API on a managed account. Keys imported or generated in another way are not designated for corporate usage.
 
       Access to keys designated for corporate usage is solely controlled by this policy. The user can neither grant nor withdraw access to corporate keys to or from extensions.
 
       By default an extension cannot use a key designated for corporate usage, which is equivalent to setting allowCorporateKeyUsage to false for that extension.
 
       Only if allowCorporateKeyUsage is set to true for an extension, it can use any platform key marked for corporate usage to sign arbitrary data. This permission should only be granted if the extension is trusted to secure access to the key against attackers.''',
     },
+    {
+      'name': 'HardwareAccelerationModeEnabled',

[bartfab (slow), 2015/07/01 09:16:54]

How does this policy interact with Disable3DAPIs?

[Zhenyao Mo, 2015/07/01 17:56:08]

Disable3DAPIs will be true if this is false. I add some text in Disable3DAPIs.

+      'type': 'main',
+      'schema': { 'type': 'boolean' },
+      'supported_on': ['chrome.*:45-', 'chrome_os:45-', 'android:45-'],
+      'features': {
+        'dynamic_refresh': False,

[bartfab (slow), 2015/07/01 09:16:54]

What happens if the policy value changes while Chrome is running? Will
content::GpuDataManager::GetInstance()->GpuAccessAllowed(NULL)'s return value
really not change?

[Zhenyao Mo, 2015/07/01 17:56:08]

This is only applied at browser startup time, so even if the value changes, it
is only effective on next browser start.

+        'per_profile': True,

[bartfab (slow), 2015/07/01 09:16:54]

Can this really be controlled on a per-profile basis? Based on the test, it
seems like it is a browser-global setting.

Also, if it is browser-global and needs to be set before the browser is created,
does the policy actually work on Chrome OS (which has no platform policy, but
cloud policy only).

[Zhenyao Mo, 2015/07/01 17:56:08]

Switched to global setting.  You are right, this should not be an option for
Chrome OS (they make sure hardware acceleration always works better than
software rendering).  I also exclude Android because I don't see a need there.
We can revisit if the needs ever arise.

+      },
+      'example_value': True,
+      'id': 303,
+      'caption': '''Use Hardware Acceleration When Available''',

[bartfab (slow), 2015/07/01 09:16:54]

Nit: Why is this in title case?

[Zhenyao Mo, 2015/07/01 17:56:08]

Switch to regular text mode.

FYI: I am simply following the example from the above Key Permissions.

[bartfab (slow), 2015/07/08 12:40:33]

I guess our template could do with a bit of clean-up :).

+      'desc': '''Use hardware acceleration when available.
+
+      If you enable this setting, hardware acceleration will be enabled unless a certain GPU feature is blacklisted.

[bartfab (slow), 2015/07/01 09:16:54]

What is that "certain GPU feature" which disables hardware acceleration? Or do
you mean that parts of the acceleration may be selectively disabled, depending
on your GPU's capabilities?

[Zhenyao Mo, 2015/07/01 17:56:07]

For example, accelerated canvas 2D, or accelerated rasterization, or accelerated
video decoding.  Each feature can be turned off independently through chrome's
software rendering list.

+
+      If you disable this setting, no hardware acceleration will be disabled.

[bartfab (slow), 2015/07/01 09:16:54]

This sentence is broken.

[Zhenyao Mo, 2015/07/01 17:56:08]

Done.

+
+      If this policy is left not set, it is equivalent to being enabled, see description above.''',

[bartfab (slow), 2015/07/01 09:16:54]

This is unnecessarily complex. How about:

If this policy is left not set, hardware acceleration will be enabled.

[Zhenyao Mo, 2015/07/01 17:56:08]

That doesn't cover the case of features being blacklisted. I think referring
back to the enabled case is easier (also the wording is copied from examples
above).

[bartfab (slow), 2015/07/08 12:40:33]

A common way to solve this is to change the first sentence to:

"If this policy is set to true or left unset, ..."

+    },
   ],
   'messages': {
     # Messages that are not associated to any policies.
     'win_supported_winxpsp2': {
       'desc': '''A label specifying the oldest possible compatible version of Windows. This text will appear right next to a label containing the text 'Supported on:'.''',
       'text': '''Microsoft Windows XP SP2 or later'''
     },
     'mac_chrome_preferences': {
       'desc': '''A text indicating in Mac OS X Workgroup Manager, that currently the preferences of Chromium are being edited''',
       'text': '''<ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> preferences'''
@@ skipping 105 matching lines @@
       'desc': '''Text appended in parentheses next to the policies top-level container to indicate that those policies are of the Recommended level''',
       'text': 'Default Settings (users can override)',
     },
     'doc_complex_policies_on_windows': {
       'desc': '''Text pointing the user to a help article for complex policies on Windows''',
       'text': '''encoded as a JSON string, for details see <ph name="COMPLEX_POLICIES_URL">http://www.chromium.org/administrators/complex-policies-on-windows<ex>http://www.chromium.org/administrators/complex-policies-on-windows</ex></ph>''',
     },
   },
   'placeholders': [],
 }