dcmpsprt: lê imagens DICOM e Presentation States e gera um trabalho de impressão

SINOPSE

dcmpsprt [options] dcmfile-in...

DESCRIÇÃO

O aplicativo dcmpsprt lê uma ou mais imagens DICOM e Presentation States e cria um trabalho de impressão. O trabalho de impressão consiste em um objeto Stored Print e uma ou mais imagens Hardcopy Grayscale, e é gravado no banco de dados especificado no arquivo de configuração. O trabalho de impressão pode, opcionalmente, ser enviado para a fila (spool) da impressora. Nesse caso, o dcmpsprt chama o aplicativo dcmprscu, que realiza a comunicação com a impressora.

PARÂMETROS

dcmfile-in  arquivo(s) de imagem DICOM a ser(em) impresso(s) ("-" para stdin)

OPÇÕES

opções gerais

-h --help: exibe este texto de ajuda e sai
--version: exibe as informações de versão e sai
--arguments: exibe os argumentos de linha de comando expandidos
-q --quiet: modo silencioso, não exibe avisos nem erros
-v --verbose: modo detalhado, exibe os detalhes do processamento
-d --debug: modo de depuração, exibe informações de depuração
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) usa o nível l para o logger
-lc --log-config [f]ilename: string: usa o arquivo de configuração f para o logger

opções de processamento

+p --pstate [p]state file: string: renderiza a imagem seguinte com o presentation state p (esta opção pode ser especificada várias vezes)
-c --config [f]ilename: string: processa usando as configurações do arquivo de configuração f
-p --printer [n]ame: string (default: 1st printer in cfg file): seleciona a impressora com o identificador n no arquivo cfg

opções de spooling

-s --spool: envia o trabalho de impressão para a fila da impressora DICOM
--nospool: não envia o trabalho de impressão para a fila da impressora DICOM (padrão)

opções de orientação do filme

--portrait: define a orientação retrato
--landscape: define a orientação paisagem
--default-orientation: usa o padrão da impressora (padrão)

opções de trim (borda)

--trim: ativa o trim
--no-trim: desativa o trim
--default-trim: usa o padrão da impressora (padrão)

opções de comportamento de decimate/crop solicitado

--request-decimate: solicita decimate
--request-crop: solicita crop
--request-fail: solicita falha
--default-request: usa o padrão da impressora (padrão)

opções de print presentation LUT

--default-plut: não cria presentation LUT (padrão)
--identity: define a forma de presentation LUT IDENTITY
--plut [l]ut identifier: string: adiciona a LUT l ao trabalho de impressão
--inverse-plut: renderiza a presentation LUT inversa no bitmap da imagem hardcopy grayscale
--illumination [v]alue: integer (0..65535): define a iluminação como v (em cd/m^2)
--reflection [v]alue: integer (0..65535): define a luz ambiente refletida como v (em cd/m^2)

opções básicas de film session (somente com –spool)

--copies [v]alue: integer (1..100, default: 1): define o número de cópias como v
--medium-type [v]alue: string: define o medium type como v
--destination [v]alue: string: define o film destination como v
--label [v]alue: string: define o film session label como v
--priority [v]alue: string: define a prioridade de impressão como v
--owner [v]alue: string: define o film session owner ID como v

opções de anotação

--no-annotation: não cria anotação (padrão)
-a --annotation [t]ext: string: cria uma anotação com o texto t
+pd --print-date: adiciona a data/hora no início da anotação (padrão)
-pd --print-no-date: não adiciona a data/hora no início da anotação
+pn --print-name: adiciona o nome da impressora no início da anotação (padrão)
-pn --print-no-name: não adiciona o nome da impressora no início da anotação
+pl --print-lighting: adiciona a iluminação no início da anotação (padrão)
-pl --print-no-lighting: não adiciona a iluminação no início da anotação

opções de overlay

+O --overlay [f]ilename: string, [x] [y]: integer: carrega os dados de overlay do arquivo PBM f e os exibe na posição (x,y)
+Og --ovl-graylevel [v]alue: integer (0..4095): usa o nível de cinza de overlay v (padrão: 4095 = branco)

outras opções de impressão

