Subversion Repositories Scribus

Rev

Rev 17163 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
10646 cbradney 1
<html>
2
<head>
3
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
4
        <title>Constantes pr&eacute;d&eacute;finies</title>
5
</head>
6
<body>
7477 mrdocs 7
<h2>Constantes pr&eacute;d&eacute;finies</h2>
8
 
9
<p>Des constantes sont d&eacute;finies pour aider &agrave; utiliser les commandes: </p>
10
 
11
<h4>Version Scribus :</h4>
12
        <p>L'interface de script fournit deux variables contenant la version
13
courante de Scribus dans le module <code>Scribus</code>. Les scripts peuvent utiliser ces variables pour v&eacute;rifier qu'ils tournent sous la bonne version de Scribus et pour informer l'utilisateur d'&eacute;ventuelles incompatibilit&eacute;s. Ces
14
deux variables, <code>scribus_version</code> et
15
<code>scribus_version_info</code>, ont &eacute;t&eacute; ajout&eacute;es dans les versions
16
1.2.1 et 1.3.0cvs et sont absentes des versions
17
pr&eacute;c&eacute;dentes. Si n&eacute;cessaire, vous pouvez v&eacute;rifier leur pr&eacute;sence avec <code>hasattr(scribus, 'scribus_version')</code>.</p>
18
        <p><code>scribus_version</code> est une cha&icirc;ne qui contient la version courante de Scribus. Sa valeur ressemble habituellement &agrave; <code>'1.2.1cvs'</code> ou <code>'1.3.0'</code>, par exemple, mais il n'est pas garanti que le format sera toujours le m&ecirc;me. Cette
19
variable est utile pour afficher la version &agrave; l'utilisateur, par exemple pour signaler une incompatibilit&eacute;. N'analysez pas et ne comparez pas cette variable, car <code>scribus_version_info</code> est fait pour cela.</p>
20
        <p><code>scribus_version_info</code> est un vecteur semblable au vecteur <code>sys.version_info</code> fourni par Python.
21
C'est un vecteur de la forme (majorversion, minorversion, patchlevel,
22
extraversion, build), par exemple 1.2.1cvs correspond &agrave;
23
<code>(1,2,1,'cvs',0)</code> et 1.3.2 correspond &agrave; <code>(1,3,2,'',0)<code> . Ces vecteurs sont id&eacute;aux pour v&eacute;rifier les versions minimum, etc., parce que Python compare les vecteurs &eacute;l&eacute;ment par &eacute;l&eacute;ment, de gauche &agrave; droite. Par exemple :</p>
24
<pre>
25
if scribus.scribus_version_info[:3] &lt; (1,2,2):
26
    messageBox("Scribus - script Python",
27
        "Ce script requiert 1.2.2 ou plus r&eacute;cent."+\
28
        "Vous roulez %s." % scribus.scribus_version,
29
        ICON_CRITICAL)
30
    sys.exit()
31
</pre>
32
 
33
<h4>Constantes d'&eacute;num&eacute;ration d'unit&eacute;s : </h4>
34
<dl>
35
        <dt>UNIT_POINTS</dt>
36
        <dd>Unit&eacute; de mesure point = 0</dd>
37
        <dt>UNIT_MILLIMETERS</dt>
38
        <dd>Unit&eacute; de mesure millim&egrave;tre = 1</dd>
39
        <dt>UNIT_INCHES</dt>
40
        <dd>Unit&eacute; de mesure pouce = 2</dd>
41
        <dt>UNIT_PICAS</dt>
42
        <dd>Unit&eacute; de mesure pica = 3</dd>
43
</dl>
44
 
45
<h4>Constantes de conversion d'unit&eacute;s</h4>
46
 
47
<p>Ces facteurs de conversion peuvent &ecirc;tre utilis&eacute;s pour convertir les unit&eacute;s en points et vice versa.
48
Ainsi, pour convertir les pouces en points, il suffit d'&eacute;crire 'valeur/inch'; pour convertir les points en pouces vous &eacute;crirez 'valeur*inch', et pour convertir les pouces en mm vous &eacute;crirez 'valeur*mm/inch'.</p>
49
 
50
<dl>
51
        <dt>pt</dt>
52
        <dd>points dans 1 pt</dd>
