Système d’exploitation

Conseillé

Obsolète

Windows

Windows 7, 8, 8.1, 10

Windows Server 2003

Windows Server 2008

Windows Server 2012

Windows 98

Windows NT 4.0

Windows 2000

Unix

HP-UX 11

AIX 4.3.3

Sun Solaris 5.5

Compaq TRU64 5.0 SCO Open Server 6 Linux⁽¹⁾ :

RedHat : version 5 et supérieur

Suse : version 11 et supérieur. Debian : version 2 et supérieur.

Système d’exploitation

Processeur minimum requis

Windows & Unix

tout processeur compatible

Système d’exploitation

Quantité de RAM minimale requise⁽²⁾

Unix/Linux

2Go min

Windows Server 2003

Windows Server 2008

Windows Server 2012

2Go min

Système d’exploitation

Espace disque minimal requis pour l’Application

Windows

400 Mo

Unix

80 Mo

/

permet de sélectionner le nœud racine

@

permet de sélectionner les attributs

*

se comporte comme un joker et permet de désigner n’importe quel élément.

SourcePageNumber

numéro de la page en cours d’utilisation dans le fichier de données

OutputPageNumber

numéro de la page imprimée

StepNumber

numéro d’itération d’une boucle

DataLinesNumber

(réservé au mode ASCII)

nombre de ligne de données dans la page en cours d’utilisation dans le fichier de données

ENDOFFILE

retourne VRAI si le fichier de données est en fin de lecture

FILLER

retourne VRAI si l’environnement est StarFiller

GED

retourne VRAI si l’environnement est StarSafe

VIEW

retourne VRAI si l’environnement est StarView

Break

Demande l’arrêt de StarPage

Layout type compute

Breakspool

Ferme le fichier spool

Layout type compute

Call Macro

Appelle une macro.

Tous types de layouts

Call Overlay

Appelle un overlay (c.a d. une

séquence de commandes de fond de page)

Layouts type page et overlay

Copy

Duplique un bloc de données de la source

Tous types de layouts

Erase

Efface les informations contenues dans un bloc de données

Tous types de layouts

ExitBlock

Permet de sortir d’un bloc d’instruction (comme une boucle) ou d’arrêter un layout de n’importe quel type que ce soit.

Tous types de layouts

Move

Déplace un bloc de données

de la source vers une autre destination

Tous types de layouts

Put

Ajoute une chaîne de caractère, ou le résultat d’un traitement

Layouts type page et overlay

Set

Affecte une valeur à une variable

Tous types de layouts

For

Permet d’effectuer les instructions tant que la

variable n’est pas égale à l’expression de Fin

While

Permet d’effectuer les instructions tant que la

variable n’est pas égale à l’expression de Fin

If

Permet d’effectuer les instructions si la condition est vérifiée

SELECT…CASE

Permet de définir les instructions à effectuer selon le contenu d’une expression chaîne.

Syntaxe

form “fichier_commandes”

Paramètres

fichier_commandes est le nom du fichier de commandes à inclure

Commentaires

• Le fichier dont le nom est indiqué sera inclus au début de l’impression. Ce fichier est un fichier de commandes classique, automatiquement généré pour vous par StarJet-Design. Il décrit l’ensemble des fonds de pages et des polices de caractères utilisés.
• Le fond de page défini sera donc imprimé avec les différentes pages de l’état. Les polices de caractères utilisées pour le reste de ce fichier de commandes font référence à celles définies dans le fond de page

Exemple

form “fichier.sjp”

…………

…………

Syntaxe

prefix <s>

Paramètres

s est un caractère spécial remplaçant la barre de fraction

(“/”) utilisée pour l’exécution des commandes StarJet

Commentaires

• Grâce à cette commande, il est possible de changer le caractère défini comme préfixe des commandes comprises par le programme de génération de l’impression. Cette commande est exécutée après l’exécution de la commande form.
• Cela permet par exemple d’utiliser le caractère “/”, préfixe par défaut, en tant que caractère imprimable.

Exemple

…………

Put “/10/2002” to 10, 50 Text 1

…………

 Cette ligne de commande génère une erreur car le caractère “/” est par défaut le préfixe des commandes StarJet.

Ce préfixe doit donc être modifié.

…………

prefix ‘!’

…………

Put “/10/2002” to 10, 50 Text 1

…………

…………

La date /10/2002 sera copiée en 10:50 et imprimée en utilisant la police définie avec le numéro 1

Syntaxe

maxlines <nombre_lignes>

Paramètres

nombre_lignes est le nombre maximum de lignes par

page.

Commentaires

• Cette fonction sert a découper les pages du fichier de données entrant.
• Cette fonction est essentielle lorsque le fichier à traiter ne contient pas d’autre condition d’éjection de page.

Exemple

…………

maxlines 66

…………

Dès que StarPage, en l’absence de toute autre condition d’éjection de page (cf § Découpage des pages), aura rencontré 66 lignes, il éjectera une nouvelle page.

Syntaxe

Page = L<nlig>:C<ncol> = “Chaîne“

Paramètres

L<nlig> est le numéro de la ligne de départ par rapport à la rupture de page

C<ncol> est le numéro de colonne de départ de la chaîne à trouver

Exemple 1

Premier exemple :

…………

page = L2:C10 = “Facture”

# … Coupe la page de la façon suivante :

Ligne1 Ligne2

… Ligne x

… Ligne 11

……….Facture  Rupture avec la valeur Ligne=2 donc “Facture” se retrouve en Ligne 2

Ligne3 Ligne 4

…………

Exemple 2

Second Exemple :

…………

page = L-3:C50 = “total”

# … Coupe la page de la façon suivante :

Ligne1 Ligne2

..

.. total  Ceci est considéré comme la ligne-3 Ligne19 Ceci est considéré comme la Ligne-2

Ligne20 Ceci est considéré comme la Ligne–1 Ligne 1

Ligne 2

…………

Syntaxe

Default <commande d’environnement>

Paramètres

commande d’environnement représente la commande et son paramètre.

Commentaires

• Une commande d’environnement (cf Chapitre Les commandes d’environnement) définie à l’aide de la commande Default sera valide pour tous les cas de figure ou une commande de même type n’est pas définie.
• Si aucune commande d’environnement ne figure dans un fichier de commandes StarPage, les commandes figurant dans le fichier de commandes de définition du fond de page indiqué dans la commande Form, restent

valides.

Exemple

…………

Default Portrait A4 Format=2 by 3 Default copies 3

Default duplex 0

…………

Par défaut, les différentes pages de cet état seront imprimées en mode portrait sur du papier A4. Six pages logiques seront imprimées sur chaque page physique.

Chaque page physique sera dupliquée trois fois. Le mode duplex est invalidé.

Syntaxe

_MAXLOOP <Entier>

Paramètres

Entier est une valeur entière qui, si elle est égale à zéro,

désactive le _MAXLOOP.

Commentaires

• Lorsque la boucle d’itération est stoppée, un message d’avertissement est généré.
• Par fichier de commandes, il n’existe qu’une valeur de

_MAXLOOP.

• La valeur par défaut du _MAXLOOP est de 10 000

Exemple

…………

_MAXLOOP 5000

…

While TRUE # une condition qui est toujours vraie

… # ensemble de commandes…

…

EndWhile

…………

Cette boucle s’arrêtera après 5000 itérations Le message suivant est alors généré :

Avertissement : une boucle WHILE ou FOR a été stoppée au bout de 5000 tours

Syntaxe

local numbers separator <sep>

Paramètres

sep représente un caractère

Commentaires

• sep est indiqué entre quotes

Exemple

…………

local numbers separator ‘.’

…………

Syntaxe

local numbers decimal <sep>

Paramètres

sep représente un caractère

Commentaires

• sep est indiqué entre quotes

Exemple

…………

local numbers decimal ‘,’

…………

Syntaxe

local numbers format “formatage”

Paramètres

formatage représente le format modèle des valeurs

numériques

Commentaires

• “formatage” est indiqué entre double-quotes

Exemple

…………

local numbers format “0,00”

…………

Les nombres ont obligatoirement 2 décimales c’est à dire que 4,1 s’écrira 4,10.

…………

local numbers format “0,##”

…………

La limite est fixée à 2 décimales c’est à dire que 4,1 s’écrira 4,1 et 3,126 sera converti en 3,13.

…………

local numbers format “# ##0,00”

…………

Le # peut aussi servir à séparer les données en groupes c’est à dire que 1000 s’écrira 1 000.

Syntaxe

XMLDoc Level n

Paramètres

n est le niveau de découpage du flux XML en différents documents.

1 : le flux représente un seul et même document.

…

n : chaque nœud de niveau n représente un document.

Exemple

…………

XMLDoc Level 3

…

Chaque nœud de niveau 3 représente un document.

Syntaxe

Value <nom> Is Var [“init“]

Paramètres

nom représente le nom de la variable

Var est le mot-clef indiquant qu’il s’agit d’une variable interne

init est la valeur d’initialisation de la variable

Commentaires

• Une valeur peut être affectée à la variable lors de sa création à l’aide de la commande Set.

Exemple

…………

Value exemple1 Is Var

…………

La variable, nommée exemple1, est une variable initialisée en chaîne vide. Elle pourra être utilisée pendant tout le reste du traitement et son contenu être modifié par une commande Set.

…………

Value exemple2 Is Var “Info”

…………

Une valeur par défaut est affectée à la variable,

exemple2, à savoir la chaîne de caractères Info.

Syntaxe

Value <nom> Is Zone <def_zone>[Page <P>][“init”]

Paramètres

nom représente le nom de la variable

Zone est le mot-clef indiquant qu’il s’agit d’une variable extraite des données

def_zone représente la définition de la zone dans une syntaxe spécifique.

Page est le mot-clef indiquant le numéro de la page d’extraction (du fichier d’entrée)

P est le numéro de la page sur laquelle doit être effectuée l’extraction

init est la valeur d’initialisation de la variable

Commentaires

• Une valeur par défaut peut être affectée à la variable. Toutefois, lors du traitement de la page, cette valeur sera écrasée par la valeur extraite de la zone. L’exploitation d’informations contenues dans les pages de données peut, par exemple, permettre d’imprimer un nombre d’étiquettes dépendant d’une valeur située sur les pages de données.
• Si un numéro de page est indiqué, la valeur de la zone ne sera affectée à cette variable que lors du traitement de la page de données spécifiée.

Exemple

…………

Value taux Is Zone L1:C2,14 Page 2

…………

taux est une variable de type Zone, son contenu étant lié aux informations contenues dans la page numéro2 de l’état traité, dans la zone indiquée, ligne 1, colonne 2 à

14. Cette valeur peut être utilisée dans une des pages suivantes lors d’un calcul impliquant la valeur taux.

Syntaxe

Value <nom> Is Field “Chaîne”[NOCASE]

[COL<inter>] [LINE<inter>]

[START<<NUM1>│<CAR1>>] [STOP<<NUM2>│<CAR2>>]

Paramètres

nom représente le nom de la variable

Field est le mot-clef indiquant qu’il s’agit d’une variable de type champ

Chaîne indique la chaîne de caractères permettant de localiser l’information désirée.

NOCASE est le mot-clef indiquant que la recherche sur chaîne ne doit pas tenir compte de la casse.

COL est le mot-clef indiquant que la recherche sur chaîne doit se faire sur une colonne précise ou un intervalle de colonnes.

LINE est le mot-clef indiquant que la recherche sur chaîne doit se faire sur une ligne précise ou un intervalle de lignes. inter est l’intervalle de lignes ou de colonnes sur laquelle doit être effectuée la recherche.

START est le mot-clef indiquant l’endroit ou la recherche sur chaîne doit se faire.

NUM1 indique le nombre de caractères à partir desquels la valeur souhaitée doit être extraite, en incluant la longueur de Chaîne.

CAR1 indique le caractère délimitant le début du champ recherché.

STOP est le mot-clef indiquant l’endroit ou la recherche sur chaîne doit se finir.

NUM2 indique la taille maximale du champ à extraire

CAR2 indique le caractère de fin de champ à extraire

Commentaires

• LINE 1 indique que seule la ligne 1 doit être parcourue en recherche.

LINE -10 indique que la recherche doit être effectuée sur les lignes 1 à 10 de la page.

LINE 10-25 indique que la recherche se situe sur une plage située entre la ligne 10 et la ligne 25.

• COL 1 indique que le premier caractère de la chaîne est localisé colonne1.

COL 10-25 indique que le premier caractère de la séquence est situé entre la colonne 10 et la colonne 25.

• Une fois, la chaîne localisée, les données peuvent être extraites soit en définissant un caractère de début, soit en spécifiant le nombre de colonnes entre le début de la chaîne et le début de l’information recherchée. Il est aussi possible de définir la fin du champ, soit par un caractère stop, ou en précisant la longueur du champ.
• Une variable de type Field est, par définition volatile,

c’est à dire que son contenu n’est pas conservé d’une page de données à l’autre.

