This file is indexed.

/usr/share/doc/HOWTO/fr-html/XFree86-XInside.html is in doc-linux-fr-html 2013.01-3ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for HTML5 for Linux version 5.2.0">
<meta name="GENERATOR" content="LinuxDoc-Tools 0.9.72">
<title>Mini-HOWTO Linux de XFree vers XInside</title>
</head>
<body>
<h1>Mini-HOWTO Linux de XFree vers XInside</h1>
<h2>par Marco Melgazzi, <code>marco@techie.com</code><br>
Traducteur: <a href="http://www.lifl.fr/~blondeel">Sébastien
Blondeel</a> ( <a href=
"mailto:sebastien.blondeel@lifl.fr">sebastien.blondeel@lifl.fr</a>)<br>
</h2>
version 1.3 / septembre 1997
<hr>
<em>Comment convertir une ligne de mode vidéo XFree86 en ligne de
mode vidéo XInside/XiGraphics</em>
<hr>
<h2><a name="s1">1. Introduction</a></h2>
<p>Au printemps 1996, j'ai lu dans comp.os.linux.x (groupe de
discussion consacré à la partie graphique du système d'exploitation
Linux) beaucoup d'articles demandant comment convertir les modes
vidéo entre XFree86 et une de ses alternatives commerciales:
XInside (désormais appelé XiGraphics, mais vous remarquerez que
dans ce document j'utiliserai l'ancien nom de produit, puisque je
me réfère principalement à cette version-là).</p>
<p>J'avais déjà évalué le produit auparavant et j'avais encore sur
mon disque dur cette version d'évaluation: comme j'aime résoudre
des problèmes, j'ai décidé de m'y mettre et, après quelques heures
de tâtonnements et de calculs, j'ai rédigé un article censé être
intéressant, qui fut rapidement posté.</p>
<p>Les discussions parlant de la conversion prirent subitement fin
et j'ai reçu 1 (un) courrier électronique me remerciant pour
l'article de telle sorte que, puisque quelqu'un d'autre risque de
se poser ces questions à l'avenir, j'ai décidé de transformer cet
article en ce mini HOWTO.</p>
<p>Mettons tout de suite les choses au clair: je ne travaille PAS
pour XInside et je n'ai eu accès qu'à leur version d'évaluation 1.2
pour Linux. Je sais que maintenant (en mai 1997) AccelX a atteint
le numéro de version 3.1, mais je pense que l'information contenue
dans ce document est toujours utilisable, au prix peut-être de
quelques modifications mineures.</p>
<p>Puisque ce HOWTO a été mis au point à l'aide d'une version de
XInside assez vieille, il se peut que certaines données présentées
ici ne soient pas tout à fait exactes. Comme vous le lirez plus
loin, grâce à l'avènement de XFree 3.2, je n'ai pas acheté ce
serveur commercial. Aussi, si vous l'avez acheté, et que vous
remarquez des erreurs, veuillez prendre le temps de me les
communiquer par courrier électronique.</p>
<p>Attention, bidouiller les réglages d'un moniteur est assez
dangereux et, pour cette raison, je ne garantis rien du tout. Si
cela fonctionne pour votre ordinateur, tant mieux. Si vous le
faites exploser, ne m'en tenez pas pour responsable.</p>
<h2><a name="s2">2. En ai-je vraiment besoin?</a></h2>
<p>Je ne comprends absolument pas le choix de XInside de ne pas
proposer d'utilitaire pour régler vos modes vidéo (comme xvidtune)
et/ou pour importer vos modes vidéo de XFree dans la version
d'évaluation (qui est, pour autant que je sache, commerciale). J'ai
passé environ trois heures à mettre tout ceci au point (indice:
j'ai comparé l'entrée concernant le VESA 1024x768 à 70Hz dans les
deux formats (et je suis presque ingénieur en électronique ;-))
alors qu'un programmeur de chez XInside aurait pu écrire un article
comparatif en bien moins de temps...</p>
<p>Je n'ai pas téléchargé les versions d'évaluation à partir de la
1.3 et j'espère vraiment qu'ils ont réglé cela. Et si c'est le cas,
on peut penser que ce mini HOWTO est devenu inutile mais puisque
vous le lisez, espérons qu'il vous aidera à mieux comprendre
comment tout cela fonctionne...</p>
<h2><a name="s3">3. Allons-y</a></h2>
<p>Supposons que vous ayez votre mode XFree86 bien aimé et que vous
vouliez évaluer XInside dans les mêmes conditions: suivez les
étapes présentées ci-dessous et vous devriez pouvoir le faire; nous
allons utiliser à titre d'exemple vécu mon mode vidéo par défaut et
je vais vous expliquer ce que vous devrez faire pour le
convertir.</p>
<p>Une entrée de XFree86 ressemble à ceci:</p>
<blockquote>
<pre><code>
Modeline "blabla" DOTCLK  A B C D  a b c d
</code></pre></blockquote>
<p>Chacun des nombres de A à D et de a à d a une signification
précise: si vous le voulez, vous pouvez faire des recherches dans
le "Guide du Rootard pour les modes vidéo sous X386/XFree86"
(/usr/lib/X11/doc/VideoModes.doc) mais vous n'avez pas besoin de
connaître toute la théorie sous-jacente pour réaliser une
conversion couronnée de succès...</p>
<p>Mon entrée dans /usr/lib/X11/XF86Config est:</p>
<blockquote>
<pre><code>
Modeline "1168x876" 105  1168 1256 1544 1640  876 877 891 900
                     |     |    |    |    |    |   |   |   |
                  DOT_CLK  A    B    C    D    a   b   c   d