53
        <dt>inch</dt>
54
        <dd>pouces dans 1 pt</dt>
55
        <dt>p</dt>
56
        <dt>pica dans 1 pt</dt>
57
        <dt>cm<dt>
58
        <dt>centim&egrave;tres dans 1 pt</dt>
59
        <dt>mm</dt>
60
        <dt>millim&egrave;tres dans 1 pt</dt>
61
        <dt>...</dt>
62
        <dt>D'autres constantes seront fournies si le coeur de Scribus les reconna&icirc;t.</dt>
63
</dl>
64
 
65
<h4>D&eacute;finitions d'orientation de page :</h4>
66
<dl>
67
        <dt>PORTRAIT</dt>
68
        <dd>Pageformat Portrait = 0</dd>
69
        <dt>LANDSCAPE</dt>
70
        <dd>Pageformat Landscape = 1</dd>
71
</dl>
72
 
73
<h4>R&eacute;glages de format de page : </h4>
74
<dl>
75
        <dt>PAPER_A0</dt>
76
        <dd>Paperformat A0 = 2380 x 3368 Points</dd>
77
        <dt>PAPER_A1</dt>
78
        <dd>Paperformat A1 = 1684 x 2380 Points</dd>
79
        <dt>PAPER_A2</dt>
80
        <dd>Paperformat A2 = 1190 x 1684 Points</dd>
81
        <dt>PAPER_A3</dt>
82
        <dd>Paperformat A3 = 842 x 1190 Points</dd>
83
        <dt>PAPER_A4</dt>
84
        <dd>Paperformat A4 = 595 x 842 Points</dd>
85
        <dt>PAPER_A5</dt>
86
        <dd>Paperformat A5 = 421 x 595 Points</dd>
87
        <dt>PAPER_A6</dt>
88
        <dd>Paperformat A6 = 297 x 421 Points</dd>
89
        <dt>PAPER_A7</dt>
90
        <dd>Paperformat A7 = 210 x 297 Points</dd>
91
        <dt>PAPER_A8</dt>
92
        <dd>Paperformat A8 = 148 x 210 Points</dd>
93
        <dt>PAPER_A9</dt>
94
        <dd>Paperformat A9 = 105 x 148 Points</dd>
95
        <dt>PAPER_B0</dt>
96
        <dd>Paperformat B0 = 2836 x 4008 Points</dd>
97
        <dt>PAPER_B1</dt>
98
        <dd>Paperformat B1 = 2004 x 2836 Points</dd>
99
        <dt>PAPER_B2</dt>
100
        <dd>Paperformat B2 = 1418 x 2004 Points</dd>
101
        <dt>PAPER_B3</dt>
102
        <dd>Paperformat B3 = 1002 x 1418 Points</dd>
103
        <dt>PAPER_B4</dt>
104
        <dd>Paperformat B4 = 709 x 1002 Points</dd>
105
        <dt>PAPER_B5</dt>
106
        <dd>Paperformat B5 = 501 x 709 Points</dd>
107
        <dt>PAPER_B6</dt>
108
        <dd>Paperformat B6 = 355 x 501 Points</dd>
109
        <dt>PAPER_B7</dt>
110
        <dd>Paperformat B7 = 250 x 355 Points</dd>
111
        <dt>PAPER_B8</dt>
112
        <dd>Paperformat B8 = 178 x 250 Points</dd>
113
        <dt>PAPER_B9</dt>
114
        <dd>Paperformat B9 = 125 x 178 Points</dd>
115
        <dt>PAPER_B10</dt>
116
        <dd>Paperformat B10 = 89 x 125 Points</dd>
117
        <dt>PAPER_C5E</dt>
118
        <dd>Paperformat C5E = 462 x 649 Points</dd>
119
        <dt>PAPER_COMM10E</dt>
120
        <dd>Paperformat Comm10E = 298 x 683 Points</dd>
121
        <dt>PAPER_DLE</dt>
122
        <dd>Paperformat DLE = 312 x 624 Points</dd>
123
        <dt>PAPER_EXECUTIVE</dt>
124
        <dd>Paperformat Executive = 542 x 720 Points</dd>
125
        <dt>PAPER_FOLIO</dt>
126
        <dd>Paperformat Folio = 595 x 935 Points</dd>
