The common interface for all MITK file readers. More...

#include <mitkIFileReader.h>

Inheritance diagram for mitk::IFileReader:

Collaboration diagram for mitk::IFileReader:

Public Member Functions
virtual	~IFileReader ()

virtual void	SetInput (const std::string &location)=0
	Set the input location. More...

virtual void	SetInput (const std::string &location, std::istream *is)=0
	Set an input stream to read from. More...

virtual std::string	GetInputLocation () const =0
	Get the current input location. More...

virtual std::istream *	GetInputStream () const =0
	Get the input stream. More...

virtual std::vector< itk::SmartPointer< BaseData > >	Read ()=0
	Reads the specified file or input stream and returns its contents. More...

virtual DataStorage::SetOfObjects::Pointer	Read (mitk::DataStorage &ds)=0
	Reads the specified file or input stream, loading its contents into the provided DataStorage. More...

Public Member Functions inherited from mitk::IFileIO
virtual	~IFileIO ()

virtual ConfidenceLevel	GetConfidenceLevel () const =0
	The confidence level of the reader or writer implementation. More...

virtual Options	GetOptions () const =0
	returns a list of the supported options More...

virtual us::Any	GetOption (const std::string &name) const =0

virtual void	SetOptions (const Options &options)=0

virtual void	SetOption (const std::string &name, const us::Any &value)=0

virtual void	AddProgressCallback (const ProgressCallback &callback)=0

virtual void	RemoveProgressCallback (const ProgressCallback &callback)=0

Additional Inherited Members
Public Types inherited from mitk::IFileIO
enum	ConfidenceLevel { Unsupported, PartiallySupported, Supported }
	A confidence level describing the confidence of the reader or writer in handling the given data. More...

typedef std::map< std::string, us::Any >	Options
	Options for reading or writing data. More...

typedef mitk::MessageAbstractDelegate1< float >	ProgressCallback

Static Public Member Functions inherited from mitk::IFileIO
static std::string	PROP_DESCRIPTION ()
	Service property name for a description. More...

static std::string	PROP_MIMETYPE ()
	Service property name for the mime-type associated with this file writer. More...

Detailed Description

The common interface for all MITK file readers.

Implementations of this interface must be registered as a service to make themselve available via the service registry. If the implementation is state-full, the service should be registered using a PrototypeServiceFactory.

The file reader implementation is associated with a mime-type, specified in the service property PROP_MIMETYPE(). The specified mime-type should have a corresponding CustomMimeType service object, registered by the reader or some other party.

It is recommended to derive new implementations from AbstractFileReader or from AbstractFileIO (if both reader and writer is implemented), which provide correct service registration semantics.

See also: AbstractFileReader; AbstractFileIO; CustomMimeType; FileReaderRegistry; IFileWriter

Definition at line 64 of file mitkIFileReader.h.

Constructor & Destructor Documentation

mitk::IFileReader::~IFileReader ( )

virtual

Definition at line 21 of file mitkIFileReader.cpp.

Member Function Documentation

virtual std::string mitk::IFileReader::GetInputLocation ( ) const

pure virtual

Get the current input location.

Returns: The input location.

Implemented in mitk::AbstractFileReader.

Referenced by mitk::AbstractFileReader::InputStream::InputStream().

virtual std::istream* mitk::IFileReader::GetInputStream ( ) const

pure virtual

Get the input stream.

Returns: The currently set input stream.

Implemented in mitk::AbstractFileReader.

Referenced by mitk::AbstractFileReader::InputStream::InputStream().

virtual std::vector<itk::SmartPointer<BaseData> > mitk::IFileReader::Read ( )

pure virtual

Reads the specified file or input stream and returns its contents.

Returns: A list of created BaseData objects.

If GetInputStream() returns a non-null value, this method must use the returned stream object to read the data from. If no input stream was set, the data must be read from the path returned by GetInputLocation().

Exceptions

mitk::Exception

Implemented in mitk::AbstractFileReader, mitk::RTDoseReader, mitk::GeometryDataReaderService, mitk::PointSetReaderService, mitk::DiffusionImageNiftiReaderService, mitk::DiffusionImageNrrdReaderService, mitk::NrrdTensorImageReader, mitk::ContourModelSetReader, mitk::ContourModelReader, mitk::NrrdQBallImageReader, mitk::LabelSetImageIO, mitk::ItkImageIO, mitk::ConnectomicsNetworkReader, mitk::FiberBundleTrackVisReader, mitk::FiberBundleVtkReader, mitk::PlanarFigureCompositeReader, mitk::TubeGraphIO, mitk::RandomForestFileIO, mitk::RawImageFileReaderService, mitk::ExampleDataStructureReaderService, mitk::NavigationDataReaderCSV, mitk::NavigationDataReaderXML, mitk::DummyLsetFileReader, mitk::BaseDICOMReaderService, mitk::MAPRegistrationWrapperIO, mitk::LegacyFileReaderService, mitk::SurfaceVtkLegacyIO, mitk::SurfaceVtkXmlIO, mitk::ImageVtkLegacyIO, mitk::ImageVtkXmlIO, mitk::SurfaceStlIO, mitk::SimulationIO, and mitk::DicomSeriesReaderService.

Referenced by mitk::IOUtil::Load(), and mitkPointSetReaderTest().

virtual DataStorage::SetOfObjects::Pointer mitk::IFileReader::Read ( mitk::DataStorage & ds )

pure virtual

Reads the specified file or input stream, loading its contents into the provided DataStorage.

Parameters

ds	The DataStorage to which the data is added.

Returns: The set of added DataNodes to ds.

This method may be overridden by implementations to create or reconstructed a hierarchy of mitk::DataNode instances in the provided mitk::DataStorage.

Exceptions

mitk::Exception

Implemented in mitk::AbstractFileReader.

virtual void mitk::IFileReader::SetInput ( const std::string & location )

pure virtual

Set the input location.

Parameters

location The file name to read from.

Implemented in mitk::AbstractFileReader.

Referenced by mitk::FileReaderSelector::FileReaderSelector(), mitk::IOUtil::Load(), and mitkPointSetReaderTest().

virtual void mitk::IFileReader::SetInput	(	const std::string &	location,
		std::istream *	is
	)

pure virtual

Set an input stream to read from.

Parameters

location	A custom label for the input stream.
is	The input stream.

If is is NULL, this clears the current input stream and location is interpreted as a file-system path. Otherwise, location is a custom label describing the input stream is.

Implemented in mitk::AbstractFileReader.

The documentation for this struct was generated from the following files:

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation