#include <ossimPngReader.h>

Inheritance diagram for ossimPngReader:

Public Types
enum	ossimPngReadMode { ossimPngReadUnknown = 0, ossimPngRead8 = 1, ossimPngRead16 = 2, ossimPngRead8a = 3, ossimPngRead16a = 4 }

Public Types inherited from ossimImageHandler
enum	ossimImageHandlerOverviewCompressionType { OSSIM_OVERVIEW_COMPRESSION_NONE = 0, OSSIM_OVERVIEW_COMPRESSION_JPEG, OSSIM_OVERVIEW_COMPRESSION_LZW, OSSIM_OVERVIEW_COMPRESSION_DEFLATE, OSSIM_OVERVIEW_COMPRESSION_PACKBITS }

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

Public Member Functions
	ossimPngReader ()
	default constructor More...

virtual	~ossimPngReader ()
	virtual destructor More...

virtual ossimString	getShortName () const

virtual ossimString	getLongName () const

virtual ossimString	getClassName () const

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIrect &rect, ossim_uint32 resLevel=0)
	Returns a pointer to a tile given an origin representing the upper left corner of the tile to grab from the image. More...

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

virtual ossim_uint32	getNumberOfInputBands () const
	Returns the number of bands in the image. More...

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

virtual ossim_uint32	getNumberOfLines (ossim_uint32 reduced_res_level=0) const
	Returns the number of lines in the image. More...

virtual ossim_uint32	getNumberOfSamples (ossim_uint32 reduced_res_level=0) const
	Returns the number of samples in the image. More...

virtual ossimIrect	getImageRectangle (ossim_uint32 reduced_res_level=0) const
	Returns the zero based image rectangle for the reduced resolution data set (rrds) passed in. More...

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

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

virtual void	setProperty (ossimRefPtr< ossimProperty > property)
	Set propterty method. More...

virtual ossimRefPtr< ossimProperty >	getProperty (const ossimString &name) const
	Get propterty method. More...

virtual void	getPropertyNames (std::vector< ossimString > &propertyNames) const
	Get propterty names. More...

virtual ossimScalarType	getOutputScalarType () const
	Returns the output pixel type of the tile source. More...

virtual ossim_uint32	getTileWidth () const
	Returns the width of the output tile. More...

virtual ossim_uint32	getTileHeight () const
	Returns the height of the output tile. More...

virtual ossim_uint32	getImageTileWidth () const
	Returns the tile width of the image or 0 if the image is not tiled. More...

virtual ossim_uint32	getImageTileHeight () const
	Returns the tile width of the image or 0 if the image is not tiled. More...

bool	isOpen () const
	Derived classes must implement this method to be concrete. More...

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

virtual bool	open (std::shared_ptr< ossim::istream > &str, const std::string &connectionString)
	This open takes a stream and stores/captures the shared pointer on success. More...

virtual void	close ()
	Close method. More...

bool	checkSignature (std::istream &str)

virtual ossimRefPtr< ossimImageGeometry >	getImageGeometry ()
	Gets the image geometry. More...

Public Member Functions inherited from ossimImageHandler
	ossimImageHandler ()
	Constructor (default): More...

virtual	~ossimImageHandler ()
	Destructor: Derived classes should implement. More...

virtual void	initialize ()
	initialize Does nothing in this class. More...

virtual bool	openOverview ()
	Searches for an overview. More...

virtual bool	openOverview (const ossimFilename &overview_file)
	Calls closeOverview(), then attempts to open the overview_file. More...

virtual void	closeOverview ()
	If theOverview is initialized it will be deleted and set to NULL. More...

virtual const ossimImageHandler *	getOverview () const

virtual bool	hasOverviews () const

virtual ossimFilename	createDefaultOverviewFilename () const

virtual ossimFilename	createDefaultGeometryFilename () const

virtual ossimFilename	createDefaultMetadataFilename () const

virtual ossimFilename	createDefaultHistogramFilename () const

virtual ossimFilename	createDefaultValidVerticesFilename () const

virtual bool	writeValidImageVertices (const std::vector< ossimIpt > &vertices, const ossimFilename &file=ossimFilename(""))
	Outputs vertices to file and updates the internal vertex array variable "theValidImageVertices". More...

virtual bool	openValidVertices (const ossimFilename &vertices_file)
	Opens the valid image vertices file and sets theValidImageVerticesFile variable. More...

virtual bool	openValidVertices ()
	Creates vertices file name based on image, then tries to open. More...

virtual bool	open (const ossimFilename &imageFile, ossim_uint32 entryIndex)
	Opens the image file. More...

virtual bool	open (const ossimFilename &imageFile)

virtual bool	open (std::shared_ptr< ossim::ImageHandlerState > state)

virtual bool	buildHistogram (int numberOfRLevels=0, ossimHistogramMode mode=OSSIM_HISTO_MODE_NORMAL)
	Build a histogram for image file. More...

virtual bool	buildAllHistograms (int numberOfRLevels=0, ossimHistogramMode mode=OSSIM_HISTO_MODE_NORMAL)
	Build a histograms for all image entries. More...

virtual bool	buildOverview (ossimImageHandlerOverviewCompressionType compressionType=OSSIM_OVERVIEW_COMPRESSION_NONE, ossim_uint32 quality=75, ossimFilterResampler::ossimFilterResamplerType resampleType=ossimFilterResampler::ossimFilterResampler_BOX, bool includeFullResFlag=false)
	Will build over file for theImageFile. More...

virtual bool	buildAllOverviews (ossimImageHandlerOverviewCompressionType compressionType=OSSIM_OVERVIEW_COMPRESSION_NONE, ossim_uint32 quality=75, ossimFilterResampler::ossimFilterResamplerType resampleType=ossimFilterResampler::ossimFilterResampler_BOX, bool includeFullResFlag=false)
	Will build over file for all image entries. More...

virtual bool	buildOverview (const ossimFilename &filename, ossimImageHandlerOverviewCompressionType compressionType=OSSIM_OVERVIEW_COMPRESSION_NONE, ossim_uint32 quality=75, ossimFilterResampler::ossimFilterResamplerType resampleType=ossimFilterResampler::ossimFilterResampler_BOX, bool includeFullResFlag=false)
	Will build an over file for filename. More...

ossimRefPtr< ossimMultiResLevelHistogram >	getImageHistogram () const
	Fetches the current entry image's histogram. More...

virtual void	setImageGeometry (ossimImageGeometry *geom)
	Sets the image geometry object. More...

virtual void	saveImageGeometry () const
	Saves the image geometry to a file that will be made based on the image file name. More...

virtual void	saveImageGeometry (const ossimFilename &geometry_file) const
	Saves the image geometry to a file that will be made based on the image file name. More...

virtual ossimIrect	getBoundingRect (ossim_uint32 resLevel=0) const
	Returns zero-based bounding rectangle of the image. More...

virtual void	getDecimationFactor (ossim_uint32 resLevel, ossimDpt &result) const

virtual void	getDecimationFactors (vector< ossimDpt > &decimations) const
	This returns all decimation for all levels. More...

virtual ossim_uint32	getNumberOfDecimationLevels () const
	This returns the total number of decimation levels. More...

virtual ossim_uint32	getNumberOfReducedResSets () const
	This method is obsolete. More...

virtual void	setFilename (const ossimFilename &filename)
	Sets the filename. More...

virtual const ossimFilename &	getFilename () const
	Returns the filename. More...

virtual bool	isValidRLevel (ossim_uint32 resLevel) const
	Determines if the passed in reslution level is valid. More...

bool	canConnectMyInputTo (ossim_int32 inputIndex, const ossimConnectableObject *object) const
	Connection rule. More...

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

virtual bool	isBandSelector () const
	Indicates whether or not the image handler can control output band selection via the setOutputBandList method. More...

virtual bool	setOutputBandList (const std::vector< ossim_uint32 > &band_list)
	If the image handler "isBandSeletor()" then the band selection of the output chip can be controlled. More...

virtual bool	setOutputToInputBandList ()
	If the image handler "isBandSeletor()" then the band selection of the output are set to input or identity. More...

virtual bool	isIdentityBandList (const std::vector< ossim_uint32 > &bandList) const
	Convenience method to see if band list is identity. More...

virtual bool	isImageTiled () const
	Indicates whether or not the image is tiled internally. More...

virtual bool	hasMetaData () const

virtual ossimRefPtr< ossimNBandLutDataObject >	getLut () const

virtual bool	hasLut () const

virtual void	loadMetaData ()
	There is an external file with an omd extension. More...

virtual double	getMinPixelValue (ossim_uint32 band=0) const
	Retuns the min pixel value. More...

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

virtual void	setMinPixelValue (ossim_uint32 band, const ossim_float64 &pix)
	convenience method to set min pixel value. More...

virtual void	setMaxPixelValue (ossim_uint32 band, const ossim_float64 &pix)
	convenience method to set max pixel value. More...

virtual void	setNullPixelValue (ossim_uint32 band, const ossim_float64 &pix)
	convenience method to set null pixel value. More...

virtual ossim_uint32	getCurrentEntry () const

virtual ossim_uint32	getNumberOfEntries () const

virtual void	getEntryName (ossim_uint32 entryIdx, std::string &name) const
	Get the name of entry as a string. More...

virtual void	getEntryList (std::vector< ossim_uint32 > &entryList) const

virtual void	getEntryNames (std::vector< ossimString > &entryNames) const

