Program: gdcm
Module: $RCSfile: gdcmSeqEntry.cxx,v $
Language: C++
- Date: $Date: 2004/10/22 03:05:42 $
- Version: $Revision: 1.32 $
+ Date: $Date: 2005/11/29 12:48:47 $
+ Version: $Revision: 1.63 $
Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
l'Image). All rights reserved. See Doc/License.txt or
#include "gdcmTS.h"
#include "gdcmGlobal.h"
#include "gdcmUtil.h"
+#include "gdcmDebug.h"
#include <iostream>
#include <iomanip>
namespace gdcm
{
-
//-----------------------------------------------------------------------------
// Constructor / Destructor
/**
- * \ingroup SeqEntry
* \brief Constructor from a given SeqEntry
*/
-SeqEntry::SeqEntry( DictEntry* e )
+SeqEntry::SeqEntry( DictEntry *e )
: DocEntry(e)
{
- UsableLength = 0;
- ReadLength = 0xffffffff;
+ Length = 0;
+ ReadLength = 0xffffffff;
SQDepthLevel = -1;
- delimitor_mode = false;
- seq_term = NULL;
+ DelimitorMode = false;
+ SeqTerm = NULL;
}
/**
- * \brief Constructor from a given SeqEntry
+ * \brief Constructor from a given DocEntry
* @param e Pointer to existing Doc entry
* @param depth depth level of the current Seq entry
- */
-SeqEntry::SeqEntry( DocEntry* e, int depth )
+ */
+SeqEntry::SeqEntry( DocEntry *e, int depth )
: DocEntry( e->GetDictEntry() )
{
- this->UsableLength = 0;
- this->ReadLength = 0xffffffff;
+ Length = 0;
+ ReadLength = 0xffffffff;
SQDepthLevel = depth;
- this->ImplicitVR = e->IsImplicitVR();
- this->Offset = e->GetOffset();
+ ImplicitVR = e->IsImplicitVR();
+ Offset = e->GetOffset();
+ SeqTerm = NULL;
}
/**
* \brief Canonical destructor.
*/
-SeqEntry::~SeqEntry() {
- for(ListSQItem::iterator cc = items.begin();cc != items.end();++cc)
- {
- delete *cc;
- }
- if (!seq_term)
- delete seq_term;
-}
-
-/**
- * \brief canonical Printer
- */
-void SeqEntry::Print( std::ostream &os )
+SeqEntry::~SeqEntry()
{
- // First, Print the Dicom Element itself.
- SetPrintLevel(2);
- DocEntry::Print(os);
- os << std::endl;
-
- if (GetReadLength() == 0)
- return;
-
- // Then, Print each SQ Item
- for(ListSQItem::iterator cc = items.begin();cc != items.end();++cc)
- {
- (*cc)->Print(os);
- }
-
- // at end, print the sequence terminator item, if any
- if (delimitor_mode) {
- for ( int i = 0; i < SQDepthLevel; i++ )
- {
- os << " | " ;
- }
- if (seq_term != NULL)
- {
- seq_term->Print(os);
- os << std::endl;
- }
- else
- {
- // fuse
- os << " -------------- should have a sequence terminator item";
- }
- }
+ ClearSQItem();
}
+//-----------------------------------------------------------------------------
+// Public
/*
* \brief canonical Writer
+ * @param fp pointer to an already open file
+ * @param filetype type of the file (ACR, ImplicitVR, ExplicitVR, ...)
*/
-void SeqEntry::Write(std::ofstream* fp, FileType filetype)
+void SeqEntry::WriteContent(std::ofstream *fp, FileType filetype)
{
uint16_t seq_term_gr = 0xfffe;
uint16_t seq_term_el = 0xe0dd;
uint32_t seq_term_lg = 0xffffffff;
-
- //uint16_t item_term_gr = 0xfffe;
- //uint16_t item_term_el = 0xe00d;
-
- DocEntry::Write(fp, filetype);
- for(ListSQItem::iterator cc = GetSQItems().begin();
- cc != GetSQItems().end();
+
+ // ignore 'Zero length' Sequences
+ if ( GetReadLength() == 0 )
+ return;
+
+ DocEntry::WriteContent(fp, filetype);
+ for(ListSQItem::iterator cc = Items.begin();
+ cc != Items.end();
++cc)
{
- (*cc)->Write(fp, filetype);
+ (*cc)->WriteContent(fp, filetype);
}
// we force the writting of a Sequence Delimitation item
// because we wrote the Sequence as a 'no Length' sequence
- fp->write ( (char*)&seq_term_gr,(size_t)2 );
- fp->write ( (char*)&seq_term_el,(size_t)2 );
- fp->write ( (char*)&seq_term_lg,(size_t)4 );
+ binary_write(*fp, seq_term_gr);
+ binary_write(*fp, seq_term_el);
+ binary_write(*fp, seq_term_lg);
}
-//-----------------------------------------------------------------------------
-// Public
+/**
+ * \brief Compute the full length of the SeqEntry (not only value
+ * length) depending on the VR.
+ */
+uint32_t SeqEntry::ComputeFullLength()
+{
+ uint32_t l = 12; // Tag (4) + VR (explicit) 4 + 4 (length);
+ for(ListSQItem::iterator cc = Items.begin();
+ cc != Items.end();
+ ++cc)
+ {
+ l += (*cc)->ComputeFullLength();
+ }
+ l += 8; // seq_term Tag (4) + seq_term_lg (4)
+ return l;
+}
-/// \brief adds the passed ITEM to the ITEM chained List for this SeQuence.
-void SeqEntry::AddEntry(SQItem *sqItem, int itemNumber)
+/**
+ * \brief adds the passed ITEM to the ITEM chained List for this SeQuence.
+ * @param sqItem SQItem to be pushed back in the SeqEntry
+ * @param itemNumber ordinal number of the SQItem
+ * \note NOT end-user intendend method !
+ */
+void SeqEntry::AddSQItem(SQItem *sqItem, int itemNumber)
{
+// FIXME : SQItemNumber is supposed to be the ordinal number of the SQItem
+// within the Sequence.
+// Either only 'push_back' is allowed,
+// and we just have to do something like SeqEntry::lastNb++
+// Or we can add (or remove) anywhere, and SQItemNumber will be broken
sqItem->SetSQItemNumber(itemNumber);
- items.push_back(sqItem);
+ Items.push_back(sqItem);
+ sqItem->Register();
+}
+
+/**
+ * \brief Remove all SQItem.
+ */
+void SeqEntry::ClearSQItem()
+{
+ for(ListSQItem::iterator cc = Items.begin(); cc != Items.end(); ++cc)
+ {
+ (*cc)->Unregister();
+ }
+ if (SeqTerm)
+ {
+ SeqTerm->Unregister();
+ }
}
+/**
+ * \brief Get the first entry while visiting the SeqEntry
+ * \return The first SQItem if found, otherwhise NULL
+ */
+SQItem *SeqEntry::GetFirstSQItem()
+{
+ ItSQItem = Items.begin();
+ if (ItSQItem != Items.end())
+ return *ItSQItem;
+ return NULL;
+}
+
+/**
+ * \brief Get the next SQItem while visiting the SeqEntry
+ * \note : meaningfull only if GetFirstEntry already called
+ * \return The next SQItem if found, otherwhise NULL
+ */
+
+SQItem *SeqEntry::GetNextSQItem()
+{
+ gdcmAssertMacro (ItSQItem != Items.end())
+ {
+ ++ItSQItem;
+ if (ItSQItem != Items.end())
+ return *ItSQItem;
+ }
+ return NULL;
+}
+
/**
* \brief return a pointer to the SQItem referenced by its ordinal number.
* Returns the first item when argument is negative.
- * Returns the last item when argument is bigget than the total
+ * Returns the last item when argument is bigger than the total
* item number.
*/
-SQItem* SeqEntry::GetSQItemByOrdinalNumber(int nb)
+SQItem *SeqEntry::GetSQItem(int nb)
{
if (nb<0)
- return (*(items.begin()));
+ {
+ return *(Items.begin());
+ }
int count = 0 ;
- for(ListSQItem::iterator cc = items.begin();
- cc != items.end();
- count ++, ++cc){
- if (count==nb)
+ for(ListSQItem::iterator cc = Items.begin();
+ cc != Items.end();
+ count ++, ++cc)
+ {
+ if (count == nb)
+ {
return *cc;
+ }
+ }
+ return *(Items.end());
+}
+
+/**
+ * \brief returns the number of SQItems within the current Sequence
+ */
+unsigned int SeqEntry::GetNumberOfSQItems()
+{
+ return Items.size();
+}
+
+/**
+ * \brief Sets the Sequence Delimitation Item
+ * \param e Delimitation item
+ */
+void SeqEntry::SetDelimitationItem(DocEntry *e)
+{
+ if( SeqTerm != e )
+ {
+ if( SeqTerm )
+ SeqTerm->Unregister();
+ SeqTerm = e;
+ if( SeqTerm )
+ SeqTerm->Register();
+ }
+}
+
+/**
+ * \brief Copies all the attributes from an other DocEntry
+ * @param doc entry to copy from
+ * @remarks The contained SQItems a not copied, only referenced
+ */
+void SeqEntry::Copy(DocEntry *doc)
+{
+ // Delete previous SQ items
+ ClearSQItem();
+
+ DocEntry::Copy(doc);
+ SeqEntry *entry = dynamic_cast<SeqEntry *>(doc);
+ if ( entry )
+ {
+ DelimitorMode = entry->DelimitorMode;
+ SQDepthLevel = entry->SQDepthLevel;
+
+ SeqTerm = entry->SeqTerm;
+ if(SeqTerm)
+ SeqTerm->Register();
+ Items = entry->Items;
+ for(ItSQItem = Items.begin();ItSQItem != Items.end(); ++ItSQItem)
+ {
+ (*ItSQItem)->Register();
+ }
}
- return (*(items.end())); // Euhhhhh ?!? Is this the last one . FIXME
}
+
//-----------------------------------------------------------------------------
// Protected
-
//-----------------------------------------------------------------------------
// Private
//-----------------------------------------------------------------------------
-} // end namespace gdcm
+// Print
+/**
+ * \brief canonical Printer
+ */
+void SeqEntry::Print( std::ostream &os, std::string const & )
+{
+ // First, Print the Dicom Element itself.
+ os << "S ";
+ DocEntry::Print(os);
+ os << std::endl;
+
+ if (GetReadLength() == 0)
+ return;
+
+ // Then, Print each SQ Item
+ for(ListSQItem::iterator cc = Items.begin(); cc != Items.end(); ++cc)
+ {
+ (*cc)->SetPrintLevel(PrintLevel);
+ (*cc)->Print(os);
+ }
+ // at end, print the sequence terminator item, if any
+ if (DelimitorMode)
+ {
+ int i;
+ for ( i = 0; i < SQDepthLevel; i++ )
+ os << " | " ;
+ os << " --- " << std::endl;
+ for ( i = 0; i < SQDepthLevel; i++ )
+ os << " | " ;
+ if (SeqTerm != NULL)
+ {
+ SeqTerm->SetPrintLevel(PrintLevel);
+ SeqTerm->Print(os);
+ os << std::endl;
+ }
+ else
+ {
+ // fuse
+ gdcmWarningMacro(" -------- should have a sequence terminator item");
+ }
+ }
+}
+
+//-----------------------------------------------------------------------------
+} // end namespace gdcm