<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
  <title></title>
</head>
<body bgcolor="#ffffff" text="#000000">
<br>
Hi!<br>
<br>
Just to be the first to agree my las sggestion about new features :<br>
<br>
<br>
<ul>
  <li> Because the <tt>gdcm::DicomDir::Load()</tt> method may be used
either for loading an already made <tt>DICOMDIR</tt> file or for
parsing all the dicom files with a given root directory we syntaxically
separated the operations: <br>
For loading an already made <tt>DICOMDIR</tt> file, use : <br>
    <pre>           gdcm::DicomDir *d = new gdcm::DicomDir();
           d->SetFileName(fileName);
           d->Load( );                 
                          </pre>
For parsing all the dicom files with a given root directory, use :<br>
    <pre>           gdcm::DicomDir *d = new gdcm::DicomDir();
           d->SetDirectoryName(dirName);
           d->Load( );                                 
           </pre>
    <b>Don't</b> use any longer old deprecated style: <br>
    <tt> gdcm::DicomDir *d = new gdcm::DicomDir();<br>
d->SetParseDir(true); // </tt>or <tt>d->SetParseDir(false);<br>
d->Load( fileName );<br>
    </tt> <br>
  </li>
  <li> User is now allowed to tell <tt>gdcm::Document</tt> constructor
he doesn't want to deal with <tt>SeqEntry</tt> (every time it's
possible) <br>
and/or he doesn't want to deal with <tt>Shadow groups</tt> (every time
it's possible) <br>
or he doesn't want to deal with <tt>SeqEntry</tt> that belong to a <tt>Shadow
group</tt> (every time it's possible)<br>
use : <br>
    <pre>            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( );
                                </pre>
    <b>Don't</b> use any longer old deprecated style: <br>
    <tt> gdcm::File *f = new gdcm::File(fileName);</tt> <br>
    <br>
  </li>
  <li> User is now allowed to tell <tt>gdcm::DicomDir</tt> constructor
he doesn't want to deal with <tt>SeqEntry</tt> he doesn't want to deal
with <tt>SeqEntry</tt> (every time it's possible) <br>
and/or he doesn't want to deal with <tt>Shadow groups</tt> (every time
it's possible) <br>
or he doesn't want to deal with <tt>SeqEntry</tt> that belong to a <tt>Shadow
group</tt> (every time it's possible)<br>
when he parses all the Dicom files within a given directory use : <br>
    <pre>            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( );
                                </pre>
    <b>Don't</b> use any longer old deprecated style: <br>
    <tt> gdcm::DicomDir *dcmdir = new gdcm::DicomDir(dirName, true);</tt></li>
</ul>
<br>
</body>
</html>