footprint_editor_utils.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright The 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, see <https://www.gnu.org/licenses/>.
 */
 
#include <board_commit.h>
#include <confirm.h>
#include <dialog_footprint_properties_fp_editor.h>
#include <footprint_edit_frame.h>
#include <footprint_info.h>
#include <footprint_tree_pane.h>
#include <footprint_library_adapter.h>
#include <functional>
#include <kiway_mail.h>
#include <pcb_group.h>
#include <pcb_marker.h>
#include <pcb_textbox.h>
#include <pcb_barcode.h>
#include <pcb_table.h>
#include <pcb_shape.h>
#include <pad.h>
#include <zone.h>
#include <settings/color_settings.h>
#include <tool/tool_manager.h>
#include <tools/pcb_actions.h>
#include <tools/footprint_editor_control.h>
#include <widgets/appearance_controls.h>
#include <widgets/editor_tabs_panel.h>
#include <widgets/lib_tree.h>
#include <pcb_layer_box_selector.h>
#include <pcb_dimension.h>
#include <project_pcb.h>
#include <view/view_controls.h>
#include <dialogs/dialog_dimension_properties.h>
#include <dialogs/dialog_table_properties.h>
 
using namespace std::placeholders;
 
 
void FOOTPRINT_EDIT_FRAME::LoadFootprintFromLibrary( LIB_ID aFPID )
{
    bool is_last_fp_from_brd = IsCurrentFPFromBoard();
 
    // The legacy path wipes the shared board; the tab path leaves other tabs untouched.
    const bool useTabs = ( m_tabsPanel != nullptr ) && aFPID.IsValid();
 
    if( useTabs )
    {
        const wxString key = aFPID.GetLibNickname().wx_str() + wxT( ':' ) + aFPID.GetLibItemName().wx_str();
 
        // Reactivate rather than reload, which would discard in-tab edits.
        if( int existing = m_tabsPanel->FindTab( key ); existing >= 0 )
        {
            m_tabsPanel->SelectTab( existing );
 
            m_treePane->GetLibTree()->ExpandLibId( aFPID );
 
            m_centerItemOnIdle = aFPID;
            Bind( wxEVT_IDLE, &FOOTPRINT_EDIT_FRAME::centerItemIdleHandler, this );
 
            m_treePane->GetLibTree()->RefreshLibTree();        // update highlighting
 
            return;
        }
    }
 
    FOOTPRINT* footprint = LoadFootprint( aFPID );
 
    if( !footprint )
        return;
 
    if( useTabs )
    {
        // A board-sourced or new footprint occupies the frame-owned board with no backing tab.
        // Switching to the library footprint's tab frees that board, so prompt to save those edits
        // first, the same way the legacy single-board path does. A tab-owned board survives the
        // switch untouched and needs no prompt.
        if( !activeBoardOwnedByTab() && IsContentModified() )
        {
            if( !HandleUnsavedChanges(
                        this, _( "The current footprint has been modified.  Save changes?" ),
                        [&]() -> bool
                        {
                            return SaveFootprint( GetBoard()->Footprints().front() );
                        } ) )
            {
                // AddFootprintToBoard would have taken ownership; on cancel we still own the clone.
                delete footprint;
                return;
            }
        }
 
        GetCanvas()->GetViewControls()->SetCrossHairCursorPosition( VECTOR2D( 0, 0 ), false );
        AddFootprintToBoard( footprint );
    }
    else
    {
        if( !Clear_Pcb( true ) )
        {
            // AddFootprintToBoard would have taken ownership; on cancel we still own the clone.
            delete footprint;
            return;
        }
 
        GetCanvas()->GetViewControls()->SetCrossHairCursorPosition( VECTOR2D( 0, 0 ), false );
        AddFootprintToBoard( footprint );
    }
 
    footprint->ClearFlags();
 
    // if either reference or value are missing, reinstall them -
    // otherwise you cannot see what you are doing on board
    if( footprint->Reference().GetText().IsEmpty() )
        footprint->SetReference( wxT( "Ref**" ) );
 
    if( footprint->Value().GetText().IsEmpty() )
        footprint->SetValue( wxT( "Val**" ) );
 
    Zoom_Automatique( false );
 
    Update3DView( true, true );
 
    GetScreen()->SetContentModified( false );
 
    UpdateView();
    GetCanvas()->Refresh();
 
    // Update the save items if needed.
    if( is_last_fp_from_brd )
    {
        ReCreateMenuBar();
        ReCreateHToolbar();
    }
 
    m_treePane->GetLibTree()->ExpandLibId( aFPID );
 
    m_centerItemOnIdle = aFPID;
    Bind( wxEVT_IDLE, &FOOTPRINT_EDIT_FRAME::centerItemIdleHandler, this );
 
    m_treePane->GetLibTree()->RefreshLibTree();        // update highlighting
}
 
 
bool FOOTPRINT_EDIT_FRAME::BeginNewFootprint( const wxString& aLibrary )
{
    // No tab strip or target library to key a tab on, so use the legacy single-board clear.
    if( !m_tabsPanel || aLibrary.IsEmpty() )
        return Clear_Pcb( true );
 
    // The new footprint opens in its own tab. Only a dirty tab-less frame board needs saving.
    if( !activeBoardOwnedByTab() && IsContentModified() )
    {
        if( !HandleUnsavedChanges( this, _( "The current footprint has been modified.  Save changes?" ),
                                   [&]() -> bool
                                   {
                                       return SaveFootprint( GetBoard()->Footprints().front() );
                                   } ) )
        {
            return false;
        }
    }
 
    return true;
}
 
 
void FOOTPRINT_EDIT_FRAME::centerItemIdleHandler( wxIdleEvent& aEvent )
{
    m_treePane->GetLibTree()->CenterLibId( m_centerItemOnIdle );
    Unbind( wxEVT_IDLE, &FOOTPRINT_EDIT_FRAME::centerItemIdleHandler, this );
}
 
 
void FOOTPRINT_EDIT_FRAME::OnTabCharHook( wxKeyEvent& aEvent )
{
    const bool isTab = aEvent.GetKeyCode() == WXK_TAB;
    const bool ctrlOnly = aEvent.ControlDown() && !aEvent.AltDown() && !aEvent.MetaDown();
 
    // Ctrl+W arrives as 'W' or the control char depending on platform, so accept both.
    const int  keyCode = aEvent.GetKeyCode();
    const bool isCtrlW = ctrlOnly && !aEvent.ShiftDown()
                         && ( keyCode == 'W' || keyCode == ( 'W' - '@' ) );
 
    if( isCtrlW && m_tabsPanel && m_tabsPanel->Model().Entries().size() >= 1 )
    {
        CloseActiveFootprintTab();
        return;
    }
 
    if( !isTab || !ctrlOnly || !m_tabsPanel )
    {
        aEvent.Skip();
        return;
    }
 
    // The appearance panel owns Ctrl+Tab for its layer-preset cycle while focused, so defer to it.
    if( APPEARANCE_CONTROLS* appearance = GetAppearancePanel() )
    {
        for( wxWindow* focus = wxWindow::FindFocus(); focus; focus = focus->GetParent() )
        {
            if( focus == appearance )
            {
                aEvent.Skip();
                return;
            }
        }
    }
 
    AdvanceFootprintTab( !aEvent.ShiftDown() );
 
    // Do not Skip, so the GTK default Tab focus-traversal does not also run.
}
 
 
class BASIC_FOOTPRINT_INFO : public FOOTPRINT_INFO
{
public:
    BASIC_FOOTPRINT_INFO( FOOTPRINT* aFootprint )
    {
        wxASSERT( aFootprint );
 
        m_nickname = aFootprint->GetFPID().GetLibNickname().wx_str();
        m_fpname = aFootprint->GetFPID().GetLibItemName().wx_str();
        m_pad_count = aFootprint->GetPadCount( DO_NOT_INCLUDE_NPTH );
        m_unique_pad_count = aFootprint->GetUniquePadCount( DO_NOT_INCLUDE_NPTH );
        m_keywords = aFootprint->GetKeywords();
        m_doc = aFootprint->GetLibDescription();
        m_loaded = true;
    }
};
 
 
void FOOTPRINT_EDIT_FRAME::UpdateLibraryTree( const wxDataViewItem& aTreeItem,
                                              FOOTPRINT* aFootprint )
{
    wxCHECK( aFootprint, /* void */ );
 
    BASIC_FOOTPRINT_INFO footprintInfo( aFootprint );
 
    if( aTreeItem.IsOk() )   // Can be not found in tree if the current footprint is imported
                             // from file therefore not yet in tree.
    {
        static_cast<LIB_TREE_NODE_ITEM*>( aTreeItem.GetID() )->Update( &footprintInfo );
        m_treePane->GetLibTree()->RefreshLibTree();
    }
}
 
 
void FOOTPRINT_EDIT_FRAME::editFootprintProperties( FOOTPRINT* aFootprint )
{
    LIB_ID oldFPID = aFootprint->GetFPID();
 
    DIALOG_FOOTPRINT_PROPERTIES_FP_EDITOR dialog( this, aFootprint );
    dialog.ShowQuasiModal();
 
    // Update design settings for footprint layers
    updateEnabledLayers();
 
    // Update library tree and title in case of a name change
    wxDataViewItem treeItem = m_adapter->FindItem( oldFPID );
    UpdateLibraryTree( treeItem, aFootprint );
 
    RenameFootprintTab( oldFPID, aFootprint->GetFPID() );
 
    UpdateMsgPanel();
    UpdateUserInterface();
}
 
 
void FOOTPRINT_EDIT_FRAME::OnEditItemRequest( BOARD_ITEM* aItem )
{
    switch( aItem->Type() )
    {
    case PCB_REFERENCE_IMAGE_T:
        ShowReferenceImagePropertiesDialog( aItem );
        break;
 
    case PCB_BARCODE_T:
        ShowBarcodePropertiesDialog( static_cast<PCB_BARCODE*>( aItem ) );
        break;
 
    case PCB_PAD_T:
        ShowPadPropertiesDialog( static_cast<PAD*>( aItem ) );
        break;
 
    case PCB_FOOTPRINT_T:
        editFootprintProperties( static_cast<FOOTPRINT*>( aItem ) );
        GetCanvas()->Refresh();
        break;
 
    case PCB_FIELD_T:
    case PCB_TEXT_T:
        ShowTextPropertiesDialog( static_cast<PCB_TEXT*>( aItem ) );
        break;
 
    case PCB_TEXTBOX_T:
        ShowTextBoxPropertiesDialog( static_cast<PCB_TEXTBOX*>( aItem ) );
        break;
 
    case PCB_TABLE_T:
    {
        DIALOG_TABLE_PROPERTIES dlg( this, static_cast<PCB_TABLE*>( aItem ) );
 
        //QuasiModal required for Scintilla auto-complete
        dlg.ShowQuasiModal();
        break;
    }
 
    case PCB_SHAPE_T :
        ShowGraphicItemPropertiesDialog( static_cast<PCB_SHAPE*>( aItem ) );
        break;
 
    case PCB_DIM_ALIGNED_T:
    case PCB_DIM_CENTER_T:
    case PCB_DIM_RADIAL_T:
    case PCB_DIM_ORTHOGONAL_T:
    case PCB_DIM_LEADER_T:
    {
        DIALOG_DIMENSION_PROPERTIES dlg( this, static_cast<PCB_DIMENSION_BASE*>( aItem ) );
 
        dlg.ShowModal();
        break;
    }
 
    case PCB_ZONE_T:
    {
        ZONE*         zone = static_cast<ZONE*>( aItem );
        bool          success = false;
        ZONE_SETTINGS zoneSettings;
 
        zoneSettings << *static_cast<ZONE*>( aItem );
 
        if( zone->GetIsRuleArea() )
            success = InvokeRuleAreaEditor( this, &zoneSettings ) == wxID_OK;
        else if( zone->IsOnCopperLayer() )
            success = InvokeCopperZonesEditor( this, zone, &zoneSettings ) == wxID_OK;
        else
            success = InvokeNonCopperZonesEditor( this, &zoneSettings ) == wxID_OK;
 
        if( success )
        {
            BOARD_COMMIT commit( this );
            commit.Modify( zone );
            commit.Push( _( "Edit Zone" ) );
            zoneSettings.ExportSetting( *static_cast<ZONE*>( aItem ) );
        }
 
        break;
    }
 
    case PCB_GROUP_T:
        m_toolManager->RunAction( ACTIONS::groupProperties,
                                  static_cast<EDA_GROUP*>( static_cast<PCB_GROUP*>( aItem ) ) );
        break;
 
    case PCB_MARKER_T:
        m_toolManager->GetTool<FOOTPRINT_EDITOR_CONTROL>()->CrossProbe( static_cast<PCB_MARKER*>( aItem ) );
        break;
 
    case PCB_POINT_T:
        break;
 
    default:
        wxFAIL_MSG( wxT( "FOOTPRINT_EDIT_FRAME::OnEditItemRequest: unsupported item type " )
                    + aItem->GetClass() );
        break;
    }
}
 
 
COLOR4D FOOTPRINT_EDIT_FRAME::GetGridColor()
{
    return GetColorSettings()->GetColor( LAYER_GRID );
}
 
 
void FOOTPRINT_EDIT_FRAME::SetActiveLayer( PCB_LAYER_ID aLayer )
{
    const PCB_LAYER_ID oldLayer = GetActiveLayer();
 
    if( oldLayer == aLayer )
        return;
 
    PCB_BASE_FRAME::SetActiveLayer( aLayer );
 
    /*
     * Follow the PCB editor logic for showing/hiding clearance layers: show only for
     * the active copper layer or a front/back non-copper layer.
     */
    const auto getClearanceLayerForActive = []( PCB_LAYER_ID aActiveLayer ) -> std::optional<int>
    {
        if( IsCopperLayer( aActiveLayer ) )
            return CLEARANCE_LAYER_FOR( aActiveLayer );
 
        return std::nullopt;
    };
 
    if( std::optional<int> oldClearanceLayer = getClearanceLayerForActive( oldLayer ) )
        GetCanvas()->GetView()->SetLayerVisible( *oldClearanceLayer, false );
 
    if( std::optional<int> newClearanceLayer = getClearanceLayerForActive( aLayer ) )
        GetCanvas()->GetView()->SetLayerVisible( *newClearanceLayer, true );
 
    m_appearancePanel->OnLayerChanged();
 
    m_toolManager->RunAction( PCB_ACTIONS::layerChanged );  // notify other tools
    GetCanvas()->SetFocus();                             // allow capture of hotkeys
    GetCanvas()->SetHighContrastLayer( aLayer );
    GetCanvas()->Refresh();
}
 
 
bool FOOTPRINT_EDIT_FRAME::OpenProjectFiles( const std::vector<wxString>& aFileSet, int aCtl )
{
    // The import opens in its own tab, leaving the open documents alone; only the legacy single-board
    // path has to clear first
    if( !m_tabsPanel && !Clear_Pcb( true ) )
        return false;                  // this command is aborted
 
    GetCanvas()->GetViewControls()->SetCrossHairCursorPosition( VECTOR2D( 0, 0 ), false );
 
    if( !ImportFootprint( aFileSet[ 0 ] ) )
        return false;
 
    if( GetBoard()->GetFirstFootprint() )
        GetBoard()->GetFirstFootprint()->ClearFlags();
 
    // An unsaved import stays dirty so closing its tab offers to save it; only the legacy path, where
    // the footprint keeps its file identity, starts out clean
    if( !m_tabsPanel )
        GetScreen()->SetContentModified( false );
 
    Zoom_Automatique( false );
    GetCanvas()->Refresh();
 
    return true;
}
 
 
void FOOTPRINT_EDIT_FRAME::KiwayMailIn( KIWAY_MAIL_EVENT& mail )
{
    const std::string& payload = mail.GetPayload();
 
    switch( mail.Command() )
    {
    case MAIL_FP_EDIT:
        if( !payload.empty() )
        {
            wxFileName fpFileName( payload );
            wxString   libNickname;
            wxString   msg;
 
            FOOTPRINT_LIBRARY_ADAPTER* adapter = PROJECT_PCB::FootprintLibAdapter( &Prj() );
            std::optional<LIBRARY_TABLE_ROW*> optRow = adapter->FindRowByURI( fpFileName.GetPath() );
 
            if( !optRow )
            {
                msg.Printf( _( "The current configuration does not include the footprint library '%s'." ),
                            fpFileName.GetPath() );
                msg += wxS( "\n" ) + _( "Use Manage Footprint Libraries to edit the configuration." );
                DisplayErrorMessage( this, _( "Library not found in footprint library table." ),
                                     msg );
                break;
            }
 
            libNickname = ( *optRow )->Nickname();
 
            if( !adapter->HasLibrary( libNickname, true ) )
            {
                msg.Printf( _( "The footprint library '%s' is not enabled in the current configuration." ),
                            libNickname );
                msg += wxS( "\n" ) + _( "Use Manage Footprint Libraries to edit the configuration." );
                DisplayErrorMessage( this, _( "Footprint library not enabled." ), msg );
                break;
            }
 
            LIB_ID  fpId( libNickname, fpFileName.GetName() );
 
            if( m_treePane )
            {
                m_treePane->GetLibTree()->SelectLibId( fpId );
                wxCommandEvent event( EVT_LIBITEM_CHOSEN );
                wxPostEvent( m_treePane, event );
            }
        }
 
        break;
 
    case MAIL_RELOAD_LIB:
        SyncLibraryTree( true );
        RefreshLibraryTree();
        break;
 
    default:
        break;
    }
}