-// gdcmSeqEntry.cxx
-//-----------------------------------------------------------------------------
-//
+/*=========================================================================
+
+ Program: gdcm
+ Module: $RCSfile: gdcmSeqEntry.cxx,v $
+ Language: C++
+ Date: $Date: 2005/10/24 16:00:48 $
+ Version: $Revision: 1.59 $
+
+ Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
+ l'Image). All rights reserved. See Doc/License.txt or
+ http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
+
+ This software is distributed WITHOUT ANY WARRANTY; without even
+ the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+ PURPOSE. See the above copyright notices for more information.
+
+=========================================================================*/
+
#include "gdcmSeqEntry.h"
#include "gdcmSQItem.h"
#include "gdcmTS.h"
#include "gdcmGlobal.h"
#include "gdcmUtil.h"
+#include "gdcmDebug.h"
#include <iostream>
#include <iomanip>
+#include <fstream>
+
+namespace gdcm
+{
//-----------------------------------------------------------------------------
// Constructor / Destructor
/**
- * \ingroup gdcmSeqEntry
- * \brief Constructor from a given gdcmSeqEntry
+ * \brief Constructor from a given SeqEntry
+ */
+SeqEntry::SeqEntry( DictEntry *e )
+ : DocEntry(e)
+{
+ Length = 0;
+ ReadLength = 0xffffffff;
+ SQDepthLevel = -1;
+
+ DelimitorMode = false;
+ SeqTerm = NULL;
+}
+
+/**
+ * \brief Constructor from a given DocEntry
+ * @param e Pointer to existing Doc entry
+ * @param depth depth level of the current Seq entry
*/
-gdcmSeqEntry::gdcmSeqEntry(gdcmDictEntry* e)
- : gdcmDocEntry(e)
+SeqEntry::SeqEntry( DocEntry *e, int depth )
+ : DocEntry( e->GetDictEntry() )
{
- delimitor_mode = false;
- seq_term = NULL;
+ Length = 0;
+ ReadLength = 0xffffffff;
+ SQDepthLevel = depth;
+
+ ImplicitVR = e->IsImplicitVR();
+ Offset = e->GetOffset();
+ SeqTerm = NULL;
}
/**
- * \ingroup gdcmSeqEntry
* \brief Canonical destructor.
*/
-gdcmSeqEntry::~gdcmSeqEntry() {
- for(ListSQItem::iterator cc = items.begin();cc != items.end();++cc)
- {
- delete *cc;
- }
- if (!seq_term)
- delete seq_term;
+SeqEntry::~SeqEntry()
+{
+ ClearSQItem();
}
//-----------------------------------------------------------------------------
-// Print
+// Public
/*
- * \ingroup gdcmSeqEntry
- * \brief canonical Printer
+ * \brief canonical Writer
+ * @param fp pointer to an already open file
+ * @param filetype type of the file (ACR, ImplicitVR, ExplicitVR, ...)
*/
-void gdcmSeqEntry::Print(std::ostream &os){
-
- std::ostringstream s;
- string vr;
- unsigned short int g, e;
- long lgth;
- size_t o;
- char greltag[10]; //group element tag
- char st[20];
-
-
- SetPrintLevel(2);
-// PrintCommonPart(os); // FIXME : why doesn't it work ?
-
- // First, Print the Dicom Element itself.
- g = GetGroup();
- e = GetElement();
- o = GetOffset();
- vr = GetVR();
- sprintf(greltag,"%04x|%04x ",g,e);
- s << greltag ;
- if (GetPrintLevel()>=2) {
- s << "lg : ";
- lgth = GetReadLength(); // ReadLength, as opposed to UsableLength
- if (lgth == 0xffffffff) {
- sprintf(st,"x(ffff)"); // I said : "x(ffff)" !
- s.setf(std::ios::left);
- s << std::setw(10-strlen(st)) << " ";
- s << st << " ";
- s.setf(std::ios::left);
- s << std::setw(8) << "-1";
- } else {
- sprintf(st,"x(%x)",lgth);
- s.setf(std::ios::left);
- s << std::setw(10-strlen(st)) << " ";
- s << st << " ";
- s.setf(std::ios::left);
- s << std::setw(8) << lgth;
- }
- s << " Off.: ";
- sprintf(st,"x(%x)",o);
- s << std::setw(10-strlen(st)) << " ";
- s << st << " ";
- s << std::setw(8) << o;
+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::WriteContent(fp, filetype);
+ for(ListSQItem::iterator cc = Items.begin();
+ cc != Items.end();
+ ++cc)
+ {
+ (*cc)->WriteContent(fp, filetype);
}
+
+ // we force the writting of a Sequence Delimitation item
+ // because we wrote the Sequence as a 'no Length' sequence
+ binary_write(*fp, seq_term_gr);
+ binary_write(*fp, seq_term_el);
+ binary_write(*fp, seq_term_lg);
+}
+
+/**
+ * \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);
+}
- s << "[" << vr << "] ";
- if (GetPrintLevel()>=1) {
- s.setf(std::ios::left);
- s << std::setw(66-GetName().length()) << " ";
+/**
+ * \brief Remove all SQItem.
+ */
+void SeqEntry::ClearSQItem()
+{
+ for(ListSQItem::iterator cc = Items.begin(); cc != Items.end(); ++cc)
+ {
+ delete *cc;
}
-
- s << "[" << GetName()<< "]";
+ if (SeqTerm)
+ {
+ SeqTerm->Unregister();
+ }
+}
- s << std::endl;
- os << s.str();
+/**
+ * \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;
+}
- // Then, Print each SQ Item
- for(ListSQItem::iterator cc = items.begin();cc != items.end();++cc)
+/**
+ * \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 bigger than the total
+ * item number.
+ */
+SQItem *SeqEntry::GetSQItem(int nb)
+{
+ if (nb<0)
{
- //(*cc)->SetPrintLevel(GetPrintLevel()); aurait-ce un sens ?
- (*cc)->Print(os);
+ return *(Items.begin());
}
- // at end, print the sequence terminator item, if any
- /*
- if (delimitor_mode) { // TODO : find the trick to print it properly
- s << " | " ;
- os << s.str();
- if (seq_term = NULL)
- seq_term->Print(os);
- }
- */
- }
+ int count = 0 ;
+ for(ListSQItem::iterator cc = Items.begin();
+ cc != Items.end();
+ count ++, ++cc)
+ {
+ if (count == nb)
+ {
+ return *cc;
+ }
+ }
+ return *(Items.end());
+}
-//-----------------------------------------------------------------------------
-// Public
+/**
+ * \brief returns the number of SQItems within the current Sequence
+ */
+unsigned int SeqEntry::GetNumberOfSQItems()
+{
+ return Items.size();
+}
- /// \brief adds the passed ITEM to the ITEM chained List for this SeQuence.
-void gdcmSeqEntry::AddEntry(gdcmSQItem *sqItem) {
- items.push_back(sqItem);
+/**
+ * \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();
+ }
}
+
//-----------------------------------------------------------------------------
// Protected
//-----------------------------------------------------------------------------
// Private
-// end-user intended : the guy *wants* to create his own SeQuence ?!?
-gdcmDocEntry *gdcmSeqEntry::NewDocEntryByNumber(guint16 group,
- guint16 element) {
-// TODO
- gdcmDocEntry *a;
- return a;
+//-----------------------------------------------------------------------------
+// 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");
+ }
+ }
}
-gdcmDocEntry *gdcmSeqEntry::NewDocEntryByName (std::string Name) {
-// TODO :
- gdcmDocEntry *a;
- return a;
-}
//-----------------------------------------------------------------------------
+} // end namespace gdcm