Subversion Repositories Scribus

Rev

Rev 8495 | Go to most recent revision | Details | Last modification | View Log | RSS feed

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