casa  5.7.0-16
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Types | Public Member Functions | Private Member Functions | Private Attributes | List of all members
casacore::RegionHandlerTable Class Reference

Class for keeping regions in memory. More...

#include <RegionHandlerTable.h>

Inheritance diagram for casacore::RegionHandlerTable:
casacore::RegionHandler

Public Types

typedef TableGetCallback (void *objectPtr, Bool writable)
 
- Public Types inherited from casacore::RegionHandler
enum  GroupType {
  Regions,
  Masks,
  Any
}
 Define the possible group types (regions or masks). More...
 

Public Member Functions

 RegionHandlerTable (GetCallback *callback, void *objectPtr)
 
 RegionHandlerTable (const RegionHandlerTable &)
 
virtual ~RegionHandlerTable ()
 
RegionHandlerTableoperator= (const RegionHandlerTable &)
 
virtual RegionHandlerTableclone () const
 Make a copy of the object. More...
 
virtual void setObjectPtr (void *objectPtr)
 Set the object pointer (for RegionHandlerTable's callback). More...
 
virtual Bool canDefineRegion () const
 Can the class indeed define and handle regions? The default implementation returns False. More...
 
virtual void setDefaultMask (const String &maskName)
 Set the default mask to the mask with the given name. More...
 
virtual String getDefaultMask () const
 Get the name of the default mask. More...
 
virtual Bool defineRegion (const String &name, const ImageRegion &region, RegionHandler::GroupType, Bool overwrite=False)
 Define a region belonging to the table. More...
 
virtual Bool hasRegion (const String &name, RegionHandler::GroupType=RegionHandler::Any) const
 Does the table have a region with the given name? More...
 
virtual ImageRegiongetRegion (const String &name, RegionHandler::GroupType=Any, Bool throwIfUnknown=True) const
 Get a region belonging to the table. More...
 
virtual Bool renameRegion (const String &newName, const String &oldName, RegionHandler::GroupType=Any, Bool overwrite=False)
 Rename a region. More...
 
virtual Bool removeRegion (const String &name, RegionHandler::GroupType=Any, Bool throwIfUnknown=True)
 Remove a region belonging to the table. More...
 
virtual Vector< StringregionNames (RegionHandler::GroupType=Any) const
 Get the names of all regions/masks. More...
 
virtual ImageRegion makeMask (const LatticeBase &lattice, const String &name)
 Make a mask for a lattice (e.g. More...
 
- Public Member Functions inherited from casacore::RegionHandler
virtual ~RegionHandler ()
 
String makeUniqueRegionName (const String &rootName, uInt startNumber=1) const
 Make a unique region name from the given root name, thus make it such that the name is not already in use for a region or mask. More...
 

Private Member Functions

TablerwTable ()
 
const Tabletable () const
 
virtual Int findRegionGroup (const String &regionName, RegionHandler::GroupType=Any, Bool throwIfUnknown=True) const
 

Private Attributes

GetCallbackitsCallback
 
void * itsObjectPtr
 

Detailed Description

Class for keeping regions in memory.

Intended use:

Internal

Review Status

Test programs:
tPagedImage2

Prerequisite

Synopsis

Persistent regions are stored as subrecords of the table keywords "regions" and "masks". The user can choose one of both keywords. Keyword "masks" is meant for true image masks, i.e. telling for each pixel if it is good or bad. Keyword "regions" is meant for true regions in an image.

This class handles defining, getting and removing such regions. It is used by class

Definition at line 88 of file RegionHandlerTable.h.

Member Typedef Documentation

typedef Table& casacore::RegionHandlerTable::GetCallback(void *objectPtr, Bool writable)

Definition at line 93 of file RegionHandlerTable.h.

Constructor & Destructor Documentation

casacore::RegionHandlerTable::RegionHandlerTable ( GetCallback callback,
void *  objectPtr 
)
casacore::RegionHandlerTable::RegionHandlerTable ( const RegionHandlerTable )
virtual casacore::RegionHandlerTable::~RegionHandlerTable ( )
virtual

Member Function Documentation

virtual Bool casacore::RegionHandlerTable::canDefineRegion ( ) const
virtual

Can the class indeed define and handle regions? The default implementation returns False.

Reimplemented from casacore::RegionHandler.

virtual RegionHandlerTable* casacore::RegionHandlerTable::clone ( ) const
virtual

Make a copy of the object.

Reimplemented from casacore::RegionHandler.

virtual Bool casacore::RegionHandlerTable::defineRegion ( const String name,
const ImageRegion region,
RegionHandler::GroupType  ,
Bool  overwrite = False 
)
virtual

Define a region belonging to the table.

The group type determines if it stored as a region or mask. If overwrite=False, an exception will be thrown if the region already exists in the "regions" or "masks" keyword. Otherwise the region will be removed first.
A False status is returned if the table is not writable

Reimplemented from casacore::RegionHandler.

virtual Int casacore::RegionHandlerTable::findRegionGroup ( const String regionName,
RegionHandler::GroupType  = Any,
Bool  throwIfUnknown = True 
) const
privatevirtual
virtual String casacore::RegionHandlerTable::getDefaultMask ( ) const
virtual

Get the name of the default mask.

An empty string is returned if no default mask.

Reimplemented from casacore::RegionHandler.

virtual ImageRegion* casacore::RegionHandlerTable::getRegion ( const String name,
RegionHandler::GroupType  = Any,
Bool  throwIfUnknown = True 
) const
virtual

Get a region belonging to the table.

A zero pointer is returned if the region does not exist. The caller has to delete the ImageRegion object created.
No exception is thrown if the region does not exist.

Reimplemented from casacore::RegionHandler.

virtual Bool casacore::RegionHandlerTable::hasRegion ( const String name,
RegionHandler::GroupType  = RegionHandler::Any 
) const
virtual

Does the table have a region with the given name?

Reimplemented from casacore::RegionHandler.

virtual ImageRegion casacore::RegionHandlerTable::makeMask ( const LatticeBase lattice,
const String name 
)
virtual

Make a mask for a lattice (e.g.

a PagedImage or TempImage). It creates it with the shape and tile shape of the lattice.

Reimplemented from casacore::RegionHandler.

RegionHandlerTable& casacore::RegionHandlerTable::operator= ( const RegionHandlerTable )
virtual Vector<String> casacore::RegionHandlerTable::regionNames ( RegionHandler::GroupType  = Any) const
virtual

Get the names of all regions/masks.

Reimplemented from casacore::RegionHandler.

virtual Bool casacore::RegionHandlerTable::removeRegion ( const String name,
RegionHandler::GroupType  = Any,
Bool  throwIfUnknown = True 
)
virtual

Remove a region belonging to the table.


Optionally an exception is thrown if the region does not exist.
A False status is returned if the table is not writable

Reimplemented from casacore::RegionHandler.

virtual Bool casacore::RegionHandlerTable::renameRegion ( const String newName,
const String oldName,
RegionHandler::GroupType  = Any,
Bool  overwrite = False 
)
virtual

Rename a region.

If a region with the new name already exists, it is deleted or an exception is thrown (depending on overwrite). The region name is looked up in the given group(s).
An exception is thrown if the old region name does not exist.

Reimplemented from casacore::RegionHandler.

Table& casacore::RegionHandlerTable::rwTable ( )
inlineprivate

Definition at line 176 of file RegionHandlerTable.h.

References itsCallback, itsObjectPtr, and casacore::True.

virtual void casacore::RegionHandlerTable::setDefaultMask ( const String maskName)
virtual

Set the default mask to the mask with the given name.

It constructs a ImageRegion object for the new default mask. If the table is writable, the setting is persistent by writing the name as a keyword. If the given maskName is the empty string, the default mask is unset.

Reimplemented from casacore::RegionHandler.

virtual void casacore::RegionHandlerTable::setObjectPtr ( void *  objectPtr)
virtual

Set the object pointer (for RegionHandlerTable's callback).

Default implementation does nothing.

Reimplemented from casacore::RegionHandler.

const Table& casacore::RegionHandlerTable::table ( ) const
inlineprivate

Definition at line 178 of file RegionHandlerTable.h.

References casacore::False, itsCallback, and itsObjectPtr.

Member Data Documentation

GetCallback* casacore::RegionHandlerTable::itsCallback
private

Definition at line 192 of file RegionHandlerTable.h.

Referenced by rwTable(), and table().

void* casacore::RegionHandlerTable::itsObjectPtr
private

Definition at line 193 of file RegionHandlerTable.h.

Referenced by rwTable(), and table().


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