Guide M-Engine - Historique des versions

Admin : /* Fichiers de sortie */

2019-03-28T13:13:55Z

‎Fichiers de sortie

Admin : /* Fichiers de sortie */

2019-03-28T13:13:38Z

‎Fichiers de sortie

Admin : /* Fichiers de sortie */

2019-03-28T13:13:13Z

‎Fichiers de sortie

Admin le 28 mars 2019 à 13:09

2019-03-28T13:09:49Z

imported>Admin : 1 révision importée

2019-03-06T09:11:25Z

1 révision importée

imported>Rdal : Rdal moved page M-PS Engine technical to Guide M-Engine

2018-11-07T12:08:58Z

Rdal moved page M-PS Engine technical to Guide M-Engine

Nouvelle page

==Introduction==
M-Engine est le nouveau programme Mapping apparu dans M-PS en version 8.0. Ce programme remplace map_xps et apporte de nouvelles fonctionnalités.
Un programme map_xps existe toujours pour rétrocompatibilité, mais celui-ci fait appel au code du M-Engine.

===Principe===
Le M-Engine fonctionne avec un système d’entrées et de sorties. Les entrées sont des arguments de la ligne de commande commençant par « -from », les sorties quant à elles commencent par « -to ». Chaque argument peut posséder plusieurs paramètres (de type paramètre=valeur) séparés par le caractère ‘|’.

Par exemple, la conversion d’un fichier XPS en PCL se fait par la commande suivante :
M-Engine.exe -fromXPS:fichier.xps –toPCL:fichier.pcl
Si on veut appeler un profil de conversion pour le rendu PCL :
M-Engine.exe -fromXPS:fichier.xps –toPCL:fichier.pcl|profile=PCL_Color
Le nom du fichier est un paramètre comme les autres, à la différence que le nom du paramètre n’est pas nécessaire. Mais on pourrait écrire la commande comme ceci :
M-Engine.exe -fromXPS:file=fichier.xps –toPCL:file=fichier.pcl|profile=PCL_Color

===Multi entrées/sorties===
La commande M-Engine peut accepter plusieurs fichiers en entrée et en sortie, de types différents.
Par exemple, la conversion d’un fichier XPS en PCL et en PDF se fait par la commande suivante :
M-Engine.exe -fromXPS:fichier.xps –toPCL:fichier.pcl –toPDF:fichier.pdf
De la même manière on peut utiliser plusieurs fichiers d’entrée, ceux-ci seront concaténés et/ou fusionnés selon l’ordre d’apparition dans la ligne de commande :
Concaténation d’un XPS et d’un PDF :
M-Engine.exe -fromXPS:fichier.xps –fromPDF:fichier.pdf –toPCL:fichier.pcl
Utilisation d’un PDF comme layer sur un XPS :
M-Engine.exe -fromXPS:fichier.xps –fromPDF:fichier.pdf|merge=once –toPCL:fichier.pcl
Les options peuvent être cumulées, on peut donc concaténer plusieurs fichiers et leur appliquer un ou plusieurs layer avant de les convertir.
Il est possible de travailler sur l’ensemble des fichiers d’un répertoire, grâce à l’utilisation du caractère ‘*’ dans le nom du fichier d’entrée.
Concaténation de tous les fichiers PDF d’un dossier dans un seul fichier PCL :
M-Engine.exe -fromPDF:dossier\*.pdf –toPCL:fichier.pcl

==Arguments de la ligne de commande==

===Fichiers d’entrée===
*-fromImage: ou -fromIMG:
Permet d’ajouter au M-Engine un fichier d’entrée de type image (PNG, BMP, JPEG ou TIFF).

*-fromXPS:
Permet d’ajouter au M-Engine un fichier d’entrée de type XPS.

*-fromPDF:
Permet d’ajouter au M-Engine un fichier d’entrée de type PDF.

*-fromPS:
Permet d’ajouter au M-Engine un fichier d’entrée de type PostScript.

*-fromAFP:
Permet d’ajouter au M-Engine un fichier d’entrée de type AFPDS.

*-fromPCL:
Permet d’ajouter au M-Engine un fichier d’entrée de type PCL.