bool	useEntryIndex () const
	Convenience method to determine if entry index should be used for support files, e.g. More...

ossimFilename	getOverviewFile () const

virtual bool	setCurrentEntry (ossim_uint32 entryIdx)

ossimFilename	getFilenameWithThisExtension (const ossimString &ext, bool set_e0_prefix=false) const
	Returns the image file with extension set using supplentary directory for dirname if set. More...

void	getFilenameWithThisExt (const ossimString &ext, ossimFilename &f) const
	Returns the image file with extension set using supplentary directory for dirname if set. More...

ossim_uint32	getStartingResLevel () const

void	setStartingResLevel (ossim_uint32 level)

bool	getOpenOverviewFlag () const

void	setOpenOverviewFlag (bool flag)
	Sets theOpenOverviewFlag. More...

virtual void	setSupplementaryDirectory (const ossimFilename &dir)
	Sets the supplementary directory. More...

virtual const ossimFilename &	getSupplementaryDirectory () const
	Returns the supplementary directory. More...

const ossimString &	getImageID () const
	Fetches the image ID. More...

void	setImageID (const ossimString &id)
	Sets the image ID in case it is externally generated. More...

ossimPixelType	getPixelType () const
	Returns the raster pixel alignment type. More...

virtual bool	getRgbBandList (std::vector< ossim_uint32 > &bandList) const
	Convenience method to get the zero based rgb output band list. More...

template<class T >
std::shared_ptr< T >	getStateAs ()

template<class T >
std::shared_ptr< const T >	getStateAs () const

std::shared_ptr< ossim::ImageHandlerState >	getState ()

std::shared_ptr< const ossim::ImageHandlerState >	getState () const

void	setState (std::shared_ptr< ossim::ImageHandlerState > state)

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 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 void	getOutputBandList (std::vector< ossim_uint32 > &bandList) const
	Initializes bandList. 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 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)

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 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 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 ossimStreamReaderInterface
	ossimStreamReaderInterface ()
	default constructor More...

virtual	~ossimStreamReaderInterface ()
	virtual destructor. More...

Protected Member Functions
bool	open (std::shared_ptr< ossim::istream > &str)
	This open takes a stream and stores/captures the shared pointer on success. More...

bool	readPngInit ()
	Performs signature check and initializes png_structp and png_infop. More...

bool	initReader ()
	Initializes this reader from libpng m_pngPtr and infoPtr. More...

void	readPngVersionInfo ()

ossimString	getPngColorTypeString () const

void	setMaxPixelValue ()
	the max pixel value. More...

virtual bool	open ()
	open method. More...

void	allocate ()
	Initializes tiles and buffers. More...

void	destroy ()
	Free tile and buffer memory. More...

void	restart ()
	Method to restart reading from the beginning (for backing up). More...

void	fillTile (const ossimIrect &clip_rect, ossimImageData *tile)

template<class T >
void	copyLines (T dummy, ossim_uint32 stopLine)

template<class T >
void	copyLinesWithAlpha (T, ossim_uint32 stopLine)

Protected Member Functions inherited from ossimImageHandler
virtual ossimRefPtr< ossimImageGeometry >	getExternalImageGeometry () const
	Returns the image geometry object associated with this tile source or NULL if non defined. More...

virtual ossimRefPtr< ossimImageGeometry >	getInternalImageGeometry () const

virtual bool	getOverviewTile (ossim_uint32 resLevel, ossimImageData *result)
	Method to get an overview tile. More...

bool	initVertices (const char *file)
	Opens file and attempts to initialize the valid image vertices. More...

virtual void	completeOpen ()
	Will complete the opening process. More...

void	initImageParameters (ossimImageGeometry *geom) const
	Convenience method to set things needed in the image geometry from the image handler. More...

virtual void	establishDecimationFactors ()
	Virtual method determines the decimation factors at each resolution level. More...

virtual bool	setOutputBandList (const std::vector< ossim_uint32 > &inBandList, std::vector< ossim_uint32 > &outBandList)
	Convenience method to set output band list. More...

void	getFilenameWithNoExtension (ossimFilename &f) const
	Get filename with no extension, using supplentary directory for dirname if set. More...

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)

Static Protected Member Functions
static void	pngReadData (png_structp png_ptr, png_bytep data, png_size_t length)
	Callback method for reading from a stream. More...

Protected Attributes
ossimRefPtr< ossimImageData >	m_tile

ossimRefPtr< ossimImageData >	m_cacheTile

ossim_uint8 *	m_lineBuffer

ossim_uint32	m_lineBufferSizeInBytes

std::shared_ptr< ossim::istream >	m_str

ossimIrect	m_bufferRect

ossimIrect	m_imageRect

ossim_uint32	m_numberOfInputBands

ossim_uint32	m_numberOfOutputBands

ossim_uint32	m_bytePerPixelPerBand

ossimIpt	m_cacheSize

ossimAppFixedTileCache::ossimAppFixedCacheId	m_cacheId

png_structp	m_pngReadPtr

png_infop	m_pngReadInfoPtr

ossim_int8	m_pngColorType

ossim_uint32	m_currentRow

ossimScalarType	m_outputScalarType

ossim_int32	m_interlacePasses

ossim_int8	m_bitDepth

ossimPngReadMode	m_readMode

std::vector< ossim_float64 >	m_maxPixelValue

bool	m_swapFlag

bool	m_useAlphaChannelFlag

Protected Attributes inherited from ossimImageHandler
ossimFilename	theImageFile

ossimFilename	theOverviewFile

ossimFilename	theSupplementaryDirectory

ossimRefPtr< ossimImageHandler >	theOverview

vector< ossimIpt >	theValidImageVertices

ossimImageMetaData	theMetaData

ossimRefPtr< ossimImageGeometry >	theGeometry

ossimRefPtr< ossimNBandLutDataObject >	theLut

std::vector< ossimDpt >	theDecimationFactors

ossimString	theImageID

ossim_uint32	theStartingResLevel
	theStartingResLevel If set to something other than zero(default) this is indicative that the reader is an overview. More...

bool	theOpenOverviewFlag
	If true opening of overviews will be attempted. More...

ossimPixelType	thePixelType

std::shared_ptr< ossim::ImageHandlerState >	m_state

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

Detailed Description

Definition at line 26 of file ossimPngReader.h.

Member Enumeration Documentation

◆ ossimPngReadMode

enum ossimPngReader::ossimPngReadMode

Enumerator
ossimPngReadUnknown
ossimPngRead8
ossimPngRead16
ossimPngRead8a
ossimPngRead16a

Definition at line 30 of file ossimPngReader.h.

    {
       ossimPngReadUnknown = 0,
       ossimPngRead8       = 1,
       ossimPngRead16      = 2,
       ossimPngRead8a      = 3,
       ossimPngRead16a     = 4 
    };

Constructor & Destructor Documentation

◆ ossimPngReader()

ossimPngReader::ossimPngReader ( )

default constructor

Definition at line 46 of file ossimPngReader.cpp.

    :
    ossimImageHandler(),
    m_tile(0),
    m_cacheTile(0),
    m_lineBuffer(0),
    m_lineBufferSizeInBytes(0),
    m_str(0),
    m_bufferRect(0, 0, 0, 0),
    m_imageRect(0, 0, 0, 0),
    m_numberOfInputBands(0),
    m_numberOfOutputBands(0),
    m_bytePerPixelPerBand(1),
    m_cacheSize(0),
    m_cacheId(-1),
    m_pngReadPtr(0),
    m_pngReadInfoPtr(0),
    m_pngColorType(PNG_COLOR_TYPE_GRAY),
    m_currentRow(0),
    m_outputScalarType(OSSIM_UINT8),
    m_interlacePasses(1),
    m_bitDepth(8),
    m_readMode(ossimPngReadUnknown),
    m_maxPixelValue(),
    m_swapFlag(false),
    m_useAlphaChannelFlag(false)
 {
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimPngReader::ossimPngReader entered..." << std::endl;
       readPngVersionInfo();
 #ifdef OSSIM_ID_ENABLED
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "OSSIM_ID:  " << OSSIM_ID << endl;
 #endif
    }
 }

◆ ~ossimPngReader()

ossimPngReader::~ossimPngReader ( )

virtual

virtual destructor

Definition at line 85 of file ossimPngReader.cpp.

References close(), and isOpen().

 {
    if (isOpen())
    {
       close();
    }
 }

Member Function Documentation

◆ allocate()

void ossimPngReader::allocate ( )

protected

Initializes tiles and buffers.

Called once on first getTile request.

Definition at line 124 of file ossimPngReader.cpp.

References ossimImageDataFactory::create(), ossim::defaultTileSize(), ossimAppFixedTileCache::deleteCache(), ossimImageData::dup(), ossimImageData::initialize(), ossimImageDataFactory::instance(), ossimAppFixedTileCache::instance(), m_cacheId, m_cacheSize, m_cacheTile, m_imageRect, m_lineBuffer, m_lineBufferSizeInBytes, m_tile, ossimImageData::setImageRectangle(), ossimIrect::ul(), ossimIrect::width(), ossimIpt::x, and ossimIpt::y.

