dctopgm8(1) [debian man page]

DCTOPGM8(1)						DICOM PS3 - DICOM image to PNM file					       DCTOPGM8(1)

NAME

       dctopgm8 - ACR/NEMA DICOM PS3 ... DICOM PS3 - DICOM image to PNM file

SYNOPSIS

       dctopgm8  [ -v|verbose ] [ -quiet|silent ] -windowwidth width ] -windowlevel|windowcenter center ] -ignorewindow ] -voilut numberfromzero ]
		 -ignorevoilut ] -invertedgray ] -signed|unsigned ]

DESCRIPTION

       dctopgm8 reads the named dicom or acr-nema input file, converts it to an 8 bit grayscale image by windowing or application of a VOI LUT and
       saves it as a PGM file.

       In  the	absence of overriding command line options, the default behavior is to apply the first VOI LUT found, else if none, the first pair
       of window values in the input file, else if none, the full range of the input pixel values.

       The input file must be unencapsulated.

OPTIONS

       The PGM output goes where it is specified or standard out.  The verbose output goes to standard error.

       The basic input switches are described in dcintro(1). Options specific to this program are:

       -quiet|silent
	      Suppress the normal description of image parameters.

       -verbose
	      Display byte offset from file start and message start, in hexadecimal, and dump contents while reading, once read,  during  replace-
	      ment, and before writing.

       -windowwidth width
	      The window width to use (also supresses use of any VOI LUT).

       -windowlevel|windowcenter center
	      The window center to use (also supresses use of any VOI LUT).

       -ignorewindow
	      Ignore  window  center  and  width  values  in  the input file, and use the full pixel value range instead (if no other command line
	      options).

       -voilut numberfromzero
	      Use the selected VOI LUT from the input file (indexed from 0 not 1).

       -ignorevoilut
	      Ignore any VOI LUTs in the input file, and use the window values or the full pixel value range instead (if  no  other  command  line
	      options).

       -invertedgray
	      Invert the grayscale, overriding the PhotometricInterpretation in the input file.

       -signed|unsigned
	      Override the sign specified in the PixelRepresentation in the input file.

ENVIRONMENT


EXAMPLES


       % dctopgm8 file.dcm file.pgm
       Read ...
	    Rows = 2294
	    Columns = 1914
	    NumberOfFrames = 0
	    PhotometricInterpretation = MONOCHROME2
	    SamplesPerPixel = 1
	    BitsAllocated = 16
	    BitsStored = 12
	    HighBit = 11
	    PixelRepresentation = 0
	    PlanarConfiguration = 0
	    RescaleIntercept = 0
	    RescaleSlope = 1
	    WindowCenter = 2905
	    WindowWidth = 900
	    VOILUTs = 3
	    PixelData Value Length = 0x85fe78
       Setting window values extracted from object because present not set on command line
       Using ...
	    Rows = 2294
	    Columns = 1914
	    NumberOfFrames = 1
	    PhotometricInterpretation = MONOCHROME2
	    SamplesPerPixel = 1
	    BitsAllocated = 16
	    BitsStored = 12
	    HighBit = 11
	    PixelRepresentation = 0
	    PlanarConfiguration = 0
	    RescaleIntercept = 0
	    RescaleSlope = 1
	    WindowCenter =
	    WindowWidth =
	    VOILUTs = 0 of 3
	    Rows*Columns*SamplesPerPixel*BitsAllocated/8 = 0x85fe78
       Writing ...
       Applying VOILUT 0

FILES


SEE ALSO

       dccp(1), pnmtodc(1), rawtodc(1), dctopnm(1), dctoraw(1), dcintro(1)

AUTHOR

       Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. All rights reserved.

BUGS

DICOM PS3							 04 December 2010						       DCTOPGM8(1)

Check Out this Related Man Page

DCTOPGX(1)						DICOM PS3 - DICOM image to PGX file						DCTOPGX(1)

NAME

       dctopgx - ACR/NEMA DICOM PS3 ... DICOM PS3 - DICOM image to PGX file

SYNOPSIS

       dctopgx [ -v|verbose ] [ -quiet|silent ]

DESCRIPTION

       dctopgx	reads the named dicom or acr-nema input file and copies the raw image pixel data to a PGX file as used for the JPEG 2000 Verifica-
       tion Model.

       A PGX file contains of a single text header line of the form "PG <byte order> [+|-]<bit-depth> <cols> <rows> immediately by the raw  binary
       data.  There  may  be 1, 2 or 4 bytes per sample corresponding to bit depths from 1 to 32.  Byte order is "LM" (little endian) or "ML" (big
       endian). The signed or unsigned pixel representation is indicated by '+' or '-' character before the bit depth.	If  the  '+'  is  omitted,
       unsigned is implied.

       The input file must be unencapsulated.

       PGX  supports  big or little endian byte order in the case of > 8 bit data. The output byte order is always in the same as the input, since
       the raw bytes are copied from input to output without any conversion. Use dccp(1) first to change the encoding if necessary.

       PGX also supports signed data, so the Pixel Representation of the input is used to specify whether the output is signed or unsigned.

OPTIONS

       The PGX output goes where it is specified or standard out.  The verbose output goes to standard error.

       The basic input switches are described in dcintro(1). Options specific to this program are:

       -quiet|silent
	      Suppress the normal description of image parameters.

       -verbose
	      Display byte offset from file start and message start, in hexadecimal, and dump contents while reading, once read,  during  replace-
	      ment, and before writing.

ENVIRONMENT


EXAMPLES

FILES


SEE ALSO

       dccp(1), pnmtodc(1), dctopnm(1), rawtodc(1), dctoraw(1), dcintro(1)

AUTHOR

       Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. All rights reserved.

BUGS

DICOM PS3							   04 March 1999							DCTOPGX(1)

Linux and UNIX Man Pages

dctopgm8(1) [debian man page]

Check Out this Related Man Page