#include <itkObjectFactoryBase.h>

Inheritance diagram for itk::ObjectFactoryBase:

Collaboration diagram for itk::ObjectFactoryBase:

Classes
class	OverrideInformation

Public Types
using	ConstPointer = SmartPointer< const Self >

using	InsertionPositionEnum = ObjectFactoryEnums::InsertionPosition

using	Pointer = SmartPointer< Self >

using	Self = ObjectFactoryBase

using	Superclass = Object

Public Types inherited from itk::Object
using	ConstPointer = SmartPointer< const Self >

using	Pointer = SmartPointer< Self >

using	Self = Object

using	Superclass = LightObject

Public Types inherited from itk::LightObject
using	ConstPointer = SmartPointer< const Self >

using	Pointer = SmartPointer< Self >

using	Self = LightObject

Public Member Functions
virtual const char *	GetNameOfClass () const

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *)

unsigned long	AddObserver (const EventObject &event, Command *) const

unsigned long	AddObserver (const EventObject &event, std::function< void(const EventObject &)> function) const

LightObject::Pointer	CreateAnother () const override

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary ()

const MetaDataDictionary &	GetMetaDataDictionary () const

virtual ModifiedTimeType	GetMTime () const

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

void	Register () const override

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag)

void	SetDebug (bool debugFlag) const

void	SetReferenceCount (int) override

void	UnRegister () const noexcept override

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

void	SetMetaDataDictionary (MetaDataDictionary &&rrhs)

virtual void	SetObjectName (std::string _arg)

virtual const std::string &	GetObjectName () const

Public Member Functions inherited from itk::LightObject
Pointer	Clone () const

virtual void	Delete ()

virtual int	GetReferenceCount () const

void	Print (std::ostream &os, Indent indent=0) const

Static Public Member Functions
static std::list< LightObject::Pointer >	CreateAllInstance (const char *itkclassname)

static LightObject::Pointer	CreateInstance (const char *itkclassname)

static void	RegisterFactoryInternal (ObjectFactoryBase *)

static void	ReHash ()

Static Public Member Functions inherited from itk::Object
static bool	GetGlobalWarningDisplay ()

static void	GlobalWarningDisplayOff ()

static void	GlobalWarningDisplayOn ()

static Pointer	New ()

static void	SetGlobalWarningDisplay (bool val)

Static Public Member Functions inherited from itk::LightObject
static void	BreakOnError ()

static Pointer	New ()

OverRideMap *	m_OverrideMap

void *	m_LibraryHandle

unsigned long	m_LibraryDate

std::string	m_LibraryPath

static ObjectFactoryBasePrivate *	m_PimplGlobals

virtual const char *	GetITKSourceVersion () const =0

virtual const char *	GetDescription () const =0

virtual std::list< std::string >	GetClassOverrideNames ()

virtual std::list< std::string >	GetClassOverrideWithNames ()

virtual std::list< std::string >	GetClassOverrideDescriptions ()

virtual std::list< bool >	GetEnableFlags ()

virtual void	SetEnableFlag (bool flag, const char className, const char subclassName)

virtual bool	GetEnableFlag (const char className, const char subclassName)

virtual void	Disable (const char *className)

const char *	GetLibraryPath ()

static bool	RegisterFactory (ObjectFactoryBase *, InsertionPositionEnum where=InsertionPositionEnum::INSERT_AT_BACK, vcl_size_t position=0)

static void	UnRegisterFactory (ObjectFactoryBase *)

static void	UnRegisterAllFactories ()

static std::list< ObjectFactoryBase * >	GetRegisteredFactories ()

static void	SetStrictVersionChecking (bool)

static void	StrictVersionCheckingOn ()

static void	StrictVersionCheckingOff ()

static bool	GetStrictVersionChecking ()

void	PrintSelf (std::ostream &os, Indent indent) const override

void	RegisterOverride (const char classOverride, const char subclass, const char description, bool enableFlag, CreateObjectFunctionBase createFunction)

virtual LightObject::Pointer	CreateObject (const char *itkclassname)

virtual std::list< LightObject::Pointer >	CreateAllObject (const char *itkclassname)

	ObjectFactoryBase ()

	~ObjectFactoryBase () override

