QwtPolarPicker(3)

📦
version 6.3.0 · 2 versions
, in alpine 3.24

💅 QwtPolarPicker(3) 💅

okay bestie, welcome to the Library Functions Manual entry for QwtPolarPicker(3) — it's giving polar-plot picker realness and I'm obsessed. 💖

💖 NAME 💖

QwtPolarPicker — QwtPolarPicker provides selections on a plot canvas. ✨

🦋 SYNOPSIS 🦋

#include <qwt_polar_picker.h>

Inherits: QwtPicker 💅

📡 Signals 📡

  • void selected (const QwtPointPolar &pos)
  • void selected (const QVector< QwtPointPolar > &points)
  • void appended (const QwtPointPolar &pos)
  • void moved (const QwtPointPolar &pos)

Signals inherited from QwtPicker

  • void activated (bool on)
  • void selected (const QPolygon &polygon)
  • void appended (const QPoint &pos)
  • void moved (const QPoint &pos)
  • void removed (const QPoint &pos)
  • void changed (const QPolygon &selection)

✨ Public Member Functions ✨

  • QwtPolarPicker (QwtPolarCanvas *) — Create a polar plot picker. 💖
  • virtual ~QwtPolarPicker () — Destructor. cleanup era 🧹
  • QwtPolarPicker (RubberBand rubberBand, DisplayMode trackerMode, QwtPolarCanvas *) — the overload with rubber band + tracker mode + canvas. 🎀
  • QwtPolarPlot * plot ()
  • const QwtPolarPlot * plot () const
  • QwtPolarCanvas * canvas ()
  • const QwtPolarCanvas * canvas () const
  • virtual QRect pickRect () const

Public Member Functions inherited from QwtPicker

  • QwtPicker (QWidget *parent)
  • QwtPicker (RubberBand rubberBand, DisplayMode trackerMode, QWidget *)
  • virtual ~QwtPicker () — Destructor. 🧹
  • void setStateMachine (QwtPickerMachine *)
  • const QwtPickerMachine * stateMachine () const
  • QwtPickerMachine * stateMachine ()
  • void setRubberBand (RubberBand)
  • RubberBand rubberBand () const
  • void setTrackerMode (DisplayMode) — Set the display mode of the tracker. periodt ✨
  • DisplayMode trackerMode () const
  • void setResizeMode (ResizeMode) — Set the resize mode. keep it cute 💅
  • ResizeMode resizeMode () const
  • void setRubberBandPen (const QPen &)
  • QPen rubberBandPen () const
  • void setTrackerPen (const QPen &)
  • QPen trackerPen () const
  • void setTrackerFont (const QFont &)
  • QFont trackerFont () const
  • bool isEnabled () const
  • bool isActive () const
  • virtual bool eventFilter (QObject *, QEvent *) override — Event filter. doing its lil filter thing 🎀
  • QWidget * parentWidget () — Return the parent widget, where the selection happens. 🫶
  • const QWidget * parentWidget () const — Return the parent widget, where the selection happens. 🫶
  • virtual void drawRubberBand (QPainter *) const
  • virtual void drawTracker (QPainter *) const
  • virtual QRegion trackerMask () const
  • virtual QRegion rubberBandMask () const
  • QPoint trackerPosition () const
  • virtual QRect trackerRect (const QFont &) const
  • QPolygon selection () const

Public Member Functions inherited from QwtEventPattern

  • QwtEventPattern ()
  • virtual ~QwtEventPattern () — Destructor. 🧹
  • void initMousePattern (int numButtons)
  • void initKeyPattern ()
  • void setMousePattern (MousePatternCode, Qt::MouseButton button, Qt::KeyboardModifiers=Qt::NoModifier)
  • void setKeyPattern (KeyPatternCode, int key, Qt::KeyboardModifiers modifiers=Qt::NoModifier)
  • void setMousePattern (const QVector< MousePattern > &) — Change the mouse event patterns. 🐭
  • void setKeyPattern (const QVector< KeyPattern > &) — Change the key event patterns. ⌨️
  • const QVector< MousePattern > & mousePattern () const
  • const QVector< KeyPattern > & keyPattern () const
  • QVector< MousePattern > & mousePattern ()
  • QVector< KeyPattern > & keyPattern ()
  • bool mouseMatch (MousePatternCode, const QMouseEvent *) const — Compare a mouse event with an event pattern. 🐭✨
  • bool keyMatch (KeyPatternCode, const QKeyEvent *) const — Compare a key event with an event pattern. ⌨️✨

🔒 Protected Member Functions 🔒

  • QwtPointPolar invTransform (const QPoint &) const
  • virtual QwtText trackerText (const QPoint &) const override
  • virtual QwtText trackerTextPolar (const QwtPointPolar &) const — Translate a position into a position string. cute lil conversion moment ✨
  • virtual void move (const QPoint &) override
  • virtual void append (const QPoint &) override
  • virtual bool end (bool ok=true) override