Exemple

…………

Value exemple Is Field “TOTAL” START ‘!’ STOP 12

…………

exemple est une variable de type Field se situant après la chaîne de caractères TOTAL, commençant

après un point d’exclamation et ayant une longueur maximale de 12 caractères.

Syntaxe

Value <nom> Is Array [Debut–Fin]

Paramètres

Nom représente le nom du tableau de variables

Array [Debut–Fin] est le mot-clé indiquant qu’il s’agit

d’un tableau. Les valeurs début et fin sont des entiers supérieurs ou égaux à zéro, indiquant les bornes du tableau.

Commentaires

• Il est possible de déclarer un tableau pour une variable seulement en mettant Début = Fin
• Les variables de type tableau peuvent être utilisées de la même façon que les variables de type Set c’est à dire dans toutes les expressions ainsi que dans les instructions Set et comme indice d’une boucle For.
• En cas de tentative d’accès en dehors des bornes, un message de Warning est généré à l’exécution et une valeur vide est renvoyée.

Exemple

…………

Value exemple Is Array [1–10]

…………

Put exemple[IndexEnCours] to 100, 110 text 1

Set “toto” to exemple[5]

Syntaxe

VarField.FindNext

Paramètres

VarField représente une variable de type Field

Commentaires

• La recherche de la première occurrence du champ étant automatique, il ne faut donc pas faire appel à FindNext pour y accéder.

Exemple

…………

WHILE exemple.index%<> 0

# tant que le champ est trouvé (cf § Variable Field pour la définition d’exemple.index).

PUT exemple to …

# utilisation de la valeur trouvée

exemple.FindNext

# recherche de l’occurrence suivante

ENDWHILE

…………

Ceci est un exemple de recherche de toutes les occurrences d’une variable Field appelé exemple

Syntaxe

VarField.Reset

Paramètres

VarField représente une variable de type Field

Commentaires

• Cette commande est donc utilisée lors de recherches consécutives dans une même page de données.
• A chaque début de traitement, il est conseillé de réinitialiser la variable Field.

Exemple

…………

exemple.Reset

WHILE exemple.index%<> 0

# tant que le champ est trouvé (cf § Variable Field pour la définition d’exemple.index).

PUT exemple to …

# utilisation de la valeur trouvée

exemple.FindNext

# recherche de l’occurrence suivante

ENDWHILE

…………

exemple est réinitialisé à chaque début de traitement

Syntaxe

condition <nom_de_condition> is <expression booléenne>

Paramètres

nom_de_condition représente le nom affecté à la condition

expression booléenne représente une expression renvoyant une valeur vraie ou fausse

Commentaires

• condition, nommée comme indiqué, est créé dans les tables internes de StarPage. Ce nom peut ensuite être utilisé en conjonction avec la majorité des commandes afin d’indiquer un traitement particulier si la condition est considérée comme vraie.
• <expression booléenne> doit obéir à la syntaxe définie.
• Il existe des conditions pré-définies dans le logiciel, évoluant (si nécessaire) en fonction du déroulement des opérations (cf § Condition).

Exemple

condition condfacture is L10:C20,26 = “FACTURE”

La première condition, nommée condfacture sera considérée comme étant vraie si, la chaîne de caractères “FACTURE” se trouve dans une page de données ligne 10 et colonne 20 et, quelque soit la casse.

L’appel à la condition est possible en indiquant le nom de la condition :

…………

condition condfacture is L10:C20,26 = “FACTURE”

…

…

[condfacture] Put “Montant total” to 100,120 text 1

…………

Syntaxe

[[<ExpBool>]] Break

Paramètres

ExpBool représente une expression booléenne définissant la condition.

Commentaires

• Cette commande permet un arrêt du déroulement de StarPage. Il est ainsi possible, après avoir testé une condition qui serait liée au contenu de vos données ou liée à une variable d’environnement, d’interrompre

purement et simplement le traitement en cours.

Syntaxe

[[<ExpBool>]]Breakspool

Paramètres

ExpBool représente une expression booléenne définissant

la condition.

Commentaires

• Cette commande permet une fermeture immédiate du fichier spool généré par StarPage, associé à la réouverture d’un nouveau fichier. Automatiquement, StarPage régénère l’environnement nécessaire à l’impression correcte du document.
• Cette fonctionnalité peut être particulièrement utile lorsque le traitement est effectué sur un très gros fichier et que l’on souhaite paralléliser l’édition physique en la répartissant sur différentes imprimantes.

Syntaxe

[[<ExpBool>]] Call <Nom_Macro>

Paramètres

ExpBool représente une expression booléenne définissant la condition.

Nom_Macro représente le nom de la macro à appeler.

Commentaires

• Une macro appelée doit avoir précédemment été définie

Exemple

…………

MACRO Calcul_Euro

Set 6.56 to Taux Euro

..

Layout Facture

..

..

Call Calcul_Euro

…………

Syntaxe

[[<ExpBool>]] call-overlay <over>

Paramètres

ExpBool représente une expression booléenne définissant la condition.

over représente un numéro d’overlay tel que défini dans le fichier de commandes de fond de page.

Commentaires

• Cette commande permet, lors de la mise en page des informations, d’appeler dynamiquement un overlay (un ensemble de commandes de fond de page) défini dans le fichier de commandes StarJet (.sjp)
• Un tel appel, contrairement à la commande use-overlay, est purement ponctuel, et peut être déclenché par un test effectué sur les données.

Exemple

…………

condition condfacture is L5:C3,9 = “FACTURE” condition total is L48:C2 = “T”

..

layout fac when condfacture use overlay 1

[total] call-overlay 3

…………

si la chaîne de caractères FACTURE est détectée en ligne 5 colonne 3 à 9, alors l’overlay 1 (fond de page facture) est activé. Si, lors du traitement de cette page, la condition TOTAL est considérée comme vraie (c’est à dire qu’une lettre T est contenue sur la ligne 48, colonne

2) alors le schéma dessiné dans l’Overlay 3 est ajouté sur le fond de page FACTURE.

Commentaires

• Le paramètre linespacing permet de définir, en points PCL l’espace interligne à utiliser pour l’impression des différentes lignes de ce bloc de données.
• La fonction Copy n’est active que pour le layout dans lequel elle a été insérée.

Exemple

…………

copy L10, 12 : C10, 19 to 1000, 200 text 2

linespacing 100

…………

Le bloc de données d’entrée commençant ligne 10 colonne 10, bloc de 10 caractères de long et de 2 lignes de haut (donc jusqu’à la colonne 19, ligne 12) sera copié en 1000:200 (points PCL sur la page) et imprimé en

utilisant la police définie avec le numéro 2, et en laissant entre chaque ligne 100 points PCL.

Syntaxe

[[<ExpBool>]] erase <bloc>

Paramètres

ExpBool représente une expression booléenne définissant la condition.

bloc représente la définition du bloc de données (cf § Bloc de données)

Commentaires

• Cette commande efface ( rend indisponible) toutes les informations contenues dans ce bloc sur la page de données en cours.
• Cette fonction n’est active que pour le layout dans lequel elle a été insérée. Après exécution de ce layout, les données réapparaissent.

Exemple

…………

erase L6,7:C1,132

…………

Le bloc de données situé ligne 6 de la première colonne à la colonne 132 est supprimé.

Syntaxe

[[<ExpBool>]] ExitBlock

Paramètres

ExpBool représente une expression booléenne définissant

la condition.

Commentaires

• Cette commande permet de sortir :
  • d’une boucle FOR
  • d’une boucle WHILE
  • d’un layout de n’importe quel type (page, overlay, compute, ou macro).
• Les instructions IF – ENDIF et SELECT ne sont pas considérées comme des blocs par la commande ExitBlock. Dans ce cas, l’instruction ExitBlock

passe au travers de façon transparente et remonte jusqu’au premier bloc appelant.

Exemple

…………

Layout Tata

…

While ConditionBoucle If ArrêtBoucle

ExitBlock # sort de la boucle EndIf

EndWhile

…………

Syntaxe

[[<ExpBool>]] move <bloc> to <x>, <y> [text <t>]

[rotate <angle>] [gray <shade>] [density <d>] [linespacing <ls>]

Paramètres

ExpBool représente une expression booléenne permettant de définir une condition.

bloc représente la définition du bloc de données (cf § Bloc de données)

1. représente le point sur l’axe des X PCL ou doit commencer l’ajout de chaîne de caractères
2. représente le point sur l’axe des Y PCL ou doit commencer l’ajout de chaîne de caractères

t représente la police à utiliser pour imprimer le bloc angle représente l’angle de rotation du bloc (valeurs possibles : 0, 90, 180, 270)

shade représente le niveau de grisé à utiliser lors de l’impression

d représente la densité à utiliser pour imprimer le bloc

ls représente l’espacement interligne, exprimé en points

PCL, pour ce bloc

Commentaires

• Cette commande exécute deux actions à la fois :
• Elle définit, sur la matrice d’entrée représentée par la page de données, un bloc d’information à déplacer
• Elle définit le mode d’impression de ce bloc.
• Le positionnement exprimé en points PCL correspond au coin inférieur gauche du premier caractère imprimé. Ce bloc est déplacé vers l’adresse indiquée sur la page.
• Le numéro de police indiqué dans la commande text permet de définir la police de caractères à utiliser pour imprimer ce bloc. Ce numéro est celui défini dans le fichier de commandes StarJet (.sjp).
• Le paramètre density permet de définir la densité avec laquelle ce bloc sera imprimé. Ce paramètre est exprimé en nombre de caractères par pouces et n’est utilisable qu’avec des polices de caractères à espacement fixe.

• Le paramètre linespacing permet de définir, en points PCL l’espace interligne à utiliser pour

l’impression des différentes lignes de ce bloc de données.

Exemple

…………

move L2,5:C10,40 to 1800,600 text 2

linespacing 100

…………

Le bloc de données d’entrée commençant colonne 10 ligne 2, bloc de 30 caractères de long et de 3 lignes de haut (donc jusqu’à la colonne 40 et la ligne 5) sera déplacé en 1800:600 (points PCL sur la page), imprimé en utilisant la police définie avec le numéro 2, et en laissant entre chaque ligne

100 points PCL.

Syntaxe

[[<ExpBool>]] Bar_PDF417 (<Exp1 ; Exp2 ; … ; Expn>) to<x>, <y>

text <n> UnitHeight <h> UnitWidth <w> [ErrorLevel <e>] [Rows <r>]

[Cols <c>] [AspectRatioVert <av>] [AspectRatioHor <ah>]

[Truncate]

Paramètres

ExpBool représente une expression booléenne permettant de définir une condition.

(<Exp1 ; Exp2 ; … ; Expn>) représente une liste d’expressions StarPage (pouvant être réduite à une seule expression).

x,y représentent les coordonnées du coin supérieur gauche du symbole PDF417 (si Rotate = 0).

UnitHeight représente la hauteur des lignes du symbole, celle-ci étant spécifiée dans la police (plusieurs hauteurs peuvent être présentes dans le fichier de police).

UnitWidth représente la largeur de l’unité barre, celle-ci étant spécifiée dans la police.

ErrorLevel représente le niveau de sécurité pour la reconstruction du texte en cas de dégradation du symbole. Ce paramètre est optionnel. Il varie de 0 à 8 et conditionne le nombre de mots-code de correction d’erreur générés dans le symbole. Plus ce niveau est élevé, plus le symbole va être volumineux. Par défaut, cette valeur est 0.

Rows représente le nombre de lignes du symbole. Il doit être compris entre 3 et 90.

Cols représente le nombre de colonnes de données du symbole. Il doit être compris entre 1 et 30.

AspectRatioVert et AspectRatioHor représentent l’aspect du symbole dans ses proportions entre sa hauteur et sa largeur, ce qui joue sur le nombre de lignes et de colonnes.

Ces deux paramètres doivent être présents ensemble. Chacun doit être compris entre 1 et 10. Par défaut leur valeur sont 1 et 2 (ratio 1:2).

 la spécification d’un paramètre Rows ou d’un paramètre Cols prime sur la spécification du paramètre Aspect.

Truncate produit un symbole PDF417 Tronqué. Compatible avec le PDF417 standard, il permet de réduire

le symbole par l’omission de certains mots-code, tel le stop pattern.

…………

Bar_PDF417 (“APPIC”) To 472, 693 Text 6

UnitHeight 24 UnitWidth 3

…………

Exemple

…………

Bar_PDF417(“STARTPOS”;”132534″;”91240″;”0015

0″;”O”;”0000015000″;”0000021000″;”N”;”APPIC

SA form management”;”France”;”APPIC invoice

number”; “ENDPOS”) To 1313, 1226 Text 6

UnitHeight 12 UnitWidth 3 AspectRatioVert 3

AspectRatioHor 1

…………

Messages d’erreur

Messages d’erreurs susceptibles d’être générés par une commande incorrecte

Messages

Causes

error level already defined

ErrorLevel est spécifié

plusieurs fois

