X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;ds=inline;f=Doc%2FWebsite%2FNews.html;h=461c05d8356e005230e17dd1cdcdbb2f528d46bb;hb=a5e9b83b0c6cece57b690bb02b24db8b884ebb0a;hp=d7f9d87d6f25fb04f677b489c225c063f0f0cbaf;hpb=c55313464ef064ecbee4a59eb8582c8354afce06;p=gdcm.git
diff --git a/Doc/Website/News.html b/Doc/Website/News.html
index d7f9d87d..461c05d8 100644
--- a/Doc/Website/News.html
+++ b/Doc/Website/News.html
@@ -8,10 +8,10 @@
-
+
Gdcm News
-
+
@@ -21,34 +21,91 @@
We know the following are missing; don't loose time looking for them ...
We know they could be helpfull. We shall add them some day.
Any contribution is welcome.
-
- - gdcm doesn't read yet JPEG-LS and JPEG2000 encoded files.
-
- Allow user to tell gdcm::Document constructor he doesn't
- want to deal with SeqEntry Allow user to tell gdcm::Document constructor he doesn't
- want to deal with Shadow groups
-
- Allow user to tell gdcm::Document constructor he just wants
- to load a given list of DocEntries (to save CPU time and RAM
- space)
-
- Allow user to tell the Writer he doesn't want to write down
+
- Decoders
+
+ - gdcm doesn't read yet JPEG-LS encoded files.
+
+ We said 'JPEG-LS', not Lossless Jpeg ...
+ [JPEG-LS is the basis for new lossless/near-lossless compression
+ standard for continuous-tone images intended for JPEG2000.
+ The standard is based on the LOCO-I algorithm
+ (LOw COmplexity LOssless COmpression for Images)
+ developed at Hewlett-Packard Laboratories]
+
+ - gdcm doesn't read yet all JPEG2000 encoded files.
+
+ But we are working on it (a lot of troubles with Jasper).
+
+ - gdcm doesn't read yet MPEG2 encoded files.
+
+ But we are working on it.
+
+
+ - Reader
+
+ - Allow user to tell gdcm::Document constructor he just wants
+ to load a given list of DocEntries
+ (to save CPU time and RAM space)
+
- Allow 'frame by frame' reading (should be helpfull for huge
+ multiframe images)
+
- Allow subvolume selection / frames selection before reading.
+
- Expose Read/Decompression mechanisms to allow user getting
+ information from DICOMDIR
-or from his own Data Base-
+ and reading his images without parsing
+ the header, one more time.
+
+ - Writer
+
+ - Allow user to tell the Writer he doesn't want to write down
SeqEntry (if any)
-
- Allow user to tell the Writer he doesn't want to write down
+
- Allow user to tell the Writer he doesn't want to write down
Shadow groups (if any)
-
- Icon Image management (Read and Write)
-
- DICOMDIR full management (not limited to
+
- Allow user to tell the Writer which compression mode he wants
+ (Right now, no one is available)
+ - Allow user to tell the Writer he wants to split a
+ Multiframe image into a serie of
+ Single frame images.
+
- Allow user to tell the Writer he wants to agregate a
+ Serie of Single frame images into a
+ Multiframe image.
+
+ - Reader / Writer
+
+ - Full Icon Image management (Read and Write)
+
- Full Overlays management (Read and Write)
+ both for 'ACR-NEMA style' (using groups 0x6000
+ and nexts) and 'DICOM V3 style' (using Sequences)
+
+ - DICOMDIR
+
+ - DICOMDIR full management (not limited to
PATIENT/STUDY/SERIE/IMAGE)
-
- Allow user to add an Entry to the default entry list, before
+
- Allow user to add an entry (belonging to the file header Dicom
+ entries)to the default entry list, before
making a DICOMDIR from a root directory
-
- DICOMDIR anonymiser (Load and Noload mode)
-
- 16-bits-LUT full Management
-
- User friendly management of Rescale Slope and
+
- Allow user to add an entry of his owns (for instance an Icon
+ to each image, or to each Serie).
+
+ - SerieHelper
+
+
+ - An accurate SerieHelper
+ Right now SerieHelper only works on 'bona fide Series', and
+ breaks on wrongly forged Series.
+ We are still looking for any heuristics...
+ - A SerieHelper that would use the DICOMDIR (if any)
+ instead of parsing all the files within the Root Directory
+
+ - Other
+
+ - 16-bits-LUT full Management
+
- User friendly management of Rescale Slope and
Rescale Intercept
-
- Allow parsing the Shadow groups against a user supplied
+
- Allow parsing the Shadow groups against a user supplied
private Dicom Dictionary (pfff!...)
-
- An accurate SerieHelper
+
-
@@ -62,44 +119,163 @@ Any contribution is welcome.
New Features
+ - AnonymizeNoLoad used with dirin=inputDirectoryName
+ anonymizes all the files within the given Directory.
+
+ User may also choose extra elements he wants to rub out:
+ rubout=listOfElementsToRubOut
+ with listOfElementsToRubOut : group1-elem1,group2-elem2,
+ ... (in hexa, no space within the list )
+
+ - gdcm::SerieHelper() has a new method
+ void AddGdcmFile(File *header), that allows aware user to
+ create a 'FileList' (actually a
+ std::vector< File* > ).
+ The FileList created this way will be the
+ 'first one' in the gdcm::FileHelper() (retrieve it with
+ FileList *GetFirstCoherentFileList() ).
+ It may be sorted using OrderFileList.
+ No 'coherence check' will be performed on this FileList
+ before sorting.
+ It may be passed to a vtkGdcmReader
+ (to avoid parsing twice the files)
+
+ - vtkGdcmReader can now get the result of
+ gdcm::SerieHelper (to avoid parsing twice the files)
+ Proceed as follow :
+
+ gdcmSerieHelper *sh = new gdcmSerieHelper();
+ sh->SetDirectory(myImageDirectory, true);
+ gdcmFileList *l = s->GetFirstCoherentFileList();
+ s->OrderFileList(l);
+
+ vtkGdcmReader *gr = new vtkGdcmReader();
+ gr->SetCoherentFileList(l);
+ gr->Update();
+
+ This works with a directory that contains only one 'Serie'
+ (same Serie UID for all the images).
+ If it contains more than one Serie, you'll have to loop
+ on the Series, using GetNextCoherentFileList();
+ It will be up to the user to delete the gdcm::File.
+
+ See vtkgdcmSerieViewer for an example.
+
- Both vtkgdcmViewer and vtkgdcmViewer2
are available to allow easy displaying of single/multiframe
- GreyLevel/RGB/PaletteColor images
-
-
+ GreyLevel/RGB/PaletteColor images
+ - DICOMDIR anonymiser (Load and Noload mode)
+
+ - Because the gdcm::DicomDir::Load() method may be used
+ either for loading an already made DICOMDIR file or for
+ parsing all the dicom files with a given root directory we
+ syntaxically separated the operations:
+ For loading an already made DICOMDIR file, use :
+
+ gdcm::DicomDir *d = new gdcm::DicomDir();
+ d->SetFileName(fileName);
+ d->Load( );
+
+
+ For parsing all the dicom files within a given root directory, use :
+
+ gdcm::DicomDir *d = new gdcm::DicomDir();
+ d->SetDirectoryName(dirName);
+ d->Load( )
+
+
+ Don't use any longer old deprecated style:
+
+ gdcm::DicomDir *d = new gdcm::DicomDir();
+ d->SetParseDir(true); // or d->SetParseDir(false);
+ d->Load( fileName );
+
+
+ - User is now allowed to tell gdcm::Document constructor
+ he doesn't want to deal with SeqEntry
+ (every time it's possible)
and/or he doesn't
+ want to deal with Shadow groups (every time it's
+ possible)
or he doesn't
+ want to deal with SeqEntry that belong to a Shadow group (every time it's
+ possible)
+ use :
+
+ gdcm::File *f = new gdcm::File();
+ f->SetLoadMode(NO_SEQ); | depending on what
+ f->SetLoadMode(NO_SHADOW); | you want *not*
+ f->SetLoadMode(NO_SEQ | NO_SHADOW);| to load from the
+ f->SetLoadMode(NO_SHADOWSEQ); | target file
+ f->SetFileName(fileName);
+ f->Load( );
+
+ Don't use any longer old deprecated style:
+
+ gdcm::File *f = new gdcm::File(fileName);
+
+ - User is now allowed to tell gdcm::DicomDir constructor
+ he doesn't want to deal with SeqEntry
+ he doesn't want to deal with SeqEntry
+ (every time it's possible)
and/or he doesn't
+ want to deal with Shadow groups (every time it's
+ possible)
or he doesn't
+ want to deal with SeqEntry that belong to a Shadow group (every time it's
+ possible)
when he parses all the Dicom files within a given
+ directory
+ use :
+
+ gdcm::DicomDir *f = new gdcm::DicomDir();
+ f->SetLoadMode(NO_SEQ); | depending on what
+ f->SetLoadMode(NO_SHADOW); | you want *not*
+ f->SetLoadMode(NO_SEQ | NO_SHADOW);| to load from the files
+ f->SetLoadMode(NO_SHADOWSEQ); | within the root directory
+ f->SetDirectoryName(rootDirectoryName);
+ f->Load( );
+
+ Don't use any longer old deprecated style:
+
+ gdcm::DicomDir *dcmdir = new gdcm::DicomDir(dirName, true);
+
Bug fixes
- The difference between MONOCHROME1 (low values = bright,
high values = dark) and MONOCHROME2 (low values = dark,
- high values = bright) is now taken into account.
+ high values = bright) is now taken into account.
It's no longer up to the user to change the pixels value
- -
+
- Writing a 'True Dicom' image after reading an ACR-NEMA image
+ does not request any longer from the user to build up
+ 'manually' the Meta Elements group (Ox0002)
+
- Old '24 Bits' ACR-NEMA are now correctly re-written
+ in DICOM V3 mode.
+
- Element 0x0000 of Shadow groups is always forced to be a
+ ValEntry and its VR is forced to UL
+
A.P.I. breaking modifications (since previous version : 1.0)
+ NEVER more API breaking modifications !!!
+
Known bugs
- - Writing a 'True Dicom' image after reading an ACR-NEMA image requests
- from the user to build up 'manually' the Meta Elements group (0002)
-
- Management, on Big Endian Processors, of unloaded BinEntries
-
- Old '24 Bits' ACR-NEMA are not correctly re-written in DICOM mode.
+
- Use of Implicit Value Representation writting mode may
+ causes troubles, when there are some SQ belonging to a
+ Shadow Group.
+ Better you use Explicit Value Representation writting mode ...
+
+
@@ -144,9 +320,27 @@ Any contribution is welcome.
a gdcm::SeqEntry
- Removal of useless accessors GetXxxByname, SetXxxByname
- Removal of accessors GetXxxByNumber, SetXxxByNumber,
- renamed as GetXxx, SetXxx
+ Removal of useless accessors GetXxxByname, SetXxxByname
+ Renaming of accessors GetXxxByNumber, SetXxxByNumber
+ as follow :
+
+ - GetEntryByNumber
+
+ --> GetEntryValue
+
- GetEntryLengthByNumber --> GetEntryLength
+
- GetEntryOffsetByNumber --> GetEntryOffset
+
- GetEntryVRByNumber
+ --> GetEntryVR
+
-
+
- GetDocEntryByNumber
+ --> GetDocEntry
+
- GetValEntryByNumber
+ --> GetValEntry
+
- GetBinEntryByNumber
+ --> GetBinEntry
+
- GetSeqEntryByNumber
+ --> GetSeqEntry
+