Class adding casacore::Table-specific support functions to PassiveCachingDD. More...

#include <PassiveTableDD.h>

Inheritance diagram for casa::PassiveTableDD:

Public Member Functions
	PassiveTableDD (casacore::Table *table)
	Constructor taking a pointer to an already constructed Table. More...

	PassiveTableDD (const casacore::String tablename)
	Constructor taking a casacore::String which describes the full pathname of a casacore::Table on disk. More...

virtual	~PassiveTableDD ()
	Destructor. More...

virtual void	setDefaultOptions ()
	Install the default options for this DisplayData. More...

virtual casacore::Bool	setOptions (casacore::Record &rec, casacore::Record &recOut)
	Apply options stored in `rec` to the DisplayData. More...

virtual casacore::Record	getOptions (bool scrub=false) const
	Retrieve the current and default options and parameter types. More...

virtual AttributeBuffer	optionsAsAttributes ()
	Return the current options of this DisplayData as an AttributeBuffer. More...

Public Member Functions inherited from casa::PassiveCachingDD
	PassiveCachingDD ()
	Constructor. More...

virtual	~PassiveCachingDD ()
	Destructor. More...

virtual casacore::Bool	linToWorld (casacore::Vector< casacore::Double > &world, const casacore::Vector< casacore::Double > &lin)
	casacore::Coordinate transformation handlers, called by WorldCanvasHolder. More...

virtual casacore::Bool	worldToLin (casacore::Vector< casacore::Double > &lin, const casacore::Vector< casacore::Double > &world)

virtual casacore::String	showPosition (const casacore::Vector< casacore::Double > &world, const casacore::Bool &displayAxesOnly=false)
	casacore::Format a string containing coordinate or value information at the given world coordinate. More...

virtual casacore::String	showValue (const casacore::Vector< casacore::Double > &world)
	casacore::Format a string containing value information at the given world coordinate More...

virtual casacore::Vector < casacore::String >	worldAxisNames () const
	World axis information suppliers. More...

virtual casacore::Vector < casacore::String >	worldAxisUnits () const

const casacore::Unit	dataUnit () const

const casacore::IPosition	dataShape () const

casacore::uInt	dataDim () const

std::vector< int >	displayAxes () const