Referenced by getTile().

 {
    // Make the cache tile the height of one tile by the image width.
    ossim::defaultTileSize(m_cacheSize);
    m_cacheSize.x = m_imageRect.width();
    
    ossimAppFixedTileCache::instance()->deleteCache(m_cacheId);
    m_cacheId = ossimAppFixedTileCache::instance()->
       newTileCache(m_imageRect, m_cacheSize);
 
    m_tile = ossimImageDataFactory::instance()->create(this, this);
    m_cacheTile = (ossimImageData*)m_tile->dup();
    m_tile->initialize();
    
    ossimIrect cache_rect(m_imageRect.ul().x,
                          m_imageRect.ul().y,
                          m_imageRect.ul().x + (m_cacheSize.x-1),
                          m_imageRect.ul().y + (m_cacheSize.y-1));
    
    m_cacheTile->setImageRectangle(cache_rect);
    m_cacheTile->initialize();
 
    if(m_lineBuffer)
    {
       delete [] m_lineBuffer;
    }
    m_lineBuffer = new ossim_uint8[m_lineBufferSizeInBytes];
 
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimPngReader::allocate DEBUG:"
          << "\nm_cacheTile:\n" << *(m_cacheTile.get())
          << "\nm_tile:\n"      << *(m_tile.get())
          << "\ncache tile size:           " << m_cacheSize
          << "\nimage width:               " << m_imageRect.width()
          << "\nimage height:              " << m_imageRect.height()
          << "\nnumber of bands:           " << m_numberOfOutputBands
          << "\nline buffer size:          " << m_lineBufferSizeInBytes
          << endl;
    }
 }

◆ checkSignature()

bool ossimPngReader::checkSignature ( std::istream & str )

Returns: true if first 8 bytes matches png signature, false if not.

Definition at line 768 of file ossimPngReader.cpp.

Referenced by open().

 {
    bool result = false;
 
    //---
    // Verify the file is a png by checking the first eight bytes:
    // 0x 89 50 4e 47 0d 0a 1a 0a
    //---
    ossim_uint8 sig[8];
    str.read( (char*)sig, 8);
    if ( str.good() )
    {
       if ( png_sig_cmp(sig, 0, 8) == 0 )
       {
          result = true;
       }
    }
 
    return result;
 }

◆ close()

void ossimPngReader::close ( )

virtual

Close method.

Reimplemented from ossimImageHandler.

Definition at line 93 of file ossimPngReader.cpp.

References ossimImageHandler::close(), and destroy().

Referenced by open(), and ~ossimPngReader().

 {
    destroy();
    ossimImageHandler::close();
 }

◆ copyLines()

template<class T >

void ossimPngReader::copyLines	(	T	dummy,
		ossim_uint32	stopLine
	)

protected

Definition at line 1185 of file ossimPngReader.cpp.

References ossimImageData::getBuf(), m_cacheTile, m_currentRow, m_imageRect, m_lineBuffer, m_numberOfInputBands, m_numberOfOutputBands, m_pngReadPtr, m_swapFlag, ossimEndian::swap(), and ossimIrect::width().

 {
    const ossim_uint32 SAMPLES = m_imageRect.width();
 
    T* src = (T*)m_lineBuffer;
    std::vector<T*> dst(m_numberOfOutputBands);
 
    ossim_uint32 band = 0;
    for (band = 0; band < m_numberOfOutputBands; ++band)
    {
       dst[band] = (T*) m_cacheTile->getBuf(band);
    }
    
    ossim_int32 bufIdx = 0;
    
    while (m_currentRow <= stopLine)
    {
       // Read a line from the jpeg file.
       png_read_row(m_pngReadPtr, m_lineBuffer, NULL);
       ++m_currentRow;
 
       if(m_swapFlag)
       {
          ossimEndian endian;
          endian.swap(src, SAMPLES*m_numberOfInputBands);
       }
 
       //---
       // Copy the line which is band interleaved by pixel the the band
       // separate buffers.
       //---
       ossim_uint32 index = 0;
       for (ossim_uint32 sample = 0; sample < SAMPLES; ++sample)
       {
          for (band = 0; band < m_numberOfOutputBands; ++band)
          {
             dst[band][bufIdx] = src[index];
             ++index;
          }
          ++bufIdx;
       }
    }
 }

◆ copyLinesWithAlpha()

template<class T >

void ossimPngReader::copyLinesWithAlpha	(	T	,
		ossim_uint32	stopLine
	)

protected

Definition at line 1230 of file ossimPngReader.cpp.

References ossimImageData::getBuf(), ossimImageData::getMaxPix(), ossimImageData::getMinPix(), ossimImageData::getNullPix(), m_cacheTile, m_currentRow, m_imageRect, m_lineBuffer, m_maxPixelValue, m_numberOfInputBands, m_numberOfOutputBands, m_outputScalarType, m_pngReadPtr, m_swapFlag, OSSIM_UINT8, ossimEndian::swap(), and ossimIrect::width().

 {
    ossim_float64 denominator;
    if (m_outputScalarType == OSSIM_UINT8)
    {
       denominator = m_maxPixelValue[m_numberOfInputBands-1];
    }
    else
    {
       denominator = m_maxPixelValue[m_numberOfInputBands-1];
    }
 
    const ossim_uint32 SAMPLES = m_imageRect.width();
    
    T* src = (T*) m_lineBuffer;
 
    std::vector<T*> dst(m_numberOfOutputBands);
    std::vector<T> p(m_numberOfOutputBands);
    
    ossim_float64 alpha;
 
    const ossim_float64 MIN_PIX  = m_cacheTile->getMinPix(0);
    const ossim_float64 MAX_PIX  = m_cacheTile->getMaxPix(0);
    const ossim_float64 NULL_PIX = m_cacheTile->getNullPix(0);
  
    ossim_uint32 band = 0;
    for (band = 0; band < m_numberOfOutputBands; ++band)
    {
       dst[band] = (T*)m_cacheTile->getBuf(band);
    }
 
    ossim_int32 dstIdx = 0;
    
    while (m_currentRow <= stopLine)
    {
       // Read a line from the jpeg file.
       png_read_row(m_pngReadPtr, m_lineBuffer, NULL);
       ++m_currentRow;
 
       if(m_swapFlag)
       {
          ossimEndian endian;
          endian.swap(src, SAMPLES*m_numberOfInputBands);
       }
       
       //---
       // Copy the line which is band interleaved by pixel the the band
       // separate buffers.
       //---
       ossim_uint32 srcIdx = 0;
       for (ossim_uint32 sample = 0; sample < SAMPLES; ++sample)
       {
          // Copy the pixels.
          for (band = 0; band < m_numberOfOutputBands; ++band)
          {
             p[band] = src[srcIdx++];
          }
          
          // Get the alpha channel.
          alpha = src[srcIdx++];
          alpha = alpha / denominator;
          
          if (alpha == 1.0)
          {
             for (band = 0; band < m_numberOfOutputBands; ++band)
             {
                dst[band][dstIdx] = p[band];
             }
          }
          else if (alpha == 0.0)
          {
             for (band = 0; band < m_numberOfOutputBands; ++band)
             {
                dst[band][dstIdx] = static_cast<T>(NULL_PIX);
             }
          }
          else
          {
             for (band = 0; band < m_numberOfOutputBands; ++band)
             {
                ossim_float64 f = p[band];
                f = f * alpha;
                if (f != NULL_PIX)
                {
                   dst[band][dstIdx] =
                      static_cast<T>( (f>=MIN_PIX) ?
                                      ( (f<=MAX_PIX) ? f : MAX_PIX ) :
                                      MIN_PIX );
                }
                else
                {
                   dst[band][dstIdx] = static_cast<T>(NULL_PIX);
                }
             }
          }
          ++dstIdx; // next sample...
             
       } // End of sample loop.
       
    } // End of line loop.
 }

◆ destroy()

void ossimPngReader::destroy ( )

protected

Free tile and buffer memory.

Deletes stream if own it flag is set.

Definition at line 99 of file ossimPngReader.cpp.

References ossimAppFixedTileCache::deleteCache(), ossimAppFixedTileCache::instance(), m_cacheId, m_cacheTile, m_lineBuffer, m_pngReadInfoPtr, m_pngReadPtr, m_str, and m_tile.

Referenced by close(), and open().

 {
    ossimAppFixedTileCache::instance()->deleteCache(m_cacheId);
 
    // ossimRefPtrs so assign to 0(unreferencing) will handle memory.
    m_tile      = 0;
    m_cacheTile = 0;
 
    if (m_lineBuffer)
    {
       delete [] m_lineBuffer;
       m_lineBuffer = 0;
    }
 
    if (m_pngReadPtr)
    {
       png_destroy_read_struct(&m_pngReadPtr, &m_pngReadInfoPtr, NULL);
       m_pngReadPtr = 0;
       m_pngReadInfoPtr = 0;
    }
 
    // Stream data member m_str is share pointer now:
    m_str = 0;
 }

◆ fillTile()

void ossimPngReader::fillTile	(	const ossimIrect &	clip_rect,
		ossimImageData *	tile
	)

protected

Note: this method assumes that setImageRectangle has been called on theTile.

Definition at line 257 of file ossimPngReader.cpp.

References getImageRectangle(), ossimIrect::height(), m_cacheSize, m_str, ossimIrect::set_lrx(), ossimIrect::set_ulx(), ossimIrect::stretchToTileBoundary(), x, and ossimIpt::y.

Referenced by getTile().

 {
    if (!tile || !m_str) return;
 
    ossimIrect buffer_rect = clip_rect;
    buffer_rect.stretchToTileBoundary(m_cacheSize);
    buffer_rect.set_ulx(0);
    buffer_rect.set_lrx(getImageRectangle(0).lr().x);
 
    ossim_int32 number_of_cache_tiles = buffer_rect.height()/m_cacheSize.y;
 
 #if 0
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "tiles high:  " << number_of_cache_tiles
          << endl;
    }
 #endif
 
    ossimIpt origin = buffer_rect.ul();
    
    for (int tileIdx = 0; tileIdx < number_of_cache_tiles; ++tileIdx)
    {
       // See if it's in the cache already.
       ossimRefPtr<ossimImageData> tempTile;
       tempTile = ossimAppFixedTileCache::instance()->
          getTile(m_cacheId, origin);
       if (tempTile.valid())
       {
          tile->loadTile(tempTile.get());
       }
       else
       {
          // Have to read from the png file.
          ossim_uint32 startLine = static_cast<ossim_uint32>(origin.y);
          ossim_uint32 stopLine  = 
             static_cast<ossim_uint32>( min(origin.y+m_cacheSize.y-1,
                                            getImageRectangle().lr().y) );
          ossimIrect cache_rect(origin.x,
                                origin.y,
                                origin.x+m_cacheSize.x-1,
                                origin.y+m_cacheSize.y-1);
          
          m_cacheTile->setImageRectangle(cache_rect);
 
          if ( !m_cacheTile->getImageRectangle().
               completely_within(getImageRectangle()) )
          {
             m_cacheTile->makeBlank();
          }
 
          if (startLine < m_currentRow)
          {
             // Must restart the compression process again.
             restart();
          }
 
          // Gobble any not needed lines.
          while(m_currentRow < startLine)
          {
             png_read_row(m_pngReadPtr, m_lineBuffer, NULL);
             ++m_currentRow;
          }
             
          switch (m_readMode)
          {
             case ossimPngRead8:
             {
                copyLines(ossim_uint8(0), stopLine);
                break;
             }
             case ossimPngRead16:
             {
                copyLines(ossim_uint16(0), stopLine);
                break;
             }
             case ossimPngRead8a:
             {
                if (m_useAlphaChannelFlag)
                {
                   copyLines(ossim_uint8(0), stopLine);
                }
                else
                {
                   // Will burn alpha value into the other bands.
                   copyLinesWithAlpha(ossim_uint8(0), stopLine);
                }
                break;
             }
             case ossimPngRead16a:
             {
                if (m_useAlphaChannelFlag)
                {
                   copyLines(ossim_uint16(0), stopLine); 
                }
                else
                {
                   // Will burn alpha value into the other bands.
                   copyLinesWithAlpha(ossim_uint16(0), stopLine);
                }
                break;
             }
             case ossimPngReadUnknown:
             default:
             {
                break; // should never happen.
             }
          }
 
          m_cacheTile->validate();
          
          tile->loadTile(m_cacheTile.get());
          
          // Add it to the cache for the next time.
          ossimAppFixedTileCache::instance()->addTile(m_cacheId,
                                                      m_cacheTile);
          
       } // End of reading for png file.
       
       origin.y += m_cacheSize.y;
       
    } // for (int tile = 0; tile < number_of_cache_tiles; ++tile)
    
    tile->validate();
 }

◆ getClassName()

ossimString ossimPngReader::getClassName ( ) const

virtual

Returns: "ossimPngReader"

Reimplemented from ossimObject.

Definition at line 616 of file ossimPngReader.cpp.

 {
    return ossimString("ossimPngReader");
 }

◆ getImageGeometry()

ossimRefPtr< ossimImageGeometry > ossimPngReader::getImageGeometry ( )

virtual

Gets the image geometry.

This method overrides ossimImageHandler::getImageGeometry to NOT call ossimImageGeometryRegistry::instance()->extendGeometry().

Returns: the image geometry object associated with this tile source. In many case the underlying ossimImageGeometry projection may be NULL with this reader so callers should check.

Reimplemented from ossimImageHandler.

Definition at line 789 of file ossimPngReader.cpp.

References ossimRefPtr< T >::get(), ossimImageHandler::getExternalImageGeometry(), ossimImageHandler::initImageParameters(), and ossimImageHandler::theGeometry.

 {
    if ( !theGeometry )
    {
       //---
       // Check factory for external geom:
       //---
       theGeometry = getExternalImageGeometry();
 
       if ( !theGeometry )
       {
          // Fist time through:
          theGeometry = new ossimImageGeometry();
 
          //---
          // This code does not call ossimImageGeometryRegistry::extendGeometry
          // by design to avoid wasted factory calls.
          //---
       }
 
       // Set image things the geometry object should know about.
       initImageParameters( theGeometry.get() );
    }
    return theGeometry;
 }

◆ getImageRectangle()

ossimIrect ossimPngReader::getImageRectangle ( ossim_uint32 reduced_res_level = 0 ) const

virtual

Returns the zero based image rectangle for the reduced resolution data set (rrds) passed in.

Note that rrds 0 is the highest resolution rrds.

Reimplemented from ossimImageHandler.

Definition at line 386 of file ossimPngReader.cpp.

References getNumberOfLines(), and getNumberOfSamples().

Referenced by fillTile(), and getTile().

 {
    return ossimIrect(0,
                      0,
                      getNumberOfSamples(reduced_res_level) - 1,
                      getNumberOfLines(reduced_res_level)   - 1);
 }

◆ getImageTileHeight()

ossim_uint32 ossimPngReader::getImageTileHeight ( ) const

virtual

Returns the tile width of the image or 0 if the image is not tiled.

Note: this is not the same as the ossimImageSource::getTileWidth which returns the output tile width which can be different than the internal image tile width on disk.

Implements ossimImageHandler.

Definition at line 601 of file ossimPngReader.cpp.

 {
    return 0;
 }

◆ getImageTileWidth()

ossim_uint32 ossimPngReader::getImageTileWidth ( ) const

virtual

Returns the tile width of the image or 0 if the image is not tiled.

Note: this is not the same as the ossimImageSource::getTileWidth which returns the output tile width which can be different than the internal image tile width on disk.

Implements ossimImageHandler.

Definition at line 596 of file ossimPngReader.cpp.

 {
    return 0;
 }

◆ getLongName()

ossimString ossimPngReader::getLongName ( ) const

virtual

Returns: "ossim png"

Reimplemented from ossimObject.

Definition at line 611 of file ossimPngReader.cpp.

 {
    return ossimString("ossim png reader");
 }

◆ getMaxPixelValue()

double ossimPngReader::getMaxPixelValue ( ossim_uint32 band = 0 ) const

virtual

Returns the max pixel of the band.

Reimplemented from ossimImageHandler.

Definition at line 648 of file ossimPngReader.cpp.

References m_maxPixelValue, and m_numberOfOutputBands.

 {
    //---
    // Note the size of m_maxPixelValue can be one greater than output bands
    // if there is an alpa channel.
    //---
    if (band < m_numberOfOutputBands)
    {
       return m_maxPixelValue[band];
    }
    return 255.0;
 }

◆ getNumberOfInputBands()

ossim_uint32 ossimPngReader::getNumberOfInputBands ( ) const

virtual

Returns the number of bands in the image.

Satisfies pure virtual from ImageHandler class.

Implements ossimImageSource.

Definition at line 621 of file ossimPngReader.cpp.

References m_numberOfOutputBands.

 {
    //---
    // NOTE:  If there is an alpha channel the input band will be one more than
    // the output bands.  For library purposes the output bands and input bands
    // are the same.
    //---
    return m_numberOfOutputBands;
 }

◆ getNumberOfLines()

ossim_uint32 ossimPngReader::getNumberOfLines ( ossim_uint32 reduced_res_level = 0 ) const

virtual

Returns the number of lines in the image.

Satisfies pure virtual from ImageHandler class.

Implements ossimImageHandler.

Definition at line 568 of file ossimPngReader.cpp.

References ossimImageHandler::getNumberOfLines(), ossimIrect::height(), m_imageRect, ossimImageHandler::theOverview, and ossimRefPtr< T >::valid().

Referenced by getImageRectangle().

 {
    if (reduced_res_level == 0)
    {
       return m_imageRect.height();
    }
    else if ( theOverview.valid() )
    {
       return theOverview->getNumberOfLines(reduced_res_level);
    }
 
    return 0;
 }

◆ getNumberOfOutputBands()

ossim_uint32 ossimPngReader::getNumberOfOutputBands ( ) const

virtual

Returns the number of bands in a tile returned from this TileSource.

Note: we are supporting sources that can have multiple data objects. If you want to know the scalar type of an object you can pass in the

Reimplemented from ossimImageSource.

Definition at line 631 of file ossimPngReader.cpp.

References m_numberOfOutputBands.

Referenced by getTile().

 {
    return m_numberOfOutputBands;
 }

◆ getNumberOfSamples()

ossim_uint32 ossimPngReader::getNumberOfSamples ( ossim_uint32 reduced_res_level = 0 ) const

virtual

Returns the number of samples in the image.

Satisfies pure virtual from ImageHandler class.

Implements ossimImageHandler.

Definition at line 582 of file ossimPngReader.cpp.

References ossimImageHandler::getNumberOfSamples(), m_imageRect, ossimImageHandler::theOverview, ossimRefPtr< T >::valid(), and ossimIrect::width().

Referenced by getImageRectangle().

 {
    if (reduced_res_level == 0)
    {
       return m_imageRect.width();
    }
    else if ( theOverview.valid() )
    {
       return theOverview->getNumberOfSamples(reduced_res_level);
    }
 
    return 0;
 }

◆ getOutputScalarType()

ossimScalarType ossimPngReader::getOutputScalarType ( ) const

virtual

Returns the output pixel type of the tile source.

Reimplemented from ossimImageSource.

Definition at line 636 of file ossimPngReader.cpp.

References m_outputScalarType.

 {
    return m_outputScalarType;
 }

◆ getPngColorTypeString()

ossimString ossimPngReader::getPngColorTypeString ( ) const

protected

Definition at line 1087 of file ossimPngReader.cpp.

References m_pngColorType.

 {
    ossimString result = "unknown";
    if (m_pngColorType == PNG_COLOR_TYPE_GRAY)
    {
       return ossimString("PNG_COLOR_TYPE_GRAY");
    }
    else if (m_pngColorType == PNG_COLOR_TYPE_PALETTE)
    {
       return ossimString("PNG_COLOR_TYPE_PALETTE");
    }
    else if (m_pngColorType == PNG_COLOR_TYPE_RGB)
    {
       return ossimString("PNG_COLOR_TYPE_RGB");
    }
    else if (m_pngColorType == PNG_COLOR_TYPE_RGB_ALPHA)
    {
       return ossimString("PNG_COLOR_TYPE_RGB_ALPHA");
    }
    else if (m_pngColorType == PNG_COLOR_TYPE_GRAY_ALPHA)
    {
       return ossimString("PNG_COLOR_TYPE_GRAY_ALPHA");
    }
 
    return ossimString("unknown");
 }

◆ getProperty()

ossimRefPtr< ossimProperty > ossimPngReader::getProperty ( const ossimString & name ) const

virtual

Get propterty method.

Overrides ossimImageHandler::getProperty.

Parameters

name	Property name to get.

Reimplemented from ossimImageHandler.

Definition at line 441 of file ossimPngReader.cpp.

References ossimString::string().

 {
    ossimRefPtr<ossimProperty> prop = 0;
    if ( name.string() == USE_ALPHA_KW )
    {
       prop = new ossimBooleanProperty(name, m_useAlphaChannelFlag);
    }
    else
    {
       prop = ossimImageHandler::getProperty(name);
    }
    return prop;
 }

◆ getPropertyNames()

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

virtual

Get propterty names.

Overrides ossimImageHandler::getPropertyNames.

Parameters

propertyNames Array to initialize.

Reimplemented from ossimImageHandler.

Definition at line 455 of file ossimPngReader.cpp.

 {
    propertyNames.push_back( ossimString(USE_ALPHA_KW) );
    ossimImageHandler::getPropertyNames(propertyNames);
 }

◆ getShortName()

ossimString ossimPngReader::getShortName ( ) const

virtual

Returns: "png"

Reimplemented from ossimObject.

Definition at line 606 of file ossimPngReader.cpp.

 {
    return ossimString("ossim_png_reader");
 }

◆ getTile() [1/2]

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

virtual

Returns a pointer to a tile given an origin representing the upper left corner of the tile to grab from the image.

Satisfies pure virtual from TileSource class.

Reimplemented from ossimImageSource.

Definition at line 167 of file ossimPngReader.cpp.

References allocate(), ossimRefPtr< T >::get(), ossimDataObject::getDataObjectStatus(), m_tile, ossimImageData::makeBlank(), OSSIM_NULL, ossimImageData::setImageRectangle(), and ossimRefPtr< T >::valid().

 {
    if ( !m_tile )
    {
       // First time through. Allocate memory...
       allocate();
    }
    
    if (m_tile.valid())
    {
       // Image rectangle must be set prior to calling getTile.
       m_tile->setImageRectangle(rect);
       
       if ( getTile( m_tile.get(), resLevel ) == false )
       {
          if (m_tile->getDataObjectStatus() != OSSIM_NULL)
          {
             m_tile->makeBlank();
          }
       }
    }
    
    return m_tile;
 }

◆ getTile() [2/2]

bool ossimPngReader::getTile	(	ossimImageData *	result,
		ossim_uint32	resLevel = `0`
	)

virtual

Method to get a tile.

Parameters

result The tile to stuff. Note The requested rectangle in full image space and bands should be set in the result tile prior to passing. It will be an error if: result.getNumberOfBands() != this->getNumberOfOutputBands()

Returns: true on success false on error. If return is false, result is undefined so caller should handle appropriately with makeBlank or whatever.

Reimplemented from ossimImageSource.

Definition at line 193 of file ossimPngReader.cpp.

References ossimIrect::clipToRect(), ossimIrect::completely_within(), fillTile(), getImageRectangle(), ossimImageData::getImageRectangle(), ossimImageData::getNumberOfBands(), getNumberOfOutputBands(), ossimImageHandler::getOverviewTile(), isOpen(), ossimSource::isSourceEnabled(), ossimImageHandler::isValidRLevel(), m_outputScalarType, m_tile, ossimImageData::makeBlank(), OSSIM_UINT16, ossimReferenced::ref(), ossimRectilinearDataObject::setScalarType(), status, and ossimReferenced::unref().

 {
    bool status = false;
    
    //---
    // Not open, this tile source bypassed, or invalid res level,
    // return a blank tile.
    //---
    if( isOpen() && isSourceEnabled() && isValidRLevel(resLevel) &&
        result && (result->getNumberOfBands() == getNumberOfOutputBands()) )
    {
       result->ref(); // Increment ref count.
       
       //---
       // Check for overview tile.  Some overviews can contain r0 so always
       // call even if resLevel is 0.  Method returns true on success, false
       // on error.
       //---
       status = getOverviewTile(resLevel, result);
 
       if (status)
       {
          if(m_outputScalarType == OSSIM_UINT16)
          {
             //---
             // Temp fix:
             // The overview handler could return a tile of OSSIM_USHORT11 if
             // the max sample value was not set to 2047.
             //
             // To prevent a scalar mismatch set 
             //---
             result->setScalarType(m_outputScalarType);
          }
       }
       
       if (!status) // Did not get an overview tile.
       {
          status = true;
          
          ossimIrect tile_rect = result->getImageRectangle();
 
          if ( ! tile_rect.completely_within(getImageRectangle(0)) )
          {
             // We won't fill totally so make blank first.
             m_tile->makeBlank();
          }
          
          if (getImageRectangle(0).intersects(tile_rect))
          {
             // Make a clip rect.
             ossimIrect clip_rect = tile_rect.clipToRect(getImageRectangle(0));
             
             // This will validate the tile at the end.
             fillTile(clip_rect, result);
          }
       }
 
       result->unref();  // Decrement ref count.
    }
 
    return status;
 }

◆ getTileHeight()

ossim_uint32 ossimPngReader::getTileHeight ( ) const

virtual

Returns the height of the output tile.

Reimplemented from ossimImageSource.

Definition at line 563 of file ossimPngReader.cpp.

References ossimImageData::getHeight(), m_tile, and ossimRefPtr< T >::valid().

 {
    return ( m_tile.valid() ? m_tile->getHeight() : 0 );
 }

◆ getTileWidth()

ossim_uint32 ossimPngReader::getTileWidth ( ) const

virtual

Returns the width of the output tile.

Reimplemented from ossimImageSource.

Definition at line 558 of file ossimPngReader.cpp.

References ossimImageData::getWidth(), m_tile, and ossimRefPtr< T >::valid().

 {
    return ( m_tile.valid() ? m_tile->getWidth() : 0 );
 }

◆ initReader()

bool ossimPngReader::initReader ( )

protected

Initializes this reader from libpng m_pngPtr and infoPtr.

Returns: true on success, false on error.

Definition at line 858 of file ossimPngReader.cpp.

References ossim::byteOrder(), m_bitDepth, m_bytePerPixelPerBand, m_currentRow, m_imageRect, m_interlacePasses, m_lineBufferSizeInBytes, m_maxPixelValue, m_numberOfInputBands, m_numberOfOutputBands, m_outputScalarType, m_pngColorType, m_pngReadInfoPtr, m_pngReadPtr, m_readMode, m_swapFlag, m_useAlphaChannelFlag, OSSIM_LITTLE_ENDIAN, OSSIM_UINT16, OSSIM_UINT8, OSSIM_USHORT11, ossimPngRead16, ossimPngRead16a, ossimPngRead8, ossimPngRead8a, and setMaxPixelValue().

Referenced by open().

 {
    bool result = true;
    
    ossim_uint32 height    = png_get_image_height(m_pngReadPtr, m_pngReadInfoPtr);
    ossim_uint32 width     = png_get_image_width(m_pngReadPtr, m_pngReadInfoPtr);
    m_bitDepth            = png_get_bit_depth(m_pngReadPtr, m_pngReadInfoPtr);
    m_pngColorType        = png_get_color_type(m_pngReadPtr, m_pngReadInfoPtr);
    
    m_imageRect = ossimIrect(0, 0, width  - 1, height - 1);
    
    if (m_bitDepth == 16)
    {
       // png_set_strip_16 (m_pngReadPtr);
       m_bytePerPixelPerBand = 2;
       m_outputScalarType = OSSIM_UINT16;
    }
    else
    {
       m_bytePerPixelPerBand = 1;
    }
 
    // Set the read mode from scalar and color type.
    if (m_outputScalarType == OSSIM_UINT8)
    {
       if ( (m_pngColorType == PNG_COLOR_TYPE_RGB_ALPHA) ||
            (m_pngColorType == PNG_COLOR_TYPE_GRAY_ALPHA) )
       {
          m_readMode = ossimPngRead8a;
       }
       else
       {
          m_readMode = ossimPngRead8;
       }
    }
    else
    {
       if ( (m_pngColorType == PNG_COLOR_TYPE_RGB_ALPHA) ||
            (m_pngColorType == PNG_COLOR_TYPE_GRAY_ALPHA) )
       {
          m_readMode = ossimPngRead16a;
       }
       else
       {
          m_readMode = ossimPngRead16;
       }
 
       // Set the swap flag.  PNG stores data in network byte order(big endian).
       if(ossim::byteOrder() == OSSIM_LITTLE_ENDIAN)
       {
          m_swapFlag = true;
       }
    }
    
    //---
    // If png_set_expand used:
    // Expand data to 24-bit RGB, or 8-bit grayscale,
    // with alpha if available.
    //---
    bool expandFlag = false;
 
    if ( m_pngColorType == PNG_COLOR_TYPE_PALETTE )
    {
       expandFlag = true;
    }
    if ( (m_pngColorType == PNG_COLOR_TYPE_GRAY) && (m_bitDepth < 8) )
    {
       expandFlag = true;
    }
    if ( png_get_valid(m_pngReadPtr, m_pngReadInfoPtr, PNG_INFO_tRNS) )
    {
       expandFlag = true;
    }
 
    //---
    // If png_set_packing used:
    // Use 1 byte per pixel in 1, 2, or 4-bit depth files. */
    //---
    bool packingFlag = false;
 
    if ( (m_bitDepth < 8) && (m_pngColorType == PNG_COLOR_TYPE_GRAY) )
    {
       packingFlag = true;
    }
 
    if (expandFlag)
    {
        png_set_expand(m_pngReadPtr);
    }
    if (packingFlag)
    {
       png_set_packing(m_pngReadPtr);
    }
 
    // Gamma correction.
    // ossim_float64 gamma;
    // if (png_get_gAMA(m_pngReadPtr, m_pngReadInfoPtr, &gamma))
    // {
    //    png_set_gamma(png_ptr, display_exponent, gamma);
    // }
 
    //---
    // Turn on interlace handling... libpng returns just 1 (ie single pass)
    //  if the image is not interlaced
    //---
    m_interlacePasses = png_set_interlace_handling (m_pngReadPtr);
 
    //---
    // Update the info structures after the transformations take effect
    //---
    png_read_update_info (m_pngReadPtr, m_pngReadInfoPtr);
 
    // TODO:
    // Add check for image offsets.
    // Add check for resolution.
    // Add check for colormap.
 
    switch (m_pngColorType)
    {
       case PNG_COLOR_TYPE_RGB:           /* RGB */
       {
          m_numberOfInputBands  = 3;
          m_numberOfOutputBands = 3;
          break;
       }  
       case PNG_COLOR_TYPE_RGB_ALPHA:     /* RGBA */
       {
          m_numberOfInputBands  = 4;
          if (m_useAlphaChannelFlag)
          {
             m_numberOfOutputBands = 4;     
          }
          else
          {
             m_numberOfOutputBands = 3;    
          }         
          break;
       }
       case PNG_COLOR_TYPE_GRAY:          /* Grayscale */
       {
          m_numberOfInputBands = 1;
          m_numberOfOutputBands = 1;
          break;
       }  
       case PNG_COLOR_TYPE_GRAY_ALPHA:    /* Grayscale + alpha */
       {
          m_numberOfInputBands = 2;
          if (m_useAlphaChannelFlag)
          {
             m_numberOfOutputBands = 2;     
          }
          else
          {
             m_numberOfOutputBands = 1;
          }
         break;
       }
      case PNG_COLOR_TYPE_PALETTE:       /* Indexed */
      {
         m_numberOfInputBands  = 3;
         m_numberOfOutputBands = 3;
         break;
      }  
      default:                   /* Unknown type */
      {
         result = false;
      }
    }
 
    if ( result )
    {
       m_lineBufferSizeInBytes = png_get_rowbytes(m_pngReadPtr, m_pngReadInfoPtr);
       
       // Set the max pixel value.
       setMaxPixelValue();
       
       // Set to OSSIM_USHORT11 for use of specialized tile.
       if (m_maxPixelValue[0] == 2047.0)
       {
          m_outputScalarType = OSSIM_USHORT11;
       }
 
       // We're on row 0 or first line.
       m_currentRow = 0;
       
       if (traceDebug())
       {
          ossimNotify(ossimNotifyLevel_DEBUG)
             << "ossimPngReader::initReader DEBUG:"
             << "\nm_imageRect:                     " << m_imageRect
             << "\nm_bitDepth:                      " << int(m_bitDepth)
             << "\nm_pngColorType:                  "
             <<  getPngColorTypeString().c_str()
             << "\nm_numberOfInputBands:            " << m_numberOfInputBands
             << "\nm_numberOfOutputBands:           " << m_numberOfOutputBands
             << "\nm_bytePerPixelPerBand:           " << m_bytePerPixelPerBand
             << "\nm_lineBufferSizeInBytes:         " << m_lineBufferSizeInBytes
             << "\nm_interlacePasses:               " << m_interlacePasses
             << "\npalette expansion:                "
             << (expandFlag?"on":"off")
             << "\npacking (1,2,4 bit to one byte):  "
             << (packingFlag?"on":"off")
             << "\nm_readMode:                      " << m_readMode
             << "\nm_swapFlag:                      " << m_swapFlag
             << std::endl;
          
          for (ossim_uint32 band = 0; band < m_numberOfInputBands; ++band)
          {
             ossimNotify(ossimNotifyLevel_DEBUG)
                << "max[" << band << "]:  " << m_maxPixelValue[band]
                << std::endl;
          }
       }
    }
 
    return result;
    
 } // End: ossimPngReader::initReader()

◆ isOpen()

bool ossimPngReader::isOpen ( ) const

virtual

Derived classes must implement this method to be concrete.

Returns: true if open, false if not.

Implements ossimImageHandler.

Definition at line 641 of file ossimPngReader.cpp.

References m_str.

Referenced by getTile(), open(), and ~ossimPngReader().

 {
    if ( m_str ) return m_str->good();
 
    return false;
 }

◆ loadState()

bool ossimPngReader::loadState	(	const ossimKeywordlist &	kwl,
		const char *	prefix = `0`
	)

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

Definition at line 403 of file ossimPngReader.cpp.

References ossimKeywordlist::findKey(), and ossimImageHandler::loadState().

 {
    bool result = false;
    if (ossimImageHandler::loadState(kwl, prefix))
    {
       // this was causing core dumps.  Mainly because if prefix is null then
       // standard string core dumps.  So wrapped with OSSIM string that checks
       // for this and inits with empty string if null
       //
       ossimString value = kwl.findKey( ossimString(prefix).c_str(), USE_ALPHA_KW );
       if ( value.size() )
       {
          ossimString s = value;
          m_useAlphaChannelFlag = s.toBool();
       }
       result = open();
   }
    return result;
 }

◆ open() [1/3]

bool ossimPngReader::open	(	std::shared_ptr< ossim::istream > &	str,
		const std::string &	connectionString
	)

virtual

This open takes a stream and stores/captures the shared pointer on success.

Satisfies pure virtual from ossimStreamReaderInterface.

Parameters

str	Open stream to image.
connectionString	Stored on success as the file name.

Returns: true on success, false on error.

Implements ossimStreamReaderInterface.

Definition at line 501 of file ossimPngReader.cpp.

References open(), and ossimImageHandler::theImageFile.

Referenced by ossimPngReaderFactory::open().

 {
    bool result = open( str );
    if ( result )
    {
       theImageFile = connectionString;
    }
    return result;
 }

◆ open() [2/3]

bool ossimPngReader::open ( std::shared_ptr< ossim::istream > & str )

protected

This open takes a stream and stores/captures the shared pointer on success.

Parameters

str	Open stream to image.

Returns: true on success, false on error.

Definition at line 512 of file ossimPngReader.cpp.

References checkSignature(), close(), ossimImageHandler::completeOpen(), destroy(), initReader(), isOpen(), m_str, and readPngInit().

 {
    bool result = false;
 
    if (isOpen())
    {
       close();
    }
    
    if ( str )
    {
       str->seekg( 0, std::ios_base::beg );
       
       if ( checkSignature( *str ) )
       {
          // Store the pointer:
          m_str = str;
          
          result = readPngInit();
          if ( result )
          {
             result = initReader();
             if ( result )
             {
                completeOpen();
             }
          }
          else
          {
             destroy();
          }
       }
       else
       {
          if (traceDebug())
          {
             ossimNotify(ossimNotifyLevel_DEBUG)
                << "ossimPngReader::open NOTICE:\n"
                << "Could not open stream!\n";
          }
       }
    }
    
    return result;
 }

◆ open() [3/3]

bool ossimPngReader::open ( )

protectedvirtual

open method.

This open assumes base class ossimImageHandler::theImageFile has been set.

Returns: true on success, false on error.

Implements ossimImageHandler.

Definition at line 461 of file ossimPngReader.cpp.

Referenced by open().

 {
    static const char MODULE[] = "ossimPngReader::open()";
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << MODULE << " entered...\n" << "File:  " << theImageFile.c_str()
          << "\n";
    }
 
    bool result = false;
 
    // Start with a clean slate.
    if (isOpen())
    {
       close();
    }
 
    // Check for empty filename.
    if ( theImageFile.size() )
    {
       // Open up a stream to the file.
       std::shared_ptr<ossim::istream> str = ossim::StreamFactoryRegistry::instance()->
          createIstream( theImageFile.string(), ios::in | ios::binary);
       if ( str )
       {
          // Pass to our open that takes a stream:
          result = open( str );
       }
    }
 
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimPngReader::open() exit status: " << (result?"true":"false") << "\n";
    }
    
    return result;
 }

