GuidelineEllipse Class Reference

Ellipse version of GuidelineAbstract. More...

#include <GuidelineEllipse.h>

Inheritance diagram for GuidelineEllipse:

Collaboration diagram for GuidelineEllipse:

Public Member Functions
	GuidelineEllipse (QGraphicsScene &scene, MainWindow &mainWindow, Guidelines &guidelines, GuidelineState guidelineStateInitial, const QString &identifier)
	Single constructor.
	~GuidelineEllipse ()
virtual bool	collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const
	Override normal QGraphicsEllipseItem collision detection that covers ellipse boundary and entire interior region, to exclude the interior region.
virtual bool	getGraphicsItemSelected () const
	Wrapper for QGraphicsItem::isSelected.
virtual bool	getGraphicsItemAcceptHover () const
	Return true if accepting hover events.
virtual QGraphicsItem::GraphicsItemFlags	graphicsItemFlags () const
	Wraps QGraphicsItem::flags.
virtual void	hoverEnterEvent (QGraphicsSceneHoverEvent *event)
	Highlight this Guideline upon hover enter.
virtual void	hoverLeaveEvent (QGraphicsSceneHoverEvent *event)
	Unset highlighting triggered by hover enter.
virtual QString	identifier () const
	Unique identifier from QGraphicsItem.
virtual void	mouseMoveEvent (QGraphicsSceneMouseEvent *event)
	Forward movements to visible Guideline.
virtual void	mousePressEvent (QGraphicsSceneMouseEvent *event)
	Forward press event to state machine.
virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event)
	Cleanup after being dragged.
virtual void	paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget=Q_NULLPTR)
	Override painting so this disappears when selected. Selected Guidelines are never visible.
virtual void	removeFromScene (QGraphicsScene *scene)
	Make graphics item remove itself from the scene.
virtual void	setGraphicsItemAcceptHoverEvents (bool accept)
	Wrapper for QGraphicsItem::setAcceptHoverEvents.
virtual void	setGraphicsItemFlags (QGraphicsItem::GraphicsItemFlags flags)
	Wrapper for QGraphicsItem::setFlags.
virtual void	setGraphicsItemLine (const QLineF &line)
	Wrapper for QGraphicsLineItem::setLine.
virtual void	setGraphicsItemPen (const QColor &color, double lineWidth)
	Wrapper for QGraphicsItem::setPen.
virtual void	setGraphicsItemVisible (bool visible)
	Wrapper for QGraphicsItem::setVisible.
virtual void	setGraphicsItemZValue (double z)
	Wrapper for QGraphicsItem::setZValue.
virtual void	updateColor ()
	Force a color update.
virtual void	updateGeometry (double valueGraph)
	Update the geometry so it passes through the specified coordinate value in graph coordinates.
virtual void	updateGeometry (const QPointF &posScreen)
	Update the geometry so it passes through the specified point in screen coordinates.
Public Member Functions inherited from GuidelineAbstract
	GuidelineAbstract (QGraphicsScene &scene)
	Single constructor.
	~GuidelineAbstract ()
void	bindGuidelineVisibleToInvisible (GuidelineAbstract *guidelineVisible)
	Bind a newly-created visible Guideline to this Guideline, and make this one invisible.
void	handleActiveChange (bool active)
	DigitizeState change so active status may (or may not) be toggled.
void	handleGuidelineMode (bool visible, bool locked)
	User toggled Guideline visibility and/or locked mode.
void	handleHoverEnterEvent ()
	Highlight this Guideline upon hover enter.
void	handleHoverLeaveEvent ()
	Unset highlighting triggered by hover enter.
void	handleMouseMoveEvent (const QPointF &posScene)
	Forward movements to visible Guideline.
void	handleMousePressEvent (const QPointF &posScene)
	Forward press event to state machine.
void	handleMouseReleaseEvent (const QPointF &posScene)
	Cleanup after being dragged.
QPointF	posCursorGraph () const
	Get position in graph coordinates.
void	sacrificeHandleAndVisibleGuidelines (const QPointF &posScene, GuidelineState guidelineStateForReplacement)
	Replace visible and handle Guidelines after click and drag.
QGraphicsScene &	scene ()
	GraphicsScene that owns this class.
QString	stateDump () const
	Dump of state as a string for debugging only. Context like the QGraphicsItem flags is included.
QString	stateName () const
	Current state name for debugging and unit test only.
void	updateActive (bool active)
	Update active versus inactive state.
void	updateWithLatestTransformation ()
	Update given Transformation in GuidelineStateContext. This is called after a command has been executed.

