1 /*=========================================================================
4 Module: $RCSfile: gdcmDocEntry.cxx,v $
6 Date: $Date: 2005/10/19 13:17:04 $
7 Version: $Revision: 1.73 $
9 Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
10 l'Image). All rights reserved. See Doc/License.txt or
11 http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
13 This software is distributed WITHOUT ANY WARRANTY; without even
14 the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 PURPOSE. See the above copyright notices for more information.
17 =========================================================================*/
19 #include "gdcmDocEntry.h"
22 #include "gdcmGlobal.h"
24 #include "gdcmDebug.h"
26 #include <iomanip> // for std::ios::left, ...
31 //-----------------------------------------------------------------------------
33 // Constructor / Destructor
35 * \brief Constructor from a given DictEntry
36 * @param in Pointer to existing dictionary entry
38 DocEntry::DocEntry(DictEntry *in)
42 Offset = 0 ; // To avoid further missprinting
44 // init some variables
49 //-----------------------------------------------------------------------------
52 * \brief Writes the common part of any DataEntry, SeqEntry
53 * @param fp already open ofstream pointer
54 * @param filetype type of the file (ACR, ImplicitVR, ExplicitVR, ...)
56 void DocEntry::WriteContent(std::ofstream *fp, FileType filetype)
58 uint32_t ffff = 0xffffffff;
59 uint16_t group = GetGroup();
61 uint16_t el = GetElement();
62 uint32_t lgth = GetLength();
64 if ( group == 0xfffe && el == 0x0000 )
66 // Fix in order to make some MR PHILIPS images e-film readable
67 // see gdcmData/gdcm-MR-PHILIPS-16-Multi-Seq.dcm:
68 // we just *always* ignore spurious fffe|0000 tag !
72 // ----------- Writes the common part
74 binary_write( *fp, group); //group number
75 binary_write( *fp, el); //element number
77 // Dicom V3 group 0x0002 is *always* Explicit VR !
78 if ( filetype == ExplicitVR || filetype == JPEG || group == 0x0002 )
80 // Special case of delimiters:
83 // Delimiters have NO Value Representation
84 // Hence we skip writing the VR.
86 // In order to avoid further troubles, we choose to write them
87 // as 'no-length' Item Delimitors (we pad by writing 0xffffffff)
88 // We shall force the end of a given SeqItem by writting
89 // a Item Delimitation Item (fffe, e00d)
91 uint32_t ff = 0xffffffff;
92 binary_write(*fp, ff);
97 uint16_t shortLgr = (uint16_t)lgth;
101 // GDCM_VRUNKNOWN was stored in the Entry VR;
102 // deal with Entry as if TS were Implicit VR
104 // FIXME : troubles expected on big endian processors :
105 // let lgth = 0x00001234
106 // we write 34 12 00 00 on little endian proc (OK)
107 // we write 12 34 00 00 on big endian proc (KO)
108 //binary_write(*fp, shortLgr);
109 //binary_write(*fp, zero);
111 binary_write(*fp, lgth);
115 binary_write(*fp, vr.str());
117 if ( (vr == "OB") || (vr == "OW") || (vr == "SQ") /*|| (vr == "UN")*/ )
119 binary_write(*fp, zero);
122 // we set SQ length to ffffffff
123 // and we shall write a Sequence Delimitor Item
124 // at the end of the Sequence!
125 binary_write(*fp, ffff);
129 binary_write(*fp, lgth);
134 binary_write(*fp, shortLgr);
142 binary_write(*fp, ffff);
146 binary_write(*fp, lgth);
152 * \brief Gets the full length of the elementary DocEntry (not only value
153 * length) depending on the VR.
155 uint32_t DocEntry::GetFullLength()
157 uint32_t l = GetReadLength();
158 if ( IsImplicitVR() )
160 l = l + 8; // 2 (gr) + 2 (el) + 4 (lgth)
164 if ( GetVR()=="OB" || GetVR()=="OW" || GetVR()=="SQ" )
166 l = l + 12; // 2 (gr) + 2 (el) + 2 (vr) + 2 (unused) + 4 (lgth)
170 l = l + 8; // 2 (gr) + 2 (el) + 2 (vr) + 2 (lgth)
177 * \brief tells us if entry is the last one of a 'no length' SequenceItem
180 bool DocEntry::IsItemDelimitor()
182 return (GetGroup() == 0xfffe && GetElement() == 0xe00d);
186 * \brief tells us if entry is the first one of an Item
189 bool DocEntry::IsItemStarter()
191 return (GetGroup() == 0xfffe && GetElement() == 0xe000);
195 * \brief tells us if entry is the last one of a 'no length' Sequence
198 bool DocEntry::IsSequenceDelimitor()
200 return (GetGroup() == 0xfffe && GetElement() == 0xe0dd);
204 * \brief Copies all the attributes from an other DocEntry
205 * @param doc entry to copy from
207 void DocEntry::Copy(DocEntry *doc)
209 Length = doc->Length;
210 ReadLength = doc->ReadLength;
211 ImplicitVR = doc->ImplicitVR;
212 Offset = doc->Offset;
215 //-----------------------------------------------------------------------------
218 //-----------------------------------------------------------------------------
221 //-----------------------------------------------------------------------------
224 * \brief Prints the common part of DataEntry, SeqEntry
225 * @param os ostream we want to print in
226 * @param indent Indentation string to be prepended during printing
228 void DocEntry::Print(std::ostream &os, std::string const & )
235 std::ostringstream s;
240 if ( vr == GDCM_VRUNKNOWN )
243 s << DictEntry::TranslateToKey(GetGroup(),GetElement());
248 lgth = GetReadLength(); // ReadLength, as opposed to (usable) Length
249 if (lgth == 0xffffffff)
252 s.setf(std::ios::left);
255 s.setf(std::ios::left);
256 s << std::setw(8) << "-1";
260 st = Util::Format("x(%x)",lgth); // we may keep it
261 s.setf(std::ios::left);
262 s << std::setw(11-st.size()) << " ";
264 s.setf(std::ios::left);
265 s << std::setw(8) << lgth;
268 st = Util::Format("x(%x)",o); // we may keep it
269 s << std::setw(11-st.size()) << " ";
271 s << std::setw(8) << o;
276 s << "[" << vr << "] ";
279 if ( GetElement() == 0x0000 )
280 name = "Group Length";
286 s.setf(std::ios::left);
287 s << std::setw(66-name.length()) << " ";
290 s << "[" << name << "]";
294 //-----------------------------------------------------------------------------
295 } // end namespace gdcm