KiCad PCB EDA Suite
Loading...
Searching...
No Matches
CURSOR Class Reference

The SIMULATOR_FRAME holds the main user-interface for running simulations. More...

#include <sim_plot_panel.h>

Inheritance diagram for CURSOR:
mpInfoLayer mpLayer

Public Member Functions

 CURSOR (TRACE *aTrace, SIM_PLOT_PANEL *aPlotPanel)
 
void Plot (wxDC &aDC, mpWindow &aWindow) override
 Plot method. More...
 
void SetX (int aX)
 
void Update ()
 
bool Inside (const wxPoint &aPoint) const override
 Checks whether a point is inside the info box rectangle. More...
 
void Move (wxPoint aDelta) override
 Moves the layer rectangle of given pixel deltas. More...
 
void UpdateReference () override
 Updates the rectangle reference point. More...
 
const wxRealPoint & GetCoords () const
 
void SetCoordX (double aValue)
 
virtual void UpdateInfo (mpWindow &w, wxEvent &event)
 Updates the content of the info box. More...
 
virtual bool HasBBox () const override
 mpInfoLayer has not bounding box. More...
 
virtual bool IsInfo () const override
 Specifies that this is an Info box layer. More...
 
wxPoint GetPosition () const
 Returns the position of the upper left corner of the box (in pixels) More...
 
wxSize GetSize () const
 Returns the size of the box (in pixels) More...
 
const wxRect & GetRectangle () const
 Returns the current rectangle coordinates. More...
 
virtual double GetMinX () const
 Get inclusive left border of bounding box. More...
 
virtual double GetMaxX () const
 Get inclusive right border of bounding box. More...
 
virtual double GetMinY () const
 Get inclusive bottom border of bounding box. More...
 
virtual double GetMaxY () const
 Get inclusive top border of bounding box. More...
 
const wxString & GetName () const
 Get layer name. More...
 
const wxString & GetDisplayName () const
 
const wxFont & GetFont () const
 Get font set for this layer. More...
 
const wxPen & GetPen () const
 Get pen set for this layer. More...
 
void SetContinuity (bool continuity)
 Set the 'continuity' property of the layer (true:draws a continuous line, false:draws separate points). More...
 
bool GetContinuity () const
 Gets the 'continuity' property of the layer. More...
 
void ShowName (bool show)
 Shows or hides the text label with the name of the layer (default is visible). More...
 
virtual void SetName (const wxString &name)
 Set layer name. More...
 
void SetFont (wxFont &font)
 Set layer font. More...
 
void SetPen (wxPen pen)
 Set layer pen. More...
 
void SetDrawOutsideMargins (bool drawModeOutside)
 Set Draw mode: inside or outside margins. More...
 
bool GetDrawOutsideMargins ()
 Get Draw mode: inside or outside margins. More...
 
wxBitmap GetColourSquare (int side=16) const
 Get a small square bitmap filled with the colour of the pen used in the layer. More...
 
mpLayerType GetLayerType () const
 Get layer type: a Layer can be of different types: plot lines, axis, info boxes, etc, this method returns the right value. More...
 
bool IsVisible () const
 Checks whether the layer is visible or not. More...
 
void SetVisible (bool show)
 Sets layer visibility. More...
 
const wxBrush & GetBrush () const
 Get brush set for this layer. More...
 
void SetBrush (wxBrush brush)
 Set layer brush. More...
 

Protected Attributes

wxRect m_dim
 
wxPoint m_reference
 
wxBrush m_brush
 
int m_winX
 
int m_winY
 
wxFont m_font
 
wxPen m_pen
 
wxString m_name
 
wxString m_displayName
 
bool m_continuous
 
bool m_showName
 
bool m_drawOutsideMargins
 
mpLayerType m_type
 
bool m_visible
 

Private Member Functions

void doSetCoordX (double aValue)
 
wxString getID ()
 

Private Attributes

TRACEm_trace
 
bool m_updateRequired
 
bool m_updateRef
 
wxRealPoint m_coords
 
mpWindowm_window
 

Static Private Attributes

static constexpr int DRAG_MARGIN = 10
 

Detailed Description

The SIMULATOR_FRAME holds the main user-interface for running simulations.

It contains a workbook with multiple tabs, each tab holding a SIM_PLOT_PANEL, a specific simulation command (.TRAN, .AC, etc.), and simulation settings (save all currents, etc.).

Each plot can have multiple TRACEs. While internally each TRACE can have multiple cursors, the GUI supports only two cursors (and a differential cursor) for each plot.