127
        <dt>PAPER_LEDGER</dt>
128
        <dd>Paperformat Ledger = 1224 x 792 Points</dd>
129
        <dt>PAPER_LEGAL</dt>
130
        <dd>Paperformat Legal = 612 x 1008 Points</dd>
131
        <dt>PAPER_LETTER</dt>
132
        <dd>Paperformat Letter = 612 x 792 Points</dd>
133
        <dt>PAPER_TABLOID</dt>
134
        <dd>Paperformat Tabloid = 792 x 1224 Points</dd>
135
</dl>
136
 
137
<h4>R&eacute;glages de la disposition du document :</h4>
138
<dl>
139
        <dt>FACINGPAGES</dt>
140
        <dd>Disposition avec des pages en regard.</dd>
141
        <dt>NOFACINGPAGES</dt>
142
        <dd>Disposition normale du document.</dd>
143
        <dt>FIRSTPAGELEFT</dt>
144
        <dd>La premi&egrave;re page du document est une page de droite.</dd>
145
        <dt>FIRSTPAGERIGHT</dt>
146
        <dd>La premi&egrave;re page du document est une premi&egrave;re de droite.</dd>
147
</dl>
148
 
149
<h4>R&eacute;glages d'alignement</h4>
150
<dl>
24686 craig 151
        <dt>ALIGN_LEFT</dt>
7477 mrdocs 152
        <dd>Le texte est align&eacute; &agrave; gauche.</dd>
153
        <dt>ALIGN_CENTERED</dt>
154
        <dd>Le texte est centr&eacute; dans le cadre de texte.</dd>
155
        <dt>ALIGN_RIGHT</dt>
156
        <dd>Le texte est align&eacute; sur le c&ocirc;t&eacute; droit du cadre de texte.</dd>
157
        <dt>ALIGN_FORCED</dt>
158
        <dd>Le texte a un alignement forc&eacute;.</dd>
159
        <dt>ALIGN_BLOCK</dt>
160
        <dd>Le texte a un alignement bloqu&eacute;.</dd>
161
</dl>
162
 
163
<h4>R&eacute;glages relatifs aux lignes : </h4>
164
<dl>
165
    <dt>LINE_DASH</dt>
166
    <dt>LINE_DASHDOT</dt>
167
    <dt>LINE_DASHDOTDOT</dt>
168
    <dt>LINE_DOT</dt>
169
    <dt>LINE_SOLID</dt>
170
    <dt>JOIN_BEVEL</dt>
171
    <dt>JOIN_MITTER</dt>
172
    <dt>JOIN_ROUND</dt>
173
    <dt>CAP_FLAT</dt>
174
    <dt>CAP_ROUND</dt>
175
    <dt>CAP_SQUARE</dt>
176
</dl>
177
 
178
<h4>R&eacute;glages relatifs au fond : </h4>
179
<dl>
180
        <dt>FILL_NOG</dt>
181
    <dd>Pas de d&eacute;grad&eacute;, couleur unie</dd>
182
        <dt>FILL_HORIZONTALG</dt>
183
        <dt>FILL_VERTICALG</dt>
184
        <dt>FILL_DIAGONALG</dt>
185
        <dt>FILL_CROSSDIAGONALG</dt>
186
        <dt>FILL_RADIALG</dt>
187
</dl>
188
 
189
<h4>Boutons de dialogue</h4>
190
<dl>
191
    <dt>BUTTON_ABORT</dt>
192
    <dt>BUTTON_CANCEL</dt>
193
    <dt>BUTTON_IGNORE</dt>
194
    <dt>BUTTON_NO</dt>
195
    <dt>BUTTON_NONE</dt>
196
    <dt>BUTTON_OK</dt>
197
    <dt>BUTTON_RETRY</dt>
198
    <dt>BUTTON_YES</dt>
199
</dl>
200
 
201
<h4>Ic&ocirc;nes de dialogue</h4>
202
<dl>
203
    <dt>ICON_CRITICAL</dt>
204
    <dt>ICON_INFORMATION</dt>
205
    <dt>ICON_NONE</dt>
206
    <dt>ICON_WARNING</dt>
207
</dl>
208
 
10646 cbradney 209
</body>
210
</html>
7477 mrdocs 211