DiDocument Class Reference

Interface class to DICOM data management (dcmdata). More...

Inheritance diagram for DiDocument:


Public Member Functions
	DiDocument (const char *filename, const unsigned long flags=0, const unsigned long fstart=0, const unsigned long fcount=0)
	constructor, open a DICOM file
	DiDocument (DcmObject *object, const E_TransferSyntax xfer, const unsigned long flags=0, const unsigned long fstart=0, const unsigned long fcount=0)
	constructor, use a given DcmObject
virtual	~DiDocument ()
	destructor
int	good () const
	check whether current document is valid
DcmObject *	getDicomObject () const
	get current DICOM object (dataset)
unsigned long	getFrameStart () const
	get first frame to be processed
unsigned long	getFrameCount () const
	get number of frames to be processed
unsigned long	getFlags () const
	get configuration flags
E_TransferSyntax	getTransferSyntax () const
	get transfer syntax of the DICOM dataset
DcmElement *	search (const DcmTagKey &tag, DcmObject *obj=NULL) const
	search for given tag
int	search (const DcmTagKey &tag, DcmStack &stack) const
	search for given tag and put result(s) on a stack
unsigned long	getVM (const DcmTagKey &tag) const
	get value multiplicity (VM) of given tag
unsigned long	getValue (const DcmTagKey &tag, Uint16 &returnVal, const unsigned long pos=0, DcmObject *item=NULL) const
	get value of given tag (Uint16)
unsigned long	getValue (const DcmTagKey &tag, Sint16 &returnVal, const unsigned long pos=0) const
	get value of given tag (Sint16)
unsigned long	getValue (const DcmTagKey &tag, Uint32 &returnVal, const unsigned long pos=0) const
	get value of given tag (Uint32)
unsigned long	getValue (const DcmTagKey &tag, Sint32 &returnVal, const unsigned long pos=0) const
	get value of given tag (Sint32)
unsigned long	getValue (const DcmTagKey &tag, double &returnVal, const unsigned long pos=0) const
	get value of given tag (double)
unsigned long	getValue (const DcmTagKey &tag, const Uint16 &returnVal, DcmObject item=NULL) const
	get value of given tag (Uint16 array)
unsigned long	getValue (const DcmTagKey &tag, const char &returnVal, DcmObject item=NULL) const
	get value of given tag (const char *)
unsigned long	getValue (const DcmTagKey &tag, OFString &returnVal, const unsigned long pos=0, DcmObject *item=NULL) const
	get value of given tag (OFString)
unsigned long	getSequence (const DcmTagKey &tag, DcmSequenceOfItems *&seq) const
	get sequence of given tag
Static Public Member Functions
static unsigned long	getElemValue (const DcmElement *elem, Uint16 &returnVal, const unsigned long pos=0)
	get value of given element (Uint16)
static unsigned long	getElemValue (const DcmElement elem, const Uint16 &returnVal)
	get value of given element (Uint16 array)
static unsigned long	getElemValue (const DcmElement elem, const char &returnVal)
	get value of given element (const char *)
static unsigned long	getElemValue (const DcmElement *elem, OFString &returnVal, const unsigned long pos=0)
	get value of given element (OFString)
Protected Member Functions
void	convertPixelData ()
	convert pixel data to uncompressed representation (if required)
Private Member Functions
	DiDocument (const DiDocument &)
DiDocument &	operator= (const DiDocument &)
Private Attributes
DcmObject *	Object
	reference to DICOM dataset (in memory)
DcmFileFormat *	FileFormat
	reference to DICOM fileformat (read from file, maybe NULL)
E_TransferSyntax	Xfer
	transfer syntax used for reading the dataset
unsigned long	FrameStart
	first frame to be processed
unsigned long	FrameCount
	number of frames to be processed
unsigned long	Flags
	configuration flags

Detailed Description

Interface class to DICOM data management (dcmdata).

NB: This is an internal class of module dcmimgle/dcmimage. Please do not use it for accessing DICOM data structures. Instead use the classes and functions provided by dcmdata (e.g. class DcmFileFormat, DcmItem).

Definition at line 68 of file didocu.h.

Constructor & Destructor Documentation

DiDocument::DiDocument ( const char * filename,

const unsigned long flags = 0,

const unsigned long fstart = 0,

const unsigned long fcount = 0

)

constructor, open a DICOM file

Parameters:

filename the DICOM file

flags configuration flags (only stored for later use)

fstart first frame to be processed (only stored for later use)

fcount number of frames (only stored for later use)

DiDocument::DiDocument ( DcmObject * object,

const E_TransferSyntax xfer,

const unsigned long flags = 0,

const unsigned long fstart = 0,

const unsigned long fcount = 0

)

constructor, use a given DcmObject

Parameters:

object pointer to dicom data structures

xfer transfer syntax

