0,0 → 1,206 |
<qt> |
<title>Constantes prédéfinies</title> |
<h2>Constantes prédéfinies</h2> |
|
<p>Des constantes sont définies pour aider à utiliser les commandes: </p> |
|
<h4>Version Scribus :</h4> |
<p>L'interface de script fournit deux variables contenant la version |
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 |
deux variables, <code>scribus_version</code> et |
<code>scribus_version_info</code>, ont été ajoutées dans les versions |
1.2.1 et 1.3.0cvs et sont absentes des versions |
précédentes. Si nécessaire, vous pouvez vérifier leur présence avec <code>hasattr(scribus, 'scribus_version')</code>.</p> |
<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 |
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> |
<p><code>scribus_version_info</code> est un vecteur semblable au vecteur <code>sys.version_info</code> fourni par Python. |
C'est un vecteur de la forme (majorversion, minorversion, patchlevel, |
extraversion, build), par exemple 1.2.1cvs correspond à |
<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> |
<pre> |
if scribus.scribus_version_info[:3] < (1,2,2): |
messageBox("Scribus - script Python", |
"Ce script requiert 1.2.2 ou plus récent."+\ |
"Vous roulez %s." % scribus.scribus_version, |
ICON_CRITICAL) |
sys.exit() |
</pre> |
|
<h4>Constantes d'énumération d'unités : </h4> |
<dl> |
<dt>UNIT_POINTS</dt> |
<dd>Unité de mesure point = 0</dd> |
<dt>UNIT_MILLIMETERS</dt> |
<dd>Unité de mesure millimètre = 1</dd> |
<dt>UNIT_INCHES</dt> |
<dd>Unité de mesure pouce = 2</dd> |
<dt>UNIT_PICAS</dt> |
<dd>Unité de mesure pica = 3</dd> |
</dl> |
|
<h4>Constantes de conversion d'unités</h4> |
|
<p>Ces facteurs de conversion peuvent être utilisés pour convertir les unités en points et vice versa. |
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> |
|
<dl> |
<dt>pt</dt> |
<dd>points dans 1 pt</dd> |
<dt>inch</dt> |
<dd>pouces dans 1 pt</dt> |
<dt>p</dt> |
<dt>pica dans 1 pt</dt> |
<dt>cm<dt> |
<dt>centimètres dans 1 pt</dt> |
<dt>mm</dt> |
<dt>millimètres dans 1 pt</dt> |
<dt>...</dt> |
<dt>D'autres constantes seront fournies si le coeur de Scribus les reconnaît.</dt> |
</dl> |
|
<h4>Définitions d'orientation de page :</h4> |
<dl> |
<dt>PORTRAIT</dt> |
<dd>Pageformat Portrait = 0</dd> |
<dt>LANDSCAPE</dt> |
<dd>Pageformat Landscape = 1</dd> |
</dl> |
|
<h4>Réglages de format de page : </h4> |
<dl> |
<dt>PAPER_A0</dt> |
<dd>Paperformat A0 = 2380 x 3368 Points</dd> |
<dt>PAPER_A1</dt> |
<dd>Paperformat A1 = 1684 x 2380 Points</dd> |
<dt>PAPER_A2</dt> |
<dd>Paperformat A2 = 1190 x 1684 Points</dd> |
<dt>PAPER_A3</dt> |
<dd>Paperformat A3 = 842 x 1190 Points</dd> |
<dt>PAPER_A4</dt> |
<dd>Paperformat A4 = 595 x 842 Points</dd> |
<dt>PAPER_A5</dt> |
<dd>Paperformat A5 = 421 x 595 Points</dd> |
<dt>PAPER_A6</dt> |
<dd>Paperformat A6 = 297 x 421 Points</dd> |
<dt>PAPER_A7</dt> |
<dd>Paperformat A7 = 210 x 297 Points</dd> |
<dt>PAPER_A8</dt> |
<dd>Paperformat A8 = 148 x 210 Points</dd> |
<dt>PAPER_A9</dt> |
<dd>Paperformat A9 = 105 x 148 Points</dd> |
<dt>PAPER_B0</dt> |
<dd>Paperformat B0 = 2836 x 4008 Points</dd> |
<dt>PAPER_B1</dt> |
<dd>Paperformat B1 = 2004 x 2836 Points</dd> |
<dt>PAPER_B2</dt> |
<dd>Paperformat B2 = 1418 x 2004 Points</dd> |
<dt>PAPER_B3</dt> |
<dd>Paperformat B3 = 1002 x 1418 Points</dd> |
<dt>PAPER_B4</dt> |
<dd>Paperformat B4 = 709 x 1002 Points</dd> |
<dt>PAPER_B5</dt> |
<dd>Paperformat B5 = 501 x 709 Points</dd> |
<dt>PAPER_B6</dt> |
<dd>Paperformat B6 = 355 x 501 Points</dd> |
<dt>PAPER_B7</dt> |
<dd>Paperformat B7 = 250 x 355 Points</dd> |
<dt>PAPER_B8</dt> |
<dd>Paperformat B8 = 178 x 250 Points</dd> |
<dt>PAPER_B9</dt> |
<dd>Paperformat B9 = 125 x 178 Points</dd> |
<dt>PAPER_B10</dt> |
<dd>Paperformat B10 = 89 x 125 Points</dd> |
<dt>PAPER_C5E</dt> |
<dd>Paperformat C5E = 462 x 649 Points</dd> |
<dt>PAPER_COMM10E</dt> |
<dd>Paperformat Comm10E = 298 x 683 Points</dd> |
<dt>PAPER_DLE</dt> |
<dd>Paperformat DLE = 312 x 624 Points</dd> |
<dt>PAPER_EXECUTIVE</dt> |
<dd>Paperformat Executive = 542 x 720 Points</dd> |
<dt>PAPER_FOLIO</dt> |
<dd>Paperformat Folio = 595 x 935 Points</dd> |
<dt>PAPER_LEDGER</dt> |
<dd>Paperformat Ledger = 1224 x 792 Points</dd> |
<dt>PAPER_LEGAL</dt> |
<dd>Paperformat Legal = 612 x 1008 Points</dd> |
<dt>PAPER_LETTER</dt> |
<dd>Paperformat Letter = 612 x 792 Points</dd> |
<dt>PAPER_TABLOID</dt> |
<dd>Paperformat Tabloid = 792 x 1224 Points</dd> |
</dl> |
|
<h4>Réglages de la disposition du document :</h4> |
<dl> |
<dt>FACINGPAGES</dt> |
<dd>Disposition avec des pages en regard.</dd> |
<dt>NOFACINGPAGES</dt> |
<dd>Disposition normale du document.</dd> |
<dt>FIRSTPAGELEFT</dt> |
<dd>La première page du document est une page de droite.</dd> |
<dt>FIRSTPAGERIGHT</dt> |
<dd>La première page du document est une première de droite.</dd> |
</dl> |
|
<h4>Réglages d'alignement</h4> |
<dl> |
<dt>ALIGN_LEFTK</dt> |
<dd>Le texte est aligné à gauche.</dd> |
<dt>ALIGN_CENTERED</dt> |
<dd>Le texte est centré dans le cadre de texte.</dd> |
<dt>ALIGN_RIGHT</dt> |
<dd>Le texte est aligné sur le côté droit du cadre de texte.</dd> |
<dt>ALIGN_FORCED</dt> |
<dd>Le texte a un alignement forcé.</dd> |
<dt>ALIGN_BLOCK</dt> |
<dd>Le texte a un alignement bloqué.</dd> |
</dl> |
|
<h4>Réglages relatifs aux lignes : </h4> |
<dl> |
<dt>LINE_DASH</dt> |
<dt>LINE_DASHDOT</dt> |
<dt>LINE_DASHDOTDOT</dt> |
<dt>LINE_DOT</dt> |
<dt>LINE_SOLID</dt> |
<dt>JOIN_BEVEL</dt> |
<dt>JOIN_MITTER</dt> |
<dt>JOIN_ROUND</dt> |
<dt>CAP_FLAT</dt> |
<dt>CAP_ROUND</dt> |
<dt>CAP_SQUARE</dt> |
</dl> |
|
<h4>Réglages relatifs au fond : </h4> |
<dl> |
<dt>FILL_NOG</dt> |
<dd>Pas de dégradé, couleur unie</dd> |
<dt>FILL_HORIZONTALG</dt> |
<dt>FILL_VERTICALG</dt> |
<dt>FILL_DIAGONALG</dt> |
<dt>FILL_CROSSDIAGONALG</dt> |
<dt>FILL_RADIALG</dt> |
</dl> |
|
<h4>Boutons de dialogue</h4> |
<dl> |
<dt>BUTTON_ABORT</dt> |
<dt>BUTTON_CANCEL</dt> |
<dt>BUTTON_IGNORE</dt> |
<dt>BUTTON_NO</dt> |
<dt>BUTTON_NONE</dt> |
<dt>BUTTON_OK</dt> |
<dt>BUTTON_RETRY</dt> |
<dt>BUTTON_YES</dt> |
</dl> |
|
<h4>Icônes de dialogue</h4> |
<dl> |
<dt>ICON_CRITICAL</dt> |
<dt>ICON_INFORMATION</dt> |
<dt>ICON_NONE</dt> |
<dt>ICON_WARNING</dt> |
</dl> |
|
</qt> |
|
Property changes: |
Added: svn:eol-style |
## -0,0 +1 ## |
+native |
\ No newline at end of property |
Added: svn:keywords |
## -0,0 +1 ## |
+Author Date Id Revision |
\ No newline at end of property |