Protected Member Functions inherited from QwtPicker

  • virtual QPolygon adjustedPoints (const QPolygon &) const — Map the pickedPoints() into a selection(). glow-up from raw points to selection 💅
  • virtual void transition (const QEvent *)
  • virtual void begin ()
  • virtual void remove ()
  • virtual bool accept (QPolygon &) const — Validate and fix up the selection. quality control ✅
  • virtual void reset ()
  • virtual void widgetMousePressEvent (QMouseEvent *)
  • virtual void widgetMouseReleaseEvent (QMouseEvent *)
  • virtual void widgetMouseDoubleClickEvent (QMouseEvent *)
  • virtual void widgetMouseMoveEvent (QMouseEvent *)
  • virtual void widgetWheelEvent (QWheelEvent *)
  • virtual void widgetKeyPressEvent (QKeyEvent *)
  • virtual void widgetKeyReleaseEvent (QKeyEvent *)
  • virtual void widgetEnterEvent (QEvent *)
  • virtual void widgetLeaveEvent (QEvent *)
  • virtual void stretchSelection (const QSize &oldSize, const QSize &newSize)
  • virtual void updateDisplay () — Update the state of rubber band and tracker label. 🎀
  • const QwtWidgetOverlay * rubberBandOverlay () const
  • const QwtWidgetOverlay * trackerOverlay () const
  • const QPolygon & pickedPoints () const
  • QRect trackerRect (const QSize &) const

Protected Member Functions inherited from QwtEventPattern

  • virtual bool mouseMatch (const MousePattern &, const QMouseEvent *) const — Compare a mouse event with an event pattern. 🐭
  • virtual bool keyMatch (const KeyPattern &, const QKeyEvent *) const — Compare a key event with an event pattern. ⌨️

🙈 Private Member Functions 🙈

  • virtual QPainterPath pickArea () const override

🌈 Additional Inherited Members 🌈

Public Types inherited from QwtPicker

  • enum RubberBand — { NoRubberBand = 0, HLineRubberBand, VLineRubberBand, CrossRubberBand, RectRubberBand, EllipseRubberBand, PolygonRubberBand, UserRubberBand = 100 }
  • enum DisplayMode — { AlwaysOff, AlwaysOn, ActiveOnly } — Display mode. 👀
  • enum ResizeMode — { Stretch, KeepSize }

Public Types inherited from QwtEventPattern

  • enum MousePatternCode — { MouseSelect1, MouseSelect2, MouseSelect3, MouseSelect4, MouseSelect5, MouseSelect6, MousePatternCount } — Symbolic mouse input codes. 🐭
  • enum KeyPatternCode — { KeySelect1, KeySelect2, KeyAbort, KeyLeft, KeyRight, KeyUp, KeyDown, KeyRedo, KeyUndo, KeyHome, KeyPatternCount } — Symbolic keyboard input codes. ⌨️

Public Slots inherited from QwtPicker

  • void setEnabled (bool) — En/disable the picker. 🔘

🌟 Detailed Description 🌟

QwtPolarPicker provides selections on a plot canvas. 💖

QwtPolarPicker is a QwtPicker tailored for selections on a polar plot canvas. like, it's literally the polar-plot picker bestie ✨

Definition at line 28 of file qwt_polar_picker.h.

🎀 Constructor & Destructor Documentation 🎀

QwtPolarPicker::QwtPolarPicker (QwtPolarCanvas * canvas) [explicit]

Create a polar plot picker. 💅

Parameters

  • canvas — Plot canvas to observe, also the parent object. it's both, bestie 👀

Definition at line 25 of file qwt_polar_picker.cpp.

QwtPolarPicker::~QwtPolarPicker () [virtual]

Destructor. cleanup era 🧹

Definition at line 51 of file qwt_polar_picker.cpp.

QwtPolarPicker::QwtPolarPicker (RubberBand rubberBand, DisplayMode trackerMode, QwtPolarCanvas * canvas) [explicit]

Create a plot picker 🌸

Parameters

  • rubberBand — Rubberband style. the aesthetic 🎀
  • trackerMode — Tracker mode. 📡
  • canvas — Plot canvas to observe, also the parent object. both again, no cap 👀

See also

  • QwtPicker
  • QwtPicker::setSelectionFlags()
  • QwtPicker::setRubberBand()
  • QwtPicker::setTrackerMode
  • QwtPolarPlot::autoReplot()
  • QwtPolarPlot::replot()
  • scaleRect()

Definition at line 43 of file qwt_polar_picker.cpp.

💖 Member Function Documentation 💖

okay bestie, this is the part where we meet literally every member function one by one. no skipping, no cap 🫶

🌸 void QwtPolarPicker::append(const QPoint &pos) — [override], [protected], [virtual]

Adds another point to the selection and refreshes the rubberband and the tracker at the same time. multitasking icon behavior ✨

Parameters

  • pos — the additional point, bestie

See also: isActive, begin(), end(), move(), appended()

Note: the appended(const QPoint &) and appended(const QDoublePoint &) signals get emitted. both of them. yeah. 💅

Reimplemented from QwtPicker.

Definition at line 128 of file qwt_polar_picker.cpp.

🎀 void QwtPolarPicker::appended(const QwtPointPolar &pos) — [signal]

A signal that fires when a point has been appended to the selection. it's giving "new point just dropped" energy 😭

Parameters

  • pos — position of the appended point

See also: append(), moved()

🦋 QwtPolarCanvas *QwtPolarPicker::canvas()

Returns: the observed plot canvas — that's the canvas we're watching, periodt 👑

Definition at line 56 of file qwt_polar_picker.cpp.

⭐ const QwtPolarCanvas *QwtPolarPicker::canvas() const

same thing but const, because sometimes you just need to look and not touch 🙈

Returns: the observed plot canvas

Definition at line 62 of file qwt_polar_picker.cpp.

💜 bool QwtPolarPicker::end(bool ok = true) — [override], [protected], [virtual]

Closes out a selection and flips the state to inactive. like ending a call, but for picking 🎬

Parameters

  • ok — if true, complete the selection and emit the selected signals; otherwise discard the selection completely

Returns: true if the selection is accepted, false otherwise

Reimplemented from QwtPicker.

Definition at line 157 of file qwt_polar_picker.cpp.

🌈 QwtPointPolar QwtPolarPicker::invTransform(const QPoint &pos) const — [protected]

Translates a point from widget coordinates into plot coordinates. glow-up for your coordinates, honestly ✨

Parameters

  • pos — point in widget coordinates of the plot canvas

Returns: point in plot coordinates

See also: transform(), canvas()

Definition at line 208 of file qwt_polar_picker.cpp.

🔥 void QwtPolarPicker::move(const QPoint &pos) — [override], [protected], [virtual]

Moves the last point of the selection to a new spot. main character point energy, everyone else stays put 💅

Parameters

  • pos — new position

See also: isActive, begin(), end(), append()

Note: the moved(const QPoint &) and moved(const QDoublePoint &) signals get emitted.

Reimplemented from QwtPicker.

Definition at line 143 of file qwt_polar_picker.cpp.

🍓 void QwtPolarPicker::moved(const QwtPointPolar &pos) — [signal]

A signal that fires whenever the last appended point of the selection has been moved. yes it's a whole vibe check on the last point 😌

Parameters

  • pos — position of the moved last point of the selection

See also: move(), appended()

🧚 QPainterPath QwtPolarPicker::pickArea() const — [override], [private], [virtual]

Finds the area of the observed widget where a selection might actually happen. the designated picking zone, iykyk 🎯

Returns: parentWidget()->contentsRect()

Reimplemented from QwtPicker.

Definition at line 229 of file qwt_polar_picker.cpp.

🌸 QRect QwtPolarPicker::pickRect() const — [virtual]

Returns: the bounding rectangle of the region where picking is supported — like the map boundaries of the pick-able world, fr fr 🗺️

Definition at line 221 of file qwt_polar_picker.cpp.

👑 QwtPolarPlot *QwtPolarPicker::plot()

Returns: the plot widget that contains the observed plot canvas

Definition at line 68 of file qwt_polar_picker.cpp.

🦋 const QwtPolarPlot *QwtPolarPicker::plot() const

same plot widget, but const-flavored 🍨

Returns: plot widget containing the observed plot canvas

Definition at line 78 of file qwt_polar_picker.cpp.

💖 void QwtPolarPicker::selected(const QVector<QwtPointPolar> &points) — [signal]

A signal that emits all the selected points, at the end of a selection. the grand finale of selection signals 🎆

Parameters

  • points — the selected points

💫 void QwtPolarPicker::selected(const QwtPointPolar &pos) — [signal]

A signal that's emitted in the case of selectionFlags() & PointSelection. yes, that exact expression. no cap 💅

Parameters

  • pos — the selected point

🌟 QwtText QwtPolarPicker::trackerText(const QPoint &pos) const — [override], [protected], [virtual]

Translates a pixel position into a position string. pixel-to-text pipeline, slay ✨

Parameters

  • pos — position in pixel coordinates

Returns: position string

Reimplemented from QwtPicker.

Definition at line 93 of file qwt_polar_picker.cpp.

🎀 QwtText QwtPolarPicker::trackerTextPolar(const QwtPointPolar &pos) const — [protected], [virtual]

Translates a position into a position string. and the formatting rules are very specific, so listen up bestie:

  • in the case of HLineRubberBand, the label is the value of the y position
  • in the case of VLineRubberBand, the label is the value of the x position
  • otherwise, the label contains the x and y position separated by a ','

The format for the double-to-string conversion is "%.4f". four decimal places or it doesn't count 🔢

Parameters

  • pos — position

Returns: position string

Definition at line 111 of file qwt_polar_picker.cpp.

🌈 Author 🌈

Generated automatically by Doxygen for Qwt User's Guide from the source code. yeah, a robot wrote the credits, not me 💀

and that's the whole page, bestie! 🫶 this whole thing came straight from the Qwt User's Guide, filed under QwtPolarPicker(3) — you're welcome, go pick some points responsibly 💅✨

📦 where this page comes from