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édéfinies</title> |
||
3 | <h2>Constantes prédéfinies</h2> |
||
4 | |||
5 | <p>Des constantes sont définies pour aider à 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érifier qu'ils tournent sous la bonne version de Scribus et pour informer l'utilisateur d'éventuelles incompatibilités. Ces |
||
10 | deux variables, <code>scribus_version</code> et |
||
11 | <code>scribus_version_info</code>, ont été ajoutées dans les versions |
||
12 | 1.2.1 et 1.3.0cvs et sont absentes des versions |
||
13 | précédentes. Si nécessaire, vous pouvez vérifier leur présence avec <code>hasattr(scribus, 'scribus_version')</code>.</p> |
||
14 | <p><code>scribus_version</code> est une chaîne qui contient la version courante de Scribus. Sa valeur ressemble habituellement à <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ême. Cette |
||
15 | variable est utile pour afficher la version à l'utilisateur, par exemple pour signaler une incompatibilité. 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 à |
||
19 | <code>(1,2,1,'cvs',0)</code> et 1.3.2 correspond à <code>(1,3,2,'',0)<code> . Ces vecteurs sont idéaux pour vérifier les versions minimum, etc., parce que Python compare les vecteurs élément par élément, de gauche à droite. Par exemple :</p> |
||
20 | <pre> |
||
21 | if scribus.scribus_version_info[:3] < (1,2,2): |
||
22 | messageBox("Scribus - script Python", |
||
23 | "Ce script requiert 1.2.2 ou plus récent."+\ |
||
24 | "Vous roulez %s." % scribus.scribus_version, |
||
25 | ICON_CRITICAL) |
||
26 | sys.exit() |
||
27 | </pre> |
||
28 | |||
29 | <h4>Constantes d'énumération d'unités : </h4> |
||
30 | <dl> |
||
31 | <dt>UNIT_POINTS</dt> |
||
32 | <dd>Unité de mesure point = 0</dd> |
||
33 | <dt>UNIT_MILLIMETERS</dt> |
||
34 | <dd>Unité de mesure millimètre = 1</dd> |
||
35 | <dt>UNIT_INCHES</dt> |
||
36 | <dd>Unité de mesure pouce = 2</dd> |
||
37 | <dt>UNIT_PICAS</dt> |
||
38 | <dd>Unité de mesure pica = 3</dd> |
||
39 | </dl> |
||
40 | |||
41 | <h4>Constantes de conversion d'unités</h4> |
||
42 | |||
43 | <p>Ces facteurs de conversion peuvent être utilisés pour convertir les unités en points et vice versa. |
||
44 | Ainsi, pour convertir les pouces en points, il suffit d'écrire 'valeur/inch'; pour convertir les points en pouces vous écrirez 'valeur*inch', et pour convertir les pouces en mm vous é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ètres dans 1 pt</dt> |
||
55 | <dt>mm</dt> |
||
56 | <dt>millimètres dans 1 pt</dt> |
||
57 | <dt>...</dt> |
||
58 | <dt>D'autres constantes seront fournies si le coeur de Scribus les reconnaît.</dt> |
||
59 | </dl> |
||
60 | |||
61 | <h4>Dé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é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é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ère page du document est une page de droite.</dd> |
||
141 | <dt>FIRSTPAGERIGHT</dt> |
||
142 | <dd>La première page du document est une première de droite.</dd> |
||
143 | </dl> |
||
144 | |||
145 | <h4>Réglages d'alignement</h4> |
||
146 | <dl> |
||
147 | <dt>ALIGN_LEFTK</dt> |
||
148 | <dd>Le texte est aligné à gauche.</dd> |
||
149 | <dt>ALIGN_CENTERED</dt> |
||
150 | <dd>Le texte est centré dans le cadre de texte.</dd> |
||
151 | <dt>ALIGN_RIGHT</dt> |
||
152 | <dd>Le texte est aligné sur le côté droit du cadre de texte.</dd> |
||
153 | <dt>ALIGN_FORCED</dt> |
||
154 | <dd>Le texte a un alignement forcé.</dd> |
||
155 | <dt>ALIGN_BLOCK</dt> |
||
156 | <dd>Le texte a un alignement bloqué.</dd> |
||
157 | </dl> |
||
158 | |||
159 | <h4>Ré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églages relatifs au fond : </h4> |
||
175 | <dl> |
||
176 | <dt>FILL_NOG</dt> |
||
177 | <dd>Pas de dégradé, 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ô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 |