virtual casacore::uInt	nelements (const WorldCanvasHolder &wcHolder) const
	Return the number of display elements (ie. More...

virtual casacore::uInt	nelements () const
	and non-specific More...

virtual void	refreshEH (const WCRefreshEvent &ev)
	Negotiatiate WorldCanvas linear coordinate system when asked to do so by the WorldCanvasHolder. More...

virtual casacore::Bool	sizeControl (WorldCanvasHolder &, AttributeBuffer &)
	Set (coordinate) state of WCH's WC. More...

virtual void	cleanup ()
	Tidy up the elements of this DisplayData. More...

Public Member Functions inherited from casa::CachingDisplayData
	CachingDisplayData ()
	Constructor. More...

virtual	~CachingDisplayData ()
	Destructor. More...

virtual void	notifyRegister (WorldCanvasHolder *wcHolder)

virtual void	notifyUnregister (WorldCanvasHolder &wcHolder, casacore::Bool ignoreRefresh=false)
	`ignoreRefresh` tells the DD not to refresh just to clean up DMs More...

virtual void	setColormap (Colormap *cmap, casacore::Float weight)
	Purges cache, to avoid reusing images with the wrong colormap, then calls base class version. More...

virtual void	purgeCache ()
	Empty cache completely. More...

virtual void	purgeCache (const WorldCanvasHolder &wch)
	Empty cache of all DMs for a given WCH. More...

Public Member Functions inherited from casa::DisplayData
	DisplayData ()
	(Required) default constructor. More...

virtual	~DisplayData ()
	required destructor More...

virtual std::string	errorMessage () const =0

virtual void	setDisplayState (DisplayState s)

virtual DisplayState	getDisplayState () const

virtual bool	isDisplayable () const

virtual void	addRestrictions (AttributeBuffer &otherBuf)
	Add general restrictions or a restriction for item `itemNum` of this DisplayData. More...

virtual void	addRestriction (Attribute &newRestriction, casacore::Bool permanent)

virtual void	addElementRestrictions (const casacore::uInt itemNum, AttributeBuffer &other)

virtual void	addElementRestriction (const casacore::uInt itemNum, Attribute &newRestriction, casacore::Bool permanent)

virtual void	setRestrictions (AttributeBuffer &otherBuf)
	Set general restrictions or a restriction for item `itemNum` of this DisplayData. More...

virtual void	setRestriction (Attribute &newRestriction)

virtual void	setElementRestrictions (const casacore::uInt itemNum, AttributeBuffer &other)

virtual void	setElementRestriction (const casacore::uInt itemNum, Attribute &newRestriction)

virtual void	removeRestriction (const casacore::String &name)
	Remove a general restriction or a restriction from item `itemNum` More...

virtual void	removeElementRestriction (const casacore::uInt itemNum, const casacore::String &name)

virtual void	clearRestrictions ()
	Clear all general restrictions or all restrictions of item `itemNum` (except the ones that are permanent of course...) More...

virtual void	clearElementRestrictions (const casacore::uInt itemNum)

virtual casacore::Bool	existRestriction (const casacore::String &name)
	Check if a general restriction or a restriction for item `itemNum` with name `name` exists. More...

virtual casacore::Bool	existElementRestriction (const casacore::uInt itemNum, const casacore::String &name)

virtual AttributeBuffer *	restrictionBuffer ()
	Get a handle to the buffer of general restrictions or of the buffer of restrictions for item `itemNum` More...

virtual AttributeBuffer *	elementRestrictionBuffer (const casacore::uInt itemNum)

virtual casacore::Bool	conformsTo (const WorldCanvas *wCanvas)
	Check whether the DD is is compatible with all WC[H] state, including its coordinate state, restrictions, and zIndex (if any). More...

virtual casacore::Bool	conformsTo (const WorldCanvas &wc)

virtual casacore::Bool	conformsToRstrs (const WorldCanvas &wc)
	Determine whether DD restrictions are in conformance with restrictions on the given WCH. More...

virtual casacore::Bool	conformsToCS (const WorldCanvas &)
	Determine whether DD is compatible with the WC[H]'s current world coordinates. More...

virtual casacore::Bool	conformsToZIndex (const WorldCanvas &wc)
	Determine whether DD is compatible with the current canvas animation (zIndex) position. More...

virtual casacore::Int	activeZIndex (const WorldCanvas *wc=0)
	Retrieve 'Active' zIndex. More...

virtual casacore::Bool	getFirstZIndex (int &firstZIndex, casacore::Int axZrng=-1) const
	Set firstZIndex to minimum zIndex setting from all canvases where this DD is registered. More...

virtual void	addPositionEventHandler (WCPositionEH *positionHandler)
	Add event handlers on the DisplayData. More...

virtual void	addMotionEventHandler (WCMotionEH *motionHandler)

virtual void	addRefreshEventHandler (WCRefreshEH *refreshHandler)

virtual void	addDisplayEventHandler (DisplayEH *displayHandler)

virtual void	removePositionEventHandler (WCPositionEH &positionHandler)
	Remove eventhandlers. More...

virtual void	removeMotionEventHandler (WCMotionEH &motionHandler)

virtual void	removeRefreshEventHandler (WCRefreshEH &refreshHandler)

virtual void	removeDisplayEventHandler (DisplayEH &displayHandler)

virtual void	removeColormap ()

virtual Colormap *	colormap () const

void	setAttribute (Attribute &at)
	set an Attribute or Attributes More...

void	setAttributes (AttributeBuffer &at)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::uInt &newValue)
	User interface to get value from the attribute buffer. More...

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Int &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Float &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Double &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Bool &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::String &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Vector< casacore::uInt > &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Vector< casacore::Int > &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Vector< casacore::Float > &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Vector< casacore::Double > &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Vector< casacore::Bool > &newValue)

casacore::Bool	getAttributeValue (const casacore::String &name, casacore::Vector< casacore::String > &newValue)

casacore::Bool	existsAttribute (casacore::String &name)
	Check if a certain Attribute exists. More...

void	removeAttribute (casacore::String &name)
	Remove an Attribute. More...

AttValue::ValueType	attributeType (casacore::String &name)
	Get the type of the Attribute. More...

void	setAttributeOnPrimaryWCHs (Attribute &at)
	Set an attribute on any WorldCanvas for which this DD is CS master. More...

virtual void	removeFromAllWCHs ()
	remove this DD everywhere–will stop any more refresh handling by the DD. More...

virtual void	refresh (casacore::Bool clean=false)
	an explicit refresh: should be called if the DisplayData is changed such that drawing is required. More...

virtual casacore::Bool	labelAxes (const WCRefreshEvent &ev)
	an explicit request to draw the axes and/or labels. More...

virtual casacore::Bool	canLabelAxes () const

virtual casacore::String	className () const
	Return the class name of this DisplayData; useful mostly for debugging purposes, and perhaps future use in the glish widget interface. More...

virtual casacore::String	description () const

virtual Display::DisplayDataType	classType ()=0
	Return the DisplayData type; used by the WorldCanvasHolder to determine the order of drawing. More...

virtual casacore::String	dataType () const =0

virtual ImageAnalysis *	imageanalysis () const
	Get image analyis about images... More...

virtual std::shared_ptr < casacore::ImageInterface < casacore::Float > >	imageinterface ()
	Returns a pointer that should not be deleted... More...

virtual void	setSubstituteTitleText (const casacore::String)

const WorldCanvasHolder *	findHolder (const WorldCanvas *wCanvas) const
	Identify the WorldCanvasHolder for the given WorldCanvas. More...

WorldCanvasHolder *	findHolder (const WorldCanvas *wCanvas)

virtual casacore::Block < casacore::Int >	allZIndices (casacore::Int axZrng=-1) const
	Return a sorted casacore::Block of all animation frame numbers currently set onto all WCHs where this DD is registered. More...

virtual casacore::Bool	zIndexHint (casacore::Int &) const
	Will be called just before registering the [GTk]DD on a [GTk]PanelDisplay which has none registered on it yet. More...

virtual void	handleEvent (DisplayEvent &ev)
	Overide DisplayEH::handleEvent. More...

virtual casacore::Bool	isCSmaster (const WorldCanvasHolder *wch=0) const
	Is this DD the CS master of the passed WCH? Defaulting wch to 0 asks whether this DD is CS master of some WCH on which it is registered. More...

virtual casacore::Int	uiBase () const
	DD 'Absolute Pixel Coordinates', e.g. More...

virtual void	setUIBase (casacore::Int uibase)

virtual casacore::Bool	getDelTmpData ()
	Get and set method for the flag. More...

virtual void	setDelTmpData (casacore::Bool delTmpData)

virtual void	setDisplayDataRed (DisplayData *)

virtual void	setDisplayDataBlue (DisplayData *)

virtual void	setDisplayDataGreen (DisplayData *)

Public Member Functions inherited from casa::DisplayOptions
	DisplayOptions ()
	Constructor. More...

virtual	~DisplayOptions ()
	Destructor. More...

template<class T >
casacore::Bool	readOptionRecord (casacore::Vector< T > &target, casacore::Bool &error, const casacore::Record &rec, const casacore::String &fieldname) const
	Find the field `fieldname` in casacore::Record `rec`, containing the requested type (casacore::Bool, casacore::String, casacore::Float, casacore::Int) in itself or its "value" sub-field, and return the value in `target`. More...

template<class T >
casacore::Bool	readOptionRecord (T &target, casacore::Bool &error, const casacore::Record &rec, const casacore::String &fieldname) const

virtual casacore::Bool	readOptionRecord (casacore::String &target, casacore::Bool &unsetTarget, casacore::Bool &error, const casacore::Record &rec, const casacore::String &fieldname) const
	Find the field `fieldname` in casacore::Record `rec`, containing the requested type (casacore::String) in itself or its "value" sub-field, and return the value in `target`. More...

casacore::Record	unset () const
	Return a casacore::Record which is an "unset" casacore::Record, ie. More...

casacore::Bool	isUnset (const casacore::Record &rec) const
	Return true or false indicating if the provided casacore::Record is equal to an "unset" Record. More...

Public Member Functions inherited from casa::DisplayEH
virtual	~DisplayEH ()

Public Member Functions inherited from casa::DlTarget
	DlTarget ()

	DlTarget (const DlTarget &)

virtual	~DlTarget ()

void	reg (DlHandleBase *p)

void	unreg (DlHandleBase *p)

Protected Member Functions
template<class T >
casacore::Bool	getTableKeyword (T &value, const casacore::String keyword) const
	Get the value of the named keyword, or the first keyword matching `regex`, and return it in `value`. More...

template<class T >
casacore::Bool	getTableKeyword (T &value, const casacore::Regex &regex) const

template<class T >
casacore::Bool	getColumnKeyword (T &value, const casacore::String column, const casacore::String keyword) const
	Get the value of the named keyword, or the first keyword matching `regex` for the named column, and return it in `value`. More...

template<class T >
casacore::Bool	getColumnKeyword (T &value, const casacore::String column, const casacore::Regex &regex) const

casacore::Vector < casacore::String >	getColumnNamesOfType (const casacore::DataType type)
	Get the names of the columns of the table having the given type. More...

casacore::Table *	table ()
	Return the casacore::Table pointer for use by derived classes. More...

	PassiveTableDD ()
	(Required) default constructor. More...

	PassiveTableDD (const PassiveTableDD &other)
	(Required) copy constructor. More...