invalid error level

ErrorLevel a été spécifié avec

une valeur qui n’est pas comprise entre 0 et 8

rows already defined

Rows est spécifié plusieurs fois

invalid rows number

Rows est spécifié avec une

valeur qui n’est pas comprise entre 3 et 90

data columns already defined

Cols est spécifié plusieurs fois

invalid data columns number

Cols est spécifié avec une valeur

qui n’est pas comprise entre 1 et 30

aspect ratio vertical

already defined

AspectRatioVert est

spécifié plusieurs fois

invalid aspect ratio vertical

AspectRatioVert est

spécifié avec une valeur qui n’est pas comprise entre 1 et 10

aspect ratio horizontal already

defined

AspectRatioHor est spécifié plusieurs fois

invalid aspect ratio horizontal

AspectRatioHor est spécifié

avec une valeur qui n’est pas comprise entre 1 et 10

invalid aspect ratio

AspectRatioVert est défini alors que AspectRatioHor

n’est pas défini, ou l’inverse

truncate already

defined

Truncate est spécifié plusieurs

fois

unit width already defined

UnitWidth est spécifié

plusieurs fois

missing unit width

UnitWidth n’est pas spécifié

alors que ce paramètre est obligatoire

unit height already

defined

UnitHeight est spécifié

plusieurs fois

missing unit height,

UnitHeight n’est pas spécifié

alors que ce paramètre est obligatoire

Messages d’erreur

Messages d’erreurs susceptibles d’être générés par un problème de codage

Messages

Causes

PDF417 error: invalid character in string

Un caractère du texte n’est pas reconnu par l’algorithme d’encodage.

PDF417 error: incorrect rows number

<n>

Le nombre de lignes est en dehors des limites 3-90.

PDF417 error: incorrect columns number <n>

Le nombre de colonnes est en dehors des limites 1-30.

PDF417 error: not

enough rows <n> or columns <n>

Le symbole n’a pas assez de lignes ou de colonnes pour coder tout le texte. Le texte est trop grand.

PDF417 error: too many characters to

code

Le texte est trop volumineux pour tout coder.

Syntaxe

[[<ExpBool>]] Bar_DataMatrix (<Exp1 ; Exp2 ;

… ; Expn>) to <x>, <y>

text <n> [ModuleWidth <w>] [Rows <r> Cols <c>]

Paramètres

ExpBool représente une expression booléenne permettant de définir une condition.

(<Exp1 ; Exp2 ; … ; Expn>) représente une liste d’expressions StarPage (pouvant être réduite à une seule expression).

 Dans le résultat lu, les différentes expressions sont séparées par un carriage return (code ASCII 13).

Les expressions acceptées par la commande Bar_DataMatrix peuvent représenter des chaînes de caractères standard, des séquences de nombres hexadécimaux ou, des séquences de nombres décimaux. Dans les deux derniers cas, ces séquences représentent des valeurs de codes ASCII. Cependant, pour différencier le mode d’interprétation de l’expression, il est nécessaire de préfixer la chaîne par une séquence spéciale :

• pas de préfixe signifie une chaîne standard ;
• un préfixe ‘0x’ signifie une séquence de nombres hexadécimaux, chaque nombre hexadécimal étant constitué de deux chiffres ;
• un préfixe ‘0d’ signifie une séquence de nombres décimaux, chaque nombre décimal étant constitué de trois chiffres.

x,y représentent les coordonnées du coin supérieur gauche du symbole DataMatrix.

ModuleWidth est une valeur entière représentant la taille de chaque module. Par défaut, la taille du module est de 6 (environ 20 millièmes de pouce) et les valeurs acceptés sont de 3 à 12.

Rows est une valeur entière qui représente le nombre de lignes du symbole.

Cols est une valeur entière qui représente le nombre de colonnes du symbole.

Par défaut, le nombre de modules par ligne et par colonne est déterminé automatiquement pour avoir le plus petit symbole carré possible.

Exemple

…………

Bar_DataMatrix (L8:C1,60) To 1335, 256 Text

5 ModuleWidth 5 Rows 26 Cols 26

…………

Messages d’erreur

Messages d’erreurs susceptibles d’être générés par une commande incorrecte

Messages

Causes

rows already defined

Rows est spécifié plusieurs fois.

data columns already

defined

Cols est spécifié plusieurs fois

unit width already

defined

ModuleWidth est spécifié plusieurs fois

Messages d’erreurs susceptibles d’être générés par un problème de codage

Messages

Causes

DataMatrix : encoding error

Le processus d’encodage des données a échoué

DataMatrix : correction code generation problem

Le processus de génération de codes de correction d’erreur a échoué

Syntaxe

[[<ExpBool>]] put <expression string> to

<x>,<y>

[(Justify or AlignLeft or AlignRight or

Center)] [Width <w>]

[(MaxLinesCount or MaxHeight or

MaxClipY)<cstr>] [text <t>] [LineSpacing <ls>] [rotate <angle>] [gray <shade>] [density <d>]

Paramètres

ExpBool représente une expression booléenne permettant de définir la condition.

expression string représente la chaîne de caractères ou le résultat d’un traitement à ajouter lors de l’impression (cf Chapitre Expression String)

1. représente le point sur l’axe des X PCL ou doit commencer l’ajout de la chaîne de caractères ou du résultat de traitement.
2. représente le point sur l’axe des Y PCL ou doit commencer l’ajout de la chaîne de caractères ou du résultat de traitement.

Justify est le mot-clé utilisé pour justifier (aligner à droite et à gauche) l’expression string c’est à dire que toutes les lignes, sauf la dernière, ont la même longueur.

AlignLeft est le mot-clé utilisé pour aligner à gauche l’expression string c’est à dire que toutes les lignes démarrent à la même coordonnée X.

AlignRight est le mot-clé utilisé pour aligner à droite l’expression string c’est à dire que toutes les lignes finissent à la même coordonnée X.

Center est le mot-clé utilisé pour centrer l’expression string c’est à dire que le milieu de toutes les lignes est placé sur la même coordonnée X.

Width est la largeur du paragraphe exprimé en points PCL.

Exemple 1

…………

Put L1:C10, 20 To 10, 20 Text 1

…………

…………

Put “Il y a” + DataLinesNumber + “lignes sur cette page” To 100, 200 Text 7 Density 9

…………

