GLINT(7)

NAME
glint - GLINT/Permedia video driver

SYNOPSIS
Section "Device"
  Identifier "devname"
  Driver "glint"
  ...
EndSection

DESCRIPTION
glint is an XFree86 driver for 3Dlabs & Texas Instruments GLINT/Permedia based video cards. The driver is rather fully accelerated, and provides support for the following framebuffer depths: 8, 15 (may give bad results with FBDev support), 16, 24 (32 bpp recommended, 24 bpp has problems), 30, and an 8+24 overlay mode. Glint permedia 3 only support depth 8 (tested upto 1280x1024) and 15/16 (ok upto 1024x768, partial screen overlap on the right at 1280x1024) and acceleration is not yet fully supported.

SUPPORTED HARDWARE
The glint driver supports 3Dlabs (GLINT MX, GLINT 500TX, GLINT GAMMA, Permedia, Permedia 2, Permedia 2v, Permedia 3) and Texas Instruments (Permedia, Permedia 2) chips.

CONFIGURATION DETAILS
Please refer to XF86Config(4) for general configuration details. This section only covers configuration details specific to this driver.

The driver auto-detects the chipset type, but the following ChipSet names may optionally be specified in the config file "Device" section, and will override the auto-detection:

    "ti_pm2", "ti_pm", "pm3", "pm2v", "pm2", "pm", "500tx", "mx", "gamma".

The driver will try to auto-detect the amount of video memory present for all chips. If it's not detected correctly, the actual amount of video memory should be specified with a VideoRam entry in the config file "Device" section.

Additionally, you may need to specify the bus ID of your card with a BusID entry in the config file "Device" section, especially with FBDev support.

The following driver Options are supported:

Option "HWCursor" "boolean"
    Enable or disable the HW cursor. Default: on.

Option "SWCursor" "boolean"
    Enable or disable the SW cursor. Default: off. This option disables the HWCursor option and vice versa.

Option "NoAccel" "boolean"
    Disable or enable acceleration. Default: acceleration is enabled.

Option "Overlay"
    Enable 8+24 overlay mode. Only appropriate for depth 24, 32 bpp. (Note: This hasn't been tested with FBDev support and probably won't work.) Recognized values are: "8,24", "24,8". Default: off.

Option "PciRetry" "boolean"
    Enable or disable PCI retries. (Note: This doesn't work with Permedia2 based cards for Amigas.) Default: off.

Option "ShadowFB" "boolean"
    Enable or disable use of the shadow framebuffer layer. See shadowfb(7) for further information. (Note: This disables hardware acceleration.) Default: off.

Option "UseFBDev" "boolean"
    Enable or disable use of an OS-specific fb interface (which is not supported on all OSs). See fbdevhw(7) for further information. Default: off.

Option "BlockWrite" "boolean"
    Enable or disable block writes for the various Permedia 2 chips. This improves acceleration in general, but disables it for some special cases. Default: off.

Option "FireGL3000" "boolean"
    If you have a card of the same name, turn this on. Default: off.

Option "SetMClk" "freq"
    The driver will try to auto-detect the memory clock for all chips. If it's not detected correctly, the actual value (in MHz) should be specified with this option.

Known problems with the Glint Permedia 3 chip
The Glint Permedia 3 chip is newly supported since the 4.0.1 release but is still work in progress. The driver supports already unaccelerated modes at depth 8 (tested upto 1280x1024) and depth 15 and 16 (ok upto 1024x768) Depth 24 and Depth 15 and 16 with modes higher than 1024x768 are showing a partial overlap of the right part of the screen. Acceleration only support clipping pseudo acceleration. Dual head for the Appian J2000 board was working but got broken since 4.0b, since now the driver claims all chip of the board.

SEE ALSO
XFree86(1), XF86Config(4), xf86config(1), Xserver(1), X(5)

AUTHORS
Authors include: Alan Hourihane, Dirk Hohndel, Stefan Dirsch, Michel Dänzer