NAME
aticonfig - parse an existing X-Server configuration file and modify it to operate with ATI productsSYNOPSIS
aticonfig
[ OPTIONS...]
DESCRIPTION
aticonfig is a tool which should help you to create an (initial) X-server configuration file using the fglrx(4x) video driver. You can enable or disable special driver options.OPTIONS
aticonfig currently supports the following options:ATI Initial Configuration
--initial[=dual-head]If this option is given without any parameter,
a default ATI device section is generated in the configuration file which is
capable of loading the fglrx driver.
If this option is used with the dual-head parameter, it further generates
a dual head setup configuration. See fglrx(4x) for an explanation of a
dual head setup.
TV Options
--tvf string, --tv-format-type=stringChange the TV signal format. string can
be one of: NTSC-JPN, NTSC-M, NTSC-N, PAL-B,
PAL-COMB-N, PAL-D, PAL-G, PAL-H, PAL-I,
PAL-K, PAL-K1, PAL-L, PAL-M, PAL-N,
PAL-SECAM-D, PAL-SECAM-K, PAL-SECAM-K1,
PAL-SECAM-L. Using this option affects Option
"TVFormat" of fglrx(4x).
Note
Not all graphics cards support every mode. Regional settings are applicable.
--tvs string,
--tv-standard-type=string
Change the TV standard for TV output.
string can be one of: VIDEO, SCART, YUV. Using
this option affects Option "TVStandard" of
fglrx(4x).
--tv-overscan=boolean
Enable or disable overscan mode for TV-Out.
boolean can be one of: yes, no. Using this option affects
Option "TVOverscan" of fglrx(4x).
Note
Not all TV formats support overscan. Try to toggle overscan "
off" before changing the TV format if an error occurs.
--tv-info
Print out the current TV geometry, TV format
and if the TV is physically connected.
--tv-geometry=widthxheight{+|-}vertical_offset{+|-}horizontal_offset
Change the size and position of the TV-Out
display. The integer values for width and height are
given in percentage units. Please note that the valid range for these values
depends on the TV format, but as a rule of thumb they are valid in the range
of [1..100]. You can further specify the vertical_offset and
horizontal_offset values as offset from the center of the screen in
pixels. Their ranges depend on the ASIC and you should use
--tv-info to get valid ranges for these values. Using this option
affects Option "TVHSizeAdj", Option
"TVVSizeAdj" and - if given - Option
"TVHPosAdj" and Option "TVVPosAdj" of
fglrx(4x). If you invoke this option only with height and width, the
offset values are automatically set to " 0".
FireGL Workstation Board Features
--app string, --use-app-profile=stringChange the application profile for a FireGL
workstation board. string can be one of: default, maya,
softimage-xsi, softimage-3d, houdini4.0,
houdini5.0, houdini5.5. Using this option affects Option
"Capabilities" of fglrx(4x).
FSAA Options
--fsaa=booleanEnable or disable full scene anti-aliasing
(FSAA). Enable this option to enhance photo-realism in 3D rendering. Disable
it to get the most accurate 3D image. boolean can be one of: on,
off. Using this option affects Option "FSAAEnable" of
fglrx(4x).
--fs integer, --fsaa-samples=integer
Set the number of FSAA samples per pixel.
integer can be one of: 0, 2, 4, 6,
off. off is the same as 0. Using this option affects
Option "FSAAScale" of fglrx(4x).
--fsg boolean, --fsaa-gamma=boolean
Enable or disable FSAA gamma. boolean
can be one of: on, off. Using this option affects Option
"FSAADisableGamma" of fglrx(4x).
--fmsp real,real,...,real,
--fsaa-ms-positions= real,real,...,real
Change the FSAA Multi-Sample Positions for
x0,y0 to x5,y5. You must specify exactly 12 real number values separated by
commas. Using this option affects Option "FSAAMSPosX0..5",
Option "FSAAMSPosY0..5" and Option
"FSAACustomizeMSPos" of fglrx(4x).
Screen-Related Options
--ovt string, --overlay-type=stringChange the overlay for the X server.
string can be one of: opengl, Xv, disable.
--ovon boolean, --overlay-on=boolean
Choose which head the hardware overlay should
be visible on. The hardware overlay can be used for either OpenGL, video,
pseudo-color or stereo. boolean can be one of: 0,
1.
--lcd string, --lcd-mode=string
Change the LCD mode. string can be one
of: center, full.
--dtop string, --desktop-setup=string
Change the desktop setup for multiple display
adapters. string can be one of: single, clone,
mirror, horizontal, horizontal,reverse, vertical,
vertical,reverse.
--vs boolean, --sync-vsync=boolean
Enable or disable sync buffer swaps with
vsync. Enable this option to prevent tearing during 3D rendering.
boolean can be one of: on, off.
--psc boolean, --pseudo-color=boolean
Enable or disable pseudo-color visuals. Enable
this option to get 8-bit color support. boolean can be one of:
on, off.
--stereo=boolean
Enable or disable quad-buffer stereo support.
Enable this option only for using applications that support the use of
hardware 3D shutter glasses. boolean can be one of: on,
off.
--ss boolean, --stereo-sync=boolean
Enable or disable quad-buffer stereo sync.
Enable this option to get 3D glasses to synchronize with the infrared
transmitter. boolean can be one of: on, off.
--resolution=resolution1[,resolution2,...]
Set the modes for the first screen. You may
specify several resolutions separated by commas.
--hsync=frequency
Change the horizontal sync range of the first
monitor. Make sure you know the capabilities of your monitor before changing
this option. frequency should be understood as a range of frequencies.
--vrefresh=frequency
Change the vertical refresh range of the first
monitor. Make sure you know the capabilities of your monitor before changing
this option. frequency should be understood as a range of frequencies.
--resolution2=resolution1[,resolution2,...]
Set the modes for the second screen for dual
head. You may specify several resolutions separated by commas.
Note
The secondary screen must exist.
--hsync2=frequency
Change the horizontal sync range of the second
display. Make sure you know the capabilities of your monitor before changing
this option. frequency should be understood as a range of
frequencies.
--vrefresh2=frequency
Change the vertical refresh range of the
second display. Make sure you know the capabilities of your monitor before
changing this option. frequency should be understood as a range of
frequencies.
--mode2=mode1[,mode2,...]
Change the modes for the second display. You
may specify several resolutions separated by commas. This option is only valid
for clone and big desktop mode settings.
--screen-layout=string
Set the secondary screen position for dual
head. string can be one of: left, right, above,
below.
--screen-overlap=integer
Set the screen overlap region in big desktop
mode in pixels.
--force-monitor=string[,string,...]
Describe all displays that are to be enabled
and/or disabled regardless of their physical connection. string can be
one or more of the following set, separated by commas: crt1,
crt2, lvds, tv, tmds1, tmds2,
tmds2i, nocrt1, nocrt2, nolvds, notv,
notmds1, notmds2, notmds2i.
POWERplay Options
The following options will not change the configuration file and take affect immediately. Other options given on the (same) command line will be ignored. --lsp, --list-powerstatesPrint information about power states and
exit.
--set-powerstate=state
Set a power state listed by
--lsp.
Advanced Options
--tls=booleanEnable or disable fast thread local storage.
Disable this option when virtual machines or Wine(X) fail to work properly.
boolean can be one of: on, off. Using this option affects
Option "UseFastTLS" of fglrx(4x).
--sb boolean, --signal-block=boolean
Enable or disable signal blocking. Disable
this option when debugging a multi-threaded OpenGL application. boolean
can be one of: on, off. Using this option affects Option
"BlockSignalsOnLock" of fglrx(4x).
--locked-userpages=boolean
Enable or disable locked user pages. Disable
this option if the system hangs when running fgl_glxgears(1x).
boolean can be one of: on, off. Using this option affects
Option "KernelModuleParm" of fglrx(4x).
Important
As of version 8.28.8 of the ATI Linux Driver, user page lock is no longer
available on AGP systems.
--gcpu boolean, --generic-cpu=boolean
Enable or disable generic CPU. Use this option
if the CPU is being reported improperly. For example: If you have an AMDCPU
that is being reported as Intel. boolean can be one of: on,
off. Using this option affects Option
"ForceGenericCPU" of fglrx(4x).
--max-gart-size=integer
Set user-defined max GART size for
non-AGP systems. Possible integer values are [64..512]
MB. Using this option affects Option "MaxGARTSize" of
fglrx(4x).
Dynamic Display Management Options
The following options are used to query or set the driver, controller and adaptor information. Changes will take effect immediately. Other options given on the (same) command line will be ignored. --enable-monitor=string,stringSetting current monitor to be enabled. Only 2
displays can be enabled at the same time. Any displays that are not on the
list will be disabled. string can be one of: none, auto,
crt1, crt2, lvds, tmds1, tmds2, tv.
To use the default policy to enable the displays use auto. Using this
option affects Option "EnableMonitor" of
fglrx(4x).
--query-monitor
Return information about connected and enabled
monitors.
--swap-monitor
Swap the contents on the two monitors.
Pair Mode Options
The following options are used to query, add and/or remove pair modes. Changes will will take effect immediately. Other options given on the (same) command line will be ignored. --list-pairmodeList all current existing pair modes the
driver can use.
--add-pairmode=width0xheight0+width1xheight1
Add one pair mode to the list.
width0xheight0 specifies the size of primary and
width1xheight1 the size of the secondary display. Using this
option affects Option "PairModes" of fglrx(4x).
--remove-pairmode=index-number
Remove one pair mode from the list. The
index-number can be get from the --list-pairmode option.
External Events Daemon Options
The following options will not change the configuration file. Instead they are used to send commands to atieventsd(8), ATI's external events daemon. --set-policy=stringSets the event policy for the daemon.
string can be one of: handle_lid, ignore_lid. For more
information see atieventsd(8).
Miscellaneous Options
-v, --verboseShow what aticonfig is doing on a verbose
level.
-q, --quiet
Disable all information output except for
errors.
--effective=string
Choose when the requested changes should take
effect:
now
The default is now,startup, i.e., do both as applicable.
--nobackup
Changes take effect immediately. This change
will affect the running X session if applicable. Only --set-powerstate
and --ovon options are applicable for now.
startup
Changes take effect on future X server
startups. This change will modify the X server configuration file if
applicable.
Do not make an automatic backup of the
configuration file.
-i file, --input=file
Select a file to input as the
configuration file. Without this option, aticonfig will search /etc/X11
for the default configuration file.
-o file, --output=file
Select a file to output the new
configuration file to. Without this option, aticonfig will replace the
input file with the newly generated file.
Note
If the (given) file is already existing, it will be backuped as file.fglrx-
integer. To suppress this behavior, use the --nobackup option.
-h, --help
Display the help screen.
-f, --force
Force aticonfig to generate default
Monitor, Device and Screen sections even if the original configuration file
has invalid settings in these sections. Only valid with the --initial
option.
EXAMPLES
This paragraph should show you some examples, how you can use the aticonfig application.Initial single-head X
To set up a configuration for a single headed X server, you can use the following command. Note, that only giving an input file will overwrite this file. If you want to save your original file, you should also use the -f option.
aticonfig
--initial --input=/etc/X11/xorg.conf
Initial dual-head X
To set up a configuration for a dual-head X server, you can use the following command. The resulting dual-head will give you one monitor upon the other.
aticonfig
--initial=dual-head --screen-layout=above
--input=/etc/X11/xorg.conf
Desktop modes
The following command will set up the big desktop to horizontal and overlay on secondary display.
aticonfig
--dtop=horizontal --overlay-on=1
Primary display modes
To set up the modes for the primary display, use:
aticonfig
--resolution=1600x1200,1280x1024,1024x768
Monitor layout
Force CRT on primary display with TV-Out disabled.
aticonfig
--force-monitor=crt1,notv
TV Geometry
Change the TV geometry to 85% width (where 100% == overscan) and 90% height. Shift 10 pixels right and 10 pixels down from the center of the screen.
aticonfig
--tv-geometry=85x90+10-10
This command sets
BUGS
Report any issues with the aticonfig program to http://support.ati.com. We currently know these bugs:•Trying to use --tv-geometry
option only giving width and height results in a broken entry Option
"TVVSizeAdj" "
--tv-geometry=value" in . Also
the leading sign of the given pixels offsets from center are not preserved,
when creating the entries for Option "TVHPosAdj" and
TVVPosAdj.
Using this option may also output the following error: “failed to set tv
geometry. check help for possible causes.” But --help doesn't
tell anything useful here. Possible reasons for this issue are: needs to be
written - maybe TV needs to be connected?
•The options --dw and
--disable-workstation are still accepted, but it seems, they are
obsolete and they always result in a Option "Capabilities"
" 0x00000000" entry in fglrx(4x). So
just don't use it.
•Following the -h output,
aticonfig should support reading from stdin and writing to stdout when
using the --input or --output options. But it doesn't work as
expected and you will receive error messages or a file named -.
•Following the -h output, the
options described in the section called “Dynamic Display Management
Options” will not affect the config file. This is of course wrong. The
--enable-monitor=string,string has an affect to
xorg.conf(5x).
SEE ALSO
atieventsd(8), fglrx(4x), xorgconfig(1x), xorg.conf(5x)AUTHORS
Daniel Leidert <[email protected]>Author.
Flavio Stanchina <[email protected]>
Author and Debian package maintainer.
Matthijs Kooijman <[email protected]>
Debian Bug report #360822.
COPYRIGHT
Copyright © 2005-2007 Daniel Leidert| $Date: 2007-06-02 12:51:31 $ | ATI Linux driver 8.32.5 |