static void	SynchronizeObjectFactoryBase (void *objectFactoryBasePrivate)

static void	InitializeFactoryList ()

static void	Initialize ()

static void	RegisterInternal ()

static void	LoadDynamicFactories ()

static void	LoadLibrariesInPath (const char *)

static void	DeleteNonInternalFactory (ObjectFactoryBase *)

	itkGetGlobalDeclarationMacro (ObjectFactoryBasePrivate, PimplGlobals)

Additional Inherited Members
Protected Member Functions inherited from itk::Object
	Object ()

	~Object () override

bool	PrintObservers (std::ostream &os, Indent indent) const

virtual void	SetTimeStamp (const TimeStamp &timeStamp)

Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer	InternalClone () const

	LightObject ()

virtual void	PrintHeader (std::ostream &os, Indent indent) const

virtual void	PrintTrailer (std::ostream &os, Indent indent) const

virtual	~LightObject ()

Protected Attributes inherited from itk::LightObject
std::atomic< int >	m_ReferenceCount

Detailed Description

Create instances of classes using an object factory.

ObjectFactoryBase is used to create itk objects. The base class ObjectFactoryBase contains a static method CreateInstance() that is used to create itk objects from the list of registerd ObjectFactoryBase sub-classes. The first time CreateInstance() is called, all dll's or shared libraries in the environment variable ITK_AUTOLOAD_PATH are loaded into the current process. The C function itkLoad is called on each dll. itkLoad should return an instance of the factory sub-class implemented in the shared library. ITK_AUTOLOAD_PATH is an environment variable containing a colon separated (semi-colon on win32) list of paths.

This can be use to override the creation of any object in ITK.

Definition at line 62 of file itkObjectFactoryBase.h.

Member Typedef Documentation

◆ ConstPointer

using itk::ObjectFactoryBase::ConstPointer = SmartPointer<const Self>

Definition at line 71 of file itkObjectFactoryBase.h.

◆ InsertionPositionEnum

using itk::ObjectFactoryBase::InsertionPositionEnum = ObjectFactoryEnums::InsertionPosition

Definition at line 105 of file itkObjectFactoryBase.h.

◆ Pointer

using itk::ObjectFactoryBase::Pointer = SmartPointer<Self>

Definition at line 70 of file itkObjectFactoryBase.h.

◆ Self

using itk::ObjectFactoryBase::Self = ObjectFactoryBase

Standard class type aliases.

Definition at line 68 of file itkObjectFactoryBase.h.

◆ Superclass

using itk::ObjectFactoryBase::Superclass = Object

Definition at line 69 of file itkObjectFactoryBase.h.

Constructor & Destructor Documentation

◆ ObjectFactoryBase()

itk::ObjectFactoryBase::ObjectFactoryBase ( )

protected

Member variables for a factory set by the base class at load or register time

◆ ~ObjectFactoryBase()

itk::ObjectFactoryBase::~ObjectFactoryBase ( )

overrideprotected

Member variables for a factory set by the base class at load or register time

Member Function Documentation

◆ CreateAllInstance()

static std::list<LightObject::Pointer> itk::ObjectFactoryBase::CreateAllInstance ( const char * itkclassname )

static

Create and return all possible instances of the named itk object. Each loaded ObjectFactoryBase will be asked in the order the factory was in the ITK_AUTOLOAD_PATH. All created objects will be returned in the list.

Examples: SphinxExamples/src/IO/ImageBase/RegisterIOFactories/Code.cxx.

◆ CreateAllObject()

virtual std::list<LightObject::Pointer> itk::ObjectFactoryBase::CreateAllObject ( const char * itkclassname )

protectedvirtual

This method creates all the objects with the class override of itkclass name, which are provide by this object

◆ CreateInstance()

static LightObject::Pointer itk::ObjectFactoryBase::CreateInstance ( const char * itkclassname )

static

Create and return an instance of the named itk object. Each loaded ObjectFactoryBase will be asked in the order the factory was in the ITK_AUTOLOAD_PATH. After the first factory returns the object no other factories are asked.

Referenced by itk::ObjectFactory< T >::Create(), and itk::TransformFactoryBase::RegisterTransform().