Additional Inherited Members
Public Slots inherited from GuidelineAbstract
void	slotHandleMoved (QPointF posScreen)
	Slot for signal from cloned deployed Guideline from handle Guideline.
Signals inherited from GuidelineAbstract
void	signalGuidelineDragged (QString, double, bool, GuidelineState)
	Signal indicating end of Guideline drag.
void	signalHandleMoved (QPointF)
	Signal for cloned deployed Guideline from handle Guideline.
Protected Member Functions inherited from GuidelineAbstract
GuidelineStateContext *	context ()
	State machine context owned by this class.
const GuidelineStateContext *	context () const
	State machine context owned by this class as a const.
void	setContext (GuidelineStateContext *context)
	Create state machine after virtual methods of child classes have been defined.

Detailed Description

Ellipse version of GuidelineAbstract.

Definition at line 22 of file GuidelineEllipse.h.

Constructor & Destructor Documentation

GuidelineEllipse()

GuidelineEllipse::GuidelineEllipse	(	QGraphicsScene &	scene,
		MainWindow &	mainWindow,
		Guidelines &	guidelines,
		GuidelineState	guidelineStateInitial,
		const QString &	identifier )

Single constructor.

Definition at line 29 of file GuidelineEllipse.cpp.

                                                              :
  GuidelineAbstract (scene),
  m_mainWindow (mainWindow)
{
  LOG4CPP_DEBUG_S ((*mainCat)) << "GuidelineEllipse::GuidelineEllipse identifier=" << identifier.toLatin1().data();
 
  // Create context after all virtual methods have been created. The transition
  // into the initial state will position the line if it was created by a button press
  setContext (new GuidelineStateContext (*this,
                                         mainWindow,
                                         guidelines,
                                         guidelineStateInitial));
 
  setData (DATA_KEY_GRAPHICS_ITEM_TYPE, QVariant (GRAPHICS_ITEM_TYPE_GUIDELINE));
  setData (DATA_KEY_IDENTIFIER, QVariant (identifier));
 
  scene.addItem (this);
}

~GuidelineEllipse()

GuidelineEllipse::~GuidelineEllipse

(

)

Definition at line 52 of file GuidelineEllipse.cpp.

{
}

Member Function Documentation

collidesWithPath()

bool GuidelineEllipse::collidesWithPath ( const QPainterPath & path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape ) const

virtual

Override normal QGraphicsEllipseItem collision detection that covers ellipse boundary and entire interior region, to exclude the interior region.

Definition at line 56 of file GuidelineEllipse.cpp.

{
  const double RATIO = 1000.0; // Ratio of many pixels to few pixels, for preventing divide by zero
  bool collides = false;
 
  if (QGraphicsEllipseItem::collidesWithPath (path,
                                              mode)) {
 
    // Slow (but fast enough) test to count interior regions
 
    // Bounding box of ellipse
    double a = rect().width() / 2.0;
    double b = rect().height() / 2.0;
 
    // Loop through points in path polygon
    QPolygonF poly = path.toFillPolygon();
    QPolygonF::const_iterator itr;
    for (itr = poly.begin(); (itr != poly.end()) && !collides; itr++) {
 
      // This point is for the ellipse that has already been rotated to be aligned with axes
      const QPointF &pointAligned = *itr;
 
      // Project point onto ellipse. The projection is assumed to be the closest ellipse portion to that point.
      // Starting with (x/a)^2+(y/b)^2=1 with x=r cos(Theta) and y=r sin(Theta), we can solve to get r^2 (cT^2/a^2 + sT2/b^2) = 1
      double xGot = pointAligned.x();
      double yGot = pointAligned.y();
      double rGot = qSqrt (xGot * xGot + yGot * yGot);
      if (rGot * RATIO > qAbs (xGot) || rGot * RATIO > qAbs (yGot)) {
 
        // Check for divide by zero passed so keep going
        double cTheta = xGot / rGot;
        double sTheta = yGot / rGot;
        double rProjected = qSqrt (1.0 / (cTheta * cTheta / a / a + sTheta * sTheta / b / b));
        double xProjected = rProjected * cTheta;
        double yProjected = rProjected * sTheta;
 
        // Distance to projection
        double distance = qSqrt ((xProjected - xGot) * (xProjected - xGot) +
                                 (yProjected - yGot) * (yProjected - yGot));
 
        int lineWidthHover = m_mainWindow.cmdMediator ()->document ().modelGuideline ().lineWidthActive ();
        
        if (distance < lineWidthHover) {
 
          // This will make the loop exit immediately for speed
          collides = true;
        }
      }
    }
  }
 
  return collides;
}