*-fromIGP:
Permet d’ajouter au M-Engine un fichier d’entrée de type Printronix IGP.

*-fromZPL:
Permet d’ajouter au M-Engine un fichier d’entrée de type Zebra ZPLII.

*-fromTEC:
Permet d’ajouter au M-Engine un fichier d’entrée de type Toshiba TEC TPCL.

*-fromESCP:
Permet d’ajouter au M-Engine un fichier d’entrée de type ESC-P.

*-fromTXT:
Permet d’ajouter au M-Engine un fichier d’entrée de type TXT.

===Fichiers de sortie===
*-to:
Permet d’ajouter au M-Engine un fichier de sortie sans type.
Le type de fichier devra être défini dans un profil de conversion passé en paramètre du -to.

Par exemple : « -to:c:\test\outfile.tmp|profile=nomduprofil »

L’utilisation d’un profil de conversion est obligatoire avec cette commande.

====Sorties pour impression====

*-toPCL:
Permet d’ajouter au M-Engine un fichier de sortie de type PCL.

*-toAFP:
Permet d’ajouter au M-Engine un fichier de sortie de type AFPDS.

*-toESCP:
Permet d’ajouter au M-Engine un fichier de sortie de type ESC-P.

*-toProPrinter:
Permet d’ajouter au M-Engine un fichier de sortie de type ProPrinter.

*-toOPOS:
Permet d’ajouter au M-Engine un fichier de sortie de type OPos.

*-toPrinter:
Permet d’ajouter au M-Engine une sortie imprimante.
Exemple : M-Engine -fromXPS :infile.xps "-toPrinter:RICOH Aficio SP C830DN"
Ne fonctionne que sous Windows. Le nom suivant -toPrinter: doit être le nom d’une imprimante définie sur le poste Windows.

====Sorties pour visualisation et impression====
*-toXPS:
Permet d’ajouter au M-Engine un fichier de sortie de type XPS.

*-toPDF:
Permet d’ajouter au M-Engine un fichier de sortie de type PDF.

*-toPS:
Permet d’ajouter au M-Engine un fichier de sortie de type PostScript.

*-toRTF:
Permet d’ajouter au M-Engine un fichier de sortie de type RTF.

*-toDOCX:
Permet d’ajouter au M-Engine un fichier de sortie de type Word Docx.

*-toHTML:
Permet d’ajouter au M-Engine un fichier de sortie de type HTML.

====Sorties pour impression Thermique/BCP====
*-toDPL:
Permet d’ajouter au M-Engine un fichier de sortie de type Datamx DPL.

*-toEPL:
Permet d’ajouter au M-Engine un fichier de sortie de type Eltron EPL.

*-toIGP:
Permet d’ajouter au M-Engine un fichier de sortie de type Printronix IGP.

*-toTEC:
Permet d’ajouter au M-Engine un fichier de sortie de type Toshiba TEC TPCL.

*-toDB4:
Permet d’ajouter au M-Engine un fichier de sortie de type Toshiba TEC DB4.

*-toZPL: ou -toZEBRA:
Permet d’ajouter au M-Engine un fichier de sortie de type Zebra ZPLII.

*-toMonarch:
Permet d’ajouter au M-Engine un fichier de sortie de type Monarch.

====Sorties fichier====
*-toIMG:
Permet d’ajouter au M-Engine un fichier de sortie de type Image, le format d’image sera choisi en fonction de l’extension du fichier (.png, .jpeg, .bmp ou .tiff).

*-toTXT:
Permet d’ajouter au M-Engine un fichier de sortie de type TXT.

*-toXML:
Permet d’ajouter au M-Engine un fichier de sortie de type XML.
Ce format permet d’exporter les textes d’un document au format XML.
Exemple :
<glyph y="64.960000" x="11.520000" line="11" col="4" >SHIP TO POSTAL CODE</glyph>

*-toXMLPOS:
Permet d’ajouter au M-Engine un fichier de sortie de type XML pos.
Ce format permet d’exporter les textes d’un document au format XML.
Exemple :
<TEXT VALUE="SHIP TO POSTAL CODE" ORIENTATION="0" POSX="24" POSY="135" SIZE="5" FONT="Courier New" BOLD="1" ITALIC="0"/>

