#include <ossimHistogramEqualization.h>

Inheritance diagram for ossimHistogramEqualization:

Public Member Functions
	ossimHistogramEqualization ()

	ossimHistogramEqualization (ossimImageSource *inputSource, ossimRefPtr< ossimMultiResLevelHistogram > histogram)

	ossimHistogramEqualization (ossimImageSource *inputSource, ossimRefPtr< ossimMultiResLevelHistogram > histogram, bool inverseFlag)

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

virtual void	setHistogram (ossimRefPtr< ossimMultiResLevelHistogram > histogram)

virtual bool	setHistogram (const ossimFilename &filename)

virtual bool	getInverseFlag () const

virtual void	initialize ()

virtual void	setInverseFlag (bool inverseFlag)

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=NULL)
	Method to the load (recreate) the state of an object from a keyword list. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=NULL) const
	Method to save the state of an object to a keyword list. More...

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

Public Member Functions inherited from ossimImageSourceHistogramFilter
	ossimImageSourceHistogramFilter ()

	ossimImageSourceHistogramFilter (ossimImageSource *inputSource, ossimRefPtr< ossimMultiResLevelHistogram > histogram)

virtual const ossimFilename &	getHistogramFilename () const

virtual ossimRefPtr< ossimMultiResLevelHistogram >	getHistogram ()

virtual const ossimRefPtr< ossimMultiResLevelHistogram >	getHistogram () const

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

virtual void	connectInputEvent (ossimConnectionEvent &event)

Public Member Functions inherited from ossimImageSourceFilter
	ossimImageSourceFilter (ossimObject *owner=NULL)

	ossimImageSourceFilter (ossimImageSource *inputSource)

	ossimImageSourceFilter (ossimObject owner, ossimImageSource inputSource)

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

virtual ossim_uint32	getNumberOfInputBands () const

virtual void	disconnectInputEvent (ossimConnectionEvent &event)

virtual void	propertyEvent (ossimPropertyEvent &event)

virtual void	refreshEvent (ossimRefreshEvent &event)

virtual void	setProperty (ossimRefPtr< ossimProperty > property)

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

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

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	getDecimationFactor (ossim_uint32 resLevel, ossimDpt &result) const
	Will return the decimation factor for the given resolution level. More...

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

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

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

virtual ossimScalarType	getOutputScalarType () const
	This will be used to query the output pixel type of the tile source. More...

virtual ossim_uint32	getTileWidth () const
	Returns the default processing tile width. More...

virtual ossim_uint32	getTileHeight () const
	Returns the default processing tile height. 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 ossimIrect	getBoundingRect (ossim_uint32 resLevel=0) const
	This will return the bounding rect of the source. 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 ossimRefPtr< ossimImageGeometry >	getImageGeometry ()
	Returns the image geometry object associated with this tile source or NULL if not defined. 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 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 void	enableSource ()

virtual void	disableSource ()

virtual bool	getEnableFlag () const

virtual void	setEnableFlag (bool flag)

virtual bool	isInitialized () const

virtual void	setInitializedFlag (bool flag)

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 ossim_int32	connectMyOutputTo (ossimConnectableObject *outputObject, bool makeInputConnection=true, bool createEventFlag=true)
	Will try to connect this objects output to the passed in object. More...

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	propagateEventToOutputs (ossimEvent &event)

virtual void	propagateEventToInputs (ossimEvent &event)

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...

virtual void	accept (ossimVisitor &visitor)
	We will add a visitor interface for all connectable objects. 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	processEvent (ossimEvent &event)
	ProcessEvent. More...

virtual void	objectDestructingEvent (ossimObjectDestructingEvent &)

virtual void	connectionEvent (ossimConnectionEvent &)

virtual void	disconnectOutputEvent (ossimConnectionEvent &)

virtual void	connectOutputEvent (ossimConnectionEvent &)

virtual void	addObjectEvent (ossimContainerEvent &)