-l --layout [c]olumns [r]ows: integer (default: 1 1): usa o formato de exibição de imagem 'STANDARD\c,r'
--filmsize [v]alue: string: define o ID de tamanho de filme como v
--magnification [v]alue: string: define o tipo de ampliação como v
--smoothing [v]alue: string: define o tipo de suavização como v
--configinfo [v]alue: string: define as informações de configuração como v
--resolution [v]alue: string: define o ID de resolução solicitada como v
--border [v]alue: string: define a densidade de borda como v
--empty-image [v]alue: string: define a densidade de imagem vazia como v
--max-density [v]alue: string: define a densidade máxima como v
--min-density [v]alue: string: define a densidade mínima como v
--img-polarity [v]alue: string: define a polaridade da image box como v (NORMAL ou REVERSE)
--img-request-size [v]alue: string: define o tamanho de imagem solicitado como v (largura em mm)
--img-magnification [v]alue: string: define o tipo de ampliação da image box como v
--img-smoothing [v]alue: string: define o tipo de suavização da image box como v
--img-configinfo [v]alue: string: define as informações de configuração da image box como v

REGISTRO DE LOG

O nível de detalhamento do log das diversas ferramentas de linha de comando e das bibliotecas subjacentes pode ser especificado pelo usuário. Por padrão, apenas erros e avisos são gravados no fluxo de erro padrão. Ao usar a opção –verbose, mensagens informativas, como detalhes do processamento, também são relatadas. A opção –debug pode ser usada para obter mais detalhes sobre a atividade interna, por exemplo, para fins de depuração. Outros níveis de log podem ser selecionados com a opção –log-level. No modo –quiet, apenas erros fatais são relatados. Nesses casos de erro muito graves, o aplicativo normalmente é encerrado. Para mais detalhes sobre os diferentes níveis de log, consulte a documentação do módulo "oflog".

Caso a saída do log deva ser gravada em arquivo (opcionalmente com rotação de arquivo de log), no syslog (Unix) ou no log de eventos (Windows), pode-se usar a opção –log-config. Esse arquivo de configuração também permite direcionar apenas determinadas mensagens para um fluxo de saída específico e filtrar certas mensagens com base no módulo ou aplicativo em que são geradas. Um arquivo de configuração de exemplo é fornecido em < etcdir>/logger.cfg.

LINHA DE COMANDO

Todas as ferramentas de linha de comando usam a seguinte notação para os parâmetros: colchetes delimitam valores opcionais (0-1), reticências no final indicam que múltiplos valores são permitidos (1-n), e a combinação dos dois significa de 0 a n valores.

As opções de linha de comando se distinguem dos parâmetros por um sinal '+' ou '-' à frente. Normalmente, a ordem e a posição das opções de linha de comando são arbitrárias (ou seja, podem aparecer em qualquer lugar). No entanto, se as opções forem mutuamente exclusivas, é usada a ocorrência mais à direita. Esse comportamento está em conformidade com as regras de avaliação padrão dos shells Unix comuns.

Além disso, um ou mais arquivos de comando podem ser especificados usando um sinal '@' como prefixo do nome do arquivo (por exemplo, @command.txt). Esse argumento de comando é substituído pelo conteúdo do arquivo de texto correspondente (múltiplos espaços em branco são tratados como um único separador, a menos que apareçam entre duas aspas) antes de qualquer avaliação posterior. Observe que um arquivo de comando não pode conter outro arquivo de comando. Essa abordagem simples, mas eficaz, permite agrupar combinações comuns de opções/parâmetros e evita linhas de comando longas e confusas (um exemplo é fornecido no arquivo < datadir>/dumppat.txt).

AMBIENTE

O aplicativo dcmpsprt tenta carregar os dicionários de dados DICOM especificados na variável de ambiente DCMDICTPATH. Por padrão, ou seja, se a variável de ambiente DCMDICTPATH não estiver definida, o arquivo < datadir>/dicom.dic é carregado, a menos que o dicionário esteja integrado ao aplicativo (padrão para Windows).

É preferível manter o comportamento padrão e usar a variável de ambiente DCMDICTPATH apenas quando dicionários de dados alternativos forem necessários. A variável de ambiente DCMDICTPATH tem o mesmo formato da variável PATH dos shells Unix, em que dois-pontos (":") separam as entradas. Em sistemas Windows, um ponto e vírgula (";") é usado como separador. O código do dicionário de dados tenta carregar cada arquivo especificado na variável de ambiente DCMDICTPATH. Ocorre um erro se nenhum dicionário de dados puder ser carregado.

ARQUIVOS

< etcdir>/dcmpstat.cfg, < etcdir>/printers.cfg - exemplos de arquivos de configuração

VEJA TAMBÉM

dcmprscu(1)