</code></pre></blockquote>
<p>Sous XInside, il vous faut ajouter une entrée dans le fichier
Xtimings, qui devrait se trouver dans etc/ (à partir de maintenant,
nous supposerons que vous vous trouvez dans le répertoire racine de
Xaccel, qui devrait être quelque chose comme
/usr/X11/lib/X11/AcceleratedX).</p>
<blockquote>
<pre><code>
!    Quelque part dans le fichier, mettez ici le nom désiré

[MODE_PRÉAJUSTÉ]
    NomDuModePréajusté = "1168x876 @ 72Hz";

!
!    Les quatre lignes suivantes sont évidentes... pour qui parle anglais
!
    HorPixel          = 1168;         // pixels
    VerPixel          = 876;          // lignes
    PixelWidthRatio   = 4;            // taux de largeur des pixels
    PixelHeightRatio  = 3;            // taux de hauteur des pixels

!
!   hsync: DOT_CLK / D * 1000 [KHz]
!
!   hsync = 105 / 1640 * 1000 = 64.024 KHz
!
!   vsync: ( 1 / (( D / DOT_CLK ) * d) ) * 1,000,000 [Hz]
!
!   vsync: ( 1 / (( 1640 / 105 ) * 900) ) * 1,000,000
!           ( 1 / 14057.1428571 ) * 1,000,000 = 71.138 Hz
!

    HorFrequency      = 64.180;        // kHz
    VerFrequency      = 71.138;        // Hz

!   Type de balayage

    ScanType          = NONINTERLACED;

!
!   Mettez ici les options de XFree86 +/-hsync et +/-vsync
!
    HorSyncPolarity   = POSITIVE;
    VerSyncPolarity   = POSITIVE;

!   Cela ne devrait pas changer

    CharacterWidth    = 8;             // largeur des caractères, en pixels

!   ici, c'est DOT_CLK

    PixelClock        = 105.000;       // MHz
!
!
!   section des réglages horizontaux: [usec, ou microsecondes]
!
    HorTotalTime  = D / DOT_CLK                  = 15.619;
    HorAddrTime   = A / DOT_CLK                  = 11.124;
    HorBlankStart = A / DOT_CLK                  = 11.124;
    HorBlankTime  = HorTotalTime - HorBlankStart =  4.495;
    HorSyncStart  = B / DOT_CLK                  = 11.962;
    HorSyncTime   = C / DOT_CLK - HorSyncStart   =  2.743;

 !
 !  section des réglages verticaux:    [msec, ou millisecondes]
 !

    VerTotalTime  = ( HorTotalTime * d ) / 1000  = 14.057;
    VerAddrTime   = ( HorTotalTime * a ) / 1000  = 13.682;
    VerBlankStart = ( HorTotalTime * a ) / 1000  = 13.682;
    VerBlankTime  = VerTotalTime - VerBlankStart =  0.375;
    VerSyncStart  = ( HorTotalTime * b ) / 1000  = 13.698;
    VerSyncTime   = ( HorTotalTime * ( c - b ) ) / 1000
                                                 = 0.219

 ! C'est tout !
