X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmCommon.h;h=4de3dee09c7dba7d23ccd43f636c906261b91381;hb=879f56a62d0772c95e92d0657882eb1886b4153d;hp=e36b21e30046509d25b1d6cbaf7cb2f15dd04b92;hpb=3ac7a631bee01193732c9ae23e90dc75181697ec;p=gdcm.git diff --git a/src/gdcmCommon.h b/src/gdcmCommon.h index e36b21e3..4de3dee0 100644 --- a/src/gdcmCommon.h +++ b/src/gdcmCommon.h @@ -3,12 +3,12 @@ Program: gdcm Module: $RCSfile: gdcmCommon.h,v $ Language: C++ - Date: $Date: 2004/09/09 17:49:24 $ - Version: $Revision: 1.30 $ + Date: $Date: 2004/10/08 08:41:04 $ + Version: $Revision: 1.35 $ 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.htm for details. + 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 @@ -49,6 +49,7 @@ #ifndef HAVE_NO_STDINT_H #include // For uint8_t uint16_t and uint32_t #else +typedef signed char int8_t; typedef unsigned char uint8_t; typedef unsigned short uint16_t; typedef unsigned int uint32_t; @@ -57,6 +58,7 @@ typedef unsigned int uint32_t; #endif #ifdef _MSC_VER +typedef signed char int8_t; typedef unsigned char uint8_t; typedef unsigned short uint16_t; typedef unsigned int uint32_t; @@ -96,6 +98,33 @@ const std::string GDCM_BINLOADED = "gdcm::Binary data loaded"; const std::string GDCM_NOTLOADED = "gdcm::NotLoaded"; const std::string GDCM_UNREAD = "gdcm::UnRead"; +/// \brief gdcmTagKey is made to hold an "universal" (as in URL, Universal +/// Ressource Locator) key to a gdcmDocEntry i.e. a dicom tag. +/// A dicom tag always has a group and an element, but a set of tags +/// embeded in various (optionally nested) sequences and sharing +/// the same group and element all share the same (group, element) +/// "identifier". Hence the (group, element) cannot be used as an +/// identifier (in gdcm we shall refer to a "TagKey") of a tag. +/// In order to construct a proper tag identifier (i.e. a key) we +/// consider the following definition of a TagKey: +/// - let Group, Element be the string representation of the +/// group and element dicom tag members, +/// - let ItemNumber be the string representation of the integer +/// index of the considered item number of a sequence, +/// Let the key of a tag embeded in a sequence, noted SeqTag, be +/// the form: +/// /ItemNumber#Group|Element +/// where "/", "#" and "|" are characters acting as separators. +/// Then the general form of a gdcmTagKey is given by: +/// Group|Element[SeqTag] +/// where [SeqTag] means NO or many instances of SeqTag. +/// Hence the gdcmTagKey of a tag not "leaving" in a sequence is the +/// string e.g. +/// 0028|1201 +/// but the gdcmTagKey of a tag "embeded" is the first item of +/// a sequence, itself nested in the third item of a sequence is the +/// string e.g. +/// 0004|1220/2#0008|0082/0#0008|0090 typedef std::string gdcmTagKey; typedef std::string TagName;