OFFIS DCMTK: DVPSDisplayedArea_PList Class Reference

List of all members.


Public Member Functions
	DVPSDisplayedArea_PList ()
	default constructor
	DVPSDisplayedArea_PList (const DVPSDisplayedArea_PList &copy)
	copy constructor
DVPSDisplayedArea_PList *	clone ()
	clone method.
virtual	~DVPSDisplayedArea_PList ()
	destructor
OFCondition	read (DcmItem &dset)
	reads a list of displayed area selections (DisplayedAreaSelectionSequence) from a DICOM dataset.
OFCondition	write (DcmItem &dset)
	writes the list of displayed area selections managed by this object to a DICOM dataset.
void	clear ()
	reset the object to initial state.
size_t	size () const
	gets the number of displayed area selections in this list.
DVPSDisplayedArea *	findDisplayedArea (const char *instanceUID, unsigned long frame)
	checks if an displayed area selection exists for the given image and frame.
DVPSDisplayedArea *	createDisplayedArea (DVPSReferencedSeries_PList &allReferences, const char sopclassUID, const char instanceUID, unsigned long frame, unsigned long numberOfFrames, DVPSObjectApplicability applicability)
	finds or creates a displayed area selection SQ item with an applicability controlled by the applicability, instanceUID and frame parameters.
void	rotateAndFlip (DVPSRotationType rotationFrom, OFBool isFlippedFrom, DVPSRotationType rotationTo, OFBool isFlippedTo)
	adjusts all displayed area coordinates for the rotation and flipping status of the image.
Private Member Functions
DVPSDisplayedArea_PList &	operator= (const DVPSDisplayedArea_PList &)
	private undefined assignment operator
Private Attributes
OFList< DVPSDisplayedArea * >	list_
	the list maintained by this object

Detailed Description

This class manages the data structures comprising one complete displayed area selection sequence contained in a presentation state object.

Member Function Documentation

DVPSDisplayedArea_PList* DVPSDisplayedArea_PList::clone ( ) [inline]

clone method.

Returns:: a pointer to a new DVPSDisplayedArea_PList object containing a deep copy of this object.

Definition at line 58 of file dvpsdal.h.

References DVPSDisplayedArea_PList().

OFCondition DVPSDisplayedArea_PList::read ( DcmItem & dset )

reads a list of displayed area selections (DisplayedAreaSelectionSequence) from a DICOM dataset.

The DICOM elements of the displayed area selection item are copied from the dataset to this object. The completeness of all items (presence of all required elements, value multiplicity) is checked. If this method returns an error code, the object is in undefined state afterwards.

Parameters:

dset

the DICOM dataset from which the sequence is to be read

Returns:: EC_Normal if successful, an error code otherwise.

OFCondition DVPSDisplayedArea_PList::write ( DcmItem & dset )

writes the list of displayed area selections managed by this object to a DICOM dataset.

Copies of the DICOM elements managed by this object are inserted into the DICOM dataset.

Parameters:

dset

the DICOM dataset to which the DisplayedAreaSelectionSequence is written

Returns:: EC_Normal if successful, an error code otherwise.

void DVPSDisplayedArea_PList::clear ( )

reset the object to initial state.

After this call, the object is in the same state as after creation with the default constructor.

size_t DVPSDisplayedArea_PList::size ( ) const [inline]

gets the number of displayed area selections in this list.

Returns:: the number of displayed area selections.

Definition at line 90 of file dvpsdal.h.

References list_, and OFList< T >::size().

DVPSDisplayedArea* DVPSDisplayedArea_PList::findDisplayedArea	(	const char *	instanceUID,
		unsigned long	frame
	)

checks if an displayed area selection exists for the given image and frame.

Parameters:

	instanceUID	SOP instance UID of the current image
	frame	number of the current frame

Returns:: pointer to the displayed area if it exists, NULL otherwise.

DVPSDisplayedArea* DVPSDisplayedArea_PList::createDisplayedArea	(	DVPSReferencedSeries_PList &	allReferences,
		const char *	sopclassUID,
		const char *	instanceUID,
		unsigned long	frame,
		unsigned long	numberOfFrames,
		DVPSObjectApplicability	applicability
	)

finds or creates a displayed area selection SQ item with an applicability controlled by the applicability, instanceUID and frame parameters.

The displayed area selection sequence is rearranged such that all other referenced images/frames keep their old displayed area settings.

Parameters:

	allReferences	list of series/instance references registered for the presentation state.
	sopclassUID	SOP class UID of the current image
	instanceUID	SOP instance UID of the current image
	frame	number of the current frame
	numberOfFrames	number of frames of the current image
	applicability	applicability of the new displayed area selection

Returns:: pointer to a displayed area selection object from the list that matches the applicability parameters. NULL is returned if out of memory.

void DVPSDisplayedArea_PList::rotateAndFlip	(	DVPSRotationType	rotationFrom,
		OFBool	isFlippedFrom,
		DVPSRotationType	rotationTo,
		OFBool	isFlippedTo
	)

adjusts all displayed area coordinates for the rotation and flipping status of the image.

Parameters:

	rotationFrom	previous rotation
	isFlippedFrom	previous flip status
	rotationTo	new rotation
	isFlippedTo	new flip status

DVPSDisplayedArea_PList Class Reference

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation