This class supports multi-threading of image chain getTile() requests and associated chain updating. More...

#include <ossimImageChainMtAdaptor.h>

Inheritance diagram for ossimImageChainMtAdaptor:

Public Member Functions
	ossimImageChainMtAdaptor ()

	ossimImageChainMtAdaptor (ossimImageChain *original, ossim_uint32 num_threads=0, bool use_shared_handlers=false, bool use_cache=false, ossim_uint32 cache_tile_size=64)
	Full constructor accepts the original image chain to clone. More...

	~ossimImageChainMtAdaptor ()

void	setNumberOfThreads (ossim_uint32 num_threads)
	Alternate way of specifying number of threads to support. More...

void	setUseSharedHandlers (bool use_shared_handlers)

void	setCacheTileSize (ossim_uint32 cache_tile_size)

void	setUseCache (bool use_cache)

void	setOriginalChain (ossimImageChain *original)
	Alternate way of specifying the original chain being adapted for multi-threading. More...

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIrect &tileRect, ossim_uint32 resLevel=0)
	Intercepts the getTile because it should never be called directly. More...

virtual void	initialize ()
	Adapts call to original chain so that all clones are initialized. More...

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=NULL)
	Adapts call to original chain so that clones are replicated after original's loadState. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=NULL) const
	Adapts call to original chain so that adapter-specific keywords can be added to KWL. More...

virtual void	processEvent (ossimEvent &event)
	Adapts the image chain event handler. More...

ossimImageSource *	getClone (ossim_uint32 index)
	Returns pointer to a specific clone image chain, or NULL if index exceeds the max available. More...

ossim_uint32	getNumberOfClones () const
	Returns the number of clones available. The original chain always counts as the first clone. More...

virtual ossimConnectableObject::ConnectableObjectList &	imageChainList ()
	These overriding access methods greatly facilitate the implementation of an image chain adapter class operating on the member original chain. More...

virtual const ossimConnectableObject::ConnectableObjectList &	imageChainList () const

virtual ossim_int32	connectMyOutputTo (ossimConnectableObject *outputObject, bool makeInputConnection=true, bool createEventFlag=true)
	Overrides base class implementation in order to make the connection to each clone. More...

Public Member Functions inherited from ossimImageChain
	ossimImageChain ()

virtual	~ossimImageChain ()

ossimConnectableObject::ConnectableObjectList &	getChainList ()

const ossimConnectableObject::ConnectableObjectList &	getChainList () const

ossimConnectableObject *	operator[] (ossim_uint32 index)

virtual ossimConnectableObject *	getConnectableObject (ossim_uint32 index)
	Same as operator[](ossim_uint32 i) More...

virtual ossim_int32	indexOf (ossimConnectableObject *obj) const

virtual ossimImageSource *	getFirstSource ()
	Return the first source which is the one that first receives the getTile request. More...

virtual const ossimImageSource *	getFirstSource () const

virtual ossimObject *	getFirstObject ()

virtual ossimImageSource *	getLastSource ()
	Return the last source which is the one that last receives the getTile request. More...

virtual const ossimImageSource *	getLastSource () const

virtual ossimObject *	getLastObject ()

bool	addFirst (ossimConnectableObject *obj)
	Adds it to the start of the chain. More...

bool	addLast (ossimConnectableObject *obj)
	Adds it to the end. More...

bool	deleteFirst ()
	Deletes the first object. More...

bool	deleteLast ()
	Deletes the last object. More...

bool	insertRight (ossimConnectableObject newObj, ossimConnectableObject rightOfThisObj)

bool	insertRight (ossimConnectableObject *newObj, const ossimId &id)

bool	insertLeft (ossimConnectableObject *newObj, const ossimId &id)

bool	insertLeft (ossimConnectableObject newObj, ossimConnectableObject leftOfThisObj)

bool	replace (ossimConnectableObject newObj, ossimConnectableObject oldObj)

virtual bool	add (ossimConnectableObject *source)
	Will return true or false if an image source was added to the chain. More...

virtual ossim_uint32	getNumberOfInputBands () const
	this call is passed to the head of the list. More...

virtual ossimScalarType	getOutputScalarType () const
	This call is passed to the head of the list. More...

virtual double	getNullPixelValue (ossim_uint32 band=0) const
	Each band has a null pixel associated with it. More...

virtual double	getMinPixelValue (ossim_uint32 band=0) const
	Returns the min pixel of the band. More...

virtual double	getMaxPixelValue (ossim_uint32 band=0) const
	Returns the max pixel of the band. More...

virtual void	getOutputBandList (std::vector< ossim_uint32 > &bandList) const
	Initializes bandList. More...

virtual ossim_uint32	getTileWidth () const
	This call is passed to the head of the list. More...

virtual ossim_uint32	getTileHeight () const
	This call is passed to the head of the list. More...

virtual ossimIrect	getBoundingRect (ossim_uint32 resLevel=0) const
	Will pass this call to the head of the list. More...

virtual void	getValidImageVertices (vector< ossimIpt > &validVertices, ossimVertexOrdering ordering=OSSIM_CLOCKWISE_ORDER, ossim_uint32 resLevel=0) const

virtual ossimRefPtr< ossimImageGeometry >	getImageGeometry ()
	Returns the image geometry object associated with this tile source or NULL if not defined. More...

virtual void	getDecimationFactor (ossim_uint32 resLevel, ossimDpt &result) const
	Will return the decimation factor for the given resolution level. More...

virtual void	getDecimationFactors (vector< ossimDpt > &decimations) const

virtual ossim_uint32	getNumberOfDecimationLevels () const
	Will return the number of resolution levels. More...

virtual void	enableSource ()

virtual void	disableSource ()