</code></pre></blockquote>
<p>Il vous faut maintenant positionner ce mode vidéo nouvellement
créé dans les fichiers indiqués dans la section suivante, au bon
endroit.</p>
<h2><a name="s4">4. Mettre les choses au point</a></h2>
<p>Dans les extraits ci-dessous, le signe -&gt; vous indique ce qui
a été modifié: ne l'incluez PAS dans vos fichiers!</p>
<p>Entrée du moniteur (la mienne est
monitors/mfreq/mfreq64.vda)</p>
<blockquote>
<pre><code>
    [MODES_ÉTABLIS]
        "640x480 @ 60Hz",
        "640x480 @ 72Hz",
        "640x480 @ 75Hz",
        "800x600 @ 56Hz",
        "800x600 @ 60Hz",
        "800x600 @ 72Hz",
        "800x600 @ 75Hz",
        "1024x768 Interlaced",
        "1024x768 @ 60Hz",
        "1024x768 @ 70Hz",
        "1024x768 @ 75Hz",
    "1152x900 Interlaced",
        "1152x900 @ 60Hz",
        "1152x900 @ 67Hz",
-&gt;      "1168x876 @ 72Hz",
        "1280x1024 Interlaced",
        "1280x1024 @ 60Hz",
    "1600x1200 Interlaced";
</code></pre></blockquote>
<p>Dans le fichier d'informations propre à la carte (la mienne est
(boards/s3/764-2.xqa, je me demande pourquoi ils ont presque toutes
les cartes Hercules sauf la mienne: Terminator 64/Dram).</p>
<blockquote>
<pre><code>
    [VISUEL]
    BitsPerPixel   = 8;
    MemoryModel    = Packed;
    ColorModel     = Indexed;
    BitsRGB        = 6;
    NumberOfColors = 256;

    [RÉSOLUTIONS]
    640x480,
    800x600,
    1024x768,
-&gt;  1168x876,
    1152x900,
    1280x1024

    [BUREAUX]
    640x480,
    800x600,
    1024x768,
    1152x900,
-&gt;  1168x876,
    1280x1024,
    1600x1200