virtual void	removeObjectEvent (ossimContainerEvent &)

virtual void	containerEvent (ossimContainerEvent &)

Public Member Functions inherited from ossimListener
	ossimListener ()

virtual	~ossimListener ()

void	enableListener ()

void	disableListener ()

void	setListenerEnableFlag (bool flag)

bool	isListenerEnabled () const

bool	getListenerEnableFlag () const

Protected Member Functions
virtual	~ossimHistogramEqualization ()

void	allocate ()
	Called on first getTile, will initialize all data needed. More...

virtual void	computeAccumulationHistogram ()

template<class T >
ossimRefPtr< ossimImageData >	runEqualizationAlgorithm (T dummyVariable, ossimRefPtr< ossimImageData > tile)

virtual void	initializeLuts ()

virtual void	deleteLuts ()

Protected Member Functions inherited from ossimImageSourceHistogramFilter
virtual	~ossimImageSourceHistogramFilter ()

Protected Member Functions inherited from ossimImageSourceFilter
virtual	~ossimImageSourceFilter ()

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< ossimImageData >	theTile

ossimRefPtr< ossimMultiResLevelHistogram >	theAccumulationHistogram

bool	theInverseFlag

vector< double * >	theForwardLut

vector< double * >	theInverseLut

std::vector< ossim_uint32 >	theBandList

Protected Attributes inherited from ossimImageSourceHistogramFilter
ossim_int32	theCurrentResLevel

Protected Attributes inherited from ossimImageSourceFilter
ossimImageSource *	theInputConnection

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

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

Definition at line 16 of file ossimHistogramEqualization.h.

Constructor & Destructor Documentation

◆ ossimHistogramEqualization() [1/3]

ossimHistogramEqualization::ossimHistogramEqualization ( )

Definition at line 29 of file ossimHistogramEqualization.cpp.

    : ossimImageSourceHistogramFilter(),
      theTile(NULL),
      theAccumulationHistogram(NULL),
      theInverseFlag(false)
 {
 }

◆ ossimHistogramEqualization() [2/3]

ossimHistogramEqualization::ossimHistogramEqualization	(	ossimImageSource *	inputSource,
		ossimRefPtr< ossimMultiResLevelHistogram >	histogram
	)

Definition at line 37 of file ossimHistogramEqualization.cpp.

References ossimMultiResLevelHistogram::createAccumulationLessThanEqual(), ossimImageSourceHistogramFilter::getHistogram(), initializeLuts(), and theAccumulationHistogram.

    : ossimImageSourceHistogramFilter(inputSource, histogram),
      theTile(0),
      theAccumulationHistogram(0),
      theInverseFlag(false)
 {
    if(getHistogram().valid())
    {
       theAccumulationHistogram = getHistogram()->createAccumulationLessThanEqual();
       initializeLuts();
    }
 }

◆ ossimHistogramEqualization() [3/3]

ossimHistogramEqualization::ossimHistogramEqualization	(	ossimImageSource *	inputSource,
		ossimRefPtr< ossimMultiResLevelHistogram >	histogram,
		bool	inverseFlag
	)

Definition at line 51 of file ossimHistogramEqualization.cpp.

References ossimMultiResLevelHistogram::createAccumulationLessThanEqual(), ossimImageSourceHistogramFilter::getHistogram(), initializeLuts(), and theAccumulationHistogram.

    : ossimImageSourceHistogramFilter(inputSource, histogram),
      theTile(NULL),
      theAccumulationHistogram(0),
      theInverseFlag(inverseFlag)
 {
    if(getHistogram().valid())
    {
       theAccumulationHistogram = getHistogram()->createAccumulationLessThanEqual();
       initializeLuts();
    }
 }

◆ ~ossimHistogramEqualization()

ossimHistogramEqualization::~ossimHistogramEqualization ( )

protectedvirtual

Definition at line 66 of file ossimHistogramEqualization.cpp.

References deleteLuts().

 {
    deleteLuts();
 }

Member Function Documentation

◆ allocate()

void ossimHistogramEqualization::allocate ( )

protected

Called on first getTile, will initialize all data needed.

Definition at line 351 of file ossimHistogramEqualization.cpp.

References ossimImageDataFactory::create(), ossimImageSource::getOutputBandList(), ossimImageData::initialize(), ossimImageDataFactory::instance(), theBandList, ossimImageSourceFilter::theInputConnection, theTile, and ossimRefPtr< T >::valid().

Referenced by getTile().

 {
    theBandList.clear();
    
    if(theTile.valid())
    {
       theTile = NULL;
    }
    
    if(theInputConnection)
    {
       theInputConnection->getOutputBandList(theBandList);
       theTile = ossimImageDataFactory::instance()->create(this, this);
       if(theTile.valid())
       {
          theTile->initialize();
       }
    }
 }

◆ computeAccumulationHistogram()

void ossimHistogramEqualization::computeAccumulationHistogram ( )

protectedvirtual

Definition at line 235 of file ossimHistogramEqualization.cpp.

References ossimMultiResLevelHistogram::createAccumulationLessThanEqual(), ossimImageSourceHistogramFilter::getHistogram(), and theAccumulationHistogram.

Referenced by getTile(), and setHistogram().

 {
    if(getHistogram().valid())
    {
       theAccumulationHistogram = getHistogram()->createAccumulationLessThanEqual();
    }
 }

◆ deleteLuts()

void ossimHistogramEqualization::deleteLuts ( )

protectedvirtual

Definition at line 515 of file ossimHistogramEqualization.cpp.

References theForwardLut, and theInverseLut.

Referenced by initializeLuts(), and ~ossimHistogramEqualization().

 {
    long band = 0;
    
    for(band = 0; band < (long)theForwardLut.size(); ++band)
    {
       delete [] theForwardLut[band];
    }
    theForwardLut.clear();
    
    for(band = 0; band < (long)theInverseLut.size(); ++band)
    {
       delete [] theInverseLut[band];      
    }
    
    theInverseLut.clear();
 }

◆ getInverseFlag()

bool ossimHistogramEqualization::getInverseFlag ( ) const

virtual

Definition at line 505 of file ossimHistogramEqualization.cpp.

References theInverseFlag.

 {
    return theInverseFlag;
 }

◆ getTile()

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

virtual

Returns: the requested region of interest

Reimplemented from ossimImageSource.

Definition at line 71 of file ossimHistogramEqualization.cpp.

References allocate(), computeAccumulationHistogram(), ossimDataObject::getDataObjectStatus(), ossimImageData::getImageRectangle(), ossimImageData::getNumberOfBands(), ossimRectilinearDataObject::getScalarType(), ossimImageSource::getTile(), initializeLuts(), ossimSource::isSourceEnabled(), OSSIM_EMPTY, OSSIM_FLOAT32, OSSIM_FLOAT64, OSSIM_NULL, OSSIM_SINT16, OSSIM_SINT32, OSSIM_UCHAR, OSSIM_UINT16, OSSIM_UINT32, OSSIM_USHORT11, OSSIM_USHORT12, OSSIM_USHORT13, OSSIM_USHORT14, OSSIM_USHORT15, ossimNotify(), ossimNotifyLevel_WARN, runEqualizationAlgorithm(), ossimImageData::setImageRectangleAndBands(), theAccumulationHistogram, theForwardLut, ossimImageSourceFilter::theInputConnection, theInverseLut, theTile, and ossimRefPtr< T >::valid().

Referenced by ossimHistogramMatchFilter::getTile().

 {
    if(!theInputConnection)
    {
       return NULL;
    }
    
    ossimRefPtr<ossimImageData> inputTile = theInputConnection->getTile(tileRect,
                                                                        resLevel);
 
    if(!inputTile.valid()) return inputTile;
    
    if (!isSourceEnabled())
    {
       return inputTile;
    }
    
    if(!theTile.valid())
    {
       allocate(); // First time through...
    }
    
    // if (!theTile) throw exception!
    
    // Set the origin, resize if needed of the output tile.
    theTile->setImageRectangleAndBands(inputTile->getImageRectangle(),
                       inputTile->getNumberOfBands());
    
    if( !inputTile.valid() ||
        inputTile->getDataObjectStatus() == OSSIM_NULL ||
        inputTile->getDataObjectStatus() == OSSIM_EMPTY )
    {
       return theTile;
    }
 
    if(!theAccumulationHistogram)
    {
       computeAccumulationHistogram();
    }
    if(theForwardLut.size() == 0 ||
       theInverseLut.size() == 0)
    {
       initializeLuts();
    }
    if((theForwardLut.size() == 0) ||
       (theInverseLut.size() == 0))
    {
       return inputTile;
    }
    
    switch(inputTile->getScalarType())
    {
       case OSSIM_UCHAR:
       {
          return runEqualizationAlgorithm(static_cast<ossim_uint8>(0),
                                          inputTile);
       }
       case OSSIM_USHORT11:
       case OSSIM_USHORT12:
       case OSSIM_USHORT13:
       case OSSIM_USHORT14:
       case OSSIM_USHORT15:
       case OSSIM_UINT16:
       {
          return runEqualizationAlgorithm(static_cast<ossim_uint16>(0),
                                          inputTile);
       }
       case OSSIM_SINT16:
       {
          return runEqualizationAlgorithm(static_cast<ossim_sint16>(0),
                                          inputTile);
       }
       case OSSIM_UINT32:
       {
          return runEqualizationAlgorithm(static_cast<ossim_uint32>(0),
                                          inputTile);
       }
       case OSSIM_SINT32:
       {
          return runEqualizationAlgorithm(static_cast<ossim_sint32>(0),
                                          inputTile);
       }
       case OSSIM_FLOAT32:
       {
          return runEqualizationAlgorithm(static_cast<ossim_float32>(0),
                                          inputTile);
       }
       case OSSIM_FLOAT64:
       {
          return runEqualizationAlgorithm(static_cast<ossim_float64>(0),
                                          inputTile);
       }
       default:
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramEqualization::getTile WARNING: Unsupported scalar type."
             << endl;
          break;
       }
    }
    
    return inputTile;
 }

◆ initialize()

void ossimHistogramEqualization::initialize ( )

virtual

Reimplemented from ossimImageSourceFilter.

Definition at line 341 of file ossimHistogramEqualization.cpp.

References ossimImageSourceFilter::initialize(), theTile, and ossimRefPtr< T >::valid().

Referenced by ossimHistogramMatchFilter::connectInputEvent(), ossimHistogramMatchFilter::disconnectInputEvent(), ossimHistogramMatchFilter::initialize(), ossimHistogramMatchFilter::setInputHistogram(), and ossimHistogramMatchFilter::setTargetHistogram().

 {
    // Base class will recapture "theInputConnection".
    ossimImageSourceHistogramFilter::initialize();
    if(theTile.valid())
    {
       theTile = NULL;
    }
 }

◆ initializeLuts()

void ossimHistogramEqualization::initializeLuts ( )

protectedvirtual

We will pre-compute the luts for the forward and inverse equalization. Note: the inverse is a little more tricky and since we must fill the empty spots missed by the inverse. We use a linear interpolation between valid values for this.

Definition at line 371 of file ossimHistogramEqualization.cpp.

References deleteLuts(), ossimHistogram::GetCounts(), ossimImageSourceHistogramFilter::getHistogram(), ossimMultiBandHistogram::getHistogram(), ossimHistogram::GetIndex(), ossimHistogram::GetMaxCount(), ossimMultiResLevelHistogram::getMultiBandHistogram(), ossimMultiBandHistogram::getNumberOfBands(), ossimHistogram::GetRangeMax(), ossimHistogram::GetRangeMin(), ossimHistogram::GetRes(), ossim::isnan(), ossim::nan(), ossimMultiResLevelHistogram::saveState(), theAccumulationHistogram, theForwardLut, theInverseLut, and ossimRefPtr< T >::valid().

Referenced by getTile(), ossimHistogramEqualization(), and setHistogram().

 {
    if(theForwardLut.size() != 0 ||
       theInverseLut.size() != 0)
    {
       deleteLuts();
    }
    if(!theAccumulationHistogram||!getHistogram())
    {
       return;
    }
    ossimRefPtr<ossimMultiBandHistogram> accumHisto = theAccumulationHistogram->getMultiBandHistogram(0);
    ossimRefPtr<ossimMultiBandHistogram> histogram  = getHistogram()->getMultiBandHistogram(0);
    ossimKeywordlist kwl;
    theAccumulationHistogram->saveState(kwl);
 
    if(accumHisto.valid()&&histogram.valid())
    {
       long maxBands = accumHisto->getNumberOfBands();
       
       for(long band = 0; band < maxBands; ++band)
       {
          // first we grab pointers to the histogram and the accumulation
          // histogram
          ossimRefPtr<ossimHistogram> h  = accumHisto->getHistogram(band);
          ossimRefPtr<ossimHistogram> h2 = histogram->getHistogram(band);
 
          if(h.valid()&&h2.valid())
          {
             // lets get the number of indices.
             ossim_uint32 numberOfIndices = (ossim_uint32)h2->GetRes();
             vector<double> countForInverse(numberOfIndices);
             
             theForwardLut.push_back(new double[numberOfIndices]);
             theInverseLut.push_back(new double[numberOfIndices]);
             
             // let's grab the counts array
             const float* histoCounts = h->GetCounts();
 
 //         double maxIntensity      = h2->GetMaxVal();
             double maxIntensity      = h2->GetRangeMax();
             double maxCount          = h->GetMaxCount();
             
             // now pre compute the transforms
             double *forwardLut = theForwardLut[band];
             double *inverseLut = theInverseLut[band];
             
 //         double minIntensity  = h2->GetMinVal();
             double minIntensity  = h2->GetRangeMin();
             double delta = maxIntensity-minIntensity;
             ossim_uint32 idx = 0;
             
             // clear out the inverse
             //
             for(idx = 0; idx < numberOfIndices; ++ idx)
             {
                inverseLut[idx] = ossim::nan();
             }
             for(idx = 0; idx < numberOfIndices; ++ idx)
             {
                forwardLut[idx]   = minIntensity + (histoCounts[idx]/maxCount)*delta;
                
                ossim_int32 inverseIdx = h2->GetIndex(forwardLut[idx]);
                if(inverseIdx >= 0)
                {
                   inverseLut[inverseIdx]   = minIntensity + delta*(idx/(ossim_float32)numberOfIndices);
                }
             }
             
             // now solve the inverse lut
             //
             ossim_uint32 idxStart = 0;
             ossim_uint32 idxEnd = 0;
             
             while((ossim::isnan(inverseLut[idxEnd]))&&(idxEnd <numberOfIndices)){ ++idxEnd;}
             if((idxStart!=idxEnd)&&(idxEnd<numberOfIndices))
             {
                std::fill(inverseLut,
                          inverseLut+idxEnd,
                          inverseLut[idxEnd]);
             }
             idxStart = numberOfIndices-1;
             while((ossim::isnan(inverseLut[idxStart]))&&(idxStart > 0)){ --idxStart;}
             if(idxStart !=0)
             {
                std::fill(inverseLut+idxStart,
                          inverseLut+numberOfIndices,
                          inverseLut[idxStart]);
             }
             
             idxStart = 0;
             idxEnd   = 0;
             ossim_float32 valueStart = 0.0;
             ossim_float32 valueEnd = 0.0;
             
             while(idxStart < numberOfIndices)
             {
                idxEnd = idxStart;
                if(ossim::isnan(inverseLut[idxStart]))
                {
                   while(ossim::isnan(inverseLut[idxEnd])&&(idxEnd < (numberOfIndices-1))) ++idxEnd;
                   double length = (idxEnd-idxStart)+1;
                   valueEnd = inverseLut[idxEnd];
                   double deltaVal = (valueEnd-valueStart);
                   ossim_uint32 tempIdx = idxStart;
                   ossim_float32 count = 1.0;
                   double t = 0.0;
                   while(tempIdx < idxEnd)
                   {
                      t = (count/length);
                      t = t>1.0?1.0:t;
                      inverseLut[tempIdx] = valueStart + deltaVal*t;
                      ++count;
                      ++tempIdx;
                   }
                   idxStart = idxEnd;
                   valueStart = valueEnd;
                }
                else
                {
                   valueStart = inverseLut[idxStart];
                   ++idxStart;
                }
             }
          }
       }
    }
 }

◆ loadState()

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

virtual

Method to the load (recreate) the state of an object from a keyword list.

Return true if ok or false on error.

Reimplemented from ossimImageSourceHistogramFilter.

Definition at line 197 of file ossimHistogramEqualization.cpp.

 {
    static const char MODULE[] = "ossimHistogramEqualization::loadState";
 
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << " Entered..."
          << "\nprefix:  " << prefix << endl;
    }
 
    const char* lookup = kwl.find(prefix,
                                  HISTOGRAM_INVERSE_FLAG_KW);
    if(lookup)
    {
       theInverseFlag = ossimString(lookup).toBool();
    }
    if(ossimImageSourceHistogramFilter::loadState(kwl, prefix))
    {
 //      computeAccumulationHistogram();
 //      initializeLuts();
    }
    else
    {
       return false;
    }
 
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG) << "DEBUG:" << MODULE;
       this->print(ossimNotify(ossimNotifyLevel_DEBUG));
       ossimNotify(ossimNotifyLevel_DEBUG) << "\nExited..." << endl;
    }
    
    return true;
 }

◆ print()

std::ostream & ossimHistogramEqualization::print ( std::ostream & out ) const

virtual

Outputs theErrorStatus as an ossimErrorCode and an ossimString.

Returns: std::ostream&

Note: Derived classes should only have to implement a virtual print, not an operator<< funtion as it's implemented here.

Reimplemented from ossimImageSourceHistogramFilter.

Definition at line 538 of file ossimHistogramEqualization.cpp.

References ossimImageSourceHistogramFilter::print().

 {
    // Base class...
    return ossimImageSourceHistogramFilter::print(out);
 }

◆ runEqualizationAlgorithm()

template<class T >

ossimRefPtr< ossimImageData > ossimHistogramEqualization::runEqualizationAlgorithm	(	T	dummyVariable,
		ossimRefPtr< ossimImageData >	tile
	)

protected

Definition at line 244 of file ossimHistogramEqualization.cpp.

References ossimImageData::getBuf(), ossimDataObject::getDataObjectStatus(), ossimImageData::getHeight(), ossimImageSourceHistogramFilter::getHistogram(), ossimMultiBandHistogram::getHistogram(), ossimHistogram::GetIndex(), ossimImageData::getMaxPix(), ossimImageData::getMinPix(), ossimMultiResLevelHistogram::getMultiBandHistogram(), ossimImageData::getNullPix(), ossimMultiBandHistogram::getNumberOfBands(), ossimImageData::getNumberOfBands(), ossimImageData::getWidth(), OSSIM_FULL, theAccumulationHistogram, theBandList, theForwardLut, theInverseFlag, theInverseLut, ossimRefPtr< T >::valid(), and ossimImageData::validate().

Referenced by getTile().

 {
    
    if(!theAccumulationHistogram ||
       !getHistogram())
    {
       return tile;
    }
 
    // for now we will always pull from res 0 information
    ossimRefPtr<ossimMultiBandHistogram> histo = getHistogram()->getMultiBandHistogram(0);
 
    if(histo.valid())
    {
       ossim_uint32 maxBands = ( (histo->getNumberOfBands() >
                                  tile->getNumberOfBands())?
                                 tile->getNumberOfBands():
                                 histo->getNumberOfBands());
       
       long offsetUpperBound = tile->getHeight()*tile->getWidth();
 
       for(ossim_uint32 band = 0; band < maxBands; ++band)
       {
          ossimRefPtr<ossimHistogram> bandHisto = histo->getHistogram(band);
          T* buf = static_cast<T*>(tile->getBuf(band));
          double *histoLut = band<theForwardLut.size()?theForwardLut[band]:NULL;
          ossim_uint32 actualBand = theBandList[band];
          if(bandHisto.valid())
          {
             if(buf&&histoLut&&(actualBand <  histo->getNumberOfBands()))
             {
                if(theInverseFlag)
                {
                   histoLut = theInverseLut[actualBand];
                }
                if(histoLut)
                {
                   if(tile->getDataObjectStatus() == OSSIM_FULL)
                   {
                      T minPix = (T)tile->getMinPix(actualBand);
                      T maxPix = (T)tile->getMaxPix(actualBand);
                      for(long offset = 0; offset < offsetUpperBound; ++offset)
                      {
                         ossim_int32 idx = bandHisto->GetIndex(buf[offset]);
                            
                         if(idx>=0)
                         {
                            T value = (T)(histoLut[idx]);
 
                            //---
                            // Assign clamping to min max.
                            // 
                            // ESH 03/2009 -- Clamping to within min-max fixed
                            //--- 
                            buf[offset] = value < minPix ? minPix :
                               (value > maxPix ? maxPix : value);
                         }
                      }
                   }
                   else
                   {
                      T minPix  = (T)tile->getMinPix(actualBand);
                      T maxPix  = (T)tile->getMaxPix(actualBand);
                      T nullPix = (T)tile->getNullPix(actualBand);
                      for(long offset = 0; offset < offsetUpperBound; ++offset)
                      {
                         ossim_int32 idx = bandHisto->GetIndex(buf[offset]);
                         
                         if((buf[offset]!=nullPix)&&(idx>=0))
                         {
                            T value = (T)(histoLut[idx]);
 
                            //---
                            // Assign clamping to min max.
                            // 
                            // ESH 03/2009 -- Clamping to within min-max fixed
                            //--- 
                            buf[offset] = value < minPix ? minPix :
                               (value > maxPix ? maxPix : value);
                         }
                         else
                         {
                            buf[offset] = nullPix;
                         }
                      }
                   }
                }
             }
          }
       }
       
       tile->validate();
    }
    
    return tile;
 }

◆ saveState()

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

virtual

Method to save the state of an object to a keyword list.

Return true if ok or false on error.

Reimplemented from ossimImageSourceHistogramFilter.

Definition at line 184 of file ossimHistogramEqualization.cpp.

References ossimKeywordlist::add(), and ossimImageSourceHistogramFilter::saveState().

 {
    bool result = ossimImageSourceHistogramFilter::saveState(kwl, prefix);
 
    kwl.add(prefix,
            HISTOGRAM_INVERSE_FLAG_KW,
            theInverseFlag,
            true);
    
    return result;
 }

◆ setHistogram() [1/2]

void ossimHistogramEqualization::setHistogram ( ossimRefPtr< ossimMultiResLevelHistogram > histogram )

virtual

Reimplemented from ossimImageSourceHistogramFilter.

Definition at line 177 of file ossimHistogramEqualization.cpp.

