kicad/pcbnew/dialogs/dialog_board_reannotate.cpp

920 lines
32 KiB
C++
Raw Normal View History

2020-04-21 01:44:17 +00:00
/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2020 Brian Piccioni brian@documenteddesigns.com
* Copyright (C) 2020-2022 KiCad Developers, see AUTHORS.txt for contributors.
2020-04-21 01:44:17 +00:00
* @author Brian Piccioni <brian@documenteddesigns.com>
*
* This program is free software; you can redistribute it and/or
2020-04-21 01:44:17 +00:00
* 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 <algorithm>
2020-04-21 01:44:17 +00:00
#include <base_units.h>
#include <bitmaps.h>
#include <board_commit.h>
#include <confirm.h>
#include <ctype.h>
#include <dialog_board_reannotate.h>
#include <string_utils.h> // StrNumCmp
2021-09-14 22:45:14 +00:00
#include <kiface_base.h>
2020-04-21 01:44:17 +00:00
#include <pcbnew_settings.h>
#include <refdes_utils.h>
2020-04-21 01:44:17 +00:00
#include <tool/grid_menu.h>
#include <widgets/wx_html_report_panel.h>
#include <wx/valtext.h>
2020-04-21 01:44:17 +00:00
2020-04-21 01:44:17 +00:00
bool SortYFirst;
bool DescendingFirst;
bool DescendingSecond;
//
// This converts the index into a sort code. Note that Back sort code will have left and
// right swapped.
2020-04-21 01:44:17 +00:00
//
int FrontDirectionsArray[] = {
SORTYFIRST + ASCENDINGFIRST + ASCENDINGSECOND, // "Top to bottom, left to right", // 100
SORTYFIRST + ASCENDINGFIRST + DESCENDINGSECOND, // "Top to bottom, right to left", // 101
SORTYFIRST + DESCENDINGFIRST + ASCENDINGSECOND, // "Back to Front, left to right", // 110
SORTYFIRST + DESCENDINGFIRST + DESCENDINGSECOND, // "Back to Front, right to left", // 111
SORTXFIRST + ASCENDINGFIRST + ASCENDINGSECOND, // "Left to right, Front to Back", // 000
SORTXFIRST + ASCENDINGFIRST + DESCENDINGSECOND, // "Left to right, Back to Front", // 001
SORTXFIRST + DESCENDINGFIRST + ASCENDINGSECOND, // "Right to left, Front to Back", // 010
SORTXFIRST + DESCENDINGFIRST + DESCENDINGSECOND // "Right to left, Back to Front", // 011
2020-04-21 01:44:17 +00:00
};
//
// Back Left/Right is opposite because it is a mirror image (coordinates are from the top)
//
int BackDirectionsArray[] = {
SORTYFIRST + ASCENDINGFIRST + DESCENDINGSECOND, // "Top to bottom, left to right", // 101
SORTYFIRST + ASCENDINGFIRST + ASCENDINGSECOND, // "Top to bottom, right to left", // 100
SORTYFIRST + DESCENDINGFIRST + DESCENDINGSECOND, // "Bottom to top, left to right", // 111
SORTYFIRST + DESCENDINGFIRST + ASCENDINGSECOND, // "Bottom to top, right to left", // 110
SORTXFIRST + DESCENDINGFIRST + ASCENDINGSECOND, // "Left to right, top to bottom", // 010
SORTXFIRST + DESCENDINGFIRST + DESCENDINGSECOND, // "Left to right, bottom to top", // 011
SORTXFIRST + ASCENDINGFIRST + ASCENDINGSECOND, // "Right to left, top to bottom", // 000
SORTXFIRST + ASCENDINGFIRST + DESCENDINGSECOND // "Right to left, bottom to top", // 001
2020-04-21 01:44:17 +00:00
};
#define SetSortCodes( DirArray, Code ) \
{ \
SortYFirst = ( ( DirArray[Code] & SORTYFIRST ) != 0 ); \
DescendingFirst = ( ( DirArray[Code] & DESCENDINGFIRST ) != 0 ); \
DescendingSecond = ( ( DirArray[Code] & DESCENDINGSECOND ) != 0 ); \
}
wxString AnnotateString[] = {
_( "All" ), // AnnotateAll
_( "Only front" ), // AnnotateFront
_( "Only back" ), // AnnotateBack
_( "Only selected" ) // AnnotateSelected
2020-04-21 01:44:17 +00:00
};
wxString ActionMessage[] = {
"", // UpdateRefDes
_( "Empty" ), // EmptyRefDes
_( "Invalid" ), // InvalidRefDes
_( "Excluded" ) // Exclude
2020-04-21 01:44:17 +00:00
};
DIALOG_BOARD_REANNOTATE::DIALOG_BOARD_REANNOTATE( PCB_EDIT_FRAME* aParentFrame )
2020-08-09 16:13:17 +00:00
: DIALOG_BOARD_REANNOTATE_BASE( aParentFrame ),
2020-11-13 02:57:11 +00:00
m_footprints( aParentFrame->GetBoard()->Footprints() )
2020-04-21 01:44:17 +00:00
{
2021-06-10 08:34:27 +00:00
m_frame = aParentFrame;
2020-04-21 01:44:17 +00:00
m_Config = Kiface().KifaceSettings();
InitValues();
m_FrontRefDesStart->SetValidator( wxTextValidator( wxFILTER_DIGITS ) );
m_BackRefDesStart->SetValidator( wxTextValidator( wxFILTER_DIGITS ) );
m_sdbSizerOK->SetLabel( _( "Reannotate PCB" ) );
m_sdbSizerCancel->SetLabel( _( "Close" ) );
m_sdbSizer->Layout();
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
m_settings = aParentFrame->config();
2020-04-21 01:44:17 +00:00
wxArrayString gridslist;
2020-11-13 02:57:11 +00:00
GRID_MENU::BuildChoiceList( &gridslist, m_settings, aParentFrame );
2020-04-21 01:44:17 +00:00
if( -1 == m_gridIndex ) // If no default loaded
m_gridIndex = m_settings->m_Window.grid.last_size_idx; // Get the current grid size
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
m_sortGridx = m_frame->GetCanvas()->GetGAL()->GetGridSize().x;
m_sortGridy = m_frame->GetCanvas()->GetGAL()->GetGridSize().y;
2020-04-21 01:44:17 +00:00
m_GridChoice->Set( gridslist );
2020-11-13 02:57:11 +00:00
m_GridChoice->SetSelection( m_gridIndex );
2020-04-21 01:44:17 +00:00
for( wxRadioButton* button : m_sortButtons )
button->SetValue( false );
2020-11-13 02:57:11 +00:00
m_sortButtons[m_sortCode]->SetValue( true );
2020-04-21 01:44:17 +00:00
m_selection = m_frame->GetToolManager()->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
2020-04-21 01:44:17 +00:00
if( !m_selection.Empty() )
m_annotationScope = AnnotateSelected;
2020-04-21 01:44:17 +00:00
for( wxRadioButton* button : m_scopeRadioButtons )
2020-04-21 01:44:17 +00:00
button->SetValue( false );
m_scopeRadioButtons[m_annotationScope]->SetValue( true );
2020-04-21 01:44:17 +00:00
reannotate_down_right_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_right_down ) );
reannotate_right_down_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_left_down ) );
reannotate_down_left_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_right_up ) );
reannotate_left_down_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_left_up ) );
reannotate_up_right_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_down_left ) );
reannotate_right_up_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_up_left ) );
reannotate_up_left_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_down_right ) );
reannotate_left_up_bitmap->SetBitmap( KiBitmap( BITMAPS::reannotate_up_right ) );
2020-04-21 01:44:17 +00:00
m_ExcludeList->SetToolTip( m_ExcludeListText->GetToolTipText() );
m_GridChoice->SetToolTip( m_SortGridText->GetToolTipText() );
m_MessageWindow->SetFileName( Prj().GetProjectPath() + wxT( "report.txt" ) );
2020-11-16 11:16:44 +00:00
finishDialogSettings();
2020-04-21 01:44:17 +00:00
}
DIALOG_BOARD_REANNOTATE::~DIALOG_BOARD_REANNOTATE()
{
GetParameters(); // Get the current menu settings
2020-04-21 01:44:17 +00:00
PCBNEW_SETTINGS* cfg = m_frame->GetPcbNewSettings();
2020-11-13 02:57:11 +00:00
cfg->m_Reannotate.sort_on_fp_location = m_locationChoice->GetSelection() == 0;
2020-08-11 12:34:53 +00:00
cfg->m_Reannotate.remove_front_prefix = m_RemoveFrontPrefix->GetValue();
cfg->m_Reannotate.remove_back_prefix = m_RemoveBackPrefix->GetValue();
cfg->m_Reannotate.exclude_locked = m_ExcludeLocked->GetValue();
2020-11-13 02:57:11 +00:00
cfg->m_Reannotate.grid_index = m_gridIndex;
cfg->m_Reannotate.sort_code = m_sortCode;
cfg->m_Reannotate.annotation_choice = m_annotationScope;
2020-11-13 02:57:11 +00:00
cfg->m_Reannotate.report_severity = m_severity;
2020-08-11 12:34:53 +00:00
cfg->m_Reannotate.front_refdes_start = m_FrontRefDesStart->GetValue();
cfg->m_Reannotate.back_refdes_start = m_BackRefDesStart->GetValue();
cfg->m_Reannotate.front_prefix = m_FrontPrefix->GetValue();
cfg->m_Reannotate.back_prefix = m_BackPrefix->GetValue();
cfg->m_Reannotate.exclude_list = m_ExcludeList->GetValue();
cfg->m_Reannotate.report_file_name = m_MessageWindow->GetFileName();
2020-04-21 01:44:17 +00:00
}
2020-04-21 01:44:17 +00:00
void DIALOG_BOARD_REANNOTATE::InitValues( void )
{
PCBNEW_SETTINGS* cfg = m_frame->GetPcbNewSettings();
2020-11-13 02:57:11 +00:00
m_locationChoice->SetSelection( cfg->m_Reannotate.sort_on_fp_location ? 0 : 1 );
2020-04-21 01:44:17 +00:00
m_RemoveFrontPrefix->SetValue( cfg->m_Reannotate.remove_front_prefix );
m_RemoveBackPrefix->SetValue( cfg->m_Reannotate.remove_back_prefix );
m_ExcludeLocked->SetValue( cfg->m_Reannotate.exclude_locked );
2020-11-13 02:57:11 +00:00
m_gridIndex = cfg->m_Reannotate.grid_index ;
m_sortCode = cfg->m_Reannotate.sort_code ;
m_annotationScope = cfg->m_Reannotate.annotation_choice ;
2020-11-13 02:57:11 +00:00
m_severity = cfg->m_Reannotate.report_severity;
2020-04-21 01:44:17 +00:00
m_FrontRefDesStart->SetValue( cfg->m_Reannotate.front_refdes_start );
m_BackRefDesStart->SetValue( cfg->m_Reannotate.back_refdes_start );
m_FrontPrefix->SetValue( cfg->m_Reannotate.front_prefix );
m_BackPrefix->SetValue( cfg->m_Reannotate.back_prefix );
m_ExcludeList->SetValue( cfg->m_Reannotate.exclude_list );
m_MessageWindow->SetFileName( cfg->m_Reannotate.report_file_name );
}
void DIALOG_BOARD_REANNOTATE::OnCloseClick( wxCommandEvent& event )
{
EndDialog( wxID_OK );
}
void DIALOG_BOARD_REANNOTATE::FilterPrefix( wxTextCtrl* aPrefix )
{
std::string tmps = VALIDPREFIX;
if( aPrefix->GetValue().empty() )
return; //Should never happen
char lastc = aPrefix->GetValue().Last();
if( isalnum( (int) lastc ) )
return;
if( std::string::npos != tmps.find( lastc ) )
return;
tmps = aPrefix->GetValue();
aPrefix->Clear();
tmps.pop_back();
aPrefix->AppendText( tmps );
}
RefDesTypeStr* DIALOG_BOARD_REANNOTATE::GetOrBuildRefDesInfo( const wxString& aRefDesPrefix,
unsigned int aStartRefDes )
{
unsigned int requiredLastRef = ( aStartRefDes == 0 ? 1 : aStartRefDes ) - 1;
for( size_t i = 0; i < m_refDesTypes.size(); i++ ) // See if it is in the types array
{
if( m_refDesTypes[i].RefDesType == aRefDesPrefix ) // Found it!
{
m_refDesTypes[i].LastUsedRefDes = std::max( m_refDesTypes[i].LastUsedRefDes,
requiredLastRef );
return &m_refDesTypes[i];
}
}
// Wasn't in the types array so add it
RefDesTypeStr newtype;
newtype.RefDesType = aRefDesPrefix;
newtype.LastUsedRefDes = requiredLastRef;
m_refDesTypes.push_back( newtype );
return &m_refDesTypes.back();
}
2020-04-21 01:44:17 +00:00
void DIALOG_BOARD_REANNOTATE::FilterFrontPrefix( wxCommandEvent& event )
{
FilterPrefix( m_FrontPrefix );
}
void DIALOG_BOARD_REANNOTATE::FilterBackPrefix( wxCommandEvent& event )
{
FilterPrefix( m_BackPrefix );
}
void DIALOG_BOARD_REANNOTATE::OnApplyClick( wxCommandEvent& event )
{
wxString warning;
if( m_frame->GetBoard()->IsEmpty() )
{
2020-08-09 16:13:17 +00:00
ShowReport( _( "No PCB to reannotate!" ), RPT_SEVERITY_ERROR );
2020-04-21 01:44:17 +00:00
return;
}
GetParameters(); // Figure out how this is to be done
2020-04-21 01:44:17 +00:00
MakeSampleText( warning );
if( !IsOK( m_frame, warning ) )
return;
if( ReannotateBoard() )
{
ShowReport( _( "PCB successfully reannotated" ), RPT_SEVERITY_ACTION );
ShowReport( _( "PCB annotation changes should be synchronized with schematic using "
"the \"Update Schematic from PCB\" tool." ), RPT_SEVERITY_WARNING );
}
2020-04-21 01:44:17 +00:00
m_MessageWindow->SetLazyUpdate( false );
m_MessageWindow->Flush( false );
m_frame->GetCanvas()->Refresh(); // Redraw
m_frame->OnModify(); // Need to save file on exit.
2020-04-21 01:44:17 +00:00
}
void DIALOG_BOARD_REANNOTATE::MakeSampleText( wxString& aMessage )
{
aMessage.Printf( _( "\n%s footprints will be reannotated." ),
_( AnnotateString[m_annotationScope] ) );
2020-04-21 01:44:17 +00:00
if( !m_ExcludeList->GetValue().empty() )
2020-08-11 12:34:53 +00:00
{
2020-08-09 16:13:17 +00:00
aMessage += wxString::Format( _( "\nAny reference types %s will not be annotated." ),
m_ExcludeList->GetValue() );
2020-08-11 12:34:53 +00:00
}
2020-04-21 01:44:17 +00:00
if( m_ExcludeLocked->GetValue() )
aMessage += wxString::Format( _( "\nLocked footprints will not be annotated" ) );
if( !m_AnnotateBack->GetValue() )
2020-08-11 12:34:53 +00:00
{
aMessage += wxString::Format( _( "\nFront footprints will start at %s" ),
2020-08-09 16:13:17 +00:00
m_FrontRefDesStart->GetValue() );
2020-08-11 12:34:53 +00:00
}
2020-04-21 01:44:17 +00:00
if( !m_AnnotateFront->GetValue() )
2020-08-09 16:13:17 +00:00
{
2020-08-09 22:26:54 +00:00
bool frontPlusOne = ( 0 == wxAtoi( m_BackRefDesStart->GetValue() ) )
2020-08-09 16:13:17 +00:00
&& !m_AnnotateBack->GetValue();
2020-08-11 12:34:53 +00:00
aMessage += wxString::Format( _( "\nBack footprints will start at %s." ),
frontPlusOne ? _( "the last front footprint + 1" ) :
2020-08-09 16:13:17 +00:00
m_BackRefDesStart->GetValue() );
}
2020-04-21 01:44:17 +00:00
if( !m_FrontPrefix->GetValue().empty() )
{
if( m_RemoveFrontPrefix->GetValue() )
2020-08-11 12:34:53 +00:00
{
aMessage += wxString::Format( _( "\nFront footprints starting with '%s' will have "
"the prefix removed." ),
m_FrontPrefix->GetValue() );
}
2020-04-21 01:44:17 +00:00
else
2020-08-11 12:34:53 +00:00
{
aMessage += wxString::Format( _( "\nFront footprints will have '%s' inserted as a "
"prefix." ),
m_FrontPrefix->GetValue() );
}
2020-04-21 01:44:17 +00:00
}
if( !m_BackPrefix->GetValue().empty() )
{
if( m_RemoveBackPrefix->GetValue() )
2020-08-11 12:34:53 +00:00
{
aMessage += wxString::Format( _( "\nBack footprints starting with '%s' will have the "
"prefix removed." ),
m_BackPrefix->GetValue() );
}
2020-04-21 01:44:17 +00:00
else
2020-08-11 12:34:53 +00:00
{
aMessage += wxString::Format( _( "\nBack footprints will have '%s' inserted as a "
"prefix." ),
m_BackPrefix->GetValue() );
}
2020-04-21 01:44:17 +00:00
}
2020-11-13 02:57:11 +00:00
bool fpLocation = m_locationChoice->GetSelection() == 0;
2020-08-11 12:34:53 +00:00
aMessage += wxString::Format( _( "\nPrior to sorting by %s, the coordinates of which will be "
"rounded to a %s, %s grid." ),
2020-11-13 02:57:11 +00:00
fpLocation ? _( "footprint location" )
: _( "reference designator location" ),
2022-09-19 09:25:20 +00:00
m_frame->MessageTextFromValue( m_sortGridx ),
m_frame->MessageTextFromValue( m_sortGridy ) );
2020-04-21 01:44:17 +00:00
ShowReport( aMessage, RPT_SEVERITY_INFO );
}
2020-08-09 16:13:17 +00:00
void DIALOG_BOARD_REANNOTATE::GetParameters()
2020-04-21 01:44:17 +00:00
{
m_sortCode = 0; // Convert radio button to sort direction code
2020-04-21 01:44:17 +00:00
for( wxRadioButton* sortbuttons : m_sortButtons )
{
if( sortbuttons->GetValue() )
break;
2020-11-13 02:57:11 +00:00
m_sortCode++;
2020-04-21 01:44:17 +00:00
}
2020-11-13 02:57:11 +00:00
if( m_sortCode >= (int) m_sortButtons.size() )
m_sortCode = 0;
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
m_frontPrefixString = m_FrontPrefix->GetValue();
m_backPrefixString = m_BackPrefix->GetValue();
2020-04-21 01:44:17 +00:00
// Get the chosen sort grid for rounding
2020-11-13 02:57:11 +00:00
m_gridIndex = m_GridChoice->GetSelection();
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
if( m_gridIndex >= ( int ) m_settings->m_Window.grid.sizes.size() )
2020-04-21 01:44:17 +00:00
{
2022-09-16 04:38:10 +00:00
m_sortGridx = EDA_UNIT_UTILS::UI::DoubleValueFromString(
pcbIUScale, EDA_UNITS::MILS, m_settings->m_Window.grid.user_grid_x );
m_sortGridy = EDA_UNIT_UTILS::UI::DoubleValueFromString(
pcbIUScale, EDA_UNITS::MILS, m_settings->m_Window.grid.user_grid_y );
2020-04-21 01:44:17 +00:00
}
else
{
2022-09-16 04:38:10 +00:00
m_sortGridx = EDA_UNIT_UTILS::UI::DoubleValueFromString(
pcbIUScale, EDA_UNITS::MILS, m_settings->m_Window.grid.sizes[m_gridIndex] );
2020-11-13 02:57:11 +00:00
m_sortGridy = m_sortGridx;
2020-04-21 01:44:17 +00:00
}
m_annotationScope = AnnotateAll;
2020-08-09 16:13:17 +00:00
for( wxRadioButton* button : m_scopeRadioButtons )
2020-04-21 01:44:17 +00:00
{
if( button->GetValue() )
break;
else
m_annotationScope++;
2020-04-21 01:44:17 +00:00
}
2020-04-21 01:44:17 +00:00
m_MessageWindow->SetLazyUpdate( true );
}
int DIALOG_BOARD_REANNOTATE::RoundToGrid( int aCoord, int aGrid )
{
if( 0 == aGrid )
aGrid = MINGRID;
int rounder;
rounder = aCoord % aGrid;
aCoord -= rounder;
if( abs( rounder ) > ( aGrid / 2 ) )
aCoord += ( aCoord < 0 ? -aGrid : aGrid );
return ( aCoord );
}
/// Compare function used to compare ChangeArray element for sort
/// @return true is A < B
2020-04-21 01:44:17 +00:00
static bool ChangeArrayCompare( const RefDesChange& aA, const RefDesChange& aB )
{
return ( StrNumCmp( aA.OldRefDesString, aB.OldRefDesString ) < 0 );
2020-04-21 01:44:17 +00:00
}
/// Compare function to sort footprints.
2020-04-21 01:44:17 +00:00
/// @return true if the first coordinate should be before the second coordinate
static bool ModuleCompare( const RefDesInfo& aA, const RefDesInfo& aB )
{
int X0 = aA.roundedx, X1 = aB.roundedx, Y0 = aA.roundedy, Y1 = aB.roundedy;
if( SortYFirst ) //If sorting by Y then X, swap X and Y
{
std::swap( X0, Y0 );
std::swap( X1, Y1 );
}
// If descending, same compare just swap directions
2020-04-21 01:44:17 +00:00
if( DescendingFirst )
std::swap( X0, X1 );
if( DescendingSecond )
std::swap( Y0, Y1 );
if( X0 < X1 )
return ( true ); // yes, its smaller
2020-04-21 01:44:17 +00:00
if( X0 > X1 )
return ( false ); // No its not
2020-04-21 01:44:17 +00:00
if( Y0 < Y1 )
return ( true ); // same but equal
2020-04-21 01:44:17 +00:00
return ( false );
}
wxString DIALOG_BOARD_REANNOTATE::CoordTowxString( int aX, int aY )
{
2022-02-04 22:44:59 +00:00
return wxString::Format( wxT( "%s, %s" ),
2022-09-19 09:25:20 +00:00
m_frame->MessageTextFromValue( aX ),
m_frame->MessageTextFromValue( aY ) );
2020-04-21 01:44:17 +00:00
}
void DIALOG_BOARD_REANNOTATE::ShowReport( const wxString& aMessage, SEVERITY aSeverity )
2020-04-21 01:44:17 +00:00
{
size_t pos = 0, prev = 0;
do
{
pos = aMessage.ToStdString().find( '\n', prev );
2020-08-09 16:13:17 +00:00
m_MessageWindow->Report( aMessage.ToStdString().substr( prev, pos - prev ), aSeverity );
2020-04-21 01:44:17 +00:00
prev = pos + 1;
} while( std::string::npos != pos );
}
2020-08-09 16:13:17 +00:00
void DIALOG_BOARD_REANNOTATE::LogChangePlan()
2020-04-21 01:44:17 +00:00
{
int i = 1;
wxString message;
message.Printf( _( "\n\nThere are %i types of reference designations\n"
2020-04-21 01:44:17 +00:00
"**********************************************************\n" ),
2020-11-13 02:57:11 +00:00
(int) m_refDesTypes.size() );
2020-04-21 01:44:17 +00:00
for( RefDesTypeStr Type : m_refDesTypes ) // Show all the types of refdes
2022-02-04 22:44:59 +00:00
message += Type.RefDesType + ( 0 == ( i++ % 16 ) ? wxT( "\n" ) : wxS( " " ) );
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
if( !m_excludeArray.empty() )
2020-04-21 01:44:17 +00:00
{
wxString excludes;
for( wxString& exclude : m_excludeArray ) // Show the refdes we are excluding
2022-02-04 22:44:59 +00:00
excludes += exclude + wxS( " " );
message += wxString::Format( _( "\nExcluding: %s from reannotation\n\n" ), excludes );
2020-04-21 01:44:17 +00:00
}
message += _( "\n Change Array\n***********************\n" );
for( const RefDesChange& change : m_changeArray )
2020-04-21 01:44:17 +00:00
{
2022-02-04 22:44:59 +00:00
message += wxString::Format( wxT( "%s -> %s %s %s\n" ),
change.OldRefDesString,
change.NewRefDes,
ActionMessage[change.Action],
UpdateRefDes != change.Action ? _( " will be ignored" )
: wxString( wxT( "" ) ) );
2020-04-21 01:44:17 +00:00
}
ShowReport( message, RPT_SEVERITY_INFO );
}
2020-11-18 19:50:36 +00:00
void DIALOG_BOARD_REANNOTATE::LogFootprints( const wxString& aMessage,
const std::vector<RefDesInfo>& aFootprints )
2020-04-21 01:44:17 +00:00
{
wxString message = aMessage;
2020-11-13 01:33:30 +00:00
if( aFootprints.empty() )
message += _( "\nNo footprints" );
2020-04-21 01:44:17 +00:00
else
{
int i = 1;
2020-11-13 01:33:30 +00:00
bool fpLocations = m_locationChoice->GetSelection() == 0;
2020-08-11 12:34:53 +00:00
message += wxString::Format( _( "\n*********** Sort on %s ***********" ),
2020-11-13 01:33:30 +00:00
fpLocations ? _( "Footprint Coordinates" )
: _( "Reference Designator Coordinates" ) );
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
message += wxString::Format( _( "\nSort Code %d" ), m_sortCode );
2020-04-21 01:44:17 +00:00
2020-11-13 01:33:30 +00:00
for( const RefDesInfo& mod : aFootprints )
2020-04-21 01:44:17 +00:00
{
message += wxString::Format( _( "\n%d %s UUID: [%s], X, Y: %s, Rounded X, Y, %s" ),
2020-08-11 12:34:53 +00:00
i++,
mod.RefDesString,
mod.Uuid.AsString(),
CoordTowxString( mod.x, mod.y ),
CoordTowxString( mod.roundedx, mod.roundedy ) );
2020-04-21 01:44:17 +00:00
}
}
ShowReport( message, RPT_SEVERITY_INFO );
}
2020-08-09 16:13:17 +00:00
bool DIALOG_BOARD_REANNOTATE::ReannotateBoard()
2020-04-21 01:44:17 +00:00
{
std::vector<RefDesInfo> BadRefDes;
wxString message, badrefdes;
STRING_FORMATTER stringformatter;
RefDesChange* newref;
NETLIST netlist;
2020-11-13 11:17:15 +00:00
if( !BuildFootprintList( BadRefDes ) )
2020-04-21 01:44:17 +00:00
{
2022-02-04 22:44:59 +00:00
ShowReport( _( "Selected options resulted in errors! Change them and try again." ),
2020-08-09 16:13:17 +00:00
RPT_SEVERITY_ERROR );
return false;
2020-04-21 01:44:17 +00:00
}
if( !BadRefDes.empty() )
{
2022-02-04 22:44:59 +00:00
message.Printf( _( "\nPCB has %d empty or invalid reference designations."
"\nRecommend running DRC with 'Test for parity between PCB and "
"schematic' checked.\n" ),
(int) BadRefDes.size() );
2020-04-21 01:44:17 +00:00
2020-08-11 12:34:53 +00:00
for( const RefDesInfo& mod : BadRefDes )
2020-04-21 01:44:17 +00:00
{
badrefdes += wxString::Format( _( "\nRefDes: %s Footprint: %s:%s at %s on PCB." ),
2020-08-11 12:34:53 +00:00
mod.RefDesString,
mod.FPID.GetLibNickname().wx_str(),
mod.FPID.GetLibItemName().wx_str(),
CoordTowxString( mod.x, mod.y ) );
2020-04-21 01:44:17 +00:00
}
2022-02-04 22:44:59 +00:00
ShowReport( message + badrefdes + wxT( "\n" ), RPT_SEVERITY_WARNING );
2020-08-11 12:34:53 +00:00
message += _( "Reannotate anyway?" );
2020-04-21 01:44:17 +00:00
if( !IsOK( m_frame, message ) )
2020-08-09 16:13:17 +00:00
return false;
}
2020-04-21 01:44:17 +00:00
BOARD_COMMIT commit( m_frame );
for( FOOTPRINT* footprint : m_footprints )
2020-11-13 11:17:15 +00:00
{
newref = GetNewRefDes( footprint );
2020-04-21 01:44:17 +00:00
if( nullptr == newref )
return false;
2020-04-21 01:44:17 +00:00
commit.Modify( footprint ); // Make a copy for undo
footprint->SetReference( newref->NewRefDes ); // Update the PCB reference
m_frame->GetCanvas()->GetView()->Update( footprint ); // Touch the footprint
2020-04-21 01:44:17 +00:00
}
2022-02-04 22:44:59 +00:00
commit.Push( wxT( "Geographic reannotation" ) );
return true;
2020-04-21 01:44:17 +00:00
}
2020-11-13 11:17:15 +00:00
bool DIALOG_BOARD_REANNOTATE::BuildFootprintList( std::vector<RefDesInfo>& aBadRefDes )
2020-04-21 01:44:17 +00:00
{
bool annotateSelected = m_AnnotateSelection->GetValue();
bool annotateFront = m_AnnotateFront->GetValue(); // Unless only doing back
bool annotateBack = m_AnnotateBack->GetValue(); // Unless only doing front
2020-11-13 11:17:15 +00:00
bool skipLocked = m_ExcludeLocked->GetValue();
2020-04-21 01:44:17 +00:00
int errorcount = 0;
size_t firstnum = 0;
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
m_frontFootprints.clear();
m_backFootprints.clear();
m_excludeArray.clear();
m_footprints = m_frame->GetBoard()->Footprints();
2020-04-21 01:44:17 +00:00
std::vector<KIID> selected;
if( annotateSelected )
2020-04-21 01:44:17 +00:00
{
for( EDA_ITEM* item : m_selection )
2020-11-13 02:57:11 +00:00
{
// Get the timestamps of selected footprints
2020-11-13 12:21:02 +00:00
if( item->Type() == PCB_FOOTPRINT_T )
2020-04-21 01:44:17 +00:00
selected.push_back( item->m_Uuid );
}
}
wxString exclude;
// Break exclude list into words.
2020-04-21 01:44:17 +00:00
for( auto thischar : m_ExcludeList->GetValue() )
{
2020-04-21 01:44:17 +00:00
if( ( ' ' == thischar ) || ( ',' == thischar ) )
{
2020-11-13 02:57:11 +00:00
m_excludeArray.push_back( exclude );
2020-04-21 01:44:17 +00:00
exclude.clear();
}
else
exclude += thischar;
if( !exclude.empty() )
2020-11-13 02:57:11 +00:00
m_excludeArray.push_back( exclude );
2020-04-21 01:44:17 +00:00
}
2020-11-13 11:17:15 +00:00
RefDesInfo fpData;
2020-08-11 12:34:53 +00:00
bool useModuleLocation = m_locationChoice->GetSelection() == 0;
2020-04-21 01:44:17 +00:00
2020-11-13 15:15:52 +00:00
for( FOOTPRINT* footprint : m_footprints )
2020-04-21 01:44:17 +00:00
{
2020-11-13 11:17:15 +00:00
fpData.Uuid = footprint->m_Uuid;
fpData.RefDesString = footprint->GetReference();
fpData.FPID = footprint->GetFPID();
fpData.x = useModuleLocation ? footprint->GetPosition().x
: footprint->Reference().GetPosition().x;
fpData.y = useModuleLocation ? footprint->GetPosition().y
: footprint->Reference().GetPosition().y;
fpData.roundedx = RoundToGrid( fpData.x, m_sortGridx ); // Round to sort
2020-11-13 11:17:15 +00:00
fpData.roundedy = RoundToGrid( fpData.y, m_sortGridy );
fpData.Front = footprint->GetLayer() == F_Cu;
fpData.Action = UpdateRefDes; // Usually good
2020-11-13 11:17:15 +00:00
if( fpData.RefDesString.IsEmpty() )
{
fpData.Action = EmptyRefDes;
}
2020-04-21 01:44:17 +00:00
else
{
2022-02-04 22:44:59 +00:00
firstnum = fpData.RefDesString.find_first_of( wxT( "0123456789" ) );
2020-04-21 01:44:17 +00:00
if( std::string::npos == firstnum )
fpData.Action = InvalidRefDes; // do not change ref des such as 12 or +1, or L
2020-04-21 01:44:17 +00:00
}
// Get the type (R, C, etc)
2020-11-13 11:17:15 +00:00
fpData.RefDesType = fpData.RefDesString.substr( 0, firstnum );
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
for( wxString excluded : m_excludeArray )
2020-04-21 01:44:17 +00:00
{
if( excluded == fpData.RefDesType ) // Am I supposed to exclude this type?
2020-04-21 01:44:17 +00:00
{
fpData.Action = Exclude; // Yes
2020-04-21 01:44:17 +00:00
break;
}
}
if(( fpData.Front && annotateBack ) || // If a front fp and doing backs only
( !fpData.Front && annotateFront ) || // If a back fp and doing front only
2020-11-13 11:17:15 +00:00
( footprint->IsLocked() && skipLocked ) ) // If excluding locked and it is locked
2020-11-13 02:57:11 +00:00
{
2020-11-13 11:17:15 +00:00
fpData.Action = Exclude;
2020-11-13 02:57:11 +00:00
}
2020-04-21 01:44:17 +00:00
2020-11-13 11:17:15 +00:00
if( annotateSelected )
{ // If only annotating selected c
2020-11-13 11:17:15 +00:00
fpData.Action = Exclude; // Assume it isn't selected
2020-04-21 01:44:17 +00:00
for( KIID sel : selected )
{
2020-11-13 11:17:15 +00:00
if( fpData.Uuid == sel )
{ // Found in selected footprints
fpData.Action = UpdateRefDes; // Update it
2020-04-21 01:44:17 +00:00
break;
}
}
}
2020-11-13 11:17:15 +00:00
if( fpData.Front )
m_frontFootprints.push_back( fpData );
2020-04-21 01:44:17 +00:00
else
2020-11-13 11:17:15 +00:00
m_backFootprints.push_back( fpData );
2020-04-21 01:44:17 +00:00
}
// Determine the sort order for the front.
SetSortCodes( FrontDirectionsArray, m_sortCode );
2020-04-21 01:44:17 +00:00
// Sort the front footprints.
sort( m_frontFootprints.begin(), m_frontFootprints.end(), ModuleCompare );
// Determine the sort order for the back.
SetSortCodes( BackDirectionsArray, m_sortCode );
// Sort the back footprints.
sort( m_backFootprints.begin(), m_backFootprints.end(), ModuleCompare );
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
m_refDesTypes.clear();
m_changeArray.clear();
BuildUnavailableRefsList();
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
if( !m_frontFootprints.empty() )
{
BuildChangeArray( m_frontFootprints, wxAtoi( m_FrontRefDesStart->GetValue() ),
2020-08-09 16:13:17 +00:00
m_FrontPrefix->GetValue(), m_RemoveFrontPrefix->GetValue(), aBadRefDes );
2020-11-13 02:57:11 +00:00
}
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
if( !m_backFootprints.empty() )
{
BuildChangeArray( m_backFootprints, wxAtoi( m_BackRefDesStart->GetValue() ),
m_BackPrefix->GetValue(), m_RemoveBackPrefix->GetValue(), aBadRefDes );
2020-11-13 02:57:11 +00:00
}
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
if( !m_changeArray.empty() )
sort( m_changeArray.begin(), m_changeArray.end(), ChangeArrayCompare );
2020-04-21 01:44:17 +00:00
LogChangePlan();
2020-11-13 02:57:11 +00:00
size_t changearraysize = m_changeArray.size();
2020-08-09 16:13:17 +00:00
for( size_t i = 0; i < changearraysize; i++ ) // Scan through for duplicates if update or skip
2020-04-21 01:44:17 +00:00
{
2020-11-13 02:57:11 +00:00
if( ( m_changeArray[i].Action != EmptyRefDes )
&& ( m_changeArray[i].Action != InvalidRefDes ) )
2020-04-21 01:44:17 +00:00
{
for( size_t j = i + 1; j < changearraysize; j++ )
{
2020-11-13 02:57:11 +00:00
if( m_changeArray[i].NewRefDes == m_changeArray[j].NewRefDes )
2020-04-21 01:44:17 +00:00
{
ShowReport( wxString::Format( _( "Duplicate instances of %s" ),
m_changeArray[j].NewRefDes ),
2020-08-09 16:13:17 +00:00
RPT_SEVERITY_ERROR );
2020-04-21 01:44:17 +00:00
if( errorcount++ > MAXERROR )
{
ShowReport( _( "Aborted: too many errors" ), RPT_SEVERITY_ERROR );
2020-04-21 01:44:17 +00:00
break;
}
}
}
}
if( errorcount > MAXERROR )
break;
}
return ( 0 == errorcount );
2020-08-09 16:13:17 +00:00
}
2020-04-21 01:44:17 +00:00
void DIALOG_BOARD_REANNOTATE::BuildUnavailableRefsList()
{
std::vector<RefDesInfo> excludedFootprints;
for( RefDesInfo fpData : m_frontFootprints )
{
if( fpData.Action == Exclude )
excludedFootprints.push_back( fpData );
}
for( RefDesInfo fpData : m_backFootprints )
{
if( fpData.Action == Exclude )
excludedFootprints.push_back( fpData );
}
for( RefDesInfo fpData : excludedFootprints )
{
if( fpData.Action == Exclude )
{
RefDesTypeStr* refDesInfo = GetOrBuildRefDesInfo( fpData.RefDesType );
refDesInfo->UnavailableRefs.insert( UTIL::GetRefDesNumber( fpData.RefDesString ) );
}
}
}
2020-04-21 01:44:17 +00:00
2020-11-13 01:33:30 +00:00
void DIALOG_BOARD_REANNOTATE::BuildChangeArray( std::vector<RefDesInfo>& aFootprints,
unsigned int aStartRefDes, const wxString& aPrefix,
2020-08-09 16:13:17 +00:00
bool aRemovePrefix,
std::vector<RefDesInfo>& aBadRefDes )
2020-04-21 01:44:17 +00:00
{
size_t prefixsize = aPrefix.size();
bool haveprefix = ( 0 != prefixsize ); // Do I have a prefix?
bool addprefix = haveprefix & !aRemovePrefix; // Yes- and I'm not removing it
aRemovePrefix &= haveprefix; // Only remove if I have a prefix
2020-04-21 01:44:17 +00:00
bool prefixpresent; // Prefix found
2020-04-21 01:44:17 +00:00
2020-11-13 01:33:30 +00:00
wxString logstring = ( aFootprints.front().Front ) ? _( "\n\nFront Footprints" )
: _( "\n\nBack Footprints" );
LogFootprints( logstring, aFootprints );
2020-04-21 01:44:17 +00:00
if( 0 != aStartRefDes ) // Initialize the change array if present
2020-11-13 01:33:30 +00:00
{
for( size_t i = 0; i < m_refDesTypes.size(); i++ )
m_refDesTypes[i].LastUsedRefDes = aStartRefDes;
2020-11-13 01:33:30 +00:00
}
2020-04-21 01:44:17 +00:00
2020-11-13 11:17:15 +00:00
for( RefDesInfo fpData : aFootprints )
{
RefDesChange change;
2020-11-13 11:17:15 +00:00
change.Uuid = fpData.Uuid;
change.Action = fpData.Action;
change.OldRefDesString = fpData.RefDesString;
change.NewRefDes = fpData.RefDesString;
change.Front = fpData.Front;
2020-04-21 01:44:17 +00:00
2020-11-13 11:17:15 +00:00
if( fpData.RefDesString.IsEmpty() )
fpData.Action = EmptyRefDes;
2020-04-21 01:44:17 +00:00
if( ( change.Action == EmptyRefDes ) || ( change.Action == InvalidRefDes ) )
{
2020-11-13 02:57:11 +00:00
m_changeArray.push_back( change );
2020-11-13 11:17:15 +00:00
aBadRefDes.push_back( fpData );
2020-04-21 01:44:17 +00:00
continue;
}
if( change.Action == UpdateRefDes )
{
2020-11-13 11:17:15 +00:00
prefixpresent = ( 0 == fpData.RefDesType.find( aPrefix ) );
2020-04-21 01:44:17 +00:00
if( addprefix && !prefixpresent )
fpData.RefDesType.insert( 0, aPrefix ); // Add prefix once only
2020-04-21 01:44:17 +00:00
if( aRemovePrefix && prefixpresent ) // If there is a prefix remove it
2020-11-13 11:17:15 +00:00
fpData.RefDesType.erase( 0, prefixsize );
2020-04-21 01:44:17 +00:00
RefDesTypeStr* refDesInfo = GetOrBuildRefDesInfo( fpData.RefDesType, aStartRefDes );
unsigned int newRefDesNumber = refDesInfo->LastUsedRefDes + 1;
2020-04-21 01:44:17 +00:00
while( refDesInfo->UnavailableRefs.count( newRefDesNumber ) )
newRefDesNumber++;
2020-04-21 01:44:17 +00:00
change.NewRefDes = refDesInfo->RefDesType + std::to_string( newRefDesNumber );
refDesInfo->LastUsedRefDes = newRefDesNumber;
2020-04-21 01:44:17 +00:00
}
m_changeArray.push_back( change );
2020-08-09 16:13:17 +00:00
}
}
2020-04-21 01:44:17 +00:00
2020-11-13 15:15:52 +00:00
RefDesChange* DIALOG_BOARD_REANNOTATE::GetNewRefDes( FOOTPRINT* aFootprint )
2020-04-21 01:44:17 +00:00
{
size_t i;
2020-11-13 02:57:11 +00:00
for( i = 0; i < m_changeArray.size(); i++ )
{
if( aFootprint->m_Uuid == m_changeArray[i].Uuid )
return ( &m_changeArray[i] );
}
2020-04-21 01:44:17 +00:00
2020-11-13 02:57:11 +00:00
ShowReport( _( "Footprint not found in changelist" ) + wxS( " " ) + aFootprint->GetReference(),
RPT_SEVERITY_ERROR );
return nullptr; // Should never happen
2020-04-21 01:44:17 +00:00
}