DSRWaveformReferenceValue Class Reference

Class for waveform reference values. More...

Inheritance diagram for DSRWaveformReferenceValue:

DSRCompositeReferenceValue DSRWaveformTreeNode List of all members.

Public Member Functions

 DSRWaveformReferenceValue ()
 default contructor
 DSRWaveformReferenceValue (const OFString &sopClassUID, const OFString &sopInstanceUID)
 constructor.
 DSRWaveformReferenceValue (const DSRWaveformReferenceValue &referenceValue)
 copy constructor
virtual ~DSRWaveformReferenceValue ()
 destructor
DSRWaveformReferenceValueoperator= (const DSRWaveformReferenceValue &referenceValue)
 assignment operator
virtual void clear ()
 clear all internal variables.
virtual OFBool isShort (const size_t flags) const
 check whether the content is short.
virtual OFCondition print (ostream &stream, const size_t flags) const
 print waveform reference.
virtual OFCondition readXML (const DSRXMLDocument &doc, DSRXMLCursor cursor)
 read waveform reference from XML document
virtual OFCondition writeXML (ostream &stream, const size_t flags, OFConsole *logStream) const
 write waveform reference in XML format
virtual OFCondition renderHTML (ostream &docStream, ostream &annexStream, size_t &annexNumber, const size_t flags, OFConsole *logStream) const
 render waveform reference value in HTML format
const DSRWaveformReferenceValuegetValue () const
 get reference to waveform reference value
OFCondition getValue (DSRWaveformReferenceValue &referenceValue) const
 get copy of waveform reference value
OFCondition setValue (const DSRWaveformReferenceValue &referenceValue)
 set waveform reference value.
DSRWaveformChannelListgetChannelList ()
 get reference to list of referenced waveform channels
OFBool appliesToChannel (const Uint16 multiplexGroupNumber, const Uint16 channelNumber) const
 check whether the waveform reference applies to a specific channel.

Protected Member Functions

DSRWaveformReferenceValuegetValuePtr ()
 get pointer to waveform reference value
virtual OFCondition readItem (DcmItem &dataset, OFConsole *logStream)
 read waveform reference value from dataset
virtual OFCondition writeItem (DcmItem &dataset, OFConsole *logStream) const
 write waveform reference value to dataset
virtual OFBool checkSOPClassUID (const OFString &sopClassUID) const
 check the specified SOP class UID for validity.

Private Attributes

DSRWaveformChannelList ChannelList
 list of referenced waveform channels (associated DICOM VR=US, VM=2-2n, type 1C)

Friends

class DSRContentItem

Detailed Description

Class for waveform reference values.

Definition at line 51 of file dsrwavvl.h.


Constructor & Destructor Documentation

DSRWaveformReferenceValue::DSRWaveformReferenceValue const OFString sopClassUID,
const OFString sopInstanceUID
 

constructor.

The UID pair is only set if it passed the validity check (see setValue()).

Parameters:
sopClassUID referenced SOP class UID of the waveform object. (VR=UI, mandatory)
sopInstanceUID referenced SOP instance UID of the waveform object. (VR=UI, mandatory)

DSRWaveformReferenceValue::DSRWaveformReferenceValue const DSRWaveformReferenceValue referenceValue  ) 
 

copy constructor

Parameters:
referenceValue waveform reference value to be copied (not checked !)


Member Function Documentation

OFBool DSRWaveformReferenceValue::appliesToChannel const Uint16  multiplexGroupNumber,
const Uint16  channelNumber
const
 

check whether the waveform reference applies to a specific channel.

The waveform reference applies to a channel if the list of referenced waveform channels is empty or the group/channel pair is part of the list.

Parameters:
multiplexGroupNumber multiplex group number of the referenced channel
channelNumber channel number of the referenced channel
Returns:
OFTrue if reference applies to the specified channel, OFFalse otherwise

virtual OFBool DSRWaveformReferenceValue::checkSOPClassUID const OFString sopClassUID  )  const [protected, virtual]
 

check the specified SOP class UID for validity.

Currently all waveform SOP classes that are defined in DICOM PS 3.x 2003 are allowed.

Parameters:
sopClassUID SOP class UID to be checked
Returns:
OFTrue if SOP class UID is valid, OFFalse otherwise

Reimplemented from DSRCompositeReferenceValue.

virtual void DSRWaveformReferenceValue::clear  )  [virtual]
 

clear all internal variables.

Since an empty waveform reference is invalid the reference becomes invalid afterwards.

Reimplemented from DSRCompositeReferenceValue.

