pcb_net_inspector_panel.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2024 KiCad Developers, see AUTHORS.txt for contributors.
 *
 * 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, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef PCB_NET_INSPECTOR_H
#define PCB_NET_INSPECTOR_H
 
#include <board.h>
#include <id.h>
#include <project/project_local_settings.h>
#include <widgets/net_inspector_panel.h>
 
#include <optional>
#include <vector>
 
class PCB_EDIT_FRAME;
class NETINFO_ITEM;
class BOARD;
class BOARD_ITEM;
class CN_ITEM;
class PCB_TRACK;
class EDA_COMBINED_MATCHER;
 
class PCB_NET_INSPECTOR_PANEL : public NET_INSPECTOR_PANEL, public BOARD_LISTENER
{
public:
    PCB_NET_INSPECTOR_PANEL( wxWindow* parent, PCB_EDIT_FRAME* aFrame );
    virtual ~PCB_NET_INSPECTOR_PANEL();
 
    virtual void OnParentSetupChanged() override;
 
    /*
     * BOARD_LISTENER implementation
     */
    virtual void OnBoardItemAdded( BOARD& aBoard, BOARD_ITEM* aBoardItem ) override;
    virtual void OnBoardItemsAdded( BOARD& aBoard, std::vector<BOARD_ITEM*>& aBoardItems ) override;
    virtual void OnBoardItemRemoved( BOARD& aBoard, BOARD_ITEM* aBoardItem ) override;
    virtual void OnBoardItemsRemoved( BOARD&                    aBoard,
                                      std::vector<BOARD_ITEM*>& aBoardItems ) override;
    virtual void OnBoardNetSettingsChanged( BOARD& aBoard ) override;
    virtual void OnBoardItemChanged( BOARD& aBoard, BOARD_ITEM* aBoardItem ) override;
    virtual void OnBoardItemsChanged( BOARD&                    aBoard,
                                      std::vector<BOARD_ITEM*>& aBoardItems ) override;
    virtual void OnBoardHighlightNetChanged( BOARD& aBoard ) override;
    virtual void OnBoardCompositeUpdate( BOARD& aBoard, std::vector<BOARD_ITEM*>& aAddedItems,
                                         std::vector<BOARD_ITEM*>& aRemovedItems,
                                         std::vector<BOARD_ITEM*>& aDeletedItems ) override;
    virtual void OnBoardChanged() override;
 
    virtual void OnShowPanel() override;
 
    virtual void SaveSettings() override;
 
protected:
    virtual void OnLanguageChangedImpl() override;
 
    /*
     * UI events
     */
    virtual void OnSearchTextChanged( wxCommandEvent& event ) override;
    virtual void OnConfigButton( wxCommandEvent& event ) override;
    void         OnExpandCollapseRow( wxCommandEvent& event );
    void         OnHeaderContextMenu( wxCommandEvent& event );
    void         OnNetsListContextMenu( wxDataViewEvent& event );
    void         OnNetsListItemActivated( wxDataViewEvent& event );
    void         OnColumnSorted( wxDataViewEvent& event );
 
private:
    /*
     * Helper methods for returning fornatted data
     */
    wxString formatNetCode( const NETINFO_ITEM* aNet ) const;
    wxString formatNetName( const NETINFO_ITEM* aNet ) const;
    wxString formatCount( unsigned int aValue ) const;
    wxString formatLength( int64_t aValue ) const;
 
    void generateShowHideColumnMenu( wxMenu* target );
 
    std::vector<CN_ITEM*> relevantConnectivityItems() const;
 
    bool netFilterMatches( NETINFO_ITEM* aNet, PANEL_NET_INSPECTOR_SETTINGS* cfg = nullptr ) const;
 
    void updateNet( NETINFO_ITEM* aNet );
 
    unsigned int calculateViaLength( const PCB_TRACK* ) const;
 
    void buildNetsList( bool rebuildColumns = false );
    void buildColumns();
    void setColumnWidths();
 
    void adjustListColumnSizes( PANEL_NET_INSPECTOR_SETTINGS* cfg );
 
    bool restoreSortColumn( int sortingColumnId, bool sortOrderAsc );
 
    wxDataViewColumn* getDisplayedColumnForModelField( int columnId );
 
    void generateReport();
 
    void highlightSelectedNets();
 
    void onUnitsChanged( wxCommandEvent& event );
    void onSettingsMenu( wxCommandEvent& event );
    void onItemContextMenu( wxCommandEvent& event );
    void onAddNet();
    void onRenameSelectedNet();
    void onDeleteSelectedNet();
    void onRemoveSelectedGroup();
    void onAddGroup();
    void onClearHighlighting();
 
    class LIST_ITEM;
 
    struct LIST_ITEM_NETCODE_CMP_LESS;
 
    struct LIST_ITEM_GROUP_NUMBER_CMP_LESS;
 
    using LIST_ITEM_ITER = std::vector<std::unique_ptr<LIST_ITEM>>::iterator;
    using LIST_ITEM_CONST_ITER = std::vector<std::unique_ptr<LIST_ITEM>>::const_iterator;
 
    std::unique_ptr<LIST_ITEM> buildNewItem( NETINFO_ITEM* aNet, unsigned int aPadCount,
                                             const std::vector<CN_ITEM*>& aCNItems );
 
    void updateDisplayedRowValues( const std::optional<LIST_ITEM_ITER>& aRow );
 
    // special zero-netcode item. Unconnected pads etc might use different
    // (dummy) NETINFO_ITEM. Redirect all of them to this item, which we get
    // from the board object in buildNetsList.
    NETINFO_ITEM* m_zero_netitem;
 
    /*
     * Current board and parent edit frame
     */
    BOARD*          m_brd = nullptr;
    PCB_EDIT_FRAME* m_frame = nullptr;
 
    class DATA_MODEL;
 
    /*
     * The bound data model to display
     */
    wxObjectDataPtr<DATA_MODEL> m_data_model;
    friend DATA_MODEL;
 
    /*
     * Status flags set during reporting and net rebuild operations
     */
    bool m_in_reporting = false;
    bool m_in_build_nets_list = false;
 
    /*
     * Status flags to indicate whether a board has been loaded in this control's
     * lifetime. Required as on PCB_EDIT_FRAME construction, there are multiple events
     * triggered which would usually result in saving settings and re-loading the board.
     * However, before the board loads the frame is in an inconsistent state: The project
     * settings are available, but the board is not yet loaded. This results in overwriting
     * settings calculated from an empty board. We do not save settings until the first
     * board load operation has occured.
     */
    bool m_board_loaded = false;
    bool m_board_loading = false;
 
    /*
     * Flags to indicate whether certain events should be disabled during programmatic updates
     */
    bool m_row_expanding = false;
    bool m_highlighting_nets = false;
 
    /*
     * Configuration flags - these are all persisted to the project storage
     */
    bool m_filter_by_net_name = true;
    bool m_filter_by_netclass = true;
    bool m_show_zero_pad_nets = false;
    bool m_show_unconnected_nets = false;
    bool m_group_by_netclass = false;
    bool m_group_by_constraint = false;
 
    int m_num_copper_layers = 0;
 
    std::vector<std::unique_ptr<EDA_COMBINED_MATCHER>> m_custom_group_rules;
 
    enum class CSV_COLUMN_DESC : int
    {
        CSV_NONE = 0,
        CSV_QUOTE = 1 << 0
    };
 
    struct COLUMN_DESC
    {
        COLUMN_DESC( unsigned aNum, PCB_LAYER_ID aLayer, const wxString& aDisp,
                     const wxString& aCsv, CSV_COLUMN_DESC aFlags, bool aHasUnits ) :
                num( aNum ),
                layer( aLayer ), display_name( aDisp ), csv_name( aCsv ), csv_flags( aFlags ),
                has_units( aHasUnits )
        {
        }
 
        unsigned int    num;
        PCB_LAYER_ID    layer;
        wxString        display_name;
        wxString        csv_name;
        CSV_COLUMN_DESC csv_flags;
        bool            has_units;
 
        operator unsigned int() const { return num; }
    };
 
    std::vector<COLUMN_DESC> m_columns;
 
    /*
     * Column static IDs. Used to refer to columns as use re-ordering can occur.
     */
    enum
    {
        COLUMN_NAME = 0,
        COLUMN_NETCLASS,
        COLUMN_TOTAL_LENGTH,
        COLUMN_VIA_COUNT,
        COLUMN_VIA_LENGTH,
        COLUMN_BOARD_LENGTH,
        COLUMN_PAD_DIE_LENGTH,
        COLUMN_PAD_COUNT,
        COLUMN_LAST_STATIC_COL = COLUMN_PAD_COUNT
    };
 
    /*
     * Popup menu item IDs
     */
    enum POPUP_MENU_OPTIONS
    {
        ID_ADD_NET = ID_POPUP_MENU_START,
        ID_RENAME_NET,
        ID_DELETE_NET,
        ID_ADD_GROUP,
        ID_GROUP_BY_CONSTRAINT,
        ID_GROUP_BY_NETCLASS,
        ID_FILTER_BY_NET_NAME,
        ID_FILTER_BY_NETCLASS,
        ID_REMOVE_SELECTED_GROUP,
        ID_REMOVE_GROUPS,
        ID_SHOW_ZERO_NET_PADS,
        ID_SHOW_UNCONNECTED_NETS,
        ID_GENERATE_REPORT,
        ID_HIGHLIGHT_SELECTED_NETS,
        ID_CLEAR_HIGHLIGHTING,
        ID_LAST_STATIC_MENU = ID_CLEAR_HIGHLIGHTING,
        ID_HIDE_COLUMN,
    };
};
 
#endif