WorldCanvas event-based rectangle region drawer. More...

#include <MWCRTRegion.h>

Inheritance diagram for casa::MWCRTRegion:

Public Member Functions
	MWCRTRegion (Display::KeySym keysym=Display::K_Pointer_Button2)
	Constructor. More...

virtual	~MWCRTRegion ()
	Destructor. More...

virtual void	handleEvent (DisplayEvent &ev)
	handle events, via new-style interface. More...

Public Member Functions inherited from casa::MWCRectTool
	MWCRectTool (Display::KeySym keysym=Display::K_Pointer_Button1, const casacore::Bool persistent=false)
	Constructor. More...

virtual	~MWCRectTool ()
	Destructor. More...

virtual void	disable ()
	Switch the tool off - this erases the rectangle, if any, and calls the base class disable. More...

virtual void	reset (casacore::Bool skipRefresh=false)
	reset to non-existent, non-active rectangle. More...

virtual casacore::Bool	rectangleDefined ()
	Is a rectangle currently defined? More...

Public Member Functions inherited from casa::MultiWCTool
	MultiWCTool (const Display::KeySym &keysym=Display::K_Pointer_Button1, bool enable_events=true)
	Constructor taking the primary key to which this tool will respond. More...

virtual	~MultiWCTool ()
	Destructor. More...

virtual void	addWorldCanvas (WorldCanvas &worldcanvas)
	Add/remove a WorldCanvas from the control of this tool. More...

virtual void	removeWorldCanvas (WorldCanvas &worldcanvas)

virtual void	addWorldCanvases (PanelDisplay *pdisp)
	Add/Remove a list of WorldCanvases from PanelDisplay. More...

virtual void	removeWorldCanvases (PanelDisplay *pdisp)

virtual void	enable ()
	Switch the tool on/off - this simply registers or unregisters the event handlers on the WorldCanvases. More...

virtual void	operator() (const WCPositionEvent &ev)
	Required operators for event handling - these are called when events occur, and distribute the events to the "user-level" methods. More...

virtual void	operator() (const WCMotionEvent &ev)
	default sends event to cout More...

virtual void	operator() (const WCRefreshEvent &ev)
	original handler interface (still used for WCRefreshEvents) More...

Public Member Functions inherited from casa::DisplayTool
virtual	~DisplayTool ()
	Destructor. More...

virtual void	setKey (const Display::KeySym &keysym)
	Set/get which key to catch. More...

virtual Display::KeySym	getKey () const

Public Member Functions inherited from casa::WCPositionEH
	WCPositionEH ()
	Default Constructor Required. More...

virtual	~WCPositionEH ()
	Destructor. More...

Public Member Functions inherited from casa::WCMotionEH
	WCMotionEH ()
	Default Constructor Required. More...

virtual	~WCMotionEH ()
	Destructor. More...

Public Member Functions inherited from casa::WCRefreshEH
	WCRefreshEH ()
	Default Constructor Required. More...

virtual	~WCRefreshEH ()
	Destructor. More...

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

Public Member Functions inherited from casa::DTVisible
	DTVisible ()
	Default constructor. More...

virtual	~DTVisible ()
	Destructor. More...

virtual casacore::String	drawColor () const
	Return the color to use. More...

virtual casacore::Int	lineWidth () const
	Return the line width to use. More...

virtual casacore::Double	doubleClickInterval () const
	Return the double click interval (in seconds). More...

Protected Member Functions
virtual void	doubleInside ()
	Handle double-click inside the rectangle. More...

virtual void	regionReady ()
	This function is called when a region is deliberately "finished" by the user. More...

void	getWorldCoords (casacore::Vector< casacore::Double > &blc, casacore::Vector< casacore::Double > &trc)
	get the world coords of the current rectangular region More...

void	getLinearCoords (casacore::Vector< casacore::Double > &blc, casacore::Vector< casacore::Double > &trc)
	get the linear coords of the current rectangular region More...

Protected Member Functions inherited from casa::MWCRectTool
virtual void	keyPressed (const WCPositionEvent &)
	Functions called by the base class event handling operators–and normally only those. More...

virtual void	keyReleased (const WCPositionEvent &)

virtual void	otherKeyPressed (const WCPositionEvent &)

