dcmprscu: spouleur d'impression pour visualiseur de Presentation State

SYNOPSIS

dcmprscu [options] [dcmfile-in...]

DESCRIPTION

dcmprscu est une application qui implémente la DICOM Basic Grayscale Print Management Service Class en tant que SCU. Elle prend également en charge les Basic Annotation Box et Presentation LUT SOP Classes optionnelles. Cette application est destinée à être utilisée au sein du visualiseur DICOMscope.

dcmprscu reçoit des travaux d'impression complets, constitués d'un objet Stored Print et d'un ou plusieurs objets Hardcopy Grayscale, et les met en file d'attente pour l'imprimante. Aucune vérification n'est effectuée pour savoir si les attributs définis dans l'objet Stored Print sont pris en charge par le Print SCP. Cependant, le spouleur d'impression n'essaie pas d'utiliser les services optionnels d'Annotation ou de Presentation LUT s'ils n'ont pas été négociés avec succès avec le Print SCP.

dcmprscu lit dans le fichier de configuration les caractéristiques de l'imprimante avec laquelle communiquer. Selon la prise en charge de la Presentation LUT par l'imprimante, toute Presentation LUT présente dans le travail d'impression est rendue dans les images hardcopy avant que celles-ci ne soient, si nécessaire, transmises à l'imprimante. Si l'imprimante ne prend pas en charge la transmission d'images à 12 bits/pixel (selon le fichier de configuration), les images hardcopy en niveaux de gris sont sous-échantillonnées à 8 bits/pixel avant transmission à l'imprimante.

dcmprscu peut être exécuté soit en "mode imprimante", auquel cas le nom de fichier d'un objet Stored Print doit être passé, soit en "mode spouleur", auquel cas des commandes sont lues périodiquement dans un répertoire de spouleur.

PARAMÈTRES

dcmfile-in   stored print file(s) to be spooled ("-" for stdin)

OPTIONS

options générales

-h --help: affiche cette aide et quitte
--version: affiche les informations de version et quitte
--arguments: affiche les arguments de ligne de commande développés
-q --quiet: mode silencieux, n'affiche ni avertissements ni erreurs
-v --verbose: mode détaillé, affiche les détails du traitement
-d --debug: mode débogage, affiche les informations de débogage
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) utilise le niveau l pour la journalisation
-lc --log-config [f]ilename: string: utilise le fichier de configuration f pour la journalisation

options d'impression

--noprint: ne crée pas de sortie imprimée (pas de n-action-rq)
--session-print: envoie le n-action-rq de film session (au lieu de film box)
--monochrome1: transmet les images basic grayscale en MONOCHROME1

options de mode

+p --print: mode imprimante, imprime le(s) fichier(s) et se termine (par défaut)
+s --spool [n]ame: string: mode spouleur, utilise n comme préfixe de tâche

options de traitement

-c --config [f]ilename: string: traite en utilisant les paramètres du fichier de configuration
-p --printer [n]ame: string (default: 1st printer in cfg file): sélectionne l'imprimante d'identifiant n dans le fichier cfg
+d --dump: effectue un vidage de tous les messages DIMSE

options du spouleur (uniquement avec –spool)

       --sleep  [d]elay: integer (default: 1)
         sleep d seconds between spooler checks

options de base du film session (pas avec –spool) :

--copies [v]alue: integer (1..100, default: 1): définit le nombre de copies à v
--medium-type [v]alue: string: définit le medium type à v
--destination [v]alue: string: définit le film destination à v
--label [v]alue: string: définit le film session label à v
--priority [v]alue: string: définit la priorité d'impression à v
--owner [v]alue: string: définit le film session owner ID à v

JOURNALISATION

Le niveau de détail de la journalisation des différents outils en ligne de commande et des bibliothèques sous-jacentes peut être spécifié par l'utilisateur. Par défaut, seules les erreurs et les avertissements sont écrits dans le flux d'erreur standard. L'option –verbose permet également de signaler des messages d'information tels que les détails du traitement. L'option –debug permet d'obtenir plus de détails sur l'activité interne, par exemple à des fins de débogage. L'option –log-level permet de sélectionner d'autres niveaux de journalisation. En mode –quiet, seules les erreurs fatales sont signalées. Dans de tels cas d'erreur très graves, l'application se termine généralement. Pour plus de détails sur les différents niveaux de journalisation, consultez la documentation du module "oflog".

Si la sortie de la journalisation doit être écrite dans un fichier (éventuellement avec rotation des fichiers journaux), vers syslog (Unix) ou le journal des événements (Windows), l'option –log-config peut être utilisée. Ce fichier de configuration permet également de diriger uniquement certains messages vers un flux de sortie particulier et de filtrer certains messages en fonction du module ou de l'application qui les génère. Un exemple de fichier de configuration est fourni dans < etcdir>/logger.cfg.

LIGNE DE COMMANDE

Tous les outils en ligne de commande utilisent la notation suivante pour les paramètres : les crochets entourent les valeurs facultatives (0-1), trois points de suspension à la fin indiquent que plusieurs valeurs sont autorisées (1-n), et la combinaison des deux signifie de 0 à n valeurs.

Les options de la ligne de commande se distinguent des paramètres par un signe '+' ou '-' en tête. En général, l'ordre et la position des options de la ligne de commande sont arbitraires (c'est-à-dire qu'elles peuvent apparaître n'importe où). Toutefois, si des options s'excluent mutuellement, c'est la dernière occurrence, la plus à droite, qui est utilisée. Ce comportement est conforme aux règles d'évaluation standard des shells Unix courants.

De plus, un ou plusieurs fichiers de commandes peuvent être spécifiés en utilisant un signe '@' comme préfixe du nom de fichier (par exemple @command.txt). Un tel argument de commande est remplacé par le contenu du fichier texte correspondant (les espaces multiples sont traités comme un séparateur unique, sauf s'ils apparaissent entre deux guillemets) avant toute évaluation ultérieure. Notez qu'un fichier de commandes ne peut pas contenir un autre fichier de commandes. Cette approche simple mais efficace permet de regrouper des combinaisons courantes d'options/paramètres et évite des lignes de commande longues et peu lisibles (un exemple est fourni dans le fichier < datadir>/dumppat.txt).

ENVIRONNEMENT

dcmprscu tente de charger les dictionnaires de données DICOM spécifiés dans la variable d'environnement DCMDICTPATH. Par défaut, c'est-à-dire si la variable d'environnement DCMDICTPATH n'est pas définie, le fichier < datadir>/dicom.dic est chargé, sauf si le dictionnaire est intégré à l'application (par défaut sous Windows).

Il est préférable de conserver le comportement par défaut et de n'utiliser la variable d'environnement DCMDICTPATH que lorsque des dictionnaires de données alternatifs sont nécessaires. La variable d'environnement DCMDICTPATH a le même format que la variable PATH des shells Unix, en ce sens que les deux-points (":") séparent les entrées. Sur les systèmes Windows, le point-virgule (";") est utilisé comme séparateur. Le code du dictionnaire de données tente de charger chaque fichier spécifié dans la variable d'environnement DCMDICTPATH. C'est une erreur si aucun dictionnaire de données ne peut être chargé.

FICHIERS

< etcdir>/dcmpstat.cfg, < etcdir>/printers.cfg - exemples de fichiers de configuration

VOIR AUSSI

dcmprscp(1)