mitkFileWriter.h

Go to the documentation of this file.

/*============================================================================

The Medical Imaging Interaction Toolkit (MITK)

Copyright (c) German Cancer Research Center (DKFZ)
All rights reserved.

Use of this source code is governed by a 3-clause BSD license that can be
found in the LICENSE file.

============================================================================*/

#ifndef FILEWRITER_H_HEADER_INCLUDED
#define FILEWRITER_H_HEADER_INCLUDED

#include <MitkCoreExports.h>
#include <itkProcessObject.h>
#include <mitkDataNode.h>

namespace mitk
{
  //##Documentation
  //## @brief Interface class of writers that write data to files
  //## @ingroup DeprecatedIO
  //## @deprecatedSince{2014_10} Use mitk::IFileWriter instead.
  class MITKCORE_EXPORT FileWriter : public itk::ProcessObject
  {
  public:
    mitkClassMacroItkParent(FileWriter, itk::ProcessObject);
    //##Documentation
    //## @brief Get the specified the file to write
    //##
    //## Either the FileName or FilePrefix plus FilePattern are used to write.
    virtual const char *GetFileName() const = 0;

    //##Documentation
    //## @brief Specify the file to write.
    //##
    //## Either the FileName or FilePrefix plus FilePattern are used to write.
    virtual void SetFileName(const char *aFileName) = 0;

    //##Documentation
    //## @brief Get the specified file prefix for the file(s) to write.
    //##
    //## You should specify either a FileName or FilePrefix. Use FilePrefix if
    //## the data is stored in multiple files.
    virtual const char *GetFilePrefix() const = 0;

    //##Documentation
    //## @brief Specify file prefix for the file(s) to write.
    //##
    //## You should specify either a FileName or FilePrefix. Use FilePrefix if
    //## the data is stored in multiple files.
    virtual void SetFilePrefix(const char *aFilePrefix) = 0;

    //##Documentation
    //## @brief Get the specified file pattern for the file(s) to write. The
    //## sprintf format used to build filename from FilePrefix and number.
    //##
    //## You should specify either a FileName or FilePrefix. Use FilePrefix if
    //## the data is stored in multiple files.
    virtual const char *GetFilePattern() const = 0;

    //##Documentation
    //## @brief Specified file pattern for the file(s) to write. The sprintf
    //## format used to build filename from FilePrefix and number.
    //##
    //## You should specify either a FileName or FilePrefix. Use FilePrefix if
    //## the data is stored in multiple files.
    virtual void SetFilePattern(const char *aFilePattern) = 0;

    //##Documentation
    //## @brief Return the extension to be added to the filename.
    virtual std::string GetFileExtension();

    //##Documentation
    //## @brief Checks if given extension is valid for file writer
    bool IsExtensionValid(std::string extension);

    //##Documentation
    //## @brief Return the possible file extensions for the data type associated with the writer
    virtual std::vector<std::string> GetPossibleFileExtensions() = 0;

    //##Documentation
    //## @brief possible file extensions for the data type associated with the writer as string
    virtual std::string GetPossibleFileExtensionsAsString();

    //##Documentation
    //## @brief Check if the Writer can write this type of data of the
    //## DataTreenode.
    virtual bool CanWriteDataType(DataNode *);

    //##Documentation
    //## @brief Return the MimeType of the saved File.
    virtual std::string GetWritenMIMEType();

    virtual std::string GetSupportedBaseData() const = 0;

    using ProcessObject::SetInput;
    void SetInput(BaseData *data);

    virtual void Write() = 0;

    virtual bool CanWriteToMemory();

    virtual void SetWriteToMemory(bool write);
    virtual bool GetWriteToMemory();

    virtual const char *GetMemoryPointer();

    virtual unsigned int GetMemorySize();

    virtual void ReleaseMemory();

  protected:
    FileWriter();
    ~FileWriter() override;

    bool m_CanWriteToMemory;
    bool m_WriteToMemory;
    char *m_MemoryBuffer;
    unsigned int m_MemoryBufferSize;
  };

#define mitkWriterMacro                                                                                                \
                                                                                                                       \
  virtual void Write() override                                                                                        \
                                                                                                                       \
  {                                                                                                                    \
    if (this->GetInput() == nullptr)                                                                                      \
                                                                                                                       \
    {                                                                                                                  \
      itkExceptionMacro(<< "Write:Please specify an input!");                                                          \
      return;                                                                                                          \
    }                                                                                                                  \
    /* Fill in image information.*/                                                                                    \
    this->UpdateOutputInformation();                                                                                   \
    (*(this->GetInputs().begin()))->SetRequestedRegionToLargestPossibleRegion();                                       \
    this->PropagateRequestedRegion(nullptr);                                                                              \
    this->UpdateOutputData(nullptr);                                                                                      \
  }                                                                                                                    \
                                                                                                                       \
  virtual void Update() override { Write(); }
} // namespace mitk
#endif /* FILEWRITER_H_HEADER_INCLUDED */