VMWARE(4)          (xf86-video-vmware 13.3.0)           VMWARE(4)

     NAME
          vmware - VMware SVGA video driver

     SYNOPSIS
          Section 34Device34
            Identifier 34devname34
            Driver 34vmware34
            ...
          EndSection

     DESCRIPTION
          vmware is an Xorg driver for VMware virtual video cards.

     MODESETTING, XINERAMA AND RANDR12
          If the driver can connect to the 34vmwgfx34 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 34xrandr34 application
          can be used to determine whether RandR12 or Xinerama is
          actually used.

     3D ACCELERATION
          If the driver can connect to the 34vmwgfx34 kernel module on
          linux, and the Virtual Machine is set up to use 3D accelera-
          tion, 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.so34 and the accelerated
          OpenGL driver, 34vmwgfx_dri.so34 is provided by the mesa dis-
          tribution.

     CONFIGURATION DETAILS
          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 34HWCursor34 34boolean34
               Enable or disable the HW cursor.  Default: off.

          Option 34Xinerama34 34boolean34
               Disable or enable Xinerama support. Default: xinerama
               is enabled if the hardware supports it.

     Page 1                    X Version 11          (printed 5/24/22)

     VMWARE(4)          (xf86-video-vmware 13.3.0)           VMWARE(4)

          Option 34StaticXinerama34 34string34
               Provide a static xinerama geometry that will be active
               at server startup and will not be overridden at run-
               time.  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 34GuiLayout34.

          Option 34GuiLayout34 34string34
               A synonym to option 34StaticXinerama34, since the latter
               name is somewhat misleading when RandR12 is favoured
               before Xinerarma.

          Option 34AddDefaultMode34 34boolean34
               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 34RenderAccel34 34boolean34
               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 34DRI34 34boolean34
               Enable the Direct Rendering Infrastructure. Default: on
               if 3D acceleration is supported and 34RenderAccel34 is
               enabled. Otherwise off.

          Option 34DirectPresents34 34boolean34
               Speed up OpenGL swapbuffers by skipping a copy opera-
               tion. 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 34HwPresents34 34boolean34
               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 34RenderCheck34 34boolean34
               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

     Page 2                    X Version 11          (printed 5/24/22)

     VMWARE(4)          (xf86-video-vmware 13.3.0)           VMWARE(4)

               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.

     Page 3                    X Version 11          (printed 5/24/22)