<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Change SYSTEM "https://itk.org/migrationv4/ITKMigration.dtd">
<!--**
**
** BRAINS2MaskImageIORemoval.xml
**
**-->
<Change>
    <!--**
    ** Title for the online migration page
    **-->
    <Title>
      The BRAINS2MaskImageIO class is removed.
    </Title>

    <!--**
    ** Plain text description of the change
    **-->
    <Description>
      The Brains2Mask file format has very limited functionality
      outside the legacy brains2 program.  This file format
      does not have sufficient information for supporting
      orientation of masks, and even the Iowa contributors
      have given up on using the ITK Brains2Mask as a file
      format from ITK.  This is a legacy format that was
      never included in the default file reader lists.
    </Description>

    <!--**
    ** Sample code snippets
    **-->
    <SampleCode>
      <Old>
        <![CDATA[
        #include "itkBrains2MaskImageIO.h"
        include "itkBrains2MaskImageIOFactory.h"
        itk::ObjectFactoryBase::RegisterFactory(itk::Brains2MaskImageIOFactory::New() );
        ]]>
      </Old>
      <New>
        // Don't include headers or register factory
      </New>
    </SampleCode>

    <!--**
    ** The change-ids for all commits in the topic branch
    **-->
    <Gerrit-ChangeId>
      d8f950b66829c531aedef5680c35c88d1edbf5b7
    </Gerrit-ChangeId>

    <!--**
    ** List of all changed files from the topic branch
    **-->
    <FileList>
      Code/IO/CMakeLists.txt
      Code/IO/itkBrains2HeaderBase.cxx
      Code/IO/itkBrains2HeaderBase.h
      Code/IO/itkBrains2HeaderFactory.cxx
      Code/IO/itkBrains2HeaderFactory.h
      Code/IO/itkBrains2IPLHeaderInfo.cxx
      Code/IO/itkBrains2IPLHeaderInfo.h
      Code/IO/itkBrains2MaskHeaderInfo.cxx
      Code/IO/itkBrains2MaskHeaderInfo.h
      Code/IO/itkBrains2MaskImageIO.cxx
      Code/IO/itkBrains2MaskImageIO.h
      Code/IO/itkBrains2MaskImageIOFactory.cxx
      Code/IO/itkBrains2MaskImageIOFactory.h
      Testing/Code/IO/CMakeLists.txt
      Testing/Code/IO/itkBrains2MaskImageIOTest.cxx
      Testing/Code/IO/itkIOHeaderTest.cxx
    </FileList>

<MigrationFix-Manual>
  <Old>
    <![CDATA[
    #include "itkBrains2MaskImageIO.h"
    #include "itkBrains2MaskImageIOFactory.h"
    itk::ObjectFactoryBase::RegisterFactory(itk::Brains2MaskImageIOFactory::New() );
    ]]>
  </Old>
  <New>
    <![CDATA[
    Remove #include statemets for BRAINS2Mask classes.
    Remove c++ statement that registered the BRAINS2Mask factory.
    In the unlikely event you need to convert BRAINS2 masks, there is a program included in
    the BRAINS3 project on nitrc.org, called ConvertMaskToBinaryImage, that can be used to do this.
    See http://www.
    ]]>
  </New>
</MigrationFix-Manual>

</Change>