◆ pngReadData()

void ossimPngReader::pngReadData	(	png_structp	png_ptr,
		png_bytep	data,
		png_size_t	length
	)

staticprotected

Callback method for reading from a stream.

This allows us to choose the stream; hence, writing to a file or memory. This will be passed to libpng's png_set_read_fn.

Definition at line 1334 of file ossimPngReader.cpp.

Referenced by readPngInit(), and restart().

 {
    ossim::istream* str = (ossim::istream*)png_get_io_ptr(png_ptr);
    if ( str )
    {
       str->read( (char*)data, length );
    }
 }

◆ readPngInit()

bool ossimPngReader::readPngInit ( )

protected

Performs signature check and initializes png_structp and png_infop.

Returns: true on success, false on error.

Definition at line 815 of file ossimPngReader.cpp.

References m_pngReadInfoPtr, m_pngReadPtr, m_str, and pngReadData().

Referenced by open().

 {
    bool result = false;
    if ( m_str )
    {
       if ( m_str->good() )
       {
          m_pngReadPtr = png_create_read_struct(PNG_LIBPNG_VER_STRING,
                                                NULL,
                                                NULL,
                                                NULL);
          if ( m_pngReadPtr )
          {
             m_pngReadInfoPtr = png_create_info_struct(m_pngReadPtr);
             if ( m_pngReadInfoPtr )
             {
                if ( setjmp( png_jmpbuf(m_pngReadPtr) ) == 0 )
                {
                   //---
                   // Pass the static read method to libpng to allow us to use our
                   // c++ stream instead of doing "png_init_io (pp, ...);" with
                   // c stream.
                   //---
                   png_set_read_fn( m_pngReadPtr,
                                    (png_voidp)m_str.get(),
                                    (png_rw_ptr)&ossimPngReader::pngReadData );
                   png_set_sig_bytes(m_pngReadPtr, 8);
                   png_read_info(m_pngReadPtr, m_pngReadInfoPtr);
                   result = true;
                }
             }
             else
             {
                // Out of memory?
                png_destroy_read_struct(&m_pngReadPtr, NULL, NULL);
             }
          }
       }
    }
    return result;
    
 } // End: ossimPngReader::readPngInit()

◆ readPngVersionInfo()

void ossimPngReader::readPngVersionInfo ( )

protected

Definition at line 1077 of file ossimPngReader.cpp.

References ossimNotify(), and ossimNotifyLevel_WARN.

 {
    ossimNotify(ossimNotifyLevel_WARN)
       << "ossimPngReader::readPngVersionInfo\nCompiled with:"
       << "\nlibpng " << PNG_LIBPNG_VER_STRING
       << " using libpng " << PNG_LIBPNG_VER
       << "\nzlib " << ZLIB_VERSION " using zlib "
       << zlib_version << std::endl;
 }

◆ restart()

void ossimPngReader::restart ( )

protected

Method to restart reading from the beginning (for backing up).

This is needed as libpng requires sequential read from start of the image.

Definition at line 661 of file ossimPngReader.cpp.

References m_bitDepth, m_currentRow, m_pngColorType, m_pngReadInfoPtr, m_pngReadPtr, m_str, ossimNotify(), ossimNotifyLevel_WARN, pngReadData(), and ossimImageHandler::theImageFile.

 {
    if ( m_str )
    {
       // Destroy the existing memory associated with png structs.
       if (m_pngReadPtr && m_pngReadInfoPtr)
       {
          png_destroy_read_struct(&m_pngReadPtr, &m_pngReadInfoPtr, NULL);
       }
 
       m_pngReadPtr = png_create_read_struct(PNG_LIBPNG_VER_STRING,
                                             NULL,
                                             NULL,
                                             NULL);
       m_pngReadInfoPtr = png_create_info_struct(m_pngReadPtr);
 
       if ( setjmp( png_jmpbuf(m_pngReadPtr) ) )
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "Error while reading.  File corrupted?  "
             << theImageFile
             << std::endl;
       
          return;
       }
 
       // Reset the file pointer.
       m_str->seekg( 0, std::ios_base::beg );
    
       //---
       // Pass the static read method to libpng to allow us to use our
       // c++ stream instead of doing "png_init_io (pp, ...);" with
       // c stream.
       //---
       png_set_read_fn( m_pngReadPtr,
                        (png_voidp)m_str.get(),
                        (png_rw_ptr)&ossimPngReader::pngReadData );
 
       //---
       // Note we won't do png_set_sig_bytes(png_ptr, 8) here because we are not
       // rechecking for png signature.
       //---
       png_read_info(m_pngReadPtr, m_pngReadInfoPtr);
 
       //---
       // If png_set_expand used:
       // Expand data to 24-bit RGB, or 8-bit grayscale,
       // with alpha if available.
       //---
       bool expandFlag = false;
 
       if ( m_pngColorType == PNG_COLOR_TYPE_PALETTE )
       {
          expandFlag = true;
       }
       if ( (m_pngColorType == PNG_COLOR_TYPE_GRAY) && (m_bitDepth < 8) )
       {
          expandFlag = true;
       }
       if ( png_get_valid(m_pngReadPtr, m_pngReadInfoPtr, PNG_INFO_tRNS) )
       {
          expandFlag = true;
       }
 
       //---
       // If png_set_packing used:
       // Use 1 byte per pixel in 1, 2, or 4-bit depth files. */
       //---
       bool packingFlag = false;
 
       if ( (m_bitDepth < 8) && (m_pngColorType == PNG_COLOR_TYPE_GRAY) )
       {
          packingFlag = true;
       }
 
       if (expandFlag)
       {
          png_set_expand(m_pngReadPtr);
       }
       if (packingFlag)
       {
          png_set_packing(m_pngReadPtr);
       }
 
       // Gamma correction.
       //    ossim_float64 gamma;
       //    if (png_get_gAMA(m_pngReadPtr, m_pngReadInfoPtr, &gamma))
       //    {
       //       png_set_gamma(m_pngReadPtr, display_exponent, gamma);
       //    }
 
       //---
       // Turn on interlace handling... libpng returns just 1 (ie single pass)
       //  if the image is not interlaced
       //---
       png_set_interlace_handling (m_pngReadPtr);
 
       //---
       // Update the info structures after the transformations take effect
       //---
       png_read_update_info (m_pngReadPtr, m_pngReadInfoPtr);
    
       // We're back on row 0 or first line.
       m_currentRow = 0;
    }
 }

◆ saveState()

bool ossimPngReader::saveState	(	ossimKeywordlist &	kwl,
		const char *	prefix = `0`
	)		const

virtual

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

Return true if ok or false on error.

Reimplemented from ossimImageHandler.

Definition at line 394 of file ossimPngReader.cpp.

References ossimKeywordlist::addPair(), m_useAlphaChannelFlag, ossimString::string(), and ossimString::toString().

 {
    std::string p = ( prefix ? prefix : "" );
    std::string v = ossimString::toString(m_useAlphaChannelFlag).string();
    kwl.addPair( p, USE_ALPHA_KW, v, true );
    return ossimImageHandler::saveState(kwl, prefix);
 }

◆ setMaxPixelValue()

void ossimPngReader::setMaxPixelValue ( )

protected

the max pixel value.

Attempts to get the sBIT chunk.

Definition at line 1114 of file ossimPngReader.cpp.

References m_maxPixelValue, m_numberOfInputBands, m_pngReadInfoPtr, and m_pngReadPtr.

Referenced by initReader().

 {
    ossim_uint32 band;
    m_maxPixelValue.resize(m_numberOfInputBands);
    for (band = 0; band < m_numberOfInputBands; ++band)
    {
       m_maxPixelValue[band] = 0.0;
    }
    
    if (png_get_valid(m_pngReadPtr, m_pngReadInfoPtr, PNG_INFO_sBIT ))
    {
       png_color_8p sig_bit;
       png_get_sBIT(m_pngReadPtr, m_pngReadInfoPtr, &sig_bit);
       if (traceDebug())
       {
          ossimNotify(ossimNotifyLevel_DEBUG)
             << "ossimPngReader::setMaxPixelValue DEBUG:"
             << "\nsig_bit->red:   " << int(sig_bit->red)
             << "\nsig_bit->green: " << int(sig_bit->green)
             << "\nsig_bit->blue:  " << int(sig_bit->blue)
             << "\nsig_bit->gray:  " << int(sig_bit->gray)            
             << "\nsig_bit->alpa:  " << int(sig_bit->alpha)
             << endl;
       }
       switch (m_pngColorType)
       {
          case PNG_COLOR_TYPE_RGB:           /* RGB */
             m_maxPixelValue[0] = pow(2.0, double(sig_bit->red))-1.0;
             m_maxPixelValue[1] = pow(2.0, double(sig_bit->green))-1.0;
             m_maxPixelValue[2] = pow(2.0, double(sig_bit->blue))-1.0;
             break;
          case PNG_COLOR_TYPE_RGB_ALPHA:     /* RGBA */
             m_maxPixelValue[0] = pow(2.0, double(sig_bit->red))-1.0;
             m_maxPixelValue[1] = pow(2.0, double(sig_bit->green))-1.0;
             m_maxPixelValue[2] = pow(2.0, double(sig_bit->blue))-1.0;
             m_maxPixelValue[3] = pow(2.0, double(sig_bit->alpha))-1.0;
             break;
          case PNG_COLOR_TYPE_GRAY:          /* Grayscale */
             m_maxPixelValue[0] = pow(2.0, double(sig_bit->gray))-1.0;
             break;
          case PNG_COLOR_TYPE_GRAY_ALPHA:    /* Grayscale + alpha */            
             m_maxPixelValue[0] = pow(2.0, double(sig_bit->gray))-1.0;
             m_maxPixelValue[1] = pow(2.0, double(sig_bit->alpha))-1.0;
             break;
          case PNG_COLOR_TYPE_PALETTE:       /* Indexed */
             m_maxPixelValue[0] = 255.0;
             m_maxPixelValue[1] = 255.0;
             m_maxPixelValue[2] = 255.0;
             break;
          default:                   /* Aie! Unknown type */
             break;
       }
    }
 
    // Sanity check.
    for (ossim_uint32 band = 0; band < m_numberOfInputBands; ++band)
    {
       if (m_maxPixelValue[band] == 0.0)
       {
          if (m_bitDepth <= 8)
          {
             m_maxPixelValue[band] = 255.0;
          }
          else
          {
             m_maxPixelValue[band] = 65535.0;
          }
       }
    }
 }

◆ setProperty()

void ossimPngReader::setProperty ( ossimRefPtr< ossimProperty > property )

virtual

Set propterty method.

Overrides ossimImageHandler::setProperty.

Current property name handled: "scale" One double value representing the scale in meters per pixel. It is assumed the scale is same for x and y direction.

Parameters

property to set.

Reimplemented from ossimImageHandler.

Definition at line 424 of file ossimPngReader.cpp.

References ossimProperty::getName(), ossimString::string(), and ossimRefPtr< T >::valid().

 {
    if ( property.valid() )
    {
       if ( property->getName().string() == USE_ALPHA_KW )
       {
          ossimString s;
          property->valueToString(s);
          m_useAlphaChannelFlag = s.toBool();
       }
       else
       {
          ossimImageHandler::setProperty(property);
       }
    }
 }

Member Data Documentation

◆ m_bitDepth

ossim_int8 ossimPngReader::m_bitDepth

protected

Definition at line 311 of file ossimPngReader.h.

Referenced by initReader(), and restart().

◆ m_bufferRect

ossimIrect ossimPngReader::m_bufferRect

protected

Definition at line 295 of file ossimPngReader.h.

◆ m_bytePerPixelPerBand

ossim_uint32 ossimPngReader::m_bytePerPixelPerBand

protected

Definition at line 299 of file ossimPngReader.h.

Referenced by initReader().

◆ m_cacheId

ossimAppFixedTileCache::ossimAppFixedCacheId ossimPngReader::m_cacheId

protected

Definition at line 303 of file ossimPngReader.h.

Referenced by allocate(), and destroy().

◆ m_cacheSize

ossimIpt ossimPngReader::m_cacheSize

protected

Definition at line 300 of file ossimPngReader.h.

Referenced by allocate(), and fillTile().

◆ m_cacheTile

ossimRefPtr<ossimImageData> ossimPngReader::m_cacheTile

protected

Definition at line 288 of file ossimPngReader.h.

Referenced by allocate(), copyLines(), copyLinesWithAlpha(), and destroy().

◆ m_currentRow

ossim_uint32 ossimPngReader::m_currentRow

protected

Definition at line 308 of file ossimPngReader.h.

Referenced by copyLines(), copyLinesWithAlpha(), initReader(), and restart().

◆ m_imageRect

ossimIrect ossimPngReader::m_imageRect

protected

Definition at line 296 of file ossimPngReader.h.

Referenced by allocate(), copyLines(), copyLinesWithAlpha(), getNumberOfLines(), getNumberOfSamples(), and initReader().

◆ m_interlacePasses

ossim_int32 ossimPngReader::m_interlacePasses

protected

Definition at line 310 of file ossimPngReader.h.

Referenced by initReader().

◆ m_lineBuffer

ossim_uint8* ossimPngReader::m_lineBuffer

protected

Definition at line 290 of file ossimPngReader.h.

Referenced by allocate(), copyLines(), copyLinesWithAlpha(), and destroy().

◆ m_lineBufferSizeInBytes

ossim_uint32 ossimPngReader::m_lineBufferSizeInBytes

protected

Definition at line 291 of file ossimPngReader.h.

Referenced by allocate(), and initReader().

◆ m_maxPixelValue

std::vector<ossim_float64> ossimPngReader::m_maxPixelValue

protected

Definition at line 314 of file ossimPngReader.h.

Referenced by copyLinesWithAlpha(), getMaxPixelValue(), initReader(), and setMaxPixelValue().

◆ m_numberOfInputBands

ossim_uint32 ossimPngReader::m_numberOfInputBands

protected

Definition at line 297 of file ossimPngReader.h.

Referenced by copyLines(), copyLinesWithAlpha(), initReader(), and setMaxPixelValue().

◆ m_numberOfOutputBands

ossim_uint32 ossimPngReader::m_numberOfOutputBands

protected

Definition at line 298 of file ossimPngReader.h.

Referenced by copyLines(), copyLinesWithAlpha(), getMaxPixelValue(), getNumberOfInputBands(), getNumberOfOutputBands(), and initReader().

◆ m_outputScalarType

ossimScalarType ossimPngReader::m_outputScalarType

protected

Definition at line 309 of file ossimPngReader.h.

Referenced by copyLinesWithAlpha(), getOutputScalarType(), getTile(), and initReader().

◆ m_pngColorType

ossim_int8 ossimPngReader::m_pngColorType

protected

Definition at line 307 of file ossimPngReader.h.

Referenced by getPngColorTypeString(), initReader(), and restart().

◆ m_pngReadInfoPtr

png_infop ossimPngReader::m_pngReadInfoPtr

protected

Definition at line 306 of file ossimPngReader.h.

Referenced by destroy(), initReader(), readPngInit(), restart(), and setMaxPixelValue().

◆ m_pngReadPtr

png_structp ossimPngReader::m_pngReadPtr

protected

Definition at line 305 of file ossimPngReader.h.

Referenced by copyLines(), copyLinesWithAlpha(), destroy(), initReader(), readPngInit(), restart(), and setMaxPixelValue().

◆ m_readMode

ossimPngReadMode ossimPngReader::m_readMode

protected

Definition at line 312 of file ossimPngReader.h.

Referenced by initReader().

◆ m_str

std::shared_ptr<ossim::istream> ossimPngReader::m_str

protected

Definition at line 293 of file ossimPngReader.h.

Referenced by destroy(), fillTile(), isOpen(), open(), readPngInit(), and restart().

◆ m_swapFlag

bool ossimPngReader::m_swapFlag

protected

Definition at line 316 of file ossimPngReader.h.

Referenced by copyLines(), copyLinesWithAlpha(), and initReader().

◆ m_tile

ossimRefPtr<ossimImageData> ossimPngReader::m_tile

protected

Definition at line 287 of file ossimPngReader.h.

Referenced by allocate(), destroy(), getTile(), getTileHeight(), and getTileWidth().

◆ m_useAlphaChannelFlag

bool ossimPngReader::m_useAlphaChannelFlag

protected

Definition at line 319 of file ossimPngReader.h.

Referenced by initReader(), and saveState().

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

Public Types

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ ossimPngReadMode

Constructor & Destructor Documentation

◆ ossimPngReader()

◆ ~ossimPngReader()

Member Function Documentation

◆ allocate()

◆ checkSignature()

◆ close()

◆ copyLines()

◆ copyLinesWithAlpha()

◆ destroy()

◆ fillTile()

◆ getClassName()

◆ getImageGeometry()

◆ getImageRectangle()

◆ getImageTileHeight()

◆ getImageTileWidth()

◆ getLongName()

◆ getMaxPixelValue()

◆ getNumberOfInputBands()

◆ getNumberOfLines()

◆ getNumberOfOutputBands()

◆ getNumberOfSamples()

◆ getOutputScalarType()

◆ getPngColorTypeString()

◆ getProperty()

◆ getPropertyNames()

◆ getShortName()

◆ getTile() [1/2]

◆ getTile() [2/2]

◆ getTileHeight()

◆ getTileWidth()

◆ initReader()

◆ isOpen()

◆ loadState()

◆ open() [1/3]

◆ open() [2/3]

◆ open() [3/3]

◆ pngReadData()

◆ readPngInit()

◆ readPngVersionInfo()

◆ restart()

◆ saveState()

◆ setMaxPixelValue()

◆ setProperty()

Member Data Documentation

◆ m_bitDepth

◆ m_bufferRect

◆ m_bytePerPixelPerBand

◆ m_cacheId

◆ m_cacheSize

◆ m_cacheTile

◆ m_currentRow

◆ m_imageRect

◆ m_interlacePasses

◆ m_lineBuffer

◆ m_lineBufferSizeInBytes

◆ m_maxPixelValue

◆ m_numberOfInputBands

◆ m_numberOfOutputBands

◆ m_outputScalarType

◆ m_pngColorType

◆ m_pngReadInfoPtr

◆ m_pngReadPtr

◆ m_readMode

◆ m_str

◆ m_swapFlag

◆ m_tile

◆ m_useAlphaChannelFlag