src/gdcmVR.cxx

   1 /*=========================================================================
   2
   3   Program:   gdcm
   4   Module:    $RCSfile: gdcmVR.cxx,v $
   5   Language:  C++
   6   Date:      $Date: 2008/02/13 11:42:13 $
   7   Version:   $Revision: 1.63 $
   8
   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.
  12
  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.
  16
  17 =========================================================================*/
  18
  19 #include "gdcmVR.h"
  20 #include "gdcmUtil.h"
  21 #include "gdcmDictSet.h"
  22 #include "gdcmDebug.h"
  23
  24 #include <fstream>
  25 #include <iostream>
  26 #include <string.h>
  27
  28 namespace GDCM_NAME_SPACE
  29 {
  30 //-----------------------------------------------------------------------------
  31 /// \brief auto generated function, to fill up the 'Value Representation'
  32 ///        Dictionnary, if relevant file is not found on user's disk
  33 void FillDefaultVRDict(VRHT &vr);
  34
  35 //-----------------------------------------------------------------------------
  36 // Constructor / Destructor
  37 /**
  38  * \brief Constructor
  39  */
  40 VR::VR()
  41 {
  42    std::string filename = DictSet::BuildDictPath() + DICT_VR;
  43    std::ifstream from(filename.c_str());
  44    if ( !from )
  45    {
  46       gdcmWarningMacro("Can't open dictionary " << filename.c_str());
  47       FillDefaultVRDict(vr);
  48    }
  49    else
  50    {
  51       char buff[1024];
  52       VRKey key;
  53       VRAtr name;
  54
  55       while (!from.eof())
  56       {
  57          from >> std::ws;
  58          from.getline(buff, 1024, ' ');
  59          if( strcmp(buff,"") == 0)
  60             continue;
  61
  62          key = buff;
  63          from >> std::ws;
  64          from.getline(buff, 1024, ';');
  65          name = buff;
  66
  67          from >> std::ws;
  68          from.getline(buff, 1024, '\n');
  69
  70          vr[key] = name;
  71       }
  72       from.close();
  73    }
  74 }
  75
  76 /**
  77  * \brief Destructor
  78  */
  79 VR::~VR()
  80 {
  81    vr.clear();
  82 }
  83
  84 //-----------------------------------------------------------------------------
  85 // Public
  86
  87 /**
  88  * \brief   Simple predicate that checks whether the given argument
  89  *          corresponds to the Value Representation of a DataEntry .
  90  * @param   tested value representation to check for.
  91  */
  92 bool VR::IsVROfBinaryRepresentable(VRKey const &tested)
  93 {
  94    if ( IsVROfStringRepresentable(tested) )
  95       return false;
  96
  97    if ( IsVROfSequence(tested) )
  98       return false;
  99
 100    return true;
 101 }
 102
 103 /**
 104  * \brief   Simple predicate that checks whether the given argument
 105  *          corresponds to the Value Representation of a
 106  *          'std::string representable' value.
 107  * @param   tested value representation to be checked.
 108  */
 109 bool VR::IsVROfStringRepresentable(VRKey const &tested)
 110 {
 111    return tested == "AE" ||
 112           tested == "AS" ||
 113           tested == "CS" ||
 114           tested == "DA" ||
 115           tested == "DS" ||
 116           tested == "DT" ||
 117           tested == "FL" ||
 118           tested == "FD" ||
 119           tested == "IS" ||
 120           tested == "LO" ||
 121           tested == "LT" ||
 122           tested == "PN" ||
 123           tested == "SH" ||
 124           tested == "SL" ||
 125           tested == "SS" ||
 126           tested == "ST" ||
 127           tested == "TM" ||
 128           tested == "UI" ||
 129           tested == "UL" ||
 130           tested == "US" ||
 131           tested == "UT";
 132
 133    // Should be quicker
 134    // --> will *never* work : any rotten value would be considered as OK !
 135 /*
 136    return tested != "OB" &&
 137           tested != "OW" &&
 138           tested != "OF" &&
 139           tested != "AT" && // Attribute Tag ?!? contain no printable character
 140           tested != "UN" && // UN is an actual VR !
 141           tested != "SQ" ;
 142 */
 143 }
 144 /// \brief returns the length of a elementary elem whose VR is passed
 145 unsigned short VR::GetAtomicElementLength(VRKey const &tested)
 146 {
 147    // Unsigned & signed short
 148    if( tested == "US" || tested == "SS" )
 149       return 2;
 150    // Unsigned & signed long
 151    if( tested == "UL" || tested == "SL" )
 152       return 4;
 153    // Float
 154    if( tested == "FL" )
 155       return 4;
 156    // Double
 157    if( tested == "FD" )
 158       return 8;
 159    // Word string
 160    if( tested == "OW" )
 161       return 2;
 162    // Float string
 163    if( tested == "OF" || tested == "OL")
 164       return 4;
 165    return 1;
 166 }
 167
 168 // VS6 need a single implementation in the dll
 169 #if defined(_MSC_VER) && (_MSC_VER == 1200)
 170 /// \brief checks is a supposed-to-be VR is a 'legal' one.
 171 bool VR::IsValidVR(VRKey const &key)
 172 {
 173   return vr.find(key) != vr.end();
 174 #ifdef USECOMPLETELYUNTESTEDCODE
 175   // to avoid to search in a std::map of std::string,
 176   // since each std::string is 2 characters longs, we check the array
 177   // (29 char comparisons in the worst case!)
 178
 179   // "RT" is an undocumented VR, found in some Siemens images.
 180   // We added it here to be able to read these images.
 181   // Dict/gdcmVR.dic, Document has to be updated, too.
 182   static const char VRvalues[] =
 183     "AEASATCSDADSDTFLFDISLOLTOBOWOLOFPNSHSLSQSSSTTMUIULUNUSUTRT";
 184
 185   //int nbVal = strlen(VRvalues)/2; // save CPU time.
 186   int nbVal = 29;
 187
 188   const char *pt = VRvalues;
 189   for (int i=0;i<nbVal;i++)
 190   {
 191      if(key[0] == *pt++) {
 192        if(key[1] == *pt++) {
 193           return true;
 194        }
 195      }
 196      else {
 197         pt++;
 198      }
 199   }
 200   return false;
 201 #endif
 202
 203 }
 204 #endif
 205
 206 //-----------------------------------------------------------------------------
 207 // Protected
 208
 209 //-----------------------------------------------------------------------------
 210 // Private
 211
 212 //-----------------------------------------------------------------------------
 213 // Print
 214 /**
 215  * \brief   Print all
 216  * @param   os The output stream to be written to.
 217  */
 218 void VR::Print(std::ostream &os,std::string const &)
 219 {
 220    for (VRHT::iterator it = vr.begin(); it != vr.end(); ++it)
 221    {
 222       os << "VR : " << it->first << " = " << it->second << std::endl;
 223    }
 224 }
 225
 226 //-----------------------------------------------------------------------------
 227 } // end namespace gdcm