2012-01-09 17:24:01 +00:00
|
|
|
/*
|
|
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
|
|
*
|
2015-02-20 08:17:54 +00:00
|
|
|
* Copyright (C) 2015 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
|
2022-01-29 19:07:07 +00:00
|
|
|
* Copyright (C) 2015-2022 KiCad Developers, see AUTHORS.txt for contributors.
|
2012-01-09 17:24:01 +00:00
|
|
|
*
|
|
|
|
* 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
|
|
|
|
*/
|
|
|
|
|
2018-01-03 02:52:35 +00:00
|
|
|
#ifndef SCH_BASE_FRAME_H_
|
|
|
|
#define SCH_BASE_FRAME_H_
|
|
|
|
|
2019-06-08 22:14:57 +00:00
|
|
|
#include <eda_draw_frame.h>
|
2019-06-25 23:39:58 +00:00
|
|
|
#include <frame_type.h>
|
2018-08-03 12:18:26 +00:00
|
|
|
#include <sch_draw_panel.h>
|
2019-06-25 23:39:58 +00:00
|
|
|
#include <sch_screen.h>
|
2020-05-20 03:34:55 +00:00
|
|
|
#include <schematic_settings.h>
|
2019-06-25 23:39:58 +00:00
|
|
|
|
|
|
|
#include <stddef.h>
|
|
|
|
#include <utility>
|
|
|
|
#include <vector>
|
|
|
|
#include <wx/event.h>
|
2023-05-31 20:37:58 +00:00
|
|
|
#include <wx/fswatcher.h>
|
|
|
|
#include <wx/datetime.h>
|
2019-06-25 23:39:58 +00:00
|
|
|
#include <wx/gdicmn.h>
|
|
|
|
#include <wx/string.h>
|
2023-05-31 20:37:58 +00:00
|
|
|
#include <wx/timer.h>
|
2019-06-25 23:39:58 +00:00
|
|
|
|
|
|
|
#include <template_fieldnames.h>
|
2018-08-14 18:52:10 +00:00
|
|
|
|
2012-01-09 17:24:01 +00:00
|
|
|
|
2018-09-02 20:19:22 +00:00
|
|
|
namespace KIGFX
|
|
|
|
{
|
|
|
|
class SCH_RENDER_SETTINGS;
|
|
|
|
}
|
|
|
|
|
2012-01-09 17:24:01 +00:00
|
|
|
class PAGE_INFO;
|
|
|
|
class TITLE_BLOCK;
|
2020-12-25 23:37:01 +00:00
|
|
|
class SYMBOL_VIEWER_FRAME;
|
2020-10-31 01:27:16 +00:00
|
|
|
class SYMBOL_EDIT_FRAME;
|
2021-06-10 18:51:46 +00:00
|
|
|
class LIB_SYMBOL;
|
2021-06-15 12:31:28 +00:00
|
|
|
class SYMBOL_LIB;
|
2022-01-29 19:07:07 +00:00
|
|
|
class SYMBOL_LIBRARY_FILTER;
|
2017-09-15 14:17:44 +00:00
|
|
|
class LIB_ID;
|
2017-10-06 18:07:43 +00:00
|
|
|
class SYMBOL_LIB_TABLE;
|
2020-05-20 03:34:55 +00:00
|
|
|
class EESCHEMA_SETTINGS;
|
2020-10-31 01:27:16 +00:00
|
|
|
class SYMBOL_EDITOR_SETTINGS;
|
2022-08-20 14:09:15 +00:00
|
|
|
class NL_SCHEMATIC_PLUGIN;
|
2022-03-31 19:03:41 +00:00
|
|
|
|
2017-10-06 18:07:43 +00:00
|
|
|
/**
|
|
|
|
* Load symbol from symbol library table.
|
|
|
|
*
|
|
|
|
* Check the symbol library table for the part defined by \a aLibId and optionally
|
|
|
|
* check the optional cache library.
|
|
|
|
*
|
|
|
|
* @param aLibId is the symbol library identifier to load.
|
|
|
|
* @param aLibTable is the #SYMBOL_LIBRARY_TABLE to load the alias from.
|
|
|
|
* @param aCacheLib is an optional cache library.
|
2021-03-25 14:07:16 +00:00
|
|
|
* @param aParent is an optional parent window when displaying an error message.
|
2017-10-06 18:07:43 +00:00
|
|
|
* @param aShowErrorMessage set to true to show any error messages.
|
|
|
|
*
|
|
|
|
* @return The symbol found in the library or NULL if the symbol was not found.
|
|
|
|
*/
|
2021-06-17 21:22:10 +00:00
|
|
|
LIB_SYMBOL* SchGetLibSymbol( const LIB_ID& aLibId, SYMBOL_LIB_TABLE* aLibTable,
|
2021-07-16 20:13:26 +00:00
|
|
|
SYMBOL_LIB* aCacheLib = nullptr, wxWindow* aParent = nullptr,
|
2021-06-17 21:22:10 +00:00
|
|
|
bool aShowErrorMsg = false );
|
2017-10-06 18:07:43 +00:00
|
|
|
|
2012-01-09 17:24:01 +00:00
|
|
|
/**
|
2017-10-06 18:07:43 +00:00
|
|
|
* A shim class between EDA_DRAW_FRAME and several derived classes:
|
2020-12-25 23:37:01 +00:00
|
|
|
* SYMBOL_EDIT_FRAME, SYMBOL_VIEWER_FRAME, and SCH_EDIT_FRAME, and it brings in a
|
2012-01-09 17:24:01 +00:00
|
|
|
* common way of handling the provided virtual functions for the derived classes.
|
2017-10-06 18:07:43 +00:00
|
|
|
*
|
2012-01-09 17:24:01 +00:00
|
|
|
* The motivation here is to switch onto GetScreen() for the underlying data model.
|
|
|
|
*
|
|
|
|
* @author Dick Hollenbeck
|
|
|
|
*/
|
|
|
|
class SCH_BASE_FRAME : public EDA_DRAW_FRAME
|
|
|
|
{
|
|
|
|
public:
|
2022-08-20 09:27:35 +00:00
|
|
|
SCH_BASE_FRAME( KIWAY* aKiway, wxWindow* aParent, FRAME_T aWindowType, const wxString& aTitle,
|
|
|
|
const wxPoint& aPosition, const wxSize& aSize, long aStyle,
|
|
|
|
const wxString & aFrameName );
|
2012-01-09 17:24:01 +00:00
|
|
|
|
2022-08-20 13:48:48 +00:00
|
|
|
virtual ~SCH_BASE_FRAME();
|
2017-08-12 12:09:39 +00:00
|
|
|
|
2018-09-10 13:37:28 +00:00
|
|
|
void createCanvas();
|
|
|
|
|
2019-06-13 17:28:55 +00:00
|
|
|
SCH_DRAW_PANEL* GetCanvas() const override;
|
2016-09-25 17:06:49 +00:00
|
|
|
SCH_SCREEN* GetScreen() const override;
|
2012-01-09 17:24:01 +00:00
|
|
|
|
2020-05-20 03:34:55 +00:00
|
|
|
EESCHEMA_SETTINGS* eeconfig() const;
|
|
|
|
|
2020-10-31 01:27:16 +00:00
|
|
|
SYMBOL_EDITOR_SETTINGS* libeditconfig() const;
|
2020-04-12 23:09:17 +00:00
|
|
|
|
|
|
|
void LoadSettings( APP_SETTINGS_BASE* aCfg ) override;
|
|
|
|
void SaveSettings( APP_SETTINGS_BASE* aCfg ) override;
|
|
|
|
|
2018-09-02 20:19:22 +00:00
|
|
|
KIGFX::SCH_RENDER_SETTINGS* GetRenderSettings();
|
|
|
|
|
2020-12-23 23:18:02 +00:00
|
|
|
COLOR4D GetDrawBgColor() const override;
|
|
|
|
|
2019-04-21 23:45:34 +00:00
|
|
|
/**
|
|
|
|
* Allow some frames to show/hide hidden pins. The default impl shows all pins.
|
|
|
|
*/
|
|
|
|
virtual bool GetShowAllPins() const { return true; }
|
|
|
|
|
2016-09-25 17:06:49 +00:00
|
|
|
void SetPageSettings( const PAGE_INFO& aPageSettings ) override;
|
|
|
|
const PAGE_INFO& GetPageSettings () const override;
|
2023-02-19 03:40:07 +00:00
|
|
|
const VECTOR2I GetPageSizeIU() const override;
|
2012-01-09 17:24:01 +00:00
|
|
|
|
2021-12-29 21:30:11 +00:00
|
|
|
const VECTOR2I& GetGridOrigin() const override
|
2013-08-03 05:15:23 +00:00
|
|
|
{
|
2021-12-29 21:30:11 +00:00
|
|
|
static VECTOR2I zero;
|
2013-08-03 05:15:23 +00:00
|
|
|
return zero;
|
|
|
|
}
|
2021-12-29 21:30:11 +00:00
|
|
|
void SetGridOrigin( const VECTOR2I& aPoint ) override {}
|
2012-01-09 17:24:01 +00:00
|
|
|
|
2016-09-25 17:06:49 +00:00
|
|
|
const TITLE_BLOCK& GetTitleBlock() const override;
|
|
|
|
void SetTitleBlock( const TITLE_BLOCK& aTitleBlock ) override;
|
2012-02-19 19:53:11 +00:00
|
|
|
|
2016-09-25 17:06:49 +00:00
|
|
|
void UpdateStatusBar() override;
|
2012-04-13 18:51:24 +00:00
|
|
|
|
2012-02-19 19:53:11 +00:00
|
|
|
/**
|
2021-05-05 21:41:51 +00:00
|
|
|
* Call the library viewer to select symbol to import into schematic.
|
|
|
|
* If the library viewer is currently running, it is closed and reopened in modal mode.
|
2017-03-23 00:59:25 +00:00
|
|
|
*
|
2021-05-05 21:41:51 +00:00
|
|
|
* aAllowFields chooses whether or not features that permit the user to edit fields
|
|
|
|
* (e.g. footprint selection) should be enabled. This should be false when they would
|
|
|
|
* have no effect, for example loading a part into symbol_editor.
|
2017-03-23 00:59:25 +00:00
|
|
|
*
|
2022-01-29 19:07:07 +00:00
|
|
|
* @param aFilter is an optional #SYMBOL_LIBRARY_FILTER filter to pass the allowed library names
|
2021-05-05 21:41:51 +00:00
|
|
|
* and/or the library name to load the symbol from and/or some other filter
|
|
|
|
* @param aHistoryList is the list of previously loaded symbols - will be edited
|
|
|
|
* @param aHighlight is the name of symbol to highlight in the list.
|
2021-03-25 14:07:16 +00:00
|
|
|
* highlights none if there isn't one by that name.
|
|
|
|
* @param aShowFootprints is the whether to show footprints in the dialog.
|
|
|
|
* @param aAllowFields is whether to allow field editing in the dialog.
|
2012-02-19 19:53:11 +00:00
|
|
|
*
|
2021-05-05 21:41:51 +00:00
|
|
|
* @return the selected symbol
|
2012-02-19 19:53:11 +00:00
|
|
|
*/
|
2023-09-28 13:09:45 +00:00
|
|
|
PICKED_SYMBOL PickSymbolFromLibrary( const SYMBOL_LIBRARY_FILTER* aFilter,
|
2020-11-07 14:31:50 +00:00
|
|
|
std::vector<PICKED_SYMBOL>& aHistoryList,
|
2023-09-28 13:09:45 +00:00
|
|
|
bool aShowFootprints, const LIB_ID* aHighlight = nullptr,
|
2020-11-07 14:31:50 +00:00
|
|
|
bool aAllowFields = true );
|
2012-02-19 19:53:11 +00:00
|
|
|
|
2017-10-06 18:07:43 +00:00
|
|
|
/**
|
|
|
|
* Load symbol from symbol library table.
|
|
|
|
*
|
|
|
|
* @param aLibId is the symbol library identifier to load.
|
|
|
|
* @param aUseCacheLib set to true to fall back to cache library if symbol is not found in
|
|
|
|
* symbol library table.
|
|
|
|
* @param aShowErrorMessage set to true to show any error messages.
|
|
|
|
* @return The symbol found in the library or NULL if the symbol was not found.
|
|
|
|
*/
|
2021-06-17 21:22:10 +00:00
|
|
|
LIB_SYMBOL* GetLibSymbol( const LIB_ID& aLibId, bool aUseCacheLib = false,
|
|
|
|
bool aShowErrorMsg = false );
|
2019-11-06 19:15:42 +00:00
|
|
|
|
2022-09-16 03:06:23 +00:00
|
|
|
/**
|
|
|
|
* Display a list of loaded libraries and allows the user to select a library.
|
|
|
|
*
|
|
|
|
* This list is sorted, with the library cache always at end of the list
|
|
|
|
*
|
|
|
|
* @return the library nickname used in the symbol library table.
|
|
|
|
*/
|
|
|
|
wxString SelectLibraryFromList();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Display a dialog asking the user to select a symbol library table.
|
|
|
|
*
|
|
|
|
* @param aOptional if set the Cancel button will be relabelled "Skip".
|
|
|
|
* @return Pointer to the selected symbol library table or nullptr if canceled.
|
|
|
|
*/
|
|
|
|
SYMBOL_LIB_TABLE* SelectSymLibTable( bool aOptional = false );
|
|
|
|
|
2022-01-01 06:04:08 +00:00
|
|
|
virtual void RedrawScreen( const VECTOR2I& aCenterPoint, bool aWarpPointer );
|
2018-08-03 12:18:26 +00:00
|
|
|
|
2019-05-28 18:44:14 +00:00
|
|
|
void HardRedraw() override;
|
2018-09-05 22:17:22 +00:00
|
|
|
|
2018-09-10 10:58:50 +00:00
|
|
|
/**
|
|
|
|
* Add an item to the screen (and view)
|
2019-03-11 21:32:05 +00:00
|
|
|
* aScreen is the screen the item is located on, if not the current screen
|
2018-09-10 10:58:50 +00:00
|
|
|
*/
|
2023-04-29 00:02:42 +00:00
|
|
|
void AddToScreen( EDA_ITEM* aItem, SCH_SCREEN* aScreen = nullptr );
|
2018-09-10 10:58:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Remove an item from the screen (and view)
|
2019-03-11 21:32:05 +00:00
|
|
|
* aScreen is the screen the item is located on, if not the current screen
|
2018-09-10 10:58:50 +00:00
|
|
|
*/
|
2020-07-13 11:21:40 +00:00
|
|
|
void RemoveFromScreen( EDA_ITEM* aItem, SCH_SCREEN* aScreen );
|
2018-08-03 12:18:26 +00:00
|
|
|
|
2018-09-10 10:58:50 +00:00
|
|
|
/**
|
|
|
|
* Mark an item for refresh.
|
|
|
|
*/
|
2022-01-07 17:42:43 +00:00
|
|
|
virtual void UpdateItem( EDA_ITEM* aItem, bool isAddOrDelete = false,
|
|
|
|
bool aUpdateRtree = false );
|
2018-09-10 10:58:50 +00:00
|
|
|
|
2019-08-08 09:06:53 +00:00
|
|
|
/**
|
|
|
|
* Mark selected items for refresh.
|
|
|
|
*/
|
2022-05-13 21:36:20 +00:00
|
|
|
void RefreshZoomDependentItems();
|
2019-08-08 09:06:53 +00:00
|
|
|
|
2018-09-10 10:58:50 +00:00
|
|
|
/**
|
|
|
|
* Mark all items for refresh.
|
|
|
|
*/
|
2018-08-03 12:18:26 +00:00
|
|
|
void SyncView();
|
|
|
|
|
2020-07-17 20:04:14 +00:00
|
|
|
void CommonSettingsChanged( bool aEnvVarsChanged, bool aTextVarsChanged ) override;
|
2020-04-09 16:15:57 +00:00
|
|
|
|
2020-02-03 16:46:58 +00:00
|
|
|
/**
|
|
|
|
* Helper to retrieve a layer color from the global color settings
|
|
|
|
*/
|
|
|
|
COLOR4D GetLayerColor( SCH_LAYER_ID aLayer );
|
|
|
|
|
2021-09-07 20:34:10 +00:00
|
|
|
COLOR_SETTINGS* GetColorSettings( bool aForceRefresh = false ) const override;
|
2020-02-03 16:46:58 +00:00
|
|
|
|
2022-03-31 19:03:41 +00:00
|
|
|
void ActivateGalCanvas() override;
|
|
|
|
|
2023-05-31 20:37:58 +00:00
|
|
|
/**
|
|
|
|
* Handler for Symbol change events. Responds to the filesystem watcher set in #setSymWatcher.
|
|
|
|
*/
|
|
|
|
void OnSymChange( wxFileSystemWatcherEvent& aEvent );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Handler for the filesystem watcher debounce timer.
|
|
|
|
*/
|
|
|
|
void OnSymChangeDebounceTimer( wxTimerEvent& aEvent );
|
|
|
|
|
2019-05-13 20:42:40 +00:00
|
|
|
protected:
|
2022-03-31 19:03:41 +00:00
|
|
|
void handleActivateEvent( wxActivateEvent& aEvent ) override;
|
|
|
|
|
|
|
|
void handleIconizeEvent( wxIconizeEvent& aEvent ) override;
|
|
|
|
|
2017-11-13 10:53:19 +00:00
|
|
|
/**
|
2021-03-25 14:07:16 +00:00
|
|
|
* Save Symbol Library Tables to disk.
|
2017-11-13 10:53:19 +00:00
|
|
|
*
|
|
|
|
* @param aGlobal when true, the Global Table is saved.
|
|
|
|
* @param aProject when true, the Project Table is saved.
|
|
|
|
* @return True when all requested actions succeeded.
|
|
|
|
*/
|
|
|
|
bool saveSymbolLibTables( bool aGlobal, bool aProject );
|
2018-08-03 12:18:26 +00:00
|
|
|
|
2023-05-31 20:37:58 +00:00
|
|
|
/**
|
|
|
|
* Creates (or removes) a watcher on the specified symbol library
|
|
|
|
* @param aSymbol If nullptr, the watcher is removed. Otherwise, set a change watcher
|
|
|
|
*/
|
|
|
|
void setSymWatcher( const LIB_ID* aSymbol );
|
|
|
|
|
2021-03-25 14:07:16 +00:00
|
|
|
/// These are only used by symbol_editor. Eeschema should be using the one inside
|
|
|
|
/// the SCHEMATIC.
|
|
|
|
SCHEMATIC_SETTINGS m_base_frame_defaults;
|
2022-03-31 19:03:41 +00:00
|
|
|
|
|
|
|
private:
|
2023-05-31 20:37:58 +00:00
|
|
|
|
|
|
|
/// These are file watchers for the symbol library tables.
|
|
|
|
std::unique_ptr<wxFileSystemWatcher> m_watcher;
|
|
|
|
wxFileName m_watcherFileName;
|
|
|
|
wxDateTime m_watcherLastModified;
|
|
|
|
wxTimer m_watcherDebounceTimer;
|
|
|
|
|
2022-08-20 13:48:48 +00:00
|
|
|
NL_SCHEMATIC_PLUGIN* m_spaceMouse;
|
2012-01-09 17:24:01 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif // SCH_BASE_FRAME_H_
|