◆ CreateObject()

virtual LightObject::Pointer itk::ObjectFactoryBase::CreateObject ( const char * itkclassname )

protectedvirtual

This method is provided by sub-classes of ObjectFactoryBase. It should create the named itk object or return 0 if that object is not supported by the factory implementation.

◆ DeleteNonInternalFactory()

static void itk::ObjectFactoryBase::DeleteNonInternalFactory ( ObjectFactoryBase * )

staticprivate

Member variables for a factory set by the base class at load or register time

◆ Disable()

virtual void itk::ObjectFactoryBase::Disable ( const char * className )

virtual

Set all enable flags for the given class to 0. This will mean that the factory will stop producing class with the given name.

◆ GetClassOverrideDescriptions()

virtual std::list<std::string> itk::ObjectFactoryBase::GetClassOverrideDescriptions ( )

virtual

Return a list of descriptions for class overrides.

◆ GetClassOverrideNames()

virtual std::list<std::string> itk::ObjectFactoryBase::GetClassOverrideNames ( )

virtual

Return a list of classes that this factory overrides.

◆ GetClassOverrideWithNames()

virtual std::list<std::string> itk::ObjectFactoryBase::GetClassOverrideWithNames ( )

virtual

Return a list of the names of classes that override classes.

◆ GetDescription()

virtual const char* itk::ObjectFactoryBase::GetDescription ( ) const

pure virtual

Return a descriptive string describing the factory.

◆ GetEnableFlag()

virtual bool itk::ObjectFactoryBase::GetEnableFlag	(	const char *	className,
		const char *	subclassName
	)

virtual

Get the Enable flag for the specific override of className.

◆ GetEnableFlags()

virtual std::list<bool> itk::ObjectFactoryBase::GetEnableFlags ( )

virtual

Return a list of enable flags.

◆ GetITKSourceVersion()

virtual const char* itk::ObjectFactoryBase::GetITKSourceVersion ( ) const

pure virtual

All sub-classes of ObjectFactoryBase should must return the version of ITK they were built with. This should be implemented with the macro ITK_SOURCE_VERSION and NOT a call to Version::GetITKSourceVersion. As the version needs to be compiled into the file as a string constant. This is critical to determine possible incompatible dynamic factory loads.

◆ GetLibraryPath()

const char* itk::ObjectFactoryBase::GetLibraryPath ( )

This returns the path to a dynamically loaded factory.

◆ GetNameOfClass()

virtual const char* itk::ObjectFactoryBase::GetNameOfClass ( ) const

virtual

Run-time type information (and related methods).

Reimplemented from itk::Object.

◆ GetRegisteredFactories()

static std::list<ObjectFactoryBase *> itk::ObjectFactoryBase::GetRegisteredFactories ( )

static

Return the list of all registered factories. This is NOT a copy, do not remove items from this list!

Examples: Examples/IO/IOFactoryRegistration.cxx, and Examples/IO/IOPlugin.cxx.

◆ GetStrictVersionChecking()

static bool itk::ObjectFactoryBase::GetStrictVersionChecking ( )

static

Member variables for a factory set by the base class at load or register time

◆ Initialize()

static void itk::ObjectFactoryBase::Initialize ( )

staticprivate

Initialize the static members of ObjectFactoryBase. RegisterInternal() and InitializeFactoryList() are called here.

◆ InitializeFactoryList()

static void itk::ObjectFactoryBase::InitializeFactoryList ( )

staticprivate

Initialize the static list of Factories.

◆ itkGetGlobalDeclarationMacro()

itk::ObjectFactoryBase::itkGetGlobalDeclarationMacro	(	ObjectFactoryBasePrivate	,
		PimplGlobals
	)

private

Member variables for a factory set by the base class at load or register time

◆ LoadDynamicFactories()

static void itk::ObjectFactoryBase::LoadDynamicFactories ( )

staticprivate

Load dynamic factories from the ITK_AUTOLOAD_PATH

◆ LoadLibrariesInPath()

static void itk::ObjectFactoryBase::LoadLibrariesInPath ( const char * )

staticprivate

Load all dynamic libraries in the given path

