dcmprscu: spooler de impressão para visualizador de presentation state

SINOPSE

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

DESCRIÇÃO

O aplicativo dcmprscu implementa a DICOM Basic Grayscale Print Management Service Class como SCU. Ele também oferece suporte às Basic Annotation Box e Presentation LUT SOP Classes opcionais. O aplicativo é destinado ao uso dentro do visualizador DICOMscope.

O aplicativo dcmprscu recebe trabalhos de impressão completos, compostos por um objeto Stored Print e um ou mais objetos Hardcopy Grayscale, e os coloca na fila da impressora. Nenhuma verificação é feita para saber se o Print SCP oferece suporte aos atributos definidos no objeto Stored Print. Porém, o spooler de impressão não tentará usar os serviços opcionais de Annotation ou Presentation LUT caso eles não tenham sido negociados com sucesso com o Print SCP.

O aplicativo dcmprscu lê no arquivo de configuração as características da impressora com a qual se comunicar. Dependendo do suporte da impressora à Presentation LUT, qualquer Presentation LUT presente no trabalho de impressão é renderizada nas imagens hardcopy antes que estas sejam enviadas à impressora, se necessário. Se a impressora não oferecer suporte à transmissão de imagens a 12 bits/pixel (conforme o arquivo de configuração), as imagens hardcopy em escala de cinza são subamostradas para 8 bits/pixel antes da transmissão à impressora.

O aplicativo dcmprscu pode ser executado em "modo impressora", caso em que o nome de arquivo de um objeto Stored Print deve ser informado, ou em "modo spooler", caso em que comandos são lidos periodicamente de um diretório de spool.

PARÂMETROS

dcmfile-in   stored print file(s) to be spooled ("-" for 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 impressão

--noprint: não gera saída impressa (nenhum n-action-rq)
--session-print: envia o n-action-rq de film session (em vez de film box)
--monochrome1: transmite as imagens basic grayscale em MONOCHROME1

opções de modo

+p --print: modo impressora, imprime o(s) arquivo(s) e encerra (padrão)
+s --spool [n]ame: string: modo spooler, usa n como prefixo do trabalho

opções de processamento

-c --config [f]ilename: string: processa usando as configurações do arquivo de configuração
-p --printer [n]ame: string (default: 1st printer in cfg file): seleciona a impressora com identificador n no arquivo cfg
+d --dump: faz o dump de todas as mensagens DIMSE

opções do spooler (apenas com –spool)

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

opções básicas de film session (não usar 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

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 dcmprscu 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 embutido no aplicativo (padrão no 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

dcmprscp(1)