TRACEs are identified by a signal (V(OUT), I(R2), etc.) and a type (SPT_VOLTAGE, SPT_AC_PHASE, etc.).

The simulator outputs simple signals in a vector of the same name. Complex signals (such as V(OUT) / V(IN)) are stored in vectors of the format "user%d". < Cursor attached to a trace to follow its values:

Definition at line 63 of file sim_plot_panel.h.

Constructor & Destructor Documentation

◆ CURSOR()

CURSOR::CURSOR ( TRACE aTrace,
SIM_PLOT_PANEL aPlotPanel 
)
inline

Definition at line 66 of file sim_plot_panel.h.

References mpLayer::SetDrawOutsideMargins().

Member Function Documentation

◆ doSetCoordX()

void CURSOR::doSetCoordX ( double  aValue)
private

Definition at line 225 of file sim_plot_panel.cpp.

References TRACE::GetDataX(), TRACE::GetDataY(), m_coords, and m_trace.

Referenced by Plot(), and SetCoordX().

◆ GetBrush()

const wxBrush & mpLayer::GetBrush ( ) const
inlineinherited

Get brush set for this layer.

Returns
brush.

Definition at line 315 of file mathplot.h.

◆ GetColourSquare()

wxBitmap mpLayer::GetColourSquare ( int  side = 16) const
inherited

Get a small square bitmap filled with the colour of the pen used in the layer.

Useful to create legends or similar reference to the layers.

Parameters
sideside length in pixels
Returns
a wxBitmap filled with layer's colour

Definition at line 76 of file mathplot.cpp.

References mpLayer::m_pen, and square().

◆ GetContinuity()

bool mpLayer::GetContinuity ( ) const
inlineinherited

Gets the 'continuity' property of the layer.

See also
SetContinuity

Definition at line 267 of file mathplot.h.

◆ GetCoords()

const wxRealPoint & CURSOR::GetCoords ( ) const
inline

◆ GetDisplayName()

const wxString & mpLayer::GetDisplayName ( ) const
inlineinherited

Definition at line 244 of file mathplot.h.

Referenced by mpInfoLegend::Plot().

◆ GetDrawOutsideMargins()

bool mpLayer::GetDrawOutsideMargins ( )
inlineinherited

Get Draw mode: inside or outside margins.

Returns
The draw mode

Definition at line 294 of file mathplot.h.

◆ GetFont()

const wxFont & mpLayer::GetFont ( ) const
inlineinherited

Get font set for this layer.

Returns
Font

Definition at line 252 of file mathplot.h.

◆ getID()

wxString CURSOR::getID ( )
private

Definition at line 264 of file sim_plot_panel.cpp.

References _, cursor, TRACE::GetCursors(), and m_trace.

Referenced by Plot().

◆ GetLayerType()

mpLayerType mpLayer::GetLayerType ( ) const
inlineinherited

Get layer type: a Layer can be of different types: plot lines, axis, info boxes, etc, this method returns the right value.

Returns
An integer indicating layer type

Definition at line 303 of file mathplot.h.

Referenced by mpInfoLegend::Plot().

◆ GetMaxX()

virtual double mpLayer::GetMaxX ( ) const
inlinevirtualinherited

Get inclusive right border of bounding box.

Returns
Value

Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.

Definition at line 184 of file mathplot.h.

Referenced by mpFXY::UpdateScales().

◆ GetMaxY()

virtual double mpLayer::GetMaxY ( ) const
inlinevirtualinherited

Get inclusive top border of bounding box.

Returns
Value

Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.

Definition at line 194 of file mathplot.h.

Referenced by mpFXY::UpdateScales().

◆ GetMinX()

virtual double mpLayer::GetMinX ( ) const
inlinevirtualinherited

Get inclusive left border of bounding box.

Returns
Value

Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.

Definition at line 179 of file mathplot.h.

Referenced by mpFXY::UpdateScales().

◆ GetMinY()

virtual double mpLayer::GetMinY ( ) const
inlinevirtualinherited

Get inclusive bottom border of bounding box.

Returns
Value

Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.

Definition at line 189 of file mathplot.h.

Referenced by mpFXY::UpdateScales().

◆ GetName()

const wxString & mpLayer::GetName ( ) const
inlineinherited

◆ GetPen()

const wxPen & mpLayer::GetPen ( ) const
inlineinherited

Get pen set for this layer.

Returns
Pen

Definition at line 257 of file mathplot.h.

Referenced by Plot(), mpInfoLegend::Plot(), and SIMULATOR_FRAME::rebuildSignalsGrid().

◆ GetPosition()

wxPoint mpInfoLayer::GetPosition ( ) const
inherited

Returns the position of the upper left corner of the box (in pixels)

Returns
The rectangle position

Definition at line 190 of file mathplot.cpp.

References mpInfoLayer::m_dim.

Referenced by SIM_PLOT_PANEL::GetLegendPosition().

◆ GetRectangle()

const wxRect & mpInfoLayer::GetRectangle ( ) const
inlineinherited

Returns the current rectangle coordinates.

Returns
The info layer rectangle

Definition at line 403 of file mathplot.h.

◆ GetSize()

wxSize mpInfoLayer::GetSize ( ) const
inherited

Returns the size of the box (in pixels)

Returns
The rectangle size

Definition at line 196 of file mathplot.cpp.

References mpInfoLayer::m_dim.

◆ HasBBox()

virtual bool mpInfoLayer::HasBBox ( ) const
inlineoverridevirtualinherited

mpInfoLayer has not bounding box.

See also
mpLayer::HasBBox
Returns
always false

Reimplemented from mpLayer.

Definition at line 368 of file mathplot.h.

◆ Inside()

bool CURSOR::Inside ( const wxPoint &  point) const
overridevirtual

Checks whether a point is inside the info box rectangle.

Parameters
pointThe point to be checked
Returns
true if the point is inside the bounding box

Reimplemented from mpInfoLayer.

Definition at line 357 of file sim_plot_panel.cpp.

References std::abs(), DRAG_MARGIN, m_coords, m_trace, m_window, mpWindow::x2p(), mpFXY::x2s(), mpWindow::y2p(), and mpFXY::y2s().

◆ IsInfo()

virtual bool mpInfoLayer::IsInfo ( ) const
inlineoverridevirtualinherited

Specifies that this is an Info box layer.

Returns
always true
See also
mpLayer::IsInfo

Reimplemented from mpLayer.

Definition at line 379 of file mathplot.h.

◆ IsVisible()

bool mpLayer::IsVisible ( ) const
inlineinherited

Checks whether the layer is visible or not.

Returns
true if visible

Definition at line 307 of file mathplot.h.

Referenced by mpWindow::IsLayerVisible(), SIM_PLOT_PANEL::IsLegendShown(), and mpInfoLegend::Plot().

◆ Move()

void CURSOR::Move ( wxPoint  delta)
inlineoverridevirtual

Moves the layer rectangle of given pixel deltas.

Parameters
deltaThe wxPoint container for delta coordinates along x and y. Units are in pixels.

Reimplemented from mpInfoLayer.

Definition at line 93 of file sim_plot_panel.h.

References mpInfoLayer::Move(), and Update().

Referenced by SetX().

◆ Plot()

◆ SetBrush()

void mpLayer::SetBrush ( wxBrush  brush)
inlineinherited

Set layer brush.

Parameters
brushbrush, will be copied to internal class member

Definition at line 319 of file mathplot.h.

◆ SetContinuity()

void mpLayer::SetContinuity ( bool  continuity)
inlineinherited

Set the 'continuity' property of the layer (true:draws a continuous line, false:draws separate points).

See also
GetContinuity

Definition at line 262 of file mathplot.h.

Referenced by TRACE::TRACE().

◆ SetCoordX()

◆ SetDrawOutsideMargins()

void mpLayer::SetDrawOutsideMargins ( bool  drawModeOutside)
inlineinherited

Set Draw mode: inside or outside margins.

Default is outside, which allows the layer to draw up to the mpWindow border.

Parameters
drawModeOutsideThe draw mode to be set

Definition at line 290 of file mathplot.h.

Referenced by CURSOR(), and TRACE::TRACE().

◆ SetFont()

void mpLayer::SetFont ( wxFont &  font)
inlineinherited

Set layer font.

Parameters
fontFont, will be copied to internal class member

Definition at line 281 of file mathplot.h.

◆ SetName()

virtual void mpLayer::SetName ( const wxString &  name)
inlinevirtualinherited

Set layer name.

Parameters
nameName, will be copied to internal class member

Reimplemented in TRACE.

Definition at line 276 of file mathplot.h.

References name.

Referenced by SIM_PLOT_PANEL::prepareDCAxes(), TRACE::SetName(), and SIM_PLOT_PANEL::updateAxes().

◆ SetPen()

void mpLayer::SetPen ( wxPen  pen)
inlineinherited

Set layer pen.

Parameters
penPen, will be copied to internal class member

Definition at line 286 of file mathplot.h.

Referenced by SIM_PLOT_PANEL::UpdateTraceStyle().

◆ SetVisible()

void mpLayer::SetVisible ( bool  show)
inlineinherited

Sets layer visibility.

Parameters
showvisibility bool.

Definition at line 311 of file mathplot.h.

Referenced by mpWindow::SetLayerVisible(), SIM_PLOT_PANEL::ShowLegend(), and SIM_PLOT_PANEL::SIM_PLOT_PANEL().

◆ SetX()

void CURSOR::SetX ( int  aX)
inline

Definition at line 79 of file sim_plot_panel.h.

References mpInfoLayer::m_reference, m_updateRef, and Move().

◆ ShowName()

void mpLayer::ShowName ( bool  show)
inlineinherited

Shows or hides the text label with the name of the layer (default is visible).

Definition at line 271 of file mathplot.h.

Referenced by TRACE::TRACE().

◆ Update()

void CURSOR::Update ( )
inline

Definition at line 86 of file sim_plot_panel.h.

References m_updateRequired.

Referenced by Move().

◆ UpdateInfo()

void mpInfoLayer::UpdateInfo ( mpWindow w,
wxEvent &  event 
)
virtualinherited

Updates the content of the info box.

Should be overridden by derived classes. Update may behave in different ways according to the type of event which called it.

Parameters
wparent mpWindow from which to obtain information
eventThe event which called the update.

Reimplemented in mpInfoCoords, and mpInfoLegend.

Definition at line 124 of file mathplot.cpp.

◆ UpdateReference()

void CURSOR::UpdateReference ( )
overridevirtual

Updates the rectangle reference point.

Used by internal methods of mpWindow to correctly move mpInfoLayers.

Reimplemented from mpInfoLayer.

Definition at line 369 of file sim_plot_panel.cpp.

References m_coords, mpInfoLayer::m_reference, m_trace, m_window, mpWindow::x2p(), mpFXY::x2s(), mpWindow::y2p(), and mpFXY::y2s().

Referenced by Plot().

Member Data Documentation

◆ DRAG_MARGIN

constexpr int CURSOR::DRAG_MARGIN = 10
staticconstexprprivate

Definition at line 120 of file sim_plot_panel.h.

Referenced by Inside().

◆ m_brush

wxBrush mpInfoLayer::m_brush
protectedinherited

◆ m_continuous

bool mpLayer::m_continuous
protectedinherited

Definition at line 328 of file mathplot.h.

Referenced by Plot(), mpFXY::Plot(), and mpMovableObject::Plot().

◆ m_coords

wxRealPoint CURSOR::m_coords
private

Definition at line 117 of file sim_plot_panel.h.

Referenced by doSetCoordX(), GetCoords(), Inside(), Plot(), SetCoordX(), and UpdateReference().

◆ m_dim

◆ m_displayName

wxString mpLayer::m_displayName
protectedinherited

Definition at line 327 of file mathplot.h.

Referenced by TRACE::SetName().

◆ m_drawOutsideMargins

bool mpLayer::m_drawOutsideMargins
protectedinherited

◆ m_font

◆ m_name

wxString mpLayer::m_name
protectedinherited

◆ m_pen

◆ m_reference

wxPoint mpInfoLayer::m_reference
protectedinherited

◆ m_showName

bool mpLayer::m_showName
protectedinherited

◆ m_trace

TRACE* CURSOR::m_trace
private

Definition at line 114 of file sim_plot_panel.h.

Referenced by doSetCoordX(), getID(), Inside(), Plot(), SetCoordX(), and UpdateReference().

◆ m_type

mpLayerType mpLayer::m_type
protectedinherited

Definition at line 331 of file mathplot.h.

Referenced by mpInfoLayer::mpInfoLayer().

◆ m_updateRef

bool CURSOR::m_updateRef
private

Definition at line 116 of file sim_plot_panel.h.

Referenced by Plot(), SetCoordX(), and SetX().

◆ m_updateRequired

bool CURSOR::m_updateRequired
private

Definition at line 115 of file sim_plot_panel.h.

Referenced by Plot(), SetCoordX(), and Update().

◆ m_visible

◆ m_window

mpWindow* CURSOR::m_window
private

Definition at line 118 of file sim_plot_panel.h.

Referenced by Inside(), Plot(), SetCoordX(), and UpdateReference().

◆ m_winX

int mpInfoLayer::m_winX
protectedinherited

◆ m_winY

int mpInfoLayer::m_winY
protectedinherited

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