summaryrefslogtreecommitdiff
path: root/driver/xf86-video-trident/man/trident.man
blob: f461e103dfbc62d2f975fafc0611f6a3f02155df (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
.\" shorthand for double quote that works everywhere.
.ds q \N'34'
.TH TRIDENT __drivermansuffix__ __vendorversion__
.SH NAME
trident \- Trident video driver
.SH SYNOPSIS
.nf
.B "Section \*qDevice\*q"
.BI "  Identifier \*q"  devname \*q
.B  "  Driver \*qtrident\*q"
\ \ ...
.B EndSection
.fi
.SH DESCRIPTION
.B trident
is an __xservername__ driver for Trident video cards.  The driver is 
accelerated, and provides support for the following framebuffer depths:
1, 4, 8, 15, 16, and 24. Multi-head configurations are supported.
The XvImage extension is supported on TGUI96xx and greater cards.
.SH SUPPORTED HARDWARE
The
.B trident
driver supports PCI,AGP and ISA video cards based on the following 
Trident chips:
.TP 12
.B Blade
Blade3D, CyberBlade series i1, i7 (DSTN), i1, i1 (DSTN), Ai1, Ai1 (DSTN),
CyberBlade/e4, CyberBladeXP, CyberBladeAi1/XP, BladeXP
.TP 12
.B Image
3DImage975, 3DImage985, Cyber9520, Cyber9525, Cyber9397, Cyber9397DVD
.TP 12
.B ProVidia
9682, 9685, Cyber9382, Cyber9385, Cyber9388
.TP 12
.B TGUI
9440AGi, 9660, 9680
.TP 12
.B ISA/VLBus
8900C, 8900D, 9000, 9200CXr, Cyber9320, 9400CXi, 9440AGi
These cards have been ported but need further testing and may not work.
.SH CONFIGURATION DETAILS
Please refer to __xconfigfile__(__filemansuffix__) for general configuration
details.  This section only covers configuration details specific to this
driver.
.PP
The following driver
.B Options
are supported:
.TP
.BI "Option \*qSWCursor\*q \*q" boolean \*q
Enable or disable the SW cursor.  Default: off.
.TP
.BI "Option \*qNoAccel\*q \*q" boolean \*q
Disable or enable acceleration.  Default: acceleration is enabled.
.TP
.BI "Option \*qPciRetry\*q \*q" boolean \*q
Enable or disable PCI retries.  Default: off.
.TP
.BI "Option \*qCyberShadow\*q \*q" boolean \*q
For Cyber chipsets only, turn off shadow registers. If you only see
a partial display - this may be the option for you. Default: on.
.TP
.BI "Option \*qCyberStretch\*q \*q" boolean \*q
For Cyber chipsets only, turn on stretching. When the resolution is lower
than the LCD's screen, this option will stretch the graphics mode to
fill the entire LCD. Default: off.
.TP
.BI "Option \*qShadowFB\*q \*q" boolean \*q
Enable or disable use of the shadow framebuffer layer.  Default: off.
.TP
.BI "Option \*qVideoKey\*q \*q" integer \*q
This sets the default pixel value for the YUV video overlay key.
Default: undefined.
.TP
.BI "Option \*qTVChipset\*q \*q" string \*q
This sets the TV chipset. Options are CH7005 or VT1621.
Default: off.
.TP
.BI "Option \*qTVSignal\*q \*q" integer \*q
This sets the TV signalling. Options are 0 for NTSC or 1 for PAL.
Default: undefined.
.TP
.BI "Option \*qNoPciBurst\*q \*q" boolean \*q
Turn off PCI burst mode, PCI Bursting is on by default.
Default: off.
.TP
.BI "Option \*qXvHsync\*q \*q" integer \*q
Override the default Horizontal-sync value for the Xv extension.
This is used to center the Xv image on the screen.  By default the values
are assigned based on the video card.
Default: 0.
.TP
.BI "Option \*qXvVsync\*q \*q" integer \*q
Override the default Vertical-sync value for the Xv extension.
This is used to center the Xv image on the screen.  By default the values
are assigned based on the video card.
Default: 0.
.TP
.BI "Option \*qXvBskew\*q \*q" integer \*q
Override the default Bottom skew value for the Xv extension.
This is used to extend the Xv image on the screen at the bottom.  By 
default the values are assigned based on the video card.
Default: 0.
.TP
.BI "Option \*qXvRskew\*q \*q" integer \*q
Override the default Right skew value for the Xv extension.
This is used to extend the Xv image on the screen at the right.  By 
default the values are assigned based on the video card.
Default: 0.
.TP
.BI "Option \*qDisplay\*q \*q" string \*q
Override the display.
Possible values are \*qCRT\*q, \*qLCD\*q and \*qDual\*q.
Please note that this option is only experimentally.
Default: Use display active when X started.
.TP
.BI "Option \*qDisplay1400\*q \*q" boolean \*q
Inform driver to expect 1400x1050 display instead of a 1280x1024.
Default: off.
.TP
.BI "Option \*qGammaBrightness\*q \*q" string \*q
Set display gamma value and brightness. \*q\fIstring\fP\*q is 
\*q\fIgamma\fP, \fIbrightness\fP\*q, where \fIgamma\fP is a floating 
point value greater than 0 and less or equal to 10. \fIbrightness\fP is 
an integer value greater or equal to 0 and less than 128. 
Default: gamma and brightness control is turned off. 
Note: This is not supported on all chipsets.
.BI "Option \*qAccelMethod\*q \*q" string \*q
Choose acceleration architecture, either "XAA" or "EXA".  XAA is the old
(but stable) XFree86 based acceleration architecture.  EXA is a newer and
simpler acceleration architecture designed to better accelerate the X Render
extension.  Default: "XAA".
.SH "SEE ALSO"
__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)
.SH AUTHOR
Author: Alan Hourihane, EXA for Blade chips by Jesse Barnes