flags configuration flags (only stored for later use)

fstart first frame to be processed (only stored for later use)

fcount number of frames (only stored for later use)

Member Function Documentation

DcmObject* DiDocument::getDicomObject ( ) const [inline]

get current DICOM object (dataset)

Returns:
pointer to DICOM object

Definition at line 117 of file didocu.h.
References Object.

static unsigned long DiDocument::getElemValue ( const DcmElement * elem,

OFString & returnVal,

const unsigned long pos = 0

) [static]

get value of given element (OFString)

Parameters:

elem element where the value is stored

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

Returns:
VM if successful, 0 otherwise

static unsigned long DiDocument::getElemValue ( const DcmElement * elem,

const char *& returnVal

) [static]

get value of given element (const char *)

Parameters:

elem element where the value is stored

returnVal reference to the storage area for the resulting value

Returns:
VM if successful, 0 otherwise

static unsigned long DiDocument::getElemValue ( const DcmElement * elem,

const Uint16 *& returnVal

) [static]

get value of given element (Uint16 array)

Parameters:

elem element where the value is stored

returnVal reference to the storage area for the resulting value

Returns:
VM if successful, 0 otherwise

static unsigned long DiDocument::getElemValue ( const DcmElement * elem,

Uint16 & returnVal,

const unsigned long pos = 0

) [static]

get value of given element (Uint16)

Parameters:

elem element where the value is stored

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getFlags ( ) const [inline]

get configuration flags

Returns:
configuration flags

Definition at line 144 of file didocu.h.
References Flags.

unsigned long DiDocument::getFrameCount ( ) const [inline]

get number of frames to be processed

Returns:
number of frames to be processed

Definition at line 135 of file didocu.h.
References FrameCount.

unsigned long DiDocument::getFrameStart ( ) const [inline]

get first frame to be processed

Returns:
first frame to be processed

Definition at line 126 of file didocu.h.
References FrameStart.

unsigned long DiDocument::getSequence ( const DcmTagKey & tag,

DcmSequenceOfItems *& seq

) const

get sequence of given tag

Parameters:

tag tag to search for

seq reference to the storage area for the resulting value

Returns:
cardinality if successful, 0 otherwise

E_TransferSyntax DiDocument::getTransferSyntax ( ) const [inline]

get transfer syntax of the DICOM dataset

Returns:
transfer syntax

Definition at line 153 of file didocu.h.
References Xfer.

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

OFString & returnVal,

const unsigned long pos = 0,

DcmObject * item = NULL

) const

get value of given tag (OFString)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

item element in the dataset where the search should start (default: root)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

const char *& returnVal,

DcmObject * item = NULL

) const

get value of given tag (const char *)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

item element in the dataset where the search should start (default: root)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

const Uint16 *& returnVal,

DcmObject * item = NULL

) const

get value of given tag (Uint16 array)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

item element in the dataset where the search should start (default: root)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

double & returnVal,

const unsigned long pos = 0

) const

get value of given tag (double)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

Sint32 & returnVal,

const unsigned long pos = 0

) const

get value of given tag (Sint32)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

Uint32 & returnVal,

const unsigned long pos = 0

) const

get value of given tag (Uint32)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

Sint16 & returnVal,

const unsigned long pos = 0

) const

get value of given tag (Sint16)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getValue ( const DcmTagKey & tag,

Uint16 & returnVal,

const unsigned long pos = 0,

DcmObject * item = NULL

) const

get value of given tag (Uint16)

Parameters:

tag tag to search for

returnVal reference to the storage area for the resulting value

pos position in muti-valued elements (starting with 0)

item element in the dataset where the search should start (default: root)

Returns:
VM if successful, 0 otherwise

unsigned long DiDocument::getVM ( const DcmTagKey & tag ) const

get value multiplicity (VM) of given tag

Parameters:

tag tag to be searched

Returns:
VM if successful, 0 otherwise

int DiDocument::good ( ) const [inline]

check whether current document is valid

Returns:
status, true if successful, false otherwise

Definition at line 108 of file didocu.h.
References Object.

int DiDocument::search ( const DcmTagKey & tag,

DcmStack & stack

) const

search for given tag and put result(s) on a stack

Parameters:

tag tag to search for

stack stack where the result(s) should be stored

Returns:
status, true if successful, false otherwise

DcmElement* DiDocument::search ( const DcmTagKey & tag,

DcmObject * obj = NULL

) const

search for given tag

Parameters:

tag tag to search for

obj element in the dataset where the search should start (default: root)

Returns:
pointer to element if successful, NULL otherwise

The documentation for this class was generated from the following file:

dcmimgle/include/dcmtk/dcmimgle/didocu.h

Generated on 20 Dec 2005 for OFFIS DCMTK Version 3.5.4 by Doxygen 1.4.5

DiDocument Class Reference

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation