Engauge Digitizer 2
Loading...
Searching...
No Matches
Public Member Functions | Protected Member Functions | List of all members
DigitizeStateAbstractBase Class Referenceabstract

Base class for all digitizing states. This serves as an interface to DigitizeStateContext. More...

#include <DigitizeStateAbstractBase.h>

Inheritance diagram for DigitizeStateAbstractBase:
Inheritance graph
Collaboration diagram for DigitizeStateAbstractBase:
Collaboration graph

Public Member Functions

 DigitizeStateAbstractBase (DigitizeStateContext &context)
 Single constructor.
 
virtual ~DigitizeStateAbstractBase ()
 
virtual QString activeCurve () const =0
 Name of the active Curve. This can include AXIS_CURVE_NAME.
 
virtual void begin (CmdMediator *cmdMediator, DigitizeState previousState)=0
 Method that is called at the exact moment a state is entered.
 
virtual bool canPaste (const Transformation &transformation, const QSize &viewSize) const =0
 Return true if there is good data in the clipboard for pasting, and that is compatible with the current state.
 
DigitizeStateContextcontext ()
 Reference to the DigitizeStateContext that contains all the DigitizeStateAbstractBase subclasses, without const.
 
const DigitizeStateContextcontext () const
 Reference to the DigitizeStateContext that contains all the DigitizeStateAbstractBase subclasses, without const.
 
virtual void end ()=0
 Method that is called at the exact moment a state is exited. Typically called just before begin for the next state.
 
virtual void handleContextMenuEventAxis (CmdMediator *cmdMediator, const QString &pointIdentifier)=0
 Handle a right click, on an axis point, that was intercepted earlier.
 
virtual void handleContextMenuEventGraph (CmdMediator *cmdMediator, const QStringList &pointIdentifiers)=0
 Handle a right click, on a graph point, that was intercepted earlier.
 
virtual void handleCurveChange (CmdMediator *cmdMediator)=0
 Handle the selection of a new curve. At a minimum, DigitizeStateSegment will generate a new set of Segments.
 
virtual void handleKeyPress (CmdMediator *cmdMediator, Qt::Key key, bool atLeastOneSelectedItem)=0
 Handle a key press that was intercepted earlier.
 
virtual void handleMouseMove (CmdMediator *cmdMediator, QPointF posScreen)=0
 Handle a mouse move. This is part of an experiment to see if augmenting the cursor in Point Match mode is worthwhile.
 
virtual void handleMousePress (CmdMediator *cmdMediator, QPointF pos)=0
 Handle a mouse press that was intercepted earlier.
 
virtual void handleMouseRelease (CmdMediator *cmdMediator, QPointF pos)=0
 Handle a mouse release that was intercepted earlier.
 
void setCursor (CmdMediator *cmdMediator)
 Update the cursor according to the current state.
 
virtual QString state () const =0
 State name for debugging.
 
virtual void updateAfterPointAddition ()=0
 Update graphics attributes after possible new points. This is useful for highlight opacity.
 
virtual void updateModelDigitizeCurve (CmdMediator *cmdMediator, const DocumentModelDigitizeCurve &modelDigitizeCurve)=0
 Update the digitize curve settings.
 
virtual void updateModelSegments (const DocumentModelSegments &modelSegments)=0
 Update the segments given the new settings.
 

Protected Member Functions

bool canPasteProtected (const Transformation &transformation, const QSize &viewSize) const
 Protected version of canPaste method. Some, but not all, leaf classes use this method.
 
virtual QCursor cursor (CmdMediator *cmdMediator) const =0
 Returns the state-specific cursor shape.
 

Detailed Description

Base class for all digitizing states. This serves as an interface to DigitizeStateContext.

Definition at line 37 of file DigitizeStateAbstractBase.h.

Constructor & Destructor Documentation

◆ DigitizeStateAbstractBase()

DigitizeStateAbstractBase::DigitizeStateAbstractBase ( DigitizeStateContext & context)

Single constructor.

Definition at line 23 of file DigitizeStateAbstractBase.cpp.

23 :
24 m_context (context)
25{
26}
DigitizeStateContext & context()
Reference to the DigitizeStateContext that contains all the DigitizeStateAbstractBase subclasses,...

◆ ~DigitizeStateAbstractBase()

DigitizeStateAbstractBase::~DigitizeStateAbstractBase ( )
virtual

Definition at line 28 of file DigitizeStateAbstractBase.cpp.

29{
30}

Member Function Documentation

◆ activeCurve()

virtual QString DigitizeStateAbstractBase::activeCurve ( ) const
pure virtual

◆ begin()

virtual void DigitizeStateAbstractBase::begin ( CmdMediator * cmdMediator,
DigitizeState previousState )
pure virtual

Method that is called at the exact moment a state is entered.

Typically called just after end for the previous state. The previousState value is used by DigitizeStateColorPicker to return to the previous state

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ canPaste()

virtual bool DigitizeStateAbstractBase::canPaste ( const Transformation & transformation,
const QSize & viewSize ) const
pure virtual

