An experimental decoder for private DICOM sequence tags. More...

#include <mlPrivateSequenceDICOMTagDecoders.h>

Inheritance diagram for ml::PrivateSequenceDICOMTagDecoders:

Public Member Functions
	PrivateSequenceDICOMTagDecoders ()
	Constructor doing nothing.

	~PrivateSequenceDICOMTagDecoders () override

PrivateDICOMTagDecoderPluginBase::DecodeStates	decodePrivateTag (const std::string &privateCreator, DCMTree::Const_TagPtr tagPtr, PrivateDICOMTagValueFields &resultFields) override
	If a private sequence tag is passed then this routine tried to converts its data element(s) to fields in resultFields container.

Protected Member Functions
PrivateDICOMTagDecoderPluginBase::DecodeStates	_extractDump (const DCMTree::Value &tagVal, bool implicit, PrivateDICOMTagValueFields &resultFields) const
	Expects the tag value of a private sequence tag and tries to decode it as far as possible as human readable information appended to resultFields.

Protected Member Functions inherited from ml::GenericPrivateDICOMTagDecoder
bool	_getTagNameAndVrFromId (unsigned int groupId, unsigned int elementId, std::string &retName, std::string &retVr) const
	Determines the tag name and value representation corresponding to a tag id given by groupId and elementId and returns true, or - if it cannot be determined - it returns false.

const unsigned char *	_findStr (const unsigned char *buffer, const std::string &str, size_t bufferSize) const
	Returns the pointer to the first occurrence of str in the buffer given by buffer and bufferSize.

PrivateDICOMTagDecoderPluginBase::DecodeStates	_decodeSequenceTagData (const std::string &prefix, const unsigned char *&tagData, MLuint32 &tagDataSize, bool implicit, PrivateDICOMTagValueFields &resultFields, bool translateStdIdToName) const
	Extract a sequence of DICOM tag values whose value representations are given in VRs.

	GenericPrivateDICOMTagDecoder ()=default
	Constructor doing nothing.

	GenericPrivateDICOMTagDecoder (const GenericPrivateDICOMTagDecoder &)=default
	Default copy constructor.

GenericPrivateDICOMTagDecoder &	operator= (const GenericPrivateDICOMTagDecoder &)=default
	Default assignment operator.

	~GenericPrivateDICOMTagDecoder () override
	Destructor.

PrivateDICOMTagDecoderPluginBase::DecodeStates	decodePrivateTag (const std::string &privateCreator, DCMTree::Const_TagPtr tagPtr, PrivateDICOMTagValueFields &resultFields) override
	If a private Toshiba PMTF header tag is passed then this routine converts its data element(s) to fields in resultFields container.

PrivateDICOMTagDecoderPluginBase::DecodeStates	extractTag (const std::string &prefix, const unsigned char *&tagData, MLuint32 &tagDataSize, bool decodeImplicitSeqVR, PrivateDICOMTagValueFields &resultFields, bool translateStdIdToName) const
	Assume a DICOM tag as binary data and add human readable information to resultFields of the tag id, names, and content(s) as far as it can be decoded.

Additional Inherited Members
Static Protected Member Functions inherited from ml::GenericPrivateDICOMTagDecoder
static std::string	_dumpRange (const unsigned char *start, size_t num=16, bool showStartAddress=true, bool showHexDump=true, bool showASCII=true, size_t maxRowSize=16, char defaultNonReadableChar='.')
	Creates a string containing one row with a hexadecimal start address of the buffer, hexadecimal byte data values, and ASCII dump corresponding to the data bytes.

static void	dumpHexArea (const std::string &prefix, const unsigned char *tagData, size_t tagDataSize, PrivateDICOMTagValueFields &resultFields, size_t rowSize=16, size_t maxBytesToDump=ML_SIZE_T_MAX)
	Add a range of bytes as a hex dump to the PrivateDICOMTagValueFields resultFields as "otherInfo" tag information with disabled "isValidTag" flag.

static bool	isValidVRString (const std::string &vrStr)
	Returns true if the passed VR string is a valid known one, otherwise false.

Detailed Description

An experimental decoder for private DICOM sequence tags.

Definition at line 20 of file mlPrivateSequenceDICOMTagDecoders.h.

Constructor & Destructor Documentation

◆ PrivateSequenceDICOMTagDecoders()

ml::PrivateSequenceDICOMTagDecoders::PrivateSequenceDICOMTagDecoders ( )

Constructor doing nothing.

◆ ~PrivateSequenceDICOMTagDecoders()

ml::PrivateSequenceDICOMTagDecoders::~PrivateSequenceDICOMTagDecoders ( )

override

Member Function Documentation

◆ _extractDump()

PrivateDICOMTagDecoderPluginBase::DecodeStates ml::PrivateSequenceDICOMTagDecoders::_extractDump	(	const DCMTree::Value &	tagVal,
		bool	implicit,
		PrivateDICOMTagValueFields &	resultFields
	)		const

protected

Expects the tag value of a private sequence tag and tries to decode it as far as possible as human readable information appended to resultFields.

Parameters

tagVal	The value of the private sequence tag to be decoded.
implicit	If false then an explicitly coded tag is assumed, otherwise the VR is determined from the tag id.
resultFields	The container to be extended by decoded tag information.

Returns: All successfully decoded tag information is appended as additional elements to resultFields. On failure or inappropriate input data resultFields might be changed and extended by all information up to the error position. The return code shows whether a full, partial or no decoding took place.

◆ decodePrivateTag()

PrivateDICOMTagDecoderPluginBase::DecodeStates ml::PrivateSequenceDICOMTagDecoders::decodePrivateTag	(	const std::string &	privateCreator,
		DCMTree::Const_TagPtr	tagPtr,
		PrivateDICOMTagValueFields &	resultFields
	)

override

If a private sequence tag is passed then this routine tried to converts its data element(s) to fields in resultFields container.

The privateCreator must be a "GEIIS" or a "KONICA1.0" one.

Parameters

privateCreator	A string with the name of the private creator this tags belongs to.
tagPtr	The tag whose value shall be decoded.
resultFields	The field container to be filled with extracted information from tagPtr or returned empty if no data could be decoded.

Returns: PrivateDICOMTagDecoderPluginBase::NOT_DECODED if the tag could not be decoded, PrivateDICOMTagDecoderPluginBase::PARTIALLY_DECODED if some of the tag value components were decoded or PrivateDICOMTagDecoderPluginBase::FULLY_DECODED if entire tag value could be decoded.

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

FMEstable/ReleaseMeVis/Projects/DICOM/MLPrivateSequenceDICOMTagDecoders/Sources/mlPrivateSequenceDICOMTagDecoders.h

Public Member Functions

Protected Member Functions