dcmpsprt: lit des images DICOM et des Presentation States et génère un travail d'impression

SYNOPSIS

dcmpsprt [options] dcmfile-in...

DESCRIPTION

dcmpsprt est une application qui lit une ou plusieurs images DICOM et Presentation States et crée un travail d'impression. Le travail d'impression se compose d'un objet Stored Print et d'une ou plusieurs images Hardcopy Grayscale, et il est écrit dans la base de données spécifiée dans le fichier de configuration. Le travail d'impression peut, en option, être spoulé vers l'imprimante. Dans ce cas, dcmpsprt appelle l'application dcmprscu, qui assure la communication avec l'imprimante.

PARAMÈTRES

dcmfile-in  fichier(s) d'image DICOM à imprimer ("-" pour 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 de traitement

+p --pstate [p]state file: string: rend l'image suivante avec le presentation state p (cette option peut être spécifiée plusieurs fois)
-c --config [f]ilename: string: traite en utilisant les paramètres du fichier de configuration f
-p --printer [n]ame: string (default: 1st printer in cfg file): sélectionne l'imprimante d'identifiant n dans le fichier cfg

options de spoulage

-s --spool: spoule le travail d'impression vers l'imprimante DICOM
--nospool: ne spoule pas le travail d'impression vers l'imprimante DICOM (par défaut)

options d'orientation du film

--portrait: définit l'orientation portrait
--landscape: définit l'orientation paysage
--default-orientation: utilise la valeur par défaut de l'imprimante (par défaut)

options de rognage (bordure)

--trim: active le rognage
--no-trim: désactive le rognage
--default-trim: utilise la valeur par défaut de l'imprimante (par défaut)

options de comportement decimate/crop demandé

--request-decimate: demande un decimate
--request-crop: demande un crop
--request-fail: demande un échec
--default-request: utilise la valeur par défaut de l'imprimante (par défaut)

options de print presentation LUT

--default-plut: ne crée pas de presentation LUT (par défaut)
--identity: définit la forme de presentation LUT IDENTITY
--plut [l]ut identifier: string: ajoute la LUT l au travail d'impression
--inverse-plut: rend la presentation LUT inverse dans le bitmap de l'image hardcopy grayscale
--illumination [v]alue: integer (0..65535): définit l'illumination à v (en cd/m^2)
--reflection [v]alue: integer (0..65535): définit la lumière ambiante réfléchie à v (en cd/m^2)

options de base du film session (uniquement 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

options d'annotation

--no-annotation: ne crée pas d'annotation (par défaut)
-a --annotation [t]ext: string: crée une annotation avec le texte t
+pd --print-date: ajoute la date/l'heure en tête de l'annotation (par défaut)
-pd --print-no-date: n'ajoute pas la date/l'heure en tête de l'annotation
+pn --print-name: ajoute le nom de l'imprimante en tête de l'annotation (par défaut)
-pn --print-no-name: n'ajoute pas le nom de l'imprimante en tête de l'annotation
+pl --print-lighting: ajoute l'illumination en tête de l'annotation (par défaut)
-pl --print-no-lighting: n'ajoute pas l'illumination en tête de l'annotation

options d'overlay

+O --overlay [f]ilename: string, [x] [y]: integer: charge les données d'overlay depuis le fichier PBM f et les affiche à la position (x,y)
+Og --ovl-graylevel [v]alue: integer (0..4095): utilise le niveau de gris d'overlay v (par défaut : 4095 = blanc)

autres options d'impression

-l --layout [c]olumns [r]ows: integer (default: 1 1): utilise le format d'affichage d'image 'STANDARD\c,r'
--filmsize [v]alue: string: définit l'ID de format de film à v
--magnification [v]alue: string: définit le type de grossissement à v
--smoothing [v]alue: string: définit le type de lissage à v
--configinfo [v]alue: string: définit les informations de configuration à v
--resolution [v]alue: string: définit l'ID de résolution demandée à v
--border [v]alue: string: définit la densité de bordure à v
--empty-image [v]alue: string: définit la densité d'image vide à v
--max-density [v]alue: string: définit la densité maximale à v
--min-density [v]alue: string: définit la densité minimale à v
--img-polarity [v]alue: string: définit la polarité de l'image box à v (NORMAL ou REVERSE)
--img-request-size [v]alue: string: définit la taille d'image demandée à v (largeur en mm)
--img-magnification [v]alue: string: définit le type de grossissement de l'image box à v
--img-smoothing [v]alue: string: définit le type de lissage de l'image box à v
--img-configinfo [v]alue: string: définit les informations de configuration de l'image box à 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

dcmpsprt 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

dcmprscu(1)