X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmTS.cxx;h=4641bc8dacb56a260ba0169c042f76198e3fcf2e;hb=9886f353508c0874d5c0283c1c55561a4a001b0f;hp=392cc548e5c97b9c9d402200cf2370e6fec0f776;hpb=038a3b7f67769dc20b4c46f3c9dcad7cc63d1161;p=gdcm.git diff --git a/src/gdcmTS.cxx b/src/gdcmTS.cxx index 392cc548..4641bc8d 100644 --- a/src/gdcmTS.cxx +++ b/src/gdcmTS.cxx @@ -3,8 +3,8 @@ Program: gdcm Module: $RCSfile: gdcmTS.cxx,v $ Language: C++ - Date: $Date: 2005/01/18 08:01:42 $ - Version: $Revision: 1.37 $ + Date: $Date: 2005/07/02 18:09:36 $ + Version: $Revision: 1.49 $ Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de l'Image). All rights reserved. See Doc/License.txt or @@ -24,16 +24,18 @@ #include #include #include +#include // for isdigit // TODO // a lot of troubles expected with TS : 1.2.840.113619.5.2 // Implicit VR - Big Endian -// see : http://www.gemedicalsystemseurope.com/euen/it_solutions/pdf/lsqxi_rev2.pdf +// http://www.gemedicalsystemseurope.com/euen/it_solutions/pdf/lsqxi_rev2.pdf // namespace gdcm { //----------------------------------------------------------------------------- +/// \brief Transfer Syntaxes gdcm deals with (internal use only) static const char *SpecialStrings[] = { // Implicit VR Little Endian "1.2.840.10008.1.2", @@ -57,28 +59,39 @@ static const char *SpecialStrings[] = { "1.2.840.10008.1.2.4.55", // JPEG Lossless, Non-Hierarchical (Process 14) "1.2.840.10008.1.2.4.57", - // JPEG Lossless, Hierarchical, First-Order Prediction (Process 14, [Selection Value 1]) + // JPEG Lossless, Hierarchical, First-Order Prediction (Process 14, + // [Selection Value 1]) "1.2.840.10008.1.2.4.70", + // JPEG-LS Lossless Image Compression + "1.2.840.10008.1.2.4.80", + // JPEG-LS Lossy (Near-Lossless) Image Compression + "1.2.840.10008.1.2.4.81", // JPEG 2000 Lossless "1.2.840.10008.1.2.4.90", // JPEG 2000 "1.2.840.10008.1.2.4.91", // RLE Lossless "1.2.840.10008.1.2.5", + // MPEG2 Main Profile @ Main Level + "1.2.840.10008.1.2.4.100", // Unknown "Unknown Transfer Syntax" }; +//----------------------------------------------------------------------------- +/// \brief auto generated function, to fill up the Dicom Dictionnary, +/// if relevant file is not found on user's disk void FillDefaultTSDict(TSHT &ts); + //----------------------------------------------------------------------------- // Constructor / Destructor TS::TS() { std::string filename = DictSet::BuildDictPath() + DICT_TS; std::ifstream from(filename.c_str()); - if( !from ) + if ( !from ) { - gdcmVerboseMacro("Can't open dictionary" << filename.c_str()); + gdcmWarningMacro("Can't open dictionary" << filename.c_str()); FillDefaultTSDict( TsMap ); } else @@ -92,7 +105,7 @@ TS::TS() from >> std::ws; std::getline(from, name); - if(key != "") + if (key != "") { TsMap[key] = name; } @@ -101,39 +114,25 @@ TS::TS() } } -//----------------------------------------------------------------------------- TS::~TS() { TsMap.clear(); } -//----------------------------------------------------------------------------- -// Print -/** - * \brief Print all - * @param os The output stream to be written to. - */ -void TS::Print(std::ostream &os) -{ - std::ostringstream s; - - for (TSHT::const_iterator it = TsMap.begin(); it != TsMap.end(); ++it) - { - s << "TS : " << it->first << " = " << it->second << std::endl; - } - os << s.str(); -} - //----------------------------------------------------------------------------- // Public + +/// \brief returns occurence number of the given key int TS::Count(TSKey const &key) { return TsMap.count(key); } -TSAtr const & TS::GetValue(TSKey const &key) +/// \brief returns the human reabable value of a Transfer Synatx string +TSAtr const &TS::GetValue(TSKey const &key) { - // First thing clean up the string sometime the transfer syntax is padded with spaces + // First thing clean up the string + // (sometime the transfer syntax is padded with spaces) std::string copy = key; while ( copy.size() && !isdigit((unsigned char)copy[copy.size()-1]) ) { @@ -147,18 +146,29 @@ TSAtr const & TS::GetValue(TSKey const &key) } return it->second; } - +/** + * \brief Determines if the key passed corresponds to a 'Transfer Syntax' + * as defined in DICOM (and stored in gdcm::TS class) + * @return True when key is an actual 'Transfer Syntax'. False in all + * other cases. + */ bool TS::IsTransferSyntax(TSKey const &key) { TSHT::const_iterator it = TsMap.find(key); return it != TsMap.end(); } +/** + * \brief Determines if the Transfer Syntax was already encountered + * and if it corresponds to a Run Length Encoding Lossless one + * @return True when Run Length Encoding Lossless found. False in all + * other cases. + */ bool TS::IsRLELossless(TSKey const &key) { bool r = false; // First check this is an actual transfer syntax - if( IsTransferSyntax(key) ) + if ( IsTransferSyntax(key) ) { if ( key == SpecialStrings[RLELossless] ) { @@ -168,11 +178,17 @@ bool TS::IsRLELossless(TSKey const &key) return r; } +/** + * \brief Determines if the Transfer Syntax was already encountered + * and if it corresponds to a 'classical' JPEG Lossless one + * @return True when 'classical' Lossless found. False in all + * other cases. + */ bool TS::IsJPEGLossless(TSKey const &key) { bool r = false; // First check this is an actual transfer syntax - if( IsTransferSyntax(key) ) + if ( IsTransferSyntax(key) ) { if ( key == SpecialStrings[JPEGFullProgressionProcess10_12] || key == SpecialStrings[JPEGLosslessProcess14] @@ -184,6 +200,29 @@ bool TS::IsJPEGLossless(TSKey const &key) return r; } +/** + * \brief Determines if the Transfer Syntax was already encountered + * and if it corresponds to a 'classical' JPEG Lossy one + * @return True when 'classical' Lossy found. False in all + * other cases. + */ +bool TS::IsJPEGLossy(TSKey const &key) +{ + bool r = false; + // First check this is an actual transfer syntax + if ( IsTransferSyntax(key) ) + { + if ( key == SpecialStrings[JPEGBaselineProcess1] + || key == SpecialStrings[JPEGExtendedProcess2_4] + || key == SpecialStrings[JPEGExtendedProcess3_5] + || key == SpecialStrings[JPEGSpectralSelectionProcess6_8] ) + { + r = true; + } + } + return r; +} + /** * \brief Determines if the Transfer Syntax was already encountered * and if it corresponds to a JPEG2000 one @@ -194,7 +233,7 @@ bool TS::IsJPEG2000(TSKey const &key) { bool r = false; // First check this is an actual transfer syntax - if( IsTransferSyntax(key) ) + if ( IsTransferSyntax(key) ) { if ( key == SpecialStrings[JPEG2000Lossless] || key == SpecialStrings[JPEG2000] ) @@ -206,22 +245,21 @@ bool TS::IsJPEG2000(TSKey const &key) } /** - * \brief Determines if the Transfer Syntax corresponds to any form - * of Jpeg encoded Pixel data. + * \brief Determines if the Transfer Syntax corresponds to + * 'classical' Jpeg Lossless or Jpeg lossy. * @return True when any form of JPEG found. False otherwise. */ bool TS::IsJPEG(TSKey const &key) { bool r = false; // First check this is an actual transfer syntax - if( IsTransferSyntax(key) ) + if ( IsTransferSyntax(key) ) { - if ( key == SpecialStrings[JPEGBaselineProcess1] - || key == SpecialStrings[JPEGExtendedProcess2_4] - || key == SpecialStrings[JPEGExtendedProcess3_5] - || key == SpecialStrings[JPEGSpectralSelectionProcess6_8] - || IsJPEGLossless( key ) - || IsJPEG2000( key ) ) + if ( IsJPEGLossy( key ) + || IsJPEGLossless( key ) + || IsJPEG2000( key ) + || IsJPEGLS( key ) + ) { r = true; } @@ -230,18 +268,18 @@ bool TS::IsJPEG(TSKey const &key) } /** - * \brief Determines if the Transfer Syntax corresponds to encapsulated - * of encoded Pixel Data (as opposed to native). - * @return True when encapsulated. False when native. + * \brief Determines if the Transfer Syntax corresponds to any form + * of Jpeg-LS encoded Pixel data. + * @return True when any form of JPEG-LS found. False otherwise. */ -bool TS::IsEncapsulate(TSKey const &key) +bool TS::IsJPEGLS(TSKey const &key) { bool r = false; // First check this is an actual transfer syntax - if( IsTransferSyntax(key) ) + if ( IsTransferSyntax(key) ) { - if ( key == SpecialStrings[RLELossless] - || IsJPEG(key) ) + if ( key == SpecialStrings[JPEGLSLossless] + || key == SpecialStrings[JPEGLSNearLossless] ) { r = true; } @@ -249,6 +287,30 @@ bool TS::IsEncapsulate(TSKey const &key) return r; } +/** + * \brief Determines if the Transfer Syntax corresponds to any form + * of MPEG encoded Pixel data. + * @return True when any form of MPEG found. False otherwise. + */ +bool TS::IsMPEG(TSKey const &key) +{ + bool r = false; + // First check this is an actual transfer syntax + if ( IsTransferSyntax(key) ) + { + if ( key == SpecialStrings[MPEG2MainProfile] ) + { + r = true; + } + } + return r; +} + +/** + * \brief GetSpecialTransferSyntax ?? + * @param key TSKey const &key ?? + * @return TS::SpecialType ??. + */ TS::SpecialType TS::GetSpecialTransferSyntax(TSKey const &key) { for (int i = 0; SpecialStrings[i] != NULL; i++) @@ -258,10 +320,14 @@ TS::SpecialType TS::GetSpecialTransferSyntax(TSKey const &key) return SpecialType(i); } } - return UnknownTS; } +/** + * \brief GetSpecialTransferSyntax ?? + * @param t SpecialType t ?? + * @return char* TS : SpecialStrings[t] ??. + */ const char* TS::GetSpecialTransferSyntax(SpecialType t) { return SpecialStrings[t]; @@ -274,5 +340,21 @@ const char* TS::GetSpecialTransferSyntax(SpecialType t) // Private //----------------------------------------------------------------------------- +// Print +/** + * \brief Print all + * @param os The output stream to be written to. + */ +void TS::Print(std::ostream &os) +{ + std::ostringstream s; + for (TSHT::const_iterator it = TsMap.begin(); it != TsMap.end(); ++it) + { + s << "TS : " << it->first << " = " << it->second << std::endl; + } + os << s.str(); +} + +//----------------------------------------------------------------------------- } // end namespace gdcm