vmware - VMware SVGA video driver
Section "Device"
Identifier "devname"
Driver "vmware"
...
EndSection
vmware is an Xorg driver for VMware virtual video
cards.
If the driver can connect to the "vmwgfx" kernel module
on linux, it will attempt to use kernel modesetting and will then also use
RandR12 for multiple output operation instead of Xinerama. The X server log
or the "xrandr" application can be used to determine whether
RandR12 or Xinerama is actually used.
If the driver can connect to the "vmwgfx" kernel module
on linux, and the Virtual Machine is set up to use 3D acceleration, the
driver will try to use Gallium3D XA to accelerate 3D operations. It will
also by default enable DRI, the Direct Rendering Infrastructure, primarily
for accelerated OpenGL. If 3D acceleration is available, the driver will in
addition provide an additional XVideo adaptor for textured video. Gallium3D
XA,ibxatracker.so" and the accelerated OpenGL driver,
"vmwgfx_dri.so" is provided by the mesa distribution.
Please refer to xorg.conf(5) for general configuration details.
This section only covers configuration details specific to this driver.
The driver auto-detects the version of any virtual VMware SVGA
adapter.
The following driver Options are supported:
- Option
"HWCursor" "boolean"
- Enable or disable the HW cursor. Default: off.
- Option
"Xinerama" "boolean"
- Disable or enable Xinerama support. Default: xinerama is enabled if the
hardware supports it.
- Option
"StaticXinerama" "string"
- Provide a static xinerama geometry that will be active at server startup
and will not be overridden at runtime. The format is
"Width1xHeight1+Xoffset1+Yoffset1;Width2xHeight2+Xoffset2+Yoffset2"
and so on. Negative offsets are not supported. If the driver is using
RandR12, this option should be used to place and enable outputs at driver
startup time or else when VMware tools is not used for that purpose. Also
please see option "GuiLayout".
- Option
"GuiLayout" "string"
- A synonym to option "StaticXinerama", since the latter name is
somewhat misleading when RandR12 is favoured before Xinerarma.
- Option
"AddDefaultMode" "boolean"
- Provide a default mode with a resolution identical to the resolution of
the guest before the X server was started. The X server will thus try to
start without changing resolution. Default: on.
- Option
"RenderAccel" "boolean"
- Try to accelerate render operations if the operations are reading from
previously accelerated contents (3D or video). This option is needed for
3D support. Default: on if 3D acceleration is supported. Otherwise
off.
- Option
"DRI" "boolean"
- Enable the Direct Rendering Infrastructure. Default: on if 3D acceleration
is supported and "RenderAccel" is enabled. Otherwise off.
- Option
"DirectPresents" "boolean"
- Speed up OpenGL swapbuffers by skipping a copy operation. This provides
some OpenGL swapbuffer speedups, but may cause performance degradation and
rendering errors when 3D contents is read back for mixing with software
rendered contents. Default: off.
- Option
"HwPresents" "boolean"
- This is a developer convenience option and should not be used by distros
or normal users. When enabled, it copies software rendered contents to a
3D surface before presenting it, so that the visible screen is always
present on a 3D surface. Default: off.
- Option
"RenderCheck" "boolean"
- This is a developer convenience option and should not be used by distros
or normal users. When enabled, it tries to use 3D acceleration for all
XRender operations where 3D acceleration is supported, resulting in a
considerable slowdown due to the increased number of readbacks of
accelerated contents from host to guest. This option is used to verify
that the accelerated Xrender paths works correctly with the
"rendercheck" application. Default: off.
Copyright (c) 1999-2007 VMware, Inc.