*-toIndex:
Permet d’ajouter au M-Engine un fichier de sortie de type index. Le format peut être xml ou txt en fonction de l’extension du fichier de sortie.
Cette sortie sert à exporter les metadata d’un document.

*-toMDesigner:
Permet d’ajouter au M-Engine un fichier de sortie de type M-Designer XML.
Le fichier xml résultant peut ensuite être importé dans M-Designer pour créer une maquette.

*-toXMLDRAW:
Permet d’ajouter au M-Engine un fichier de sortie de type XML Mapping. Une maquette M-Designer peut par la suite être appliquée à ce XML pour créer un nouveau fichier XPS.

====Sortie pour archivage====
*-toEverteam:
Permet d’ajouter au M-Engine un fichier de sortie pour Everteam.

*-toEasyFolder:
Permet d’ajouter au M-Engine un fichier de sortie pour EasyFolder.

*-toDigitech:
Permet d’ajouter au M-Engine un fichier de sortie pour Digitech.

*-toOnBase:
Permet d’ajouter au M-Engine un fichier de sortie pour OnBase.

*–toMStorage:
Permet d’ajouter au M-Engine un fichier de sortie pour M-Storage.

===Options globales===

*–replaceEnv
Active le remplacement des valeurs entre crochets (« [[variable]] ») par le contenu des variables d’environnement de même nom.

*-addIndex:
Permet l’ajout de metadata aux fichiers de sorties.

Syntaxe :
-addIndex:nommetadata=valeur
Ou
-addIndex:nommetadata=FILE:chemindufichier

*–indexOnAllPages:
Permet de dupliquer certains index sur les pages ou ils ne sont pas présents.
Syntaxe :
-indexOnAllPages:nomindex1,nomindex2,nomindex3

*-sort:
Indique un index sur lequel se baser pour trier les pages des fichiers.
-sort:nomindex1,nomindex2,nomindex3
Ou
-sort:nomindex1 -sort:nomindex2 -sort:nomindex3

*-filter:
Permet de filtrer les pages des fichiers d’entrée en fonction des valeurs des métadonnées. Les opérateurs mathématiques (=, <, >, <=, >=) et logiques (AND, OR) peuvent être employés pour des filtres complexes sans oublier les parenthèses de priorités.

*-exec:
Permet l’exécution d’une ligne de commande quelque conque en fin de traitement.

*-onError:
Permet l’exécution d’une ligne de commande quelque conque en fin de traitement si une erreur s’est produite.

*-onSuccess:
Permet l’exécution d’une ligne de commande quelque conque en fin de traitement si aucune erreur ne s’est produite.

*–duplicateindex
Permet lors d’un export de métadonnées (-toIndex par exemple) de prendre en compte toutes les occurrences des valeurs.

*-set:
Ajoute ou modifie les options des printtickets.
Syntaxe :
-set:option1=valeur1|option2=valeur2|option3=valeur3

Options possibles :

*filter
Permet de filtrer la modification du printticket en fonction des métadonnées de la page (syntaxe identique au -filter)

DUPLEX
Permet de choisir une impression recto-verso, les valeurs possibles sont :
*long
*short
*TwoSidedLongEdge
*TwoSidedShortEdge
*OneSided

*INPUTBIN
Détermine le numéro du bac d’entrée à utiliser. Valeur numérique attendue.

*OUTPUBIN
Détermine le numéro du bac de sortie à utiliser. Valeur numérique attendue.

ORIENTATION
Détermine l’orientation de la page, les valeurs attendues sont :
*0 -> Portrait
*1 -> Paysage
*2 -> Portrait inversé
*3 -> Paysage inversé

*COPY
Détermine le nombre de copie de chaque page. Valeur numérique attendue.

*TOPOFFSET
Détermine le décalage haut de chaque page. Valeur numérique attendue.

*LEFTOFFSET
Détermine le décalage gauche de chaque page. Valeur numérique attendue.

*TOGGLE
Ajoute un séparateur de job à la page. Valeur booléenne attendue (0, 1, ON, OFF, YES, NO).

