X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmFile.cxx;h=8e84268df4ab764a684ab6c9ea1ae541e64ae416;hb=1a11accd11061d63d3c09db7b1445637207e81e4;hp=2bb43980229a7a88af084b7f2ab16ac5d0884d41;hpb=27c61aa23c3f02def28d44dca855e54d9adb25a1;p=gdcm.git diff --git a/src/gdcmFile.cxx b/src/gdcmFile.cxx index 2bb43980..8e84268d 100644 --- a/src/gdcmFile.cxx +++ b/src/gdcmFile.cxx @@ -14,14 +14,12 @@ typedef std::pair IterHT; * file (see SetFileName, SetDcmTag and Write) * Opens (in read only and when possible) an existing file and checks * for DICOM compliance. Returns NULL on failure. - * \Note the in-memory representation of all available tags found in + * \note the in-memory representation of all available tags found in * the DICOM header is post-poned to first header information access. * This avoid a double parsing of public part of the header when * one sets an a posteriori shadow dictionary (efficiency can be * seen as a side effect). - * * @param header file to be opened for reading datas - * * @return */ @@ -40,13 +38,12 @@ gdcmFile::gdcmFile(gdcmHeader *header) { * file (see SetFileName, SetDcmTag and Write) * Opens (in read only and when possible) an existing file and checks * for DICOM compliance. Returns NULL on failure. - * \Note the in-memory representation of all available tags found in + * \note the in-memory representation of all available tags found in * the DICOM header is post-poned to first header information access. * This avoid a double parsing of public part of the header when * one sets an a posteriori shadow dictionary (efficiency can be * seen as a side effect). * @param filename file to be opened for parsing - * @return */ gdcmFile::gdcmFile(std::string & filename) { Header=new gdcmHeader(filename.c_str()); @@ -57,7 +54,20 @@ gdcmFile::gdcmFile(std::string & filename) { SetPixelDataSizeFromHeader(); } -gdcmFile::gdcmFile(const char * filename) { +/** + * \ingroup gdcmFile + * \brief Constructor dedicated to writing a new DICOMV3 part10 compliant + * file (see SetFileName, SetDcmTag and Write) + * Opens (in read only and when possible) an existing file and checks + * for DICOM compliance. Returns NULL on failure. + * \note the in-memory representation of all available tags found in + * the DICOM header is post-poned to first header information access. + * This avoid a double parsing of public part of the header when + * one sets an a posteriori shadow dictionary (efficiency can be + * seen as a side effect). + * @param filename file to be opened for parsing + */ + gdcmFile::gdcmFile(const char * filename) { Header=new gdcmHeader(filename); SelfHeader=true; PixelRead=-1; // no ImageData read yet. @@ -69,7 +79,7 @@ gdcmFile::gdcmFile(const char * filename) { /** * \ingroup gdcmFile * \brief canonical destructor - * \Note If the gdcmHeader is created by the gdcmFile, it is destroyed + * \note If the gdcmHeader is created by the gdcmFile, it is destroyed * by the gdcmFile */ gdcmFile::~gdcmFile(void) { @@ -85,7 +95,7 @@ gdcmFile::~gdcmFile(void) { // Public /** * \ingroup gdcmFile - * \brief + * \brief returns the gdcmHeader *Header * @return */ gdcmHeader *gdcmFile::GetHeader(void) { @@ -162,9 +172,9 @@ size_t gdcmFile::GetImageDataSize(void) { /** * \ingroup gdcmFile * \brief Returns the size (in bytes) of required memory to hold - * \ the pixel data represented in this file, when user DOESN'T want - * \ to get RGB pixels image when it's stored as a PALETTE COLOR image - * \ - the (vtk) user is supposed to know how deal with LUTs - + * the pixel data represented in this file, when user DOESN'T want + * to get RGB pixels image when it's stored as a PALETTE COLOR image + * -the (vtk) user is supposed to know how deal with LUTs- * \warning to be used with GetImagePixelsRaw() * @return The size of pixel data in bytes. */ @@ -180,12 +190,13 @@ size_t gdcmFile::GetImageDataSizeRaw(void) { * Transforms 3 planes R, G, B into a single RGB Plane * Transforms single Grey plane + 3 Palettes into a RGB Plane * @return Pointer to newly allocated pixel data. - * \ NULL if alloc fails + * NULL if alloc fails */ void * gdcmFile::GetImageData (void) { PixelData = (void *) malloc(lgrTotale); if (PixelData) GetImageDataIntoVector(PixelData, lgrTotale); + PixelRead=0; // no PixelRaw return(PixelData); } @@ -322,7 +333,7 @@ size_t gdcmFile::GetImageDataIntoVectorRaw (void* destination, size_t MaxSize) { } (void)ReadPixelData(destination); - + // Number of Bits Allocated for storing a Pixel str_nb = Header->GetEntryByNumber(0x0028,0x0100); if (str_nb == GDCM_UNFOUND ) { @@ -368,7 +379,6 @@ size_t gdcmFile::GetImageDataIntoVectorRaw (void* destination, size_t MaxSize) { deb++; } } - // re arange bits inside the bytes if (nbu != nb){ int l = (int)lgrTotale / (nb/8); @@ -393,7 +403,7 @@ size_t gdcmFile::GetImageDataIntoVectorRaw (void* destination, size_t MaxSize) { return (size_t)0; } } -// DO NOT remove this code commented out. +// DO NOT remove this commented out code . // Nobody knows what's expecting you ... // Just to 'see' what was actually read on disk :-( @@ -531,12 +541,13 @@ size_t gdcmFile::GetImageDataIntoVectorRaw (void* destination, size_t MaxSize) { /** * \ingroup gdcmFile - * \brief TODO JPR - * \warning doit-etre etre publique ? - * TODO : y a-t-il un inconvenient à fusioner ces 2 fonctions - * - * @param inData - * @param ExpectedSize + * \brief performs a shadow copy (not a deep copy) of the user given + * pixel area. + * 'image' Pixels are presented as C-like 2D arrays : line per line. + * 'volume'Pixels are presented as C-like 3D arrays : lane per plane + * \warning user is kindly requested NOT TO 'free' the Pixel area + * @param inData user supplied pixel area + * @param ExpectedSize total image size, in Bytes * * @return boolean */ @@ -551,9 +562,7 @@ bool gdcmFile::SetImageData(void * inData, size_t ExpectedSize) { * \ingroup gdcmFile * \brief Writes on disk A SINGLE Dicom file * NO test is performed on processor "Endiannity". - * Ca sera à l'utilisateur d'appeler son Reader correctement - * (Equivalent a IdImaWriteRawFile) - * + * It's up to the user to call his Reader properly * @param fileName name of the file to be created * (any already existing file is over written) * @return false if write fails @@ -573,9 +582,9 @@ bool gdcmFile::WriteRawData (std::string fileName) { /** * \ingroup gdcmFile - * \brief Writes on disk A SINGLE Dicom file + * \brief Writes on disk A SINGLE Dicom file, + * using the Implicit Value Representation convention * NO test is performed on processor "Endiannity". - * * @param fileName name of the file to be created * (any already existing file is overwritten) * @return false if write fails @@ -587,8 +596,9 @@ bool gdcmFile::WriteDcmImplVR (std::string fileName) { /** * \ingroup gdcmFile - * \brief - * @param fileName name of the file to be created + * \brief Writes on disk A SINGLE Dicom file, + * using the Implicit Value Representation convention + * NO test is performed on processor "Endiannity". * @param fileName name of the file to be created * (any already existing file is overwritten) * @return false if write fails */ @@ -599,8 +609,9 @@ bool gdcmFile::WriteDcmImplVR (const char* fileName) { /** * \ingroup gdcmFile - * \brief - * @param fileName name of the file to be created +* \brief Writes on disk A SINGLE Dicom file, + * using the Explicit Value Representation convention + * NO test is performed on processor "Endiannity". * @param fileName name of the file to be created * (any already existing file is overwritten) * @return false if write fails */ @@ -611,15 +622,14 @@ bool gdcmFile::WriteDcmExplVR (std::string fileName) { /** * \ingroup gdcmFile - * \brief Ecrit au format ACR-NEMA sur disque l'entete et les pixels + * \brief Writes on disk A SINGLE Dicom file, + * using the ACR-NEMA convention + * NO test is performed on processor "Endiannity". * (a l'attention des logiciels cliniques * qui ne prennent en entrée QUE des images ACR ... * \warning if a DICOM_V3 header is supplied, - * groups < 0x0008 and shadow groups are ignored) + * groups < 0x0008 and shadow groups are ignored * \warning NO TEST is performed on processor "Endiannity". - * Ca fonctionnera correctement (?) sur processeur Intel - * (Equivalent a IdDcmWrite) - * * @param fileName name of the file to be created * (any already existing file is overwritten) * @return false if write fails @@ -633,10 +643,11 @@ bool gdcmFile::WriteAcr (std::string fileName) { // Protected /** * \ingroup gdcmFile - * -* @param fileName name of the file to be created + * \brief NOT a end user inteded function + * (used by WriteDcmExplVR, WriteDcmImplVR, WriteAcr, etc) + * @param fileName name of the file to be created * (any already existing file is overwritten) - * @param type file type (ExplicitVR, ImplicitVR, ...) + * @param type file type (ExplicitVR, ImplicitVR, DICOMDIR, ...) * @return false if write fails */ bool gdcmFile::WriteBase (std::string fileName, FileType type) { @@ -644,8 +655,8 @@ bool gdcmFile::WriteBase (std::string fileName, FileType type) { FILE * fp1; if (PixelRead==-1 && type != DICOMDIR) { - std::cout << "U never Read the pixels; U cannot write the file" - << std::endl; +/* std::cout << "U never Read the pixels; U cannot write the file" + << std::endl;*/ return false; } @@ -703,16 +714,16 @@ bool gdcmFile::WriteBase (std::string fileName, FileType type) { p2=it.second;// iterator on the last synonym PixelElement=p2->second; // H Table target column (2-nd col) - PixelElement->SetPrintLevel(2); - PixelElement->Print(); + // PixelElement->SetPrintLevel(2); + // PixelElement->Print(); if (PixelRead==1) PixelElement->SetLength(lgrTotaleRaw); else if (PixelRead==0) PixelElement->SetLength(lgrTotale); - PixelElement->SetPrintLevel(2); - PixelElement->Print(); + //PixelElement->SetPrintLevel(2); + //PixelElement->Print(); Header->Write(fp1, type); @@ -761,9 +772,10 @@ if(nb == 16) case 2143: case 4321: - for(i=0;i>8) | ((((unsigned short int*)im)[i])<<8); + } break; default: @@ -777,7 +789,7 @@ if( nb == 32 ) break; case 4321: - for(i=0;i>16; fort= (fort>>8) | (fort<<8); @@ -788,7 +800,7 @@ if( nb == 32 ) break; case 2143: - for(i=0;i>16; fort= (fort>>8) | (fort<<8); @@ -799,7 +811,7 @@ if( nb == 32 ) break; case 3412: - for(i=0;i>16; s32=faible;