</code></pre></blockquote>
<p>Si la carte le permet (ce qui n'est PAS le cas pour ma carte)
vous pouvez même mettre cette entrée dans les sections 16bpp et
32bpp (bpp: bit par pixel).</p>
<p>Le fichier etc/Xaccel.ini ressemblera à ce qui suit:</p>
<blockquote>
<pre><code>
--------------------------------------------------------------
    Board   = "s3/764-2.xqa";
    Monitor = "mfreq/mfreq64.vda";
    Depth   = 8;
-&gt;  Desktop = 1168x876;

    [RÉSOLUTIONS]
-&gt;      1168x876,
        1024x768;
</code></pre></blockquote>
<p>L'entrée du mode correspondant pour XInside dans
etc/Xtimings:</p>
<blockquote>
<pre><code>
--------------------------------------------------------------
[MODE_PRÉAJUSTÉ]
    NomDuModePréajusté = "1168x876 @ 72Hz";

    HorPixel          = 1168;          // pixels
    VerPixel          = 876;           // lignes
    PixelWidthRatio   = 4;
    PixelHeightRatio  = 3;
    HorFrequency      = 64.024;        // kHz
    VerFrequency      = 71.138;        // Hz
    ScanType          = NONINTERLACED;
    HorSyncPolarity   = POSITIVE;
    VerSyncPolarity   = POSITIVE;
    CharacterWidth    = 8;             // pixels
    PixelClock        = 105.000;       // MHz
    HorTotalTime      = 15.619;        // (usec) =  205 caractères
    HorAddrTime       = 11.124;        // (usec) =  146 caractères
    HorBlankStart     = 11.124;        // (usec) =  146 caractères
    HorBlankTime      =  4.495;        // (usec) =   59 caractères
    HorSyncStart      = 11.962;        // (usec) =  157 caractères
    HorSyncTime       =  2.743;        // (usec) =   36 caractères
    VerTotalTime      = 14.057;        // (msec) =  900 lignes
    VerAddrTime       = 13.682;        // (msec) =  876 lignes
    VerBlankStart     = 13.682;        // (msec) =  876 lignes
    VerBlankTime      =  0.375;        // (msec) =   24 lignes
    VerSyncStart      = 13.698;        // (msec) =  877 lignes
    VerSyncTime       =  0.219;        // (msec) =   14 lignes
</code></pre></blockquote>
<p>Vous pouvez vérifier votre conversion en lançant le programme
vgaset sans paramètres alors que le serveur XInside tourne: cela
produira une ligne à la XFree et, si tout s'est bien passé, cette
ligne sera la même que celle de laquelle vous étiez parti (sauf si
b et c sont égaux, je n'ai pas réussi à reproduire cette situation
dans XInside: le meilleur cas qui s'est produit étant c=b+1).</p>
<h2><a name="s5">5. La fin...</a></h2>
<p>C'est tout pour cette fois-ci ! J'espère que cela vous sera
utile. Je ne pense pas acheter le serveur XiGraphics dans un futur
proche pour une raison simple: la sortie de XFree86 3.2 a résolu
tous les problèmes de vitesse que je rencontrais avec mon humble
carte vidéo Trio 64 ;)</p>
<p>Il semble toutefois que le serveur XiGraphics reconnaît un
ensemble de puces et de cartes vidéo bien plus large que XFree,
aussi est-il possible que l' "alternative commerciale" soit la
seule disponible pour vous. Si c'est le cas, et si vous avez acheté
le serveur XiGraphics, j'aimerais vraiment avoir de vos nouvelles
afin de savoir si l'information présentée ici vous a été utile, si
vous l'avez trouvée trop compliquée, ou quoi que ce soit.</p>
<h2><a name="s6">6. Rendre le processus automatique</a></h2>
<p>Le petit script qui suit automatise la plupart du travail.
Faites très attention au ScanType (type de balayage) et aux deux
lignes Polarity (polarité): le script ne les positionne pas et, si
vous avez la paresse de ne pas les corriger, les risques
d'endommager votre moniteur augmentent en flèche.</p>
<p>Remarquez que je ne sais pas si le drapeau "Doublescan"
(balayage double) a une signification quelconque dans XInside: si
vous tentez de convertir un mode de double balayage de faible
résolution FAITES ATTENTION, vous pouvez assez facilement casser
votre moniteur puisque le taux de rafraîchissement que vous obtenez
sera doublé (en fait mon 400x300 à 72Hz est devenu un 400x300 à
144Hz!).</p>
<blockquote>
<pre><code>
#!/bin/sh
##########################################################################
# XF2XInside
#
# Ce script convertit les lignes de mode vidéo du format XF86Config au
# format XInside pour remplir les besoins du fichier etc/Xtimings.
#
# C'est une bidouille vite programmée, n'en attendez pas des vérifications
# d'erreurs fines (et ne parlons pas de l'interface utilisateur).
#
# Si vous l'appelez sans argument, il devrait vous dire quoi faire.
#
#                               (juillet 1996, hcz@tazlwurm.bb.bawue.de)
#
# Au fait: Les nouveaux modes créés comme expliqués dans ce HOWTO
# fonctionnent, mais n'apparaissent pas dans le menu de Xsetup. Quelqu'un
# sait-il pourquoi ?
#
##########################################################################
#----------------------------------------------- On y va:
# Modifiez ceci si votre fichier de lignes de modes vidéo est ailleurs:
XF=/usr/X11/lib/X11/XF86Config
if [ $# -ne 1 ] ; then
  echo "utilisation: ${0##*/} &lt;mode&gt;"
  echo " exemple: ${0##*/} 1024x764"
  echo -e " rôle: convertit une entrée de ligne de mode vidéo de $XF au\nformat XInside (stdout, ou la sortie standard)"
  exit 1
fi
egrep -i "^[\t ]*modeline.+\"$1\""  /usr/X11/lib/X11/XF86Config |
gawk '
NF &lt; 11  { print "! mauvaise ligne:\n! " $0 "\n!"; next }
{
  print "//", $0  ":"
  name = $2
  DOT_CLK = $3;
  A = $4;
  B = $5;
  C = $6;
  D = $7;
  a = $8;
  b = $9;
  c = $10;
  d = $11;
  VerFrequency =  1000000 / ((D / DOT_CLK) * d)
  print "[MODE_PRÉAJUSTÉ]"
  printf "  NomDuModePréajusté = \"%dx%d @ %.0dHz\";\n", A, a, VerFrequency
  print "  HorPixel\t\t= " A ";"
  print "  VerPixel\t\t= " a ";"
  print "  PixelWidthRatio\t= 4;\n  PixelHeightRatio\t= 3;"
  print "  HorFrequency\t\t= " DOT_CLK / D * 1000 ";\t// kHz"
  print "  VerFrequency\t\t= " VerFrequency  ";\t// Hz"
  print "  ScanType\t\t= NONINTERLACED;\t\t// *VÉRIFIEZ*"
  print "  HorSyncPolarity\t= NEGATIVE;\t\t\t// *VÉRIFIEZ*"
  print "  VerSyncPolarity\t= NEGATIVE;\t\t\t// *VÉRIFIEZ*"
  print "  CharacterWidth\t= 8;"
  print "  PixelClock\t\t= " DOT_CLK ";"
  HorTotalTime = D / DOT_CLK
  print "  HorTotalTime\t\t= " HorTotalTime ";"
  print "  HorAddrTime \t\t= " A / DOT_CLK ";"
  print "  HorBlankStart\t\t= " A / DOT_CLK ";"
  print "  HorBlankTime\t\t= " D / DOT_CLK - A / DOT_CLK ";"
  print "  HorSyncStart\t\t= " B / DOT_CLK ";"
  print "  HorSyncTime\t\t= " C / DOT_CLK - B / DOT_CLK ";"
  VerTotalTime  = ( HorTotalTime * d ) / 1000
  print "  VerTotalTime\t\t= " VerTotalTime ";"
  print "  VerAddrTime\t\t= " ( HorTotalTime * a ) / 1000 ";"
  VerBlankStart = ( HorTotalTime * a ) / 1000
  print "  VerBlankStart\t\t= " VerBlankStart ";"
  print "  VerBlankTime\t\t= " VerTotalTime - VerBlankStart ";"
  print "  VerSyncStart\t\t= " ( HorTotalTime * b ) / 1000 ";"
  print "  VerSyncTime\t\t= " ( HorTotalTime * ( c - b ) ) / 1000
  print ""
}'
</code></pre></blockquote>
<h2><a name="s7">7. Merci à</a></h2>
<ul>
<li>Heike Claudia Zimmerer <a href=
"mailto:hcz@tazlwurm.bb.bawue.de">hcz@tazlwurm.bb.bawue.de</a> pour
m'avoir fait remarquer une petite contradiction et pour m'avoir
envoyé un script qui automatise une grande partie du travail.</li>
<li>Bartosz Maruszewski <a href=
"mailto:B.Maruszewski@zsmeie.torun.pl">B.Maruszewski@zsmeie.torun.pl</a>
pour avoir traduit ce mini HOWTO en polonais et pour m'avoir fait
remarquer une petite faute de frappe.</li>
</ul>
<h2><a name="s8">8. Copyright/point de vue légal</a></h2>
<p>(c)opyright 1996-7 par Marco Melgazzi (marco@techie.com) -
couvert par la GPL (licence publique de GNU). Pour obtenir une
copie de cette licence, écrivez à la Fondation pour un Logiciel
Libre, à l'adresse: Free Software Foundation, Inc., 675 Mass Ave,
Cambridge, MA 02139, USA.</p>
<p>Les marques déposées appartiennent à leurs propriétaires. Aucune
garantie ne couvre la justesse ou l'utilité de l'information que
vous trouverez dans ce document.</p>
</body>
</html>