/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2019 Jean-Pierre Charras, jp.charras at wanadoo.fr * Copyright (C) 2009-2023 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 2 * 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: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #ifndef PANEL_SETUP_BOARD_STACKUP_H #define PANEL_SETUP_BOARD_STACKUP_H #include #include #include #include "panel_board_stackup_base.h" #include "board_stackup.h" #include "stackup_predefined_prms.h" #include "dielectric_material.h" class wxBitmapComboBox; class PANEL_SETUP_LAYERS; // A helper class to handle UI items managed by m_fgGridSizer // in PANEL_SETUP_BOARD_STACKUP // these items are shown or not in m_fgGridSizer, depending on // the enabled layers in the current board. // So we need to store the list of these UI items int m_fgGridSizer // row by row struct BOARD_STACKUP_ROW_UI_ITEM { BOARD_STACKUP_ITEM* m_Item; // The BOARD_STACKUP_ITEM managed by this BOARD_STACKUP_ROW_UI_ITEM int m_SubItem; // For multilayer dielectric, the index in sublayer list. // Must be >= 0 and < m_Item sublayer count. Used only for dielectic // 0 is the base list of parameters (always existing) bool m_isEnabled; // True if the row is in board // false if not (this row is not shown on the panel) wxStaticBitmap* m_Icon; // Color icon in first column (column 1) wxStaticText* m_LayerName; // string shown in column 2 wxControl* m_LayerTypeCtrl; // control shown in column 3 wxControl* m_MaterialCtrl; // control shown in column 4, with m_MaterialButt wxButton* m_MaterialButt; // control shown in column 4, with m_MaterialCtrl wxControl* m_ThicknessCtrl; // control shown in column 5 wxControl* m_ThicknessLockCtrl;// control shown in column 6 wxControl* m_ColorCtrl; // control shown in column 7 wxControl* m_EpsilonCtrl; // control shown in column 8 wxControl* m_LossTgCtrl; // control shown in column 9 COLOR4D m_UserColor; // User-specified color (if any) BOARD_STACKUP_ROW_UI_ITEM( BOARD_STACKUP_ITEM* aItem, int aSubItem = 1 ) : m_Item( aItem ), m_SubItem( aSubItem ), m_isEnabled( true ), m_Icon( nullptr ), m_LayerName( nullptr ), m_LayerTypeCtrl( nullptr ), m_MaterialCtrl( nullptr ), m_MaterialButt( nullptr ), m_ThicknessCtrl( nullptr ), m_ThicknessLockCtrl( nullptr ), m_ColorCtrl( nullptr ), m_EpsilonCtrl( nullptr ), m_LossTgCtrl( nullptr ) {} }; class PANEL_SETUP_BOARD_STACKUP : public PANEL_SETUP_BOARD_STACKUP_BASE { public: PANEL_SETUP_BOARD_STACKUP( wxWindow* aParentWindow, PCB_EDIT_FRAME* aFrame, PANEL_SETUP_LAYERS* aPanelLayers ); ~PANEL_SETUP_BOARD_STACKUP(); void ImportSettingsFrom( BOARD* aBoard ); /** Must be called if the copper layers count has changed * or solder mask, solder paste or silkscreen layers are * enabled or disabled * Rebuild the Layer Stack Panel if the new layer set differs * from the current layet set */ void OnLayersOptionsChanged( LSET aNewLayerSet ); /// @return the number of copper layers configured for the board stackup int GetCopperLayerCount() const; /// @return the BOARD_STACKUP_ITEM managed by the row aRow BOARD_STACKUP_ITEM* GetStackupItem( int aRow ); /// @return the BOARD_STACKUP_ITEM sublayermanaged by the row aRow int GetSublayerId( int aRow ); /// Return the color currently selected for the row aRow wxColor GetSelectedColor( int aRow ) const; // Called by wxWidgets: transfer current settings stored in m_stackup to the board bool TransferDataFromWindow() override; private: /** Creates a BOARD_STACKUP_ROW_UI_ITEM relative to the aStackupItem. * @return a BOARD_STACKUP_ROW_UI_ITEM filled with corresponding widgets * @param aRow is the row index in the row list * @param aStackupItem is the stackup item controlled by the created * BOARD_STACKUP_ROW_UI_ITEM. * @param aSublayerIdx is used only for BS_ITEM_TYPE_DIELECTRIC stackup items. * this is the index of the sublayer to used inside aStackupItem * (from 0 to sub layer count - 1) */ BOARD_STACKUP_ROW_UI_ITEM createRowData( int aRow, BOARD_STACKUP_ITEM* aStackupItem, int aSublayerIdx ); /** add a Spacer in m_fgGridSizer when a empty cell is needed */ wxControl* addSpacer(); /** add a control (a wxTextCtrl + a button) in m_fgGridSizer to select a material * @param aId is the wxControl id, used to know the event source * @param aMaterialName is the name of the currently selected material (can be null) * @param aUiRowItem is the BOARD_STACKUP_ROW_UI_ITEM to store the controls * created */ void addMaterialChooser( wxWindowID aId, const wxString * aMaterialName, BOARD_STACKUP_ROW_UI_ITEM& aUiRowItem ); /** Populate m_fgGridSizer with items to handle stackup parameters * This is a full list: * all copper layers and all tech layers that are supported by the stackup * items not in the current board stackup will be not shown, but they are * existing in list * @param aCreateInitialStackup = true to create a initial stackup list for the dialog * @param aRelinkStackup = true to re-link m_stackup to m_brdSettings * false to build the stackup panel from the existing stackup list. */ void buildLayerStackPanel( bool aCreateInitialStackup = false, bool aRelinkStackup = false ); /** Synchronize the full stackup shown in m_fgGridSizer according to the stackup of the * current board and optionally update the stackup params (thickness, color ... ) * @param aFullSync = true to update stackup params, false to only update the list * of shown items */ void synchronizeWithBoard( bool aFullSync ); /** Show or do not show items in m_fgGridSizer according to the stackup of the * current board. * The panel stackup stores all possible layers (because the number of layers is set * from an other panel), but only some of them must be actually shown on screen */ void showOnlyActiveLayers(); /** Populate m_fgGridSizer with items to handle stackup parameters * If previous items are in list, remove old items * New prms are added * must be called after adding or deleting a dielectric parameter set * @param aRelinkItems will recreate the links between m_stackup and m_brdSettings */ void rebuildLayerStackPanel( bool aRelinkItems = false ); /** Transfer current UI settings to m_stackup but not to the board */ bool transferDataFromUIToStackup(); /** * Updates the enabled copper layers when the dropdown is changed */ void updateCopperLayerCount(); /** * Recompute the board thickness and update the textbox * @return the computed value */ int computeBoardThickness(); /** * Set the widths of dielectric layers to sensible defaults * @param targetThickness target thickness of PCB in IU */ void setDefaultLayerWidths( int targetThickness ); void onColorSelected( wxCommandEvent& event ); void onMaterialChange( wxCommandEvent& event ); void onThicknessChange( wxCommandEvent& event ); void onExportToClipboard( wxCommandEvent& event ) override; void onAddDielectricLayer( wxCommandEvent& event ) override; void onRemoveDielectricLayer( wxCommandEvent& event ) override; void onRemoveDielUI( wxUpdateUIEvent& event ) override; void onCopperLayersSelCount( wxCommandEvent& event ) override; void onAdjustDielectricThickness( wxCommandEvent& event ) override; /** Update the icons color (swatches in first grid column) * @param aRow is the row (index in m_rowUiItemsList) that manages the icon to update. * if -1 all icons will be updated */ void updateIconColor( int aRow = -1 ); /** @return the color of the BOARD_STACKUP_ITEM at row aRow, * to draw a bitmap color according to the selected color * or the best default color (for dielectric or copper item) * @param aRow is the row index to find the color. */ wxColor getColorIconItem( int aRow ); /** creates a bitmap combobox to select a layer color * @return the created wxBitmapComboBox * @param aStackupItem = the BOARD_STACKUP_ITEM related to the bitmap combobox * (to set the user color, if any) * can be nullptr * @param aRow = the row index in the wxFlexGridSizer (used to build a wxWidget unique id) */ wxBitmapComboBox* createColorBox( BOARD_STACKUP_ITEM* aStackupItem, int aRow ); /** * disconnect event handlers connected to wxControl items found in list m_controlItemsList */ void disconnectEvents(); private: BOARD_STACKUP m_stackup; PANEL_SETUP_LAYERS* m_panelLayers; // The associated PANEL_SETUP_LAYERS, to know enabled // layers and copper layer names LSET m_enabledLayers; // The current enabled layers in this panel restricted // to allowed layers in stackup. (When this doesn't // match the enabled layers in PANEL_SETUP_LAYERS the // stackup is not up to date.) DIELECTRIC_SUBSTRATE_LIST m_delectricMatList; // List of currently available // dielectric materials DIELECTRIC_SUBSTRATE_LIST m_solderMaskMatList; // List of currently available // solder mask materials DIELECTRIC_SUBSTRATE_LIST m_silkscreenMatList; // List of currently available // solder mask materials std::vector m_rowUiItemsList; // List of items in m_fgGridSizer BOARD* m_board; BOARD_DESIGN_SETTINGS* m_brdSettings; PCB_EDIT_FRAME* m_frame; wxSize m_numericTextCtrlSize; // Best size for wxTextCtrls with units wxSize m_numericFieldsSize; // Best size for wxTextCtrls without units wxArrayString m_core_prepreg_choice; // Used to display the option list in dialog wxSize m_colorSwatchesSize; // Size of swatches in the wxBitmapComboBox. wxSize m_colorIconsSize; // Size of swatches in the grid (left column) std::vector m_controlItemsList; // List of ctrls (wxChoice, wxTextCtrl, etc.) // with added event handlers }; #endif // #ifndef PANEL_SETUP_BOARD_STACKUP_H