virtual void	moved (const WCMotionEvent &, const viewer::region::region_list_type &)

virtual void	draw (const WCRefreshEvent &, const viewer::region::region_list_type &)
	draw the rectangle (if any) on the object's currently active WC. More...

virtual void	doubleOutside ()

virtual void	rectangleReady ()
	Called when a rectangle is ready and not being edited. More...

virtual void	get (casacore::Int &x1, casacore::Int &y1, casacore::Int &x2, casacore::Int &y2) const
	Retrieve the rectangle coordinates, in screen pixels. More...

Protected Member Functions inherited from casa::MultiWCTool
virtual void	otherKeyReleased (const WCPositionEvent &)

virtual void	updateRegion ()

virtual void	clicked (casacore::Int, casacore::Int)

virtual void	doubleClicked (casacore::Int, casacore::Int)

virtual void	refresh ()
	Copy back-to-front buffer (erasing all MWCTool drawings), then cause this (and all MWCTools on current WC's PC) to draw (or not draw) themselves, according to their current state. More...

virtual void	setClipToDrawArea ()
	Cause subsequent drawing commands to be clipped to the current WC (or its drawing area). More...

virtual void	setClipToWC ()

virtual void	resetClip ()

Protected Member Functions inherited from casa::DisplayTool
	DisplayTool (const Display::KeySym &keysym=Display::K_Pointer_Button1)
	Constructor taking a key to which this tool will initially be attached, typically one of the pointer buttons. More...

	DisplayTool (const DisplayTool &other)
	Copy constructor - construct a new DisplayTool from `other`, using copy semantics. More...

DisplayTool &	operator= (const DisplayTool &other)
	Copy assignment using copy semantics. More...

Display::KeyModifier	keyModifiers ()
	Return the modifier mask. More...

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

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

Additional Inherited Members
Protected Attributes inherited from casa::MultiWCTool
WorldCanvas *	itsCurrentWC
	WC being (or to be) drawn on (may be 0 initially). More...

Detailed Description

WorldCanvas event-based rectangle region drawer.

Intended use:

Public interface

Review Status

<prerequisites> MWCRectTool </prerequisites>

Etymology

MWCRTRegion stands for MultiWorldCanvas Rectangle Tool Region

Synopsis

This class finalises the functionality in MWCRectTool to implement event-based drawing of rectangular regions on a WorldCanvas. casacore::Double clicking inside the constructed rectangle emits the region, whilst pressing Escape cancels the region.

Example

Motivation

Rectangular regions are the most common regions, and constructing them visually can be very efficient.

To Do

Nothing known

Definition at line 78 of file MWCRTRegion.h.

Constructor & Destructor Documentation

casa::MWCRTRegion::MWCRTRegion ( Display::KeySym keysym = Display::K_Pointer_Button2 )

Constructor.

virtual casa::MWCRTRegion::~MWCRTRegion ( )

virtual

Destructor.

Member Function Documentation

virtual void casa::MWCRTRegion::doubleInside ( )

protectedvirtual

Handle double-click inside the rectangle.

Invokes regionReady().

Reimplemented from casa::MWCRectTool.

void casa::MWCRTRegion::getLinearCoords	(	casacore::Vector< casacore::Double > &	blc,
		casacore::Vector< casacore::Double > &	trc
	)

protected

get the linear coords of the current rectangular region

void casa::MWCRTRegion::getWorldCoords	(	casacore::Vector< casacore::Double > &	blc,
		casacore::Vector< casacore::Double > &	trc
	)

protected

get the world coords of the current rectangular region

virtual void casa::MWCRTRegion::handleEvent ( DisplayEvent & ev )

virtual

handle events, via new-style interface.

Currently just for reset event.

Reimplemented from casa::DisplayEH.

virtual void casa::MWCRTRegion::regionReady ( )

inlineprotectedvirtual

This function is called when a region is deliberately "finished" by the user.

It can be implemented to do further actions, such as report the region to the application

Reimplemented in casa::QtOldRTRegion.

Definition at line 99 of file MWCRTRegion.h.

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

casa/code/display/DisplayEvents/MWCRTRegion.h

Public Member Functions

Protected Member Functions

Additional Inherited Members