getGraphicsItemAcceptHover()

bool GuidelineEllipse::getGraphicsItemAcceptHover ( ) const

virtual

Return true if accepting hover events.

Implements GuidelineAbstract.

Definition at line 111 of file GuidelineEllipse.cpp.

{
  return acceptHoverEvents();
}

getGraphicsItemSelected()

bool GuidelineEllipse::getGraphicsItemSelected ( ) const

virtual

Wrapper for QGraphicsItem::isSelected.

Implements GuidelineAbstract.

Definition at line 116 of file GuidelineEllipse.cpp.

{
  return QGraphicsEllipseItem::isSelected ();
}

graphicsItemFlags()

QGraphicsItem::GraphicsItemFlags GuidelineEllipse::graphicsItemFlags ( ) const

virtual

Wraps QGraphicsItem::flags.

Implements GuidelineAbstract.

Definition at line 121 of file GuidelineEllipse.cpp.

{
  return QGraphicsEllipseItem::flags ();
}

hoverEnterEvent()

void GuidelineEllipse::hoverEnterEvent ( QGraphicsSceneHoverEvent * event )

virtual

Highlight this Guideline upon hover enter.

Definition at line 126 of file GuidelineEllipse.cpp.

{
  handleHoverEnterEvent ();
 
  QGraphicsEllipseItem::hoverEnterEvent (event);    
}

hoverLeaveEvent()

void GuidelineEllipse::hoverLeaveEvent ( QGraphicsSceneHoverEvent * event )

virtual

Unset highlighting triggered by hover enter.

Definition at line 133 of file GuidelineEllipse.cpp.

{
  handleHoverLeaveEvent ();
 
  QGraphicsEllipseItem::hoverLeaveEvent (event);  
}

identifier()

QString GuidelineEllipse::identifier ( ) const

virtual

Unique identifier from QGraphicsItem.

Implements GuidelineAbstract.

Definition at line 140 of file GuidelineEllipse.cpp.

{
  return data (DATA_KEY_IDENTIFIER).toString ();
}

mouseMoveEvent()

void GuidelineEllipse::mouseMoveEvent ( QGraphicsSceneMouseEvent * event )

virtual

Forward movements to visible Guideline.

Definition at line 145 of file GuidelineEllipse.cpp.

{
  handleMouseMoveEvent (event->scenePos ());
  
  QGraphicsEllipseItem::mouseMoveEvent (event);
}

mousePressEvent()

void GuidelineEllipse::mousePressEvent ( QGraphicsSceneMouseEvent * event )

virtual

Forward press event to state machine.

Definition at line 152 of file GuidelineEllipse.cpp.

{
  LOG4CPP_DEBUG_S ((*mainCat)) << "GuidelineEllipse::mousePressEvent";
 
  QGraphicsEllipseItem::mousePressEvent (event);
 
  handleMousePressEvent (event->scenePos ());
 
  context()->handleMousePress(event->scenePos());
}

mouseReleaseEvent()

void GuidelineEllipse::mouseReleaseEvent ( QGraphicsSceneMouseEvent * event )

virtual

Cleanup after being dragged.

Definition at line 163 of file GuidelineEllipse.cpp.

{
  LOG4CPP_DEBUG_S ((*mainCat)) << "GuidelineEllipse::mouseReleaseEvent";
 
  handleMouseReleaseEvent (event->scenePos());
 
  QGraphicsEllipseItem::mouseReleaseEvent (event);
}

paint()

void GuidelineEllipse::paint ( QPainter * painter, const QStyleOptionGraphicsItem * option, QWidget * widget = Q_NULLPTR )

virtual

Override painting so this disappears when selected. Selected Guidelines are never visible.

Definition at line 172 of file GuidelineEllipse.cpp.

{
  if (context()->doPaint ()) {
 
    QGraphicsEllipseItem::paint (painter,
                                 option,
                                 widget);
  }
}

removeFromScene()

void GuidelineEllipse::removeFromScene ( QGraphicsScene * scene )

virtual

Make graphics item remove itself from the scene.

Implements GuidelineAbstract.

Definition at line 184 of file GuidelineEllipse.cpp.

{
  LOG4CPP_DEBUG_S ((*mainCat)) << "GuidelineLine::removeFromScene identifier="
                               << identifier().toLatin1().data();
 
  scene->removeItem (this);
}

setGraphicsItemAcceptHoverEvents()

void GuidelineEllipse::setGraphicsItemAcceptHoverEvents ( bool accept )

virtual

Wrapper for QGraphicsItem::setAcceptHoverEvents.

Implements GuidelineAbstract.

Definition at line 192 of file GuidelineEllipse.cpp.

{
  QGraphicsEllipseItem::setAcceptHoverEvents (accept);
}

setGraphicsItemFlags()

void GuidelineEllipse::setGraphicsItemFlags ( QGraphicsItem::GraphicsItemFlags flags )

virtual

Wrapper for QGraphicsItem::setFlags.

Implements GuidelineAbstract.

Definition at line 197 of file GuidelineEllipse.cpp.

{
  QGraphicsEllipseItem::setFlags (flags);
}

setGraphicsItemLine()

void GuidelineEllipse::setGraphicsItemLine ( const QLineF & line )

virtual

Wrapper for QGraphicsLineItem::setLine.

Implements GuidelineAbstract.

Definition at line 202 of file GuidelineEllipse.cpp.

{
  // Noop
}

setGraphicsItemPen()

void GuidelineEllipse::setGraphicsItemPen ( const QColor & color, double lineWidth )

virtual

Wrapper for QGraphicsItem::setPen.

Implements GuidelineAbstract.

Definition at line 207 of file GuidelineEllipse.cpp.

{
  QBrush brush (color);
 
  setPen (QPen (brush,
                lineWidth));
}

setGraphicsItemVisible()

void GuidelineEllipse::setGraphicsItemVisible ( bool visible )

virtual

Wrapper for QGraphicsItem::setVisible.

Implements GuidelineAbstract.

Definition at line 216 of file GuidelineEllipse.cpp.

{
  QGraphicsEllipseItem::setVisible (visible);
}

setGraphicsItemZValue()

void GuidelineEllipse::setGraphicsItemZValue ( double z )

virtual

Wrapper for QGraphicsItem::setZValue.

Implements GuidelineAbstract.

Definition at line 221 of file GuidelineEllipse.cpp.

{
  QGraphicsEllipseItem::setZValue (z);
}

updateColor()

void GuidelineEllipse::updateColor ( )

virtual

Force a color update.

Implements GuidelineAbstract.

Definition at line 226 of file GuidelineEllipse.cpp.

{
  // Apply color to brush and pen defined in setGraphicsItemPen.
 
  QPen p = QGraphicsEllipseItem::pen();
  QBrush br = p.brush();
  double alphaF = br.color().alphaF();
  double lineWidth = p.width ();
 
  QColor color = ColorPaletteToQColor (context()->color());
  color.setAlphaF (alphaF);
 
  setGraphicsItemPen (color,
                      lineWidth);
}

updateGeometry() [1/2]

void GuidelineEllipse::updateGeometry ( const QPointF & posScreen )

virtual

Update the geometry so it passes through the specified point in screen coordinates.

Implements GuidelineAbstract.

Definition at line 249 of file GuidelineEllipse.cpp.

{
  LOG4CPP_INFO_S ((*mainCat)) << "GuidelineEllipse::updateGeometry scale=" << scale()
                              << " rotation(deg)=" << rotation();
 
  EllipseParameters ellipseParameters = context()->pointToEllipse (posScreen);
 
  QPointF posCenter = ellipseParameters.posCenter();
 
  double a = ellipseParameters.a();
  double b = ellipseParameters.b();
 
  setRect (QRectF (- QPointF (a, b),
                   + QPointF (a, b)));
 
  // Rotate. Originally the rectangle was centered at posCenter, the rotation center
  // was set using setTransformOriginPoint to posCenter, but the resulting shape was not right
  setRotation (qRadiansToDegrees (ellipseParameters.angleRadians()));
  setPos (posCenter);
 
  // Save the graph value for later
  QPointF posGraph;
  context()->transformation().transformScreenToRawGraph (posScreen,
                                                         posGraph);
  context()->setPosCursorGraph (posGraph);
 
  CentipedeDebugPolar debugPolar;
  debugPolar.dumpEllipseGraphicsItem ("GuidelineEllipse::updateGeometry",
                                      this);
}

updateGeometry() [2/2]

void GuidelineEllipse::updateGeometry ( double valueGraph )

virtual

Update the geometry so it passes through the specified coordinate value in graph coordinates.

Implements GuidelineAbstract.

Definition at line 242 of file GuidelineEllipse.cpp.

{
  // Convert single graph coordinate, which is range, into screen point pair,
  // then update with the screen point
  updateGeometry (context ()->convertGraphCoordinateToScreenPoint (valueGraph));
}

---

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

• Guideline/GuidelineEllipse.h
• Guideline/GuidelineEllipse.cpp