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.
|
Constantes 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
|
Constantes de 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.
|
Constantes de types d'objet de page:
- ITEM_ITEMTYPE1
- Obsolète, veuillez ne pas utiliser. Présent pour des raisons d'exhaustivité.
- ITEM_IMAGEFRAME
- ITEM_ITEMTYPE3
- Obsolète, veuillez ne pas utiliser. Présent pour des raisons d'exhaustivité.
- ITEM_TEXTFRAME
- ITEM_LINE
- ITEM_POLYGON
- ITEM_POLYLINE
- ITEM_PATHTEXT
- ITEM_LATEXFRAME
- ITEM_OSGFRAME
- ITEM_SYMBOL
- ITEM_GROUP
- ITEM_REGULARPOLYGON
- ITEM_ARC
- ITEM_SPIRAL
- ITEM_TABLE
- ITEM_NOTEFRAME
- ITEM_MULTIPLE
|
Constantes d'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é.
|
Constantes d'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.
|
Constantes d'offset de première ligne:
- FLOP_REALGLYPHHEIGHT
- L'offset de la première ligne est déterminé selon la hauteur maximale des glyphes situés dans la ligne de texte.
- FLOP_FONTASCENT
- L'offset de la première ligne est déterminé selon la hauteur de hampe de la police de caractère.
- FLOP_LINESPACING
- L'offset de la première ligne est déterminé selon la valeur d'interligne courante.
- FLOP_BASELINEGRID
- L'offset de la première ligne est déterminé selon la grille de base.
|
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
|
Constantes d'alignement par TAB
- TAB_LEFT
- TAB_RIGHT
- TAB_PERIOD
- TAB_COMMA
- TAB_CENTER
|
Constantes de language d'impression
- PRNLANG_POSTSCRIPT1
- Postscript Niveau 1 (requiert Ghostscript)
- PRNLANG_POSTSCRIPT2
- Postscript Niveau 2 (requiert Ghostscript)
- PRNLANG_POSTSCRIPT3
- Postscript Niveau 3
- PRNLANG_WINDOWSGDI
- Windows GDI (disponible sur Microsoft Windows uniquement)
- PRNLANG_PDF
- Adobe PDF (disponible uniquement sur MacOS et les systèmes dérivés d'Unix)
|