1 /*=========================================================================
4 Module: $RCSfile: gdcmDataEntry.cxx,v $
6 Date: $Date: 2005/11/03 08:41:59 $
7 Version: $Revision: 1.17 $
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 "gdcmDataEntry.h"
22 #include "gdcmGlobal.h"
24 #include "gdcmDebug.h"
30 //-----------------------------------------------------------------------------
31 #define MAX_SIZE_PRINT_ELEMENT_VALUE 0x7fffffff
32 uint32_t DataEntry::MaxSizePrintEntry = MAX_SIZE_PRINT_ELEMENT_VALUE;
34 //-----------------------------------------------------------------------------
35 // Constructor / Destructor
37 * \brief Constructor for a given DictEntry
38 * @param e Pointer to existing dictionary entry
40 DataEntry::DataEntry(DictEntry *e)
51 * \brief Constructor for a given DocEntry
52 * @param e Pointer to existing Doc entry
54 DataEntry::DataEntry(DocEntry *e)
55 : DocEntry(e->GetDictEntry())
65 * \brief Canonical destructor.
67 DataEntry::~DataEntry ()
72 //-----------------------------------------------------------------------------
75 //-----------------------------------------------------------------------------
78 * \brief Sets the value (non string) of the current Dicom Header Entry
80 void DataEntry::SetBinArea( uint8_t *area, bool self )
90 * \brief Inserts the value (non string) into the current Dicom Header Entry
92 void DataEntry::CopyBinArea( uint8_t *area, uint32_t length )
96 uint32_t lgh = length + length%2;
99 if( area && length > 0 )
102 memcpy(BinArea,area,length);
106 State = STATE_LOADED;
110 void DataEntry::SetValue(const uint32_t &id, const double &val)
114 State = STATE_LOADED;
116 if( id > GetValueCount() )
118 gdcmErrorMacro("Index (" << id << ")is greater than the data size");
122 const VRKey &vr = GetVR();
123 if( vr == "US" || vr == "SS" )
125 uint16_t *data = (uint16_t *)BinArea;
126 data[id] = (uint16_t)val;
128 else if( vr == "UL" || vr == "SL" )
130 uint32_t *data = (uint32_t *)BinArea;
131 data[id] = (uint32_t)val;
133 else if( vr == "FL" )
135 float *data = (float *)BinArea;
136 data[id] = (float)val;
138 else if( vr == "FD" )
140 double *data = (double *)BinArea;
141 data[id] = (double)val;
143 else if( Global::GetVR()->IsVROfStringRepresentable(vr) )
145 gdcmErrorMacro("SetValue on String representable not implemented yet");
149 BinArea[id] = (uint8_t)val;
153 * \brief returns, as a double (?!?) one of the values
154 // (when entry is multivaluated), identified by its index.
155 // Returns 0.0 if index is wrong
156 // FIXME : warn the user there was a problem !
158 double DataEntry::GetValue(const uint32_t &id) const
162 gdcmErrorMacro("BinArea not set. Can't get the value");
166 uint32_t count = GetValueCount();
169 gdcmErrorMacro("Index (" << id << ")is greater than the data size");
173 // FIX the API : user *knows* that entry contains a US
174 // and he receives a double ?!?
176 const VRKey &vr = GetVR();
177 if( vr == "US" || vr == "SS" )
178 return ((uint16_t *)BinArea)[id];
179 else if( vr == "UL" || vr == "SL" )
180 return ((uint32_t *)BinArea)[id];
181 else if( vr == "FL" )
182 return ((float *)BinArea)[id];
183 else if( vr == "FD" )
184 return ((double *)BinArea)[id];
185 else if( Global::GetVR()->IsVROfStringRepresentable(vr) )
189 // Don't use std::string to accelerate processing
191 char *tmp = new char[GetLength()+1];
192 memcpy(tmp,BinArea,GetLength());
203 for(uint32_t i=0;i<GetLength();i++)
233 * \brief Checks if the multiplicity of the value follows Dictionary VM
235 bool DataEntry::IsValueCountValid() const
239 const std::string &strVM = GetVM();
240 uint32_t vc = GetValueCount();
242 // FIXME : what shall we do with VM = "2-n", "3-n", etc
246 // make sure there is at least one ??? FIXME
247 valid = vc >= 1 || vc == 0;
251 std::istringstream os;
255 // vm respects the one from the dict
256 // vm is 0 (we need to check if this element is allowed to be empty) FIXME
260 // Entries whose type is 1 are mandatory, with a mandatory value.
261 // Entries whose type is 1c are mandatory-inside-a-Sequence,
262 // with a mandatory value.
263 // Entries whose type is 2 are mandatory, with an optional value.
264 // Entries whose type is 2c are mandatory-inside-a-Sequence,
265 // with an optional value.
266 // Entries whose type is 3 are optional.
268 // case vc == 0 is only applicable for 'type 2' entries.
269 // Problem : entry type may depend on the modality and/or the Sequence
270 // it's embedded in !
271 // (Get the information in the 'Conformance Statements' ...)
272 valid = vc == vm || vc == 0;
278 * \brief returns the number of elementary values
280 uint32_t DataEntry::GetValueCount( ) const
282 const VRKey &vr = GetVR();
283 if( vr == "US" || vr == "SS" )
284 return GetLength()/sizeof(uint16_t);
285 else if( vr == "UL" || vr == "SL" )
286 return GetLength()/sizeof(uint32_t);
287 else if( vr == "FL" )
288 return GetLength()/sizeof(float);
289 else if( vr == "FD" )
290 return GetLength()/sizeof(double);
291 else if( Global::GetVR()->IsVROfStringRepresentable(vr) )
293 // Some element in DICOM are allowed to be empty
294 if( !GetLength() ) return 0;
295 // Don't use std::string to accelerate processing
297 for(uint32_t i=0;i<GetLength();i++)
299 if( BinArea[i] == '\\')
308 * \brief Sets the 'value' of an Entry, passed as a std::string
309 * @param value string representation of the value to be set
311 void DataEntry::SetString(std::string const &value)
315 const VRKey &vr = GetVR();
316 if ( vr == "US" || vr == "SS" )
318 std::vector<std::string> tokens;
319 Util::Tokenize (value, tokens, "\\");
320 SetLength(tokens.size()*sizeof(uint16_t));
323 uint16_t *data = (uint16_t *)BinArea;
324 for (unsigned int i=0; i<tokens.size();i++)
325 data[i] = atoi(tokens[i].c_str());
328 else if ( vr == "UL" || vr == "SL" )
330 std::vector<std::string> tokens;
331 Util::Tokenize (value, tokens, "\\");
332 SetLength(tokens.size()*sizeof(uint32_t));
335 uint32_t *data = (uint32_t *)BinArea;
336 for (unsigned int i=0; i<tokens.size();i++)
337 data[i] = atoi(tokens[i].c_str());
340 else if ( vr == "FL" )
342 std::vector<std::string> tokens;
343 Util::Tokenize (value, tokens, "\\");
344 SetLength(tokens.size()*sizeof(float));
347 float *data = (float *)BinArea;
348 for (unsigned int i=0; i<tokens.size();i++)
349 data[i] = (float)atof(tokens[i].c_str());
352 else if ( vr == "FD" )
354 std::vector<std::string> tokens;
355 Util::Tokenize (value, tokens, "\\");
356 SetLength(tokens.size()*sizeof(double));
359 double *data = (double *)BinArea;
360 for (unsigned int i=0; i<tokens.size();i++)
361 data[i] = atof(tokens[i].c_str());
366 if( value.size() > 0 )
368 // FIXME : should be quicker if we don't create one more std::string
369 // just to make even the length of a char array ...
372 std::string finalVal = Util::DicomString( value.c_str() );
373 SetLength(finalVal.size());
376 memcpy(BinArea, &(finalVal[0]), finalVal.size());
379 size_t l = value.size();
382 //memcpy(BinArea, &(value[0]), l);
383 memcpy(BinArea, value.c_str(), l);
388 State = STATE_LOADED;
391 * \brief returns as a string (when possible) the value of the DataEntry
393 std::string const &DataEntry::GetString() const
395 static std::ostringstream s;
396 const VRKey &vr = GetVR();
404 // When short integer(s) are stored, convert the following (n * 2) characters
405 // as a displayable string, the values being separated by a back-slash
407 if( vr == "US" || vr == "SS" )
409 uint16_t *data=(uint16_t *)BinArea;
411 for (unsigned int i=0; i < GetValueCount(); i++)
419 // See above comment on multiple short integers (mutatis mutandis).
420 else if( vr == "UL" || vr == "SL" )
422 uint32_t *data=(uint32_t *)BinArea;
424 for (unsigned int i=0; i < GetValueCount(); i++)
432 else if( vr == "FL" )
434 float *data=(float *)BinArea;
436 for (unsigned int i=0; i < GetValueCount(); i++)
444 else if( vr == "FD" )
446 double *data=(double *)BinArea;
448 for (unsigned int i=0; i < GetValueCount(); i++)
458 StrArea.append((const char *)BinArea,GetLength());
459 // to avoid gdcm propagate oddities in lengthes
461 StrArea.append(" ",1);
466 * \brief Copies all the attributes from an other DocEntry
467 * @param doc entry to copy from
469 void DataEntry::Copy(DocEntry *doc)
473 DataEntry *entry = dynamic_cast<DataEntry *>(doc);
476 State = entry->State;
478 CopyBinArea(entry->BinArea,entry->GetLength());
482 * \brief Writes the 'value' area of a DataEntry
483 * @param fp already open ofstream pointer
484 * @param filetype type of the file (ACR, ImplicitVR, ExplicitVR, ...)
486 void DataEntry::WriteContent(std::ofstream *fp, FileType filetype)
488 DocEntry::WriteContent(fp, filetype);
490 if ( GetGroup() == 0xfffe )
492 return; //delimitors have NO value
495 // --> We only deal with Little Endian writting
496 // --> forget Big Endian Transfer Syntax writting!
497 // Next DICOM version will give it up ...
499 // WARNING - For Implicit VR private element,
500 // we have *no choice* but considering them as
501 // something like 'OB' values.
502 // we rewrite them as we found them on disc.
503 // Some trouble will occur if element was
504 // *actually* OW, if image was produced
505 // on Big endian based processor, read and writen
506 // on Little endian based processor
507 // and, later on, somebody needs
508 // this 'OW' Implicit VR private element (?!?)
509 // (Same stuff, mutatis mutandis, for Little/Big)
511 // 8/16 bits Pixels problem should be solved automatiquely,
512 // since we ensure the VR (OB vs OW) is conform to Pixel size.
514 uint8_t *data = BinArea; //safe notation
515 size_t l = GetLength();
516 gdcmDebugMacro ("in DataEntry::WriteContent " << GetKey()
517 << " : " << Global::GetVR()->GetAtomicElementLength(this->GetVR())
519 if (BinArea) // the binArea was *actually* loaded
521 #if defined(GDCM_WORDS_BIGENDIAN) || defined(GDCM_FORCE_BIGENDIAN_EMULATION)
522 unsigned short vrLgth =
523 Global::GetVR()->GetAtomicElementLength(this->GetVR());
529 binary_write (*fp, data, l );
534 uint16_t *data16 = (uint16_t *)data;
535 for(i=0;i<l/vrLgth;i++)
536 binary_write( *fp, data16[i]);
541 uint32_t *data32 = (uint32_t *)data;
542 for(i=0;i<l/vrLgth;i++)
543 binary_write( *fp, data32[i]);
548 double *data64 = (double *)data;
549 for(i=0;i<l/vrLgth;i++)
550 binary_write( *fp, data64[i]);
555 binary_write (*fp, data, l );
556 #endif //GDCM_WORDS_BIGENDIAN
561 // nothing was loaded, but we need to skip space on disc
563 // --> WARNING : nothing is written;
564 // --> the initial data (on the the source image) is lost
565 // --> user is *not* informed !
567 fp->seekp(l, std::ios::cur);
569 // to avoid gdcm to propagate oddities
570 // (length was already modified)
572 fp->seekp(1, std::ios::cur);
575 //-----------------------------------------------------------------------------
577 void DataEntry::NewBinArea(void)
580 if( GetLength() > 0 )
581 BinArea = new uint8_t[GetLength()];
585 void DataEntry::DeleteBinArea(void)
587 if (BinArea && SelfArea)
594 //-----------------------------------------------------------------------------
597 //-----------------------------------------------------------------------------
600 * \brief Prints a DataEntry (Dicom entry)
601 * @param os ostream we want to print in
602 * @param indent Indentation string to be prepended during printing
604 void DataEntry::Print(std::ostream &os, std::string const & )
609 uint16_t g = GetGroup();
610 if (g == 0xfffe) // delimiters have NO value
612 return; // just to avoid identing all the remaining code
615 std::ostringstream s;
621 const VRKey &vr = GetVR();
623 if( vr == "US" || vr == "SS" )
624 s << " [" << GetString() << "]";
625 else if( vr == "UL" || vr == "SL" )
626 s << " [" << GetString() << "]";
627 else if ( vr == "FL" )
628 s << " [" << GetString() << "]";
629 else if ( vr == "FD" )
630 s << " [" << GetString() << "]";
633 if(Global::GetVR()->IsVROfStringRepresentable(vr))
635 // replace non printable characters by '.'
636 std::string cleanString = Util::CreateCleanString(v);
637 if ( cleanString.length() <= GetMaxSizePrintEntry()
640 // FIXME : when IsNotLoaded(), you create a Clean String ?!?
641 // FIXME : PrintLevel<2 *does* print the values
642 // (3 is only for extra offsets printing)
643 // What do you wanted to do ? JPR
645 s << " [" << cleanString << "]";
649 s << " [gdcm::too long for print (" << cleanString.length() << ") ]";
654 // A lot of Private elements (with no VR) contain actually
655 // only printable characters;
656 // Let's deal with them as is they were VR std::string representable
658 if ( Util::IsCleanArea( GetBinArea(), GetLength() ) )
660 // FIXME : since the 'Area' *is* clean, just use
661 // a 'CreateString' method, to save CPU time.
662 std::string cleanString =
663 Util::CreateCleanString( BinArea,GetLength() );
664 s << " [" << cleanString << "]";
668 s << " [" << GDCM_BINLOADED << ";"
669 << "length = " << GetLength() << "]";
677 s << " [" << GDCM_NOTLOADED << "]";
678 else if( IsUnfound() )
679 s << " [" << GDCM_UNFOUND << "]";
680 else if( IsUnread() )
681 s << " [" << GDCM_UNREAD << "]";
682 else if ( GetLength() == 0 )
687 s << " (" << GDCM_PIXELDATA << ")";
689 // Display the UID value (instead of displaying only the rough code)
690 // First 'clean' trailing character (space or zero)
693 const uint16_t &gr = GetGroup();
694 const uint16_t &elt = GetElement();
695 TS *ts = Global::GetTS();
699 // Any more to be displayed ?
700 if ( elt == 0x0010 || elt == 0x0002 )
702 if ( v.length() != 0 ) // for brain damaged headers
704 if ( ! isdigit((unsigned char)v[v.length()-1]) )
706 v.erase(v.length()-1, 1);
709 s << " ==>\t[" << ts->GetValue(v) << "]";
712 else if (gr == 0x0008)
714 if ( elt == 0x0016 || elt == 0x1150 )
716 if ( v.length() != 0 ) // for brain damaged headers
718 if ( ! isdigit((unsigned char)v[v.length()-1]) )
720 v.erase(v.length()-1, 1);
723 s << " ==>\t[" << ts->GetValue(v) << "]";
726 else if (gr == 0x0004)
728 if ( elt == 0x1510 || elt == 0x1512 )
730 if ( v.length() != 0 ) // for brain damaged headers
732 if ( ! isdigit((unsigned char)v[v.length()-1]) )
734 v.erase(v.length()-1, 1);
737 s << " ==>\t[" << ts->GetValue(v) << "]";
745 //-----------------------------------------------------------------------------
746 } // end namespace gdcm