void	operator= (const PassiveTableDD &other)
	(Required) copy assignment. More...

Protected Member Functions inherited from casa::PassiveCachingDD
	PassiveCachingDD (const PassiveCachingDD &other)
	(Required) copy constructor. More...

void	operator= (const PassiveCachingDD &other)
	(Required) copy assignment. More...

Protected Member Functions inherited from casa::CachingDisplayData
virtual CachingDisplayMethod *	newDisplayMethod (WorldCanvas worldCanvas, AttributeBuffer wchAttributes, AttributeBuffer ddAttributes, CachingDisplayData dd)=0
	Create a new (Caching)DisplayMethod for drawing on the given WorldCanvas when the AttributeBuffers are suitably matched to the current state of this DisplayData and of the WorldCanvas/Holder. More...

virtual void	setCaching (const casacore::Bool caching)
	Return any additional Attributes to consider when searching the cache. More...

	CachingDisplayData (const CachingDisplayData &other)
	(Required) copy constructor. More...

void	operator= (const CachingDisplayData &other)
	(Required) copy assignment. More...

Protected Member Functions inherited from casa::DisplayData
virtual casacore::Bool	setActiveZIndex_ (casacore::Int zindex)
	DDs may override to adjust the internal stored current animation index (activeZIndex_) if necessary, and to set return value false iff the passed zindex won't work for the DD. More...

casacore::Bool	conformed ()
	Returns result of last call to conformsTo(WCH&). More...

casacore::Bool	isCsAndZIndexConformed ()
	Added so that when two images are loaded with no velocity alignment, they can still show their position coordinates without having to be rstrsConformed. More...

virtual void	delTmpData (casacore::String &tmpData)
	Delete temporary data. More...

virtual const std::list < WCPositionEH * > *	positionEventHandlerList ()
	Retrieve position, motion, refresh and display event handler lists. More...

virtual const std::list < WCMotionEH * > *	motionEventHandlerList ()

virtual const std::list < WCRefreshEH * > *	refreshEventHandlerList ()

virtual const std::list < DisplayEH * > *	displayEventHandlerList ()

virtual void	positionEH (const WCPositionEvent &ev)
	Position, motion and refresh event handlers that will generally be called by a WorldCanvasHolder. More...

virtual void	motionEH (const WCMotionEvent &ev)

	DisplayData (const DisplayData &other)
	(Required) copy constructor. More...

void	operator= (const DisplayData &other)
	(Required) copy assignment. More...

Protected Member Functions inherited from casa::DisplayOptions
	DisplayOptions (const DisplayOptions &other)
	(Required) copy constructor. More...

void	operator= (const DisplayOptions &other)
	(Required) copy assignment. More...

Private Member Functions
void	installDefaultOptions ()
	Install the default options for this DisplayData. More...

casacore::Bool	arrangeQueryTable ()
	Arrange the query table (generally called after installing new options). More...

Private Attributes
casacore::Table *	itsTable
	Store the primary table here. More...

casacore::Table *	itsQueryTable
	Store the result of a query on the table here. More...

casacore::String	itsOptQueryString
	Option: what is the query string, or is it unset? More...

casacore::Bool	itsOptQueryStringUnset

Additional Inherited Members
Public Types inherited from casa::DisplayData
enum	DisplayState { DISPLAYED, UNDISPLAYED, LIMBO }

Static Public Attributes inherited from casa::DisplayData
static const casacore::String	DATA_MIN

static const casacore::String	DATA_MAX

Protected Attributes inherited from casa::CachingDisplayData
casacore::Bool	restorePCColormap_
	The default is false. More...

Protected Attributes inherited from casa::DisplayData
AttributeBuffer	restrictions
	The Book says that we should not put data members in class that is supposed to only define an interface, but by putting these here, we can implement some of the restriction & eventhandling stuff so that people do not have to repeat it. More...

AttributeBuffer	attributes
	buffer for storing Attributes More...

casacore::PtrBlock< void * >	DDelement
	list of DisplayDataElements, which are of type DisplayMethod or derived More...

casacore::Int	activeZIndex_
	Indicates the 'current' animation frame, i.e. More...

casacore::Bool	delTmpData_
	Flag indicating that temporary data should be removed when deleting the object. More...

casacore::Bool	rstrsConformed_
	Somewhat limited-use state, saved here for 'efficiency'. More...

casacore::Bool	csConformed_

casacore::Bool	zIndexConformed_

Detailed Description