La chaîne de caractères “Il y a (nombre de lignes de données dans la page (cf § Variable prédéfinie) lignes sur cette page” sera copiée en 100:200 et imprimée en utilisant la police définie avec le numéro 7 et une densité de 9 caractères par pouce.

…………

Put “Anciennement Raguse, avec son histoire vénitienne puis turque, Dubrovnik est une ville et un port de Croatie sur l’Adriatique. Elle fut fondée au VIIème siècle par des Grecs d’Épidaure fuyant les invasions slaves et avares.” To 500, 500 Justify Width 900 Text 4 LineSpacing 50

…………

…………

Put “Anciennement Raguse, avec son histoire vénitienne puis turque, Dubrovnik est une ville et un port de Croatie sur l’Adriatique. Elle fut fondée au VIIème siècle par des Grecs d’Épidaure fuyant les invasions slaves et avares.” To 500, 500 Justify Width 900 MaxLinesCount 3 Text 4

LineSpacing 50

…………

La chaîne de caractères sera justifiée et copiée en 500:500 sur une largeur de 900 points PCL puis, imprimée en utilisant la police définie avec le numéro 4. L’espace entre les lignes est de 50 points PCL et le nombre maximum de lignes du paragraphe est de 3.

Exemple 2

…………

Value parag Is Var Value y Is Var

…………

Set “Support Services. If this product was received as part of a \”bundle\” with an other software or hardware manufacturer’s product, end-users are required to contact that manufacturer for first level support.” to parag

Set 500 to y

…………

Put @parag To 1300, @y Justify Width 450 MaxLinesCount 2 Text 4 LineSpacing 40

Put @parag To 1750, @y Justify Width 450 MaxHeight 100 Text 4 LineSpacing 40

Put @parag To 1300, @y Justify Width 450 MaxClipY 800 Text 4 LineSpacing 40

Put @parag To 1750, @y Justify Width 450 Text 4 LineSpacing 40

…………

Après chaque commande Put, l’expression string contient la partie non affichée du paragraphe. Après chaque commande Put, y contient la coordonnée immédiatement sous la partie du paragraphe affichée.

Syntaxe 1 : paragraphe total

[[<ExpBool>]] GetParagraphInfo <expression string> ResLinesCount <rlc> ResHeight <rh> [(Justify or AlignLeft or AlignRight or Center)]

[Width <w>] [text <t>]

[LineSpacing <ls>]

Syntaxe 2 : paragraphe “découpé”

[[<ExpBool>]] GetParagraphInfo <expression string> ResBeginning <rb> ResEnd <re> [(Justify or AlignLeft or AlignRight or Center)]

[Width <w>]

[(MaxLinesCount or MaxHeight) <cstr>] [text <t>]

[LineSpacing <ls>]

Paramètres

ExpBool représente une expression booléenne permettant de définir la condition.

expression string représente la chaîne de caractères ou le résultat d’un traitement à ajouter lors de l’impression (cf Chapitre Expression String)

rlc représente le nombre de lignes résultant du paragraphe.

rh représente la hauteur résultante du paragraphe.

rb représente le début du paragraphe si celui-ci est “découpé”.

re représente la seconde partie du paragraphe si celui-ci est “découpé”.

cstr représente une contrainte de scission du paragraphe (nombre de lignes maximum du paragraphe exprimé en points si précédé de MaxLinesCount, hauteur maximale du paragraphe exprimée en points PCL si précédé de MaxHeight).

Justify est le mot-clé utilisé pour justifier (aligner à droite et à gauche) l’expression string c’est à dire que toutes les lignes, sauf la dernière, ont la même longueur.

AlignLeft est le mot-clé utilisé pour aligner à gauche l’expression string c’est à dire que toutes les lignes démarrent à la même coordonnée X.

AlignRight est le mot-clé utilisé pour aligner à droite

l’expression string c’est à dire que toutes les lignes finissent à la même coordonnée X.

Center est le mot-clé utilisé pour centrer l’expression string c’est à dire que le milieu de toutes les lignes est placé sur la même coordonnée X.

Width est la largeur du paragraphe exprimé en points PCL.

t représente la police à utiliser pour imprimer la ligne.

ls représente l’espacement entre deux lignes, exprimé en points PCL.

Exemple 1

…………

GetParagraphInfo parag ResLinesCount rlc ResHeight rh Justify Width 537 Text 4 LineSpacing 35

Put “LinesCount = ” + rlc To 150, 891 Text 1 Put “Height = ” + rh To 150, 978 Text 1

…………

Le résultat est affiché ci-dessous :

LinesCount = 8

Height = 280

Exemple 2

S’il y a un découpage :

…………

Value pbegin Is Var Value pend Is Var

…………

GetParagraphInfo parag ResBeginning pbegin ResEnd pend Justify Width 537 MaxLinesCount

1. Text 4 LineSpacing 35

Put “pbegin =” To 147, 1269 Text 1

Put pbegin To 267, 1363 Justify Width 537

MaxLinesCount 3 Text 4 LineSpacing 35

Put “pend =” To 137, 1681 Text 1

Put pend To 257, 1775 Justify Width 537 Text

1. LineSpacing 35

…………

Le résultat est affiché ci-dessous :

Syntaxe

[[<ExpBool>]] Set <expression> to <variable>

[[indice]]

Paramètres

ExpBool représente une expression booléenne permettant de définir la condition.

variable représente le nom de la variable dans laquelle le résultat doit être stocké

indice est une constante ou une expression

Commentaires

• Cette commande permet d’évaluer l’expression et d’en affecter le résultat dans la variable indiquée.
• expression peut être n’importe quelle suite d’opérations se conformant aux syntaxes (cf Chapitre Expression String et Chapitre Expression Booléenne)
• La variable doit être préalablement définie par une commande value.

Exemple

…………

Value Line_Nr Is Var Value Line_Start Is Var

…

…

Set “3” to Line_Start Set Line_Start to Line_Nr

…………

De plus, la commande Set permet d’affecter une valeur à un élément du tableau si la variable est un identifiant du tableau dont l’indice est entre crochets [ ].

Value Exemple Is Array [1–10]

Set “toto” to Exemple[5]

Syntaxe

FOR variable = <init> TO <end> STEP <val- step>

…

ENDFOR

Paramètres

variable représente le nom de la variable qui doit être utilisée pour contrôler la boucle FOR

init représente une valeur ou expression initiale à affecter à la variable

end représente une valeur ou expression qui définit la fin de l’exécution de cette boucle

val-step représente une valeur d’incrémentation du pas à appliquer pour chaque For

ENDFOR est un mot-clef représentant la fin du bloc d’instructions

Commentaires

• Cette commande permet d’effectuer toutes les instructions situées entre For et Endfor tant que la variable indiquée n’est pas égale à la valeur ou à l’expression définie comme end.
• La valeur de la variable évoluera conformément à la valeur indiquée derrière le mot-clef STEP.

Exemple

…………

Value nb_lig Is Var

..

FOR nb_lig = 29 TO 56 STEP 1

Put L(nb_lig):C(2,40) To 30, 1500 %+

(nb_lig %- 29) %* 48 Text 11 Density 10 ENDFOR

…………

Syntaxe

WHILE <expression booléenne>

…

ENDWHILE

Paramètres

expression booléenne représente une expression renvoyant une valeur vraie ou fausse.

ENDWHILE est un mot-clef représentant la fin du bloc d’instructions

Commentaires

• Cette commande permet d’effectuer toutes les instructions situées entre While et EndWhile tant que

l’expression booléenne est vraie.

Exemple

…………

Value Libelle_banniere Is Zone L2:C1,200 Page 1

..

WHILE NOT BLANK(Libelle_banniere)

Put Cut( Libelle_banniere, 80) To 200,

1580 %+ (Ordonnee %- 1) %* 90 Text 7 Set Ordonnee %+ 1 to Ordonnee

ENDWHILE

…………

Syntaxe

IF <expression booléenne>

…

ELSE

…

ENDIF

Paramètres

expression booléenne représente une expression dont l’évaluation doit envoyer une valeur vraie afin que les commandes suivantes soient évaluées.

ENDIF est un mot-clef représentant la fin du bloc

d’instructions

Commentaires

• Si la condition indiquée dans le IF est vérifiée, les instructions qui suivent sont exécutées.
• En cas de présence d’un ELSE associé, les instructions suivant le ELSE seront exécutées si l’expression n’est pas vérifiée.

Exemple

…………

Condition Der_Page is L23:C72,73 =L23:C76,77

..

IF Der_Page

Call Overlay 2

Copy L63,63:C56,68 To 230, 3300 Text 10

Density 10

Put Format( L64:C34,38, “#0,0”) To 730,

3300 Text 10 Density 10

Copy L64,64:C56,68 To 960, 3300 Text 10

Density 10

Copy L65,65:C56,68 To 1440, 3300 Text

11 Density 10

Put L65:C56,68 %/ EURO To 2050, 3300

Text 11 Density 10

ELSE

Call Overlay 3

Put REPORT To 1760, 3250 Text 11

Density 10 ENDIF

…………

Syntaxe

SELECT CASE <expression string>

CASE <val1> :

…

CASE <val2>;<val3> :

…

CASE ELSE

…

ENDSELECT

Paramètres

Expression string représente une expression devant être comparée aux différents cas envisagés.

val1, val2, val3 représente des valeurs qui devront être comparées à expression string.

ELSE est un mot-clef demandant l’exécution d’instruction précises si aucune correspondance n’a été trouvée.

ENDCASE est un mot-clef représentant la fin du bloc d’instructions

Commentaires

• Cette instruction permet, pour une information donnée et définie par expression string, de définir l’exécution que l’on veut voir appliquer selon son contenu. expression string est une expression de type chaîne de caractères (cf Chapitre Expression String).
• Si aucune adéquation n’est trouvée, il est possible de demander l’application d’une instruction différente (ou un bloc d’instructions) par l’utilisation d’un CASE ELSE.

Exemple

…………

Value SOCIETE Is Zone L1:C1,6

..

SELECT CASE SOCIETE CASE “CENTAU”:

Put “!” To 1920, 382 Text 18

Put “CENTAURE” To 1780, 480 Text 15 CASE “AKWABA”:

Put “!” To 1920, 292 Text 6

Put “AKWABA” To 1830, 480 Text 15 CASE ELSE

ENDSELECT

…………

Syntaxe

Macro <Nom_Macro> [Printable]

<instruction1> [<instruction2>]

…

[when <ExpBool>]

…

Paramètres

Nom_Macro représente le nom définissant la macro Instruction1 et instruction2 représentent les commandes constituant la macro.

ExpBool représente une expression booléenne définissant la condition

Commentaires

• Une macro appelée doit précédemment être définie.
• Les macros non imprimables présentent la possibilité de faire appel à d’autres macros du même type.
• Les macros imprimables présentent la possibilité de faire appel à toutes les macros, quel que soit leur type.

Exemple

…………

Macro Calcul_Euro Set 6.56 to Taux Euro

..

Macro imprime_Adresse Printable Put FieldAdresse1 to 100, 200

Put FieldAdresse2 to 100, 250

..

..

..

Call Calcul_Euro

…………

Syntaxe

Layout <nom> [with <Id> [RESTORE]

INCREASE|DECREASE <borne>[step <pas>]]

[when <ExpBool>]

Paramètres

Layout est le mot-clé permettant de définir la page

nom est le nom affecté à ce layout

Id est le nom de variable utilisée pour la boucle

borne représente une borne inférieure (si en décrément) ou supérieure (si en incrément) à atteindre

pas représente la valeur de l’incrément ou du décrément de

Id

ExpBool représente une expression booléenne définissant la condition

Commentaires

• La commande Layout donne à l’utilisateur la possibilité d’affecter un nom à un nouveau layout de type page. Le mot-clé Layout doit impérativement être suivi par un nom unique. Seule une autre commande Layout, Overlay, Compute ou la fin du fichier met fin au layout dont la description commence par cette commande.
• Il est possible de conditionner un layout en utilisant une expression booléenne.
• Il est également possible de demander une exécution répétée de ce layout, notamment, pour permettre l’édition d’étiquettes. Ainsi, après chaque exécution du layout, la valeur Step sera ajoutée (présence du mot clef Increase)ou soustraite (présence du mot clef Decrease) à la variable set et ce, jusqu’à ce que la valeur indiquée comme borne soit atteinte. La valeur Step affecte donc le nombre d’itérations.
• Le mot clef Restore demande à ce que la valeur initiale de la variable soit initialisée après traitement de ce layout. Pendant l’exécution de ce layout, la variable StepNumber est disponible pour déterminer quel est le numéro de l’exécution en cours. Si la valeur borne est

égale à 0, le layout n’est pas exécuté. Si le Step n’est pas indiqué, sa valeur par défaut est de 1.

Exemple

…………

Value LoopVar Is Var “0”

..

Layout My_Layout With LoopVar RESTORE INCREASE “2”

..

..

..

…………

…………

Layout BANNIERE When SourcePageNumber %= 1

..

..

..

…………

Syntaxe

Overlay <num> [when <ExpBool>]

Paramètres

num représente le numéro de l’overlay généré

ExpBool représente une expression booléenne définissant la condition

Commentaires

• Au sein d’une telle structure, l’utilisation de la commande Use-Overlay est interdite.

Exemple

…………

# Définition des conditions

Condition cas1 is L2:C3, 9 = “FACTURE”

..

# Définition d’un Overlay Overlay 25 when cas1 Portrait A4

Move L1,5 : C10,100 to 100 300 text 2

..

# Définition d’un Layout Layout FACT when TRUE Use overlay 1

Call overlay 25

Move L6,60 : C1,132 to 100 800 text 3

…………

Si la zone commençant en ligne 2, colonne 3 contient la chaîne de caractères “FACTURE”, le layout type Overlay

25 est créé. Il est orienté en portrait et contient les informations contenues ligne 1 à 5, de la colonne 10 à la colonne 100. Dans tous les cas (c’est à dire pour toutes les pages de données), le Layout FACT sera appliqué.

Syntaxe

compute <nom> [with <Id> [RESTORE]

INCREASE|DECREASE <borne>[step <pas>]]

[when ExpBool>]

Paramètres

nom représente le nom affecté au layout de type compute

ExpBool représente une expression booléenne définissant la condition

Commentaires

• Il est également possible de demander une exécution répétée de ce compute. Ainsi, après chaque exécution du layout, la valeur Step sera ajoutée (présence du mot clef Increase) ou soustraite (présence du mot clef Decrease) à la variable set et ce, jusqu’à ce que la valeur indiquée comme borne soit atteinte. La valeur Step affecte donc le nombre d’itérations.
• Le mot clef Restore demande à ce que la valeur initiale de la variable soit initialisée après traitement de ce layout. Pendant l’exécution de ce layout, la variable StepNumber est disponible pour déterminer quel est le numéro de l’exécution en cours. Si la valeur borne est égale à 0, le layout n’est pas exécuté. Si le Step n’est pas indiqué, sa valeur par défaut est de 1.
• Toutes les “commandes d’impression” sont refusées et génèrent une erreur de syntaxe. Dans un tel layout, il n’est possible d’utiliser que les commandes Set, Call

macro, Break et Breakspool.

Exemple

…………

# Définition de la variable chaîne Value info is VAR

# Définition des conditions

Condition cas1 is L2:C3, 9 = “FACTURE”

# Définition d’une structure Compute Compute c_cas1 when cas1 #Affectation d’une valeur à info Set L2:C10,18 to info

# Définition d’un Layout Layout FACT when TRUE Use overlay 1

# Impression du contenu de la variable info Put info to 50 800 text 1

Move L6,60 : C1,132 to 100 800 text 3

…………

Si la zone commençant en ligne 2, colonne 3 contient la chaîne de caractères “FACTURE”, le traitement compute est effectué. Ce traitement affecte à la variable info la chaîne de caractères contenue dans la page de donnée (ligne 2 colonne 10 à 18). A l’issue de ce traitement de type compute, la page de données n’est pas considérée comme traitée. Elle reste donc disponible pour

l’exécution d’un Layout ultérieur.

%+

Addition

%-

Soustraction

%*

Multiplication

%/

Division

%mod

Modulo

%div

Division entière

%%mod

Modulo pour très

grand nombre (>=2 147 483 648)

%%div

Division entière pour

très grand nombre

(>=2 147 483 648)

+

Concaténation

%=

Egalité

%<

Inférieur

%<=

Inférieur ou égal

%>

Supérieur

%>=

Supérieur ou égal

%<>

Différent de

=

Egalité

<

Inférieur

<=

Inférieur ou égal

>

Supérieur

>=

Supérieur ou égal

<>

Différent de

Syntaxe

blank (<expression string, len>)

Syntaxe

<expression string 1> in (<expression string 2>)

Nom

EAN 13

Type de données codées

Conditions sur les données

Numérique : 13 chiffres (0…9)

Le premier chiffre est appelée “code pays”.

Propriétés

Longueur fixe, bidirectionnel

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Fonctions :

• BAR_EAN13(DATA [ , start, middle, end, first1, first2, first3 ])
• BAR_EAN13HR(DATA [ , start, middle, end, first1, first2, first3 ])

Paramètres :

• DATA : Toute expression string supportée par StarPage et répondant aux exigences du code à barres EAN13 .
• Start, Middle, End, First1, First2, First3 : voir le paragraphe “Remarques avancées”.

Remarques :

Différences entre la fonction standard et la version “HR”: le code pays est ajouté sous une forme “lisible”.

Polices requises

BAR_EAN13 : police ean13.sfp police EA040rrp.sfp

police Ean8-13_20mm.sfp police Ean8-13rrp_20mm.sfp

BAR_EAN13HR : police EAN13hr.sfp

Exemple d’utilisation

Ean13

Dans le fichier sjp :

/Char 3 ean13.sfp

Dans le fichier sp :

Put Bar_EAN13(“0051111428177”) To 363,

303 Text 3

Ean13Hr

Dans le fichier sjp :

/Char 5 EAN13hr.sfp

Dans le fichier sp :

Put Bar_Ean13Hr(“0051111428177”) To 363,

711 Text 5

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas.

Remarques avancées

Le code à barres EAN13 est un codage de 13 chiffres, chaque chiffre étant représenté par un symbole (barre(s) et espace(s)) d’un jeu de nombres donné.

L’EAN13 comprend 3 jeux de nombres (A, B et C) correspondant aux paramètres first1, first2 et first3. De plus, il y a 3 motifs ajoutés au symbole final : caractère de début (start), caractère de contrôle au milieu (middle) et caractère de fin (end). Les 6 premiers chiffres sont codés dans les jeux de nombres A ou B alors que les 6 derniers chiffres sont codés dans le jeu de nombres C.

Le 13^ème chiffre, le code pays, est déduit d’après le masque des 6 premiers chiffres.

Nom

Code 39

Type de données codées

Alpha-Numérique, (A-Z, 0-9, espace, $%+-./)

Propriétés

bidirectionnel, discret⁽¹), longueur variable

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Fonctions :

– BAR_3of9(DATA)

Paramètres :

DATA : chaîne à coder.

Polices requises

BAR_3of9 : police B3906rrp.sfp

police B3908rrp.sfp police B3912rrp.sfp police B3915rrp.sfp police B3929rrp.sfp police B3930rrp.sfp police B3931rrp.sfp

Exemple d’utilisation

Dans le fichier sjp :

/Char 3 B3906rrp.sfp

Dans le fichier sp :

Put Bar_3of9(“396011720561697563257”) To

363, 303 Text 3

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Remarques avancées

Chaque code barre est constitué d’un nombre quelconque de caractères, appelés digits. Chaque digit est représenté par un total de 5 barres (noires) et 4 espaces (blancs). Chacun de ces neuf éléments est appelé un module. Un digit est toujours représenté par 6 modules étroits et 3 modules larges, d’où le nom du code (3 sur 9). Chaque digit est séparé du suivant par un espace étroit.

Le code 39 peut ainsi représenter 44 caractères, les chiffres, les lettres majuscules et les symboles suivants ($ % + – . / ). Un code 39 débute toujours par le caractère astérisque (automatiquement généré par StarPage) et finit de la même manière, ce caractère particulier est appelé caractère d’arrêt et ne doit pas être utilisé ailleurs qu’au début et à la fin du code. L’utilisation du caractère de contrôle (C) est

facultative.

Nom

Code 128

Type de données codées

Alphanumérique : la table ASCII (c’est à dire 128 caractères)

Propriétés

Longueur variable, Auto contrôlé, continu⁽¹⁾, bidirectionnel

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Fonctions :

– BAR_CODE128(DATA [offset, EndCode1, EndCode2])

Paramètres :

• DATA : chaîne à coder.
• offset, EndCode1, EndCode2 : voir le paragraphe “Remarques avancées”.

Polices requises

BAR_CODE128 : police B128_46.sfp

police B128_66.sfp police B1282rp.sfp police B1286rp.sfp police B12811rp.sfp police B12816rp.sfp police BA128RXP50.sfp police BA128RXP75.sfp police BA12RXP_25.sfp

police BA128RZP.sfp

Exemple d’utilisation

Dans le fichier sjp :

/Char 3 B128_46.sfp

Dans le fichier sp :

Put Bar_CODE128(“3960117205”) To 363, 303

Text 3

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Remarques avancées

Le code 128 est un codage de la table ASCII. Il y a 3 motifs ajoutés au symbole final :

• Le caractère de début (start) est modulé par un paramètre de décalage (offset) dont la valeur par défaut dans StarPage est 32. Cependant, cette valeur est paramétrable car elle peut varier selon les polices utilisées.
• Le caractère de contrôle (C) généré par StarPage
• Le caractère de fin (EndCode1)ainsi qu’un second caractère si nécessaire.

Remarques avancées

Le code 128 comprend 3 jeux de caractères et la sélection d’un de ceux-ci dépend du caractère de début. De plus, des caractères auxiliaires permettent, en cours de symbole, de passer d’un jeu à un autre. Notamment pour les données purement numériques, le jeu C permet d’utiliser le code 128 en double densité. Chaque caractère est composé de 3 barres et 3 espaces (4 et 3 pour le caractère de début/Fin). Les barres

représentent toujours un nombre pair de modules et les espaces un nombre impair.

Nom

Code 128

Type de données codées

Alphanumérique : la table ASCII (c’est à dire 128 caractères)

Propriétés

Longueur variable, Auto contrôlé, continu⁽¹⁾, bidirectionnel

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Fonctions :

extern_Func(“Code128;A;1600,140;0;2;” +

VAR128, “sjgraph.dll”, “sjg_barcode”) to graphname

Le code128 comprend 3 “jeux de caractères” A, B ou C, qui sera précisée juste après le type de code.

Le paramètre suivant est la taille (rectangle) du code à générer en 10eme de millimètre (largeur,hauteur).

Le troisième paramètre représente l’orientation: 0, 90, 180 ou 270

Le dernier paramètre « 2 » signifie que l’on génère un fichier tif (qui sera inséré ensuite par un /Picture).

Remarques avancées

Le code 128 est un codage de la table ASCII. Il y a 3 motifs ajoutés au symbole final :

• Le caractère de début (start) est modulé par un paramètre de décalage (offset) dont la valeur par défaut dans StarPage est 32. Cependant, cette valeur est paramétrable car elle peut varier selon les polices utilisées.
• Le caractère de contrôle (C) généré par StarPage
• Le caractère de fin (EndCode1)ainsi qu’un second caractère si nécessaire.

Remarques avancées

Le code 128 comprend 3 jeux de caractères et la sélection d’un de ceux-ci dépend du caractère de début. De plus, des caractères auxiliaires permettent, en cours de symbole, de passer d’un jeu à un autre. Notamment pour les données purement numériques, le jeu C permet d’utiliser le code 128 en double densité. Chaque caractère est composé de 3 barres et 3 espaces (4 et 3 pour le caractère de début/Fin). Les barres

représentent toujours un nombre pair de modules et les espaces un nombre impair.

Nom

EAN 128

Type de données codées

Alphanumérique : la table ASCII (c’est à dire 128 caractères).

Propriétés

Longueur variable, Auto contrôlé, continu⁽¹⁾, bidirectionnel

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Fonctions :

– BAR_Ean128(DATA [offset, EndCode1, EndCode2])

Paramètres :

• DATA : chaîne à coder.
• offset, EndCode1, EndCode2 : voir le Code 128

Polices requises

BAR_Ean128 : police B12811rp.sfp

police B12815rp.sfp police B12816rp.sfp police B12824rp.sfp police BA128rxp.sfp police BA128rzp.sfp

Exemple d’utilisation

Dans le fichier sjp :

/Char 3 B12811rp.sfp

Dans le fichier sp :

Put Bar_Ean128(“3960117205”) To 363, 303

Text 3

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Remarques avancées

Il a les mêmes propriétés que le Code 128.

De plus, l’Ean 128 comprend un caractère fonction (F1) permettant de reconnaître les applications standardisées EAN d’éventuelles utilisations particulières du code 128. L’identifiant de données (AI) définit la nature et parfois la longueur et structure des données qui suivent. Les AI sont utilisés pour

coder l’identification des produits. Ces paramètres sont automatiquement générés par StarPage.

D

F1

AI

Donnée

(F1)

AI

Donnée

C

F

Nom

Code 2 parmi 5

Type de données codées

Numérique (0-9)

Propriétés

longueur variable, bidirectionnel

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Fonctions :

– BAR_2of5(DATA)

– BAR_2of5p(DATA,weight,start,end)

Paramètres :

• DATA : chaîne à coder.
• offset, EndCode1, EndCode2 : voir le Chapitre “Remarques avancées”

Polices requises

BAR_2of5p : police 25int_16.sfp

police 25int_18.sfp police 25int_20.sfp police 25int_22.sfp police 25intX18.sfp police B2510rrp.sfp police B2530rrp.sfp

Exemple d’utilisation

Dans le fichier sjp :

/Char 3 25int_16.sfp

Dans le fichier sp :

Put Bar_2of5p(“39601172056169756325”,40,’#’,

‘$’) To 363, 303 Text 3

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Remarques avancées

Le codage de chaque caractère comprend 2 modules larges sur 5 d’ou le nom Code 2 parmi 5.

• Le caractère de début (start) peut être un nombre ou un caractère. Sa valeur par défaut est “(” mais, peut être différente pour certaines polices d’ou son caractère paramétrable.
• Le caractère de fin (end) peut être un nombre ou un caractère. Sa valeur par défaut est “)” mais, peut être différente pour certaines polices d’ou son caractère paramétrable.
• Les données peuvent être modulés par un paramètre de décalage (weight) dont la valeur par défaut dans

StarPage est 129. Cette valeur est paramétrable car elle peut varier selon les polices.

Nom

PDF417

Type de données codées

les tables ASCII et ISO

Propriétés

Bidimensionnel, encode plus de1100 bytes, 1800 caractères ASCII ou 2700 caractères numériques

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Cf § Les instructions et commandes de contrôle / Bar_PDF147

Polices requises

police pdfw3.417

Exemple d’utilisation

Dans le fichier sjp :

/Char 6 pdfw3.417

Dans le fichier sp :

Bar_PDF417 (“APPIC”) To 472, 693 Text 6

UnitHeight 24 UnitWidth 3

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Remarques avancées

PDF signifie Portable Data File (=fichier de données portable).

Chaque symbole PDF417 est constitué d’un ensemble de lignes (de 3 à 90) et chaque ligne contient un motif de début (start pattern), un indicateur gauche de ligne, un indicateur droit de ligne, un motif de fin (stop pattern), et de 1 à 30 mots-code (ou symboles de données).

Un mot-code consiste en 4 barres et 4 espaces mesurant 17 modules.

Le nombre de lignes est variable ainsi que leur hauteur. Le ratio hauteur/largeur d’un symbole PDF417 peut être modifié, notamment pour les besoins de l’impression. Cependant, le nombre de mots-code doit être le même dans toutes les lignes d’un symbole PDF417 donné.

De plus, chaque symbole PDF417 contient au moins 2 mots-code de correction d’erreur. Le niveau d’erreur est sélectionnable lors de la création du symbole et conditionne le nombre de mots-code de correction (mini : niveau 0→2 mots-code ; maxi niveau 8→512 mots-code). Cela permet la lecture du code à barres

même en cas de destruction partielle du code.

Nom

DataMatrix

Type de données codées

les tables ASCII et ISO

Propriétés

Bidimensionnel, encode jusqu’à 2335 caractères alphanumériques ou 3116 caractères numériques

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Cf § Les instructions et commandes de contrôle / Bar_DataMatrix

Polices requises

police dmx.sfp

Exemple d’utilisation

Dans le fichier sjp :

/Char 5 dmx.sfp

Dans le fichier sp :

…………

Bar_DataMatrix (L8:C1,60) To 1335, 256

Text 5 ModuleWidth 5 Rows 26 Cols 26

…………

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Remarques avancées

Le code à barres bidimensionnel, DataMatrix, est constitué d’un ensemble de lignes et de colonnes contenant des modules et est délimité par un finder pattern, bordure de reconnaissance de un module de large sur les quatre côtés. Les côtés gauche et bas sont des lignes comprenant des modules de couleur noire tandis que les côtés haut et droit sont constitués de modules alternativement noir et blanc. Le symbole peut être de forme carrée ou rectangulaire selon la taille, représentée par le nombre de modules par ligne et par colonne, choisie.

Le symbole est constitué d’une partie représentant les données et d’une partie représentant des codes de correction d’erreur permettant de reconstituer les données même si une partie du symbole est abimé.

Il y a deux types de symboles DataMatrix, ECC 000-

140 et ECC 200 mais, seul ECC 200 est géré par StarPage.

Le module est un carré dont le côté peut mesurer de 10 à 30 mils (1 mils = 1 millième de pouce), soit entre

0.254 et 0.762 mm, ce qui correspond, pour une imprimante 300 dpi, entre 3 et 9 points. Le fichier de police associé contiendra des modules variant de 3 à 12 points.

Nom

DataMatrix

Type de données codées

les tables ASCII et ISO

Propriétés

Bidimensionnel, encode jusqu’à 2335 caractères alphanumériques ou 3116 caractères numériques

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Cf Extern_Func_Datamatrix

Exemple d’utilisation

Windows :

Set Extern_Func(“dmx;0;0;0;TRUE;” + data, “sjgraph.dll”, “sjg_barcode”) to var

Unix/Linux :

Set Extern_Func(“dmx;0;0;0;TRUE;” + data, “/usr/local/share/tbarcode11”, “sjg_barcode”) to var

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Remarques avancées

Le code à barres bidimensionnel, DataMatrix, est constitué d’un ensemble de lignes et de colonnes contenant des modules et est délimité par un finder pattern, bordure de reconnaissance de un module de large sur les quatre côtés. Les côtés gauche et bas sont des lignes comprenant des modules de couleur noire tandis que les côtés haut et droit sont constitués de modules alternativement noir et blanc. Le symbole peut être de forme carrée ou rectangulaire selon la taille, représentée par le nombre de modules par ligne et par colonne, choisie.

Le symbole est constitué d’une partie représentant les données et d’une partie représentant des codes de correction d’erreur permettant de reconstituer les données même si une partie du symbole est abimé.

Il y a deux types de symboles DataMatrix, ECC 000-

140 et ECC 200 mais, seul ECC 200 est géré par StarPage.

Le module est un carré dont le côté peut mesurer de 10 à 30 mils (1 mils = 1 millième de pouce), soit entre

0.254 et 0.762 mm, ce qui correspond, pour une imprimante 300 dpi, entre 3 et 9 points. Le fichier de police associé contiendra des modules variant de 3 à 12 points.

Nom

MaxiCode

Type de données codées

les tables ASCII et ISO

Propriétés

bidimensionnelle inventée par UPS pour ses colis. Il est désormais dans le domaine public et permet la représentation de 93 caractères alpha-numériques. Sa taille est fixe et fait précisément 1 pouce² soit 6,45 cm².

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Cf § Extern_Func_MaxiCode

Logiciel requis

TBarcode

Exemple d’utilisation

Dans le fichier sp :

Set Extern_Func(“UPS;4;S;TRUE;chaine a encoder”,”répertoire sjgraph.dll ou lib TBarcode(sous unix)”, “sjg_barcode”)to NomVariable

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Nom

QR-Code

Type de données codées

les tables ASCII et ISO

Propriétés

Le code QR est un type de code-barres en deux dimensions (ou code matriciel datamatrix) constitué de modules noirs disposés dans un carré à fond blanc. L’agencement de ces points définit l’information que contient le code. QR (abréviation de Quick Response) signifie que le contenu du code peut être décodé rapidement après avoir été lu par un lecteur de code-barres, un téléphone mobile, un smartphone, ou encore une webcam. Son avantage est de pouvoir stocker plus d’informations qu’un code à barres classique, et surtout des données directement reconnues par des applications, permettant ainsi de déclencher facilement des actions.

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Cf § Extern_Func_QRCode

Logiciel requis

TBarcode

Exemple d’utilisation

Dans le fichier sp :

Set Extern_Func(“QR-CODE; TailleX,Y; 0;TRUE;chaine a encoder”,”répertoire sjgraph.dll ou lib TBarcode(sous unix)”, “sjg_barcode”)to NomVariable

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Nom

AZTEC

Type de données codées

les tables ASCII et ISO

Propriétés

Le code Aztec est un type de code-barres bidimensionnel construit autour d’une cible carrée centrale. Les données sont encodées dans des couches concentriques de pixels autour de cette cible. Il est souvent confondu avec le QR-Code dont les trois cibles sont présentes aux coins du code-barres.

Le code Aztec est fréquemment utilisé pour les billets de train dématérialisés. Il s’agit du type de code 2D utilisé par la SNCF, iDTGV, Eurostar, Thalys, DB Bahn, SNCB, ainsi que par d’autres compagnies ferroviaires.

Exemple StarPage

Se reporter aux annexes

Instructions StarPage

Cf § Extern_Func_Aztec

Logiciel requis

Option Graph

Exemple d’utilisation

Dans le fichier sp :

Set Extern_Func(“AZTEC; cf taille; cf format; TRUE;” + AZTECCode, “sjgraph”, “sjg_barcode”) to graphname

Remarques

Si les données ne répondent pas aux exigences, cela ne fonctionnera pas

Syntaxe

Portrait{A4|A3|Letter|Legal|Ledger|Executiv e|Size=<x> by <y>}

[Format=nx by ny [across|down]]

Paramètres

Le mot-clé Portrait est suivi du format physique de la feuille

Size est le mot-clé permettant de définir le format de papier

x représente la taille en inch du papier sur l’axe des X by représente le mot-clé indispensable pour séparer les valeurs en inch associées

y représente la taille en inch du papier sur l’axe des Y Format est un mot-clé demandant l’impression de plusieurs pages logiques par page physique

nx représente horizontalement le nombre de pages logiques par page physique

ny représente verticalement le nombre de pages logiques par page physique

across est un mot clé demandant le déplacement latéral des pages logiques

down est un mot clé demandant le déplacement vertical des pages logiques

Syntaxe

Landscape{A4|A3|Letter|Legal|Ledger|Executiv e|Size=<x> by <y>}

[Format=nx by ny [across|down]]

Paramètres

Le mot-clé Landscape est suivi du format physique de la feuille

Size est le mot-clé permettant de définir le format de papier

x représente la taille en inch du papier sur l’axe des X by représente le mot-clé indispensable pour séparer les valeurs en inch associées

y représente la taille en inch du papier sur l’axe des Y Format est un mot-clé demandant l’impression de plusieurs pages logiques par page physique.

nx représente horizontalement le nombre de pages logiques par page physique

ny représente verticalement le nombre de pages logiques par page physique

across représente le nombre de pages logiques par page physique horizontalement

down représente le nombre de pages logiques par page physique verticalement

Syntaxe

LineSpacing <ls>

Paramètres

ls représente en points PCL l’espace entre les lignes

Syntaxe

Copies <nc>

Paramètres

nc représente le nombre de copies

Syntaxe

Duplex {0|1|2}

Paramètres

La valeur 0 invalide le mode Recto-Verso.

La valeur 1 active le mode Recto-Verso horizontal. C’est celui généralement utilisé avec l’orientation Landscape.

La valeur 2 active le mode Recto-Verso vertical. C’est celui généralement utilisé avec l’orientation Portrait.

Syntaxe

Intray <nt>

Paramètres

nt représente le numéro du bac d’alimentation papier

Syntaxe

OutBin <nb>

Paramètres

nb représente le numéro du bac de sortie du papier

Syntaxe

Use Overlay <no>

Paramètres

no représente le numéro de l’overlay utilisé

Syntaxe

toupper (<expression string>)

Syntaxe

tolower (<expression string>)

Syntaxe

trim (<expression string>)

Syntaxe

left (<expression string, len>)

Syntaxe

right (<expression string, len>)

Syntaxe

format (expression string, format,

[décimal, séparateur])

Chaîne

Format spécifié

Résultat

Paramètres

56123,567

“”

56123,567

56123,567

“# ###,##”

56123,57

56123,567

56123,567

56123,567

“# ###,####” “#.###,0000”

“#,###.000”,’.’,’,’

56123,567

56.123,5670

56,123.5670

Syntaxe

alignright (expression string ,nombre,

[remplissage])

Paramètres

Appel

Résultat

alignright (“Hello”, 10, ‘.’)

alignright (“Hello”, 10) alignright (“Hello”, 2, ‘.’)

“. Hello”

” Hello” “Hello”

Syntaxe

Sum (bloc)

Syntaxe

Literal (<ExpStrValeur, ExpStrLangage, Nombre_Precision, [ExpStrEuros, ExpStrEuros,

ExpStrCentimes, ExpStrCentimes]>)

Appel

Résultat

literal(50.01 ,

Cinquante virgule un

“FRA”, 2)

literal(50.1 , “FRA”,

Cinquante virgule dix

2)

literal(50.1, “FRA”,

Cinquante virgule un

Paramètres

1)

literal (1256.36,

Mille deux cent

cinquante six euros

“FRA”, 2, “euros”,

et trente six

“euro”, “centimes”,

centimes

“centime”)

literal (1200, “FRA”,

mille deux cent euros

2, “euros”, “euro”,

“centimes”,

“centime”)

zéro euros

literal (0 , “FRA”, 2

, “euros”, “euro”,

“centimes”,

“centime”)

Langues supportées

Abréviations utilisées pour l’ExpStrLangage

Allemand

DEU

Espagnol

ESP

Anglais (Etats Unis)

ENU

Français

FRA

Portugais

PTG

Italien

ITA

Indonésien

IDN

Syntaxe

Cut (NomVariable, ExpStrLongueurMax,

[‘FillChar’])

Paramètres

La variable ESSAI contient “Bonjour les amis”

Appel

Renvoi

CUT (ESSAI, 10)

“Bonjour” donc ESSAI

contient “les amis”

CUT (ESSAI, 11)

“Bonjour les” donc

ESSAI contient “amis”

CUT (ESSAI, 10, ‘*’ )

“Bonjour***” donc ESSAI contient “les amis”

CUT (ESSAI, 5, ‘*’ )

“Bonjo” donc ESSAI

contient “ur les amis”

La variable ESSAI contient un paragraphe que l’on veut mettre sur plusieurs lignes avec 80 colonnes maximum.

WHILE NOT BLANK (ESSAI) # tant que essai n’est pas vide, il y a des données à imprimer

PUT CUT (ESSAI, 80) TO 100, COORD_TEXT_Y TEXT 1

SET COORD_TEXT_Y%+ 50 TO COORD_TEXT_Y #

interlignage ENDWHILE.

Syntaxe

Readdate (ExpStrLecture, ExpStrFormat)

Exemple

READDATE (“1/12/00”, “D/M/Y”) 20001201

Formes possibles pour les formats entrants

DDMMYY DDsepMMsepYY

DDYYMM DDsepYYsepMM

MMDDYY MMsepDDsepYY

MMYYDD MMsepYYsepDD

YYMMDD YYsepMMsepDD

YYDDMM YYsepDDsepMM

DDMMYYYY DDsepMMsepYYYY

DDYYYYMM DDsepYYYYsepMM

MMDDYYYY MMsepDDsepYYYY

MMYYYYDD MMsepYYYYsepDD

YYYYMMDD YYYYsepMMsepDD

YYYYDDMM YYYYsepDDsepMM

DsepMsepY

MsepYsepD

DsepYsepM

YsepMsepD

MsepDsepY

YsepDsepM

Today

Syntaxe

Formatdate (ExpStrDateCode(YYYYMMDD),

ExpStrFormat, ExpStrLanguage)

Paramètres

Les formats applicables à la valeur du jour

D : expression numérique de la valeur significative du jour

Appel

Renvoi

FORMATDATE (“20001105”, “D”, “FRA”)

5

FORMATDATE ( “20011223”, “D” , ” FRA”)

23

DD : expression numérique de la valeur jour sur deux positions

Appel

Renvoi

FORMATDATE (“20001105”, “DD”, “FRA”)

05

FORMATDATE ( “20011223”, “DD” , ” FRA”)

23

Dt : expression numérique de la valeur jour sur deux positions (adjectif numéral ordinal) précédée par un article dans la langue demandée

FORMATDATE (“20001101”, “Dt”, “FRA”)

Le 1^er

FORMATDATE (“20011223”, “Dt”, “FRA”)

Le 23

FORMATDATE (“20001101”, “Dt”, “ENU”)

The 1^st

FORMATDATE (“20011223”, “Dt”, “ENU”)

The 23^th

d : expression alphabétique de la valeur du jour dans la langue demandée.

FORMATDATE (“20001101”, “d”, “FRA”)

un

FORMATDATE (“20011223”, “d”, “FRA”)

Vingt trois

FORMATDATE (“20001101”, “d”, “ENU”)

One

FORMATDATE (“20011223”, “d”, “ENU”)

Twenty three

dt : expression alphabétique de la valeur du jour (adjectif numéral ordinal) précédée par un article dans la langue demandée.

FORMATDATE (“20001101”, “dt”, “FRA”)

Le premier

FORMATDATE (“20011223”, “dt”, “FRA”)

Le vingt trois

FORMATDATE (“20001101”, “dt”, “ENU”)

The first

FORMATDATE (“20011223”, “dt”, “ENU”)

The twenty- third

Les formats applicables à la valeur du mois

M : expression numérique de la valeur significative du mois

FORMATDATE (“20000305”, “M”, “FRA”)

3

FORMATDATE (“20011223”, “M”, “FRA”)

12

MM : expression numérique de la valeur du mois sur deux positions

FORMATDATE (“20000305”, “MM”, “FRA”)

03

FORMATDATE (“20011223”, “MM”, “FRA”)

12

m : expression alphabétique de la valeur du mois dans la langue demandée

FORMATDATE (“20000301”, “m”, “FRA”)

mars

FORMATDATE (“20000723”, “m”, “ENU”)

july

m…m : expression alphabétique de la valeur du mois sur n

caractères dans la langue demandée

FORMATDATE (“20000305”, “mmm”, “FRA”)

mar

FORMATDATE (“20000305”, “mmmm”, “ENU”)

marc

Les formats applicables à la valeur de l’année

Y : expression numérique complète de la valeur de l’année

FORMATDATE (“20001105”, “Y”, “FRA”)

2000

FORMATDATE (“001105”, “Y”, “FRA”)

00

YY : expression numérique de la valeur de l’année sur deux positions.

FORMATDATE (“20001105”, “YY”, “FRA”)

00

FORMATDATE (“20011105”, “YY”, “FRA”)

01

YYYY : expression numérique de la valeur de l’année sur quatre positions.

FORMATDATE (“20001105”, “YYYY”, “FRA”)

2000

FORMATDATE (“011105”, “YYYY”, “FRA”)

2001

y : expression alphabétique complète de la valeur de l’année dans la langue demandée

FORMATDATE (“20001105”, “y”, “FRA”)

deux mille

FORMATDATE (“20001105”, “y”, “ENU”)

two thousand

Syntaxe

Extern_Func (expr [;expr]*, library_name,

function_name)

Paramètres

Expr représente la chaîne source ou paramètre entrant [;expr]* représente la concaténation d’une série d’expressions

library_name représente le nom du fichier .dll (Windows) ou .so (Unix)

function_name représente le nom de la fonction externe

Commentaires

• Il est déconseillé d’archiver, à l’aide de StarSafe, des projets StarPage utilisant des données arabes. Le traitement des données arabes reposant sur un module externe, la consultation d’une telle archive serait incorrecte si le module externe n’est pas présent, et cela risquerait d’affecter l’intégrité de l’archive. Si, cependant, tel est le cas, aucune garantie ne sera apportée à la solution complète.
• Lors du développement de la librairie, donner le nom exact de la fonction développée dans la dll. Les paramètres de cette fonction sont deux chaînes de caractères.

Exemple de prototype en C :

declspec(dllexport) int stdcall MyFunction(unsigned char *szInParam, unsigned char *szResult)

la fonction peut écrire jusqu’à 64 Kilo octets dans szResult. Un code de retour de zéro indique le bon déroulement de la fonction.

Exemple

Extern_Func (L1:C1,52, “arabic.dll”, “convertISO”)

L’exemple ci-dessus est une conversion de données arabes : les données arabes (de droite à gauche) sont converties par le biais d’une fonction externe, en une chaîne (de gauche à droite) associée avec une police arabe.

La librairie “arabic.dll” réalisée par APPIC peut appeler deux fonctions :

• convertISO traite les données arabes provenant d’un système UNIX dans un format ISO8859-6
• convertMS traite les données arabes provenant d’un système Windows dans un format Microsoft CP1256.

Les polices de taille fixe à associer sont les fichiers suivants (taille 9, 12, 16, 24) : nk09rea.sfp, nk12rea.sfp, nk16rea.sfp, nk24rea.sfp.

Syntaxe

Extern_Func(“DMX;expr2;expr3;expr4;expr5;expr6″,” expr7″, “sjg_barcode”)

Paramètres

DMX type de code à barre à générer

Expr2 taille exprimé en 10e de mm (options Datamatrix) Expr3 taille (lignes/colonnes) du code (options Datamatrix) Expr4 largeur du code (en millième de mm) (options Datamatrix)

Expr5 présence de séquence(s) Escape ou non

Expr6 chaine à encoder

Expr7 chemin d’accès au répertoire où se trouve installé la librairie TBarcode

sjg_barcode représente le nom de la fonction à exécuter

Commentaires

• La librairie TBarcode génère une image bitmap du code à barre et retourne son nom complet.
• Peut coder jusqu’à 2335 caractères alphanumériques ou 3116 caractères numériques sur environ 1cm².
• La fonction sjg_barcode est à associer avec la fonction sjg_release qui permet, le programme terminé, de supprimer les images bitmap créées.

Exemple

Set Extern_Func(“DMX;0;0;0;TRUE;chaine a encoder”, “sjgraph.dll ou unix TBarCode librairie”, “sjg_barcode”) to bc_graphname Put “/Picture ” + bc_graphname + ” x=10 y=640″ To 0, 0 Text 1

Set Extern_Func(“DMX;bc_graphname “,”sjgraph.dll ou unix TBarCode librairie”,”sjg_release”) to ret

L’exemple ci-dessus génère l’image d’un code à barre contenant “chaine à encoder”. Le nom de l’image est récupéré dans la variable bc_graphname.

La commande Put /Picture… va intégrer l’image du code à barre dans le PCL de StarPage.

La fonction “Extern_Func… sjg_release ” indique à StarPage qu’il faudra supprimer cette image à la fin du traitement.

Syntaxe

Extern_Func(“UPS;expr2;expr3;expr4;expr5″,”expr6”

, “sjg_barcode”)

Paramètres

UPS type de code à barre à générer

Expr2 mode du code à barres (cf page 80) Expr3 format du code à barres (cf page 85) Expr4 présence de séquence(s) Escape ou non Expr5 chaine à encoder

Expr6 chemin d’accès au répertoire où se trouve installé la librairie TBarcode

sjg_barcode représente le nom de la fonction à exécuter

Commentaires

• La librairie TBarcode génère une image bitmap du code à barre et retourne son nom complet.
• Le nombre maximun de caractères pouvant être encodés et de 93 caractères alpha-numériques.
• La fonction sjg_barcode est à associer avec la fonction sjg_release qui permet, le programme terminé, de supprimer les images bitmap créées.

Exemple

Set Extern_Func(“UPS;4;S;TRUE;chaine a encoder”, “sjgraph.dll”, “sjg_barcode”) to bc_graphname

Put “/Picture ” + bc_graphname + ” x=10 y=640″ To 0, 0 Text 1

Set Extern_Func(“UPS;bc_graphname “,”sjgraph.dll or unix TBarCode library”,”sjg_release”) to ret

L’exemple ci-dessus génère l’image d’un code à barre contenant “chaine a encoder”. Le nom de l’image est récupéré dans la variable bc_graphname.

La commande Put /Picture… va intégrer l’image du code à barre dans le PCL de StarPage.

La fonction “Extern_Func… sjg_release ” indique à StarPage qu’il faudra supprimer cette image à la fin du traitement.

Syntaxe

Extern_Func(“QR-CODE;

expr2;expr3;expr4;expr5;expr6″,”sjg_barcode”)

Paramètres

QR-CODE type de code à barre à générer

Expr2 dimension X,Y exprimée en dizième de millimètres

Expr3 format du code à barres (0 par défaut) Expr4 présence de séquence(s) Escape ou non Expr5 chaine à encoder

Expr6 chemin d’accès au répertoire où se trouve installé la librairie TBarcode

sjg_barcode nom de la fonction à exécuter

Commentaires

• La librairie TBarcode génère une image bitmap du code à barre et retourne son nom complet.
• La fonction sjg_barcode est à associer avec la fonction sjg_release qui permet, le programme terminé, de supprimer les images bitmap créées.

Exemple

Set Extern_Func(“QR- CODE;360,360;0;TRUE;chaine a

encoder”,”sjgraph.dll”, “sjg_barcode”) to graphname

Put “/Picture ” + graphname + ” x=200 y=300″ To 0, 0 Text 1

Set Extern_Func(“QR-CODE;bc_graphname “,”sjgraph.dll or unix TBarCode library”,”sjg_release”) to ret

L’exemple ci-dessus génère l’image d’un code à barre contenant “chaine a encoder”. Le nom de l’image est récupéré dans la variable graphname.

La commande Put /Picture… va intégrer l’image du code à barre dans le PCL de StarPage.

La fonction “Extern_Func… sjg_release ” indique à StarPage qu’il faudra supprimer cette image à la fin du traitement.

Syntaxe

Extern_Func(“AZTEC; expr2;expr3;expr4

“,expr5,”sjg_barcode”)

Paramètres

AZTEC type de code à barre à générer Expr2 Taille du code (cf table tailles) Expr3 format du code (cf table formats)

Expr4 présence de séquence(s) Escape ou non

Expr5 chemin d’accès au répertoire où se trouve installé la librairie TBarcode

sjg_barcode nom de la fonction à exécuter

Commentaires

• La librairie SJGraph génère une image bitmap du code à barre et retourne son nom complet.
• La fonction sjg_barcode est à associer avec la fonction sjg_release qui permet, le programme terminé, de supprimer les images bitmap créées.

Exemple

Set Extern_Func(“AZTEC;3;1;TRUE;” + AZTECCode, “sjgraph”, “sjg_barcode”) to graphname

Put “/Picture ” + graphname + ” x=200 y=300″ To 0, 0 Text 1

Set Extern_Func(“AZTEC;bc_graphname “,”sjgraph.dll or unix TBarCode library”,”sjg_release”) to ret

L’exemple ci-dessus génère l’image d’un code à barre contenant “chaine à encoder”. Le nom de l’image est récupéré dans la variable graphname.

La commande Put /Picture… va intégrer l’image du code à barre dans le PCL de StarPage.

La fonction “Extern_Func… sjg_release ” indique à StarPage qu’il faudra supprimer cette image à la fin du traitement.

Syntaxe

length (nom variable)

Exemple

…………

Value numero_client1 Is Var Value numero_client2 Is Var

…

…

Set “34” to numero_client1 Set “152” to numero_client2

…………

Appel

Renvoi

length(numero_client1)

2

length(numero_client2)

3

Syntaxe

CHR(expr)

Paramètres

expr représente un élément du code ASCII (voir table ASCII)

Commentaires

• Cette fonction permet de récupérer et donc de gérer des caractères non imprimables (ex : saut de page).

Exemple

Appel

Renvoi

CHR(65)

A

CHR(12)

Saut de page

CHR (13)

Retour à la ligne

Syntaxe

FindStrPos(ExpStr_tofind,ExpStr[,Pos])

Paramètres

ExpStr_tofind est la chaîne de caractères recherchée.

ExpStr est la chaîne de caractères source.

Pos est une valeur numérique définissant le début de la

recherche.

Commentaires

• Le résultat est une valeur numérique définissant le début de la chaîne de caractères recherchée.
• La recherche commence à partir de la position qui suit le paramètre Pos. Si Pos=5, la recherche commence au 6^ème caractère

Exemple

# recherche la premiere occurrence

Set FindStrPos(“TOTO”,”TATATOTOTITITITOTO”)to Pos

While (Pos %<>0)

Put “Trouvé en position : ” + Pos to…

# recherche l’occurence suivante

Set FindStrPos(“TOTO”,”TATATOTOTITITITITOTO”,Pos)

to Pos EndWhile

…

Syntaxe

GetSubStr(Pos,Len,ExpStr)

Paramètres

Pos est une valeur numérique définissant la début de la chaîne de caractères recherchée.

Len est une valeur numérique définissant la taille de la chaîne de caractères recherchée.

ExpStr est la chaîne de caractères source.

Commentaires

• Si la valeur de Pos est trop élevée ou la valeur de Len négative ou nulle, la chaîne de caractères retournée sera vide.
• Si la valeur de Len est trop élevée, une chaîne de caractères

de taille inférieure à Len peut être renvoyée.

Exemples

GetSubStr(3,3,”CHAINE” )  “AIN” GetSubStr(5,2,”CHAINE”)  “NE” GetSubStr(5,8,”CHAINE”)  “NE” GetSubStr(7,8,”CHAINE”)  “”

…

Syntaxe

DeleteSubStr(Pos,Len,ExpStr)

Paramètres

Pos est une valeur numérique définissant le début de la chaîne de caractères à supprimer.

Len est une valeur numérique définissant la taille de la chaîne de caractères à supprimer.

ExpStr est la chaîne de caractères source.

Commentaires

• Si la valeur de Pos est trop élevée ou la valeur de Len négative ou nulle, la chaîne de caractères retournée est la chaîne source.
• Si la valeur de Len est trop élevée, une chaîne de caractères

de taille inférieure à Len est supprimée de la source.

Exemples

DeleteSubStr(3,3,”CHAINE” )  “CHE” DeleteSubStr(5,2,”CHAINE”)  “CHAI” DeleteSubStr(5,8,”CHAINE”)  “CHAI” DeleteSubStr(7,8,”CHAINE”)  “CHAINE”

…

Syntaxe

ReplaceStr(ExpStr_tofind,ExpStr_toreplace,ExpStr[,

Pos[,toPos]])

Paramètres

ExpStr_tofind est la chaîne de caractères à supprimer. ExpStr_toreplace est la chaîne de caractères remplaçante. ExpStr est la chaîne de caractères source.

Pos est une valeur numérique définissant le début de la recherche.

toPos est une valeur numérique définissant la fin de la

recherche.

Commentaires

• La chaîne de caractères remplaçante peut être constituée d’un nombre de caractères différent de la chaîne supprimée.

Exemples

ReplaceStr(“TOTO”,”PADDY”,”TATATOTOTITITITOTO”)

 “TATAPADDYTITITIPADDY”

ReplaceStr(“TOTO”,”PADDY”,”TATATOTOTITITITITOTO”,9)

 “TATATOTOTITITIPADDY”

ReplaceStr(“TOTO”,”PADDY” “TATATOTOTITITITITOTOTATATITITATATITITOTO”,9,36)  “TATATOTOTITITITIPADDYTATATITITATATITITOTO”

…

Syntaxe

ReverseStr(ExpStr)

Paramètres

ExpStr est la chaîne de caractères.

Exemples

ReverseStr (“PADDY”)  “YDDAP”

…

Syntaxe

GetFieldsCount(Delimit,Quote,ExpStr)

Paramètres

Delimit représente le caractère de délimitation.

Quote représente les quotes simples ou doubles gérées par la fonction en tant qu’inhibiteurs.

ExpStr est la chaîne de caractères.

Commentaires

• S’il n’y a pas de gestion de quote, le paramètre Quote est vide et il n’y a pas d’inhibiteur.
• Le paramètre \ placé devant un caractère est utilisé pour interpréter ce dernier en tant qu’inhibiteur et non en tant que début de chaine de caractères.

Exemples

GetFieldsCount(“;”,”\””,”AB;CD;EF”)  3

GetFieldsCount(“;”,”\””,”AB;CD;\”EF;GH\””)  3

GetFieldsCount(“;”,””,”AB;CD;\”EF;GH\””)  4

GetFieldsCount (“;”,”\””,”AB;CD; \”EF\”;\”GH\”” )  4

GetFieldsCount (“;”,”\””,” ; ; ; ” )  4

…

Syntaxe

GetField(Delimit,Quote,ExpStr,FieldNumber)

Paramètres

Delimit représente le caractère de délimitation des champs. Quote représente les quotes simples ou doubles gérés par la fonction en tant qu’inhibiteurs.

ExpStr est la chaîne de caractères.

FieldNumber représente le numéro de champ recherché.

Commentaires

• S’il n’y a pas de gestion de quote, le paramètre Quote est vide et il n’y a pas d’inhibiteur.
• Le paramètre \ placé devant le caractère quote est utilisé pour interpréter ce dernier en tant qu’inhibiteur et non en tant que début de chaine de caractères.

Exemples

GetField(“;”,”\””,”AB;CD;EF”,2 )  “CD”

GetField(“;”,”\””,”AB;CD; \”EF;GH\””,3)  “EF;GH”

GetField(“;”,””,”AB;CD; \”EF;GH\””,3)  “”EF”

GetField(“;”,”\””,”AB;CD;\”EF\”;\”GH\””, 3)  “EF”

GetField(“;”,”\””,”AB;CD;EF; ” , 4)  “”

…

Syntaxe

XPath (xPathExpStr)

Paramètres

xPathExpStr représente le “chemin” de la requête

Commentaires

Si le résultat est constitué de plusieurs éléments, les réponses sont concaténées

Exemple

<?xml version=”1.0″ encoding=”iso-8859-1″ ?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author>

<firstname>Jules</firstname>

<lastname>Vernes</lastname>

</author>

</book>

</bookstore>

XPath (“/bookstore/book/author”) renvoie

<author>

<firstname>Jules</firstname>

<lastname>Vernes</lastname>

</author>

Syntaxe

XPath (xPathExpStr, nodeExpStr)

Paramètres

xPathExpStr représente le “chemin” de la requête

nodeExpStr représente le nœud, partie du document XML

Commentaires

Si le résultat est constitué de plusieurs éléments, les réponses sont concaténées

Exemple

<?xml version=”1.0″ encoding=”iso-8859-1″?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author> Jules Vernes </author>

</book>

<book>

<title> Learning XML </title>

<author> Erik T. Ray </author>

</book>

</bookstore>

La commande Set permet d’affecter une valeur à une variable de type Set.

Set XPath (“/bookstore/book”)[1] to book1

…

XPath (“/book/author”, book1) renvoie

<author> Jules Vernes </author>

Syntaxe

XPath (xPathExpStr,[nodeExpStr]) [i]

Paramètres

xPathExpStr représente le “chemin” de la requête

nodeExpStr représente le nœud, partie du document XML i représente le numéro d’indice

Exemple

<?xml version=”1.0″ encoding=”iso-8859-1″?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author> Jules Vernes </author>

</book>

<book>

<title> Learning XML </title>

<author> Erik T. Ray </author>

</book>

</bookstore>

XPath(“/bookstore/book/author”)[1] renvoie

<author> Jules Vernes </author>

Syntaxe

XPath (xPathExpStr,[nodeExpStr]).Count

Paramètres

xPathExpStr représente le “chemin” de la requête

nodeExpStr représente le nœud, partie du document XML

Exemple

<?xml version=”1.0″ encoding=”iso-8859-1″?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author> Jules Vernes </author>

</book>

<book>

<title> Learning XML </title>

<author> Erik T. Ray </author>

</book>

</bookstore>

XPath(“/bookstore/*”).Count renvoie

2

Syntaxe

XPath (xPathExpStr,[nodeExpStr])[[i]].Value

Paramètres

xPathExpStr représente le “chemin” de la requête

nodeExpStr représente le nœud, partie du document XML i représente le numéro d’indice

Commentaires

Si le résultat est constitué de plusieurs éléments, les réponses sont concaténées

Exemples

<?xml version=”1.0″ encoding=”iso-8859-1″?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author> Jules Vernes </author>

</book>

<book>

<title> Learning XML </title>

<author> Erik T. Ray </author>

</book>

</bookstore>

XPath (“/bookstore/book/author”).Value renvoie

Jules Vernes Erik T. Ray

XPath(“/bookstore/book/author”)[2].Value renvoie

Erik T. Ray

Syntaxe

XPath(xPathExpStr,[nodeExpStr])[[i]].Name

Paramètres

xPathExpStr représente le “chemin” de la requête

nodeExpStr représente le nœud, partie du document XML i représente le numéro d’indice

Commentaires

Si le résultat est constitué de plusieurs éléments, les réponses sont concaténées

Exemples

<?xml version=”1.0″ encoding=”iso-8859-1″?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author> Jules Vernes </author>

</book>

<book>

<title> Learning XML </title>

<author> Erik T. Ray </author>

</book>

</bookstore>

XPath(“/bookstore/book/author”).Name renvoie

author author

XPath(“/bookstore/book/author”)[1].Name renvoie

author

Syntaxe

XPath(xPathExpStr,[nodeExpStr])[[i]].Path

Paramètres

xPathExpStr représente le “chemin” de la requête

nodeExpStr représente le nœud, partie du document XML i représente le numéro d’indice

Commentaires

Si le résultat est constitué de plusieurs éléments, les réponses sont concaténées

Exemple

<?xml version=”1.0″ encoding=”iso-8859-1″?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author> Jules Vernes </author>

</book>

<book>

<title> Learning XML </title>

<author> Erik T. Ray </author>

</book>

</bookstore>

XPath(“/bookstore/book/*”)[2].Path renvoie

/bookstore/book/author

Syntaxe

XPath(xPathExpStr,[nodeExpStr])[[i]].ExactPath

Paramètres

xPathExpStr représente le “chemin” de la requête

nodeExpStr représente le nœud, partie du document XML i représente le numéro d’indice

Commentaires

Si le résultat est constitué de plusieurs éléments, les réponses sont concaténées

Exemple

<?xml version=”1.0″ encoding=”iso-8859-1″?>

<bookstore>

<book>

<title> Le rayon vert </title>

<author> Jules Vernes </author>

</book>

<book>

<title> Learning XML </title>

<author> Erik T. Ray </author>

</book>

</bookstore>

XPath(“/bookstore/book/*”)[2].ExactPath renvoie

/bookstore/book/author[1]

Syntaxe

Include rest

Commentaires

• Cette commande de même nature que les commandes copy, move et erase porte sur l’ensemble de la matrice. Elle permet de demander l’impression du reste de la matrice, en utilisant la police et la densité définie par défaut grâce à la commande text.
• L’espace interligne est décidé à partir des valeurs indiquées par les commandes Linespacing, Verticalspacing définies pour la page de reformatage en cours de traitement, ou par les valeurs définies par défaut. Si aucunes de ces valeurs n’est définie, l’impression se fera en tenant compte des valeurs Maxlines et Top définies dans la commande

/PORTRAIT ou /LANDSCAPE du fond de page indiqué dans la commande form, ainsi, bien entendu que de la taille du papier.

• Sont considérées comme faisant partie du reste de la matrice les informations qui :
  • n’ont été effacées par aucune commande erase
  • n’ont été déplacées par aucune commande move.
• Cette commande doit être située à la fin du fichier de commandes ou, si plusieurs page de reformatage sont définies, à la fin de chacune des pages concernées par cette commande.

Syntaxe

text <police> [density <dens>]

Paramètres

police représente le numéro de police à utiliser par défaut density est le mot-clé permettant d’altérer la densité par défaut de la police

• dens est la densité à affecter à la police par défaut

Commentaires

• Les informations reprises de la matrice d’entrée seront imprimées par défaut, en utilisant la police de caractères définie à l’aide de cette commande.
• Si une densité est indiquée, la police sera modifiée pour satisfaire cette valeur de densité. Dans le cas contraire, la densité par défaut de la police sera utilisée.
• L’utilisation de cette commande est indispensable pour pouvoir utiliser la commande Include rest.

Exemple

…………

text 2 density 13.8

..

..

…………

Par défaut, c’est à dire en l’absence d’indication contraire mentionnée dans les commandes suivantes, la police utilisée sera celle définie dans le fichier de commandes StarJet par la commande /CHAR 2. Les données seront imprimées avec une densité de 13,8 caractères par pouce. En toute logique cette police de caractères est une police à espacement fixe, faute de quoi le mot clef density n’a

aucune influence sur l’impression.

Syntaxe

VerticalSpacing <vmi> <Top>

Syntaxe

Left-Margin <lm>

Paramètres

lm représente le nombre de colonnes devant constituer la marge gauche

Syntaxe

MultiDuplex <nd> <nd> … <nd>

Paramètres

nd représente le mode Duplex utilisé pour chaque copie

Syntaxe

MultiOutBin <nb> <nb> … <nb>

Paramètres

nb représente le bac de sortie utilisé pour chaque copie

Syntaxe

MultiTray <nb> <nb> … <nb>

Paramètres

nb représente le bac d’alimentation utilisé pour chaque copie.

Syntaxe

Use Multipart <no> <no> … <no>

Paramètres

no représente les numéros des Overlays utilisés pour émuler

une liasse.

Commentaires

• Cette commande est la dernière avant les données devant être imprimées sur des liasses émulées.
• Les numéros indiqués comme paramètres de cette commande identifient les Overlays utilisés.
• Un même numéro d’Overlay peut être utilisé plusieurs fois si vous souhaitez voir imprimer plusieurs pages identiques avec cet Overlay.

Exemple

…………

text 2 density 13.8

..

…………

Par défaut, c’est à dire en l’absence d’indication contraire mentionnée dans les commandes suivantes, la police utilisée sera celle définie dans le fichier de commandes StarJet par la commande /CHAR 2. Les données seront imprimées avec une densité de 13,8 caractères par pouce. En toute logique cette police de caractères est une police à espacement fixe, faute de quoi le mot clef density n’a aucune influence sur

l’impression.

Code

Définition

retour

0

Aucune erreur

Ligne de commande

-1

Erreur de syntaxe sur la ligne de commande

-2

Sortie non définie

-3

Pas de ficher de données

-4

Le fichier .sp n’a pas été spécifié

-7

Sortie déjà spécifiée

-8

Fichier .sp déjà spécifié

-9

Fichier de données déjà spécifié

-10

Commande incompatible avec paramètre

-11

Option déjà spécifiée

-12

Paramètre manquant pour l’option

-13

Redirection impossible

Validation et modules

-20

Période de validité expirée

-21

Copy non valide

-22

Versions des dll incompatibles

Gestion de fichier

-32

Impossible d’ouvrir la sortie

-33

Impossible de fermer la sortie

-35

Impossible d’ouvrir le fichier de message StarJet

-36

Impossible de parser le fichier .sp

-40

Impossible de récupérer les paramètres

Fonction d’initialisation

-41

Impossible d’initialiser le “page array”

-42

Impossible d’initialiser la sortie

-43

Impossible de libérer la sortie

-44

Plus de mémoire

-50

Le fichier spécifié n’a pas été trouvé ou problème d’ouverture du fichier

Projets

-60

Erreur StarPage

-61

Erreur StarJet

-PAGES

Cette option permet d’afficher chaque fin de page. Elle est particulièrement utile pour les gros fichiers PCL dont le traitement est de longue durée.

-P

Cette option permet de définir une orientation “Portrait” pour les pages en sortie.

– L

Cette option permet de définir une orientation “Paysage” pour les pages en sortie.

-A3

Cette option permet de définir un format A3 pour les pages en sortie.

-A4

Cette option permet de définir un format A4 pour les pages en sortie.

-LEGAL

Cette option permet de définir un format Legal (14×8.5 inchs) pour les pages en sortie.

-LETTER

Cette option permet de définir un format Letter (11×8.5 inchs) pour les pages en sortie.

-M:#

Cette option permet de définir un nombre de pages à traiter car, par défaut, le traitement concerne la totalité du fichier PCL entrant.

-SC:#

Cette option permet de modifier l’échelle du document sortant. Elle peut être utilisée pour réduire un document afin qu’il soit correctement imprimé.

-DIA:”..”

Cette option permet de définir l’auteur du document à inclure dans le fichier PDF en sortie.

-DIC:”..”

Cette option permet de définir le créateur de documents à inclure dans le fichier PDF en sortie.

-DIK:”..”

Cette option permet de définir le(s) mot(s)-clé à inclure dans le fichier PDF en sortie.

-DIS:”..”

Cette option permet de définir le sujet du document à inclure dans le fichier PDF en sortie.

-DIT:”..”

Cette option permet de définir le titre du document à inclure dans le fichier PDF en sortie.

-CSIZE

Cette option permet de demander à ce que les documents PDF sortants soient les plus compressés possible.

-CSPEED

Cette option permet de demander à ce que les documents PDF sortants soient compressés le plus rapidement possible.

-CNONE

Cette option permet de demander à ce que les documents PDF sortants ne soient pas compressés.

-EO:”..”

Cette option permet de définir un mot de passe empêchant l’utilisateur de modifier les paramètres de sécurité.

-EU:”..”

Cette option permet de définir un mot de passe nécessaire à l’ouverture du document PDF.

-EF:”..”

Cette option permet de définir les restrictions appliqués au document PDF créé.

P (bloque l’impression).

M (“modifier” – bloque la modification des documents).

C (“Copie” bloque la sélection de textes ou de graphiques).

A (bloque l’addition ou la modification des notes).

-RA

Cette option permet de spécifier que les polices téléchargées bitmap PCL soient rendues en tant que bitmaps.

-BM:0

Cette option permet de définir la marge minimale non imprimable de la page.