bool	canConnectMyInputTo (ossim_int32 myInputIndex, const ossimConnectableObject *object) const
	required to be overriden by derived classes More...

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject::ConnectableObjectList findAllObjectsOfType(const RTTItypeid &typeInfo, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject::ConnectableObjectList findAllObjectsOfType(const ossimString &className, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findFirstObjectOfType(const RTTItypeid &typeInfo, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findFirstObjectOfType(const ossimString &className, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findObject(const ossimId &id, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject findObject(const ossimConnectableObject obj, bool recurse=true))

virtual void	makeUniqueIds ()
	Will cycle through all sources setting their ids. More...

virtual ossim_uint32	getNumberOfObjects (bool recurse=true) const
	Returns the number of objects within this container and all child containers. More...

virtual ossim_uint32	getNumberOfSources () const
	Deprecated! Please use getNumberOfObjects(false). More...

virtual bool	addChild (ossimConnectableObject *attachableObject)
	Will add an object to the container and then set the added objects owner to this. More...

virtual bool	removeChild (ossimConnectableObject *object)
	Will remove the child from the container. More...

virtual ossimConnectableObject *	removeChild (const ossimId &id)

virtual void	getChildren (vector< ossimConnectableObject *> &children, bool immediateChildrenOnlyFlag)

virtual void	disconnectInputEvent (ossimConnectionEvent &event)

virtual void	disconnectOutputEvent (ossimConnectionEvent &event)

virtual void	connectInputEvent (ossimConnectionEvent &event)

virtual void	connectOutputEvent (ossimConnectionEvent &event)

virtual void	objectDestructingEvent (ossimObjectDestructingEvent &event)

virtual void	propagateEventToOutputs (ossimEvent &event)

virtual void	propagateEventToInputs (ossimEvent &event)

virtual void	accept (ossimVisitor &visitor)
	We will add a visitor interface for all connectable objects. More...

void	deleteList ()

Public Member Functions inherited from ossimImageSource
	ossimImageSource (ossimObject *owner=0)

	ossimImageSource (ossimObject *owner, ossim_uint32 inputListSize, ossim_uint32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimImageSource ()

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIpt &origin, ossim_uint32 resLevel=0)

virtual bool	getTile (ossimImageData *result, ossim_uint32 resLevel=0)
	Method to get a tile. More...

virtual ossimObject *	getObject ()
	For RTTI support. More...

virtual const ossimObject *	getObject () const
	For RTTI support. More...

virtual void	getDecimationFactors (std::vector< ossimDpt > &decimations) const
	Will return an array of all decimations for each resolution level. More...

virtual ossim_uint32	getNumberOfOutputBands () const
	Returns the number of bands in a tile returned from this TileSource. More...

virtual void	getBoundingRect (ossimIrect &rect, ossim_uint32 resLevel=0) const
	Gets the bounding rectangle of the source. More...

virtual void	getValidImageVertices (std::vector< ossimIpt > &validVertices, ossimVertexOrdering ordering=OSSIM_CLOCKWISE_ORDER, ossim_uint32 resLevel=0) const
	ordering specifies how the vertices should be arranged. More...

virtual void	setImageGeometry (const ossimImageGeometry *geom)
	Default implementation sets geometry of the first input to the geometry specified. More...

virtual void	saveImageGeometry () const
	Default method to call input's saveImageGeometry. More...

virtual void	saveImageGeometry (const ossimFilename &geometry_file) const
	Default method to call input's saveImageGeometry. More...

virtual ossimRefPtr< ossimProperty >	getProperty (const ossimString &name) const

virtual void	setProperty (ossimRefPtr< ossimProperty > property)

virtual void	getPropertyNames (std::vector< ossimString > &propertyNames) const

virtual bool	isIndexedData () const

Public Member Functions inherited from ossimSource
	ossimSource (ossimObject *owner=0)

	ossimSource (ossimObject *owner, ossim_uint32 inputListSize, ossim_uint32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimSource ()

virtual bool	isSourceEnabled () const

virtual bool	getEnableFlag () const

virtual void	setEnableFlag (bool flag)

virtual bool	isInitialized () const

virtual void	setInitializedFlag (bool flag)

virtual std::ostream &	print (std::ostream &out) const
	Outputs theErrorStatus as an ossimErrorCode and an ossimString. More...

Public Member Functions inherited from ossimConnectableObject
	ossimConnectableObject (ossimObject *owner=0)
	Base constructor of this object. More...

	ossimConnectableObject (ossimObject *owner, ossim_int32 inputListSize, ossim_int32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimConnectableObject ()

void	setId (const ossimId &id)
	All connectable objects will have id's. More...

const ossimId &	getId () const
	Will allow us to get this object's id. More...

const ossimObject *	getOwner () const
	Fetches the current owner, most likely a container but not limited to one. More...

virtual void	changeOwner (ossimObject *owner)
	Permits changing the object's owner. More...

virtual void	setDescription (const ossimString &description)

virtual ossimString	getDescription () const

virtual bool	isConnected (ossimConnectableObjectDirectionType direction=CONNECTABLE_DIRECTION_INPUT) const
	will check the direction specified to see if all slots are full. More...

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findConnectableObject(const ossimId &id))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findObjectOfType(RTTItypeid typeId, ossimConnectableObjectDirectionType directionType, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findObjectOfType(const ossimString &obj, ossimConnectableObjectDirectionType directionType, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findInputObjectOfType(const ossimString &className))

virtual ossim_int32	findInputIndex (const ossimConnectableObject *object)
	Return a valid index of the input list if the passed in object is found else return -1. More...

virtual ossim_int32	findInputIndex (const ossimId &id)
	Return a valid index of the input list if the passed id is found else return -1. More...

virtual ossim_int32	findOutputIndex (const ossimConnectableObject *object)
	Return a valid index of the output list if the passed in object is found else return -1. More...

virtual ossim_int32	findOutputIndex (const ossimId &id)
	Return a valid index of the output list if the passed in object is found else return -1. More...

virtual ossim_int32	getMyInputIndexToConnectTo (ossimConnectableObject *object) const
	Should return the first available index to connect to. More...

virtual ossim_int32	getMyOutputIndexToConnectTo (ossimConnectableObject *object) const
	Should return the first available index to connect to. More...

virtual bool	canConnectMyOutputTo (ossim_int32 myOutputIndex, const ossimConnectableObject *object) const
	default implementation is to allow anyone to connect to us. More...

virtual void	disconnect (ossimConnectableObject *object=0)
	Will disconnect the object passed in. More...

virtual void	disconnect (const ossimId &id)
	Will disconnect the object passed in. More...

virtual ossimRefPtr< ossimConnectableObject >	disconnectMyInput (ossim_int32 inputIndex, bool disconnectOutputFlag=true, bool createEventFlag=true)
	Will disconnect the object at the given input index and generate a connection event. More...

virtual void	disconnectMyInput (ossimConnectableObject *input, bool disconnectOutputFlag=true, bool createEventFlag=true)
	Finds the index of the passed in input and calls disconnectMyInput(inputIndex, disconnectOutputFlag, createEventFlag);. More...

virtual void	disconnectMyInputs (ConnectableObjectList &inputList, bool disconnectOutputFlag=true, bool createEventFlag=true)

virtual ossimRefPtr< ossimConnectableObject >	disconnectMyOutput (ossim_int32 outputIndex, bool disconnectInputFlag=true, bool createEventFlag=true)
	Will disconnect the object at the given output index and generate a connection event. More...

virtual void	disconnectMyOutput (ossimConnectableObject *output, bool disconnectInputFlag=true, bool createEventFlag=true)
	Will disconnect the output object. More...

virtual void	disconnectMyOutputs (ConnectableObjectList &outputList, bool disconnectOutputFlag=true, bool createEventFlag=true)

virtual void	disconnectAllInputs ()
	Will disconnect all of the input objects. More...

virtual void	disconnectAllOutputs ()
	Will disconnect all of the output objects. More...

virtual ossim_int32	connectMyInputTo (ossimConnectableObject *inputObject, bool makeOutputConnection=true, bool createEventFlag=true)
	Will try to connect this objects input to the passed in object. More...

virtual ossim_int32	connectMyInputTo (ossim_int32 inputIndex, ossimConnectableObject *inputObject, bool makeOutputConnection=true, bool createEventFlag=true)
	Will connect the specified input to the passed in object. More...

virtual bool	connectMyInputTo (ConnectableObjectList &inputList, bool makeOutputConnection=true, bool createEventFlag=true)

virtual bool	connectMyOutputTo (ConnectableObjectList &outputList, bool makeInputConnection=true, bool createEventFlag=true)

virtual bool	connectInputList (ConnectableObjectList &inputList)
	Will disconnect itself from all inputs and reset to the passed in input list. More...

virtual bool	connectOutputList (ConnectableObjectList &outputList)
	Will disconnect itself from all outputs and reset to the passed in output list. More...

virtual ossim_uint32	getNumberOfInputs () const
	Returns the number of input objects. More...

virtual ossim_uint32	getNumberOfOutputs () const
	Return the number of output objects. More...

ossimConnectableObject *	getInput (ossim_uint32 index=0)
	returns the object at the specified index. More...

const ossimConnectableObject *	getInput (ossim_uint32 index=0) const
	returns the object at the specified index. More...

ossimConnectableObject *	getOutput (ossim_uint32 index=0)
	returns the object at the specified index. More...

const ossimConnectableObject *	getOutput (ossim_uint32 index=0) const
	returns the object at the specified index. More...

virtual void	setNumberOfInputs (ossim_int32 numberOfInputs)
	Will set the number of inputs. More...

virtual bool	getInputListIsFixedFlag () const

virtual bool	getOutputListIsFixedFlag () const

virtual void	setNumberOfOutputs (ossim_int32 numberOfInputs)
	Will set the number of outputs. More...

const ConnectableObjectList &	getInputList () const

const ConnectableObjectList &	getOutputList () const

ConnectableObjectList &	getInputList ()

ConnectableObjectList &	getOutputList ()

	OSSIM_DEPRECATE_METHOD (virtual void findAllObjectsOfType(ConnectableObjectList &result, const RTTItypeid &typeInfo, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual void findAllObjectsOfType(ConnectableObjectList &result, const ossimString &className, bool recurse=true))

virtual void	setProperty (const ossimString &name, const ossimString &value)

virtual ossim_uint32	saveStateOfAllInputs (ossimKeywordlist &kwl, bool saveThisStateFlag=true, ossim_uint32 objectIndex=1, const char *prefix=0) const
	Save the state of all inputs to a keyword list. More...

virtual bool	fillContainer (ossimConnectableContainer &container)
	Inserts this object and all of its children and inputs into the container provided. More...

bool	moveInputUp (const ossimId &id)
	Moves the input connection matching id up one in the connection list. More...

bool	moveInputDown (const ossimId &id)
	Moves the input connection matching id down one in the connection list. More...

bool	moveInputToTop (const ossimId &id)
	Moves the input connection matching id to the top of the connection list. More...

bool	moveInputToBottom (const ossimId &id)
	Moves the input connection matching id to the bottom of the connection list. More...

Public Member Functions inherited from ossimObject
	ossimObject ()

virtual	~ossimObject ()

virtual ossimObject *	dup () const

virtual ossimString	getShortName () const

virtual ossimString	getLongName () const

virtual ossimString	getClassName () const

virtual RTTItypeid	getType () const

virtual bool	canCastTo (ossimObject *obj) const

virtual bool	canCastTo (const RTTItypeid &id) const

virtual bool	canCastTo (const ossimString &parentClassName) const

virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const

Public Member Functions inherited from ossimReferenced
	ossimReferenced ()

	ossimReferenced (const ossimReferenced &)

ossimReferenced &	operator= (const ossimReferenced &)

void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...

void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

int	referenceCount () const

Public Member Functions inherited from ossimListenerManager
	ossimListenerManager ()

virtual	~ossimListenerManager ()

virtual void	fireEvent (ossimEvent &event)

virtual bool	addListener (ossimListener *listener)

virtual bool	removeListener (ossimListener *listener)

virtual bool	findListener (ossimListener *listener)

Public Member Functions inherited from ossimPropertyInterface
	ossimPropertyInterface ()

virtual	~ossimPropertyInterface ()

virtual ossimString	getPropertyValueAsString (const ossimString &name) const

void	getPropertyList (std::vector< ossimRefPtr< ossimProperty > > &propertyList) const

void	setProperties (std::vector< ossimRefPtr< ossimProperty > > &propertyList)

Public Member Functions inherited from ossimErrorStatusInterface
	ossimErrorStatusInterface ()

virtual	~ossimErrorStatusInterface ()

virtual ossimErrorCode	getErrorStatus () const

virtual ossimString	getErrorStatusString () const

virtual void	setErrorStatus (ossimErrorCode error_status) const

virtual void	setErrorStatus () const

virtual void	clearErrorStatus () const

bool	hasError () const

Public Member Functions inherited from ossimConnectableObjectListener
	ossimConnectableObjectListener ()

virtual	~ossimConnectableObjectListener ()

virtual void	connectionEvent (ossimConnectionEvent &)

virtual void	propertyEvent (ossimPropertyEvent &)

virtual void	addObjectEvent (ossimContainerEvent &)

virtual void	removeObjectEvent (ossimContainerEvent &)

virtual void	containerEvent (ossimContainerEvent &)

virtual void	refreshEvent (ossimRefreshEvent &)

Public Member Functions inherited from ossimListener
	ossimListener ()

virtual	~ossimListener ()

void	enableListener ()

void	disableListener ()

void	setListenerEnableFlag (bool flag)

bool	isListenerEnabled () const

bool	getListenerEnableFlag () const

Public Member Functions inherited from ossimConnectableContainerInterface
	ossimConnectableContainerInterface (ossimObject *obj)

virtual	~ossimConnectableContainerInterface ()

virtual ossimConnectableObject::ConnectableObjectList	findAllObjectsOfType (const RTTItypeid &typeInfo, bool recurse=true)=0

virtual ossimConnectableObject::ConnectableObjectList	findAllObjectsOfType (const ossimString &className, bool recurse=true)=0

virtual ossimConnectableObject *	findFirstObjectOfType (const RTTItypeid &typeInfo, bool recurse=true)=0

virtual ossimConnectableObject *	findFirstObjectOfType (const ossimString &className, bool recurse=true)=0

virtual ossimConnectableObject *	findObject (const ossimId &id, bool recurse=true)=0

virtual ossimConnectableObject *	findObject (const ossimConnectableObject *obj, bool recurse=true)=0

ossimObject *	getObject ()

const ossimObject *	getObject () const

void	deleteAllChildren ()

virtual void	getChildren (std::vector< ossimConnectableObject *> &children, bool immediateChildrenOnlyFlag)=0

Protected Types
typedef std::vector< ossimRefPtr< ossimImageHandlerMtAdaptor > >	SharedHandlerList
	List of handlers that are being shared among all clones (if requested). More...

Protected Member Functions
void	deleteReplicas ()
	Deletes instances of all replicas from the clone list and leaves only the original. More...

bool	replicate ()
	Creates clones of original and pushes them onto the clone list. Returns TRUE if successful. More...

bool	connectSharedHandlers (ossim_uint32 index)
	Manages reconnecting shared image handlers to a cloned image chain (identified by index) after its creation. More...

Protected Member Functions inherited from ossimImageChain
void	prepareForRemoval (ossimConnectableObject *connectableObject)
	Inserts all of this object's children and inputs into the container provided. More...

bool	addAllSources (map< ossimId, vector< ossimId > > &idMapping, const ossimKeywordlist &kwl, const char *prefix=NULL)
	For dynamic loading to take place we must allocate all objects first and then assign id's later. More...

void	findInputConnectionIds (vector< ossimId > &result, const ossimKeywordlist &kwl, const char *prefix=NULL)

bool	connectAllSources (const map< ossimId, vector< ossimId > > &idMapping)

Protected Member Functions inherited from ossimImageSource
	ossimImageSource (const ossimImageSource &rhs)

const ossimImageSource &	operator= (const ossimImageSource &)

Protected Member Functions inherited from ossimSource
	ossimSource (const ossimSource &rhs)

const ossimSource &	operator= (const ossimSource &rhs)

Protected Member Functions inherited from ossimConnectableObject
ossimConnectableObject *	findObjectOfType (ConnectableObjectList *connectableList, ossimVisitor &visitor)

Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Protected Member Functions inherited from ossimListenerManager
	ossimListenerManager (const ossimListenerManager &rhs)

Protected Attributes
ossimRefPtr< ossimImageChain >	m_adaptedChain
	This is the adaptee image chain. More...

std::vector< ossimRefPtr< ossimImageSource > >	m_clones
	List of replicated child chains' first source (the one receiving the getTile call). More...

std::vector< ossimRefPtr< ossimConnectableContainer > >	m_chainContainers
	The container objects must be kept alive in this vector while their child chains in m_clones are used. More...

SharedHandlerList	m_sharedHandlers

ossim_uint32	m_numThreads

bool	d_useSharedHandlers

ossim_uint32	d_cacheTileSize

bool	d_useCache

bool	d_debugEnabled

Protected Attributes inherited from ossimImageChain
ossimConnectableObject::ConnectableObjectList	theImageChainList
	This will hold a sequence of image sources. More...

ossimRefPtr< ossimImageData >	theBlankTile

bool	theLoadStateFlag

Protected Attributes inherited from ossimSource
bool	theEnableFlag

bool	theInitializedFlag

Protected Attributes inherited from ossimConnectableObject
ossimId	theId

ossimString	theDescription

ossimObject *	theOwner

bool	theInputListIsFixedFlag
	Indicates whether the theInputObjectList is fixed. More...

bool	theOutputListIsFixedFlag
	Indicates whether the theOutputObjectList is fixed. More...

ConnectableObjectList	theInputObjectList
	Holds a list of input objects. More...

ConnectableObjectList	theOutputObjectList
	Holds a list of output objects. More...

Protected Attributes inherited from ossimListenerManager
std::list< ossimListener * >	theListenerList

bool	theEnabledFlag

std::list< ossimListener * >	theDelayedAdd

std::list< ossimListener * >	theDelayedRemove

bool	theFireEventFlag

Protected Attributes inherited from ossimErrorStatusInterface
ossimErrorCode	theErrorStatus

Protected Attributes inherited from ossimListener
bool	theListenerEnableFlag

Protected Attributes inherited from ossimConnectableContainerInterface
ossimObject *	theBaseObject

Friends
class	ossimMultiThreadSequencer

Additional Inherited Members
Public Types inherited from ossimConnectableObject
enum	ossimConnectableObjectDirectionType { CONNECTABLE_DIRECTION_NONE = 0, CONNECTABLE_DIRECTION_INPUT = 1, CONNECTABLE_DIRECTION_OUTPUT = 2 }

typedef std::vector< ossimRefPtr< ossimConnectableObject > >	ConnectableObjectList

Detailed Description

This class supports multi-threading of image chain getTile() requests and associated chain updating.

It accepts an original ossimImageChain object which is then cloned (replicated). One clone per thread is created, counting the original as clone(0), with all clones sharing a common input handler (if directed) so that disk access is serialized and thread-safe.

Definition at line 25 of file ossimImageChainMtAdaptor.h.

Member Typedef Documentation

◆ SharedHandlerList

typedef std::vector<ossimRefPtr<ossimImageHandlerMtAdaptor> > ossimImageChainMtAdaptor::SharedHandlerList

protected

List of handlers that are being shared among all clones (if requested).

It is a list since the original chain may involve a combiner with multiple image inputs.

Definition at line 116 of file ossimImageChainMtAdaptor.h.

Constructor & Destructor Documentation

◆ ossimImageChainMtAdaptor() [1/2]

ossimImageChainMtAdaptor::ossimImageChainMtAdaptor ( )

Definition at line 30 of file ossimImageChainMtAdaptor.cpp.

References ossimMtDebug::chainDebugEnabled, d_debugEnabled, and ossimMtDebug::instance().

 :  m_numThreads (0),
    d_useSharedHandlers(false),
    d_debugEnabled(false),
    d_cacheTileSize(1024),
    d_useCache(false)
 {
    //###### DEBUG ############
    ossimMtDebug* mt_debug = ossimMtDebug::instance();
    //d_useSharedHandlers = mt_debug->chainSharedHandlers;
    d_debugEnabled = mt_debug->chainDebugEnabled;
    //###### END DEBUG ############
 }

◆ ossimImageChainMtAdaptor() [2/2]

ossimImageChainMtAdaptor::ossimImageChainMtAdaptor	(	ossimImageChain *	original,
		ossim_uint32	num_threads = `0`,
		bool	use_shared_handlers = `false`,
		bool	use_cache = `false`,
		ossim_uint32	cache_tile_size = `64`
	)

Full constructor accepts the original image chain to clone.

Parameters

num_threads Total number of cloned chains to make available.

Definition at line 47 of file ossimImageChainMtAdaptor.cpp.

References ossimMtDebug::chainDebugEnabled, d_debugEnabled, ossimMtDebug::instance(), setCacheTileSize(), setNumberOfThreads(), setOriginalChain(), setUseCache(), and setUseSharedHandlers().

 :  m_numThreads (0),
    d_useSharedHandlers(false),
    d_debugEnabled(false),
    d_cacheTileSize(1024),
    d_useCache(false)
 {
    //###### DEBUG ############
    ossimMtDebug* mt_debug = ossimMtDebug::instance();
    //d_useSharedHandlers = mt_debug->chainSharedHandlers;
    d_debugEnabled = mt_debug->chainDebugEnabled;
    //###### END DEBUG ############
 
    setNumberOfThreads(num_threads_req); 
    setUseSharedHandlers(use_shared_handlers);
    setUseCache(use_cache);
    setCacheTileSize(cache_tile_size);
    setOriginalChain(original); 
 }

◆ ~ossimImageChainMtAdaptor()

ossimImageChainMtAdaptor::~ossimImageChainMtAdaptor ( )

Definition at line 71 of file ossimImageChainMtAdaptor.cpp.

References d_useSharedHandlers, m_chainContainers, m_clones, m_sharedHandlers, and ossimListenerManager::removeListener().

 {
   removeListener((ossimConnectableObjectListener*)this);
   if (d_useSharedHandlers)
     m_sharedHandlers[0]->disconnectAllOutputs();
   m_clones.clear();
   m_chainContainers.clear();
   if (d_useSharedHandlers)
   {
     m_sharedHandlers[0]->close();
     m_sharedHandlers[0] = 0;
     m_sharedHandlers.clear();
   }
 }

Member Function Documentation

◆ connectMyOutputTo()

ossim_int32 ossimImageChainMtAdaptor::connectMyOutputTo	(	ossimConnectableObject *	outputObject,
		bool	makeInputConnection = `true`,
		bool	createEventFlag = `true`
	)

virtual

Overrides base class implementation in order to make the connection to each clone.

This connection is typically to the multi-thread sequencer object.

Reimplemented from ossimConnectableObject.

Definition at line 473 of file ossimImageChainMtAdaptor.cpp.

References ossimConnectableObject::connectMyOutputTo(), and m_clones.

 {
    // Make output connection for each clone source:
    std::vector< ossimRefPtr<ossimImageSource> >::iterator clone_source = m_clones.begin();
    while (clone_source != m_clones.end())
    {
       (*clone_source)->connectMyOutputTo(outputObject, false, false);
       clone_source++;
    }
 
    // Now make master connection including making input connection on outputObject and firing event:
    return ossimConnectableObject::connectMyOutputTo(outputObject, 
                                                     makeInputConnection, 
                                                     createEventFlag);
 }

◆ connectSharedHandlers()

bool ossimImageChainMtAdaptor::connectSharedHandlers ( ossim_uint32 index )

protected

Manages reconnecting shared image handlers to a cloned image chain (identified by index) after its creation.

This is in support of shared image handlers. Returns TRUE if successful.

Definition at line 388 of file ossimImageChainMtAdaptor.cpp.

References ossimConnectableObject::connectMyInputTo(), ossimId::getId(), ossimIdVisitor::getObject(), m_chainContainers, and m_sharedHandlers.

Referenced by replicate().

 {
    if ((size_t)chain_index >= m_chainContainers.size())
       return false;
 
    // Loop over each adapted handler in our shared handler list:
    SharedHandlerList::iterator handler = m_sharedHandlers.begin();
    while (handler != m_sharedHandlers.end())
    {
       // Fetch all objects connected to this adapted handler. The list will point to objects in
       // m_chainContainers[0], the original chain. The new chain's objects share the same ID's as
       // the original chain for the moment. So we can search for the output connection 
       // in the new chain using the ID of the corresponding object in the original chain:
       ConnectableObjectList handler_connections = (*handler)->getOutputList();
       ConnectableObjectList::iterator output_connection = handler_connections.begin();
       // BUG HERE AFTER UPGRADING FROM 1.8.14 to 1.8.20 - only grabbing the first output connection
       //while (output_connection != handler_connections.end())
       //{
          ossimId obj_id = (*output_connection)->getId();
          ossimIdVisitor visitor (obj_id);
          m_chainContainers[chain_index]->accept(visitor);
 
          // Get the pointer to the actual output object that needs to be connected to the shared
          // handler:
          ossimConnectableObject* output_obj = visitor.getObject();
          if (output_obj == NULL)
             return false; // Should never happen
          output_obj->connectMyInputTo((*handler).get(), true, true);
 
          output_connection++;
       //}
       handler++;
    }
    return true;
 }

◆ deleteReplicas()

void ossimImageChainMtAdaptor::deleteReplicas ( )

protected

Deletes instances of all replicas from the clone list and leaves only the original.

Definition at line 230 of file ossimImageChainMtAdaptor.cpp.

References m_clones, and m_numThreads.

Referenced by loadState().

 {
    if (m_clones.size() > 1)
    {
       std::vector< ossimRefPtr<ossimImageSource> >::iterator first_copy = m_clones.begin();
       first_copy++;
       m_clones.erase(first_copy, m_clones.end());
    }
    m_numThreads = 1;
 }

◆ getClone()

ossimImageSource * ossimImageChainMtAdaptor::getClone ( ossim_uint32 index )

Returns pointer to a specific clone image chain, or NULL if index exceeds the max available.

The clone at index=0 corresponds to the original, though this detail should be ignored.

Definition at line 461 of file ossimImageChainMtAdaptor.cpp.

References m_clones.

Referenced by ossimMultiThreadSequencer::ossimGetTileJob::run().

 {
    if (index < (ossim_uint32) m_clones.size())
       return m_clones[index].get();
    
    return 0;
 }

◆ getNumberOfClones()

ossim_uint32 ossimImageChainMtAdaptor::getNumberOfClones ( ) const

inline

Returns the number of clones available. The original chain always counts as the first clone.

Definition at line 73 of file ossimImageChainMtAdaptor.h.

73 { return (ossim_uint32) m_clones.size(); }

ossimImageChainMtAdaptor::m_clones

std::vector< ossimRefPtr< ossimImageSource > > m_clones

List of replicated child chains' first source (the one receiving the getTile call).

Definition: ossimImageChainMtAdaptor.h:104

ossim_uint32

unsigned int ossim_uint32

Definition: ossimConstants.h:235

◆ getTile()

ossimRefPtr< ossimImageData > ossimImageChainMtAdaptor::getTile	(	const ossimIrect &	tileRect,
		ossim_uint32	resLevel = `0`
	)

virtual

Intercepts the getTile because it should never be called directly.

The tile request must go to the specific chain clone.

Reimplemented from ossimImageChain.

Definition at line 371 of file ossimImageChainMtAdaptor.cpp.

References ossimImageChain::getTile(), m_adaptedChain, ossimNotify(), ossimNotifyLevel_WARN, and ossimRefPtr< T >::valid().

 {
    ossimNotify(ossimNotifyLevel_WARN)<<"ossimImageChainMtAdaptor::getTile() -- This method "
       "Should never be called directly. The tile request must go to the specific chain clone. "
       "Returning a tile using the original chain's getTile (not threaded)..."<<endl;
    
    if (!m_adaptedChain.valid())
       return ossimRefPtr<ossimImageData>(0);
       
    return m_adaptedChain->getTile(tileRect, resLevel);
 }

◆ imageChainList() [1/2]

ossimConnectableObject::ConnectableObjectList & ossimImageChainMtAdaptor::imageChainList ( )

virtual

These overriding access methods greatly facilitate the implementation of an image chain adapter class operating on the member original chain.

These methods really should be "protected" but the compiler complains if the base class declarations are "protected".

Reimplemented from ossimImageChain.

Definition at line 428 of file ossimImageChainMtAdaptor.cpp.

References ossimImageChain::imageChainList(), m_adaptedChain, ossimImageChain::theImageChainList, and ossimRefPtr< T >::valid().

 {
    // If there is no original chain defined, then just return our own blank list:
    if (!m_adaptedChain.valid())
       return theImageChainList;
 
    return m_adaptedChain->imageChainList();
 }

◆ imageChainList() [2/2]

const ossimConnectableObject::ConnectableObjectList & ossimImageChainMtAdaptor::imageChainList ( ) const

virtual

Reimplemented from ossimImageChain.

Definition at line 441 of file ossimImageChainMtAdaptor.cpp.

References ossimImageChain::imageChainList(), m_adaptedChain, ossimImageChain::theImageChainList, and ossimRefPtr< T >::valid().

 {
    // If there is no original chain defined, then just return our own blank list:
    if (!m_adaptedChain.valid())
       return theImageChainList;
 
    return m_adaptedChain->imageChainList();
 }

◆ initialize()

void ossimImageChainMtAdaptor::initialize ( )

virtual

Adapts call to original chain so that all clones are initialized.

Reimplemented from ossimImageChain.

Definition at line 361 of file ossimImageChainMtAdaptor.cpp.

References m_clones.

 {
    for (size_t i=0; i<m_clones.size(); ++i)
       m_clones[i]->initialize();
 }

◆ loadState()

bool ossimImageChainMtAdaptor::loadState	(	const ossimKeywordlist &	kwl,
		const char *	prefix = `NULL`
	)

virtual

Adapts call to original chain so that clones are replicated after original's loadState.

Reimplemented from ossimImageChain.

Definition at line 264 of file ossimImageChainMtAdaptor.cpp.

References deleteReplicas(), and ossimKeywordlist::find().

Referenced by replicate().

 {
    bool succeeded;
 
    // Reset this object:
    deleteReplicas();
 
    // Fetch this object's data members before moving onto original chain:
    ossimString value = kwl.find(prefix, NUM_THREADS_KW);
    if (value.empty())
       return false;
    m_numThreads = value.toUInt32();
    if (m_numThreads == 0)
       return false;
 
    // The chain ID needs to be read from KWL:
    ossimId orig_source_id (ossimId::INVALID_ID);
    value = kwl.find(prefix, ORIGINAL_SOURCE_ID_KW);
    if (value.empty())
       return false;
    orig_source_id.setId(value.toInt64());
 
    // This loadState may be called for the purpose of replicating the existing original, or it can
    // be intended as an adapter to a yet-to-be-instantiated original chain. Check if we already
    // have a valid original chain:
    ossimConnectableObject* candidate = 0;
    ossimImageSource* original_source = 0;
    if (!m_adaptedChain.valid() || m_chainContainers.empty())
    {
       m_chainContainers.clear();
       m_chainContainers.push_back(new ossimConnectableContainer);
       m_chainContainers[0]->loadState(kwl, prefix);
 
       // Need to instantiate a new original. This is a bootstrap for a full initialization of this
       // object. We'll need to replicate the clones afterwards:
       ossimIdVisitor visitor (orig_source_id);
       m_chainContainers[0]->accept(visitor);
       candidate = visitor.getObject();
       original_source = dynamic_cast<ossimImageSource*>(candidate);
       if (original_source == NULL)
          return false;
       m_clones.push_back(original_source); // original is always in first position of clones list
 
       // The original "chain" is morphed into a chain with a single child (original first source).
       // This source is the one maintaining the connection to the rest of the sources in the real
       // processing chain:
       m_adaptedChain = new ossimImageChain;
       m_adaptedChain->add(original_source);
 
       // Now that we have an original chain, Recursive code to replicate clones:
       succeeded = replicate();
       if (!succeeded)
          return false;
    }
 
    // We may be done:
    if (m_numThreads == 1)
       return true;
 
    // In preparation for multi-threading jobs, loop to instantiate all clone chains. The container
    // class is used to perform a deep copy of the original chain with all connections established.
    // It would have been cleaner to just use the ossimImageChain::dup() but that method was not
    // traversing the full chain, resulting in missing input sources:
    succeeded = true;
    for (ossim_uint32 i=1; (i<m_numThreads) && succeeded; ++i)
    {
       // Use original container's kwl to dup clone container, and pull out our chain of interest:
       m_chainContainers.push_back(new ossimConnectableContainer);
       m_chainContainers[i]->loadState(kwl, prefix);
       
       // Special handling required if the handlers are being shared. In this case, the handler had
       // been removed from the original chain, so connections need to be identified and made:
       if (d_useSharedHandlers)
       {
          succeeded = connectSharedHandlers(i);
          if (!succeeded)
             return false;
       }
 
       // Find the first (right-most) source in the chain and store it in the clone list. Need to
       // Modify all IDs
       ossimIdVisitor visitor (orig_source_id);
       m_chainContainers[i]->accept(visitor);
       candidate = visitor.getObject();
       m_chainContainers[i]->makeUniqueIds();
       ossimRefPtr<ossimImageSource> clone_source = dynamic_cast<ossimImageSource*>(candidate);
       if (!clone_source)
          return false;
       m_clones.push_back(clone_source);
    }
 
    return succeeded;
 }

◆ processEvent()

void ossimImageChainMtAdaptor::processEvent ( ossimEvent & event )

virtual

Adapts the image chain event handler.

If the event involves a change to the original image chain, then the clones will need to be regenerated here.

Reimplemented from ossimImageChain.

Definition at line 454 of file ossimImageChainMtAdaptor.cpp.

References ossimNotify(), and ossimNotifyLevel_WARN.

 {
    ossimNotify(ossimNotifyLevel_WARN)<<"ossimImageChainMtAdaptor::processEvent() -- "
       "NOT YET IMPLEMENTED"<<endl;
 }

◆ replicate()

bool ossimImageChainMtAdaptor::replicate ( )

protected

Creates clones of original and pushes them onto the clone list. Returns TRUE if successful.

Definition at line 162 of file ossimImageChainMtAdaptor.cpp.

References ossimConnectableObject::changeOwner(), connectSharedHandlers(), d_cacheTileSize, d_useCache, d_useSharedHandlers, ossimRefPtr< T >::get(), ossimCollectionVisitor::getObjectAs(), loadState(), m_chainContainers, m_clones, m_numThreads, m_sharedHandlers, and saveState().

Referenced by setNumberOfThreads(), and setOriginalChain().

 {
    if ((m_clones.empty()) || (m_numThreads == 0))
       return false;
 
    // Don't need to replicate if only one thread is being requested. This is not an error though:
    if (m_numThreads == 1)
       return true;
 
    // If the handlers are to be shared, need to isolate them from the original chain and replace
    // them with a "hollow adaptor" (i.e., a handler adaptor without the adaptee set yet:
    m_sharedHandlers.clear();
    if (d_useSharedHandlers)
    {
       if (m_chainContainers.empty())
          return false;
 
       // Collect all image handlers in original chain for possible sharing with all clones:
       ossimTypeNameVisitor visitor (ossimString("ossimImageHandler"));
       m_chainContainers[0]->accept(visitor);
       ossimRefPtr<ossimImageHandler> handler = 0;
       ossimRefPtr<ossimImageHandlerMtAdaptor> handler_adaptor = 0;
       ossimRefPtr<ossimConnectableObject> output_connection = 0;
       ossim_uint32 handler_idx = 0;
 
       // Loop over all image handlers found in the original chain. Each handler's connection info
       // is stored and the handler is removed temporarily from the original chain.
       while (1) 
       {
          // Fetch a handler from the chain and wrap it with a handler adaptor:
          handler = visitor.getObjectAs<ossimImageHandler>(handler_idx++);
          if (!handler)
             break; // Only exit point of while loop
          
          handler_adaptor = new ossimImageHandlerMtAdaptor(handler.get(), d_useCache, d_cacheTileSize);
          m_sharedHandlers.push_back(handler_adaptor);
 
          // Change ownership:
          m_chainContainers[0]->removeChild(handler.get());
          handler->changeOwner(this);
       } 
 
       // If no handler was found, we can't continue.
       if (m_sharedHandlers.empty())
          return false;
    }
 
    // Fetch the state of this and the original chain. This KWL will be used for creating replicas
    // via the loadState. The saveState essentially bootstraps the replication task:
    ossimKeywordlist kwl;
    bool succeeded = saveState(kwl);
 
    // The original chain may have had the handlers temporarily removed for the saveState in support
    // of shared handlers. If so, need to restore them now:
    if (d_useSharedHandlers)
       succeeded = connectSharedHandlers(0);
 
    // Finally, initialize THIS chain with the original chain's state. This call will also create
    // the clones:
    if (succeeded)
       succeeded = loadState(kwl);
 
    return succeeded;
 }

◆ saveState()

bool ossimImageChainMtAdaptor::saveState	(	ossimKeywordlist &	kwl,
		const char *	prefix = `NULL`
	)		const

virtual

Adapts call to original chain so that adapter-specific keywords can be added to KWL.

Reimplemented from ossimImageChain.

Definition at line 244 of file ossimImageChainMtAdaptor.cpp.

References ossimKeywordlist::add(), and m_chainContainers.

Referenced by replicate().

 {
    if (m_chainContainers.empty())
       return false;
 
    kwl.add(prefix, NUM_THREADS_KW, m_numThreads);
    kwl.add(prefix, ORIGINAL_SOURCE_ID_KW, m_clones[0]->getId().getId());
    
    bool rtn_state = m_chainContainers[0]->saveState(kwl, prefix);
 
    if (d_debugEnabled)
       kwl.write("ossimImageChainMtAdaptor.kwl");
 
    return rtn_state;
 }

◆ setCacheTileSize()

void ossimImageChainMtAdaptor::setCacheTileSize ( ossim_uint32 cache_tile_size )

Definition at line 118 of file ossimImageChainMtAdaptor.cpp.

References d_cacheTileSize.

Referenced by ossimImageChainMtAdaptor(), ossimMultiThreadSequencer::setCacheTileSize(), and ossimMultiThreadSequencer::setToStartOfSequence().

 {
    d_cacheTileSize = cache_tile_size;
 }

◆ setNumberOfThreads()

void ossimImageChainMtAdaptor::setNumberOfThreads ( ossim_uint32 num_threads )

Alternate way of specifying number of threads to support.

This is the same as the number of clones that will be available after replicating the original chain.

Parameters

num_threads Total number of cloned chains to make available.

This is the same as the number of clones that will be available after replicating the original chain.

Definition at line 90 of file ossimImageChainMtAdaptor.cpp.

References ossimString::empty(), ossimPreferences::findPreference(), ossimPreferences::instance(), m_chainContainers, m_numThreads, replicate(), and ossimString::toUInt32().

Referenced by ossimImageChainMtAdaptor(), ossimMultiThreadSequencer::setNumberOfThreads(), and ossimMultiThreadSequencer::setToStartOfSequence().

 {
    if (m_numThreads == num_threads)
       return;
 
    // Determine number of cores/threads to set up:
    if (num_threads > 0)
    {
       m_numThreads = num_threads;
    }
    else
    {
       // Look in ossim preferences if arg is provided above.
       ossimString value = ossimPreferences::instance()->findPreference("ossim_threads");
       if ( !value.empty() )
          m_numThreads = value.toUInt32();
    }
 
    // If there is a valid original chain, we can perform the replication:
    if (!m_chainContainers.empty())
       replicate();
 }

◆ setOriginalChain()

void ossimImageChainMtAdaptor::setOriginalChain ( ossimImageChain * original )

Alternate way of specifying the original chain being adapted for multi-threading.

Parameters

original Image chain to be adapted.

Definition at line 131 of file ossimImageChainMtAdaptor.cpp.

References ossimConnectableObject::fillContainer(), ossimImageChain::getFirstSource(), m_adaptedChain, m_chainContainers, m_clones, m_numThreads, and replicate().

Referenced by ossimImageChainMtAdaptor().

 {
    if (original == NULL)
       return;
 
    ossimImageSource* first_source = original->getFirstSource();
    if (first_source == NULL)
       return;
 
    // Assign the adaptee and put it in the first position of the clones list:
    m_adaptedChain = original;
    m_clones.clear();
    m_clones.push_back(first_source);
 
    m_chainContainers.clear();
    m_chainContainers.push_back(new ossimConnectableContainer);
    m_adaptedChain->fillContainer(*m_chainContainers[0].get());
 
    // If we know the number of threads, we can begin replicating:
    if (m_numThreads > 1)
       replicate();
 }

◆ setUseCache()

void ossimImageChainMtAdaptor::setUseCache ( bool use_cache )

Definition at line 123 of file ossimImageChainMtAdaptor.cpp.

References d_useCache.

Referenced by ossimImageChainMtAdaptor(), ossimMultiThreadSequencer::setToStartOfSequence(), and ossimMultiThreadSequencer::setUseCache().

 {
    d_useCache = use_cache;
 }

◆ setUseSharedHandlers()

void ossimImageChainMtAdaptor::setUseSharedHandlers ( bool use_shared_handlers )

Definition at line 113 of file ossimImageChainMtAdaptor.cpp.

References d_useSharedHandlers.

Referenced by ossimImageChainMtAdaptor(), ossimMultiThreadSequencer::setToStartOfSequence(), and ossimMultiThreadSequencer::setUseSharedHandlers().

 {
    d_useSharedHandlers = use_shared_handlers;
 }

Friends And Related Function Documentation

◆ ossimMultiThreadSequencer

friend class ossimMultiThreadSequencer

friend

Definition at line 27 of file ossimImageChainMtAdaptor.h.

Member Data Documentation

◆ d_cacheTileSize

ossim_uint32 ossimImageChainMtAdaptor::d_cacheTileSize

protected

Definition at line 122 of file ossimImageChainMtAdaptor.h.

Referenced by replicate(), and setCacheTileSize().

◆ d_debugEnabled

bool ossimImageChainMtAdaptor::d_debugEnabled

protected

Definition at line 124 of file ossimImageChainMtAdaptor.h.

Referenced by ossimImageChainMtAdaptor().

◆ d_useCache

bool ossimImageChainMtAdaptor::d_useCache

protected

Definition at line 123 of file ossimImageChainMtAdaptor.h.

Referenced by replicate(), and setUseCache().

◆ d_useSharedHandlers

bool ossimImageChainMtAdaptor::d_useSharedHandlers

protected

Definition at line 121 of file ossimImageChainMtAdaptor.h.

Referenced by replicate(), setUseSharedHandlers(), and ~ossimImageChainMtAdaptor().

◆ m_adaptedChain

ossimRefPtr<ossimImageChain> ossimImageChainMtAdaptor::m_adaptedChain

protected

This is the adaptee image chain.

Definition at line 99 of file ossimImageChainMtAdaptor.h.

Referenced by getTile(), imageChainList(), and setOriginalChain().

◆ m_chainContainers

std::vector< ossimRefPtr<ossimConnectableContainer> > ossimImageChainMtAdaptor::m_chainContainers

protected

The container objects must be kept alive in this vector while their child chains in m_clones are used.

Containers are used because they are the only way of "duping" a complete chain with all connections properly done. The containers need to persist in order for the chain connections to be maintained (apparent bug in connectable object code). I found it impossible to dissociate the chain from its container. As soon as the container disappeared, the chain's internal connections would be disrupted. (OLK 11/11)

Definition at line 112 of file ossimImageChainMtAdaptor.h.

Referenced by connectSharedHandlers(), replicate(), saveState(), setNumberOfThreads(), setOriginalChain(), and ~ossimImageChainMtAdaptor().

◆ m_clones

std::vector< ossimRefPtr<ossimImageSource> > ossimImageChainMtAdaptor::m_clones

protected

List of replicated child chains' first source (the one receiving the getTile call).

The first in the list is always the original (adaptee) source. These are owned by the m_chainContainers that are maintained here.

Definition at line 104 of file ossimImageChainMtAdaptor.h.

Referenced by connectMyOutputTo(), deleteReplicas(), getClone(), initialize(), replicate(), setOriginalChain(), and ~ossimImageChainMtAdaptor().

◆ m_numThreads

ossim_uint32 ossimImageChainMtAdaptor::m_numThreads

protected

Definition at line 119 of file ossimImageChainMtAdaptor.h.

Referenced by deleteReplicas(), replicate(), setNumberOfThreads(), and setOriginalChain().

◆ m_sharedHandlers

SharedHandlerList ossimImageChainMtAdaptor::m_sharedHandlers

protected

Definition at line 117 of file ossimImageChainMtAdaptor.h.

Referenced by connectSharedHandlers(), ossimMultiThreadSequencer::handlerGetTileT(), replicate(), and ~ossimImageChainMtAdaptor().

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

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ SharedHandlerList

Constructor & Destructor Documentation

◆ ossimImageChainMtAdaptor() [1/2]

◆ ossimImageChainMtAdaptor() [2/2]

◆ ~ossimImageChainMtAdaptor()

Member Function Documentation

◆ connectMyOutputTo()

◆ connectSharedHandlers()

◆ deleteReplicas()

◆ getClone()

◆ getNumberOfClones()

◆ getTile()

◆ imageChainList() [1/2]

◆ imageChainList() [2/2]

◆ initialize()

◆ loadState()

◆ processEvent()

◆ replicate()

◆ saveState()

◆ setCacheTileSize()

◆ setNumberOfThreads()

◆ setOriginalChain()

◆ setUseCache()

◆ setUseSharedHandlers()

Friends And Related Function Documentation

◆ ossimMultiThreadSequencer

Member Data Documentation

◆ d_cacheTileSize

◆ d_debugEnabled

◆ d_useCache

◆ d_useSharedHandlers

◆ m_adaptedChain

◆ m_chainContainers

◆ m_clones

◆ m_numThreads

◆ m_sharedHandlers