Class adding casacore::Table-specific support functions to PassiveCachingDD.

Synopsis

This class adds support functions useful for dealing with Tables to the PassiveCachingDD class.

Definition at line 55 of file PassiveTableDD.h.

Constructor & Destructor Documentation

casa::PassiveTableDD::PassiveTableDD ( casacore::Table * table )

Constructor taking a pointer to an already constructed Table.

The casacore::Table will be deleted by this class.

casa::PassiveTableDD::PassiveTableDD ( const casacore::String tablename )

Constructor taking a casacore::String which describes the full pathname of a casacore::Table on disk.

virtual casa::PassiveTableDD::~PassiveTableDD ( )

virtual

Destructor.

casa::PassiveTableDD::PassiveTableDD ( )

protected

(Required) default constructor.

casa::PassiveTableDD::PassiveTableDD ( const PassiveTableDD & other )

protected

(Required) copy constructor.

Member Function Documentation

casacore::Bool casa::PassiveTableDD::arrangeQueryTable ( )

private

Arrange the query table (generally called after installing new options).

template<class T >

casacore::Bool casa::PassiveTableDD::getColumnKeyword	(	T &	value,
		const casacore::String	column,
		const casacore::String	keyword
	)		const

protected

Get the value of the named keyword, or the first keyword matching regex for the named column, and return it in value.

The return value is true for success, and false for failure, which is the result if the wrong type T is requested, or if the keyword doesn't exist.

template<class T >

casacore::Bool casa::PassiveTableDD::getColumnKeyword	(	T &	value,
		const casacore::String	column,
		const casacore::Regex &	regex
	)		const

protected

casacore::Vector<casacore::String> casa::PassiveTableDD::getColumnNamesOfType ( const casacore::DataType type )

protected

Get the names of the columns of the table having the given type.

virtual casacore::Record casa::PassiveTableDD::getOptions ( bool scrub = false ) const

virtual

Retrieve the current and default options and parameter types.

Reimplemented from casa::PassiveCachingDD.

Reimplemented in casa::SkyCatOverlayDD.

template<class T >

casacore::Bool casa::PassiveTableDD::getTableKeyword	(	T &	value,
		const casacore::String	keyword
	)		const

protected

Get the value of the named keyword, or the first keyword matching regex, and return it in value.

The return value is true for success, and false for failure, which is the result if the wrong type T is requested.

template<class T >

casacore::Bool casa::PassiveTableDD::getTableKeyword	(	T &	value,
		const casacore::Regex &	regex
	)		const

protected

void casa::PassiveTableDD::installDefaultOptions ( )

private

Install the default options for this DisplayData.

void casa::PassiveTableDD::operator= ( const PassiveTableDD & other )

protected

(Required) copy assignment.

virtual AttributeBuffer casa::PassiveTableDD::optionsAsAttributes ( )

virtual

Return the current options of this DisplayData as an AttributeBuffer.

Reimplemented from casa::PassiveCachingDD.

Reimplemented in casa::SkyCatOverlayDD.

virtual void casa::PassiveTableDD::setDefaultOptions ( )

virtual

Install the default options for this DisplayData.

Reimplemented from casa::PassiveCachingDD.

Reimplemented in casa::SkyCatOverlayDD.

virtual casacore::Bool casa::PassiveTableDD::setOptions	(	casacore::Record &	rec,
		casacore::Record &	recOut
	)

virtual

Apply options stored in rec to the DisplayData.

A return value of true means a refresh is needed. recOut contains any fields which were implicitly changed as a result of the call to this function.

Reimplemented from casa::PassiveCachingDD.

Reimplemented in casa::SkyCatOverlayDD.

casacore::Table* casa::PassiveTableDD::table ( )

protected

Return the casacore::Table pointer for use by derived classes.

If a query is active (via setOptions), then the result of the query is returned, otherwise the construction casacore::Table is returned.

Member Data Documentation

casacore::String casa::PassiveTableDD::itsOptQueryString

private

Option: what is the query string, or is it unset?

Definition at line 138 of file PassiveTableDD.h.

casacore::Bool casa::PassiveTableDD::itsOptQueryStringUnset

private

Definition at line 139 of file PassiveTableDD.h.

casacore::Table* casa::PassiveTableDD::itsQueryTable

private

Store the result of a query on the table here.

Definition at line 135 of file PassiveTableDD.h.

casacore::Table* casa::PassiveTableDD::itsTable

private

Store the primary table here.

Definition at line 132 of file PassiveTableDD.h.

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

casa/code/display/DisplayDatas/PassiveTableDD.h

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Synopsis

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation