/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2016 CERN * Copyright (C) 2016-2021 KiCad Developers, see AUTHORS.txt for contributors. * * @author Tomasz Wlostowski * @author Maciej Suminski * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 3 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * https://www.gnu.org/licenses/gpl-3.0.html * or you may search the http://www.gnu.org website for the version 3 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #ifndef __SIM_PLOT_PANEL_H #define __SIM_PLOT_PANEL_H #include "sim_types.h" #include #include #include #include #include "sim_panel_base.h" #include "sim_plot_colors.h" class SIM_PLOT_FRAME; class SIM_PLOT_PANEL; class TRACE; ///< Cursor attached to a trace to follow its values: class CURSOR : public mpInfoLayer { public: CURSOR( const TRACE* aTrace, SIM_PLOT_PANEL* aPlotPanel ) : mpInfoLayer( wxRect( 0, 0, DRAG_MARGIN, DRAG_MARGIN ), wxTRANSPARENT_BRUSH ), m_trace( aTrace ), m_updateRequired( true ), m_updateRef( false ), m_coords( 0.0, 0.0 ), m_window( nullptr ) { SetDrawOutsideMargins( false ); } void Plot( wxDC& aDC, mpWindow& aWindow ) override; void SetX( int aX ) { m_reference.x = 0; m_updateRef = true; Move( wxPoint( aX, 0 ) ); } void Update() { m_updateRequired = true; } bool Inside( wxPoint& aPoint ) override; void Move( wxPoint aDelta ) override { Update(); mpInfoLayer::Move( aDelta ); } void UpdateReference() override; const wxRealPoint& GetCoords() const { return m_coords; } private: const TRACE* m_trace; bool m_updateRequired, m_updateRef; wxRealPoint m_coords; mpWindow* m_window; static constexpr int DRAG_MARGIN = 10; }; class TRACE : public mpFXYVector { public: TRACE( const wxString& aName, SIM_PLOT_TYPE aType ) : mpFXYVector( aName ), m_cursor( nullptr ), m_type( aType ) { SetContinuity( true ); SetDrawOutsideMargins( false ); ShowName( false ); } /** * Assigns new data set for the trace. aX and aY need to have the same length. * * @param aX are the X axis values. * @param aY are the Y axis values. */ void SetData( const std::vector& aX, const std::vector& aY ) override { if( m_cursor ) m_cursor->Update(); mpFXYVector::SetData( aX, aY ); } const std::vector& GetDataX() const { return m_xs; } const std::vector& GetDataY() const { return m_ys; } bool HasCursor() const { return m_cursor != nullptr; } void SetCursor( CURSOR* aCursor ) { m_cursor = aCursor; } CURSOR* GetCursor() const { return m_cursor; } SIM_PLOT_TYPE GetType() const { return m_type; } void SetTraceColour( wxColour aColour ) { m_traceColour = aColour; } wxColour GetTraceColour() { return m_traceColour; } const wxString& GetParam() const { return m_param; } protected: CURSOR* m_cursor; SIM_PLOT_TYPE m_type; wxColour m_traceColour; private: ///< Name of the signal parameter wxString m_param; }; class SIM_PLOT_PANEL : public SIM_PANEL_BASE { friend class SIM_WORKBOOK; public: SIM_PLOT_PANEL( const wxString& aCommand, int aOptions, wxWindow* parent, SIM_PLOT_FRAME* aMainFrame, wxWindowID id, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, long style = 0, const wxString& name = wxPanelNameStr ); virtual ~SIM_PLOT_PANEL(); ///< set the pointer to the sim plot frame void SetMasterFrame( SIM_PLOT_FRAME* aFrame ) { m_masterFrame = aFrame; } wxString GetLabelX() const { return m_axis_x ? m_axis_x->GetName() : ""; } wxString GetLabelY1() const { return m_axis_y1 ? m_axis_y1->GetName() : ""; } wxString GetLabelY2() const { return m_axis_y2 ? m_axis_y2->GetName() : ""; } bool TraceShown( const wxString& aName ) const { return m_traces.count( aName ) > 0; } const std::map& GetTraces() const { return m_traces; } TRACE* GetTrace( const wxString& aName ) const { auto trace = m_traces.find( aName ); return trace == m_traces.end() ? nullptr : trace->second; } void ShowGrid( bool aEnable ) { m_axis_x->SetTicks( !aEnable ); m_axis_y1->SetTicks( !aEnable ); m_axis_y2->SetTicks( !aEnable ); m_plotWin->UpdateAll(); } bool IsGridShown() const { if( !m_axis_x || !m_axis_y1 ) return false; assert( m_axis_x->GetTicks() == m_axis_y1->GetTicks() ); return !m_axis_x->GetTicks(); } void ShowLegend( bool aEnable ) { m_legend->SetVisible( aEnable ); m_plotWin->UpdateAll(); } bool IsLegendShown() const { return m_legend->IsVisible(); } void SetDottedCurrentPhase( bool aEnable ) { m_dotted_cp = aEnable; for( const auto& tr : m_traces ) { UpdateTraceStyle( tr.second ); } m_plotWin->UpdateAll(); } bool GetDottedCurrentPhase() const { return m_dotted_cp; } ///< Toggle cursor for a particular trace. void EnableCursor( const wxString& aName, bool aEnable ); ///< Reset scale ranges to fit the current traces. void ResetScales(); ///< Update trace line style void UpdateTraceStyle( TRACE* trace ); ///> Update plot colors void UpdatePlotColors(); ///< Getter for math plot window mpWindow* GetPlotWin() const { return m_plotWin; } protected: bool addTrace( const wxString& aTitle, const wxString& aName, int aPoints, const double* aX, const double* aY, SIM_PLOT_TYPE aType ); bool deleteTrace( const wxString& aName ); private: ///< @brief Construct the plot axes for DC simulation plot. void prepareDCAxes(); ///> Create/Ensure axes are available for plotting void updateAxes(); SIM_PLOT_COLORS m_colors; // Top-level plot window mpWindow* m_plotWin; wxBoxSizer* m_sizer; // Traces to be plotted std::map m_traces; mpScaleXBase* m_axis_x; mpScaleY* m_axis_y1; mpScaleY* m_axis_y2; mpInfoLegend* m_legend; bool m_dotted_cp; std::vector m_topLevel; SIM_PLOT_FRAME* m_masterFrame; }; wxDECLARE_EVENT( EVT_SIM_CURSOR_UPDATE, wxCommandEvent ); #endif