*MEDIATYPE
Défini le type de papier à utiliser. Chaine de caractère attendue.

*FRONTSIDE
Permet de forcer l’impression en recto de la page. Quel que soit le mode de duplex en cours.

STAPLE
Gestion de l’agrafage.
Valeurs possibles :
*1 : SaddleStitch (agrafage au milieu de la feuille)
*2 : StapleBottomLeft (agrafage en bas à gauche)
*3 : StapleBottomRight (agrafage en bas à droite)
*4 : StapleDualBottom (agrafage en bas)
*5 : StapleDualLeft (agrafage à gauche)
*6 : StapleDualRight (agrafage à droite)
*7 : StapleDualTop (agrafage en haut)
*8 : StapleTopLeft (agrafage en haut à gauche)
*9 : StapleTopRight (agrafage en bas à droite)
*16 : None (pour stopper l’agrafage) *Dans la documentation il est indiqué 10, probablement une erreur dans le code
*La documentation fait référence aux options NUP et JOBCUT, mais ces options ne sont pas présentes en v8 actuellement

-lpr:
Permet l’envoi des fichiers de sortie à une queue Mapping. Les différents paramètres sont séparés par le caractère ‘|’.
Les paramètres possibles sont :
*title=title
*queue=queue
*user=user
*priority=priority
*nbcopy=nbcopy
*retention
*compress=compress
*security=security
*codecompta=codecompta
*fidelity=fidelity
*userdata=userdata
*add
*save
*hold

==Paramètres des Loaders et Renders==
Chaque fichier d’entrée (loader) et chaque fichier de sortie (render) peut posséder une liste de paramètres. Ces paramètres sont séparés par le caractère ‘|’ et suivent la syntaxe « paramètre=valeur ».

Ces paramètres sont toutes les options possibles du fichier XpsConfig.xml, par exemple l’option de choix de résolution d’un profil du XpsConfig (<dpi>300</dpi> dans le fichier) sera utilisé en ligne de commande de cette manière :
« toPCL:nomfichier.pcl|dpi=300 »

==Concaténation et utilisation de calques==
===Concaténation===

Il existe plusieurs manières de concaténer des fichiers.
====Utilisation de plusieurs loaders====
Il suffit d’indiquer plusieurs fichiers d’entrée pour les concaténer. La concaténation se fera selon l’ordre d’apparition dans la ligne de commande.
-fromXPS:fichier1.xps -fromXPS:fichier2.xps -toXPS:concat.xps

Les fichiers d’entrée peuvent être de langages différents, il est aussi possible d’avoir plusieurs fichiers de sortie pour effectuer la concaténation dans diffèrent langage par exemple.

====Scanne de répertoires====
La deuxième méthode pour concaténer des fichiers consiste à utiliser le caractère ‘*’ dans le nom du fichier pour permettre la lecture de plusieurs fichiers.
-fromXPS:*.xps -toXPS:concat.xps

Ou

-fromXPS:prefixe* -toXPS:concat.xps

===Calques===
Pour utiliser un fichier d’entrée comme calque il doit posséder le paramètre « merge ».
Le paramètre « merge » peut prendre plusieurs valeurs :
*repeatall
Toutes les pages sont fusionnées en répétant le calque jusqu’à la fin des fichiers d’entrée.

*repeatfull
Toutes les pages sont fusionnées en répétant le calque tant qu’il peut être inséré entièrement.

*once
Le calque n’est inséré qu’une seule fois sur la ou les premières pages du fichier d’entrée.

==Ordre des traitements==
*Etape 1 :
Tri des pages des fichiers d’entrée si nécessaire (présence de l’option -sort par exemple).

*Etape 2 :
Récupération de la page à traiter.
Le traitement démarre avec la première page du premier fichier d’entrée, une fois toutes les pages du fichier traitées on passe au fichier suivant.
Fin du traitement lorsqu’il n’y a plus de page à traiter.

*Etape 3 :
Application des options de transformation du fichier d’entrée à la page (rotation, offset, redimensionnent)