References computeAccumulationHistogram(), initializeLuts(), and ossimImageSourceHistogramFilter::setHistogram().

Referenced by ossimHistogramMatchFilter::setInputHistogram(), and ossimHistogramMatchFilter::setTargetHistogram().

 {
    ossimImageSourceHistogramFilter::setHistogram(histogram);
    computeAccumulationHistogram();
    initializeLuts();
 }

◆ setHistogram() [2/2]

bool ossimHistogramEqualization::setHistogram ( const ossimFilename & filename )

virtual

Reimplemented from ossimImageSourceHistogramFilter.

Definition at line 500 of file ossimHistogramEqualization.cpp.

References ossimImageSourceHistogramFilter::setHistogram().

 {
    return ossimImageSourceHistogramFilter::setHistogram(filename);
 }

◆ setInverseFlag()

void ossimHistogramEqualization::setInverseFlag ( bool inverseFlag )

virtual

Definition at line 510 of file ossimHistogramEqualization.cpp.

References theInverseFlag.

Referenced by ossimHistogramMatchFilter::ossimHistogramMatchFilter().

 {
    theInverseFlag = inverseFlag;
 }

Member Data Documentation

◆ theAccumulationHistogram

ossimRefPtr<ossimMultiResLevelHistogram> ossimHistogramEqualization::theAccumulationHistogram

protected

This will be used in some of the histogram based operations.

Definition at line 55 of file ossimHistogramEqualization.h.

Referenced by computeAccumulationHistogram(), getTile(), initializeLuts(), ossimHistogramEqualization(), and runEqualizationAlgorithm().

◆ theBandList

std::vector<ossim_uint32> ossimHistogramEqualization::theBandList

protected

Definition at line 80 of file ossimHistogramEqualization.h.

Referenced by allocate(), and runEqualizationAlgorithm().

◆ theForwardLut

vector<double*> ossimHistogramEqualization::theForwardLut

protected

We will create a LUT for each band that directly maps an input value to an equalized output.

Definition at line 71 of file ossimHistogramEqualization.h.

Referenced by deleteLuts(), getTile(), initializeLuts(), and runEqualizationAlgorithm().

◆ theInverseFlag

bool ossimHistogramEqualization::theInverseFlag

protected

Indicates if you should equalize or unequalize an input stream. If the inverse flag is true then it will indicate that we should assume that the input stream is already equalized and we should invert based on the current accumulation histogram.

This flag is defaulted to false.

Definition at line 66 of file ossimHistogramEqualization.h.

Referenced by getInverseFlag(), runEqualizationAlgorithm(), and setInverseFlag().

◆ theInverseLut

vector<double*> ossimHistogramEqualization::theInverseLut

protected

We will create a LUT for each band that directly maps an input value to an un-equalized output.

Definition at line 77 of file ossimHistogramEqualization.h.

Referenced by deleteLuts(), getTile(), initializeLuts(), and runEqualizationAlgorithm().

◆ theTile

ossimRefPtr<ossimImageData> ossimHistogramEqualization::theTile

protected

Definition at line 50 of file ossimHistogramEqualization.h.

Referenced by allocate(), getTile(), and initialize().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimHistogramEqualization() [1/3]

◆ ossimHistogramEqualization() [2/3]

◆ ossimHistogramEqualization() [3/3]

◆ ~ossimHistogramEqualization()

Member Function Documentation

◆ allocate()

◆ computeAccumulationHistogram()

◆ deleteLuts()

◆ getInverseFlag()

◆ getTile()

◆ initialize()

◆ initializeLuts()

◆ loadState()

◆ print()

◆ runEqualizationAlgorithm()

◆ saveState()

◆ setHistogram() [1/2]

◆ setHistogram() [2/2]

◆ setInverseFlag()

Member Data Documentation

◆ theAccumulationHistogram

◆ theBandList

◆ theForwardLut

◆ theInverseFlag

◆ theInverseLut

◆ theTile