Changeset 34974 in vbox

Timestamp:

Dec 12, 2010 4:50:29 PM (14 years ago)

Author:

vboxsync

Message:

2D accel troubleshooting

File:

• trunk/doc/manual/en_US/user_Troubleshooting.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_Troubleshooting.xml

@@ -562 +562 @@
           a balance between performance and power consumption must always be 
           considered.
+      </para>
+
+    </sect2>
+
+    <sect2 id="gui2D_grayedout">
+      <title>GUI: 2D Video Acceleration option is grayed out</title>
+
+      <para>To use 2D Video Acceleration within VirtualBox, your host's video
+          card should support certain OpenGL extensions.
+          On startup, VirtualBox checks for those extensions, and, if the test
+          fails, this option is silently grayed out.
+      </para>
+        
+      <para>To find out why it has failed, you can manually execute the
+          following command:
+      </para>
+
+      <screen>VBoxTestOGL --log "log_file_name" --test 2D</screen>      
+
+      <para>It will list the required OpenGL extensions one by one and will
+          show you which one failed the test. This usually means that you 
+          are running an outdated or misconfigured OpenGL driver on your host.
+          It can also mean that your video chip is lacking require functionality.
       </para>