◆ PrintSelf()

void itk::ObjectFactoryBase::PrintSelf	(	std::ostream &	os,
		Indent	indent
	)		const

overrideprotectedvirtual

Member variables for a factory set by the base class at load or register time

Reimplemented from itk::Object.

Reimplemented in itk::HDF5ImageIOFactory, itk::BYUMeshIOFactory, itk::OBJMeshIOFactory, itk::OFFMeshIOFactory, itk::VTKPolyDataMeshIOFactory, itk::NiftiImageIOFactory, itk::GE4ImageIOFactory, itk::GE5ImageIOFactory, itk::GEAdwImageIOFactory, itk::SiemensVisionImageIOFactory, itk::FreeSurferAsciiMeshIOFactory, itk::FreeSurferBinaryMeshIOFactory, itk::GiftiMeshIOFactory, itk::HDF5TransformIOFactory, itk::MatlabTransformIOFactory, and itk::TxtTransformIOFactory.

◆ RegisterFactory()

static bool itk::ObjectFactoryBase::RegisterFactory	(	ObjectFactoryBase *	,
		InsertionPositionEnum	where = `InsertionPositionEnum::INSERT_AT_BACK`,
		vcl_size_t	position = `0`
	)

static

Register a factory so it can be used to create itk objects.

When InsertionPositionEnum::INSERT_AT_POSITION is selected, a third argument must be provided
with the actual integer number of the intended position. The position
number must be in the range [0, numberOfRegisteredFactories-1].

Usage should be any of the following:

itk::ObjectFactoryBase::RegisterFactory( newFactory1 ); // at back
itk::ObjectFactoryBase::RegisterFactory( newFactory2, InsertionPositionEnum::INSERT_AT_FRONT );
itk::ObjectFactoryBase::RegisterFactory( newFactory3, InsertionPositionEnum::INSERT_AT_BACK );
itk::ObjectFactoryBase::RegisterFactory( newFactory4, InsertionPositionEnum::INSERT_AT_POSITION, 5 );

If the position value is out of range, an exception will be
thrown.
Returns true if the factory was successfully registered.
Returns false if factory is already loaded.

Referenced by itk::SpatialObjectFactoryBase::GetFactory(), ProcessArgumentsAndRegisterBuiltInFactories(), itk::VoxBoCUBImageIOFactory::RegisterOneFactory(), itk::GPUGradientAnisotropicDiffusionImageFilterFactory::RegisterOneFactory(), itk::GPUMeanImageFilterFactory::RegisterOneFactory(), itk::GPUDemonsRegistrationFilterFactory::RegisterOneFactory(), itk::GPUBinaryThresholdImageFilterFactory::RegisterOneFactory(), itk::RawImageIOFactory< TPixel, VImageDimension >::RegisterOneFactory(), and itk::GPUImageFactory::RegisterOneFactory().

◆ RegisterFactoryInternal()

static void itk::ObjectFactoryBase::RegisterFactoryInternal ( ObjectFactoryBase * )

static

Register a factory so it can be used to create itk objects. This method is intended to be called only for built-in default factories, not for loadable factories.

Factories that are registered with this method will be registered after ReHash.

◆ RegisterInternal()

static void itk::ObjectFactoryBase::RegisterInternal ( )

staticprivate

Register default factories which are not loaded at run time.

◆ RegisterOverride()

void itk::ObjectFactoryBase::RegisterOverride	(	const char *	classOverride,
		const char *	subclass,
		const char *	description,
		bool	enableFlag,
		CreateObjectFunctionBase *	createFunction
	)

protected

Register object creation information with the factory.

Referenced by itk::TransformFactoryBase::RegisterTransform().

◆ ReHash()

static void itk::ObjectFactoryBase::ReHash ( )

static

Re-check the ITK_AUTOLOAD_PATH for new factory libraries. This calls UnRegisterAll before re-loading.

Examples: Examples/IO/IOPlugin.cxx.

◆ SetEnableFlag()

virtual void itk::ObjectFactoryBase::SetEnableFlag	(	bool	flag,
		const char *	className,
		const char *	subclassName
	)

virtual

Set the Enable flag for the specific override of className.

◆ SetStrictVersionChecking()

