/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2012 NBEE Embedded Systems, Miguel Angel Ajo * Copyright (C) 1992-2017 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 */ /** * @file pcbnew_scripting_helpers.cpp * @brief Scripting helper functions for pcbnew functionality */ #include #undef HAVE_CLOCK_GETTIME // macro is defined in Python.h and causes redefine warning #include #include #include #include #include #include #include #include #include #include #include #include #include #include static PCB_EDIT_FRAME* s_PcbEditFrame = NULL; static SETTINGS_MANAGER* s_SettingsManager = nullptr; BOARD* GetBoard() { if( s_PcbEditFrame ) return s_PcbEditFrame->GetBoard(); else return NULL; } void ScriptingSetPcbEditFrame( PCB_EDIT_FRAME* aPcbEditFrame ) { s_PcbEditFrame = aPcbEditFrame; } BOARD* LoadBoard( wxString& aFileName ) { if( aFileName.EndsWith( wxT( ".kicad_pcb" ) ) ) return LoadBoard( aFileName, IO_MGR::KICAD_SEXP ); else if( aFileName.EndsWith( wxT( ".brd" ) ) ) return LoadBoard( aFileName, IO_MGR::LEGACY ); // as fall back for any other kind use the legacy format return LoadBoard( aFileName, IO_MGR::LEGACY ); } SETTINGS_MANAGER* GetSettingsManager() { if( !s_SettingsManager ) s_SettingsManager = new SETTINGS_MANAGER( true ); return s_SettingsManager; } PROJECT* GetDefaultProject() { PROJECT* project = GetSettingsManager()->GetProject( "" ); if( !project ) { GetSettingsManager()->LoadProject( "" ); project = GetSettingsManager()->GetProject( "" ); } return project; } BOARD* LoadBoard( wxString& aFileName, IO_MGR::PCB_FILE_T aFormat ) { wxFileName pro = aFileName; pro.SetExt( ProjectFileExtension ); pro.MakeAbsolute(); wxString projectPath = pro.GetFullPath(); PROJECT* project = GetSettingsManager()->GetProject( projectPath ); if( !project ) { GetSettingsManager()->LoadProject( projectPath ); GetSettingsManager()->GetProject( projectPath ); } // Board cannot be loaded without a project, so create the default project if( !project ) project = GetDefaultProject(); BOARD* brd = IO_MGR::Load( aFormat, aFileName ); if( brd ) { brd->SetProject( project ); brd->BuildConnectivity(); brd->BuildListOfNets(); brd->SynchronizeNetsAndNetClasses(); } return brd; } BOARD* CreateEmptyBoard() { BOARD* brd = new BOARD(); brd->SetProject( GetDefaultProject() ); return brd; } bool SaveBoard( wxString& aFileName, BOARD* aBoard, IO_MGR::PCB_FILE_T aFormat ) { aBoard->BuildConnectivity(); aBoard->SynchronizeNetsAndNetClasses(); aBoard->GetDesignSettings().SetCurrentNetClass( NETCLASS::Default ); IO_MGR::Save( aFormat, aFileName, aBoard, NULL ); wxFileName pro = aFileName; pro.SetExt( ProjectFileExtension ); pro.MakeAbsolute(); wxString projectPath = pro.GetFullPath(); GetSettingsManager()->SaveProject( pro.GetFullPath() ); return true; } bool SaveBoard( wxString& aFileName, BOARD* aBoard ) { return SaveBoard( aFileName, aBoard, IO_MGR::KICAD_SEXP ); } FP_LIB_TABLE* GetFootprintLibraryTable() { BOARD* board = GetBoard(); if( !board ) return nullptr; PROJECT* project = board->GetProject(); if( !project ) return nullptr; return project->PcbFootprintLibs(); } wxArrayString GetFootprintLibraries() { wxArrayString footprintLibraryNames; FP_LIB_TABLE* tbl = GetFootprintLibraryTable(); if( !tbl ) return footprintLibraryNames; for( const wxString& name : tbl->GetLogicalLibs() ) footprintLibraryNames.Add( name ); return footprintLibraryNames; } wxArrayString GetFootprints( const wxString& aNickName ) { wxArrayString footprintNames; FP_LIB_TABLE* tbl = GetFootprintLibraryTable(); if( !tbl ) return footprintNames; tbl->FootprintEnumerate( footprintNames, aNickName, true ); return footprintNames; } bool ExportSpecctraDSN( wxString& aFullFilename ) { if( s_PcbEditFrame ) { bool ok = s_PcbEditFrame->ExportSpecctraFile( aFullFilename ); return ok; } else { return false; } } bool ImportSpecctraSES( wxString& aFullFilename ) { if( s_PcbEditFrame ) { bool ok = s_PcbEditFrame->ImportSpecctraSession( aFullFilename ); return ok; } else { return false; } } bool ArchiveModulesOnBoard( bool aStoreInNewLib, const wxString& aLibName, wxString* aLibPath ) { if( s_PcbEditFrame ) { s_PcbEditFrame->ArchiveModulesOnBoard( aStoreInNewLib, aLibName, aLibPath ); return true; } else { return false; } } void Refresh() { if( s_PcbEditFrame ) { auto board = s_PcbEditFrame->GetBoard(); board->BuildConnectivity(); // Re-init everything: this is the easy way to do that s_PcbEditFrame->ActivateGalCanvas(); s_PcbEditFrame->GetCanvas()->Refresh(); } } void UpdateUserInterface() { if( s_PcbEditFrame ) s_PcbEditFrame->UpdateUserInterface(); } int GetUserUnits() { if( s_PcbEditFrame ) return static_cast( s_PcbEditFrame->GetUserUnits() ); return -1; } bool IsActionRunning() { return ACTION_PLUGINS::IsActionRunning(); }