512 lines
17 KiB
C++
512 lines
17 KiB
C++
/*
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 2010 Jean-Pierre Charras, jp.charras at wanadoo.fr
|
|
* Copyright (C) 2016 - 2020 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
|
|
*/
|
|
|
|
#include <bitmaps.h>
|
|
#include <sch_painter.h>
|
|
#include <symbol_edit_frame.h>
|
|
#include <lib_pin.h>
|
|
#include <dialog_pin_properties.h>
|
|
#include <confirm.h>
|
|
#include <widgets/tab_traversal.h>
|
|
#include <widgets/wx_grid.h>
|
|
#include <grid_tricks.h>
|
|
#include <widgets/grid_icon_text_helpers.h>
|
|
|
|
class ALT_PIN_DATA_MODEL : public wxGridTableBase, public std::vector<LIB_PIN::ALT>
|
|
{
|
|
public:
|
|
ALT_PIN_DATA_MODEL( EDA_UNITS aUserUnits )
|
|
{
|
|
}
|
|
|
|
int GetNumberRows() override { return (int) size(); }
|
|
int GetNumberCols() override { return COL_COUNT; }
|
|
|
|
wxString GetColLabelValue( int aCol ) override
|
|
{
|
|
switch( aCol )
|
|
{
|
|
case COL_NAME: return _( "Alternate Pin Name" );
|
|
case COL_TYPE: return _( "Electrical Type" );
|
|
case COL_SHAPE: return _( "Graphic Style" );
|
|
default: wxFAIL; return wxEmptyString;
|
|
}
|
|
}
|
|
|
|
bool IsEmptyCell( int row, int col ) override
|
|
{
|
|
return false; // don't allow adjacent cell overflow, even if we are actually empty
|
|
}
|
|
|
|
wxString GetValue( int aRow, int aCol ) override
|
|
{
|
|
switch( aCol )
|
|
{
|
|
case COL_NAME: return at( aRow ).m_Name;
|
|
case COL_TYPE: return PinTypeNames()[static_cast<int>( at( aRow ).m_Type )];
|
|
case COL_SHAPE: return PinShapeNames()[static_cast<int>( at( aRow ).m_Shape )];
|
|
default: wxFAIL; return wxEmptyString;
|
|
}
|
|
}
|
|
|
|
void SetValue( int aRow, int aCol, const wxString &aValue ) override
|
|
{
|
|
switch( aCol )
|
|
{
|
|
case COL_NAME:
|
|
at( aRow ).m_Name = aValue;
|
|
break;
|
|
|
|
case COL_TYPE:
|
|
if( PinTypeNames().Index( aValue ) != wxNOT_FOUND )
|
|
at( aRow ).m_Type = (ELECTRICAL_PINTYPE) PinTypeNames().Index( aValue );
|
|
|
|
break;
|
|
|
|
case COL_SHAPE:
|
|
if( PinShapeNames().Index( aValue ) != wxNOT_FOUND )
|
|
at( aRow ).m_Shape = (GRAPHIC_PINSHAPE) PinShapeNames().Index( aValue );
|
|
|
|
break;
|
|
|
|
default:
|
|
wxFAIL;
|
|
break;
|
|
}
|
|
}
|
|
|
|
void AppendRow( const LIB_PIN::ALT& aAlt )
|
|
{
|
|
push_back( aAlt );
|
|
|
|
if ( GetView() )
|
|
{
|
|
wxGridTableMessage msg( this, wxGRIDTABLE_NOTIFY_ROWS_APPENDED, 1 );
|
|
GetView()->ProcessTableMessage( msg );
|
|
}
|
|
}
|
|
|
|
void RemoveRow( int aRow )
|
|
{
|
|
erase( begin() + aRow );
|
|
|
|
if ( GetView() )
|
|
{
|
|
wxGridTableMessage msg( this, wxGRIDTABLE_NOTIFY_ROWS_DELETED, aRow, 1 );
|
|
GetView()->ProcessTableMessage( msg );
|
|
}
|
|
}
|
|
};
|
|
|
|
|
|
DIALOG_PIN_PROPERTIES::DIALOG_PIN_PROPERTIES( SYMBOL_EDIT_FRAME* parent, LIB_PIN* aPin ) :
|
|
DIALOG_PIN_PROPERTIES_BASE( parent ),
|
|
m_frame( parent ),
|
|
m_pin( aPin ),
|
|
m_posX( parent, m_posXLabel, m_posXCtrl, m_posXUnits ),
|
|
m_posY( parent, m_posYLabel, m_posYCtrl, m_posYUnits ),
|
|
m_pinLength( parent, m_pinLengthLabel, m_pinLengthCtrl, m_pinLengthUnits ),
|
|
m_nameSize( parent, m_nameSizeLabel, m_nameSizeCtrl, m_nameSizeUnits ),
|
|
m_numberSize( parent, m_numberSizeLabel, m_numberSizeCtrl, m_numberSizeUnits ),
|
|
m_delayedFocusRow( -1 ),
|
|
m_delayedFocusColumn( -1 ),
|
|
m_initialized( false )
|
|
{
|
|
// Creates a dummy pin to show on a panel, inside this dialog:
|
|
m_dummyPin = new LIB_PIN( *m_pin );
|
|
|
|
m_bSizerInfo->Show( m_frame->m_SyncPinEdit );
|
|
|
|
if( m_frame->m_SyncPinEdit )
|
|
{
|
|
if( aPin->IsNew() )
|
|
{
|
|
m_textInfoUpper->SetLabel( _( "Synchronized pins edit mode, and this pin is new" ) );
|
|
m_textInfoLower->SetLabel( _( "Similar pins will be automatically added to other units, "
|
|
"if this pin is not common to all units" ) );
|
|
}
|
|
else
|
|
{
|
|
m_textInfoUpper->SetLabel( _( "Synchronized pins edit mode" ) );
|
|
m_textInfoLower->SetLabel( _( "Similar pins at the same location will be edited. "
|
|
"Pin number of other pins will be not modified" ) );
|
|
}
|
|
}
|
|
|
|
COLOR4D bgColor = parent->GetRenderSettings()->GetLayerColor( LAYER_SCHEMATIC_BACKGROUND );
|
|
m_panelShowPin->SetBackgroundColour( bgColor.ToColour() );
|
|
|
|
const wxArrayString& orientationNames = PinOrientationNames();
|
|
const std::vector<BITMAPS>& orientationIcons = PinOrientationIcons();
|
|
|
|
for ( unsigned ii = 0; ii < orientationNames.GetCount(); ii++ )
|
|
m_choiceOrientation->Insert( orientationNames[ii], KiBitmap( orientationIcons[ii] ), ii );
|
|
|
|
// We can't set the tab order through wxWidgets due to shortcomings in their mnemonics
|
|
// implementation on MSW
|
|
m_tabOrder = {
|
|
m_textPinName,
|
|
m_textPinNumber,
|
|
m_choiceElectricalType,
|
|
m_choiceStyle,
|
|
m_posXCtrl,
|
|
m_posYCtrl,
|
|
m_choiceOrientation,
|
|
m_pinLengthCtrl,
|
|
m_nameSizeCtrl,
|
|
m_numberSizeCtrl,
|
|
m_checkApplyToAllParts,
|
|
m_checkApplyToAllConversions,
|
|
m_checkShow,
|
|
m_sdbSizerButtonsOK,
|
|
m_sdbSizerButtonsCancel
|
|
};
|
|
|
|
// Default alternates turndow to whether or not alternates exist
|
|
m_alternatesTurndown->Collapse( m_pin->GetAlternates().size() == 0 );
|
|
|
|
m_alternatesDataModel = new ALT_PIN_DATA_MODEL( GetUserUnits() );
|
|
|
|
// Save original columns widths so we can do proportional sizing.
|
|
for( int i = 0; i < COL_COUNT; ++i )
|
|
m_originalColWidths[ i ] = m_alternatesGrid->GetColSize( i );
|
|
|
|
// Give a bit more room for combobox editors
|
|
m_alternatesGrid->SetDefaultRowSize( m_alternatesGrid->GetDefaultRowSize() + 4 );
|
|
|
|
m_alternatesGrid->SetTable( m_alternatesDataModel );
|
|
m_alternatesGrid->PushEventHandler( new GRID_TRICKS( m_alternatesGrid ) );
|
|
|
|
if( aPin->GetParent()->HasConversion() )
|
|
{
|
|
m_alternatesTurndown->Collapse();
|
|
m_alternatesTurndown->Disable();
|
|
m_alternatesTurndown->SetToolTip(
|
|
_( "Alternate pin assignments are not available for De Morgan symbols." ) );
|
|
}
|
|
|
|
// Set special attributes
|
|
wxGridCellAttr* attr;
|
|
|
|
attr = new wxGridCellAttr;
|
|
attr->SetRenderer( new GRID_CELL_ICON_TEXT_RENDERER( PinTypeIcons(), PinTypeNames() ) );
|
|
attr->SetEditor( new GRID_CELL_ICON_TEXT_POPUP( PinTypeIcons(), PinTypeNames() ) );
|
|
m_alternatesGrid->SetColAttr( COL_TYPE, attr );
|
|
|
|
attr = new wxGridCellAttr;
|
|
attr->SetRenderer( new GRID_CELL_ICON_TEXT_RENDERER( PinShapeIcons(), PinShapeNames() ) );
|
|
attr->SetEditor( new GRID_CELL_ICON_TEXT_POPUP( PinShapeIcons(), PinShapeNames() ) );
|
|
m_alternatesGrid->SetColAttr( COL_SHAPE, attr );
|
|
|
|
m_addAlternate->SetBitmap( KiBitmap( BITMAPS::small_plus ) );
|
|
m_deleteAlternate->SetBitmap( KiBitmap( BITMAPS::small_trash ) );
|
|
m_addAlternate->GetParent()->Layout();
|
|
|
|
m_sdbSizerButtonsOK->SetDefault();
|
|
SetInitialFocus( m_textPinName );
|
|
|
|
// Now all widgets have the size fixed, call FinishDialogSettings
|
|
finishDialogSettings();
|
|
|
|
// On some window managers (Unity, XFCE) the dialog is not always raised, depending on
|
|
// how it is run.
|
|
Raise();
|
|
|
|
m_initialized = true;
|
|
m_width = 0;
|
|
}
|
|
|
|
|
|
DIALOG_PIN_PROPERTIES::~DIALOG_PIN_PROPERTIES()
|
|
{
|
|
delete m_dummyPin;
|
|
|
|
// Prevents crash bug in wxGrid's d'tor
|
|
m_alternatesGrid->DestroyTable( m_alternatesDataModel );
|
|
|
|
// Delete the GRID_TRICKS.
|
|
m_alternatesGrid->PopEventHandler( true );
|
|
}
|
|
|
|
|
|
bool DIALOG_PIN_PROPERTIES::TransferDataToWindow()
|
|
{
|
|
if( !DIALOG_SHIM::TransferDataToWindow() )
|
|
return false;
|
|
|
|
m_origPos = m_pin->GetPosition();
|
|
|
|
m_choiceOrientation->SetSelection( PinOrientationIndex( m_pin->GetOrientation() ) );
|
|
m_choiceStyle->SetSelection( m_pin->GetShape() );
|
|
m_choiceElectricalType->SetSelection( m_pin->GetType() );
|
|
m_textPinName->SetValue( m_pin->GetName() );
|
|
m_nameSize.SetValue( m_pin->GetNameTextSize() );
|
|
m_posX.SetValue( m_origPos.x );
|
|
m_posY.SetValue( -m_origPos.y );
|
|
m_textPinNumber->SetValue( m_pin->GetNumber() );
|
|
m_numberSize.SetValue( m_pin->GetNumberTextSize() );
|
|
m_pinLength.SetValue( m_pin->GetLength() );
|
|
m_checkApplyToAllParts->SetValue( m_pin->GetUnit() == 0 );
|
|
m_checkApplyToAllConversions->SetValue( m_pin->GetConvert() == 0 );
|
|
m_checkShow->SetValue( m_pin->IsVisible() );
|
|
|
|
m_dummyPin->SetVisible( m_pin->IsVisible() );
|
|
|
|
bool hasMultiUnit = m_pin->GetParent()->GetUnitCount() > 1;
|
|
|
|
m_checkApplyToAllParts->Enable( hasMultiUnit );
|
|
|
|
wxString toolTip;
|
|
|
|
if( !hasMultiUnit )
|
|
toolTip = _( "This symbol only has one unit. This control has no effect." );
|
|
else if( m_frame->m_SyncPinEdit )
|
|
toolTip = _( "Synchronized pin edit mode is enabled.\n"
|
|
"Similar pins will be edited, regardless this option." );
|
|
else
|
|
toolTip = _( "If checked, this pin will exist in all units." );
|
|
|
|
m_checkApplyToAllParts->SetToolTip( toolTip );
|
|
|
|
for( const std::pair<const wxString, LIB_PIN::ALT>& alt : m_pin->GetAlternates() )
|
|
m_alternatesDataModel->AppendRow( alt.second );
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
bool DIALOG_PIN_PROPERTIES::TransferDataFromWindow()
|
|
{
|
|
if( !m_alternatesGrid->CommitPendingChanges() )
|
|
return false;
|
|
|
|
// Check for missing alternate names.
|
|
for( size_t i = 0; i < m_alternatesDataModel->size(); ++i )
|
|
{
|
|
if( m_alternatesDataModel->at( i ).m_Name.IsEmpty() )
|
|
{
|
|
DisplayErrorMessage( this, _( "Alternate pin definitions must have a name." ) );
|
|
|
|
m_delayedFocusColumn = COL_NAME;
|
|
m_delayedFocusRow = i;
|
|
|
|
return false;
|
|
}
|
|
}
|
|
|
|
if( !DIALOG_SHIM::TransferDataFromWindow() )
|
|
return false;
|
|
|
|
wxPoint newPos( m_posX.GetValue(), -m_posY.GetValue() );
|
|
|
|
const int acceptable_mingrid = 50;
|
|
|
|
// Only show the warning if the position has been changed
|
|
if( ( m_origPos != newPos )
|
|
&& ( ( m_posX.GetValue() % acceptable_mingrid ) || ( m_posY.GetValue() % acceptable_mingrid ) ) )
|
|
{
|
|
auto msg = wxString::Format( _( "This pin is not on a %d mils grid which will make it\n"
|
|
"difficult to connect to in the schematic.\n"
|
|
"Do you want to continue?" ),
|
|
acceptable_mingrid );
|
|
if( !IsOK( this, msg ) )
|
|
return false;
|
|
}
|
|
|
|
m_pin->SetName( m_textPinName->GetValue() );
|
|
m_pin->SetNumber( m_textPinNumber->GetValue() );
|
|
m_pin->SetNameTextSize( m_nameSize.GetValue() );
|
|
m_pin->SetNumberTextSize( m_numberSize.GetValue() );
|
|
m_pin->SetOrientation( PinOrientationCode( m_choiceOrientation->GetSelection() ) );
|
|
m_pin->SetLength( m_pinLength.GetValue() );
|
|
m_pin->SetPosition( newPos );
|
|
m_pin->SetType( m_choiceElectricalType->GetPinTypeSelection() );
|
|
m_pin->SetShape( m_choiceStyle->GetPinShapeSelection() );
|
|
m_pin->SetConvert( m_checkApplyToAllConversions->GetValue() ? 0 : m_frame->GetConvert() );
|
|
m_pin->SetUnit( m_checkApplyToAllParts->GetValue() ? 0 : m_frame->GetUnit() );
|
|
m_pin->SetVisible( m_checkShow->GetValue() );
|
|
|
|
std::map<wxString, LIB_PIN::ALT>& alternates = m_pin->GetAlternates();
|
|
alternates.clear();
|
|
|
|
for( const LIB_PIN::ALT& alt : *m_alternatesDataModel )
|
|
alternates[ alt.m_Name ] = alt;
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
/*
|
|
* Draw (on m_panelShowPin) the pin according to current settings in dialog
|
|
*/
|
|
void DIALOG_PIN_PROPERTIES::OnPaintShowPanel( wxPaintEvent& event )
|
|
{
|
|
wxPaintDC dc( m_panelShowPin );
|
|
wxSize dc_size = dc.GetSize();
|
|
dc.SetDeviceOrigin( dc_size.x / 2, dc_size.y / 2 );
|
|
|
|
// Give a parent to m_dummyPin only from draw purpose.
|
|
// In fact m_dummyPin should not have a parent, but draw functions need a parent
|
|
// to know some options, about pin texts
|
|
SYMBOL_EDIT_FRAME* symbolEditor = (SYMBOL_EDIT_FRAME*) GetParent();
|
|
|
|
// Calculate a suitable scale to fit the available draw area
|
|
EDA_RECT bBox = m_dummyPin->GetBoundingBox( true );
|
|
double xscale = (double) dc_size.x / bBox.GetWidth();
|
|
double yscale = (double) dc_size.y / bBox.GetHeight();
|
|
double scale = std::min( xscale, yscale );
|
|
|
|
// Give a 10% margin and limit to no more than 100% zoom
|
|
scale = std::min( scale * 0.9, 1.0 );
|
|
dc.SetUserScale( scale, scale );
|
|
GRResetPenAndBrush( &dc );
|
|
|
|
LIB_SYMBOL_OPTIONS opts;
|
|
opts.draw_hidden_fields = true;
|
|
opts.show_connect_point = true;
|
|
|
|
RENDER_SETTINGS* renderSettings = symbolEditor->GetRenderSettings();
|
|
renderSettings->SetPrintDC( &dc );
|
|
|
|
m_dummyPin->Print( renderSettings, -bBox.Centre(), (void*) &opts, DefaultTransform );
|
|
|
|
event.Skip();
|
|
}
|
|
|
|
|
|
void DIALOG_PIN_PROPERTIES::OnPropertiesChange( wxCommandEvent& event )
|
|
{
|
|
if( !IsShown() ) // do nothing at init time
|
|
return;
|
|
|
|
m_dummyPin->SetName( m_textPinName->GetValue() );
|
|
m_dummyPin->SetNumber( m_textPinNumber->GetValue() );
|
|
m_dummyPin->SetNameTextSize( m_nameSize.GetValue() );
|
|
m_dummyPin->SetNumberTextSize( m_numberSize.GetValue() );
|
|
m_dummyPin->SetOrientation( PinOrientationCode( m_choiceOrientation->GetSelection() ) );
|
|
m_dummyPin->SetLength( m_pinLength.GetValue() );
|
|
m_dummyPin->SetType( m_choiceElectricalType->GetPinTypeSelection() );
|
|
m_dummyPin->SetShape( m_choiceStyle->GetPinShapeSelection() );
|
|
m_dummyPin->SetVisible( m_checkShow->GetValue() );
|
|
|
|
m_panelShowPin->Refresh();
|
|
}
|
|
|
|
|
|
void DIALOG_PIN_PROPERTIES::OnAddAlternate( wxCommandEvent& event )
|
|
{
|
|
if( !m_alternatesGrid->CommitPendingChanges() )
|
|
return;
|
|
|
|
LIB_PIN::ALT newAlt;
|
|
newAlt.m_Name = wxEmptyString;
|
|
newAlt.m_Type = m_pin->GetType();
|
|
newAlt.m_Shape = m_pin->GetShape();
|
|
|
|
m_alternatesDataModel->AppendRow( newAlt );
|
|
|
|
m_alternatesGrid->MakeCellVisible( m_alternatesGrid->GetNumberRows() - 1, 0 );
|
|
m_alternatesGrid->SetGridCursor( m_alternatesGrid->GetNumberRows() - 1, 0 );
|
|
|
|
m_alternatesGrid->EnableCellEditControl( true );
|
|
m_alternatesGrid->ShowCellEditControl();
|
|
}
|
|
|
|
|
|
void DIALOG_PIN_PROPERTIES::OnDeleteAlternate( wxCommandEvent& event )
|
|
{
|
|
if( !m_alternatesGrid->CommitPendingChanges() )
|
|
return;
|
|
|
|
if( m_alternatesDataModel->size() == 0 ) // empty table
|
|
return;
|
|
|
|
int curRow = m_alternatesGrid->GetGridCursorRow();
|
|
|
|
if( curRow < 0 )
|
|
return;
|
|
|
|
m_alternatesDataModel->RemoveRow( curRow );
|
|
|
|
curRow = std::max( 0, curRow - 1 );
|
|
m_alternatesGrid->MakeCellVisible( curRow, m_alternatesGrid->GetGridCursorCol() );
|
|
m_alternatesGrid->SetGridCursor( curRow, m_alternatesGrid->GetGridCursorCol() );
|
|
}
|
|
|
|
|
|
void DIALOG_PIN_PROPERTIES::adjustGridColumns( int aWidth )
|
|
{
|
|
m_width = aWidth;
|
|
|
|
// Account for margins
|
|
aWidth -= 30;
|
|
|
|
wxGridUpdateLocker deferRepaintsTillLeavingScope;
|
|
|
|
m_alternatesGrid->SetColSize( COL_TYPE, m_originalColWidths[ COL_TYPE ] );
|
|
m_alternatesGrid->SetColSize( COL_SHAPE, m_originalColWidths[ COL_SHAPE ] );
|
|
|
|
m_alternatesGrid->SetColSize( COL_NAME, aWidth - m_originalColWidths[ COL_TYPE ]
|
|
- m_originalColWidths[ COL_SHAPE ] );
|
|
}
|
|
|
|
|
|
void DIALOG_PIN_PROPERTIES::OnSize( wxSizeEvent& event )
|
|
{
|
|
auto new_size = event.GetSize().GetX();
|
|
|
|
if( m_initialized && m_width != new_size )
|
|
adjustGridColumns( new_size );
|
|
|
|
// Always propagate for a grid repaint (needed if the height changes, as well as width)
|
|
event.Skip();
|
|
}
|
|
|
|
|
|
void DIALOG_PIN_PROPERTIES::OnUpdateUI( wxUpdateUIEvent& event )
|
|
{
|
|
// Handle a delayed focus
|
|
if( m_delayedFocusRow >= 0 )
|
|
{
|
|
m_alternatesTurndown->Collapse( false );
|
|
|
|
m_alternatesGrid->SetFocus();
|
|
m_alternatesGrid->MakeCellVisible( m_delayedFocusRow, m_delayedFocusColumn );
|
|
m_alternatesGrid->SetGridCursor( m_delayedFocusRow, m_delayedFocusColumn );
|
|
|
|
m_alternatesGrid->EnableCellEditControl( true );
|
|
m_alternatesGrid->ShowCellEditControl();
|
|
|
|
m_delayedFocusRow = -1;
|
|
m_delayedFocusColumn = -1;
|
|
}
|
|
}
|
|
|
|
|
|
void DIALOG_PIN_PROPERTIES::onUpdateUIInfo( wxUpdateUIEvent& event )
|
|
{
|
|
// Disable Info texts for pins common to all units
|
|
event.Enable( m_checkApplyToAllParts->GetValue() == 0 );
|
|
}
|