static void itk::ObjectFactoryBase::SetStrictVersionChecking ( bool )

static

Require the ITK version of this application to exactly match the ITK version used to compile a dynamic library. When this is set to true, if the versions do not match, an exception will be thrown. When this is false, and the versions do not match, only a warning message is printed out in the console, and the factory is still registered.

◆ StrictVersionCheckingOff()

static void itk::ObjectFactoryBase::StrictVersionCheckingOff ( )

static

Member variables for a factory set by the base class at load or register time

◆ StrictVersionCheckingOn()

static void itk::ObjectFactoryBase::StrictVersionCheckingOn ( )

static

Member variables for a factory set by the base class at load or register time

◆ SynchronizeObjectFactoryBase()

static void itk::ObjectFactoryBase::SynchronizeObjectFactoryBase ( void * objectFactoryBasePrivate )

staticprivate

Set/Get the pointer to ObjectFactoryBasePrivate. No concurrent thread safe.

◆ UnRegisterAllFactories()

static void itk::ObjectFactoryBase::UnRegisterAllFactories ( )

static

Unregister all factories.

◆ UnRegisterFactory()

static void itk::ObjectFactoryBase::UnRegisterFactory ( ObjectFactoryBase * )

static

Remove a factory from the list of registered factories.

Member Data Documentation

◆ m_LibraryDate

unsigned long itk::ObjectFactoryBase::m_LibraryDate

private

Member variables for a factory set by the base class at load or register time

Definition at line 288 of file itkObjectFactoryBase.h.

◆ m_LibraryHandle

void* itk::ObjectFactoryBase::m_LibraryHandle

private

Member variables for a factory set by the base class at load or register time

Definition at line 287 of file itkObjectFactoryBase.h.

◆ m_LibraryPath

std::string itk::ObjectFactoryBase::m_LibraryPath

private

Member variables for a factory set by the base class at load or register time

Definition at line 289 of file itkObjectFactoryBase.h.

◆ m_OverrideMap

OverRideMap* itk::ObjectFactoryBase::m_OverrideMap

private

Member variables for a factory set by the base class at load or register time

Definition at line 259 of file itkObjectFactoryBase.h.

◆ m_PimplGlobals

ObjectFactoryBasePrivate* itk::ObjectFactoryBase::m_PimplGlobals

staticprivate

Member variables for a factory set by the base class at load or register time

Definition at line 291 of file itkObjectFactoryBase.h.

The documentation for this class was generated from the following file:

itkObjectFactoryBase.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ ConstPointer

◆ InsertionPositionEnum

◆ Pointer

◆ Self

◆ Superclass

Constructor & Destructor Documentation

◆ ObjectFactoryBase()

◆ ~ObjectFactoryBase()

Member Function Documentation

◆ CreateAllInstance()

◆ CreateAllObject()

◆ CreateInstance()

◆ CreateObject()

◆ DeleteNonInternalFactory()

◆ Disable()

◆ GetClassOverrideDescriptions()

◆ GetClassOverrideNames()

◆ GetClassOverrideWithNames()

◆ GetDescription()

◆ GetEnableFlag()

◆ GetEnableFlags()

◆ GetITKSourceVersion()

◆ GetLibraryPath()

◆ GetNameOfClass()

◆ GetRegisteredFactories()

◆ GetStrictVersionChecking()

◆ Initialize()

◆ InitializeFactoryList()

◆ itkGetGlobalDeclarationMacro()

◆ LoadDynamicFactories()

◆ LoadLibrariesInPath()

◆ PrintSelf()

◆ RegisterFactory()

◆ RegisterFactoryInternal()

◆ RegisterInternal()

◆ RegisterOverride()

◆ ReHash()

◆ SetEnableFlag()

◆ SetStrictVersionChecking()

◆ StrictVersionCheckingOff()

◆ StrictVersionCheckingOn()

◆ SynchronizeObjectFactoryBase()

◆ UnRegisterAllFactories()

◆ UnRegisterFactory()

Member Data Documentation

◆ m_LibraryDate

◆ m_LibraryHandle

◆ m_LibraryPath

◆ m_OverrideMap

◆ m_PimplGlobals