*Etape 4 :
Vérification des filtres.
Si l’option -filter est présente, le filtre est appliqué à la page pour déterminer si elle doit être traitée.
Retour à l’étape 2 si la page ne correspond pas au filtre.

*Etape 5 :
Modification des printtickets de la page si présence de l’option -set.

*Etape 6 :
Remplacement des variables M-Designer de type « nombre total de page », « nombre total de document », etc…

*Etape 7 :
Rendu des calques dans les fichiers de sortie. (Apres avoir appliqué les options de transformation au calque)

*Etape 8 :
Application des options de transformation du fichier de sortie à la page (rotation, offset, redimensionnent)
Et rendu de la page dans le fichier de sortie.
Etape répétée pour chaque fichier de sortie.

*Etape 9 :
Génération d’un saut de page dans chaque fichier de sortie.
Et retour à l’étape 2.

@@ Ligne 98 : / Ligne 98 : @@
 Exemple : M-Engine -fromXPS :infile.xps "-toPrinter:RICOH Aficio SP C830DN"
 Ne fonctionne que sous Windows. Le nom suivant -toPrinter: doit être le nom d’une imprimante définie sur le poste Windows.
 ====<u>Sorties pour visualisation et impression</u>====

@@ Ligne 76 : / Ligne 76 : @@
 L’utilisation d’un profil de conversion est obligatoire avec cette commande.
-====Sorties pour impression====
+====<u>Sorties pour impression</u>====
 *-toPCL:
@@ Ligne 100 : / Ligne 99 : @@
 Ne fonctionne que sous Windows. Le nom suivant -toPrinter: doit être le nom d’une imprimante définie sur le poste Windows.
-====Sorties pour visualisation et impression====
+====<u>Sorties pour visualisation et impression</u>====
 *-toXPS:
 Permet d’ajouter au M-Engine un fichier de sortie de type XPS.
@@ Ligne 118 : / Ligne 117 : @@
 *-toHTML:
 Permet d’ajouter au M-Engine un fichier de sortie de type HTML.
-−
-====Sorties pour impression Thermique/BCP====
+====<u>Sorties pour impression Thermique/BCP</u>====
 *-toDPL:
 Permet d’ajouter au M-Engine un fichier de sortie de type Datamx DPL.
@@ Ligne 141 : / Ligne 140 : @@
 Permet d’ajouter au M-Engine un fichier de sortie de type Monarch.
+====<u>Sorties fichier</u>====
 *-toIMG:
 Permet d’ajouter au M-Engine un fichier de sortie de type Image, le format d’image sera choisi en fonction de l’extension du fichier (.png, .jpeg, .bmp ou .tiff).
@@ Ligne 172 : / Ligne 169 : @@
 *-toXMLDRAW:
 Permet d’ajouter au M-Engine un fichier de sortie de type XML Mapping. Une maquette M-Designer peut par la suite être appliquée à ce XML pour créer un nouveau fichier XPS.
-====Sortie pour archivage====
+====<u>Sortie pour archivage</u>====
 *-toEverteam:
 Permet d’ajouter au M-Engine un fichier de sortie pour Everteam.

@@ Ligne 2 : / Ligne 2 : @@
 M-Engine est le nouveau programme Mapping apparu dans M-PS en version 8.0. Ce programme remplace map_xps et apporte de nouvelles fonctionnalités.
 Un programme map_xps existe toujours pour rétrocompatibilité, mais celui-ci fait appel au code du M-Engine.
 ===Principe===
@@ Ligne 141 : / Ligne 142 : @@
 ====Sorties fichier====
 *-toIMG:
@@ Ligne 311 : / Ligne 313 : @@
 *save
 *hold
@@ Ligne 321 : / Ligne 322 : @@
 « toPCL:nomfichier.pcl|dpi=300 »
 ==Concaténation et utilisation de calques==
@@ Ligne 339 : / Ligne 341 : @@
 -fromXPS:prefixe* -toXPS:concat.xps
 ===Calques===
@@ Ligne 351 : / Ligne 355 : @@
 *once
 Le calque n’est inséré qu’une seule fois sur la ou les premières pages du fichier d’entrée.

← Version précédente	Version du 6 mars 2019 à 09:11
(Aucune différence)