Reimplemented in DSRWaveformTreeNode.

DSRWaveformChannelList& DSRWaveformReferenceValue::getChannelList  )  [inline]
 

get reference to list of referenced waveform channels

Returns:
reference to channel list

Definition at line 170 of file dsrwavvl.h.

References ChannelList.

OFCondition DSRWaveformReferenceValue::getValue DSRWaveformReferenceValue referenceValue  )  const
 

get copy of waveform reference value

Parameters:
referenceValue reference to variable in which the value should be stored
Returns:
status, EC_Normal if successful, an error code otherwise

const DSRWaveformReferenceValue& DSRWaveformReferenceValue::getValue  )  const [inline]
 

get reference to waveform reference value

Returns:
reference to waveform reference value

Reimplemented from DSRCompositeReferenceValue.

Definition at line 148 of file dsrwavvl.h.

DSRWaveformReferenceValue* DSRWaveformReferenceValue::getValuePtr  )  [inline, protected]
 

get pointer to waveform reference value

Returns:
pointer to waveform reference value (never NULL)

Reimplemented from DSRCompositeReferenceValue.

Definition at line 191 of file dsrwavvl.h.

virtual OFBool DSRWaveformReferenceValue::isShort const size_t  flags  )  const [virtual]
 

check whether the content is short.

This method is used to check whether the rendered output of this content item can be expanded inline or not (used for renderHTML()).

Parameters:
flags flag used to customize the output (see DSRTypes::HF_xxx)
Returns:
OFTrue if the content is short, OFFalse otherwise

Reimplemented in DSRWaveformTreeNode.

DSRWaveformReferenceValue& DSRWaveformReferenceValue::operator= const DSRWaveformReferenceValue referenceValue  ) 
 

assignment operator

Parameters:
referenceValue waveform reference value to be copied (not checked !)
Returns:
reference to this waveform reference value after 'referenceValue' has been copied

virtual OFCondition DSRWaveformReferenceValue::print ostream &  stream,
const size_t  flags
const [virtual]
 

print waveform reference.

The output of a typical waveform reference value looks like this: (HemodynamicWaveform Storage,"1.2.3") If the SOP class UID is unknown the UID is printed instead of the related name.

Parameters:
stream output stream to which the image reference value should be printed
flags flag used to customize the output (see DSRTypes::PF_xxx)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRCompositeReferenceValue.

Reimplemented in DSRWaveformTreeNode.

virtual OFCondition DSRWaveformReferenceValue::readItem DcmItem dataset,
OFConsole logStream
[protected, virtual]
 

read waveform reference value from dataset

Parameters:
dataset DICOM dataset from which the value should be read
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRCompositeReferenceValue.

virtual OFCondition DSRWaveformReferenceValue::readXML const DSRXMLDocument doc,
DSRXMLCursor  cursor
[virtual]
 

read waveform reference from XML document

Parameters:
doc document containing the XML file content
cursor cursor pointing to the starting node
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRCompositeReferenceValue.

virtual OFCondition DSRWaveformReferenceValue::renderHTML ostream &  docStream,
ostream &  annexStream,
size_t &  annexNumber,
const size_t  flags,
OFConsole logStream
const [virtual]
 

render waveform reference value in HTML format

Parameters:
docStream output stream to which the main HTML document is written
annexStream output stream to which the HTML document annex is written
annexNumber reference to the variable where the current annex number is stored. Value is increased automatically by 1 after a new entry has been added.
flags flag used to customize the output (see DSRTypes::HF_xxx)
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRCompositeReferenceValue.

OFCondition DSRWaveformReferenceValue::setValue const DSRWaveformReferenceValue referenceValue  ) 
 

set waveform reference value.

Before setting the reference it is checked (see checkXXX()). If the value is invalid the current value is not replaced and remains unchanged.

Parameters:
referenceValue value to be set
Returns:
status, EC_Normal if successful, an error code otherwise

virtual OFCondition DSRWaveformReferenceValue::writeItem DcmItem dataset,
OFConsole logStream
const [protected, virtual]
 

write waveform reference value to dataset

Parameters:
dataset DICOM dataset to which the value should be written
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRCompositeReferenceValue.

virtual OFCondition DSRWaveformReferenceValue::writeXML ostream &  stream,
const size_t  flags,
OFConsole logStream
const [virtual]
 

write waveform reference in XML format

Parameters:
stream output stream to which the XML document is written
flags flag used to customize the output (see DSRTypes::XF_xxx)
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRCompositeReferenceValue.

Reimplemented in DSRWaveformTreeNode.


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


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