Return true if there is good data in the clipboard for pasting, and that is compatible with the current state.

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ canPasteProtected()

bool DigitizeStateAbstractBase::canPasteProtected ( const Transformation & transformation,
const QSize & viewSize ) const
protected

Protected version of canPaste method. Some, but not all, leaf classes use this method.

Definition at line 32 of file DigitizeStateAbstractBase.cpp.

34{
36
37 return mimePointsDetector.isMimePointsData (transformation,
38 viewSize);
39}
const int INNER_RADIUS_MIN
Detect if text is acceptable for ingestion by MimePoints.
bool isMimePointsData(const Transformation &transforation, const QSize &screenSize) const
Returns true if text is acceptable mime data.

◆ context() [1/2]

DigitizeStateContext & DigitizeStateAbstractBase::context ( )

Reference to the DigitizeStateContext that contains all the DigitizeStateAbstractBase subclasses, without const.

Definition at line 41 of file DigitizeStateAbstractBase.cpp.

42{
43 return m_context;
44}

◆ context() [2/2]

const DigitizeStateContext & DigitizeStateAbstractBase::context ( ) const

Reference to the DigitizeStateContext that contains all the DigitizeStateAbstractBase subclasses, without const.

Definition at line 46 of file DigitizeStateAbstractBase.cpp.

47{
48 return m_context;
49}

◆ cursor()

virtual QCursor DigitizeStateAbstractBase::cursor ( CmdMediator * cmdMediator) const
protectedpure virtual

◆ end()

virtual void DigitizeStateAbstractBase::end ( )
pure virtual

Method that is called at the exact moment a state is exited. Typically called just before begin for the next state.

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ handleContextMenuEventAxis()

virtual void DigitizeStateAbstractBase::handleContextMenuEventAxis ( CmdMediator * cmdMediator,
const QString & pointIdentifier )
pure virtual

Handle a right click, on an axis point, that was intercepted earlier.

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ handleContextMenuEventGraph()

virtual void DigitizeStateAbstractBase::handleContextMenuEventGraph ( CmdMediator * cmdMediator,
const QStringList & pointIdentifiers )
pure virtual

Handle a right click, on a graph point, that was intercepted earlier.

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ handleCurveChange()

virtual void DigitizeStateAbstractBase::handleCurveChange ( CmdMediator * cmdMediator)
pure virtual

Handle the selection of a new curve. At a minimum, DigitizeStateSegment will generate a new set of Segments.

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ handleKeyPress()

virtual void DigitizeStateAbstractBase::handleKeyPress ( CmdMediator * cmdMediator,
Qt::Key key,
bool atLeastOneSelectedItem )
pure virtual

◆ handleMouseMove()

virtual void DigitizeStateAbstractBase::handleMouseMove ( CmdMediator * cmdMediator,
QPointF posScreen )
pure virtual

Handle a mouse move. This is part of an experiment to see if augmenting the cursor in Point Match mode is worthwhile.

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ handleMousePress()

virtual void DigitizeStateAbstractBase::handleMousePress ( CmdMediator * cmdMediator,
QPointF pos )
pure virtual

◆ handleMouseRelease()

virtual void DigitizeStateAbstractBase::handleMouseRelease ( CmdMediator * cmdMediator,
QPointF pos )
pure virtual

◆ setCursor()

void DigitizeStateAbstractBase::setCursor ( CmdMediator * cmdMediator)

Update the cursor according to the current state.

Definition at line 51 of file DigitizeStateAbstractBase.cpp.

52{
53 LOG4CPP_DEBUG_S ((*mainCat)) << "DigitizeStateAbstractBase::setCursor";
54
55 // Note that we are setting the QGraphicsView cursor and NOT the QApplication override cursor
56 m_context.view ().setCursor (cursor (cmdMediator));
57}
log4cpp::Category * mainCat
Definition Logger.cpp:14
virtual QCursor cursor(CmdMediator *cmdMediator) const =0
Returns the state-specific cursor shape.
QGraphicsView & view()
QGraphicsView for use by DigitizeStateAbstractBase subclasses.
#define LOG4CPP_DEBUG_S(logger)
Definition convenience.h:20

◆ state()

virtual QString DigitizeStateAbstractBase::state ( ) const
pure virtual

◆ updateAfterPointAddition()

virtual void DigitizeStateAbstractBase::updateAfterPointAddition ( )
pure virtual

Update graphics attributes after possible new points. This is useful for highlight opacity.

Implemented in DigitizeStateAxis, DigitizeStateColorPicker, DigitizeStateCurve, DigitizeStateEmpty, DigitizeStatePointMatch, DigitizeStateScale, DigitizeStateSegment, and DigitizeStateSelect.

◆ updateModelDigitizeCurve()

virtual void DigitizeStateAbstractBase::updateModelDigitizeCurve ( CmdMediator * cmdMediator,
const DocumentModelDigitizeCurve & modelDigitizeCurve )
pure virtual

◆ updateModelSegments()

virtual void DigitizeStateAbstractBase::updateModelSegments ( const DocumentModelSegments & modelSegments)
pure virtual

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