panel_setup_tracks_and_vias.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2018-2023 KiCad Developers, see change_log.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
 */
 
 
#include <pcb_edit_frame.h>
#include <board_design_settings.h>
#include <bitmaps.h>
#include <widgets/wx_grid.h>
#include <widgets/std_bitmap_button.h>
#include <grid_tricks.h>
 
#include <panel_setup_tracks_and_vias.h>
 
 
enum TRACK_VAR_GRID_COLUMNS
{
 TR_WIDTH_COL = 0
};
 
enum VIA_VAR_GRID_COLUMNS
{
 VIA_SIZE_COL = 0,
 VIA_DRILL_COL
};
 
enum DIFF_VAR_GRID_COLUMNS
{
 DP_WIDTH_COL = 0,
 DP_GAP_COL,
 DP_VIA_GAP_COL
};
 
 
PANEL_SETUP_TRACKS_AND_VIAS::PANEL_SETUP_TRACKS_AND_VIAS( wxWindow* aParentWindow,
 PCB_EDIT_FRAME* aFrame ) :
 PANEL_SETUP_TRACKS_AND_VIAS_BASE( aParentWindow )
{
 m_Frame = aFrame;
 m_Pcb = m_Frame->GetBoard();
 m_BrdSettings = &m_Pcb->GetDesignSettings();
 
 m_trackWidthsAddButton->SetBitmap( KiBitmap( BITMAPS::small_plus ) );
 m_trackWidthsSortButton->SetBitmap( KiBitmap( BITMAPS::small_sort_desc ) );
 m_trackWidthsRemoveButton->SetBitmap( KiBitmap( BITMAPS::small_trash ) );
 m_viaSizesAddButton->SetBitmap( KiBitmap( BITMAPS::small_plus ) );
 m_viaSizesSortButton->SetBitmap( KiBitmap( BITMAPS::small_sort_desc ) );
 m_viaSizesRemoveButton->SetBitmap( KiBitmap( BITMAPS::small_trash ) );
 m_diffPairsAddButton->SetBitmap( KiBitmap( BITMAPS::small_plus ) );
 m_diffPairsSortButton->SetBitmap( KiBitmap( BITMAPS::small_sort_desc ) );
 m_diffPairsRemoveButton->SetBitmap( KiBitmap( BITMAPS::small_trash ) );
 
 // Membership combobox editors require a bit more room, so increase the row size of
 // all our grids for consistency
 m_trackWidthsGrid->SetDefaultRowSize( m_trackWidthsGrid->GetDefaultRowSize() + 4 );
 m_viaSizesGrid->SetDefaultRowSize( m_viaSizesGrid->GetDefaultRowSize() + 4 );
 m_diffPairsGrid->SetDefaultRowSize( m_diffPairsGrid->GetDefaultRowSize() + 4 );
 
 m_trackWidthsGrid->PushEventHandler( new GRID_TRICKS( m_trackWidthsGrid,
 [this]( wxCommandEvent& aEvent )
 {
 OnAddTrackWidthsClick( aEvent );
 } ) );
 m_viaSizesGrid->PushEventHandler( new GRID_TRICKS( m_viaSizesGrid,
 [this]( wxCommandEvent& aEvent )
 {
 OnAddViaSizesClick( aEvent );
 } ) );
 m_diffPairsGrid->PushEventHandler( new GRID_TRICKS( m_diffPairsGrid,
 [this]( wxCommandEvent& aEvent )
 {
 OnAddDiffPairsClick( aEvent );
 } ) );
 
 m_trackWidthsGrid->SetSelectionMode( wxGrid::wxGridSelectionModes::wxGridSelectRows );
 m_viaSizesGrid->SetSelectionMode( wxGrid::wxGridSelectionModes::wxGridSelectRows );
 m_diffPairsGrid->SetSelectionMode( wxGrid::wxGridSelectionModes::wxGridSelectRows );
 
 m_trackWidthsGrid->SetUnitsProvider( m_Frame );
 m_viaSizesGrid->SetUnitsProvider( m_Frame );
 m_diffPairsGrid->SetUnitsProvider( m_Frame );
 
 m_trackWidthsGrid->SetAutoEvalCols( { 0 } );
 m_viaSizesGrid->SetAutoEvalCols( { 0, 1 } );
 m_diffPairsGrid->SetAutoEvalCols( { 0, 1, 2 } );
 
 // Ensure width of columns is enough to enter any reasonable value
 WX_GRID* grid_list[] = { m_trackWidthsGrid, m_viaSizesGrid, m_diffPairsGrid, nullptr };
 int min_linesize = m_trackWidthsGrid->GetTextExtent( wxT( "000.000000 mm " ) ).x;
 
 for( int ii = 0; grid_list[ii]; ii++ )
 {
 WX_GRID* curr_grid = grid_list[ii];
 
 for( int col = 0; col < curr_grid->GetNumberCols(); col++ )
 {
 int min_w = curr_grid->GetVisibleWidth( col, true, true, true );
 int best_w = std::max( min_linesize, min_w );
 curr_grid->SetColMinimalWidth( col, best_w );
 curr_grid->SetColSize( col,best_w );
 }
 }
 
 m_Frame->Bind( EDA_EVT_UNITS_CHANGED, &PANEL_SETUP_TRACKS_AND_VIAS::onUnitsChanged, this );
}
 
 
PANEL_SETUP_TRACKS_AND_VIAS::~PANEL_SETUP_TRACKS_AND_VIAS()
{
 // Delete the GRID_TRICKS.
 m_trackWidthsGrid->PopEventHandler( true );
 m_viaSizesGrid->PopEventHandler( true );
 m_diffPairsGrid->PopEventHandler( true );
 
 m_Frame->Unbind( EDA_EVT_UNITS_CHANGED, &PANEL_SETUP_TRACKS_AND_VIAS::onUnitsChanged, this );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnSortTrackWidthsClick( wxCommandEvent& aEvent )
{
 std::vector<int> trackWidths;
 wxString msg;
 
 wxGridUpdateLocker lock( m_trackWidthsGrid );
 
 for( int row = 0; row < m_trackWidthsGrid->GetNumberRows(); ++row )
 {
 msg = m_trackWidthsGrid->GetCellValue( row, TR_WIDTH_COL );
 
 if( !msg.IsEmpty() )
 trackWidths.push_back( m_Frame->ValueFromString( msg ) );
 }
 
 std::sort( trackWidths.begin(), trackWidths.end() );
 m_trackWidthsGrid->DeleteRows(0, m_trackWidthsGrid->GetNumberRows(), false);
 
 for( int width : trackWidths )
 AppendTrackWidth( width );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnSortViaSizesClick( wxCommandEvent& aEvent )
{
 std::vector<VIA_DIMENSION> vias;
 wxString msg;
 
 wxGridUpdateLocker lock( m_viaSizesGrid );
 
 for( int row = 0; row < m_viaSizesGrid->GetNumberRows(); ++row )
 {
 msg = m_viaSizesGrid->GetCellValue( row, VIA_SIZE_COL );
 
 if( !msg.IsEmpty() )
 {
 VIA_DIMENSION via_dim;
 via_dim.m_Diameter = m_Frame->ValueFromString( msg );
 
 msg = m_viaSizesGrid->GetCellValue( row, VIA_DRILL_COL );
 
 if( !msg.IsEmpty() )
 via_dim.m_Drill = m_Frame->ValueFromString( msg );
 
 vias.push_back( via_dim );
 }
 }
 
 std::sort( vias.begin(), vias.end() );
 m_viaSizesGrid->DeleteRows(0, m_viaSizesGrid->GetNumberRows(), false );
 
 for( const VIA_DIMENSION& via : vias )
 AppendViaSize( via.m_Diameter, via.m_Drill );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnSortDiffPairsClick( wxCommandEvent& aEvent )
{
 wxString msg;
 std::vector<DIFF_PAIR_DIMENSION> diffPairs;
 
 wxGridUpdateLocker lock( m_diffPairsGrid );
 
 for( int row = 0; row < m_diffPairsGrid->GetNumberRows(); ++row )
 {
 msg = m_diffPairsGrid->GetCellValue( row, DP_WIDTH_COL );
 
 if( !msg.IsEmpty() )
 {
 DIFF_PAIR_DIMENSION diffPair_dim;
 diffPair_dim.m_Width = m_Frame->ValueFromString( msg );
 
 msg = m_diffPairsGrid->GetCellValue( row, DP_GAP_COL );
 diffPair_dim.m_Gap = m_Frame->ValueFromString( msg );
 
 msg = m_diffPairsGrid->GetCellValue( row, DP_VIA_GAP_COL );
 
 if( !msg.IsEmpty() )
 diffPair_dim.m_ViaGap = m_Frame->ValueFromString( msg );
 
 diffPairs.push_back( diffPair_dim );
 }
 }
 
 std::sort( diffPairs.begin(), diffPairs.end() );
 m_diffPairsGrid->DeleteRows(0, m_diffPairsGrid->GetNumberRows(), false );
 
 for( const DIFF_PAIR_DIMENSION& dp : diffPairs )
 AppendDiffPairs( dp.m_Width, dp.m_Gap, dp.m_ViaGap );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::onUnitsChanged( wxCommandEvent& aEvent )
{
 BOARD_DESIGN_SETTINGS tempBDS( nullptr, "dummy" );
 BOARD_DESIGN_SETTINGS* saveBDS = m_BrdSettings;
 
 m_BrdSettings = &tempBDS; // No, address of stack var does not escape function
 
 TransferDataFromWindow();
 TransferDataToWindow();
 
 m_BrdSettings = saveBDS;
 
 aEvent.Skip();
}
 
 
bool PANEL_SETUP_TRACKS_AND_VIAS::TransferDataToWindow()
{
 m_trackWidthsGrid->ClearRows();
 m_viaSizesGrid->ClearRows();
 m_diffPairsGrid->ClearRows();
 
 // Skip the first item, which is the current netclass value
 for( unsigned ii = 1; ii < m_BrdSettings->m_TrackWidthList.size(); ii++ )
 {
 AppendTrackWidth( m_BrdSettings->m_TrackWidthList[ii] );
 }
 
 // Skip the first item, which is the current netclass value
 for( unsigned ii = 1; ii < m_BrdSettings->m_ViasDimensionsList.size(); ii++ )
 {
 AppendViaSize( m_BrdSettings->m_ViasDimensionsList[ii].m_Diameter,
 m_BrdSettings->m_ViasDimensionsList[ii].m_Drill );
 }
 
 // Skip the first item, which is the current netclass value
 for( unsigned ii = 1; ii < m_BrdSettings->m_DiffPairDimensionsList.size(); ii++ )
 {
 AppendDiffPairs( m_BrdSettings->m_DiffPairDimensionsList[ii].m_Width,
 m_BrdSettings->m_DiffPairDimensionsList[ii].m_Gap,
 m_BrdSettings->m_DiffPairDimensionsList[ii].m_ViaGap );
 }
 
 return true;
}
 
 
bool PANEL_SETUP_TRACKS_AND_VIAS::TransferDataFromWindow()
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return false;
 }
 
 wxString msg;
 std::vector<int> trackWidths;
 std::vector<VIA_DIMENSION> vias;
 std::vector<DIFF_PAIR_DIMENSION> diffPairs;
 
 // Test ONLY for malformed data. Design rules and constraints are the business of DRC.
 
 for( int row = 0; row < m_trackWidthsGrid->GetNumberRows(); ++row )
 {
 if( !m_trackWidthsGrid->GetCellValue( row, TR_WIDTH_COL ).IsEmpty() )
 trackWidths.push_back( m_trackWidthsGrid->GetUnitValue( row, TR_WIDTH_COL ) );
 }
 
 for( int row = 0; row < m_viaSizesGrid->GetNumberRows(); ++row )
 {
 if( !m_viaSizesGrid->GetCellValue( row, VIA_SIZE_COL ).IsEmpty() )
 {
 VIA_DIMENSION via_dim;
 via_dim.m_Diameter = m_viaSizesGrid->GetUnitValue( row, VIA_SIZE_COL );
 
 if( !m_viaSizesGrid->GetCellValue( row, VIA_DRILL_COL ).IsEmpty() )
 via_dim.m_Drill = m_viaSizesGrid->GetUnitValue( row, VIA_DRILL_COL );
 
 vias.push_back( via_dim );
 }
 }
 
 for( int row = 0; row < m_diffPairsGrid->GetNumberRows(); ++row )
 {
 if( !m_diffPairsGrid->GetCellValue( row, DP_WIDTH_COL ).IsEmpty() )
 {
 DIFF_PAIR_DIMENSION diffPair_dim;
 diffPair_dim.m_Width = m_diffPairsGrid->GetUnitValue( row, DP_WIDTH_COL );
 
 if( !m_diffPairsGrid->GetCellValue( row, DP_GAP_COL ).IsEmpty() )
 diffPair_dim.m_Gap = m_diffPairsGrid->GetUnitValue( row, DP_GAP_COL );
 
 if( !m_diffPairsGrid->GetCellValue( row, DP_VIA_GAP_COL ).IsEmpty() )
 diffPair_dim.m_ViaGap = m_diffPairsGrid->GetUnitValue( row, DP_VIA_GAP_COL );
 
 diffPairs.push_back( diffPair_dim );
 }
 }
 
 // Sort lists by increasing value
 sort( trackWidths.begin(), trackWidths.end() );
 sort( vias.begin(), vias.end() );
 sort( diffPairs.begin(), diffPairs.end() );
 
 // These are all stored in project file, not board, so no need for OnModify()
 
 trackWidths.insert( trackWidths.begin(), 0 ); // dummy value for "use netclass"
 m_BrdSettings->m_TrackWidthList = trackWidths;
 
 vias.insert( vias.begin(), { 0, 0 } ); // dummy value for "use netclass"
 m_BrdSettings->m_ViasDimensionsList = vias;
 
 diffPairs.insert( diffPairs.begin(), { 0, 0, 0 } ); // dummy value for "use netclass"
 m_BrdSettings->m_DiffPairDimensionsList = diffPairs;
 
 return true;
}
 
 
bool PANEL_SETUP_TRACKS_AND_VIAS::Validate()
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return false;
 }
 
 wxString msg;
 
 // Test vias
 for( int row = 0; row < m_viaSizesGrid->GetNumberRows(); ++row )
 {
 wxString viaDia = m_viaSizesGrid->GetCellValue( row, VIA_SIZE_COL );
 wxString viaDrill = m_viaSizesGrid->GetCellValue( row, VIA_DRILL_COL );
 
 if( !viaDia.IsEmpty() && viaDrill.IsEmpty() )
 {
 msg = _( "No via hole size defined." );
 PAGED_DIALOG::GetDialog( this )->SetError( msg, this, m_viaSizesGrid, row, VIA_DRILL_COL );
 return false;
 }
 }
 
 // Test diff pairs
 for( int row = 0; row < m_diffPairsGrid->GetNumberRows(); ++row )
 {
 wxString dpWidth = m_diffPairsGrid->GetCellValue( row, 0 );
 wxString dpGap = m_diffPairsGrid->GetCellValue( row, 1 );
 
 if( !dpWidth.IsEmpty() && dpGap.IsEmpty() )
 {
 msg = _( "No differential pair gap defined." );
 PAGED_DIALOG::GetDialog( this )->SetError( msg, this, m_diffPairsGrid, row, 1 );
 return false;
 }
 }
 
 return true;
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::AppendTrackWidth( const int aWidth )
{
 int i = m_trackWidthsGrid->GetNumberRows();
 
 m_trackWidthsGrid->AppendRows( 1 );
 
 m_trackWidthsGrid->SetUnitValue( i, TR_WIDTH_COL, aWidth );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::AppendViaSize( int aSize, int aDrill )
{
 int i = m_viaSizesGrid->GetNumberRows();
 
 m_viaSizesGrid->AppendRows( 1 );
 
 m_viaSizesGrid->SetUnitValue( i, VIA_SIZE_COL, aSize );
 
 if( aDrill > 0 )
 m_viaSizesGrid->SetUnitValue( i, VIA_DRILL_COL, aDrill );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::AppendDiffPairs( int aWidth, int aGap, int aViaGap )
{
 int i = m_diffPairsGrid->GetNumberRows();
 
 m_diffPairsGrid->AppendRows( 1 );
 
 m_diffPairsGrid->SetUnitValue( i, DP_WIDTH_COL, aWidth );
 
 if( aGap > 0 )
 m_diffPairsGrid->SetUnitValue( i, DP_GAP_COL, aGap );
 
 if( aViaGap > 0 )
 m_diffPairsGrid->SetUnitValue( i, DP_VIA_GAP_COL, aViaGap );
}
 
 
void removeSelectedRows( WX_GRID* aGrid )
{
 wxArrayInt selectedRows = aGrid->GetSelectedRows();
 int curRow = aGrid->GetGridCursorRow();
 
 if( selectedRows.empty() && curRow >= 0 && curRow < aGrid->GetNumberRows() )
 selectedRows.Add( curRow );
 
 for( int ii = selectedRows.Count() - 1; ii >= 0; --ii )
 {
 int row = selectedRows.Item( ii );
 aGrid->DeleteRows( row, 1 );
 curRow = std::min( curRow, row );
 }
 
 curRow = std::max( 0, curRow - 1 );
 aGrid->MakeCellVisible( curRow, aGrid->GetGridCursorCol() );
 aGrid->SetGridCursor( curRow, aGrid->GetGridCursorCol() );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnAddTrackWidthsClick( wxCommandEvent& aEvent )
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return;
 }
 
 AppendTrackWidth( 0 );
 
 m_trackWidthsGrid->MakeCellVisible( m_trackWidthsGrid->GetNumberRows() - 1, TR_WIDTH_COL );
 m_trackWidthsGrid->SetGridCursor( m_trackWidthsGrid->GetNumberRows() - 1, TR_WIDTH_COL );
 
 m_trackWidthsGrid->EnableCellEditControl( true );
 m_trackWidthsGrid->ShowCellEditControl();
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnRemoveTrackWidthsClick( wxCommandEvent& event )
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return;
 }
 
 removeSelectedRows( m_trackWidthsGrid );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnAddViaSizesClick( wxCommandEvent& event )
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return;
 }
 
 AppendViaSize( 0, 0 );
 
 m_viaSizesGrid->MakeCellVisible( m_viaSizesGrid->GetNumberRows() - 1, VIA_SIZE_COL );
 m_viaSizesGrid->SetGridCursor( m_viaSizesGrid->GetNumberRows() - 1, VIA_SIZE_COL );
 
 m_viaSizesGrid->EnableCellEditControl( true );
 m_viaSizesGrid->ShowCellEditControl();
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnRemoveViaSizesClick( wxCommandEvent& event )
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return;
 }
 
 removeSelectedRows( m_viaSizesGrid );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnAddDiffPairsClick( wxCommandEvent& event )
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return;
 }
 
 AppendDiffPairs( 0, 0, 0 );
 
 m_diffPairsGrid->MakeCellVisible( m_diffPairsGrid->GetNumberRows() - 1, DP_WIDTH_COL );
 m_diffPairsGrid->SetGridCursor( m_diffPairsGrid->GetNumberRows() - 1, DP_WIDTH_COL );
 
 m_diffPairsGrid->EnableCellEditControl( true );
 m_diffPairsGrid->ShowCellEditControl();
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::OnRemoveDiffPairsClick( wxCommandEvent& event )
{
 if( !m_trackWidthsGrid->CommitPendingChanges()
 || !m_viaSizesGrid->CommitPendingChanges()
 || !m_diffPairsGrid->CommitPendingChanges() )
 {
 return;
 }
 
 removeSelectedRows( m_diffPairsGrid );
}
 
 
void PANEL_SETUP_TRACKS_AND_VIAS::ImportSettingsFrom( BOARD* aBoard )
{
 m_trackWidthsGrid->CommitPendingChanges( true );
 m_viaSizesGrid->CommitPendingChanges( true );
 m_diffPairsGrid->CommitPendingChanges( true );
 
 // Note: do not change the board, as we need to get the current nets from it for
 // netclass memberships. All the netclass definitions and dimension lists are in
 // the BOARD_DESIGN_SETTINGS.
 
 BOARD_DESIGN_SETTINGS* savedSettings = m_BrdSettings;
 
 m_BrdSettings = &aBoard->GetDesignSettings();
 TransferDataToWindow();
 
 m_BrdSettings = savedSettings;
}