KiCad PCB EDA Suite
Loading...
Searching...
No Matches
eda_draw_frame.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2009 Jean-Pierre Charras, [email protected]
5 * Copyright (C) 2011 Wayne Stambaugh <[email protected]>
6 * Copyright (C) 1992-2024 KiCad Developers, see AUTHORS.txt for contributors.
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2
11 * of the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, you may find one here:
20 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
21 * or you may search the http://www.gnu.org website for the version 2 license,
22 * or you may write to the Free Software Foundation, Inc.,
23 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
24 */
25
26#ifndef DRAW_FRAME_H_
27#define DRAW_FRAME_H_
28
29#include <api/api_plugin.h>
30#include <eda_base_frame.h>
31#include <eda_search_data.h>
32#include <kiway_player.h>
35#include <gal/color4d.h>
37#include <kiid.h>
38#include <hotkeys_basic.h>
39#include <widgets/lib_tree.h>
40
41class EDA_ITEM;
42class wxSingleInstanceChecker;
43class ACTION_TOOLBAR;
44class COLOR_SETTINGS;
45class LOCKFILE;
46class TOOL_MENU;
48class wxFindReplaceData;
49class SEARCH_PANE;
53enum class BITMAP_TYPE;
54
55namespace KIGFX
56{
57 class GAL_DISPLAY_OPTIONS;
58 class RENDER_SETTINGS;
59}
60
61using KIGFX::COLOR4D;
63
64#define LIB_EDIT_FRAME_NAME wxT( "LibeditFrame" )
65#define LIB_VIEW_FRAME_NAME wxT( "ViewlibFrame" )
66#define SCH_EDIT_FRAME_NAME wxT( "SchematicFrame" )
67#define SYMBOL_CHOOSER_FRAME_NAME wxT( "SymbolChooserFrame" )
68#define PL_EDITOR_FRAME_NAME wxT( "PlEditorFrame" )
69#define FOOTPRINT_WIZARD_FRAME_NAME wxT( "FootprintWizard" )
70#define FOOTPRINT_CHOOSER_FRAME_NAME wxT( "FootprintChooserFrame" )
71#define FOOTPRINT_EDIT_FRAME_NAME wxT( "ModEditFrame" )
72#define FOOTPRINT_VIEWER_FRAME_NAME wxT( "ModViewFrame" )
73#define PCB_EDIT_FRAME_NAME wxT( "PcbFrame" )
74
75
83{
84public:
85 EDA_DRAW_FRAME( KIWAY* aKiway, wxWindow* aParent, FRAME_T aFrameType, const wxString& aTitle,
86 const wxPoint& aPos, const wxSize& aSize, long aStyle,
87 const wxString& aFrameName, const EDA_IU_SCALE& aIuScale );
88
90
99 bool LockFile( const wxString& aFileName );
100
104 void ReleaseFile();
105
110
115
117 wxArrayString& GetFindHistoryList() { return m_findStringHistoryList; }
118
119 virtual void SetPageSettings( const PAGE_INFO& aPageSettings ) = 0;
120 virtual const PAGE_INFO& GetPageSettings() const = 0;
121
126 virtual const VECTOR2I GetPageSizeIU() const = 0;
127
131 bool GetShowPolarCoords() const { return m_polarCoords; }
132 void SetShowPolarCoords( bool aShow ) { m_polarCoords = aShow; }
133
134 void ToggleUserUnits() override;
135
142 void GetUnitPair( EDA_UNITS& aPrimaryUnit, EDA_UNITS& aSecondaryUnits ) override;
143
150 virtual const VECTOR2I& GetGridOrigin() const = 0;
151 virtual void SetGridOrigin( const VECTOR2I& aPosition ) = 0;
152
159 VECTOR2I GetNearestGridPosition( const VECTOR2I& aPosition ) const;
160
170 VECTOR2I GetNearestHalfGridPosition( const VECTOR2I& aPosition ) const;
171
172 virtual const TITLE_BLOCK& GetTitleBlock() const = 0;
173 virtual void SetTitleBlock( const TITLE_BLOCK& aTitleBlock ) = 0;
174
175 // the background color of the draw canvas:
176 // Virtual because some frames can have a specific way to get/set the bg color
177 virtual COLOR4D GetDrawBgColor() const { return m_drawBgColor; }
178 virtual void SetDrawBgColor( const COLOR4D& aColor) { m_drawBgColor= aColor ; }
179
181 virtual COLOR_SETTINGS* GetColorSettings( bool aForceRefresh = false ) const;
182
192 bool LibraryFileBrowser( bool doOpen, wxFileName& aFilename, const wxString& wildcard,
193 const wxString& ext, bool isDirectory = false, bool aIsGlobal = false,
194 const wxString& aGlobalPath = wxEmptyString );
195
196 void CommonSettingsChanged( bool aEnvVarsChanged, bool aTextVarsChanged ) override;
197
198 virtual wxString GetScreenDesc() const;
199 virtual wxString GetFullScreenDesc() const;
200
206 virtual BASE_SCREEN* GetScreen() const { return m_currentScreen; }
207
208 void EraseMsgBox();
209
210 virtual void ReCreateHToolbar() { };
211 virtual void ReCreateVToolbar() { };
212 virtual void ReCreateOptToolbar() { };
213 virtual void ReCreateAuxiliaryToolbar() { }
214
218 virtual void UpdateToolbarControlSizes() { }
219
220 /*
221 * These 4 functions provide a basic way to show/hide grid and /get/set grid color.
222 *
223 * These parameters are saved in KiCad config for each main frame.
224 */
225 bool IsGridVisible() const;
226 virtual void SetGridVisibility( bool aVisible );
227
228 bool IsGridOverridden() const;
229 virtual void SetGridOverrides( bool aOverride );
230
231 virtual COLOR4D GetGridColor() { return m_gridColor; }
232 virtual void SetGridColor( const COLOR4D& aColor ) { m_gridColor = aColor; }
233
243 void OnSelectGrid( wxCommandEvent& event );
244
249 void UpdateGridSelectBox();
250
254 void OnUpdateSelectGrid( wxUpdateUIEvent& aEvent );
255
259 void OnUpdateSelectZoom( wxUpdateUIEvent& aEvent );
260
265 void UpdateZoomSelectBox();
266
270 const wxString GetZoomLevelIndicator() const;
271
279 virtual void OnSelectZoom( wxCommandEvent& event );
280
284 virtual void OnSize( wxSizeEvent& event ) override;
285
286 void OnMove( wxMoveEvent& aEvent ) override;
287
291 virtual void HardRedraw();
292
297 virtual void Zoom_Automatique( bool aWarpPointer );
298
307 void FocusOnLocation( const VECTOR2I& aPos );
308
313 void AddStandardSubMenus( TOOL_MENU& aMenu );
314
324 void PrintDrawingSheet( const RENDER_SETTINGS* aSettings, BASE_SCREEN* aScreen,
325 const std::map<wxString, wxString>* aProperties, double aMils2Iu,
326 const wxString& aFilename, const wxString& aSheetLayer = wxEmptyString );
327
328 void DisplayToolMsg( const wxString& msg ) override;
329
330 void DisplayConstraintsMsg( const wxString& msg );
331
337 virtual void OnPageSettingsChange() {}
338
346 void UpdateStatusBar() override;
347
351 void DisplayUnitsMsg();
352
356 virtual void DisplayGridMsg();
357
358 void LoadSettings( APP_SETTINGS_BASE* aCfg ) override;
359 void SaveSettings( APP_SETTINGS_BASE* aCfg ) override;
360
371 void AppendMsgPanel( const wxString& aTextUpper, const wxString& aTextLower, int aPadding = 6 );
372
376 virtual void ClearMsgPanel();
377
383 void SetMsgPanel( const std::vector< MSG_PANEL_ITEM >& aList );
384 void SetMsgPanel( EDA_ITEM* aItem );
385
393 void SetMsgPanel( const wxString& aTextUpper, const wxString& aTextLower, int aPadding = 6 );
394
398 virtual void UpdateMsgPanel();
399
400 virtual LIB_TREE* GetLibTree() const { return nullptr; }
401 virtual LIB_ID GetTargetLibId() const { return LIB_ID(); }
402
403 virtual bool IsLibraryTreeShown() const { return false; }
404 virtual void ToggleLibraryTree() {};
405 virtual void FocusLibraryTreeInput() {};
406
408
409 void UpdateProperties();
410
411 virtual void ToggleProperties() {}
412
413 static const wxString PropertiesPaneName() { return wxS( "PropertiesManager" ); }
414
415 static const wxString NetInspectorPanelName() { return wxS( "NetInspector" ); }
416
420 virtual EDA_ITEM* GetItem( const KIID& aId ) const { return nullptr; }
421
427 virtual void PrintPage( const RENDER_SETTINGS* aSettings );
428
432 virtual void ActivateGalCanvas();
433
437 virtual void SwitchCanvas( EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvasType );
438
444 virtual EDA_DRAW_PANEL_GAL* GetCanvas() const { return m_canvas; }
445 void SetCanvas( EDA_DRAW_PANEL_GAL* aPanel ) { m_canvas = aPanel; }
446
447 wxWindow* GetToolCanvas() const override { return GetCanvas(); }
448
453
454 void RefreshCanvas() override
455 {
456 GetCanvas()->Refresh();
457 }
458
471 virtual const BOX2I GetDocumentExtents( bool aIncludeAllVisible = true ) const;
472
476 void RecreateToolbars();
477
482
486 void ShowChangedLanguage() override;
487
489
490 virtual void CreateHotkeyPopup();
491
492
501 bool SaveCanvasImageToFile( const wxString& aFileName, BITMAP_TYPE aBitmapType );
502
506 virtual void OnApiPluginInvoke( wxCommandEvent& aEvent );
507
508 virtual PLUGIN_ACTION_SCOPE PluginActionScope() const { return PLUGIN_ACTION_SCOPE::INVALID; }
509
510
511 DECLARE_EVENT_TABLE()
512
513protected:
514 virtual void SetScreen( BASE_SCREEN* aScreen ) { m_currentScreen = aScreen; }
515
516 void unitsChangeRefresh() override;
517
518 void setupUnits( APP_SETTINGS_BASE* aCfg );
519
521
522 std::vector<wxWindow*> findDialogs();
523
527 virtual void resolveCanvasType();
528
535
540
544 virtual void handleActivateEvent( wxActivateEvent& aEvent );
545 void onActivate( wxActivateEvent& aEvent );
546
550 virtual void addApiPluginTools();
551
552
553 wxSocketServer* m_socketServer;
554
556 std::unique_ptr<LOCKFILE> m_file_checker;
557
558 COLOR4D m_gridColor; // Grid color
559 COLOR4D m_drawBgColor; // The background color of the draw canvas; BLACK for
560 // Pcbnew, BLACK or WHITE for Eeschema
561 int m_undoRedoCountMax; // Default Undo/Redo command Max depth, to be handed
562 // to screens
563 bool m_polarCoords; // For those frames that support polar coordinates
564
565 bool m_showBorderAndTitleBlock; // Show the drawing sheet (border & title block).
566
569
571 ACTION_TOOLBAR* m_auxiliaryToolBar; // Additional tools under main toolbar
572 ACTION_TOOLBAR* m_drawToolBar; // Drawing tools (typically on right edge of window)
573 ACTION_TOOLBAR* m_optionsToolBar; // Options (typically on left edge of window)
574
575 std::unique_ptr<EDA_SEARCH_DATA> m_findReplaceData;
578
581
586
588
591
594
595private:
598
601
603};
604
605#endif // DRAW_FRAME_H_
PLUGIN_ACTION_SCOPE
Definition: api_plugin.h:55
BITMAP_TYPE
Definition: bitmap_types.h:43
Define the structure of a toolbar with buttons that invoke ACTIONs.
APP_SETTINGS_BASE is a settings class that should be derived for each standalone KiCad application.
Definition: app_settings.h:92
Handles how to draw a screen (a board, a schematic ...)
Definition: base_screen.h:41
Color settings are a bit different than most of the settings objects in that there can be more than o...
The base class for create windows for drawing purpose.
virtual const BOX2I GetDocumentExtents(bool aIncludeAllVisible=true) const
Returns bbox of document with option to not include some items.
wxArrayString m_replaceStringHistoryList
virtual void ClearMsgPanel()
Clear all messages from the message panel.
virtual void ReCreateVToolbar()
virtual void UpdateToolbarControlSizes()
Update the sizes of any controls in the toolbars of the frame.
HOTKEY_CYCLE_POPUP * GetHotkeyPopup()
EDA_DRAW_PANEL_GAL * m_canvas
This the frame's interface to setting GAL display options.
virtual void ActivateGalCanvas()
Use to start up the GAL drawing canvas.
virtual void SetTitleBlock(const TITLE_BLOCK &aTitleBlock)=0
void SaveSettings(APP_SETTINGS_BASE *aCfg) override
Save common frame parameters to a configuration data file.
GAL_DISPLAY_OPTIONS_IMPL m_galDisplayOptions
virtual const TITLE_BLOCK & GetTitleBlock() const =0
virtual void PrintPage(const RENDER_SETTINGS *aSettings)
Print the page pointed by current screen, set by the calling print function.
void onActivate(wxActivateEvent &aEvent)
COLOR_SETTINGS * m_colorSettings
wxChoice * m_gridSelectBox
void AddStandardSubMenus(TOOL_MENU &aMenu)
Construct a "basic" menu for a tool, containing only items that apply to all tools (e....
void ReleaseFile()
Release the current file marked in use.
void OnToolbarSizeChanged()
Update toolbars if desired toolbar icon changed.
EDA_DRAW_PANEL_GAL::GAL_TYPE m_canvasType
virtual BASE_SCREEN * GetScreen() const
Return a pointer to a BASE_SCREEN or one of its derivatives.
void ScriptingConsoleEnableDisable()
Toggles the scripting console visibility.
virtual wxString GetFullScreenDesc() const
void OnSelectGrid(wxCommandEvent &event)
Command event handler for selecting grid sizes.
void DisplayToolMsg(const wxString &msg) override
std::unique_ptr< LOCKFILE > m_file_checker
bool IsScriptingConsoleVisible()
Gets the current visibility of the scripting console window.
void OnUpdateSelectZoom(wxUpdateUIEvent &aEvent)
Update the checked item in the zoom wxchoice.
virtual const PAGE_INFO & GetPageSettings() const =0
virtual void FocusLibraryTreeInput()
void DisplayUnitsMsg()
Display current unit pane in the status bar.
void setupUnits(APP_SETTINGS_BASE *aCfg)
virtual void ToggleLibraryTree()
void SetMsgPanel(const std::vector< MSG_PANEL_ITEM > &aList)
Clear the message panel and populates it with the contents of aList.
void RefreshCanvas() override
virtual COLOR4D GetGridColor()
ACTION_TOOLBAR * m_optionsToolBar
void UpdateGridSelectBox()
Rebuild the grid combobox to respond to any changes in the GUI (units, user grid changes,...
virtual const VECTOR2I GetPageSizeIU() const =0
Works off of GetPageSettings() to return the size of the paper page in the internal units of this par...
bool LockFile(const wxString &aFileName)
Mark a schematic file as being in use.
virtual void HardRedraw()
Rebuild the GAL and redraws the screen.
virtual void SetGridOrigin(const VECTOR2I &aPosition)=0
bool LibraryFileBrowser(bool doOpen, wxFileName &aFilename, const wxString &wildcard, const wxString &ext, bool isDirectory=false, bool aIsGlobal=false, const wxString &aGlobalPath=wxEmptyString)
virtual bool IsLibraryTreeShown() const
bool IsGridOverridden() const
void LoadSettings(APP_SETTINGS_BASE *aCfg) override
Load common frame parameters from a configuration file.
bool SaveCanvasImageToFile(const wxString &aFileName, BITMAP_TYPE aBitmapType)
Save the current view as an image file.
void UpdateZoomSelectBox()
Rebuild the grid combobox to respond to any changes in the GUI (units, user grid changes,...
virtual void SetPageSettings(const PAGE_INFO &aPageSettings)=0
virtual void SwitchCanvas(EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvasType)
Changes the current rendering backend.
virtual void OnSize(wxSizeEvent &event) override
Recalculate the size of toolbars and display panel when the frame size changes.
EDA_DRAW_PANEL_GAL::GAL_TYPE loadCanvasTypeSetting(APP_SETTINGS_BASE *aCfg=nullptr)
Returns the canvas type stored in the application settings.
const wxString GetZoomLevelIndicator() const
Return a human readable value for display in dialogs.
virtual void OnSelectZoom(wxCommandEvent &event)
Set the zoom factor when selected by the zoom list box in the main tool bar.
GAL_DISPLAY_OPTIONS_IMPL & GetGalDisplayOptions()
Return a reference to the gal rendering options used by GAL for rendering.
virtual void resolveCanvasType()
Determines the Canvas type to load (with prompt if required) and initializes m_canvasType.
static bool m_openGLFailureOccured
Has any failure occured when switching to OpenGL in any EDA_DRAW_FRAME?
virtual LIB_TREE * GetLibTree() const
BASE_SCREEN * m_currentScreen
current used SCREEN
virtual wxString GetScreenDesc() const
VECTOR2I GetNearestGridPosition(const VECTOR2I &aPosition) const
Return the nearest aGridSize location to aPosition.
static const wxString PropertiesPaneName()
EDA_MSG_PANEL * m_messagePanel
void SetCanvas(EDA_DRAW_PANEL_GAL *aPanel)
virtual const VECTOR2I & GetGridOrigin() const =0
Return the absolute coordinates of the origin of the snap grid.
virtual void ReCreateAuxiliaryToolbar()
void SetShowPolarCoords(bool aShow)
void FocusOnLocation(const VECTOR2I &aPos)
Useful to focus on a particular location, in find functions.
virtual void SetScreen(BASE_SCREEN *aScreen)
virtual void ReCreateHToolbar()
void RecreateToolbars()
Rebuild all toolbars, and update the checked state of check tools.
bool saveCanvasTypeSetting(EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvasType)
Stores the canvas type in the application settings.
ACTION_TOOLBAR * m_mainToolBar
virtual void Zoom_Automatique(bool aWarpPointer)
Redraw the screen with best zoom level and the best centering that shows all the page or the board.
COLOR4D m_drawBgColor
NET_INSPECTOR_PANEL * m_netInspectorPanel
virtual void SetGridVisibility(bool aVisible)
virtual void handleActivateEvent(wxActivateEvent &aEvent)
Handle a window activation event.
virtual void ReCreateOptToolbar()
virtual void OnApiPluginInvoke(wxCommandEvent &aEvent)
Handler for activating an API plugin (via toolbar or menu)
virtual void SetDrawBgColor(const COLOR4D &aColor)
virtual void UpdateMsgPanel()
Redraw the message panel.
virtual COLOR_SETTINGS * GetColorSettings(bool aForceRefresh=false) const
Returns a pointer to the active color theme settings.
void ToggleUserUnits() override
static const wxString NetInspectorPanelName()
virtual void CreateHotkeyPopup()
void UpdateStatusBar() override
Update the status bar information.
void GetUnitPair(EDA_UNITS &aPrimaryUnit, EDA_UNITS &aSecondaryUnits) override
Get the pair or units in current use.
wxArrayString & GetFindHistoryList()
void ShowChangedLanguage() override
Redraw the menus and what not in current language.
virtual EDA_ITEM * GetItem(const KIID &aId) const
Fetch an item by KIID.
void updateStatusBarWidths()
void PrintDrawingSheet(const RENDER_SETTINGS *aSettings, BASE_SCREEN *aScreen, const std::map< wxString, wxString > *aProperties, double aMils2Iu, const wxString &aFilename, const wxString &aSheetLayer=wxEmptyString)
Prints the drawing-sheet (frame and title block).
virtual EDA_DRAW_PANEL_GAL * GetCanvas() const
Return a pointer to GAL-based canvas of given EDA draw frame.
virtual void OnPageSettingsChange()
Called when modifying the page settings.
wxSocketServer * m_socketServer
Prevents opening same file multiple times.
ACTION_TOOLBAR * m_drawToolBar
SEARCH_PANE * m_searchPane
EDA_SEARCH_DATA & GetFindReplaceData()
virtual COLOR4D GetDrawBgColor() const
void unitsChangeRefresh() override
Called when when the units setting has changed to allow for any derived classes to handle refreshing ...
void OnMove(wxMoveEvent &aEvent) override
void CommonSettingsChanged(bool aEnvVarsChanged, bool aTextVarsChanged) override
Notification event that some of the common (suite-wide) settings have changed.
bool IsGridVisible() const
std::vector< wxWindow * > findDialogs()
virtual void DisplayGridMsg()
Display current grid size in the status bar.
virtual void SetGridColor(const COLOR4D &aColor)
wxArrayString m_findStringHistoryList
virtual LIB_ID GetTargetLibId() const
wxChoice * m_zoomSelectBox
PROPERTIES_PANEL * GetPropertiesPanel()
wxWindow * GetToolCanvas() const override
Canvas access.
virtual PLUGIN_ACTION_SCOPE PluginActionScope() const
std::unique_ptr< EDA_SEARCH_DATA > m_findReplaceData
void DisplayConstraintsMsg(const wxString &msg)
void AppendMsgPanel(const wxString &aTextUpper, const wxString &aTextLower, int aPadding=6)
Append a message to the message panel.
virtual void SetGridOverrides(bool aOverride)
PROPERTIES_PANEL * m_propertiesPanel
virtual void addApiPluginTools()
Append actions from API plugins to the main toolbar.
bool m_showBorderAndTitleBlock
VECTOR2I GetNearestHalfGridPosition(const VECTOR2I &aPosition) const
Return the nearest aGridSize / 2 location to aPosition.
HOTKEY_CYCLE_POPUP * m_hotkeyPopup
The current canvas type.
void OnUpdateSelectGrid(wxUpdateUIEvent &aEvent)
Update the checked item in the grid wxchoice.
virtual void ToggleProperties()
ACTION_TOOLBAR * m_auxiliaryToolBar
bool GetShowPolarCoords() const
For those frames that support polar coordinates.
virtual void Refresh(bool aEraseBackground=true, const wxRect *aRect=nullptr) override
A base class for most all the KiCad significant classes used in schematics and boards.
Definition: eda_item.h:89
A panel to display various information messages.
Definition: msgpanel.h:101
Similar to EDA_VIEW_SWITCHER, this dialog is a popup that shows feedback when using a hotkey to cycle...
A color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:104
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
Definition: kiid.h:49
A wxFrame capable of the OpenProjectFiles function, meaning it can load a portion of a KiCad project.
Definition: kiway_player.h:65
A minimalistic software bus for communications between various DLLs/DSOs (DSOs) within the same KiCad...
Definition: kiway.h:279
A logical library item identifier and consists of various portions much like a URI.
Definition: lib_id.h:49
Widget displaying a tree of symbols with optional search text control and description panel....
Definition: lib_tree.h:49
A base class used to implement docking net inspector panels.
Describe the page size and margins of a paper page on which to eventually print or plot.
Definition: page_info.h:59
Hold the information shown in the lower right corner of a plot, printout, or editing view.
Definition: title_block.h:41
Manage a CONDITIONAL_MENU and some number of CONTEXT_MENUs as sub-menus.
Definition: tool_menu.h:43
Base window classes and related definitions.
EDA_UNITS
Definition: eda_units.h:46
FRAME_T
The set of EDA_BASE_FRAME derivatives, typically stored in EDA_BASE_FRAME::m_Ident.
Definition: frame_type.h:33
The Cairo implementation of the graphics abstraction layer.
Definition: color4d.cpp:247