## Constantes prédéfinies

Des constantes sont définies pour aider à utiliser les commandes:

#### Version Scribus :

L'interface de script fournit deux variables contenant la version courante de Scribus dans le module `Scribus`. 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, `scribus_version` et `scribus_version_info`, 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 `hasattr(scribus, 'scribus_version')`.

`scribus_version` est une chaîne qui contient la version courante de Scribus. Sa valeur ressemble habituellement à `'1.2.1cvs'` ou `'1.3.0'`, 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 `scribus_version_info` est fait pour cela.

`scribus_version_info` est un vecteur semblable au vecteur `sys.version_info` fourni par Python. C'est un vecteur de la forme (majorversion, minorversion, patchlevel, extraversion, build), par exemple 1.2.1cvs correspond à `(1,2,1,'cvs',0)` et 1.3.2 correspond à `(1,3,2,'',0)` . 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 :

    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()

#### Constantes d'énumération d'unités :

UNIT_POINTS Unité de mesure point = 0 UNIT_MILLIMETERS Unité de mesure millimètre = 1 UNIT_INCHES Unité de mesure pouce = 2 UNIT_PICAS Unité de mesure pica = 3

#### Constantes de conversion d'unités

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'.

pt points dans 1 pt inch pouces dans 1 pt p pica dans 1 pt cm centimètres dans 1 pt mm millimètres dans 1 pt ... D'autres constantes seront fournies si le coeur de Scribus les reconnaît.

#### Définitions d'orientation de page :

PORTRAIT Orientation Portrait = 0 LANDSCAPE Orientation Landscape = 1

#### Réglages de format de page :

PAPER_A0 Format papier A0 = 2380 x 3368 Points PAPER_A1 Format papier A1 = 1684 x 2380 Points PAPER_A2 Format papier A2 = 1190 x 1684 Points PAPER_A3 Format papier A3 = 842 x 1190 Points PAPER_A4 Format papier A4 = 595 x 842 Points PAPER_A5 Format papier A5 = 421 x 595 Points PAPER_A6 Format papier A6 = 297 x 421 Points PAPER_A7 Format papier A7 = 210 x 297 Points PAPER_A8 Format papier A8 = 148 x 210 Points PAPER_A9 Format papier A9 = 105 x 148 Points | PAPER_A0_MM Format papier A0 = 841 x 1189 Millimètres PAPER_A1_MM Format papier A1 = 594 x 841 Millimètres PAPER_A2_MM Format papier A2 = 420 x 594 Millimètres PAPER_A3_MM Format papier A3 = 297 x 420 Millimètres PAPER_A4_MM Format papier A4 = 210 x 297 Millimètres PAPER_A5_MM Format papier A5 = 148 x 210 Millimètres PAPER_A6_MM Format papier A6 = 105 x 148 Millimètres PAPER_A7_MM Format papier A7 = 74 x 105 Millimètres PAPER_A8_MM Format papier A8 = 52 x 74 Millimètres PAPER_A9_MM Format papier A9 = 37 x 52 Millimètres
PAPER_B0 Format papier B0 = 2836 x 4008 Points PAPER_B1 Format papier B1 = 2004 x 2836 Points PAPER_B2 Format papier B2 = 1418 x 2004 Points PAPER_B3 Format papier B3 = 1002 x 1418 Points PAPER_B4 Format papier B4 = 709 x 1002 Points PAPER_B5 Format papier B5 = 501 x 709 Points PAPER_B6 Format papier B6 = 355 x 501 Points PAPER_B7 Format papier B7 = 250 x 355 Points PAPER_B8 Format papier B8 = 178 x 250 Points PAPER_B9 Format papier B9 = 125 x 178 Points PAPER_B10 Format papier B10 = 89 x 125 Points | PAPER_B0_MM Format papier B0 = 1000 x 1414 Millimètres PAPER_B1_MM Format papier B1 = 707 x 1000 Millimètres PAPER_B2_MM Format papier B2 = 500 x 707 Millimètres PAPER_B3_MM Format papier B3 = 353 x 500 Millimètres PAPER_B4_MM Format papier B4 = 250 x 353 Millimètres PAPER_B5_MM Format papier B5 = 176 x 250 Millimètres PAPER_B6_MM Format papier B6 = 125 x 176 Millimètres PAPER_B7_MM Format papier B7 = 88 x 125 Millimètres PAPER_B8_MM Format papier B8 = 62 x 88 Millimètres PAPER_B9_MM Format papier B9 = 44 x 62 Millimètres PAPER_B10_MM Format papier B10 = 31 x 44 Millimètres
PAPER_C5E Format papier C5E = 462 x 649 Points PAPER_COMM10E Format papier Comm10E = 298 x 683 Points PAPER_DLE Format papier DLE = 312 x 624 Points PAPER_EXECUTIVE Format papier Executive = 542 x 720 Points PAPER_FOLIO Format papier Folio = 595 x 935 Points PAPER_LEDGER Format papier Ledger = 1224 x 792 Points PAPER_LEGAL Format papier Legal = 612 x 1008 Points PAPER_LETTER Format papier Letter = 612 x 792 Points PAPER_TABLOID Format papier Tabloid = 792 x 1224 Points

#### Réglages de la disposition du document :

FACINGPAGES Disposition avec des pages en regard. NOFACINGPAGES Disposition normale du document. FIRSTPAGELEFT La première page du document est une page de droite. FIRSTPAGERIGHT La première page du document est une première de droite.

#### Réglages de l'alignement :

ALIGN_LEFT Le texte est aligné à gauche. ALIGN_CENTERED Le texte est centré dans le cadre de texte. ALIGN_RIGHT Le texte est aligné sur le côté droit du cadre de texte. ALIGN_FORCED Le texte a un alignement forcé. ALIGN_BLOCK Le texte a un alignement bloqué.

#### Réglages de l'alignement vertical :

ALIGNV_TOP Le texte est aligné verticalement en haut. ALIGNV_CENTERED Le texte est aligné verticalement au centre. ALIGNV_BOTTOM Le texte est aligné verticalement en bas.

#### Réglages relatifs aux lignes :

LINE_DASH LINE_DASHDOT LINE_DASHDOTDOT LINE_DOT LINE_SOLID JOIN_BEVEL JOIN_MITTER JOIN_ROUND CAP_FLAT CAP_ROUND CAP_SQUARE

#### Définitions d'espaces de couleur:

CSPACE_UNDEFINED CSPACE_RGB CSPACE_CMYK CSPACE_GRAY CSPACE_DUOTONE CSPACE_MONOCHROME

#### Réglages relatifs au fond :

FILL_NOG Pas de dégradé, couleur unie FILL_HORIZONTALG FILL_VERTICALG FILL_DIAGONALG FILL_CROSSDIAGONALG FILL_RADIALG

#### Boutons de dialogue

BUTTON_ABORT BUTTON_CANCEL BUTTON_IGNORE BUTTON_NO BUTTON_NONE BUTTON_OK BUTTON_RETRY BUTTON_YES

#### Icônes de dialogue

ICON_CRITICAL ICON_INFORMATION ICON_NONE ICON_WARNING