{{tag>matériel carte_graphique amd-ati catalyst}}
----

====== Aticonfig: les options pour bien configurer votre carte graphique AMD-ATI ======

**aticonfig** est la commande qui permet de paramétrer le pilote propriétaire de votre carte graphique [[:Amd-ati]].\\
Cette commande, associée à une ou plusieurs options permettra ainsi de configurer le fichier **/etc/X11/xorg.conf** et ainsi régler votre [[:xorg|serveur X]].

<note>Le pendant graphique de cette commande est accessible depuis le panneau de contrôle [[:Catalyst]].</note>

<note important>__**Avant**__ d'appliquer la moindre commande, faites une [[:tutoriel:comment_sauver_et_restaurer_un_fichier|sauvegarde]] dur fichier **/etc/X11/xorg.conf**</note>

===== Pré-requis =====
  * Disposer des [[:sudo|droits d'administration]]

===== Les options =====

Pour afficher la liste des options tapez dans un [[:terminal]] la [[:commande_shell|commande]] suivante :
<code>aticonfig</code>
qui devrait répondre
<code>
Usage: aticonfig [OPTION] ...
Parses an existing X-Server configuration file and modifies it to
operate with ATI products.
The following command-line options can be invoked as parameters: (...)</code>

==== Configuration initiale nécessaire et suffisante du pilote ATI ====

Les options :

<code>--initial
        Generate a default ATI device section in the configuration
        file which is capable of loading the fglrx driver.

--initial=dual-head
        Same as '--initial' but generate a basic dual head
        configuration file.</code>

Exemple la [[:commande_shell|commande]]
<code>sudo aticonfig --initial=dual-head</code> met en place une config Dual Screen. Voilà, vous avez compris. Même chose pour la suite.

Note : pour les adeptes du vrai Dual Screen FIXME **c'est à dire ?**, lancez plutôt :
<code>sudo aticonfig --dtop=horizontal --overlay-on=1</code>
Cette commande est spécifiée par Ati en guise d'exemple en bas de page (Big Desktop FIXME ?)\\
Pour que vous puissiez voir les effets, il vous faut [[:tutoriel:comment_redemarrer_le_serveur_graphique|redémarrer le serveur X]] ou redémarrer votre ordinateur.

==== TV Options  ====
<code>--tvf, --tv-format-type=STRING
        Change the TV signal format. STRING can be one of:
        NTSC-M
        NTSC-JPN
        PAL-B
        PAL-D
        PAL-G
        PAL-H
        PAL-I
        PAL-K
        PAL-K1
        PAL-L
        PAL-M
        PAL-N
        PAL-CN
        PAL-SCART</code>
Permet de choisir le standard télé en fonction du pays.

<code>
        PAL-B : 	en Belgique, Danmark, Finland, Allemagne,
                        Guinée, Hong Kong, Inde, Indonesie,
                        Italie, Malaysie, Les Pays Bas, Norvège,
                        Portugal, Singapoure, Espagne, Suède,
                        et Suisse
        PAL-D : 	en Chine and Corée du Nord
        PAL-G : 	au Danmark, Finland, Allemagne, Italie,
                        Malaysie, Les Pays Bas, Norvège, Portugal,
                        Espagne, Suède, et Suisse
        PAL-H : 	en Belgique
        PAL-I : 	à Hong Kong et au Royaume Uni
        PAL-K1 : 	en Guinée
        PAL-M : 	au Brézil
        PAL-N : 	en France, Paraguay, et Uruguay
        PAL-NC : 	en Argentine
        NTSC-J : 	au Japan
        NTSC-M : 	au Canada, Chili, Colombie, Costa Rica,
                        Ecuador, Haiti, Honduras, Mexique, Panama,
                        Porto Rico, Corée du Sud, Taiwan, USA,
                        et Venezuela</code>

<code>--tvs, --tv-standard-type=STRING
        Change the TV standard for TV output. STRING can be one of:
        VIDEO
        SCART
        YUV
</code>

La fonction overscan qui permet un plein écran ou surbalayage de l'écran pour ôter les bandes noires sur votre tv:
<code>
 --tv-overscan={on|off}
       Enable or disable overscan mode for TVout
       Note, not all tv-formats support overscan. Try to
       toggle overscan off before changing tv-format if
       and error occurs.
</code>

Donne des infos sur votre tv.
<code>
 --tv-info
         Print out the current tv geometry, tv format, and if the
         tv is physically connected.
</code>

Options pour les cartes FireGL Workstation :
<code>
--app, --use-app-profile=STRING
        Change 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</code>

Cette commande permet d'optimiser les paramètres de votre machine pour des applications 3d spécifiques. Tous les logiciels qui suivent sont des logiciels de 3d. Maya par exemple à servi pour l'épisode 3 de Star Wars\\
Exemple :
<code>sudo aticonfig --use-app-profile=maya</code>

<code>
--dw, --disable-workstation=STRING
        Disable a FireGL workstation board feature. STRING can be one of:
        all
        timmo
        timmo-extreme</code>


==== FSAA Options ====
<code>
--fsaa={on|off}
        Enable/disable full scene anti-aliasing. Enable this option
        to enhance photo-realism in 3D rendering. Disable it to get
        the most accurate 3D image.
</code>

Cette option permet d'activer l'[[:catalyst#anticrenelage_ou_antialiasing|anti-aliasing]] des cartes 3d.\\
Dans les faits, la carte graphique lisse les contours des objets 3d pour permettre de diminuer l'effet de crénelage

<code>--fs, --fsaa-samples={off,0,2,4,6}
        Set the number of FSAA samples per pixel or 2, 4, 6. off is
        the same as setting 0 samples.
</code>

Cette option détermine le taux de lissage que vous voulez appliquer à votre objets 3d: plus le chiffre est grand, plus l'image sera douce, mais plus les ressources demandées à la carte graphique augmentent.\\
**Petites cartes s'abstenir...**

<code>
--fsg, --fsaa-gamma={on|off}
        Enable/disable FSAA gamma.
</code>

Activer le gamma permet de corriger un défaut de beaucoup de moniteurs.\\
Il est conseillé de l'activer, ou tout au moins de le tester, surtout si vous êtes équipé d'un écran [[wpfr>Tube_cathodique|CRT]].\\
Si vous êtes infographiste, ou comptez le devenir, il est important de connaître, ce qu'est [[http://www.profil-couleur.com/pp/204-gamma-ecran.php|une courbe de gamma]].

<code>
--fmsp, --fsaa-ms-positions=x0,y0,x1,y1,x2,y2,x3,y3,x4,y4,x5,y5
        Change the FSAA Multi-Sample Positions for x0,y0 to x5,y5. You must
        specify exactly 12 real number values separated by commas.
</code>



==== Options relatives aux écrans ====

<code>
--ovt, --overlay-type=STRING
        Change the overlay for the X server. STRING can be one of:
        opengl
        Xv
        disable

--ovon, --overlay-on={0|1}
        Choose which head the hardware overlay should be visible on. The hardware overlay can be used for either OpenGL, video, pseudo-color or stereo.

--lcd, --lcd-mode=STRING

        Change the LCD mode. STRING can be one of:
        center
        full
</code>

<code>
aticonfig --desktop-setup= horizontal
    --dtop, --desktop-setup=STRING

        Change the desktop setup for multiple display adapters.
        STRING can be one of:

            single 	          1 screen, second dark
            mirror                2 screens - same content, identical refresh rate/resolution
            clone 	          2 screens - same content, allows for different refresh rates/resolutions
            horizontal            2 screens - one framebuffer, screen 1 right of screen 0 
            horizontal,reverse 	  2 screens - one framebuffer, screen 1 left of screen 0
            vertical 	          2 screens - one framebuffer, screen 1 above of screen 0
            vertical,reverse 	  2 screens - one framebuffer, screen 1 below of screen 0

            Note: This option is not valid if '--initial=dual-head' is specified.</code>

Permet de gérer l'organisation des écrans les uns par rapport aux autres.

<code>
--vs, --sync-vsync={on|off}
            Enable/disable sync buffer swaps with vsync.
            Enable this option to prevent tearing during 3D rendering.
</code>

Si vous possédez un écran LCD, évite l'effet d'escalier dans les jeux de type FPS.

<code>
--psc, --pseudo-color={on|off}
            Enable/disable pseudo-color visuals. Enable this option
            to get 16-bit color support.

--stereo={on|off}
            Enable/disable quad-buffer stereo support.
            Enable this option only for using applications that support the use of hardware 3D shutter glasses.

--ss, --stereo-sync={on|off}
            Enable/disable quad-buffer stereo sync. Enable this option to get 3D glasses to synchronize with the infrared transmitter.

--resolution=W1xH1,W2xH2,W3xH3,...
            Set the modes for the first screen. You may specify several resolutions separated by commas.

--hsync=LOW-HIGH
            Change the horizontal sync range of the first monitor.
            Make sure you know the capabilities of your monitor before changing this option.

--vrefresh=LOW-HIGH
            Change the vertical refresh range of the first monitor.
            Make sure you know the capabilities of your monitor before changing this option.

--resolution2=W1xH1,W2xH2,W3xH3,...
            Change the modes for the second screen for dual head.
            You may specify several resolutions separated by commas.
            Note: The secondary screen must exist.

--hsync2=LOW-HIGH
            Change the horizontal sync range of the second display.
            Make sure you know the capabilities of your monitor before changing this option.

--vrefresh2=LOW-HIGH
            Change the vertical refresh range of the second display.
            Make sure you know the capabilities of your monitor before changing this option.

--mode2=W1xH1,W2XH2,W3xH3,...
            Change the modes for the second display.
            You may specify several resolutions separated by commas.
            Only valid for clone and big desktop settings.
</code>
<code>
--screen-layout={left|right|above|below}
            Set the secondary screen position for dual head.

</code>

Change l'ordre de disposition des écrans

<code>
--screen-overlap=NUM
             Set the screen overlap region in big desktop mode to be NUM pixels.
</code>
L'oververlapping permet, quand on veut maximiser un fenêtre de la répartir sur les deux écrans. Il est déconseillé de l'activer car cela pose des problèmes pour l'affichage des vidéos plein écran.

<code>--force-monitor=STRING[,STRING...]

              Describe all displays that are to be enabled and/or disabled regardless of 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
</code>
Permet d'activer ou désactiver les différentes connexions physiques, crt1 et crt2 pour activer les sorties écrans 1 et 2, nocrt1 et nocrt2 pour désactiver les sorties écrans 1 et 2, tv pour la sortie tv, etc.


==== Powerplay Options ====

Option disponible uniquement sur les modèles //mobility//. Elle permet de régler les différents modes de la carte afin de baisser ou d'augmenter sa fréquence.\\
Exemple, sur //mobility x1800//  il existe trois modes : //eco, defaut// et //perf//  qui font respectivement comme résultat avec [[:catalyst#glxgears|glxgears]]  : 3000 / 5500 / 8500.

<code>
--lsp, --list-powerstates
              Print information about power states and exit.

--set-powerstate=NUMBER
              Set a power state listed by --list-powerstates.
</code>

==== Advanced Options ====

<code>
--tls={on|off}
              Enable/disable fast thread local storage.
              Disable this option when virtual machines or
              WineX fail to work properly.

--sb, --signal-block={on|off}

              Enable/disable signal blocking. Disable this option when debugging a
              multi-threaded OpenGL application.

--iagp, --internal-agp={on|off}

               Enable/disable internal AGP gart. Enable this option to use the ATI
               AGP GART module. Disable it to use the module included with the Linux
               kernel. Changing this option may help resolve display-related issues.

--agpl, --agp-locked-userpages={on|off}

               Enable/disable AGP locked user pages. Disable this option if the system
               hangs when running fgl_glxgears.

--gcpu, --generic-cpu={on|off}

               Enable/disable generic CPU. Use this option if the CPU is being
               reported improperly. For example: If you have an AMD cpu that is
               being reported as Intel.
</code>

==== Miscellaneous Options ====

<code>
-v, --verbose
              Show what aticonfig is doing.

-q, --quiet
              Disable all information output except for errors.

--effective={now,startup}
              Choose when the requested changes should take effect.

              now: Immediately. This change will affect the running X
              session if applicable. Only 'set-powerstate' and
              'overlay-on' are applicable for now.
              startup: On future X server startups. This change will modify the
              X server configuration file if applicable.
              The default is 'now,startup', i.e., do both as applicable.

-i, --input=FILE
               Select a FILE to input as the configuration file. Set FILE to '-' to
               pipe from standard input. Without this option, aticonfig will search
               /etc/X11 for the default configuration file.

-o, --output=FILE
                Select a FILE to output the new configuration file to. Set FILE to '-'
                to print to standard output. Without this option, aticonfig will
                replace the input file with the newly generated file.

-h, --help
                Display this help screen.

-f, --force
                Only valid with 'initial' option. Force aticonfig to generate default
                Monitor, Device, and Screen sections even if the original configuration
                file has invalid settings in these sections.

</code>


===== Les exemples =====

<code>
1. Setting up fglrx for the first time.

Single head :	aticonfig --initial
                --input=/etc/X11/xorg.conf
----
Dual head :	aticonfig --initial=dual-head --screen-layout=above
            	This command will generate a dual head configuration
                file with the second screen located above the first
                screen.
2. Setting up big desktop to horizontal and set overlay on secondary display.
                aticonfig --dtop=horizontal --overlay-on=1

3. Setting up modes for primary display.
                aticonfig --resolution=1600x1200,1280x1024,1024x768

4. Force primary CRT on and TV-out off.
                aticonfig --force-monitor=crt1,notv
</code>

===== Liens =====
  * Source de cette page: l'aide d' ''aticonfig''
  * [[http://support.ati.com|Contacter Ati]] pour rapporter d'éventuels bugs
  * [[:amd-ati]]

----
//Contributeurs : [[:utilisateurs:kao_chen]], [[:utilisateurs:urss]]//