SCH_EDIT_FRAME Class Reference

Schematic editor (Eeschema) main window. More...

#include <sch_edit_frame.h>

Inheritance diagram for SCH_EDIT_FRAME:

Public Types
enum	UNDO_REDO_LIST { UNDO_LIST , REDO_LIST }
	Specifies whether we are interacting with the undo or redo stacks. More...
enum	HOLDER_TYPE { DIALOG , FRAME , PANEL }

Public Member Functions
	SCH_EDIT_FRAME (KIWAY *aKiway, wxWindow *aParent)
	~SCH_EDIT_FRAME () override
SCH_SCREEN *	GetScreen () const override
	Return a pointer to a BASE_SCREEN or one of its derivatives. More...
SELECTION &	GetCurrentSelection () override
	Get the current selection from the canvas area. More...
SCHEMATIC &	Schematic () const
bool	GetShowAllPins () const override
	Allow edit frame to show/hide hidden pins. More...
void	SaveProjectSettings () override
	Save changes to the project settings to the project (.pro) file. More...
bool	LoadProjectSettings ()
	Load the KiCad project file (*.pro) settings specific to Eeschema. More...
void	ShowSchematicSetupDialog (const wxString &aInitialPage=wxEmptyString)
void	LoadSettings (APP_SETTINGS_BASE *aCfg) override
	Load common frame parameters from a configuration file. More...
void	SaveSettings (APP_SETTINGS_BASE *aCfg) override
	Save common frame parameters to a configuration data file. More...
void	CreateScreens ()
void	ReCreateHToolbar () override
void	ReCreateVToolbar () override
void	ReCreateOptToolbar () override
void	ReCreateMenuBar () override
	Recreates the menu bar. More...
void	setupUIConditions () override
	Setup the UI conditions for the various actions and their controls in this frame. More...
bool	IsContentModified () const override
	Get if the current schematic has been modified but not saved. More...
void	OnModify () override
	Must be called after a schematic change in order to set the "modify" flag of the current screen and update the date in frame reference. More...
void	RecordERCExclusions ()
	Scan existing markers and record data from any that are Excluded. More...
void	ResolveERCExclusions ()
	Update markers to match recorded exclusions. More...
SEVERITY	GetSeverity (int aErrorCode) const override
wxString	GetScreenDesc () const override
	Return a human-readable description of the current screen. More...
void	ExecuteRemoteCommand (const char *cmdline) override
	Execute a remote command sent by Pcbnew via a socket connection. More...
void	KiwayMailIn (KIWAY_EXPRESS &aEvent) override
	Receive KIWAY_EXPRESS messages from other players. More...
void	AutoRotateItem (SCH_SCREEN *aScreen, SCH_ITEM *aItem)
	Automatically set the rotation of an item (if the item supports it) More...
void	AddItemToScreenAndUndoList (SCH_SCREEN *aScreen, SCH_ITEM *aItem, bool aUndoAppend)
	Add an item to the schematic and adds the changes to the undo/redo container. More...
void	ShowFindReplaceDialog (bool aReplace)
	Run the Find or Find & Replace dialog. More...
void	UpdateHierarchyNavigator ()
	Update the hierarchy navigation tree and history. More...
void	ShowFindReplaceStatus (const wxString &aMsg, int aStatusTime)
void	ClearFindReplaceStatus ()
void	OnFindDialogClose ()
	Notification that the Find dialog has closed. More...
bool	BreakSegment (SCH_LINE *aSegment, const VECTOR2I &aPoint, SCH_LINE **aNewSegment=nullptr, SCH_SCREEN *aScreen=nullptr)
	Break a single segment into two at the specified point. More...
bool	BreakSegments (const VECTOR2I &aPoint, SCH_SCREEN *aScreen=nullptr)
	Check every wire and bus for a intersection at aPoint and break into two segments at aPoint if an intersection is found. More...
bool	BreakSegmentsOnJunctions (SCH_SCREEN *aScreen=nullptr)
	Test all junctions and bus entries in the schematic for intersections with wires and buses and breaks any intersections into multiple segments. More...
void	TestDanglingEnds ()
	Test all of the connectable objects in the schematic for unused connection points. More...
void	SendSelectItemsToPcb (const std::vector< EDA_ITEM * > &aItems, bool aForce)
	Sends items to Pcbnew for selection. More...
void	SendCrossProbeNetName (const wxString &aNetName)
	Sends a net name to Pcbnew for highlighting. More...
void	SetCrossProbeConnection (const SCH_CONNECTION *aConnection)
	Send a connection (net or bus) to Pcbnew for highlighting. More...
void	SendCrossProbeClearHighlight ()
	Tell Pcbnew to clear the existing highlighted net, if one exists. More...
const SCH_CONNECTION *	GetHighlightedConnection () const
void	SetHighlightedConnection (const SCH_CONNECTION *aConnection)
bool	ReadyToNetlist (const wxString &aAnnotateMessage)
	Check if we are ready to write a netlist file for the current schematic. More...
bool	WriteNetListFile (int aFormat, const wxString &aFullFileName, unsigned aNetlistOptions, REPORTER *aReporter=nullptr)
	Create a netlist file. More...
void	DeleteAnnotation (ANNOTATE_SCOPE_T aAnnotateScope, bool aRecursive, bool *appendUndo)
	Clear the current symbol annotation. More...
void	AnnotateSymbols (ANNOTATE_SCOPE_T aAnnotateScope, ANNOTATE_ORDER_T aSortOption, ANNOTATE_ALGO_T aAlgoOption, bool aRecursive, int aStartNumber, bool aResetAnnotation, bool aRepairTimestamps, REPORTER &aReporter, bool appendUndo=false)
	Annotate the symbols in the schematic that are not currently annotated. More...
int	CheckAnnotate (ANNOTATION_ERROR_HANDLER aErrorHandler, ANNOTATE_SCOPE_T aAnnotateScope=ANNOTATE_ALL, bool aRecursive=true)
	Check for annotation errors. More...
int	ModalAnnotate (const wxString &aMessage)
	Run a modal version of the annotate dialog for a specific purpose. More...
SCH_SHEET_PATH &	GetCurrentSheet () const
void	SetCurrentSheet (const SCH_SHEET_PATH &aSheet)
void	UpdateItem (EDA_ITEM *aItem, bool isAddOrDelete=false, bool aUpdateRtree=false) override
	Mark an item for refresh. More...
void	HardRedraw () override
	Rebuild the GAL and redraw the screen. More...
void	DisplayCurrentSheet ()
	Draw the current sheet on the display. More...
void	DrawCurrentSheetToClipboard ()
	Use the wxWidgets print code to draw an image of the current sheet onto the clipboard. More...
void	OnPageSettingsChange () override
	Called when modifying the page settings. More...
wxString	GetUniqueFilenameForCurrentSheet ()
void	SetSheetNumberAndCount ()
	Set the m_ScreenNumber and m_NumberOfScreens members for screens. More...
wxPageSetupDialogData &	GetPageSetupData ()
void	NewProject ()
void	LoadProject ()
bool	SaveProject (bool aSaveAs=false)
	Save the currently-open schematic (including its hierarchy) and associated project. More...
bool	OpenProjectFiles (const std::vector< wxString > &aFileSet, int aCtl=0) override
	Open a project or set of files given by aFileList. More...
wxString	GetCurrentFileName () const override
	Get the full filename + path of the currently opened file in the frame. More...
bool	AppendSchematic ()
	Import a KiCad schematic into the current sheet. More...
bool	AddSheetAndUpdateDisplay (const wxString aFullFileName)
	Add a sheet file into the current sheet and updates display. More...
bool	AskToSaveChanges ()
	Check if any of the screens has unsaved changes and asks the user whether to save or drop them. More...
SCH_JUNCTION *	AddJunction (SCH_SCREEN *aScreen, const VECTOR2I &aPos, bool aAppendToUndo, bool aFinal=true)
bool	SchematicCleanUp (SCH_SCREEN *aScreen=nullptr)
	Perform routine schematic cleaning including breaking wire and buses and deleting identical objects superimposed on top of each other. More...
bool	TrimWire (const VECTOR2I &aStart, const VECTOR2I &aEnd)
	If any single wire passes through both points, remove the portion between the two points, potentially splitting the wire into two. More...
std::vector< VECTOR2I >	GetSchematicConnections ()
	Collect a unique list of all possible connection points in the schematic. More...
void	OnOpenPcbnew (wxCommandEvent &event)
void	OnOpenCvpcb (wxCommandEvent &event)
void	OnUpdatePCB (wxCommandEvent &event)
void	OnAnnotate (wxCommandEvent &event)
bool	CheckSheetForRecursion (SCH_SHEET *aSheet, SCH_SHEET_PATH *aHierarchy)
	Verify that aSheet will not cause a recursion error in aHierarchy. More...
bool	AllowCaseSensitiveFileNameClashes (const wxString &aSchematicFileName)
	Check aSchematicFileName for a potential file name case sensitivity clashes. More...
bool	EditSheetProperties (SCH_SHEET *aSheet, SCH_SHEET_PATH *aHierarchy, bool *aClearAnnotationNewItems)
	Edit an existing sheet or add a new sheet to the schematic. More...
void	InitSheet (SCH_SHEET *aSheet, const wxString &aNewFilename)
bool	LoadSheetFromFile (SCH_SHEET *aSheet, SCH_SHEET_PATH *aHierarchy, const wxString &aFileName)
	Load a the KiCad schematic file aFileName into the sheet aSheet. More...
void	DeleteJunction (SCH_ITEM *aItem, bool aAppend=false)
	Removes a given junction and heals any wire segments under the junction. More...
void	ConvertPart (SCH_SYMBOL *aSymbol)
void	SelectUnit (SCH_SYMBOL *aSymbol, int aUnit)
void	StartNewUndo ()
	Create a new, blank stack for future Undo commands to be pushed to. More...
void	SaveCopyInUndoList (SCH_SCREEN *aScreen, SCH_ITEM *aItemToCopy, UNDO_REDO aTypeCommand, bool aAppend, bool aDirtyConnectivity=true)
	Create a copy of the current schematic item, and put it in the undo list. More...
void	SaveCopyInUndoList (const PICKED_ITEMS_LIST &aItemsList, UNDO_REDO aTypeCommand, bool aAppend, bool aDirtyConnectivity=true)
	Create a new entry in undo list of commands. More...
void	PutDataInPreviousState (PICKED_ITEMS_LIST *aList)
	Restore an undo or redo command to put data pointed by aList in the previous state. More...
void	ClearUndoORRedoList (UNDO_REDO_LIST whichList, int aItemCount=-1) override
	Free the undo or redo list from aList element. More...
void	SaveCopyForRepeatItem (const SCH_ITEM *aItem)
	Clone aItem and owns that clone in this container. More...
void	AddCopyForRepeatItem (const SCH_ITEM *aItem)
const std::vector< std::unique_ptr< SCH_ITEM > > &	GetRepeatItems () const
	Return the items which are to be repeated with the insert key. More...
EDA_ITEM *	GetItem (const KIID &aId) const override
	Fetch an item by KIID. More...
void	RollbackSchematicFromUndo ()
	Perform an undo of the last edit WITHOUT logging a corresponding redo. More...
bool	CreateArchiveLibraryCacheFile (bool aUseCurrentSheetFilename=false)
	Create a symbol library file with the name of the root document plus the '-cache' suffix,. More...
bool	CreateArchiveLibrary (const wxString &aFileName)
	Create a library aFileName that contains all symbols used in the current schematic. More...
virtual void	PrintPage (const RENDER_SETTINGS *aSettings) override
	Plot or print the current sheet to the clipboard. More...
void	SetNetListerCommand (const wxString &aCommand)
void	DefaultExecFlags ()
	Reset the execution flags to defaults for external netlist and bom generators. More...
void	SetExecFlags (const int aFlags)
	Set (adds) specified flags for next execution of external generator of the netlist or bom. More...
void	ClearExecFlags (const int aFlags)
	Clear (removes) specified flags that not needed for next execution of external generator of the netlist or bom. More...
wxString	GetNetListerCommand () const
void	RecalculateConnections (SCH_CLEANUP_FLAGS aCleanupFlags)
	Generate the connection data for the entire schematic hierarchy. More...
void	CommonSettingsChanged (bool aEnvVarsChanged, bool aTextVarsChanged) override
	Called after the preferences dialog is run. More...
void	UpdateNetHighlightStatus ()
void	ShowChangedLanguage () override
void	SetScreen (BASE_SCREEN *aScreen) override
const BOX2I	GetDocumentExtents (bool aIncludeAllVisible=true) const override
	Returns bbox of document with option to not include some items. More...
void	FixupJunctions ()
int	GetSchematicJunctionSize ()
void	FocusOnItem (SCH_ITEM *aItem)
bool	IsSyncingSelection ()
void	SaveSymbolToSchematic (const LIB_SYMBOL &aSymbol, const KIID &aSchematicSymbolUUID)
	Update a schematic symbol from a LIB_SYMBOL. More...
void	RecomputeIntersheetRefs (bool autoplaceUninitialized=false)
	Update the schematic's page reference map for all global labels, and refresh the labels so that they are redrawn with up-to-date references. More...
void	ShowAllIntersheetRefs (bool aShow)
virtual void	CheckForAutoSaveFile (const wxFileName &aFileName) override
	This overloaded version checks if the auto save master file "#auto_saved_files#" exists and recovers all of the schematic files listed in it. More...
void	ToggleSchematicHierarchy ()
	Toggle the show/hide state of the left side schematic navigation panel. More...
void	createCanvas ()
SCH_DRAW_PANEL *	GetCanvas () const override
	Return a pointer to GAL-based canvas of given EDA draw frame. More...
EESCHEMA_SETTINGS *	eeconfig () const
SYMBOL_EDITOR_SETTINGS *	libeditconfig () const
KIGFX::SCH_RENDER_SETTINGS *	GetRenderSettings ()
COLOR4D	GetDrawBgColor () const override
void	SetPageSettings (const PAGE_INFO &aPageSettings) override
const PAGE_INFO &	GetPageSettings () const override
const wxSize	GetPageSizeIU () const override
	Works off of GetPageSettings() to return the size of the paper page in the internal units of this particular view. More...
const VECTOR2I &	GetGridOrigin () const override
	Return the absolute coordinates of the origin of the snap grid. More...
void	SetGridOrigin (const VECTOR2I &aPoint) override
const TITLE_BLOCK &	GetTitleBlock () const override
void	SetTitleBlock (const TITLE_BLOCK &aTitleBlock) override
void	UpdateStatusBar () override
	Update the status bar information. More...
PICKED_SYMBOL	PickSymbolFromLibTree (const SYMBOL_LIBRARY_FILTER *aFilter, std::vector< PICKED_SYMBOL > &aHistoryList, bool aUseLibBrowser, int aUnit, int aConvert, bool aShowFootprints, const LIB_ID *aHighlight=nullptr, bool aAllowFields=true)
	Call the library viewer to select symbol to import into schematic. More...
LIB_SYMBOL *	GetLibSymbol (const LIB_ID &aLibId, bool aUseCacheLib=false, bool aShowErrorMsg=false)
	Load symbol from symbol library table. More...
PICKED_SYMBOL	PickSymbolFromLibBrowser (wxTopLevelWindow *aParent, const SYMBOL_LIBRARY_FILTER *aFilter, const LIB_ID &aPreselectedLibId, int aUnit, int aConvert)
	Call the library viewer to select symbol to import into schematic. More...
wxString	SelectLibraryFromList ()
	Display a list of loaded libraries and allows the user to select a library. More...
SYMBOL_LIB_TABLE *	SelectSymLibTable (bool aOptional=false)
	Display a dialog asking the user to select a symbol library table. More...
virtual void	RedrawScreen (const VECTOR2I &aCenterPoint, bool aWarpPointer)
void	AddToScreen (EDA_ITEM *aItem, SCH_SCREEN *aScreen)
	Add an item to the screen (and view) aScreen is the screen the item is located on, if not the current screen. More...
void	RemoveFromScreen (EDA_ITEM *aItem, SCH_SCREEN *aScreen)
	Remove an item from the screen (and view) aScreen is the screen the item is located on, if not the current screen. More...
void	RefreshZoomDependentItems ()
	Mark selected items for refresh. More...
void	SyncView ()
	Mark all items for refresh. More...
COLOR4D	GetLayerColor (SCH_LAYER_ID aLayer)
	Helper to retrieve a layer color from the global color settings. More...
COLOR_SETTINGS *	GetColorSettings (bool aForceRefresh=false) const override
	Returns a pointer to the active color theme settings. More...
void	ActivateGalCanvas () override
	Use to start up the GAL drawing canvas. More...
bool	LockFile (const wxString &aFileName)
	Mark a schematic file as being in use. More...
void	ReleaseFile ()
	Release the current file marked in use. More...
void	ScriptingConsoleEnableDisable ()
	Toggles the scripting console visibility. More...
bool	IsScriptingConsoleVisible ()
	Gets the current visibility of the scripting console window. More...
EDA_SEARCH_DATA &	GetFindReplaceData ()
wxArrayString &	GetFindHistoryList ()
bool	GetShowPolarCoords () const
	For those frames that support polar coordinates. More...
void	SetShowPolarCoords (bool aShow)
void	ToggleUserUnits () override
void	GetUnitPair (EDA_UNITS &aPrimaryUnit, EDA_UNITS &aSecondaryUnits)
	Get the pair or units in current use. More...
VECTOR2I	GetNearestGridPosition (const VECTOR2I &aPosition) const
	Return the nearest aGridSize location to aPosition. More...
VECTOR2I	GetNearestHalfGridPosition (const VECTOR2I &aPosition) const
	Return the nearest aGridSize / 2 location to aPosition. More...
virtual void	SetDrawBgColor (const COLOR4D &aColor)
bool	LibraryFileBrowser (bool doOpen, wxFileName &aFilename, const wxString &wildcard, const wxString &ext, bool isDirectory=false, bool aIsGlobal=false, const wxString &aGlobalPath=wxEmptyString)
void	EraseMsgBox ()
virtual void	ReCreateAuxiliaryToolbar ()
virtual void	UpdateToolbarControlSizes ()
	Update the sizes of any controls in the toolbars of the frame. More...
bool	IsGridVisible () const
virtual void	SetGridVisibility (bool aVisible)
virtual COLOR4D	GetGridColor ()
virtual void	SetGridColor (const COLOR4D &aColor)
void	OnSelectGrid (wxCommandEvent &event)
	Command event handler for selecting grid sizes. More...
void	OnGridSettings (wxCommandEvent &event)
void	UpdateGridSelectBox ()
	Rebuild the grid combobox to respond to any changes in the GUI (units, user grid changes, etc.). More...
void	OnUpdateSelectGrid (wxUpdateUIEvent &aEvent)
	Update the checked item in the grid wxchoice. More...
void	OnUpdateSelectZoom (wxUpdateUIEvent &aEvent)
	Update the checked item in the zoom wxchoice. More...
void	UpdateZoomSelectBox ()
	Rebuild the grid combobox to respond to any changes in the GUI (units, user grid changes, etc.) More...
const wxString	GetZoomLevelIndicator () const
	Return a human readable value for display in dialogs. More...
virtual void	OnSelectZoom (wxCommandEvent &event)
	Set the zoom factor when selected by the zoom list box in the main tool bar. More...
virtual void	OnSize (wxSizeEvent &event) override
	Recalculate the size of toolbars and display panel when the frame size changes. More...
void	OnMove (wxMoveEvent &aEvent) override
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. More...
void	FocusOnLocation (const VECTOR2I &aPos)
	Useful to focus on a particular location, in find functions. More...
void	AddStandardSubMenus (TOOL_MENU &aMenu)
	Construct a "basic" menu for a tool, containing only items that apply to all tools (e.g. More...
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). More...
void	DisplayToolMsg (const wxString &msg) override
void	DisplayConstraintsMsg (const wxString &msg)
void	DisplayUnitsMsg ()
	Display current unit pane in the status bar. More...
virtual void	DisplayGridMsg ()
	Display current grid size in the status bar. More...
void	AppendMsgPanel (const wxString &aTextUpper, const wxString &aTextLower, int aPadding=6)
	Append a message to the message panel. More...
virtual void	ClearMsgPanel ()
	Clear all messages from the message panel. More...
void	SetMsgPanel (const std::vector< MSG_PANEL_ITEM > &aList)
	Clear the message panel and populates it with the contents of aList. More...
void	SetMsgPanel (EDA_ITEM *aItem)
void	SetMsgPanel (const wxString &aTextUpper, const wxString &aTextLower, int aPadding=6)
	Helper function that erases the msg panel and then appends a single message. More...
virtual void	UpdateMsgPanel ()
	Redraw the message panel. More...
virtual void	SwitchCanvas (EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvasType)
	Changes the current rendering backend. More...
void	SetCanvas (EDA_DRAW_PANEL_GAL *aPanel)
wxWindow *	GetToolCanvas () const override
	Canvas access. More...
KIGFX::GAL_DISPLAY_OPTIONS &	GetGalDisplayOptions ()
	Return a reference to the gal rendering options used by GAL for rendering. More...
void	RefreshCanvas () override
void	RecreateToolbars ()
	Rebuild all toolbars, and update the checked state of check tools. More...
virtual void	ParseArgs (wxCmdLineParser &aParser)
	Handle command-line arguments in a frame-specific way. More...
virtual bool	ShowModal (wxString *aResult=nullptr, wxWindow *aResultantFocusWindow=nullptr)
	Show this wxFrame as if it were a modal dialog, with all other instantiated wxFrames disabled until this KIWAY_PLAYER derivative calls DismissModal(). More...
bool	Destroy () override
	Our version of Destroy() which is virtual from wxWidgets. More...
bool	IsModal () const override
	Return true if the frame is shown in our modal mode and false if the frame is shown as an usual frame. More...
void	SetModal (bool aIsModal)
bool	IsDismissed ()
void	DismissModal (bool aRetVal, const wxString &aResult=wxEmptyString)
void	CreateServer (int service, bool local=true)
void	OnSockRequest (wxSocketEvent &evt)
void	OnSockRequestServer (wxSocketEvent &evt)
void	ChangeUserUnits (EDA_UNITS aUnits)
virtual ORIGIN_TRANSFORMS &	GetOriginTransforms ()
	Return a reference to the default ORIGIN_TRANSFORMS object. More...
SETTINGS_MANAGER *	GetSettingsManager () const
bool	ProcessEvent (wxEvent &aEvent) override
	Override the default process event handler to implement the auto save feature. More...
virtual void	OnCharHook (wxKeyEvent &aKeyEvent)
	Capture the key event before it is sent to the GUI. More...
void	OnMenuEvent (wxMenuEvent &event)
	The TOOL_DISPATCHER needs these to work around some issues in wxWidgets where the menu events aren't captured by the menus themselves. More...
virtual void	RegisterUIUpdateHandler (int aID, const ACTION_CONDITIONS &aConditions) override
	Register a UI update handler for the control with ID aID. More...
virtual void	RegisterUIUpdateHandler (const TOOL_ACTION &aAction, const ACTION_CONDITIONS &aConditions)
	Register an action's update conditions with the UI layer to allow the UI to appropriately display the state of its controls. More...
virtual void	UnregisterUIUpdateHandler (int aID) override
	Unregister a UI handler for a given ID that was registered using RegisterUIUpdateHandler. More...
virtual void	UnregisterUIUpdateHandler (const TOOL_ACTION &aAction)
	Unregister a UI handler for an action that was registered using RegisterUIUpdateHandler. More...
void	OnMaximize (wxMaximizeEvent &aEvent)
int	GetAutoSaveInterval () const
bool	IsType (FRAME_T aType) const
FRAME_T	GetFrameType () const
virtual const SEARCH_STACK &	sys_search ()
	Return a SEARCH_STACK pertaining to entire program. More...
virtual wxString	help_name ()
void	OnKicadAbout (wxCommandEvent &event)
void	OnPreferences (wxCommandEvent &event)
	Displays the preferences and settings of all opened editors paged dialog. More...
void	PrintMsg (const wxString &text)
void	CreateInfoBar ()
void	FinishAUIInitialization ()
WX_INFOBAR *	GetInfoBar ()
void	ShowInfoBarError (const wxString &aErrorMsg, bool aShowCloseButton=false, WX_INFOBAR::MESSAGE_TYPE aType=WX_INFOBAR::MESSAGE_TYPE::GENERIC)
	Show the WX_INFOBAR displayed on the top of the canvas with a message and an error icon on the left of the infobar, and an optional closebox to the right. More...
void	ShowInfoBarError (const wxString &aErrorMsg, bool aShowCloseButton, std::function< void(void)> aCallback)
	Show the WX_INFOBAR displayed on the top of the canvas with a message and an error icon on the left of the infobar, and an optional closebox to the right. More...
void	ShowInfoBarWarning (const wxString &aWarningMsg, bool aShowCloseButton=false)
	Show the WX_INFOBAR displayed on the top of the canvas with a message and a warning icon on the left of the infobar. More...
void	ShowInfoBarMsg (const wxString &aMsg, bool aShowCloseButton=false)
	Show the WX_INFOBAR displayed on the top of the canvas with a message and an info icon on the left of the infobar. More...
virtual APP_SETTINGS_BASE *	config () const
	Returns the settings object used in SaveSettings(), and is overloaded in KICAD_MANAGER_FRAME. More...
void	LoadWindowState (const wxString &aFileName)
virtual void	LoadWindowState (const WINDOW_STATE &aState)
	Load frame state info from a configuration file. More...
void	LoadWindowSettings (const WINDOW_SETTINGS *aCfg)
	Load window settings from the given settings object. More...
void	SaveWindowSettings (WINDOW_SETTINGS *aCfg)
	Save window settings to the given settings object. More...
virtual WINDOW_SETTINGS *	GetWindowSettings (APP_SETTINGS_BASE *aCfg)
	Return a pointer to the window settings for this frame. More...
wxString	ConfigBaseName () override
	Get the configuration base name. More...
void	ImportHotkeyConfigFromFile (std::map< std::string, TOOL_ACTION * > aActionMap, const wxString &aDefaultShortname)
	Prompt the user for a hotkey file to read, and read it. More...
wxString	GetFileFromHistory (int cmdId, const wxString &type, FILE_HISTORY *aFileHistory=nullptr)
	Fetches the file name from the file history list. More...
void	ClearFileHistory (FILE_HISTORY *aFileHistory=nullptr)
	Removes all files from the file history. More...
void	UpdateFileHistory (const wxString &FullFileName, FILE_HISTORY *aFileHistory=nullptr)
	Update the list of recently opened files. More...
FILE_HISTORY &	GetFileHistory ()
	Get the frame's main file history. More...
void	SetMruPath (const wxString &aPath)
wxString	GetMruPath () const
void	AddStandardHelpMenu (wxMenuBar *aMenuBar)
	Adds the standard KiCad help menu to the menubar. More...
bool	IsWritable (const wxFileName &aFileName, bool aVerbose=true)
	Checks if aFileName can be written. More...
virtual void	ThemeChanged ()
	Process light/dark theme change. More...
virtual void	ProjectChanged ()
	Notification event that the project has changed. More...
const wxString &	GetAboutTitle () const
wxSize	GetWindowSize ()
	Get the undecorated window size that can be used for restoring the window size. More...
virtual void	ClearUndoRedoList ()
	Clear the undo and redo list using ClearUndoORRedoList() More...
virtual void	PushCommandToUndoList (PICKED_ITEMS_LIST *aItem)
	Add a command to undo in the undo list. More...
virtual void	PushCommandToRedoList (PICKED_ITEMS_LIST *aItem)
	Add a command to redo in the redo list. More...
virtual PICKED_ITEMS_LIST *	PopCommandFromUndoList ()
	Return the last command to undo and remove it from list, nothing is deleted. More...
virtual PICKED_ITEMS_LIST *	PopCommandFromRedoList ()
	Return the last command to undo and remove it from list, nothing is deleted. More...
virtual int	GetUndoCommandCount () const
virtual int	GetRedoCommandCount () const
int	GetMaxUndoItems () const
bool	NonUserClose (bool aForce)
virtual void	HandleSystemColorChange ()
	Update the UI in response to a change in the system colors. More...
TOOL_MANAGER *	GetToolManager () const
	Return the MVC controller. More...
virtual void	PushTool (const TOOL_EVENT &aEvent)
	NB: the definition of "tool" is different at the user level. More...
virtual void	PopTool (const TOOL_EVENT &aEvent)
	Pops a tool from the stack. More...
bool	ToolStackIsEmpty ()
std::string	CurrentToolName () const
bool	IsCurrentTool (const TOOL_ACTION &aAction) const
bool	GetDoImmediateActions () const
	Indicate that hotkeys should perform an immediate action even if another tool is currently active. More...
MOUSE_DRAG_ACTION	GetDragAction () const
	Indicates whether a drag should draw a selection rectangle or drag selected (or unselected) objects. More...
bool	GetMoveWarpsCursor () const
	Indicate that a move operation should warp the mouse pointer to the origin of the move object. More...
HOLDER_TYPE	GetType () const
KIWAY &	Kiway () const
	Return a reference to the KIWAY that this object has an opportunity to participate in. More...
bool	HasKiway () const
	Safety check before asking for the Kiway reference. More...
PROJECT &	Prj () const
	Return a reference to the PROJECT associated with this KIWAY. More...
void	SetKiway (wxWindow *aDest, KIWAY *aKiway)
	It is only used for debugging, since "this" is not a wxWindow*. More...
EDA_UNITS	GetUserUnits () const
void	SetUserUnits (EDA_UNITS aUnits)
const EDA_IU_SCALE &	GetIuScale () const
wxString	StringFromValue (double aValue, bool aAddUnitLabel=false, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
	Converts aValue in internal units into a united string. More...
wxString	StringFromValue (const EDA_ANGLE &aValue, bool aAddUnitLabel=false)
wxString	MessageTextFromValue (double aValue, bool aAddUnitLabel=true, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
	A lower-precision version of StringFromValue(). More...
wxString	MessageTextFromValue (const EDA_ANGLE &aValue, bool aAddUnitLabel=true)
long long int	ValueFromString (const wxString &aTextValue, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
	Converts aTextValue in aUnits to internal units used by the frame. More...

Static Public Member Functions
static const wxString	SchematicHierarchyPaneName ()
static void	HandleUpdateUIEvent (wxUpdateUIEvent &aEvent, EDA_BASE_FRAME *aFrame, ACTION_CONDITIONS aCond)
	Handle events generated when the UI is trying to figure out the current state of the UI controls related to TOOL_ACTIONS (e.g. More...

Protected Member Functions
bool	doAutoSave () override
	Save the schematic files that have been modified and not yet saved. More...
bool	isAutoSaveRequired () const override
	Return true if the schematic has been modified. More...
void	sendNetlistToCvpcb ()
	Send the KiCad netlist over to CVPCB. More...
void	onSize (wxSizeEvent &aEvent)
void	handleActivateEvent (wxActivateEvent &aEvent) override
	Handle a window activation event. More...
void	handleIconizeEvent (wxIconizeEvent &aEvent) override
	Handle a window iconize event. More...
bool	saveSymbolLibTables (bool aGlobal, bool aProject)
	Save Symbol Library Tables to disk. More...
void	unitsChangeRefresh () override
	Called when when the units setting has changed to allow for any derived classes to handle refreshing and controls that have units based measurements in them. More...
void	setupUnits (APP_SETTINGS_BASE *aCfg)
std::vector< wxWindow * >	findDialogs ()
void	resolveCanvasType ()
	Determines the Canvas type to load (with prompt if required) and initializes m_canvasType. More...
EDA_DRAW_PANEL_GAL::GAL_TYPE	loadCanvasTypeSetting ()
	Returns the canvas type stored in the application settings. More...
bool	saveCanvasTypeSetting (EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvasType)
	Stores the canvas type in the application settings. More...
void	onActivate (wxActivateEvent &aEvent)
void	kiway_express (KIWAY_EXPRESS &aEvent)
	event handler, routes to derivative specific virtual KiwayMailIn() More...
void	language_change (wxCommandEvent &event)
	An event handler called on a language menu selection. More...
void	onAutoSaveTimer (wxTimerEvent &aEvent)
	Handle the auto save timer event. More...
void	onIconize (wxIconizeEvent &aEvent)
void	onSystemColorChange (wxSysColourChangedEvent &aEvent)
void	initExitKey ()
	Sets the common key-pair for exiting the application (Ctrl-Q) and ties it to the wxID_EXIT event id. More...
void	ensureWindowIsOnScreen ()
virtual void	OnDropFiles (wxDropFilesEvent &aEvent)
	Handles event fired when a file is dropped to the window. More...
virtual void	DoWithAcceptedFiles ()
	Execute action on accepted dropped file. More...

Static Protected Member Functions
static wxString	GetAutoSaveFilePrefix ()

Protected Attributes
SCHEMATIC_SETTINGS	m_base_frame_defaults
	These are only used by symbol_editor. More...
wxSocketServer *	m_socketServer
std::vector< wxSocketBase * >	m_sockets
	interprocess communication More...
std::unique_ptr< wxSingleInstanceChecker >	m_file_checker
COLOR4D	m_gridColor
COLOR4D	m_drawBgColor
int	m_undoRedoCountMax
bool	m_polarCoords
bool	m_showBorderAndTitleBlock
long	m_firstRunDialogSetting
wxChoice *	m_gridSelectBox
wxChoice *	m_zoomSelectBox
ACTION_TOOLBAR *	m_mainToolBar
ACTION_TOOLBAR *	m_auxiliaryToolBar
ACTION_TOOLBAR *	m_drawToolBar
ACTION_TOOLBAR *	m_optionsToolBar
std::unique_ptr< EDA_SEARCH_DATA >	m_findReplaceData
wxArrayString	m_findStringHistoryList
wxArrayString	m_replaceStringHistoryList
EDA_MSG_PANEL *	m_messagePanel
int	m_msgFrameHeight
COLOR_SETTINGS *	m_colorSettings
SEARCH_PANE *	m_searchPane
	The current canvas type. More...
EDA_DRAW_PANEL_GAL::GAL_TYPE	m_canvasType
bool	m_modal
WX_EVENT_LOOP *	m_modal_loop
	< Points to nested event_loop. NULL means not modal and dismissed. More...
wxWindow *	m_modal_resultant_parent
wxString	m_modal_string
bool	m_modal_ret_val
std::vector< wxFileName >	m_AcceptedFiles
FRAME_T	m_ident
wxPoint	m_framePos
wxSize	m_frameSize
bool	m_maximizeByDefault
int	m_displayIndex
wxPoint	m_normalFramePos
wxSize	m_normalFrameSize
wxString	m_aboutTitle
wxAuiManager	m_auimgr
wxString	m_perspective
WX_INFOBAR *	m_infoBar
wxString	m_configName
SETTINGS_MANAGER *	m_settingsManager
FILE_HISTORY *	m_fileHistory
bool	m_supportsAutoSave
bool	m_autoSaveState
wxTimer *	m_autoSaveTimer
UNDO_REDO_CONTAINER	m_undoList
UNDO_REDO_CONTAINER	m_redoList
wxString	m_mruPath
ORIGIN_TRANSFORMS	m_originTransforms
std::map< int, UIUpdateHandler >	m_uiUpdateMap
	< Map containing the UI update handlers registered with wx for each action. More...
bool	m_isClosing
	Set by NonUserClose() to indicate that the user did not request the current close. More...
bool	m_isNonUserClose
std::map< const wxString, TOOL_ACTION * >	m_acceptedExts
	Associates files extensions with action to execute. More...
TOOL_MANAGER *	m_toolManager
ACTIONS *	m_actions
TOOL_DISPATCHER *	m_toolDispatcher
SELECTION	m_dummySelection
std::vector< std::string >	m_toolStack
bool	m_immediateActions
MOUSE_DRAG_ACTION	m_dragAction
bool	m_moveWarpsCursor

Static Protected Attributes
static constexpr int	KICAD_AUI_TB_STYLE = wxAUI_TB_DEFAULT_STYLE | wxAUI_TB_PLAIN_BACKGROUND
	< Default style flags used for wxAUI toolbars. More...

Private Member Functions
void	OnResizeHierarchyNavigator (wxSizeEvent &aEvent)
void	setupTools ()
void	OnExit (wxCommandEvent &event)
void	OnLoadFile (wxCommandEvent &event)
void	OnAppendProject (wxCommandEvent &event)
void	OnImportProject (wxCommandEvent &event)
void	OnClearFileHistory (wxCommandEvent &aEvent)
bool	canCloseWindow (wxCloseEvent &aCloseEvent) override
void	doCloseWindow () override
void	UpdateTitle ()
	Set the main window title bar text. More...
void	initScreenZoom ()
	Initialize the zoom value of the current screen and mark the screen as zoom-initialized. More...
bool	checkForNoFullyDefinedLibIds (SCH_SHEET *aSheet)
	Verify that the symbol library links aSheet and all of its child sheets have been remapped to the symbol library table. More...
bool	importFile (const wxString &aFileName, int aFileType)
	Load the given filename but sets the path to the current project path. More...
bool	saveSchematicFile (SCH_SHEET *aSheet, const wxString &aSavePath)
	Save aSheet to a schematic file. More...
void	mapExistingAnnotation (std::map< wxString, wxString > &aMap)
	Fill a map of uuid -> reference from the currently loaded schematic. More...
bool	updateAutoSaveFile ()
const wxString &	getAutoSaveFileName () const
void	windowClosing (wxCloseEvent &event)
	(with its unexpected name so it does not collide with the real OnWindowClose() function provided in derived classes) is called just before a window closing, and is used to call a derivation specific SaveSettings(). More...
void	commonInit (FRAME_T aFrameType)
	Collect common initialization functions used in all CTORs. More...
wxWindow *	findQuasiModalDialog ()

Private Attributes
SCHEMATIC *	m_schematic
	The currently loaded schematic. More...
const SCH_CONNECTION *	m_highlightedConn
	The highlighted net or bus, or nullptr. More...
wxPageSetupDialogData	m_pageSetupData
std::vector< std::unique_ptr< SCH_ITEM > >	m_items_to_repeat
	For the repeat-last-item cmd. More...
wxString	m_netListerCommand
	Command line to call a custom net list generator. More...
int	m_exec_flags
	Flags of the wxExecute() function to call a custom net list generator. More...
DIALOG_SCH_FIND *	m_findReplaceDialog
HIERARCHY_NAVIG_PANEL *	m_hierarchy
bool	m_syncingPcbToSchSelection
BASE_SCREEN *	m_currentScreen
	current used SCREEN More...
EDA_DRAW_PANEL_GAL *	m_canvas
	This the frame's interface to setting GAL display options. More...
KIGFX::GAL_DISPLAY_OPTIONS	m_galDisplayOptions
KIWAY *	m_kiway
HOLDER_TYPE	m_type
const EDA_IU_SCALE &	m_iuScale
EDA_UNITS	m_userUnits

Friends
class	SCH_EDITOR_CONTROL

Detailed Description

Schematic editor (Eeschema) main window.

Definition at line 97 of file sch_edit_frame.h.

Member Enumeration Documentation

HOLDER_TYPE

enum KIWAY_HOLDER::HOLDER_TYPE

inherited

Enumerator
DIALOG
FRAME
PANEL

Definition at line 39 of file kiway_holder.h.

{ DIALOG, FRAME, PANEL };

UNDO_REDO_LIST

enum EDA_BASE_FRAME::UNDO_REDO_LIST

inherited

Specifies whether we are interacting with the undo or redo stacks.

Enumerator
UNDO_LIST
REDO_LIST

Definition at line 111 of file eda_base_frame.h.

 {
 UNDO_LIST,
 REDO_LIST
 };

Constructor & Destructor Documentation

SCH_EDIT_FRAME()

SCH_EDIT_FRAME::SCH_EDIT_FRAME	(	KIWAY *	aKiway,
		wxWindow *	aParent
	)

Definition at line 115 of file sch_edit_frame.cpp.

 :
 SCH_BASE_FRAME( aKiway, aParent, FRAME_SCH, wxT( "Eeschema" ), wxDefaultPosition,
 wxDefaultSize, KICAD_DEFAULT_DRAWFRAME_STYLE, SCH_EDIT_FRAME_NAME ),
 m_highlightedConn( nullptr )
{
 m_maximizeByDefault = true;
 m_schematic = new SCHEMATIC( nullptr );
 
 m_showBorderAndTitleBlock = true; // true to show sheet references
 m_supportsAutoSave = true;
 m_syncingPcbToSchSelection = false;
 m_aboutTitle = _( "KiCad Schematic Editor" );
 
 m_findReplaceDialog = nullptr;
 
 m_findReplaceData = std::make_unique<SCH_SEARCH_DATA>();
 
 // Give an icon
 wxIcon icon;
 wxIconBundle icon_bundle;
 
 icon.CopyFromBitmap( KiBitmap( BITMAPS::icon_eeschema ) );
 icon_bundle.AddIcon( icon );
 icon.CopyFromBitmap( KiBitmap( BITMAPS::icon_eeschema_32 ) );
 icon_bundle.AddIcon( icon );
 icon.CopyFromBitmap( KiBitmap( BITMAPS::icon_eeschema_16 ) );
 icon_bundle.AddIcon( icon );
 
 SetIcons( icon_bundle );
 
 LoadSettings( eeconfig() );
 
 // NB: also links the schematic to the loaded project
 CreateScreens();
 
 setupTools();
 setupUIConditions();
 ReCreateMenuBar();
 ReCreateHToolbar();
 ReCreateVToolbar();
 ReCreateOptToolbar();
 
 m_hierarchy = new HIERARCHY_NAVIG_PANEL( this );
 
 // Initialize common print setup dialog settings.
 m_pageSetupData.GetPrintData().SetPrintMode( wxPRINT_MODE_PRINTER );
 m_pageSetupData.GetPrintData().SetQuality( wxPRINT_QUALITY_MEDIUM );
 m_pageSetupData.GetPrintData().SetBin( wxPRINTBIN_AUTO );
 m_pageSetupData.GetPrintData().SetNoCopies( 1 );
 
 m_auimgr.SetManagedWindow( this );
 
 CreateInfoBar();
 
 // Rows; layers 4 - 6
 m_auimgr.AddPane( m_mainToolBar, EDA_PANE().HToolbar().Name( "MainToolbar" )
 .Top().Layer( 6 ) );
 
 m_auimgr.AddPane( m_messagePanel, EDA_PANE().Messages().Name( "MsgPanel" )
 .Bottom().Layer( 6 ) );
 
 // Columns; layers 1 - 3
 m_auimgr.AddPane( m_hierarchy, EDA_PANE().Palette().Name( SchematicHierarchyPaneName() )
 .Caption( _( "Schematic Hierarchy" ) )
 .Left().Layer( 3 )
 .TopDockable( false )
 .BottomDockable( false )
 .CloseButton( true )
 .MinSize( 120, 60 )
 .BestSize( 200, 200 )
 .FloatingSize( 200, 200 )
 .Show( false ) );
 m_auimgr.AddPane( m_optionsToolBar, EDA_PANE().VToolbar().Name( "OptToolbar" )
 .Left().Layer( 2 ) );
 
 m_auimgr.AddPane( m_drawToolBar, EDA_PANE().VToolbar().Name( "ToolsToolbar" )
 .Right().Layer( 2 ) );
 
 // Center
 m_auimgr.AddPane( GetCanvas(), EDA_PANE().Canvas().Name( "DrawFrame" )
 .Center() );
 
 FinishAUIInitialization();
 
 resolveCanvasType();
 SwitchCanvas( m_canvasType );
 
 GetCanvas()->GetGAL()->SetAxesEnabled( false );
 
 KIGFX::SCH_VIEW* view = GetCanvas()->GetView();
 static_cast<KIGFX::SCH_PAINTER*>( view->GetPainter() )->SetSchematic( m_schematic );
 
 wxAuiPaneInfo& hierarchy_pane = m_auimgr.GetPane( SchematicHierarchyPaneName() );
 EESCHEMA_SETTINGS* cfg = eeconfig();
 
 hierarchy_pane.Show( cfg->m_AuiPanels.show_schematic_hierarchy );
 
 if( cfg->m_AuiPanels.hierarchy_panel_float_width > 0
 && cfg->m_AuiPanels.hierarchy_panel_float_height > 0 )
 {
 // Show at end, after positioning
 hierarchy_pane.FloatingSize( cfg->m_AuiPanels.hierarchy_panel_float_width,
 cfg->m_AuiPanels.hierarchy_panel_float_height );
 }
 
 if( cfg->m_AuiPanels.schematic_hierarchy_float )
 hierarchy_pane.Float();
 
 if( cfg->m_AuiPanels.hierarchy_panel_docked_width > 0 )
 {
 SetAuiPaneSize( m_auimgr, hierarchy_pane,
 cfg->m_AuiPanels.hierarchy_panel_docked_width, -1 );
 
 // wxAUI hack: force width by setting MinSize() and then Fixed()
 // thanks to ZenJu http://trac.wxwidgets.org/ticket/13180
 hierarchy_pane.MinSize( cfg->m_AuiPanels.hierarchy_panel_docked_width, -1 );
 hierarchy_pane.Fixed();
 m_auimgr.Update();
 
 // now make it resizable again
 hierarchy_pane.Resizable();
 m_auimgr.Update();
 
 // Note: DO NOT call m_auimgr.Update() anywhere after this; it will nuke the size
 // back to minimum.
 hierarchy_pane.MinSize( 120, 60 );
 }
 else
 {
 m_auimgr.Update();
 }
 
 LoadProjectSettings();
 
 initScreenZoom();
 
 m_hierarchy->Connect( wxEVT_SIZE,
 wxSizeEventHandler( SCH_EDIT_FRAME::OnResizeHierarchyNavigator ),
 NULL, this );
 
 
 // This is used temporarily to fix a client size issue on GTK that causes zoom to fit
 // to calculate the wrong zoom size. See SCH_EDIT_FRAME::onSize().
 Bind( wxEVT_SIZE, &SCH_EDIT_FRAME::onSize, this );
 
 setupUnits( eeconfig() );
 
 // Net list generator
 DefaultExecFlags();
 
 UpdateTitle();
 m_toolManager->GetTool<SCH_NAVIGATE_TOOL>()->ResetHistory();
 
 // Default shutdown reason until a file is loaded
 KIPLATFORM::APP::SetShutdownBlockReason( this, _( "New schematic file is unsaved" ) );
 
 // Init for dropping files
 m_acceptedExts.emplace( KiCadSchematicFileExtension, &EE_ACTIONS::ddAppendFile );
 DragAcceptFiles( true );
 
 // Ensure the window is on top
 Raise();
 
 // Now that all sizes are fixed, set the initial hierarchy_pane floating position to the
 // top-left corner of the canvas
 wxPoint canvas_pos = GetCanvas()->GetScreenPosition();
 hierarchy_pane.FloatingPosition( canvas_pos.x + 10, canvas_pos.y + 10 );
}

References _, PCAD2KICAD::Center, EE_ACTIONS::ddAppendFile, KIGFX::eeconfig(), KIGFX::VIEW::GetPainter(), EESCHEMA_SETTINGS::AUI_PANELS::hierarchy_panel_docked_width, EESCHEMA_SETTINGS::AUI_PANELS::hierarchy_panel_float_height, EESCHEMA_SETTINGS::AUI_PANELS::hierarchy_panel_float_width, icon_eeschema, icon_eeschema_16, icon_eeschema_32, KiBitmap(), KiCadSchematicFileExtension, PCAD2KICAD::Left, EESCHEMA_SETTINGS::m_AuiPanels, OnResizeHierarchyNavigator(), onSize(), PCAD2KICAD::Right, EESCHEMA_SETTINGS::AUI_PANELS::schematic_hierarchy_float, SetAuiPaneSize(), KIPLATFORM::APP::SetShutdownBlockReason(), and EESCHEMA_SETTINGS::AUI_PANELS::show_schematic_hierarchy.

~SCH_EDIT_FRAME()

SCH_EDIT_FRAME::~SCH_EDIT_FRAME ( )

override

Definition at line 285 of file sch_edit_frame.cpp.

{
 m_hierarchy->Disconnect( wxEVT_SIZE,
 wxSizeEventHandler( SCH_EDIT_FRAME::OnResizeHierarchyNavigator ),
 NULL, this );
 // Ensure m_canvasType is up to date, to save it in config
 m_canvasType = GetCanvas()->GetBackend();
 
 // Close modeless dialogs
 wxWindow* open_dlg = wxWindow::FindWindowByName( DIALOG_ERC_WINDOW_NAME );
 
 if( open_dlg )
 open_dlg->Close( true );
 
 // Shutdown all running tools
 if( m_toolManager )
 {
 m_toolManager->ShutdownAllTools();
 delete m_toolManager;
 m_toolManager = nullptr;
 }
 
 SetScreen( nullptr );
 
 delete m_schematic;
 m_schematic = nullptr;
 
 // Close the project if we are standalone, so it gets cleaned up properly
 if( Kiface().IsSingle() )
 {
 try
 {
 GetSettingsManager()->UnloadProject( &Prj(), false );
 }
 catch( const nlohmann::detail::type_error& exc )
 {
 // This may be overkill and could be an assertion but we are more likely to
 // find any settings manager errors this way.
 wxLogError( wxT( "Settings exception '%s' occurred." ), exc.what() );
 }
 }
 
 delete m_hierarchy;
}

References DIALOG_ERC_WINDOW_NAME, EDA_DRAW_PANEL_GAL::GetBackend(), SCH_BASE_FRAME::GetCanvas(), EDA_BASE_FRAME::GetSettingsManager(), Kiface(), EDA_DRAW_FRAME::m_canvasType, m_hierarchy, m_schematic, TOOLS_HOLDER::m_toolManager, OnResizeHierarchyNavigator(), KIWAY_HOLDER::Prj(), SetScreen(), TOOL_MANAGER::ShutdownAllTools(), and SETTINGS_MANAGER::UnloadProject().

Member Function Documentation

ActivateGalCanvas()

void SCH_BASE_FRAME::ActivateGalCanvas ( )

overridevirtualinherited

Use to start up the GAL drawing canvas.

Reimplemented from EDA_DRAW_FRAME.

Definition at line 348 of file sch_base_frame.cpp.

{
 EDA_DRAW_FRAME::ActivateGalCanvas();
 
#if defined( KICAD_USE_3DCONNEXION )
 try
 {
 if( !m_spaceMouse )
 {
 m_spaceMouse = new NL_SCHEMATIC_PLUGIN();
 }
 
 m_spaceMouse->SetCanvas( GetCanvas() );
 }
 catch( const std::system_error& e )
 {
 wxLogTrace( wxT( "KI_TRACE_NAVLIB" ), e.what() );
 }
#endif
}

References EDA_DRAW_FRAME::ActivateGalCanvas(), and SCH_BASE_FRAME::GetCanvas().

Referenced by SCH_BASE_FRAME::createCanvas(), and SCH_DRAW_PANEL::OnShow().

AddCopyForRepeatItem()

void SCH_EDIT_FRAME::AddCopyForRepeatItem

(

const SCH_ITEM *

aItem

)

Definition at line 604 of file sch_edit_frame.cpp.

{
 // we cannot store a pointer to an item in the display list here since
 // that item may be deleted, such as part of a line concatenation or other.
 // So simply always keep a copy of the object which is to be repeated.
 
 if( aItem )
 {
 std::unique_ptr<SCH_ITEM> repeatItem( static_cast<SCH_ITEM*>( aItem->Clone() ) );
 
 // Clone() preserves the flags, we want 'em cleared.
 repeatItem->ClearFlags();
 
 m_items_to_repeat.emplace_back( std::move( repeatItem ) );
 }
}

References EDA_ITEM::Clone(), and m_items_to_repeat.

Referenced by SCH_LINE_WIRE_BUS_TOOL::finishSegments(), SCH_EDIT_TOOL::RepeatDrawItem(), and SaveCopyForRepeatItem().

AddItemToScreenAndUndoList()

void SCH_EDIT_FRAME::AddItemToScreenAndUndoList	(	SCH_SCREEN *	aScreen,
		SCH_ITEM *	aItem,
		bool	aUndoAppend
	)

Add an item to the schematic and adds the changes to the undo/redo container.

Parameters

aUndoAppend

True if the action should be appended to the current undo record.

Definition at line 1324 of file sch_edit_frame.cpp.

{
 wxCHECK_RET( aItem != nullptr, wxT( "Cannot add null item to list." ) );
 
 SCH_SHEET* parentSheet = nullptr;
 SCH_SYMBOL* parentSymbol = nullptr;
 SCH_ITEM* undoItem = aItem;
 
 if( aItem->Type() == SCH_SHEET_PIN_T )
 {
 parentSheet = (SCH_SHEET*) aItem->GetParent();
 
 wxCHECK_RET( parentSheet && parentSheet->Type() == SCH_SHEET_T,
 wxT( "Cannot place sheet pin in invalid schematic sheet." ) );
 
 undoItem = parentSheet;
 }
 
 else if( aItem->Type() == SCH_FIELD_T )
 {
 parentSymbol = (SCH_SYMBOL*) aItem->GetParent();
 
 wxCHECK_RET( parentSymbol && parentSymbol->Type() == SCH_SYMBOL_T,
 wxT( "Cannot place field in invalid schematic symbol." ) );
 
 undoItem = parentSymbol;
 }
 
 if( aItem->IsNew() )
 {
 if( aItem->Type() == SCH_SHEET_PIN_T )
 {
 // Sheet pins are owned by their parent sheet.
 SaveCopyInUndoList( aScreen, undoItem, UNDO_REDO::CHANGED, aUndoAppend );
 
 parentSheet->AddPin( (SCH_SHEET_PIN*) aItem );
 }
 else if( aItem->Type() == SCH_FIELD_T )
 {
 // Symbol fields are also owned by their parent, but new symbol fields are
 // handled elsewhere.
 wxLogMessage( wxT( "addCurrentItemToScreen: unexpected new SCH_FIELD" ) );
 }
 else
 {
 if( !aScreen->CheckIfOnDrawList( aItem ) ) // don't want a loop!
 AddToScreen( aItem, aScreen );
 
 SaveCopyForRepeatItem( aItem );
 SaveCopyInUndoList( aScreen, undoItem, UNDO_REDO::NEWITEM, aUndoAppend );
 }
 
 // Update connectivity info for new item
 if( !aItem->IsMoving() )
 RecalculateConnections( LOCAL_CLEANUP );
 }
 
 aItem->ClearFlags( IS_NEW );
 
 aScreen->SetContentModified();
 UpdateItem( aItem );
 
 if( !aItem->IsMoving() && aItem->IsConnectable() )
 {
 std::vector<VECTOR2I> pts = aItem->GetConnectionPoints();
 
 bool connected = true;
 for( auto i = pts.begin(); i != pts.end(); i++ )
 {
 for( auto j = i + 1; j != pts.end(); j++ )
 TrimWire( *i, *j );
 
 if( aScreen->IsExplicitJunctionNeeded( *i ) )
 {
 AddJunction( aScreen, *i, true, false );
 connected = true;
 }
 }
 
 if( connected )
 {
 AutoRotateItem( aScreen, aItem );
 }
 
 TestDanglingEnds();
 
 for( SCH_ITEM* item : aItem->ConnectedItems( GetCurrentSheet() ) )
 UpdateItem( item );
 }
 
 aItem->ClearEditFlags();
 GetCanvas()->Refresh();
}

References AddJunction(), SCH_SHEET::AddPin(), SCH_BASE_FRAME::AddToScreen(), AutoRotateItem(), CHANGED, SCH_SCREEN::CheckIfOnDrawList(), EDA_ITEM::ClearEditFlags(), EDA_ITEM::ClearFlags(), SCH_ITEM::ConnectedItems(), SCH_BASE_FRAME::GetCanvas(), SCH_ITEM::GetConnectionPoints(), GetCurrentSheet(), EDA_ITEM::GetParent(), IS_NEW, SCH_ITEM::IsConnectable(), SCH_SCREEN::IsExplicitJunctionNeeded(), EDA_ITEM::IsMoving(), EDA_ITEM::IsNew(), LOCAL_CLEANUP, NEWITEM, RecalculateConnections(), EDA_DRAW_PANEL_GAL::Refresh(), SaveCopyForRepeatItem(), SaveCopyInUndoList(), SCH_FIELD_T, SCH_SHEET_PIN_T, SCH_SHEET_T, SCH_SYMBOL_T, BASE_SCREEN::SetContentModified(), TestDanglingEnds(), TrimWire(), EDA_ITEM::Type(), and UpdateItem().

Referenced by SCH_DRAWING_TOOLS::DrawShape(), SCH_DRAWING_TOOLS::DrawSheet(), SCH_EDITOR_CONTROL::Paste(), SCH_DRAWING_TOOLS::PlaceImage(), SCH_DRAWING_TOOLS::PlaceSymbol(), BACK_ANNOTATE::processNetNameChange(), SCH_DRAWING_TOOLS::SingleClickPlace(), and SCH_DRAWING_TOOLS::TwoClickPlace().

AddJunction()

SCH_JUNCTION * SCH_EDIT_FRAME::AddJunction	(	SCH_SCREEN *	aScreen,
		const VECTOR2I &	aPos,
		bool	aAppendToUndo,
		bool	aFinal = true
	)

Definition at line 454 of file bus-wire-junction.cpp.

{
 SCH_JUNCTION* junction = new SCH_JUNCTION( aPos );
 
 AddToScreen( junction, aScreen );
 SaveCopyInUndoList( aScreen, junction, UNDO_REDO::NEWITEM, aUndoAppend );
 BreakSegments( aPos );
 
 if( aFinal )
 {
 m_toolManager->PostEvent( EVENTS::SelectedItemsModified );
 
 TestDanglingEnds();
 OnModify();
 
 KIGFX::SCH_VIEW* view = GetCanvas()->GetView();
 view->ClearPreview();
 view->ShowPreview( false );
 view->ClearHiddenFlags();
 }
 
 return junction;
}

References SCH_BASE_FRAME::AddToScreen(), BreakSegments(), KIGFX::SCH_VIEW::ClearHiddenFlags(), KIGFX::VIEW::ClearPreview(), SCH_BASE_FRAME::GetCanvas(), SCH_DRAW_PANEL::GetView(), TOOLS_HOLDER::m_toolManager, NEWITEM, OnModify(), TOOL_MANAGER::PostEvent(), SaveCopyInUndoList(), EVENTS::SelectedItemsModified, KIGFX::VIEW::ShowPreview(), and TestDanglingEnds().

Referenced by AddItemToScreenAndUndoList(), SCH_LINE_WIRE_BUS_TOOL::AddJunctionsIfNeeded(), SCH_LINE_WIRE_BUS_TOOL::finishSegments(), and SCH_MOVE_TOOL::Main().

AddSheetAndUpdateDisplay()

bool SCH_EDIT_FRAME::AddSheetAndUpdateDisplay

(

const wxString

aFullFileName

)

Add a sheet file into the current sheet and updates display.

Note

Used in AppendSchematic() and SCH_EDIT_TOOL::ddAppendFile() (so it is public)

Parameters

aFullFileName

Path and name of sheet

Returns

True if the sheet was properly added

Definition at line 548 of file eeschema/files-io.cpp.

{
 if( !LoadSheetFromFile( GetCurrentSheet().Last(), &GetCurrentSheet(), aFullFileName ) )
 return false;
 
 initScreenZoom();
 SetSheetNumberAndCount();
 
 SyncView();
 OnModify();
 HardRedraw(); // Full reinit of the current screen and the display.
 
 UpdateHierarchyNavigator();
 
 return true;
}

References GetCurrentSheet(), HardRedraw(), initScreenZoom(), LoadSheetFromFile(), OnModify(), SetSheetNumberAndCount(), SCH_BASE_FRAME::SyncView(), and UpdateHierarchyNavigator().

Referenced by AppendSchematic(), and SCH_EDIT_TOOL::DdAppendFile().

AddStandardHelpMenu()

void EDA_BASE_FRAME::AddStandardHelpMenu ( wxMenuBar *  aMenuBar )

inherited

Adds the standard KiCad help menu to the menubar.

Definition at line 443 of file eda_base_frame.cpp.

{
 COMMON_CONTROL* commonControl = m_toolManager->GetTool<COMMON_CONTROL>();
 ACTION_MENU* helpMenu = new ACTION_MENU( false, commonControl );
 
 helpMenu->Add( ACTIONS::help );
 helpMenu->Add( ACTIONS::gettingStarted );
 helpMenu->Add( ACTIONS::listHotKeys );
 helpMenu->Add( ACTIONS::getInvolved );
 helpMenu->Add( ACTIONS::donate );
 helpMenu->Add( ACTIONS::reportBug );
 
 helpMenu->AppendSeparator();
 helpMenu->Add( _( "&About KiCad" ), "", wxID_ABOUT, BITMAPS::about );
 
 // Trailing space keeps OSX from hijacking our menu (and disabling everything in it).
 aMenuBar->Append( helpMenu, _( "&Help" ) + wxS( " " ) );
}

References _, about, ACTIONS::donate, ACTIONS::getInvolved, ACTIONS::gettingStarted, TOOL_MANAGER::GetTool(), ACTIONS::help, ACTIONS::listHotKeys, TOOLS_HOLDER::m_toolManager, and ACTIONS::reportBug.

Referenced by EDA_3D_VIEWER_FRAME::CreateMenuBar(), CVPCB_MAINFRAME::ReCreateMenuBar(), ReCreateMenuBar(), SYMBOL_EDIT_FRAME::ReCreateMenuBar(), SYMBOL_VIEWER_FRAME::ReCreateMenuBar(), GERBVIEW_FRAME::ReCreateMenuBar(), KICAD_MANAGER_FRAME::ReCreateMenuBar(), PL_EDITOR_FRAME::ReCreateMenuBar(), FOOTPRINT_EDIT_FRAME::ReCreateMenuBar(), FOOTPRINT_VIEWER_FRAME::ReCreateMenuBar(), and PCB_EDIT_FRAME::ReCreateMenuBar().

AddStandardSubMenus()

void EDA_DRAW_FRAME::AddStandardSubMenus ( TOOL_MENU &  aMenu )

inherited

Construct a "basic" menu for a tool, containing only items that apply to all tools (e.g.

zoom and grid).

Definition at line 546 of file eda_draw_frame.cpp.

{
 COMMON_TOOLS* commonTools = m_toolManager->GetTool<COMMON_TOOLS>();
 CONDITIONAL_MENU& aMenu = aToolMenu.GetMenu();
 
 aMenu.AddSeparator( 1000 );
 
 std::shared_ptr<ZOOM_MENU> zoomMenu = std::make_shared<ZOOM_MENU>( this );
 zoomMenu->SetTool( commonTools );
 aToolMenu.RegisterSubMenu( zoomMenu );
 
 std::shared_ptr<GRID_MENU> gridMenu = std::make_shared<GRID_MENU>( this );
 gridMenu->SetTool( commonTools );
 aToolMenu.RegisterSubMenu( gridMenu );
 
 aMenu.AddMenu( zoomMenu.get(), SELECTION_CONDITIONS::ShowAlways, 1000 );
 aMenu.AddMenu( gridMenu.get(), SELECTION_CONDITIONS::ShowAlways, 1000 );
}

References CONDITIONAL_MENU::AddSeparator(), TOOL_MENU::GetMenu(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::m_toolManager, TOOL_MENU::RegisterSubMenu(), and SELECTION_CONDITIONS::ShowAlways().

Referenced by EE_SELECTION_TOOL::Init(), PICKER_TOOL::Init(), PL_DRAWING_TOOLS::Init(), PL_EDIT_TOOL::Init(), PL_SELECTION_TOOL::Init(), ROUTER_TOOL::Init(), PCB_SELECTION_TOOL::Init(), and PCB_VIEWER_TOOLS::Init().

AddToScreen()

void SCH_BASE_FRAME::AddToScreen ( EDA_ITEM *  aItem, SCH_SCREEN *  aScreen  )

inherited

Add an item to the screen (and view) aScreen is the screen the item is located on, if not the current screen.

Definition at line 440 of file sch_base_frame.cpp.

{
 // Null pointers will cause boost::ptr_vector to raise a boost::bad_pointer exception which
 // will be unhandled. There is no valid reason to pass an invalid EDA_ITEM pointer to the
 // screen append function.
 wxCHECK( aItem != nullptr, /* voide */ );
 
 auto screen = aScreen;
 
 if( aScreen == nullptr )
 screen = GetScreen();
 
 screen->Append( (SCH_ITEM*) aItem );
 
 if( screen == GetScreen() )
 {
 GetCanvas()->GetView()->Add( aItem );
 UpdateItem( aItem, true ); // handle any additional parent semantics
 }
}

References KIGFX::VIEW::Add(), SCH_BASE_FRAME::GetCanvas(), SCH_BASE_FRAME::GetScreen(), SCH_DRAW_PANEL::GetView(), and SCH_BASE_FRAME::UpdateItem().

Referenced by AddItemToScreenAndUndoList(), AddJunction(), BreakSegment(), SCH_EDIT_TOOL::ChangeTextType(), SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), SCH_LINE_WIRE_BUS_TOOL::doUnfoldBus(), SCH_LINE_WIRE_BUS_TOOL::finishSegments(), SCH_MOVE_TOOL::getConnectedDragItems(), SCH_MOVE_TOOL::Main(), PutDataInPreviousState(), and SCH_EDIT_TOOL::RepeatDrawItem().

AllowCaseSensitiveFileNameClashes()

bool SCH_EDIT_FRAME::AllowCaseSensitiveFileNameClashes

(

const wxString &

aSchematicFileName

)

Check aSchematicFileName for a potential file name case sensitivity clashes.

On platforms where file names are case sensitive, it is possible to schematic sheet file names that would cause issues on platforms where file name are case insensitive. File names foo.sch and Foo.sch are unique files on Linux and MacOS but on Windows this would result in a broken schematic.

Parameters

aSchematicFileName

is the absolute path and file name of the file to test.

Returns

true if the user accepts the potential file name clash risk.

Definition at line 553 of file sheet.cpp.

{
 wxString msg;
 SCH_SCREENS screens( Schematic().Root() );
 wxFileName fn = aSchematicFileName;
 
 wxCHECK( fn.IsAbsolute(), false );
 
 if( eeconfig()->m_Appearance.show_sheet_filename_case_sensitivity_dialog
 && screens.CanCauseCaseSensitivityIssue( aSchematicFileName ) )
 {
 msg.Printf( _( "The file name '%s' can cause issues with an existing file name\n"
 "already defined in the schematic on systems that support case\n"
 "insensitive file names. This will cause issues if you copy this\n"
 "project to an operating system that supports case insensitive file\n"
 "names.\n\nDo you wish to continue?" ),
 fn.GetName() );
 
 wxRichMessageDialog dlg( this, msg, _( "Warning" ),
 wxYES_NO | wxNO_DEFAULT | wxICON_QUESTION );
 dlg.ShowCheckBox( _( "Do not show this message again." ) );
 dlg.SetYesNoLabels( wxMessageDialog::ButtonLabel( _( "Create New Sheet" ) ),
 wxMessageDialog::ButtonLabel( _( "Discard New Sheet" ) ) );
 
 if( dlg.ShowModal() == wxID_NO )
 return false;
 
 eeconfig()->m_Appearance.show_sheet_filename_case_sensitivity_dialog =
 !dlg.IsCheckBoxChecked();
 }
 
 return true;
}

References _, SCH_SCREENS::CanCauseCaseSensitivityIssue(), SCH_BASE_FRAME::eeconfig(), EESCHEMA_SETTINGS::m_Appearance, Schematic(), and EESCHEMA_SETTINGS::APPEARANCE::show_sheet_filename_case_sensitivity_dialog.

Referenced by DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged().

AnnotateSymbols()

void SCH_EDIT_FRAME::AnnotateSymbols	(	ANNOTATE_SCOPE_T	aAnnotateScope,
		ANNOTATE_ORDER_T	aSortOption,
		ANNOTATE_ALGO_T	aAlgoOption,
		bool	aRecursive,
		int	aStartNumber,
		bool	aResetAnnotation,
		bool	aRepairTimestamps,
		REPORTER &	aReporter,
		bool	appendUndo = false
	)

Annotate the symbols in the schematic that are not currently annotated.

Multi-unit symbols are annotated together. E.g. if two symbols were R8A and R8B, they may become R3A and R3B, but not R3A and R3C or R3C and R4D.

Parameters

aAnnotateScope	See ANNOTATE_SCOPE_T
aSortOption	Define the annotation order. See ANNOTATE_ORDER_T.
aAlgoOption	Define the annotation style. See ANNOTATE_ALGO_T.
aRecursive	Annotation should descend into and annotate subsheets
aStartNumber	The start number for non-sheet-based annotation styles.
aResetAnnotation	Clear any previous annotation if true. Otherwise, keep the existing symbol annotation.
aRepairTimestamps	Test for and repair any duplicate time stamps if true. Otherwise, keep the existing time stamps. This option could change previous annotation because time stamps are used to handle annotation in complex hierarchies.
aReporter	A sink for error messages. Use NULL_REPORTER if you don't need errors.
appendUndo	True if the annotation operation should be added to an existing undo, false if it should be separately undo-able.

When the sheet number is used in annotation, each sheet annotation starts from sheet number * 100. In other words the first sheet uses 100 to 199, the second sheet uses 200 to 299, and so on.

Definition at line 194 of file annotate.cpp.

{
 EE_SELECTION_TOOL* selTool = m_toolManager->GetTool<EE_SELECTION_TOOL>();
 EE_SELECTION& selection = selTool->RequestSelection();
 
 SCH_REFERENCE_LIST references;
 SCH_SCREENS screens( Schematic().Root() );
 SCH_SHEET_LIST sheets = Schematic().GetSheets();
 SCH_SHEET_PATH currentSheet = GetCurrentSheet();
 
 
 // Store the selected sheets relative to the full hierarchy so we get the correct sheet numbers
 SCH_SHEET_LIST selectedSheets;
 
 for( EDA_ITEM* item : selection )
 {
 if( item->Type() == SCH_SHEET_T )
 {
 SCH_SHEET_PATH subSheetPath = currentSheet;
 subSheetPath.push_back( static_cast<SCH_SHEET*>( item ) );
 
 sheets.GetSheetsWithinPath( selectedSheets, subSheetPath );
 }
 }
 
 
 // Like above, store subsheets relative to full hierarchy for recursive annotation from current
 // sheet
 SCH_SHEET_LIST subSheets;
 
 std::vector<SCH_ITEM*> tempSubSheets;
 currentSheet.LastScreen()->GetSheets( &tempSubSheets );
 
 for( SCH_ITEM* item : tempSubSheets )
 {
 SCH_SHEET_PATH subSheetPath = currentSheet;
 subSheetPath.push_back( static_cast<SCH_SHEET*>( item ) );
 
 sheets.GetSheetsWithinPath( subSheets, subSheetPath );
 }
 
 
 std::unordered_set<SCH_SYMBOL*> selectedSymbols;
 
 if( aAnnotateScope == ANNOTATE_SELECTION )
 selectedSymbols = getInferredSymbols( selection );
 
 
 // Map of locked symbols
 SCH_MULTI_UNIT_REFERENCE_MAP lockedSymbols;
 
 // Map of previous annotation for building info messages
 std::map<wxString, wxString> previousAnnotation;
 
 // Test for and replace duplicate time stamps in symbols and sheets. Duplicate time stamps
 // can happen with old schematics, schematic conversions, or manual editing of files.
 if( aRepairTimestamps )
 {
 int count = screens.ReplaceDuplicateTimeStamps();
 
 if( count )
 {
 wxString msg;
 msg.Printf( _( "%d duplicate time stamps were found and replaced." ), count );
 aReporter.ReportTail( msg, RPT_SEVERITY_WARNING );
 }
 }
 
 // Collect all the sets that must be annotated together.
 switch( aAnnotateScope )
 {
 case ANNOTATE_ALL:
 sheets.GetMultiUnitSymbols( lockedSymbols );
 break;
 
 case ANNOTATE_CURRENT_SHEET:
 currentSheet.GetMultiUnitSymbols( lockedSymbols );
 break;
 
 case ANNOTATE_SELECTION:
 for( SCH_SYMBOL* symbol : selectedSymbols )
 currentSheet.AppendMultiUnitSymbol( lockedSymbols, symbol );
 
 break;
 }
 
 // Store previous annotations for building info messages
 mapExistingAnnotation( previousAnnotation );
 
 // Set sheet number and number of sheets.
 SetSheetNumberAndCount();
 
 // Build symbol list
 switch( aAnnotateScope )
 {
 case ANNOTATE_ALL:
 sheets.GetSymbols( references );
 break;
 
 case ANNOTATE_CURRENT_SHEET:
 currentSheet.GetSymbols( references );
 
 if( aRecursive )
 subSheets.GetSymbolsWithinPath( references, currentSheet, false, true );
 
 break;
 
 case ANNOTATE_SELECTION:
 for( SCH_SYMBOL* symbol : selectedSymbols )
 currentSheet.AppendSymbol( references, symbol, false, true );
 
 if( aRecursive )
 selectedSheets.GetSymbolsWithinPath( references, currentSheet, false, true );
 
 break;
 }
 
 // Remove annotation only updates the "new" flag to indicate to the algorithm
 // that these references must be reannotated, but keeps the original reference
 // so that we can reannotate multi-unit symbols together.
 if( aResetAnnotation )
 references.RemoveAnnotation( false );
 
 // Build additional list of references to be used during reannotation
 // to avoid duplicate designators (no additional references when annotating
 // the full schematic)
 SCH_REFERENCE_LIST additionalRefs;
 
 if( aAnnotateScope != ANNOTATE_ALL )
 {
 SCH_REFERENCE_LIST allRefs;
 sheets.GetSymbols( allRefs );
 
 for( size_t i = 0; i < allRefs.GetCount(); i++ )
 {
 if( !references.Contains( allRefs[i] ) )
 additionalRefs.AddItem( allRefs[i] );
 }
 }
 
 // Break full symbol reference into name (prefix) and number:
 // example: IC1 become IC, and 1
 references.SplitReferences();
 
 // Annotate all of the references we've collected by our options
 references.AnnotateByOptions( aSortOption, aAlgoOption, aStartNumber, lockedSymbols,
 additionalRefs, false );
 
 for( size_t i = 0; i < references.GetCount(); i++ )
 {
 SCH_REFERENCE& ref = references[i];
 SCH_SYMBOL* symbol = ref.GetSymbol();
 SCH_SHEET_PATH* sheet = &ref.GetSheetPath();
 
 SaveCopyInUndoList( sheet->LastScreen(), symbol, UNDO_REDO::CHANGED, appendUndo );
 appendUndo = true;
 ref.Annotate();
 
 KIID_PATH full_uuid = sheet->Path();
 full_uuid.push_back( symbol->m_Uuid );
 
 wxString prevRef = previousAnnotation[ full_uuid.AsString() ];
 wxString newRef = symbol->GetRef( sheet );
 
 if( symbol->GetUnitCount() > 1 )
 newRef << LIB_SYMBOL::SubReference( symbol->GetUnitSelection( sheet ) );
 
 wxString msg;
 
 if( prevRef.Length() )
 {
 if( newRef == prevRef )
 continue;
 
 if( symbol->GetUnitCount() > 1 )
 {
 msg.Printf( _( "Updated %s (unit %s) from %s to %s." ),
 symbol->GetValue( sheet, true ),
 LIB_SYMBOL::SubReference( symbol->GetUnit(), false ),
 prevRef,
 newRef );
 }
 else
 {
 msg.Printf( _( "Updated %s from %s to %s." ),
 symbol->GetValue( sheet, true ),
 prevRef,
 newRef );
 }
 }
 else
 {
 if( symbol->GetUnitCount() > 1 )
 {
 msg.Printf( _( "Annotated %s (unit %s) as %s." ),
 symbol->GetValue( sheet, true ),
 LIB_SYMBOL::SubReference( symbol->GetUnit(), false ),
 newRef );
 }
 else
 {
 msg.Printf( _( "Annotated %s as %s." ),
 symbol->GetValue( sheet, true ),
 newRef );
 }
 }
 
 aReporter.Report( msg, RPT_SEVERITY_ACTION );
 }
 
 // Final control (just in case ... ).
 if( !CheckAnnotate(
 [ &aReporter ]( ERCE_T , const wxString& aMsg, SCH_REFERENCE* , SCH_REFERENCE* )
 {
 aReporter.Report( aMsg, RPT_SEVERITY_ERROR );
 },
 aAnnotateScope, aRecursive ) )
 {
 aReporter.ReportTail( _( "Annotation complete." ), RPT_SEVERITY_ACTION );
 }
 
 // Update on screen references, that can be modified by previous calculations:
 GetCurrentSheet().UpdateAllScreenReferences();
 SetSheetNumberAndCount();
 
 wxWindow* erc_dlg = wxWindow::FindWindowByName( DIALOG_ERC_WINDOW_NAME );
 
 if( erc_dlg )
 static_cast<DIALOG_ERC*>( erc_dlg )->UpdateAnnotationWarning();
 
 SyncView();
 GetCanvas()->Refresh();
 OnModify();
 
 // Must go after OnModify() so the connectivity graph has been updated
 UpdateNetHighlightStatus();
}

References _, SCH_REFERENCE_LIST::AddItem(), SCH_REFERENCE::Annotate(), ANNOTATE_ALL, ANNOTATE_CURRENT_SHEET, ANNOTATE_SELECTION, SCH_REFERENCE_LIST::AnnotateByOptions(), SCH_SHEET_PATH::AppendMultiUnitSymbol(), SCH_SHEET_PATH::AppendSymbol(), KIID_PATH::AsString(), CHANGED, CheckAnnotate(), SCH_REFERENCE_LIST::Contains(), DIALOG_ERC_WINDOW_NAME, SCH_BASE_FRAME::GetCanvas(), SCH_REFERENCE_LIST::GetCount(), GetCurrentSheet(), getInferredSymbols(), SCH_SHEET_PATH::GetMultiUnitSymbols(), SCH_SHEET_LIST::GetMultiUnitSymbols(), SCH_SYMBOL::GetRef(), SCH_REFERENCE::GetSheetPath(), SCHEMATIC::GetSheets(), SCH_SCREEN::GetSheets(), SCH_SHEET_LIST::GetSheetsWithinPath(), SCH_REFERENCE::GetSymbol(), SCH_SHEET_PATH::GetSymbols(), SCH_SHEET_LIST::GetSymbols(), SCH_SHEET_LIST::GetSymbolsWithinPath(), TOOL_MANAGER::GetTool(), SCH_SYMBOL::GetUnit(), SCH_SYMBOL::GetUnitCount(), SCH_SYMBOL::GetUnitSelection(), SCH_SYMBOL::GetValue(), SCH_SHEET_PATH::LastScreen(), TOOLS_HOLDER::m_toolManager, EDA_ITEM::m_Uuid, mapExistingAnnotation(), OnModify(), SCH_SHEET_PATH::Path(), SCH_SHEET_PATH::push_back(), EDA_DRAW_PANEL_GAL::Refresh(), SCH_REFERENCE_LIST::RemoveAnnotation(), SCH_SCREENS::ReplaceDuplicateTimeStamps(), REPORTER::Report(), REPORTER::ReportTail(), EE_SELECTION_TOOL::RequestSelection(), RPT_SEVERITY_ACTION, RPT_SEVERITY_ERROR, RPT_SEVERITY_WARNING, SaveCopyInUndoList(), SCH_SHEET_T, Schematic(), SetSheetNumberAndCount(), SCH_REFERENCE_LIST::SplitReferences(), LIB_SYMBOL::SubReference(), SCH_BASE_FRAME::SyncView(), SCH_SHEET_PATH::UpdateAllScreenReferences(), and UpdateNetHighlightStatus().

Referenced by DIALOG_ANNOTATE::OnApplyClick(), and SCH_EDIT_TOOL::RepeatDrawItem().

AppendMsgPanel()

void EDA_DRAW_FRAME::AppendMsgPanel ( const wxString &  aTextUpper, const wxString &  aTextLower, int  aPadding = 6  )

inherited

Append a message to the message panel.

This helper method checks to make sure the message panel exists in the frame and appends a message to it using the message panel AppendMessage() method.

Parameters

aTextUpper	The message upper text.
aTextLower	The message lower text.
aPadding	Number of spaces to pad between messages.

Definition at line 708 of file eda_draw_frame.cpp.

{
 if( m_messagePanel )
 m_messagePanel->AppendMessage( aTextUpper, aTextLower, aPadding );
}

References EDA_MSG_PANEL::AppendMessage(), and EDA_DRAW_FRAME::m_messagePanel.

Referenced by GERBER_FILE_IMAGE::DisplayImageInfo(), SYMBOL_VIEWER_FRAME::updatePreviewSymbol(), and SYMBOL_EDIT_FRAME::UpdateSymbolMsgPanelInfo().

AppendSchematic()

bool SCH_EDIT_FRAME::AppendSchematic

(

)

Import a KiCad schematic into the current sheet.

Returns

True if the schematic was imported properly.

Definition at line 525 of file eeschema/files-io.cpp.

{
 SCH_SCREEN* screen = GetScreen();
 
 if( !screen )
 {
 wxLogError( wxT( "Document not ready, cannot import" ) );
 return false;
 }
 
 // open file chooser dialog
 wxString path = wxPathOnly( Prj().GetProjectFullName() );
 
 wxFileDialog dlg( this, _( "Insert Schematic" ), path, wxEmptyString,
 KiCadSchematicFileWildcard(), wxFD_OPEN | wxFD_FILE_MUST_EXIST );
 
 if( dlg.ShowModal() == wxID_CANCEL )
 return false;
 
 return AddSheetAndUpdateDisplay( dlg.GetPath() );
}

References _, AddSheetAndUpdateDisplay(), GetScreen(), KiCadSchematicFileWildcard(), path, and KIWAY_HOLDER::Prj().

Referenced by OnAppendProject().

AskToSaveChanges()

bool SCH_EDIT_FRAME::AskToSaveChanges

(

)

Check if any of the screens has unsaved changes and asks the user whether to save or drop them.

Returns

True if user decided to save or drop changes, false if the operation should be canceled.

Definition at line 1284 of file eeschema/files-io.cpp.

{
 SCH_SCREENS screenList( Schematic().Root() );
 
 // Save any currently open and modified project files.
 for( SCH_SCREEN* screen = screenList.GetFirst(); screen; screen = screenList.GetNext() )
 {
 SIM_PLOT_FRAME* simFrame = (SIM_PLOT_FRAME*) Kiway().Player( FRAME_SIMULATOR, false );
 
 // Simulator must be closed before loading another schematic, otherwise it may crash.
 // If there are any changes in the simulator the user will be prompted to save them.
 if( simFrame && !simFrame->Close() )
 return false;
 
 if( screen->IsContentModified() )
 {
 if( !HandleUnsavedChanges( this, _( "The current schematic has been modified. "
 "Save changes?" ),
 [&]() -> bool
 {
 return SaveProject();
 } ) )
 {
 return false;
 }
 }
  }
 
 return true;
}

References _, FRAME_SIMULATOR, SCH_SCREENS::GetFirst(), SCH_SCREENS::GetNext(), HandleUnsavedChanges(), KIWAY_HOLDER::Kiway(), KIWAY::Player(), SaveProject(), and Schematic().

Referenced by OnImportProject(), and OpenProjectFiles().

AutoRotateItem()

void SCH_EDIT_FRAME::AutoRotateItem	(	SCH_SCREEN *	aScreen,
		SCH_ITEM *	aItem
	)

Automatically set the rotation of an item (if the item supports it)

Definition at line 1298 of file sch_edit_frame.cpp.

{
 if( aItem->IsType( { SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T } ) )
 {
 auto label = static_cast<SCH_LABEL_BASE*>( aItem );
 if( label->AutoRotateOnPlacement() )
 {
 auto textSpin = aScreen->GetLabelOrientationForPoint(
 label->GetPosition(), label->GetTextSpinStyle(), &GetCurrentSheet() );
 if( textSpin != label->GetTextSpinStyle() )
 {
 label->SetTextSpinStyle( textSpin );
 for( SCH_ITEM* item : aScreen->Items().OfType( SCH_GLOBAL_LABEL_T ) )
 {
 SCH_LABEL_BASE* otherLabel = static_cast<SCH_LABEL_BASE*>( item );
 if( otherLabel != label && otherLabel->GetText() == label->GetText() )
 {
 otherLabel->AutoplaceFields( aScreen, false );
 }
 }
 }
 }
 }
}

References SCH_LABEL_BASE::AutoplaceFields(), GetCurrentSheet(), SCH_SCREEN::GetLabelOrientationForPoint(), EDA_TEXT::GetText(), SCH_ITEM::IsType(), SCH_SCREEN::Items(), EE_RTREE::OfType(), and SCH_GLOBAL_LABEL_T.

Referenced by AddItemToScreenAndUndoList(), and SCH_EDIT_TOOL::Swap().

BreakSegment()

bool SCH_EDIT_FRAME::BreakSegment	(	SCH_LINE *	aSegment,
		const VECTOR2I &	aPoint,
		SCH_LINE **	aNewSegment = nullptr,
		SCH_SCREEN *	aScreen = nullptr
	)

Break a single segment into two at the specified point.

Note

This always appends to the existing undo state.

Parameters

aSegment	Line segment to break
aPoint	Point at which to break the segment
aNewSegment	Pointer to the newly created segment (if given and created)
aScreen	is the screen to examine, or nullptr to examine the current screen.

Returns

True if any wires or buses were broken.

Definition at line 293 of file bus-wire-junction.cpp.

{
 if( aScreen == nullptr )
 aScreen = GetScreen();
 
 SCH_LINE* newSegment = static_cast<SCH_LINE*>( aSegment->Duplicate() );
 
 newSegment->SetStartPoint( aPoint );
 newSegment->SetConnectivityDirty( true );
 AddToScreen( newSegment, aScreen );
 
 SaveCopyInUndoList( aScreen, newSegment, UNDO_REDO::NEWITEM, true );
 SaveCopyInUndoList( aScreen, aSegment, UNDO_REDO::CHANGED, true );
 
 UpdateItem( aSegment, false, true );
 aSegment->SetEndPoint( aPoint );
 
 if( aNewSegment )
 *aNewSegment = newSegment;
 
 return true;
}

References SCH_BASE_FRAME::AddToScreen(), CHANGED, SCH_ITEM::Duplicate(), GetScreen(), NEWITEM, SaveCopyInUndoList(), SCH_ITEM::SetConnectivityDirty(), SCH_LINE::SetEndPoint(), SCH_LINE::SetStartPoint(), and UpdateItem().

Referenced by BreakSegments(), SCH_EDIT_TOOL::BreakWire(), and TrimWire().

BreakSegments()

bool SCH_EDIT_FRAME::BreakSegments	(	const VECTOR2I &	aPoint,
		SCH_SCREEN *	aScreen = nullptr
	)

Check every wire and bus for a intersection at aPoint and break into two segments at aPoint if an intersection is found.

Note

This always appends to the existing undo state.

Parameters

aPoint	Test this point for an intersection.
aScreen	is the screen to examine, or nullptr to examine the current screen.

Returns

True if any wires or buses were broken.

Definition at line 318 of file bus-wire-junction.cpp.

{
 if( aScreen == nullptr )
 aScreen = GetScreen();
 
 bool brokenSegments = false;
 std::vector<SCH_LINE*> wires;
 
 for( SCH_ITEM* item : aScreen->Items().Overlapping( SCH_LINE_T, aPoint ) )
 {
 if( item->IsType( { SCH_ITEM_LOCATE_WIRE_T, SCH_ITEM_LOCATE_BUS_T } ) )
 {
 SCH_LINE* wire = static_cast<SCH_LINE*>( item );
 
 if( IsPointOnSegment( wire->GetStartPoint(), wire->GetEndPoint(), aPoint )
 && !wire->IsEndPoint( aPoint ) )
 {
 wires.push_back( wire );
 }
 }
 }
 
 for( SCH_LINE* wire : wires )
 brokenSegments |= BreakSegment( wire, aPoint, nullptr, aScreen );
 
 return brokenSegments;
}

References BreakSegment(), SCH_LINE::GetEndPoint(), GetScreen(), SCH_LINE::GetStartPoint(), SCH_LINE::IsEndPoint(), IsPointOnSegment(), SCH_SCREEN::Items(), EE_RTREE::Overlapping(), and SCH_LINE_T.

Referenced by AddJunction(), and BreakSegmentsOnJunctions().

BreakSegmentsOnJunctions()

bool SCH_EDIT_FRAME::BreakSegmentsOnJunctions

(

SCH_SCREEN *

aScreen = nullptr

)

Test all junctions and bus entries in the schematic for intersections with wires and buses and breaks any intersections into multiple segments.

Note

This always appends to the existing undo state.

Parameters

aScreen

is the screen to examine, or nullptr to examine the current screen

Returns

True if any wires or buses were broken.

Definition at line 347 of file bus-wire-junction.cpp.

{
 if( aScreen == nullptr )
 aScreen = GetScreen();
 
 bool brokenSegments = false;
 
 std::set<VECTOR2I> point_set;
 
 for( SCH_ITEM* item : aScreen->Items().OfType( SCH_JUNCTION_T ) )
 point_set.insert( item->GetPosition() );
 
 for( SCH_ITEM* item : aScreen->Items().OfType( SCH_BUS_WIRE_ENTRY_T ) )
 {
 SCH_BUS_WIRE_ENTRY* entry = static_cast<SCH_BUS_WIRE_ENTRY*>( item );
 point_set.insert( entry->GetPosition() );
 point_set.insert( entry->GetEnd() );
 }
 
 
 for( const VECTOR2I& pt : point_set )
  brokenSegments |= BreakSegments( pt, aScreen );
 
 return brokenSegments;
}

References BreakSegments(), SCH_BUS_ENTRY_BASE::GetEnd(), SCH_BUS_ENTRY_BASE::GetPosition(), GetScreen(), SCH_SCREEN::Items(), EE_RTREE::OfType(), SCH_BUS_WIRE_ENTRY_T, and SCH_JUNCTION_T.

Referenced by SchematicCleanUp().

canCloseWindow()

bool SCH_EDIT_FRAME::canCloseWindow ( wxCloseEvent &  aCloseEvent )

overrideprivatevirtual

Reimplemented from EDA_BASE_FRAME.

Definition at line 742 of file sch_edit_frame.cpp.

{
 // Exit interactive editing
 // Note this this will commit *some* pending changes. For instance, the EE_POINT_EDITOR
 // will cancel any drag currently in progress, but commit all changes from previous drags.
 if( m_toolManager )
 m_toolManager->RunAction( ACTIONS::cancelInteractive, true );
 
 // Shutdown blocks must be determined and vetoed as early as possible
 if( KIPLATFORM::APP::SupportsShutdownBlockReason() && aEvent.GetId() == wxEVT_QUERY_END_SESSION
 && Schematic().GetSheets().IsModified() )
 {
 return false;
 }
 
 if( Kiface().IsSingle() )
 {
 auto* symbolEditor = (SYMBOL_EDIT_FRAME*) Kiway().Player( FRAME_SCH_SYMBOL_EDITOR, false );
 
 if( symbolEditor && !symbolEditor->Close() ) // Can close symbol editor?
 return false;
 
 auto* symbolViewer = (SYMBOL_VIEWER_FRAME*) Kiway().Player( FRAME_SCH_VIEWER, false );
 
 if( symbolViewer && !symbolViewer->Close() ) // Can close symbol viewer?
 return false;
 
 symbolViewer = (SYMBOL_VIEWER_FRAME*) Kiway().Player( FRAME_SCH_VIEWER_MODAL, false );
 
 if( symbolViewer && !symbolViewer->Close() ) // Can close modal symbol viewer?
 return false;
 }
 else
 {
 auto* symbolEditor = (SYMBOL_EDIT_FRAME*) Kiway().Player( FRAME_SCH_SYMBOL_EDITOR, false );
 
 if( symbolEditor && symbolEditor->IsSymbolFromSchematic() )
 {
 if( !symbolEditor->CanCloseSymbolFromSchematic( true ) )
 return false;
 }
 }
 
 SIM_PLOT_FRAME* simFrame = (SIM_PLOT_FRAME*) Kiway().Player( FRAME_SIMULATOR, false );
 
 if( simFrame && !simFrame->Close() ) // Can close the simulator?
 return false;
 
 // We may have gotten multiple events; don't clean up twice
 if( !Schematic().IsValid() )
 return false;
 
 SCH_SHEET_LIST sheetlist = Schematic().GetSheets();
 
 if( sheetlist.IsModified() )
 {
 wxFileName fileName = Schematic().RootScreen()->GetFileName();
 wxString msg = _( "Save changes to '%s' before closing?" );
 
 if( !HandleUnsavedChanges( this, wxString::Format( msg, fileName.GetFullName() ),
 [&]() -> bool
 {
 return SaveProject();
 } ) )
 {
 return false;
 }
 }
 
 // Close modeless dialogs. They're trouble when they get destroyed after the frame and/or
 // board.
 wxWindow* open_dlg = wxWindow::FindWindowByName( DIALOG_ERC_WINDOW_NAME );
 
 if( open_dlg )
 open_dlg->Close( true );
 
 return true;
}

References _, ACTIONS::cancelInteractive, DIALOG_ERC_WINDOW_NAME, Format(), FRAME_SCH_SYMBOL_EDITOR, FRAME_SCH_VIEWER, FRAME_SCH_VIEWER_MODAL, FRAME_SIMULATOR, SCH_SCREEN::GetFileName(), SCHEMATIC::GetSheets(), HandleUnsavedChanges(), SCH_SHEET_LIST::IsModified(), SCHEMATIC::IsValid(), Kiface(), KIWAY_HOLDER::Kiway(), TOOLS_HOLDER::m_toolManager, KIWAY::Player(), SCHEMATIC::RootScreen(), TOOL_MANAGER::RunAction(), Schematic(), and KIPLATFORM::APP::SupportsShutdownBlockReason().

ChangeUserUnits()

void EDA_BASE_FRAME::ChangeUserUnits ( EDA_UNITS  aUnits )

inherited

Definition at line 1303 of file eda_base_frame.cpp.

{
 SetUserUnits( aUnits );
 unitsChangeRefresh();
 
 wxCommandEvent e( UNITS_CHANGED );
 ProcessEventLocally( e );
}

References UNITS_PROVIDER::SetUserUnits(), and EDA_BASE_FRAME::unitsChangeRefresh().

Referenced by COMMON_TOOLS::SwitchUnits(), and COMMON_TOOLS::ToggleUnits().

CheckAnnotate()

int SCH_EDIT_FRAME::CheckAnnotate	(	ANNOTATION_ERROR_HANDLER	aErrorHandler,
		ANNOTATE_SCOPE_T	aAnnotateScope = ANNOTATE_ALL,
		bool	aRecursive = true
	)

Check for annotation errors.

The following list of items are checked:

• Symbols that are not annotated.
• Duplicate symbol references.
• Multiple part per package symbols where the part number is greater number of parts in the package.
• Multiple part per package symbols where the reference designator is different between parts.

Returns

Number of annotation errors found.

Parameters

aReporter	A handler for error reporting.
aAnnotateScope	See ANNOTATE_SCOPE_T Check the current sheet only if true. Otherwise check the entire schematic.

Definition at line 441 of file annotate.cpp.

{
 SCH_REFERENCE_LIST referenceList;
 constexpr bool includePowerSymbols = false;
 SCH_SHEET_LIST sheets = Schematic().GetSheets();
 SCH_SHEET_PATH currentSheet = GetCurrentSheet();
 
 // Build the list of symbols
 switch( aAnnotateScope )
 {
 case ANNOTATE_ALL:
 Schematic().GetSheets().GetSymbols( referenceList );
 break;
 
 case ANNOTATE_CURRENT_SHEET:
 GetCurrentSheet().GetSymbols( referenceList, includePowerSymbols );
 
 if( aRecursive )
 {
 SCH_SHEET_LIST subSheets;
 
 std::vector<SCH_ITEM*> tempSubSheets;
 currentSheet.LastScreen()->GetSheets( &tempSubSheets );
 
 for( SCH_ITEM* item : tempSubSheets )
 {
 SCH_SHEET_PATH subSheetPath = currentSheet;
 subSheetPath.push_back( static_cast<SCH_SHEET*>( item ) );
 
 sheets.GetSheetsWithinPath( subSheets, subSheetPath );
 }
 
 for( SCH_SHEET_PATH sheet : subSheets )
 sheet.GetSymbols( referenceList, includePowerSymbols );
 }
 
 break;
 
 case ANNOTATE_SELECTION:
 EE_SELECTION_TOOL* selTool = m_toolManager->GetTool<EE_SELECTION_TOOL>();
 EE_SELECTION& selection = selTool->RequestSelection();
 
 for( SCH_SYMBOL* symbol : getInferredSymbols( selection ) )
 GetCurrentSheet().AppendSymbol( referenceList, symbol, false, true );
 
 if( aRecursive )
 {
 SCH_SHEET_LIST selectedSheets;
 
 for( EDA_ITEM* item : selection.Items() )
 {
 if( item->Type() == SCH_SHEET_T )
 {
 SCH_SHEET_PATH subSheetPath = currentSheet;
 subSheetPath.push_back( static_cast<SCH_SHEET*>( item ) );
 
 sheets.GetSheetsWithinPath( selectedSheets, subSheetPath );
 }
 }
 
 for( SCH_SHEET_PATH sheet : selectedSheets )
 sheet.GetSymbols( referenceList, includePowerSymbols );
 }
 
 break;
 }
 
 // Empty schematic does not need annotation
 if( referenceList.GetCount() == 0 )
 return 0;
 
 return referenceList.CheckAnnotation( aErrorHandler );
}

References ANNOTATE_ALL, ANNOTATE_CURRENT_SHEET, ANNOTATE_SELECTION, SCH_SHEET_PATH::AppendSymbol(), SCH_REFERENCE_LIST::CheckAnnotation(), SCH_REFERENCE_LIST::GetCount(), GetCurrentSheet(), getInferredSymbols(), SCHEMATIC::GetSheets(), SCH_SCREEN::GetSheets(), SCH_SHEET_LIST::GetSheetsWithinPath(), SCH_SHEET_PATH::GetSymbols(), SCH_SHEET_LIST::GetSymbols(), TOOL_MANAGER::GetTool(), SCH_SHEET_PATH::LastScreen(), TOOLS_HOLDER::m_toolManager, SCH_SHEET_PATH::push_back(), EE_SELECTION_TOOL::RequestSelection(), SCH_SHEET_T, and Schematic().

Referenced by AnnotateSymbols(), DIALOG_ERC::OnRunERCClick(), ReadyToNetlist(), and DIALOG_ERC::UpdateAnnotationWarning().

CheckForAutoSaveFile()

void SCH_EDIT_FRAME::CheckForAutoSaveFile ( const wxFileName &  aFileName )

overridevirtual

This overloaded version checks if the auto save master file "#auto_saved_files#" exists and recovers all of the schematic files listed in it.

Parameters

aFileName

is the project auto save master file name.

Reimplemented from EDA_BASE_FRAME.

Definition at line 1375 of file eeschema/files-io.cpp.

{
 wxCHECK_RET( aFileName.IsOk(), wxT( "Invalid file name!" ) );
 
 wxLogTrace( traceAutoSave,
 wxT( "Checking for auto save file " ) + aFileName.GetFullPath() );
 
 if( !aFileName.FileExists() )
 return;
 
 wxString msg = _(
 "Well this is potentially embarrassing!\n"
 "It appears that the last time you were editing one or more of the schematic files\n"
 "were not saved properly. Do you wish to restore the last saved edits you made?" );
 
 int response = wxMessageBox( msg, Pgm().App().GetAppDisplayName(), wxYES_NO | wxICON_QUESTION,
 this );
 
 wxTextFile autoSaveFile( aFileName.GetFullPath() );
 
 if( !autoSaveFile.Open() )
 {
 msg.Printf( _( "The file '%s` could not be opened.\n"
 "Manual recovery of automatically saved files is required." ),
 aFileName.GetFullPath() );
 
 wxMessageBox( msg, Pgm().App().GetAppDisplayName(), wxOK | wxICON_EXCLAMATION, this );
 return;
 }
 
 if( response == wxYES )
 {
 wxArrayString unrecoveredFiles;
 
 for( wxString fn = autoSaveFile.GetFirstLine(); !autoSaveFile.Eof();
 fn = autoSaveFile.GetNextLine() )
 {
 wxFileName recoveredFn = fn;
 wxString tmp = recoveredFn.GetName();
 
 // Strip "_autosave-" prefix from the auto save file name.
 tmp.Replace( GetAutoSaveFilePrefix(), wxT( "" ), false );
 recoveredFn.SetName( tmp );
 
 wxFileName backupFn = recoveredFn;
 
 backupFn.SetExt( backupFn.GetExt() + BackupFileSuffix );
 
 wxLogTrace( traceAutoSave, wxT( "Recovering auto save file:\n"
 " Original file: '%s'\n"
 " Backup file: '%s'\n"
 " Auto save file: '%s'" ),
 recoveredFn.GetFullPath(), backupFn.GetFullPath(), fn );
 
 // Attempt to back up the last schematic file before overwriting it with the auto
 // save file.
 if( !wxCopyFile( recoveredFn.GetFullPath(), backupFn.GetFullPath() ) )
 {
 unrecoveredFiles.Add( recoveredFn.GetFullPath() );
 }
 else if( !wxRenameFile( fn, recoveredFn.GetFullPath() ) )
 {
 unrecoveredFiles.Add( recoveredFn.GetFullPath() );
 }
 }
 
 if( !unrecoveredFiles.IsEmpty() )
 {
 msg = _( "The following automatically saved file(s) could not be restored\n" );
 
 for( size_t i = 0; i < unrecoveredFiles.GetCount(); i++ )
 msg += unrecoveredFiles[i] + wxT( "\n" );
 
 msg += _( "Manual recovery will be required to restore the file(s) above." );
 wxMessageBox( msg, Pgm().App().GetAppDisplayName(), wxOK | wxICON_EXCLAMATION,
 this );
 }
 }
 else
 {
 wxArrayString unremovedFiles;
 
 for( wxString fn = autoSaveFile.GetFirstLine(); !autoSaveFile.Eof();
 fn = autoSaveFile.GetNextLine() )
 {
 wxLogTrace( traceAutoSave, wxT( "Removing auto save file " ) + fn );
 
 if( !wxRemoveFile( fn ) )
 {
 unremovedFiles.Add( fn );
 }
 }
 
 if( !unremovedFiles.IsEmpty() )
 {
 msg = _( "The following automatically saved file(s) could not be removed\n" );
 
 for( size_t i = 0; i < unremovedFiles.GetCount(); i++ )
 msg += unremovedFiles[i] + wxT( "\n" );
 
 msg += _( "Manual removal will be required for the file(s) above." );
 wxMessageBox( msg, Pgm().App().GetAppDisplayName(), wxOK | wxICON_EXCLAMATION,
 this );
 }
 }
 
 // Remove the auto save master file.
 wxLogTrace( traceAutoSave, wxT( "Removing auto save file '%s'" ), aFileName.GetFullPath() );
 
 if( !wxRemoveFile( aFileName.GetFullPath() ) )
 {
 msg.Printf( _( "The automatic save master file\n"
 "'%s'\n"
 "could not be deleted." ), aFileName.GetFullPath() );
 
 wxMessageDialog dlg( this, msg, Pgm().App().GetAppDisplayName(),
 wxOK | wxICON_EXCLAMATION | wxCENTER );
 
 dlg.SetExtendedMessage(
 _( "This file must be manually removed or the auto save feature will be\n"
 "shown every time the schematic editor is launched." ) );
 
 dlg.ShowModal();
 }
}

References _, BackupFileSuffix, EDA_BASE_FRAME::GetAutoSaveFilePrefix(), Pgm(), and traceAutoSave.

Referenced by OpenProjectFiles().

checkForNoFullyDefinedLibIds()

bool SCH_EDIT_FRAME::checkForNoFullyDefinedLibIds ( SCH_SHEET *  aSheet )

private

Verify that the symbol library links aSheet and all of its child sheets have been remapped to the symbol library table.

Parameters

aSheet

is the SCH_SHEET object to test.

Returns

true if aSheet and its child sheets have not been remapped.

Definition at line 75 of file sheet.cpp.

{
 wxASSERT( aSheet && aSheet->GetScreen() );
 
 wxString msg;
 SCH_SCREENS newScreens( aSheet );
 
 if( newScreens.HasNoFullyDefinedLibIds() )
 {
 msg.Printf( _( "The schematic '%s' has not had its symbol library links remapped "
 "to the symbol library table. The project this schematic belongs to "
 "must first be remapped before it can be imported into the current "
 "project." ),
 aSheet->GetScreen()->GetFileName() );
 DisplayInfoMessage( this, msg );
 return true;
 }
 
 return false;
}

References _, DisplayInfoMessage(), SCH_SCREEN::GetFileName(), SCH_SHEET::GetScreen(), and SCH_SCREENS::HasNoFullyDefinedLibIds().

Referenced by LoadSheetFromFile().

CheckSheetForRecursion()

bool SCH_EDIT_FRAME::CheckSheetForRecursion	(	SCH_SHEET *	aSheet,
		SCH_SHEET_PATH *	aHierarchy
	)

Verify that aSheet will not cause a recursion error in aHierarchy.

Parameters

aSheet	is the SCH_SHEET object to test.
aHierarchy	is the SCH_SHEET_PATH where aSheet is going to reside.

Returns

true if aSheet will cause a recursion error in aHierarchy.

Definition at line 47 of file sheet.cpp.

{
 wxASSERT( aSheet && aHierarchy );
 
 wxString msg;
 SCH_SHEET_LIST hierarchy = Schematic().GetSheets(); // The full schematic sheet hierarchy.
 SCH_SHEET_LIST sheetHierarchy( aSheet ); // This is the hierarchy of the loaded file.
 
 wxFileName destFile = aHierarchy->LastScreen()->GetFileName();
 
 // SCH_SCREEN object file paths are expected to be absolute. If this assert fires,
 // something is seriously broken.
 wxASSERT( destFile.IsAbsolute() );
 
 if( hierarchy.TestForRecursion( sheetHierarchy, destFile.GetFullPath() ) )
 {
 msg.Printf( _( "The sheet changes cannot be made because the destination sheet already "
 "has the sheet '%s' or one of its subsheets as a parent somewhere in the "
 "schematic hierarchy." ),
 destFile.GetFullPath() );
 DisplayError( this, msg );
 return true;
 }
 
 return false;
}

References _, DisplayError(), SCH_SCREEN::GetFileName(), SCHEMATIC::GetSheets(), SCH_SHEET_PATH::LastScreen(), Schematic(), and SCH_SHEET_LIST::TestForRecursion().

Referenced by LoadSheetFromFile(), and DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged().

ClearExecFlags()

void SCH_EDIT_FRAME::ClearExecFlags ( const int  aFlags )

inline

Clear (removes) specified flags that not needed for next execution of external generator of the netlist or bom.

Parameters

aFlags

is the wxEXEC_* flags, see wxExecute documentation.

Definition at line 763 of file sch_edit_frame.h.

{ m_exec_flags &= ~( aFlags ); }

References m_exec_flags.

ClearFileHistory()

void EDA_BASE_FRAME::ClearFileHistory ( FILE_HISTORY *  aFileHistory = nullptr )

inherited

Removes all files from the file history.

Parameters

aFileHistory

The FILE_HISTORY in use. If null, the main application file history is used

Definition at line 948 of file eda_base_frame.cpp.

{
 if( !aFileHistory )
 aFileHistory = m_fileHistory;
 
 wxASSERT( aFileHistory );
 
 aFileHistory->ClearFileHistory();
 
 // Update the menubar to update the file history menu
 if( GetMenuBar() )
 {
 ReCreateMenuBar();
 GetMenuBar()->Refresh();
 }
}

References FILE_HISTORY::ClearFileHistory(), EDA_BASE_FRAME::m_fileHistory, and EDA_BASE_FRAME::ReCreateMenuBar().

Referenced by GERBVIEW_FRAME::OnClearDrlFileHistory(), OnClearFileHistory(), KICAD_MANAGER_FRAME::OnClearFileHistory(), PL_EDITOR_FRAME::OnClearFileHistory(), PCB_EDIT_FRAME::OnClearFileHistory(), GERBVIEW_FRAME::OnClearGbrFileHistory(), GERBVIEW_FRAME::OnClearJobFileHistory(), and GERBVIEW_FRAME::OnClearZipFileHistory().

ClearFindReplaceStatus()

void SCH_EDIT_FRAME::ClearFindReplaceStatus

(

)

Definition at line 1089 of file sch_edit_frame.cpp.

{
 m_infoBar->Dismiss();
}

References WX_INFOBAR::Dismiss(), and EDA_BASE_FRAME::m_infoBar.

Referenced by SCH_EDITOR_CONTROL::FindNext().

ClearMsgPanel()

void EDA_DRAW_FRAME::ClearMsgPanel ( )

virtualinherited

Clear all messages from the message panel.

Reimplemented in SYMBOL_EDIT_FRAME.

Definition at line 716 of file eda_draw_frame.cpp.

{
 if( m_messagePanel )
 m_messagePanel->EraseMsgBox();
}

References EDA_MSG_PANEL::EraseMsgBox(), and EDA_DRAW_FRAME::m_messagePanel.

Referenced by GERBVIEW_CONTROL::ClearAllLayers(), GERBVIEW_CONTROL::ClearLayer(), GERBER_FILE_IMAGE::DisplayImageInfo(), DIALOG_GENDRILL::GenDrillAndMapFiles(), GERBVIEW_FRAME::LoadGerberJobFile(), DIALOG_BOM::OnRunGenerator(), GERBVIEW_CONTROL::ReloadAllLayers(), NETLIST_DIALOG::TransferDataFromWindow(), EE_INSPECTION_TOOL::UpdateMessagePanel(), FOOTPRINT_WIZARD_FRAME::UpdateMsgPanel(), SYMBOL_VIEWER_FRAME::updatePreviewSymbol(), SYMBOL_EDIT_FRAME::UpdateSymbolMsgPanelInfo(), and GERBVIEW_FRAME::UpdateTitleAndInfo().

ClearUndoORRedoList()

void SCH_EDIT_FRAME::ClearUndoORRedoList ( UNDO_REDO_LIST  whichList, int  aItemCount = -1  )

overridevirtual

Free the undo or redo list from aList element.

• Wrappers are deleted.
• data pointed by wrappers are deleted if not in use in schematic i.e. when they are copy of a schematic item or they are no more in use (DELETED)

Parameters

whichList	is the UNDO_REDO_CONTAINER to clear
aItemCount	is the count of items to remove. Use < 0 to remove all items from the beginning of the list.

Reimplemented from EDA_BASE_FRAME.

Definition at line 411 of file schematic_undo_redo.cpp.

{
 if( aItemCount == 0 )
 return;
 
 UNDO_REDO_CONTAINER& list = whichList == UNDO_LIST ? m_undoList : m_redoList;
 
 for( PICKED_ITEMS_LIST* command : list.m_CommandsList )
 {
 command->ClearListAndDeleteItems();
 delete command;
 }
 
 list.m_CommandsList.clear();
}

References PICKED_ITEMS_LIST::ClearListAndDeleteItems(), UNDO_REDO_CONTAINER::m_CommandsList, EDA_BASE_FRAME::m_redoList, EDA_BASE_FRAME::m_undoList, and EDA_BASE_FRAME::UNDO_LIST.

Referenced by DIALOG_SYMBOL_REMAP::OnRemapSymbols(), and SaveCopyInUndoList().

ClearUndoRedoList()

void EDA_BASE_FRAME::ClearUndoRedoList ( )

virtualinherited

Clear the undo and redo list using ClearUndoORRedoList()

Picked items are deleted by ClearUndoORRedoList() according to their status.

Definition at line 1254 of file eda_base_frame.cpp.

{
 ClearUndoORRedoList( UNDO_LIST );
 ClearUndoORRedoList( REDO_LIST );
}

References EDA_BASE_FRAME::ClearUndoORRedoList(), EDA_BASE_FRAME::REDO_LIST, and EDA_BASE_FRAME::UNDO_LIST.

Referenced by FOOTPRINT_EDIT_FRAME::Clear_Pcb(), PCB_EDIT_FRAME::Clear_Pcb(), SYMBOL_EDIT_FRAME::emptyScreen(), importFile(), FOOTPRINT_EDITOR_CONTROL::ImportFootprint(), PCB_EDIT_FRAME::ImportSpecctraSession(), FOOTPRINT_EDIT_FRAME::LoadFootprintFromBoard(), SYMBOL_EDIT_FRAME::LoadOneLibrarySymbolAux(), SYMBOL_EDIT_FRAME::LoadSymbolFromCurrentLib(), OnImportProject(), PL_EDITOR_FRAME::OnNewDrawingSheet(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), OpenProjectFiles(), SCH_EDITOR_CONTROL::rescueProject(), FOOTPRINT_EDIT_FRAME::RevertFootprint(), and EDA_BASE_FRAME::~EDA_BASE_FRAME().

commonInit()

void EDA_BASE_FRAME::commonInit ( FRAME_T  aFrameType )

privateinherited

Collect common initialization functions used in all CTORs.

Definition at line 117 of file eda_base_frame.cpp.

{
 m_ident = aFrameType;
 m_maximizeByDefault = false;
 m_infoBar = nullptr;
 m_settingsManager = nullptr;
 m_fileHistory = nullptr;
 m_supportsAutoSave = false;
 m_autoSaveState = false;
 m_undoRedoCountMax = DEFAULT_MAX_UNDO_ITEMS;
 m_isClosing = false;
 m_isNonUserClose = false;
 m_autoSaveTimer = new wxTimer( this, ID_AUTO_SAVE_TIMER );
 m_mruPath = PATHS::GetDefaultUserProjectsPath();
 m_frameSize = defaultSize( aFrameType );
 m_displayIndex = -1;
 
 m_auimgr.SetArtProvider( new WX_AUI_DOCK_ART() );
 
 m_settingsManager = &Pgm().GetSettingsManager();
 
 // Set a reasonable minimal size for the frame
 SetSizeHints( minSize( aFrameType ).x, minSize( aFrameType ).y, -1, -1, -1, -1 );
 
 // Store dimensions of the user area of the main window.
 GetClientSize( &m_frameSize.x, &m_frameSize.y );
 
 Connect( ID_AUTO_SAVE_TIMER, wxEVT_TIMER,
 wxTimerEventHandler( EDA_BASE_FRAME::onAutoSaveTimer ) );
 
 // hook wxEVT_CLOSE_WINDOW so we can call SaveSettings(). This function seems
 // to be called before any other hook for wxCloseEvent, which is necessary.
 Connect( wxEVT_CLOSE_WINDOW, wxCloseEventHandler( EDA_BASE_FRAME::windowClosing ) );
 
 initExitKey();
}

References DEFAULT_MAX_UNDO_ITEMS, defaultSize(), PATHS::GetDefaultUserProjectsPath(), ID_AUTO_SAVE_TIMER, minSize(), EDA_BASE_FRAME::onAutoSaveTimer(), Pgm(), and EDA_BASE_FRAME::windowClosing().

Referenced by EDA_BASE_FRAME::EDA_BASE_FRAME().

CommonSettingsChanged()

void SCH_EDIT_FRAME::CommonSettingsChanged ( bool  aEnvVarsChanged, bool  aTextVarsChanged  )

overridevirtual

Called after the preferences dialog is run.

Reimplemented from SCH_BASE_FRAME.

Definition at line 1607 of file sch_edit_frame.cpp.

{
 SCHEMATIC_SETTINGS& settings = Schematic().Settings();
 
 SCH_BASE_FRAME::CommonSettingsChanged( aEnvVarsChanged, aTextVarsChanged );
 settings.m_JunctionSize = GetSchematicJunctionSize();
 
 ShowAllIntersheetRefs( settings.m_IntersheetRefsShow );
 
 EESCHEMA_SETTINGS* cfg = Pgm().GetSettingsManager().GetAppSettings<EESCHEMA_SETTINGS>();
 GetGalDisplayOptions().ReadWindowSettings( cfg->m_Window );
 
 KIGFX::VIEW* view = GetCanvas()->GetView();
 view->SetLayerVisible( LAYER_ERC_ERR, cfg->m_Appearance.show_erc_errors );
 view->SetLayerVisible( LAYER_ERC_WARN, cfg->m_Appearance.show_erc_warnings );
 view->SetLayerVisible( LAYER_ERC_EXCLUSION, cfg->m_Appearance.show_erc_exclusions );
 
 SCH_SCREEN* screen = GetCurrentSheet().LastScreen();
 
 for( SCH_ITEM* item : screen->Items() )
 item->ClearCaches();
 
 for( std::pair<const wxString, LIB_SYMBOL*>& libSymbol : screen->GetLibSymbols() )
 libSymbol.second->ClearCaches();
 
 GetCanvas()->ForceRefresh();
 
 RecreateToolbars();
 Layout();
 SendSizeEvent();
}

References SCH_BASE_FRAME::CommonSettingsChanged(), EDA_DRAW_PANEL_GAL::ForceRefresh(), SCH_BASE_FRAME::GetCanvas(), GetCurrentSheet(), EDA_DRAW_FRAME::GetGalDisplayOptions(), SCH_SCREEN::GetLibSymbols(), GetSchematicJunctionSize(), SCH_DRAW_PANEL::GetView(), SCH_SCREEN::Items(), SCH_SHEET_PATH::LastScreen(), LAYER_ERC_ERR, LAYER_ERC_EXCLUSION, LAYER_ERC_WARN, EESCHEMA_SETTINGS::m_Appearance, SCHEMATIC_SETTINGS::m_IntersheetRefsShow, SCHEMATIC_SETTINGS::m_JunctionSize, APP_SETTINGS_BASE::m_Window, Pgm(), KIGFX::GAL_DISPLAY_OPTIONS::ReadWindowSettings(), EDA_DRAW_FRAME::RecreateToolbars(), Schematic(), KIGFX::VIEW::SetLayerVisible(), SCHEMATIC::Settings(), EESCHEMA_SETTINGS::APPEARANCE::show_erc_errors, EESCHEMA_SETTINGS::APPEARANCE::show_erc_exclusions, EESCHEMA_SETTINGS::APPEARANCE::show_erc_warnings, and ShowAllIntersheetRefs().

config()

APP_SETTINGS_BASE * EDA_BASE_FRAME::config ( ) const

virtualinherited

Returns the settings object used in SaveSettings(), and is overloaded in KICAD_MANAGER_FRAME.

Reimplemented in SYMBOL_EDIT_FRAME, KICAD_MANAGER_FRAME, and FOOTPRINT_EDIT_FRAME.

Definition at line 788 of file eda_base_frame.cpp.

{
 // KICAD_MANAGER_FRAME overrides this
 return Kiface().KifaceSettings();
}

References Kiface(), and KIFACE_BASE::KifaceSettings().

Referenced by GERBVIEW_FRAME::ActivateGalCanvas(), PCB_BASE_FRAME::ActivateGalCanvas(), BM2CMP_FRAME::BM2CMP_FRAME(), CVPCB_MAINFRAME::CVPCB_MAINFRAME(), DIALOG_BOARD_REANNOTATE::DIALOG_BOARD_REANNOTATE(), DIALOG_GRID_SETTINGS::DIALOG_GRID_SETTINGS(), SIM_PLOT_FRAME::doCloseWindow(), FOOTPRINT_WIZARD_FRAME::doCloseWindow(), SCH_BASE_FRAME::eeconfig(), GERBVIEW_FRAME::GERBVIEW_FRAME(), PCB_EDIT_FRAME::GetRotationAngle(), GRID_MENU::GRID_MENU(), COMMON_TOOLS::GridFast1(), COMMON_TOOLS::GridFast2(), GERBVIEW_FRAME::gvconfig(), EDA_DRAW_FRAME::IsGridVisible(), SCH_BASE_FRAME::libeditconfig(), EDA_DRAW_FRAME::OnUpdateSelectGrid(), EDA_DRAW_FRAME::OnUpdateSelectZoom(), PCB_CALCULATOR_FRAME::PCB_CALCULATOR_FRAME(), GERBVIEW_FRAME::Read_EXCELLON_File(), DIALOG_GRID_SETTINGS::RebuildGridSizes(), EDA_DRAW_FRAME::resolveCanvasType(), PCB_BASE_EDIT_FRAME::SetBoard(), EDA_DRAW_FRAME::SetGridVisibility(), CVPCB_MAINFRAME::setupTools(), setupTools(), SYMBOL_VIEWER_FRAME::setupTools(), GERBVIEW_FRAME::setupTools(), PL_EDITOR_FRAME::setupTools(), PCB_EDIT_FRAME::setupTools(), SIM_PLOT_FRAME::SIM_PLOT_FRAME(), SYMBOL_VIEWER_FRAME::SYMBOL_VIEWER_FRAME(), DIALOG_GRID_SETTINGS::TransferDataFromWindow(), DIALOG_GRID_SETTINGS::TransferDataToWindow(), GRID_MENU::update(), ZOOM_MENU::update(), EDA_DRAW_FRAME::UpdateGridSelectBox(), EDA_DRAW_FRAME::UpdateZoomSelectBox(), EDA_BASE_FRAME::windowClosing(), and BM2CMP_FRAME::~BM2CMP_FRAME().

ConfigBaseName()

wxString EDA_BASE_FRAME::ConfigBaseName ( )

inlineoverridevirtualinherited

Get the configuration base name.

This is usually the name of the frame set by CTOR, except for frames shown in multiple modes in which case the m_configName must be set to the base name so that a single configuration can be used.

Returns

a base name prefix used in Load/Save settings to build the full name of keys used in configuration.

Reimplemented from TOOLS_HOLDER.

Definition at line 341 of file eda_base_frame.h.

 {
 wxString baseCfgName = m_configName.IsEmpty() ? GetName() : m_configName;
 return baseCfgName;
 }

References EDA_BASE_FRAME::m_configName.

ConvertPart()

void SCH_EDIT_FRAME::ConvertPart

(

SCH_SYMBOL *

aSymbol

)

Definition at line 275 of file picksymbol.cpp.

{
 if( !aSymbol || !aSymbol->GetLibSymbolRef() )
 return;
 
 wxString msg;
 
 if( !aSymbol->GetLibSymbolRef()->HasConversion() )
 {
 LIB_ID id = aSymbol->GetLibSymbolRef()->GetLibId();
 
 msg.Printf( _( "No alternate body style found for symbol '%s' in library '%s'." ),
 id.GetLibItemName().wx_str(),
 id.GetLibNickname().wx_str() );
 DisplayError( this, msg );
 return;
 }
 
 EDA_ITEM_FLAGS savedFlags = aSymbol->GetFlags();
 
 aSymbol->SetConvert( aSymbol->GetConvert() + 1 );
 
 // ensure m_convert = 1 or 2
 // 1 = shape 1 = not converted
 // 2 = shape 2 = first converted shape
 // > 2 is not currently supported
 // When m_convert = val max, return to the first shape
 if( aSymbol->GetConvert() > LIB_ITEM::LIB_CONVERT::DEMORGAN )
 aSymbol->SetConvert( LIB_ITEM::LIB_CONVERT::BASE );
 
 TestDanglingEnds();
 aSymbol->ClearFlags();
 aSymbol->SetFlags( savedFlags ); // Restore m_flags (modified by SetConvert())
 
 // If selected make sure all the now-included pins are selected
 if( aSymbol->IsSelected() )
 m_toolManager->RunAction( EE_ACTIONS::addItemToSel, true, aSymbol );
 
 UpdateItem( aSymbol, false, true );
 OnModify();
}

References _, EE_ACTIONS::addItemToSel, EDA_ITEM::ClearFlags(), DisplayError(), SCH_SYMBOL::GetConvert(), EDA_ITEM::GetFlags(), SCH_SYMBOL::GetLibSymbolRef(), EDA_ITEM::IsSelected(), TOOLS_HOLDER::m_toolManager, OnModify(), TOOL_MANAGER::RunAction(), SCH_SYMBOL::SetConvert(), EDA_ITEM::SetFlags(), TestDanglingEnds(), and UpdateItem().

Referenced by SCH_EDIT_TOOL::ConvertDeMorgan().

CreateArchiveLibrary()

bool SCH_EDIT_FRAME::CreateArchiveLibrary

(

const wxString &

aFileName

)

Create a library aFileName that contains all symbols used in the current schematic.

Parameters

aFileName

The full path and file name of the archive library.

Returns

True if aFileName was written successfully.

Definition at line 65 of file libarch.cpp.

{
 wxString tmp;
 wxString errorMsg;
 SCH_SCREENS screens( Schematic().Root() );
 
 // Create a new empty library to archive symbols:
 std::unique_ptr<SYMBOL_LIB> archLib = std::make_unique<SYMBOL_LIB>( SCH_LIB_TYPE::LT_EESCHEMA,
 aFileName );
 
 // Save symbols to file only when the library will be fully filled
 archLib->EnableBuffering();
 
 /* Examine all screens (not hierarchical sheets) used in the schematic and build a
 * library of unique symbols found in all screens. Complex hierarchies are not a
 * problem because we just want to know the library symbols used in the schematic
 * not their reference.
 */
 for( SCH_SCREEN* screen = screens.GetFirst(); screen; screen = screens.GetNext() )
 {
 
 for( SCH_ITEM* aItem : screen->Items().OfType( SCH_SYMBOL_T ) )
 {
 LIB_SYMBOL* libSymbol = nullptr;
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( aItem );
 
 try
 {
 if( archLib->FindSymbol( symbol->GetLibId() ) )
 continue;
 
 libSymbol = GetLibSymbol( symbol->GetLibId(), true );
 }
 catch( const IO_ERROR& )
 {
 // Queue up error messages for later.
 tmp.Printf( _( "Failed to add symbol %s to library file '%s'." ),
 symbol->GetLibId().GetUniStringLibItemName(),
 aFileName );
 
 // Don't bail out here. Attempt to add as many of the symbols to the library
 // as possible.
 }
 catch( ... )
 {
 tmp = _( "Unexpected exception occurred." );
 }
 
 if( libSymbol )
 {
 std::unique_ptr<LIB_SYMBOL> flattenedSymbol = libSymbol->Flatten();
 
 // Use the full LIB_ID as the symbol name to prevent symbol name collisions.
 flattenedSymbol->SetName( symbol->GetLibId().GetUniStringLibId() );
 
 // AddSymbol() does first clone the symbol before adding.
 archLib->AddSymbol( flattenedSymbol.get() );
 }
 else
 {
 tmp.Printf( _( "Symbol %s not found in any library or cache." ),
 symbol->GetLibId().GetUniStringLibId() );
 }
 
 if( !tmp.empty() && !errorMsg.Contains( symbol->GetLibId().GetUniStringLibId() ) )
 {
 if( errorMsg.empty() )
 errorMsg += tmp;
 else
 errorMsg += "\n" + tmp;
 }
 }
 }
 
 if( !errorMsg.empty() )
 {
 tmp.Printf( _( "Errors occurred creating symbol library %s." ), aFileName );
 DisplayErrorMessage( this, tmp, errorMsg );
 }
 
 archLib->EnableBuffering( false );
 
 try
 {
 archLib->Save( false );
 }
 catch( const IO_ERROR& ioe )
 {
 errorMsg.Printf( _( "Failed to save symbol library file '%s'." ), aFileName );
 DisplayErrorMessage( this, errorMsg, ioe.What() );
 return false;
 }
 catch( std::exception& error )
 {
 errorMsg.Printf( _( "Failed to save symbol library file '%s'." ), aFileName );
 DisplayErrorMessage( this, errorMsg, error.what() );
 return false;
 }
 
 return true;
}

References _, DisplayErrorMessage(), LIB_SYMBOL::Flatten(), SCH_SCREENS::GetFirst(), SCH_SYMBOL::GetLibId(), SCH_BASE_FRAME::GetLibSymbol(), SCH_SCREENS::GetNext(), LIB_ID::GetUniStringLibId(), LIB_ID::GetUniStringLibItemName(), LT_EESCHEMA, SCH_SYMBOL_T, Schematic(), and IO_ERROR::What().

Referenced by CreateArchiveLibraryCacheFile().

CreateArchiveLibraryCacheFile()

bool SCH_EDIT_FRAME::CreateArchiveLibraryCacheFile

(

bool

aUseCurrentSheetFilename = false

)

Create a symbol library file with the name of the root document plus the '-cache' suffix,.

This file will contain all symbols used in the current schematic.

Parameters

aUseCurrentSheetFilename

set to false to use the root sheet filename (default) or true to use the currently opened sheet.

Returns

true if the file was written successfully.

Definition at line 42 of file libarch.cpp.

{
 wxFileName fn;
 
 if( aUseCurrentSheetFilename )
 fn = GetScreen()->GetFileName();
 else
 fn = Schematic().RootScreen()->GetFileName();
 
 fn.SetName( fn.GetName() + "-cache" );
 fn.SetExt( LegacySymbolLibFileExtension );
 
 bool success = CreateArchiveLibrary( fn.GetFullPath() );
 
 // Update the schematic symbol library links.
 // because the lib cache has changed
 SCH_SCREENS schematic( Schematic().Root() );
 schematic.UpdateSymbolLinks();
 
 return success;
}

References CreateArchiveLibrary(), SCH_SCREEN::GetFileName(), GetScreen(), LegacySymbolLibFileExtension, SCHEMATIC::RootScreen(), Schematic(), and SCH_SCREENS::UpdateSymbolLinks().

createCanvas()

void SCH_BASE_FRAME::createCanvas ( )

inherited

Definition at line 338 of file sch_base_frame.cpp.

{
 m_canvasType = loadCanvasTypeSetting();
 
 SetCanvas( new SCH_DRAW_PANEL( this, wxID_ANY, wxPoint( 0, 0 ), m_frameSize,
 GetGalDisplayOptions(), m_canvasType ) );
 ActivateGalCanvas();
}

References SCH_BASE_FRAME::ActivateGalCanvas(), EDA_DRAW_FRAME::GetGalDisplayOptions(), EDA_DRAW_FRAME::loadCanvasTypeSetting(), EDA_DRAW_FRAME::m_canvasType, EDA_BASE_FRAME::m_frameSize, and EDA_DRAW_FRAME::SetCanvas().

Referenced by SCH_BASE_FRAME::SCH_BASE_FRAME().

CreateInfoBar()

void EDA_BASE_FRAME::CreateInfoBar ( )

inherited

Definition at line 813 of file eda_base_frame.cpp.

{
#if defined( __WXOSX_MAC__ )
 m_infoBar = new WX_INFOBAR( GetToolCanvas() );
#else
 m_infoBar = new WX_INFOBAR( this, &m_auimgr );
 
 m_auimgr.AddPane( m_infoBar, EDA_PANE().InfoBar().Name( "InfoBar" ).Top().Layer(1) );
#endif
}

References TOOLS_HOLDER::GetToolCanvas(), EDA_BASE_FRAME::m_auimgr, and EDA_BASE_FRAME::m_infoBar.

CreateScreens()

void SCH_EDIT_FRAME::CreateScreens

(

)

Definition at line 677 of file sch_edit_frame.cpp.

{
 m_schematic->Reset();
 m_schematic->SetProject( &Prj() );
 
 m_schematic->SetRoot( new SCH_SHEET( m_schematic ) );
 
 SCH_SCREEN* rootScreen = new SCH_SCREEN( m_schematic );
 m_schematic->Root().SetScreen( rootScreen );
 SetScreen( Schematic().RootScreen() );
 
 m_schematic->RootScreen()->SetFileName( wxEmptyString );
 
 // Don't leave root page number empty
 SCH_SHEET_PATH rootSheetPath;
 rootSheetPath.push_back( &m_schematic->Root() );
 m_schematic->RootScreen()->SetPageNumber( wxT( "1" ) );
 m_schematic->Root().AddInstance( rootSheetPath );
 m_schematic->Root().SetPageNumber( rootSheetPath, wxT( "1" ) );
 
 if( GetScreen() == nullptr )
 {
 SCH_SCREEN* screen = new SCH_SCREEN( m_schematic );
 SetScreen( screen );
 }
}

References SCH_SHEET::AddInstance(), GetScreen(), m_schematic, KIWAY_HOLDER::Prj(), SCH_SHEET_PATH::push_back(), SCHEMATIC::Reset(), SCHEMATIC::Root(), SCHEMATIC::RootScreen(), Schematic(), SCH_SCREEN::SetFileName(), SCH_SHEET::SetPageNumber(), BASE_SCREEN::SetPageNumber(), SCHEMATIC::SetProject(), SCHEMATIC::SetRoot(), SetScreen(), and SCH_SHEET::SetScreen().

Referenced by importFile(), and OpenProjectFiles().

CreateServer()

void KIWAY_PLAYER::CreateServer ( int  service, bool  local = true  )

inherited

Definition at line 43 of file eda_dde.cpp.

{
 wxIPV4address addr;
 
 // Set the port number
 addr.Service( service );
 
 // Listen on localhost only if requested
 if( local )
 addr.Hostname( HOSTNAME );
 
 if( m_socketServer )
 {
 // this helps prevent any events that could come in during deletion
 m_socketServer->Notify( false );
 delete m_socketServer;
 }
 
 m_socketServer = new wxSocketServer( addr );
 
 m_socketServer->SetNotify( wxSOCKET_CONNECTION_FLAG );
 m_socketServer->SetEventHandler( *this, ID_EDA_SOCKET_EVENT_SERV );
 m_socketServer->Notify( true );
}

References HOSTNAME(), ID_EDA_SOCKET_EVENT_SERV, and KIWAY_PLAYER::m_socketServer.

Referenced by SCH::IFACE::CreateWindow().

CurrentToolName()

std::string TOOLS_HOLDER::CurrentToolName ( ) const

inherited

Definition at line 110 of file tools_holder.cpp.

{
 if( m_toolStack.empty() )
 return ACTIONS::selectionTool.GetName();
 else
 return m_toolStack.back();
}

References TOOL_ACTION::GetName(), TOOLS_HOLDER::m_toolStack, and ACTIONS::selectionTool.

Referenced by TOOLS_HOLDER::ShowChangedLanguage().

DefaultExecFlags()

void SCH_EDIT_FRAME::DefaultExecFlags ( )

inline

Reset the execution flags to defaults for external netlist and bom generators.

Definition at line 748 of file sch_edit_frame.h.

{ m_exec_flags = wxEXEC_SYNC; }

References m_exec_flags.

Referenced by WriteNetListFile().

DeleteAnnotation()

void SCH_EDIT_FRAME::DeleteAnnotation	(	ANNOTATE_SCOPE_T	aAnnotateScope,
		bool	aRecursive,
		bool *	appendUndo
	)

Clear the current symbol annotation.

Parameters

aCurrentSheetOnly	Where to clear the annotation. See ANNOTATE_SCOPE_T
appendUndo	true to add the action to the previous undo list

Definition at line 60 of file annotate.cpp.

{
 auto clearSymbolAnnotation =
 [&]( EDA_ITEM* aItem, SCH_SCREEN* aScreen, SCH_SHEET_PATH* aSheet, bool aResetPrefixes )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( aItem );
 
 SaveCopyInUndoList( aScreen, symbol, UNDO_REDO::CHANGED, *aAppendUndo );
 *aAppendUndo = true;
 symbol->ClearAnnotation( aSheet, aResetPrefixes );
 };
 
 auto clearSheetAnnotation =
 [&]( SCH_SCREEN* aScreen, SCH_SHEET_PATH* aSheet, bool aResetPrefixes )
 {
 for( SCH_ITEM* item : aScreen->Items().OfType( SCH_SYMBOL_T ) )
 clearSymbolAnnotation( item, aScreen, aSheet, aResetPrefixes );
 };
 
 SCH_SHEET_LIST sheets = Schematic().GetSheets();
 SCH_SCREEN* screen = GetScreen();
 SCH_SHEET_PATH currentSheet = GetCurrentSheet();
 
 switch( aAnnotateScope )
 {
 case ANNOTATE_ALL:
 {
 for( const SCH_SHEET_PATH& sheet : sheets )
 clearSheetAnnotation( sheet.LastScreen(), nullptr, false );
 
 break;
 }
 case ANNOTATE_CURRENT_SHEET:
 {
 clearSheetAnnotation( screen, &currentSheet, false );
 
 if( aRecursive )
 {
 SCH_SHEET_LIST subSheets;
 
 std::vector<SCH_ITEM*> tempSubSheets;
 currentSheet.LastScreen()->GetSheets( &tempSubSheets );
 
 for( SCH_ITEM* item : tempSubSheets )
 {
 SCH_SHEET_PATH subSheetPath = currentSheet;
 subSheetPath.push_back( static_cast<SCH_SHEET*>( item ) );
 
 sheets.GetSheetsWithinPath( subSheets, subSheetPath );
 }
 
 for( SCH_SHEET_PATH sheet : subSheets )
 clearSheetAnnotation( sheet.LastScreen(), &sheet, false );
 }
 
 break;
 }
 
 case ANNOTATE_SELECTION:
 {
 EE_SELECTION_TOOL* selTool = m_toolManager->GetTool<EE_SELECTION_TOOL>();
 EE_SELECTION& selection = selTool->RequestSelection();
 SCH_SHEET_LIST selectedSheets;
 
 for( EDA_ITEM* item : selection.Items() )
 {
 if( item->Type() == SCH_SYMBOL_T )
 clearSymbolAnnotation( item, screen, &currentSheet, false );
 
 if( item->Type() == SCH_SHEET_T && aRecursive )
 {
 SCH_SHEET_PATH subSheetPath = currentSheet;
 subSheetPath.push_back( static_cast<SCH_SHEET*>( item ) );
 
 sheets.GetSheetsWithinPath( selectedSheets, subSheetPath );
 }
 }
 
 for( SCH_SHEET_PATH sheet : selectedSheets )
 clearSheetAnnotation( sheet.LastScreen(), &sheet, false );
 
 break;
 }
 }
 
 // Update the references for the sheet that is currently being displayed.
 GetCurrentSheet().UpdateAllScreenReferences();
 
 wxWindow* erc_dlg = wxWindow::FindWindowByName( DIALOG_ERC_WINDOW_NAME );
 
 if( erc_dlg )
 static_cast<DIALOG_ERC*>( erc_dlg )->UpdateAnnotationWarning();
 
 SyncView();
 GetCanvas()->Refresh();
 OnModify();
 
 // Must go after OnModify() so the connectivity graph has been updated
 UpdateNetHighlightStatus();
}

References ANNOTATE_ALL, ANNOTATE_CURRENT_SHEET, ANNOTATE_SELECTION, CHANGED, SCH_SYMBOL::ClearAnnotation(), DIALOG_ERC_WINDOW_NAME, SCH_BASE_FRAME::GetCanvas(), GetCurrentSheet(), GetScreen(), SCHEMATIC::GetSheets(), SCH_SCREEN::GetSheets(), SCH_SHEET_LIST::GetSheetsWithinPath(), TOOL_MANAGER::GetTool(), SCH_SHEET_PATH::LastScreen(), TOOLS_HOLDER::m_toolManager, OnModify(), SCH_SHEET_PATH::push_back(), EDA_DRAW_PANEL_GAL::Refresh(), EE_SELECTION_TOOL::RequestSelection(), SaveCopyInUndoList(), SCH_SHEET_T, SCH_SYMBOL_T, Schematic(), SCH_BASE_FRAME::SyncView(), SCH_SHEET_PATH::UpdateAllScreenReferences(), and UpdateNetHighlightStatus().

Referenced by DIALOG_ANNOTATE::OnClearAnnotationClick().

DeleteJunction()

void SCH_EDIT_FRAME::DeleteJunction	(	SCH_ITEM *	aItem,
		bool	aAppend = false
	)

Removes a given junction and heals any wire segments under the junction.

Parameters

aItem	The junction to delete
aAppend	True if we are updating an ongoing commit

Note that std::list or similar is required here as we may insert values in the loop below. This will invalidate iterators in a std::vector or std::deque

Definition at line 374 of file bus-wire-junction.cpp.

{
 SCH_SCREEN* screen = GetScreen();
 PICKED_ITEMS_LIST undoList;
 EE_SELECTION_TOOL* selectionTool = m_toolManager->GetTool<EE_SELECTION_TOOL>();
 
 auto remove_item =
 [&]( SCH_ITEM* aItem ) -> void
 {
 aItem->SetFlags( STRUCT_DELETED );
 undoList.PushItem( ITEM_PICKER( screen, aItem, UNDO_REDO::DELETED ) );
 };
 
 remove_item( aJunction );
 RemoveFromScreen( aJunction, screen );
 
 std::list<SCH_LINE*> lines;
 
 for( SCH_ITEM* item : screen->Items().Overlapping( SCH_LINE_T, aJunction->GetPosition() ) )
 {
 SCH_LINE* line = static_cast<SCH_LINE*>( item );
 
 if( line->IsType( { SCH_ITEM_LOCATE_WIRE_T, SCH_ITEM_LOCATE_BUS_T } )
 && line->IsEndPoint( aJunction->GetPosition() )
 && !( line->GetEditFlags() & STRUCT_DELETED ) )
 {
 lines.push_back( line );
 }
 }
 
 alg::for_all_pairs( lines.begin(), lines.end(),
 [&]( SCH_LINE* firstLine, SCH_LINE* secondLine )
 {
 if( ( firstLine->GetEditFlags() & STRUCT_DELETED )
 || ( secondLine->GetEditFlags() & STRUCT_DELETED )
 || !secondLine->IsParallel( firstLine ) )
 {
 return;
 }
 
 // Remove identical lines
 if( firstLine->IsEndPoint( secondLine->GetStartPoint() )
 && firstLine->IsEndPoint( secondLine->GetEndPoint() ) )
 {
 remove_item( firstLine );
 return;
 }
 
 // Try to merge the remaining lines
 if( SCH_LINE* line = secondLine->MergeOverlap( screen, firstLine, false ) )
 {
 remove_item( firstLine );
 remove_item( secondLine );
 undoList.PushItem( ITEM_PICKER( screen, line, UNDO_REDO::NEWITEM ) );
 AddToScreen( line, screen );
 
 if( line->IsSelected() )
 selectionTool->AddItemToSel( line, true /*quiet mode*/ );
 
 lines.push_back( line );
 }
 } );
 
 SaveCopyInUndoList( undoList, UNDO_REDO::DELETED, aAppend );
 
 for( SCH_LINE* line : lines )
 {
 if( line->GetEditFlags() & STRUCT_DELETED )
 {
 if( line->IsSelected() )
 selectionTool->RemoveItemFromSel( line, true /*quiet mode*/ );
 
 RemoveFromScreen( line, screen );
 }
 }
}

References DELETED, alg::for_all_pairs(), EDA_ITEM::GetEditFlags(), SCH_LINE::GetEndPoint(), EDA_ITEM::GetPosition(), GetScreen(), SCH_LINE::GetStartPoint(), TOOL_MANAGER::GetTool(), SCH_LINE::IsEndPoint(), SCH_LINE::IsType(), SCH_SCREEN::Items(), TOOLS_HOLDER::m_toolManager, SCH_LINE::MergeOverlap(), EE_RTREE::Overlapping(), PICKED_ITEMS_LIST::PushItem(), SCH_BASE_FRAME::RemoveFromScreen(), SCH_LINE_T, and STRUCT_DELETED.

Referenced by SCH_EDIT_TOOL::DoDelete().

Destroy()

bool KIWAY_PLAYER::Destroy ( )

overrideinherited

Our version of Destroy() which is virtual from wxWidgets.

Definition at line 170 of file kiway_player.cpp.

{
 return EDA_BASE_FRAME::Destroy();
}

Referenced by DISPLAY_FOOTPRINTS_FRAME::doCloseWindow(), doCloseWindow(), SIM_PLOT_FRAME::doCloseWindow(), SYMBOL_EDIT_FRAME::doCloseWindow(), SYMBOL_VIEWER_FRAME::doCloseWindow(), GERBVIEW_FRAME::doCloseWindow(), PL_EDITOR_FRAME::doCloseWindow(), FOOTPRINT_VIEWER_FRAME::doCloseWindow(), FIELDS_EDITOR_GRID_TRICKS::doPopupSelection(), FIELDS_GRID_TRICKS::doPopupSelection(), DIALOG_CHANGE_SYMBOLS::launchMatchIdSymbolBrowser(), DIALOG_CHANGE_SYMBOLS::launchNewIdSymbolBrowser(), TEXT_BUTTON_SYMBOL_CHOOSER::OnButtonClick(), TEXT_BUTTON_FP_CHOOSER::OnButtonClick(), EDA_3D_VIEWER_FRAME::OnCloseWindow(), DIALOG_FIELD_PROPERTIES::OnTextValueSelectButtonClick(), SCH_BASE_FRAME::PickSymbolFromLibBrowser(), PCB_BASE_FRAME::SelectFootprintFromLibBrowser(), DIALOG_EXCHANGE_FOOTPRINTS::ViewAndSelectFootprint(), and FOOTPRINT_WIZARD_FRAME::~FOOTPRINT_WIZARD_FRAME().

DismissModal()

void KIWAY_PLAYER::DismissModal ( bool  aRetVal, const wxString &  aResult = wxEmptyString  )

inherited

Definition at line 182 of file kiway_player.cpp.

{
 m_modal_ret_val = aRetVal;
 m_modal_string = aResult;
 
 if( m_modal_loop )
 {
 m_modal_loop->Exit();
 m_modal_loop = nullptr; // this marks it as dismissed.
 }
 
 Show( false );
}

References KIWAY_PLAYER::m_modal_loop, KIWAY_PLAYER::m_modal_ret_val, and KIWAY_PLAYER::m_modal_string.

Referenced by FOOTPRINT_VIEWER_FRAME::AddFootprintToPCB(), SYMBOL_VIEWER_FRAME::doCloseWindow(), FOOTPRINT_VIEWER_FRAME::doCloseWindow(), FOOTPRINT_WIZARD_FRAME::doCloseWindow(), FOOTPRINT_WIZARD_FRAME::ExportSelectedFootprint(), and SYMBOL_VIEWER_FRAME::FinishModal().

DisplayConstraintsMsg()

void EDA_DRAW_FRAME::DisplayConstraintsMsg ( const wxString &  msg )

inherited

Definition at line 572 of file eda_draw_frame.cpp.

{
 SetStatusText( msg, 7 );
}

Referenced by EDIT_TOOL::doMoveSelection(), and DRAWING_TOOL::UpdateStatusBar().

DisplayCurrentSheet()

void SCH_EDIT_FRAME::DisplayCurrentSheet

(

)

Draw the current sheet on the display.

Definition at line 1886 of file sch_edit_frame.cpp.

{
 m_toolManager->RunAction( ACTIONS::cancelInteractive, true );
 m_toolManager->RunAction( EE_ACTIONS::clearSelection, true );
 SCH_SCREEN* screen = GetCurrentSheet().LastScreen();
 
 wxASSERT( screen );
 
 SetScreen( screen );
 
 // update the References
 GetCurrentSheet().UpdateAllScreenReferences();
 SetSheetNumberAndCount();
 
 if( !screen->m_zoomInitialized )
 {
 initScreenZoom();
 }
 else
 {
 // Set zoom to last used in this screen
 GetCanvas()->GetView()->SetScale( GetScreen()->m_LastZoomLevel );
 RedrawScreen( (wxPoint) GetScreen()->m_ScrollCenter, false );
 }
 
 UpdateTitle();
 
 HardRedraw(); // Ensure all items are redrawn (especially the drawing-sheet items)
 
 SCH_EDITOR_CONTROL* editTool = m_toolManager->GetTool<SCH_EDITOR_CONTROL>();
 TOOL_EVENT dummy;
 editTool->UpdateNetHighlighting( dummy );
 
 m_hierarchy->UpdateHierarchySelection();
}

References ACTIONS::cancelInteractive, EE_ACTIONS::clearSelection, dummy(), SCH_BASE_FRAME::GetCanvas(), GetCurrentSheet(), GetScreen(), TOOL_MANAGER::GetTool(), SCH_DRAW_PANEL::GetView(), HardRedraw(), initScreenZoom(), SCH_SHEET_PATH::LastScreen(), m_hierarchy, TOOLS_HOLDER::m_toolManager, SCH_SCREEN::m_zoomInitialized, SCH_BASE_FRAME::RedrawScreen(), TOOL_MANAGER::RunAction(), KIGFX::SCH_VIEW::SetScale(), SetScreen(), SetSheetNumberAndCount(), SCH_SHEET_PATH::UpdateAllScreenReferences(), HIERARCHY_NAVIG_PANEL::UpdateHierarchySelection(), SCH_EDITOR_CONTROL::UpdateNetHighlighting(), and UpdateTitle().

Referenced by SCH_NAVIGATE_TOOL::Back(), SCH_NAVIGATE_TOOL::changeSheet(), SCH_EDITOR_CONTROL::FindNext(), SCH_EDITOR_CONTROL::FindSymbolAndItem(), SCH_NAVIGATE_TOOL::Forward(), DIALOG_ERC::OnERCItemSelected(), OnPageSettingsChange(), PutDataInPreviousState(), SCH_EDITOR_CONTROL::Revert(), and EE_SELECTION_TOOL::SyncSelection().

DisplayGridMsg()

void EDA_DRAW_FRAME::DisplayGridMsg ( )

virtualinherited

Display current grid size in the status bar.

Reimplemented in GERBVIEW_FRAME, PCB_BASE_FRAME, and PL_EDITOR_FRAME.

Definition at line 578 of file eda_draw_frame.cpp.

{
 wxString msg;
 
 msg.Printf( "grid %s", MessageTextFromValue( GetCanvas()->GetGAL()->GetGridSize().x, false ) );
 
 SetStatusText( msg, 4 );
}

References EDA_DRAW_FRAME::GetCanvas(), and UNITS_PROVIDER::MessageTextFromValue().

Referenced by SCH_BASE_FRAME::UpdateStatusBar().

DisplayToolMsg()

void EDA_DRAW_FRAME::DisplayToolMsg ( const wxString &  msg )

overridevirtualinherited

Reimplemented from TOOLS_HOLDER.

Definition at line 566 of file eda_draw_frame.cpp.

{
 SetStatusText( msg, 6 );
}

Referenced by EDIT_TOOL::Duplicate(), and PCB_CONTROL::Paste().

DisplayUnitsMsg()

void EDA_DRAW_FRAME::DisplayUnitsMsg ( )

inherited

Display current unit pane in the status bar.

Definition at line 588 of file eda_draw_frame.cpp.

{
 wxString msg;
 
 switch( GetUserUnits() )
 {
 case EDA_UNITS::INCHES: msg = _( "inches" ); break;
 case EDA_UNITS::MILS: msg = _( "mils" ); break;
 case EDA_UNITS::MILLIMETRES: msg = _( "mm" ); break;
 default: msg = _( "Units" ); break;
 }
 
 SetStatusText( msg, 5 );
}

References _, UNITS_PROVIDER::GetUserUnits(), INCHES, MILLIMETRES, and MILS.

Referenced by EDA_DRAW_FRAME::UpdateGridSelectBox(), SCH_BASE_FRAME::UpdateStatusBar(), and EDA_DRAW_FRAME::UpdateStatusBar().

doAutoSave()

bool SCH_EDIT_FRAME::doAutoSave ( )

overrideprotectedvirtual

Save the schematic files that have been modified and not yet saved.

Returns

true if the auto save was successful otherwise false.

Reimplemented from EDA_BASE_FRAME.

Definition at line 1114 of file eeschema/files-io.cpp.

{
 wxFileName tmpFileName = Schematic().Root().GetFileName();
 wxFileName fn = tmpFileName;
 wxFileName tmp;
 SCH_SCREENS screens( Schematic().Root() );
 
 // Don't run autosave if content has not been modified
 if( !IsContentModified() )
 return true;
 
 bool autoSaveOk = true;
 
 if( fn.GetPath().IsEmpty() )
 tmp.AssignDir( Prj().GetProjectPath() );
 else
 tmp.AssignDir( fn.GetPath() );
 
 if( !tmp.IsOk() )
 return false;
 
 if( !IsWritable( tmp ) )
 return false;
 
 wxString title = GetTitle(); // Save frame title, that can be modified by the save process
 
 for( size_t i = 0; i < screens.GetCount(); i++ )
 {
 // Only create auto save files for the schematics that have been modified.
 if( !screens.GetScreen( i )->IsContentModified() )
 continue;
 
 tmpFileName = fn = screens.GetScreen( i )->GetFileName();
 
 // Auto save file name is the normal file name prefixed with GetAutoSavePrefix().
 fn.SetName( GetAutoSaveFilePrefix() + fn.GetName() );
 
 if( saveSchematicFile( screens.GetSheet( i ), fn.GetFullPath() ) )
 screens.GetScreen( i )->SetContentModified();
 else
 autoSaveOk = false;
 }
 
 if( autoSaveOk && updateAutoSaveFile() )
 {
 m_autoSaveState = false;
 
 if( !Kiface().IsSingle() &&
 GetSettingsManager()->GetCommonSettings()->m_Backup.backup_on_autosave )
 {
 GetSettingsManager()->TriggerBackupIfNeeded( NULL_REPORTER::GetInstance() );
 }
 }
 
 SetTitle( title );
 
 return autoSaveOk;
}

References EDA_BASE_FRAME::GetAutoSaveFilePrefix(), SCH_SCREENS::GetCount(), SCH_SCREEN::GetFileName(), SCH_SHEET::GetFileName(), NULL_REPORTER::GetInstance(), SCH_SCREENS::GetScreen(), EDA_BASE_FRAME::GetSettingsManager(), SCH_SCREENS::GetSheet(), BASE_SCREEN::IsContentModified(), IsContentModified(), EDA_BASE_FRAME::IsWritable(), Kiface(), EDA_BASE_FRAME::m_autoSaveState, KIWAY_HOLDER::Prj(), SCHEMATIC::Root(), saveSchematicFile(), Schematic(), BASE_SCREEN::SetContentModified(), SETTINGS_MANAGER::TriggerBackupIfNeeded(), and updateAutoSaveFile().

doCloseWindow()

void SCH_EDIT_FRAME::doCloseWindow ( )

overrideprivatevirtual

Reimplemented from EDA_BASE_FRAME.

Definition at line 822 of file sch_edit_frame.cpp.

{
 SCH_SHEET_LIST sheetlist = Schematic().GetSheets();
 
 // Shutdown all running tools
 if( m_toolManager )
 m_toolManager->ShutdownAllTools();
 
 RecordERCExclusions();
 
 // Close the find dialog and preserve its setting if it is displayed.
 if( m_findReplaceDialog )
 {
 m_findStringHistoryList = m_findReplaceDialog->GetFindEntries();
 m_replaceStringHistoryList = m_findReplaceDialog->GetReplaceEntries();
 
 m_findReplaceDialog->Destroy();
 m_findReplaceDialog = nullptr;
 }
 
 wxAuiPaneInfo& hierarchy_pane = m_auimgr.GetPane( SchematicHierarchyPaneName() );
 
 if( hierarchy_pane.IsShown() && hierarchy_pane.IsFloating() )
 {
 hierarchy_pane.Show( false );
 m_auimgr.Update();
 }
 
 if( Kiway().Player( FRAME_SIMULATOR, false ) )
 Prj().GetProjectFile().m_SchematicSettings->m_NgspiceSimulatorSettings->SaveToFile();
 
 SCH_SCREENS screens( Schematic().Root() );
 wxFileName fn;
 
 for( SCH_SCREEN* screen = screens.GetFirst(); screen != nullptr; screen = screens.GetNext() )
 {
 fn = Prj().AbsolutePath( screen->GetFileName() );
 
 // Auto save file name is the normal file name prepended with GetAutoSaveFilePrefix().
 fn.SetName( GetAutoSaveFilePrefix() + fn.GetName() );
 
 if( fn.IsFileWritable() )
 wxRemoveFile( fn.GetFullPath() );
 }
 
 wxFileName tmpFn = Prj().GetProjectFullName();
 wxFileName autoSaveFileName( tmpFn.GetPath(), getAutoSaveFileName() );
 
 if( autoSaveFileName.IsFileWritable() )
 wxRemoveFile( autoSaveFileName.GetFullPath() );
 
 sheetlist.ClearModifyStatus();
 
 wxString fileName = Prj().AbsolutePath( Schematic().RootScreen()->GetFileName() );
 
 if( !Schematic().GetFileName().IsEmpty() && !Schematic().RootScreen()->IsEmpty() )
 UpdateFileHistory( fileName );
 
 // Make sure local settings are persisted
 SaveProjectSettings();
 
 Schematic().RootScreen()->Clear();
 
 // all sub sheets are deleted, only the main sheet is usable
 GetCurrentSheet().clear();
 
 // Clear view before destroying schematic as repaints depend on schematic being valid
 SetScreen( nullptr );
 
 Schematic().Reset();
 
 Destroy();
}

References PROJECT::AbsolutePath(), SCH_SHEET_PATH::clear(), SCH_SCREEN::Clear(), SCH_SHEET_LIST::ClearModifyStatus(), KIWAY_PLAYER::Destroy(), FRAME_SIMULATOR, getAutoSaveFileName(), EDA_BASE_FRAME::GetAutoSaveFilePrefix(), GetCurrentSheet(), DIALOG_SCH_FIND::GetFindEntries(), SCH_SCREENS::GetFirst(), SCH_SCREENS::GetNext(), PROJECT::GetProjectFile(), PROJECT::GetProjectFullName(), DIALOG_SCH_FIND::GetReplaceEntries(), SCHEMATIC::GetSheets(), KIWAY_HOLDER::Kiway(), EDA_BASE_FRAME::m_auimgr, m_findReplaceDialog, EDA_DRAW_FRAME::m_findStringHistoryList, SCHEMATIC_SETTINGS::m_NgspiceSimulatorSettings, EDA_DRAW_FRAME::m_replaceStringHistoryList, PROJECT_FILE::m_SchematicSettings, TOOLS_HOLDER::m_toolManager, KIWAY_HOLDER::Prj(), RecordERCExclusions(), SCHEMATIC::Reset(), SCHEMATIC::RootScreen(), SaveProjectSettings(), Schematic(), SchematicHierarchyPaneName(), SetScreen(), TOOL_MANAGER::ShutdownAllTools(), and EDA_BASE_FRAME::UpdateFileHistory().

DoWithAcceptedFiles()

void EDA_BASE_FRAME::DoWithAcceptedFiles ( )

protectedvirtualinherited

Execute action on accepted dropped file.

Called in OnDropFiles and should be populated with the action to execute in inherited classes.

Reimplemented in GERBVIEW_FRAME, KICAD_MANAGER_FRAME, and PL_EDITOR_FRAME.

Definition at line 1138 of file eda_base_frame.cpp.

{
 for( const wxFileName& file : m_AcceptedFiles )
 {
 wxString fn = file.GetFullPath();
 m_toolManager->RunAction( *m_acceptedExts.at( file.GetExt() ), true, &fn );
 }
}

References EDA_BASE_FRAME::m_acceptedExts, EDA_BASE_FRAME::m_AcceptedFiles, TOOLS_HOLDER::m_toolManager, and TOOL_MANAGER::RunAction().

Referenced by EDA_BASE_FRAME::OnDropFiles().

DrawCurrentSheetToClipboard()

void SCH_EDIT_FRAME::DrawCurrentSheetToClipboard

(

)

Use the wxWidgets print code to draw an image of the current sheet onto the clipboard.

Definition at line 477 of file sheet.cpp.

{
 wxRect DrawArea;
 BASE_SCREEN* screen = GetScreen();
 
 DrawArea.SetSize( GetPageSizeIU() );
 
 // Calculate a reasonable dc size, in pixels, and the dc scale to fit
 // the drawings into the dc size
 // scale is the ratio resolution (in PPI) / internal units
 double ppi = 300; // Use 300 pixels per inch to create bitmap images on start
 double inch2Iu = 1000.0 * schIUScale.IU_PER_MILS;
 double scale = ppi / inch2Iu;
 
 wxSize dcsize = DrawArea.GetSize();
 
 int maxdim = std::max( dcsize.x, dcsize.y );
 
 // the max size in pixels of the bitmap used to build the sheet copy
 const int maxbitmapsize = 5600;
 
 while( int( maxdim * scale ) > maxbitmapsize )
 {
 ppi = ppi / 1.5;
 scale = ppi / inch2Iu;
 }
 
 dcsize.x *= scale;
 dcsize.y *= scale;
 
 // Set draw offset, zoom... to values needed to draw in the memory DC
 // after saving initial values:
 VECTOR2I tmp_startvisu = screen->m_StartVisu;
 VECTOR2I old_org = screen->m_DrawOrg;
 screen->m_DrawOrg.x = screen->m_DrawOrg.y = 0;
 screen->m_StartVisu.x = screen->m_StartVisu.y = 0;
 
 wxMemoryDC dc;
 wxBitmap image( dcsize );
 dc.SelectObject( image );
 dc.Clear();
 
 GRResetPenAndBrush( &dc );
 GRForceBlackPen( false );
 dc.SetUserScale( scale, scale );
 
 GetRenderSettings()->SetPrintDC( &dc );
 // Init the color of the layer actually used to print the drawing sheet:
 GetRenderSettings()->SetLayerColor( LAYER_DRAWINGSHEET,
 GetRenderSettings()->GetLayerColor( LAYER_SCHEMATIC_DRAWINGSHEET ) );
 
 PrintPage( GetRenderSettings() );
 
 {
 wxLogNull doNotLog; // disable logging of failed clipboard actions
 
 if( wxTheClipboard->Open() )
 {
 // This data objects are held by the clipboard, so do not delete them in the app.
 wxBitmapDataObject* clipbrd_data = new wxBitmapDataObject( image );
 wxTheClipboard->SetData( clipbrd_data );
 wxTheClipboard->Flush(); // Allow data to be available after closing KiCad
 wxTheClipboard->Close();
 }
 }
 
 // Deselect Bitmap from DC in order to delete the MemoryDC
 dc.SelectObject( wxNullBitmap );
 
 GRForceBlackPen( false );
 
 screen->m_StartVisu = tmp_startvisu;
 screen->m_DrawOrg = old_org;
}

References SCH_BASE_FRAME::GetLayerColor(), SCH_BASE_FRAME::GetPageSizeIU(), SCH_BASE_FRAME::GetRenderSettings(), GetScreen(), GRForceBlackPen(), GRResetPenAndBrush(), image, EDA_IU_SCALE::IU_PER_MILS, LAYER_DRAWINGSHEET, LAYER_SCHEMATIC_DRAWINGSHEET, BASE_SCREEN::m_DrawOrg, BASE_SCREEN::m_StartVisu, PrintPage(), scale, schIUScale, KIGFX::RENDER_SETTINGS::SetLayerColor(), KIGFX::RENDER_SETTINGS::SetPrintDC(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by SCH_EDITOR_CONTROL::DrawSheetOnClipboard().

EditSheetProperties()

bool SCH_EDIT_FRAME::EditSheetProperties	(	SCH_SHEET *	aSheet,
		SCH_SHEET_PATH *	aHierarchy,
		bool *	aClearAnnotationNewItems
	)

Edit an existing sheet or add a new sheet to the schematic.

When aSheet is a new sheet:

• and the file name already exists in the schematic hierarchy, the screen associated with the sheet found in the hierarchy is associated with aSheet.
• and the file name already exists on the system, then aSheet is loaded with the existing file.
• and the file name does not exist in the schematic hierarchy or on the file system, then a new screen is created and associated with aSheet.

When aSheet is an existing sheet:

• and the file name already exists in the schematic hierarchy, the current associated screen is replace by the one found in the hierarchy.
• and the file name already exists on the system, the current associated screen file name is changed and the file is loaded.
• and the file name does not exist in the schematic hierarchy or on the file system, the current associated screen file name is changed and saved to disk.

Note: the screen is not refresh. The caller is responsible to do that

Parameters

aSheet	is the sheet to edit
aHierarchy	is the current hierarchy containing aSheet
aClearAnnotationNewItems	is a reference to a bool to know if the items managed by this sheet need to have their annotation cleared i.e. when an existing item list is used. it can happens when the edited sheet used an existing file, or becomes a new instance of a already existing sheet.

Definition at line 461 of file sheet.cpp.

{
 if( aSheet == nullptr || aHierarchy == nullptr )
 return false;
 
 // Get the new texts
 DIALOG_SHEET_PROPERTIES dlg( this, aSheet, aClearAnnotationNewItems );
 
 if( dlg.ShowModal() == wxID_CANCEL )
 return false;
 
 return true;
}

Referenced by SCH_DRAWING_TOOLS::DrawSheet(), and SCH_EDIT_TOOL::Properties().

eeconfig()

EESCHEMA_SETTINGS * SCH_BASE_FRAME::eeconfig ( ) const

inherited

Definition at line 131 of file sch_base_frame.cpp.

{
 return dynamic_cast<EESCHEMA_SETTINGS*>( config() );
}

References EDA_BASE_FRAME::config().

Referenced by SYMBOL_EDITOR_CONTROL::AddSymbolToSchematic(), AllowCaseSensitiveFileNameClashes(), EE_SELECTION_TOOL::autostartEvent(), SCH_EDITOR_CONTROL::ChangeLineMode(), EE_SELECTION_TOOL::CollectHits(), DIALOG_BOM::DIALOG_BOM(), SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), SCH_DRAWING_TOOLS::DrawSheet(), SCH_EDIT_TOOL::editFieldText(), ExecuteRemoteCommand(), SCH_EDITOR_CONTROL::FindSymbolAndItem(), GetSchematicJunctionSize(), GetShowAllPins(), EE_SELECTION_TOOL::GuessSelectionCandidates(), DIALOG_BOM::installGeneratorsList(), KiwayMailIn(), SCH_EDITOR_CONDITIONS::lineModeFunc(), LoadSettings(), EE_SELECTION_TOOL::Main(), SCH_EDITOR_CONTROL::NextLineMode(), DIALOG_SHAPE_PROPERTIES::onBorderChecked(), DIALOG_TEXT_PROPERTIES::onBorderChecked(), DIALOG_PRINT_USING_PRINTER::OnMonochromeChecked(), OpenProjectFiles(), SCH_EDITOR_CONTROL::Paste(), SCH_DRAWING_TOOLS::PlaceSymbol(), SCH_PRINTOUT::PrintPage(), DIALOG_CHANGE_SYMBOLS::processSymbol(), SCH_EDIT_TOOL::Properties(), SCH_EDIT_TOOL::RepeatDrawItem(), SCH_EDIT_TOOL::Rotate(), DIALOG_PRINT_USING_PRINTER::SavePrintOptions(), SaveSettings(), EE_SELECTION_TOOL::Selectable(), SelectUnit(), setupUIConditions(), SCH_LINE_WIRE_BUS_TOOL::startSegments(), EE_SELECTION_TOOL::SyncSelection(), SCH_EDITOR_CONTROL::ToggleAnnotateAuto(), SCH_EDITOR_CONTROL::ToggleAnnotateRecursive(), SCH_EDITOR_CONTROL::ToggleERCErrors(), SCH_EDITOR_CONTROL::ToggleERCExclusions(), SCH_EDITOR_CONTROL::ToggleERCWarnings(), SCH_EDITOR_CONTROL::ToggleHiddenFields(), SCH_EDITOR_CONTROL::ToggleHiddenPins(), ToggleSchematicHierarchy(), DIALOG_PRINT_USING_PRINTER::TransferDataToWindow(), and DIALOG_BOM::~DIALOG_BOM().

ensureWindowIsOnScreen()

void EDA_BASE_FRAME::ensureWindowIsOnScreen ( )

protectedinherited

Definition at line 640 of file eda_base_frame.cpp.

{
 wxDisplay display( wxDisplay::GetFromWindow( this ) );
 wxRect clientSize = display.GetClientArea();
 wxPoint pos = GetPosition();
 wxSize size = GetWindowSize();
 
 wxLogTrace( traceDisplayLocation,
 "ensureWindowIsOnScreen: clientArea (%d, %d) w %d h %d", clientSize.x, clientSize.y,
 clientSize.width, clientSize.height );
 
 if( pos.y < clientSize.y )
 {
 wxLogTrace( traceDisplayLocation,
 "ensureWindowIsOnScreen: y pos %d below minimum, setting to %d", pos.y,
 clientSize.y );
 pos.y = clientSize.y;
 }
 
 if( pos.x < clientSize.x )
 {
 wxLogTrace( traceDisplayLocation,
 "ensureWindowIsOnScreen: x pos %d is off the client rect, setting to %d", pos.x,
 clientSize.x );
 pos.x = clientSize.x;
 }
 
 if( pos.x + size.x - clientSize.x > clientSize.width )
 {
 int newWidth = clientSize.width - ( pos.x - clientSize.x );
 wxLogTrace( traceDisplayLocation,
 "ensureWindowIsOnScreen: effective width %d above available %d, setting to %d",
 pos.x + size.x, clientSize.width, newWidth );
 size.x = newWidth;
 }
 
 if( pos.y + size.y - clientSize.y > clientSize.height )
 {
 int newHeight = clientSize.height - ( pos.y - clientSize.y );
 wxLogTrace( traceDisplayLocation,
 "ensureWindowIsOnScreen: effective height %d above available %d, setting to %d",
 pos.y + size.y, clientSize.height, newHeight );
 size.y = newHeight;
 }
 
 wxLogTrace( traceDisplayLocation, "Updating window position (%d, %d) with size (%d, %d)",
 pos.x, pos.y, size.x, size.y );
 
 SetSize( pos.x, pos.y, size.x, size.y );
}

References EDA_BASE_FRAME::GetWindowSize(), and traceDisplayLocation.

Referenced by EDA_BASE_FRAME::OnSize().

EraseMsgBox()

void EDA_DRAW_FRAME::EraseMsgBox ( )

inherited

Definition at line 328 of file eda_draw_frame.cpp.

{
 if( m_messagePanel )
 m_messagePanel->EraseMsgBox();
}

References EDA_MSG_PANEL::EraseMsgBox(), and EDA_DRAW_FRAME::m_messagePanel.

Referenced by GERBVIEW_CONTROL::UpdateMessagePanel().

ExecuteRemoteCommand()

void SCH_EDIT_FRAME::ExecuteRemoteCommand ( const char *  cmdline )

overridevirtual

Execute a remote command sent by Pcbnew via a socket connection.

When user selects a footprint or pin in Pcbnew, Eeschema shows that same symbol or pin and moves cursor on the item. The socket port used is KICAD_SCH_PORT_SERVICE_NUMBER which defaults to 4243.

Valid commands are:

• $PART: "reference" Put cursor on symbol.
• $PART: "reference" $REF: "ref" Put cursor on symbol reference.
• $PART: "reference" $VAL: "value" Put cursor on symbol value.
• $PART: "reference" $PAD: "pin name" Put cursor on the symbol pin.
• $NET: "netname" Highlight a specified net
• $CLEAR: "HIGHLIGHTED" Clear symbols highlight

They are a keyword followed by a quoted string.

Parameters

cmdline

is the command received from Pcbnew.

Reimplemented from KIWAY_PLAYER.

Definition at line 186 of file eeschema/cross-probing.cpp.

{
 SCH_EDITOR_CONTROL* editor = m_toolManager->GetTool<SCH_EDITOR_CONTROL>();
 char line[1024];
 
 strncpy( line, cmdline, sizeof( line ) - 1 );
 line[ sizeof( line ) - 1 ] = '\0';
 
 char* idcmd = strtok( line, " \n\r" );
 char* text = strtok( nullptr, "\"\n\r" );
 
 if( idcmd == nullptr )
 return;
 
 CROSS_PROBING_SETTINGS& crossProbingSettings = eeconfig()->m_CrossProbing;
 
 if( strcmp( idcmd, "$NET:" ) == 0 )
 {
 if( !crossProbingSettings.auto_highlight )
 return;
 
 wxString netName = FROM_UTF8( text );
 
 if( auto sg = Schematic().ConnectionGraph()->FindFirstSubgraphByName( netName ) )
 m_highlightedConn = sg->m_driver_connection;
 else
 m_highlightedConn = nullptr;
 
 GetToolManager()->RunAction( EE_ACTIONS::updateNetHighlighting, true );
 
 SetStatusText( _( "Selected net:" ) + wxS( " " ) + UnescapeString( netName ) );
 return;
 }
 
 if( strcmp( idcmd, "$CLEAR:" ) == 0 )
 {
 // Cross-probing is now done through selection so we no longer need a clear command
 return;
 }
 
 if( !crossProbingSettings.on_selection )
 return;
 
 if( text == nullptr )
 return;
 
 if( strcmp( idcmd, "$PART:" ) != 0 )
 return;
 
 wxString part_ref = FROM_UTF8( text );
 
 /* look for a complement */
 idcmd = strtok( nullptr, " \n\r" );
 
 if( idcmd == nullptr ) // Highlight symbol only (from CvPcb or Pcbnew)
 {
 // Highlight symbol part_ref, or clear Highlight, if part_ref is not existing
 editor->FindSymbolAndItem( nullptr, &part_ref, true, HIGHLIGHT_SYMBOL, wxEmptyString );
 return;
 }
 
 text = strtok( nullptr, "\"\n\r" );
 
 if( text == nullptr )
 return;
 
 wxString msg = FROM_UTF8( text );
 
 if( strcmp( idcmd, "$REF:" ) == 0 )
 {
 // Highlighting the reference itself isn't actually that useful, and it's harder to
 // see. Highlight the parent and display the message.
 editor->FindSymbolAndItem( nullptr, &part_ref, true, HIGHLIGHT_SYMBOL, msg );
 }
 else if( strcmp( idcmd, "$VAL:" ) == 0 )
 {
 // Highlighting the value itself isn't actually that useful, and it's harder to see.
 // Highlight the parent and display the message.
 editor->FindSymbolAndItem( nullptr, &part_ref, true, HIGHLIGHT_SYMBOL, msg );
 }
 else if( strcmp( idcmd, "$PAD:" ) == 0 )
 {
 editor->FindSymbolAndItem( nullptr, &part_ref, true, HIGHLIGHT_PIN, msg );
 }
 else
 {
 editor->FindSymbolAndItem( nullptr, &part_ref, true, HIGHLIGHT_SYMBOL, wxEmptyString );
 }
}

References _, CROSS_PROBING_SETTINGS::auto_highlight, editor, SCH_BASE_FRAME::eeconfig(), FROM_UTF8(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::GetToolManager(), HIGHLIGHT_PIN, HIGHLIGHT_SYMBOL, APP_SETTINGS_BASE::m_CrossProbing, m_highlightedConn, TOOLS_HOLDER::m_toolManager, CROSS_PROBING_SETTINGS::on_selection, TOOL_MANAGER::RunAction(), Schematic(), text, UnescapeString(), and EE_ACTIONS::updateNetHighlighting.

Referenced by KiwayMailIn().

findDialogs()

std::vector< wxWindow * > EDA_DRAW_FRAME::findDialogs ( )

protectedinherited

Definition at line 898 of file eda_draw_frame.cpp.

{
 std::vector<wxWindow*> dialogs;
 
 for( wxWindow* window : GetChildren() )
 {
 if( dynamic_cast<DIALOG_SHIM*>( window ) )
 dialogs.push_back( window );
 }
 
 return dialogs;
}

Referenced by PCB_BASE_FRAME::FocusOnItems(), and EDA_DRAW_FRAME::FocusOnLocation().

findQuasiModalDialog()

wxWindow * EDA_BASE_FRAME::findQuasiModalDialog ( )

privateinherited

Definition at line 168 of file eda_base_frame.cpp.

{
 for( wxWindow* iter : GetChildren() )
 {
 DIALOG_SHIM* dlg = dynamic_cast<DIALOG_SHIM*>( iter );
 
 if( dlg && dlg->IsQuasiModal() )
 return dlg;
 }
 
 // FIXME: CvPcb is currently implemented on top of KIWAY_PLAYER rather than DIALOG_SHIM,
 // so we have to look for it separately.
 if( m_ident == FRAME_SCH )
 {
 wxWindow* cvpcb = wxWindow::FindWindowByName( "CvpcbFrame" );
 
 if( cvpcb )
 return cvpcb;
 }
 
 return nullptr;
}

References FRAME_SCH, DIALOG_SHIM::IsQuasiModal(), and EDA_BASE_FRAME::m_ident.

Referenced by EDA_BASE_FRAME::ProcessEvent(), and EDA_BASE_FRAME::windowClosing().

FinishAUIInitialization()

void EDA_BASE_FRAME::FinishAUIInitialization ( )

inherited

Definition at line 825 of file eda_base_frame.cpp.

{
#if defined( __WXOSX_MAC__ )
 m_auimgr.Update();
#else
 // Call Update() to fix all pane default sizes, especially the "InfoBar" pane before
 // hiding it.
 m_auimgr.Update();
 
 // We don't want the infobar displayed right away
 m_auimgr.GetPane( "InfoBar" ).Hide();
 m_auimgr.Update();
#endif
}

References EDA_BASE_FRAME::m_auimgr.

FixupJunctions()

void SCH_EDIT_FRAME::FixupJunctions

(

)

Definition at line 1726 of file sch_edit_frame.cpp.

{
 // Save the current sheet, to retrieve it later
 SCH_SHEET_PATH oldsheetpath = GetCurrentSheet();
 
 SCH_SHEET_LIST sheetList = Schematic().GetSheets();
 
 for( const SCH_SHEET_PATH& sheet : sheetList )
 {
 size_t num_undos = m_undoList.m_CommandsList.size();
 
 // We require a set here to avoid adding multiple junctions to the same spot
 std::set<wxPoint> junctions;
 
 SetCurrentSheet( sheet );
 GetCurrentSheet().UpdateAllScreenReferences();
 
 SCH_SCREEN* screen = GetCurrentSheet().LastScreen();
 
 EE_SELECTION allItems;
 
 for( auto item : screen->Items() )
 allItems.Add( item );
 
 m_toolManager->RunAction( EE_ACTIONS::addNeededJunctions, true, &allItems );
 
 // Check if we modified anything during this routine
 // Needs to happen for every sheet to set the proper modified flag
 if( m_undoList.m_CommandsList.size() > num_undos )
 OnModify();
 }
 
 // Reselect the initial sheet:
 SetCurrentSheet( oldsheetpath );
 GetCurrentSheet().UpdateAllScreenReferences();
 SetScreen( GetCurrentSheet().LastScreen() );
}

References SELECTION::Add(), EE_ACTIONS::addNeededJunctions, GetCurrentSheet(), SCHEMATIC::GetSheets(), SCH_SCREEN::Items(), SCH_SHEET_PATH::LastScreen(), UNDO_REDO_CONTAINER::m_CommandsList, TOOLS_HOLDER::m_toolManager, EDA_BASE_FRAME::m_undoList, OnModify(), TOOL_MANAGER::RunAction(), Schematic(), SetCurrentSheet(), SetScreen(), and SCH_SHEET_PATH::UpdateAllScreenReferences().

Referenced by importFile(), and OpenProjectFiles().

FocusOnItem()

void SCH_EDIT_FRAME::FocusOnItem

(

SCH_ITEM *

aItem

)

Definition at line 1778 of file sch_edit_frame.cpp.

{
 static KIID lastBrightenedItemID( niluuid );
 
 SCH_SHEET_LIST sheetList = Schematic().GetSheets();
 SCH_SHEET_PATH dummy;
 SCH_ITEM* lastItem = sheetList.GetItem( lastBrightenedItemID, &dummy );
 
 if( lastItem && lastItem != aItem )
 {
 lastItem->ClearBrightened();
 
 UpdateItem( lastItem );
 lastBrightenedItemID = niluuid;
 }
 
 if( aItem )
 {
 if( !aItem->IsBrightened() )
 {
 aItem->SetBrightened();
 
 UpdateItem( aItem );
 lastBrightenedItemID = aItem->m_Uuid;
 }
 
 FocusOnLocation( aItem->GetFocusPosition() );
 }
}

References EDA_ITEM::ClearBrightened(), dummy(), EDA_DRAW_FRAME::FocusOnLocation(), EDA_ITEM::GetFocusPosition(), SCH_SHEET_LIST::GetItem(), SCHEMATIC::GetSheets(), EDA_ITEM::IsBrightened(), EDA_ITEM::m_Uuid, niluuid, Schematic(), EDA_ITEM::SetBrightened(), and UpdateItem().

Referenced by SCH_EDITOR_CONTROL::FindSymbolAndItem(), HardRedraw(), DIALOG_ERC::OnCancelClick(), DIALOG_ERC::OnCloseErcDialog(), DIALOG_ERC::OnERCItemSelected(), SetCurrentSheet(), and EE_SELECTION_TOOL::SyncSelection().

FocusOnLocation()

void EDA_DRAW_FRAME::FocusOnLocation ( const VECTOR2I &  aPos )

inherited

Useful to focus on a particular location, in find functions.

Move the graphic cursor (crosshair cursor) at a given coordinate and reframes the drawing if the requested point is out of view or if center on location is requested.

Parameters

aPos	is the point to go to.

Definition at line 912 of file eda_draw_frame.cpp.

{
 bool centerView = false;
 BOX2D r = GetCanvas()->GetView()->GetViewport();
 
 // Center if we're off the current view, or within 10% of its edge
 r.Inflate( - (int) r.GetWidth() / 10 );
 
 if( !r.Contains( aPos ) )
 centerView = true;
 
 std::vector<BOX2D> dialogScreenRects;
 
 for( wxWindow* dialog : findDialogs() )
 {
 dialogScreenRects.emplace_back( GetCanvas()->ScreenToClient( dialog->GetScreenPosition() ),
 dialog->GetSize() );
 }
 
 // Center if we're behind an obscuring dialog, or within 10% of its edge
 for( BOX2D rect : dialogScreenRects )
 {
 rect.Inflate( rect.GetWidth() / 10 );
 
 if( rect.Contains( GetCanvas()->GetView()->ToScreen( aPos ) ) )
 centerView = true;
 }
 
 if( centerView )
 {
 try
 {
 GetCanvas()->GetView()->SetCenter( aPos, dialogScreenRects );
 }
 catch( const ClipperLib::clipperException& exc )
 {
 wxLogError( wxT( "Clipper library error '%s' occurred centering object." ),
 exc.what() );
 }
 }
 
 GetCanvas()->GetViewControls()->SetCrossHairCursorPosition( aPos );
}

References EDA_DRAW_FRAME::findDialogs(), EDA_DRAW_FRAME::GetCanvas(), EDA_DRAW_PANEL_GAL::GetView(), EDA_DRAW_PANEL_GAL::GetViewControls(), KIGFX::VIEW::GetViewport(), r, KIGFX::VIEW::SetCenter(), and KIGFX::VIEW_CONTROLS::SetCrossHairCursorPosition().

Referenced by PCB_SELECTION_TOOL::doSyncSelection(), PCB_EDIT_FRAME::ExecuteRemoteCommand(), PCB_SELECTION_TOOL::FindItem(), SCH_EDITOR_CONTROL::FindNext(), FocusOnItem(), PCB_BASE_FRAME::FocusOnItems(), DIALOG_DRC::OnDRCItemSelected(), and EE_SELECTION_TOOL::SyncSelection().

GetAboutTitle()

const wxString & EDA_BASE_FRAME::GetAboutTitle ( ) const

inlineinherited

Definition at line 497 of file eda_base_frame.h.

{ return m_aboutTitle; }

References EDA_BASE_FRAME::m_aboutTitle.

Referenced by DIALOG_ABOUT::DIALOG_ABOUT(), PGM_SINGLE_TOP::OnPgmInit(), and COMMON_CONTROL::ReportBug().

getAutoSaveFileName()

const wxString & SCH_EDIT_FRAME::getAutoSaveFileName ( ) const

private

Definition at line 1502 of file eeschema/files-io.cpp.

{
 static wxString autoSaveFileName( wxT( "#auto_saved_files#" ) );
 
 return autoSaveFileName;
}

Referenced by doCloseWindow(), OpenProjectFiles(), and updateAutoSaveFile().

GetAutoSaveFilePrefix()

static wxString EDA_BASE_FRAME::GetAutoSaveFilePrefix ( )

inlinestaticprotectedinherited

Returns

the string to prepend to a file name for automatic save.

Definition at line 585 of file eda_base_frame.h.

 {
 return wxT( "_autosave-" );
 }

Referenced by EDA_BASE_FRAME::CheckForAutoSaveFile(), CheckForAutoSaveFile(), doAutoSave(), PCB_EDIT_FRAME::doAutoSave(), doCloseWindow(), PCB_EDIT_FRAME::doCloseWindow(), PCB_EDIT_FRAME::Files_io_from_id(), PCB_EDIT_FRAME::OnExportSTEP(), PCB_EDIT_FRAME::SavePcbFile(), saveSchematicFile(), and updateAutoSaveFile().

GetAutoSaveInterval()

int EDA_BASE_FRAME::GetAutoSaveInterval ( ) const

inherited

Definition at line 297 of file eda_base_frame.cpp.

{
 return Pgm().GetCommonSettings()->m_System.autosave_interval;
}

References Pgm().

Referenced by EDA_DRAW_FRAME::CommonSettingsChanged(), EDA_BASE_FRAME::onAutoSaveTimer(), and EDA_BASE_FRAME::ProcessEvent().

GetCanvas()

SCH_DRAW_PANEL * SCH_BASE_FRAME::GetCanvas ( ) const

overridevirtualinherited

Return a pointer to GAL-based canvas of given EDA draw frame.

Returns

Pointer to GAL-based canvas.

Reimplemented from EDA_DRAW_FRAME.

Definition at line 320 of file sch_base_frame.cpp.

{
 return static_cast<SCH_DRAW_PANEL*>( EDA_DRAW_FRAME::GetCanvas() );
}

References EDA_DRAW_FRAME::GetCanvas().

Referenced by SCH_BASE_FRAME::ActivateGalCanvas(), AddItemToScreenAndUndoList(), AddJunction(), SCH_BASE_FRAME::AddToScreen(), AnnotateSymbols(), SCH_EDITOR_CONTROL::AssignFootprints(), SCH_EDITOR_CONTROL::AssignNetclass(), SCH_EDIT_TOOL::BreakWire(), SCH_NAVIGATE_TOOL::changeSheet(), SYMBOL_VIEWER_FRAME::ClickOnSymbolList(), SCH_BASE_FRAME::CommonSettingsChanged(), CommonSettingsChanged(), SYMBOL_EDIT_FRAME::CommonSettingsChanged(), SYMBOL_VIEWER_FRAME::CommonSettingsChanged(), DIALOG_CHOOSE_SYMBOL::ConstructRightPanel(), DeleteAnnotation(), DisplayCurrentSheet(), SYMBOL_VIEWER_FRAME::doCloseWindow(), SCH_EDIT_TOOL::DoDelete(), SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), SCH_DRAWING_TOOLS::DrawShape(), SYMBOL_EDITOR_DRAWING_TOOLS::DrawShape(), SCH_DRAWING_TOOLS::DrawSheet(), SYMBOL_EDITOR_EDIT_TOOL::editFieldProperties(), SYMBOL_EDITOR_EDIT_TOOL::editShapeProperties(), SYMBOL_EDITOR_EDIT_TOOL::editTextBoxProperties(), SYMBOL_EDITOR_EDIT_TOOL::editTextProperties(), EE_INSPECTION_TOOL::ExcludeMarker(), DIALOG_ERC::ExcludeMarker(), SCH_EDITOR_CONTROL::FindNext(), SCH_EDITOR_CONTROL::FindSymbolAndItem(), GetDocumentExtents(), SCH_BASE_FRAME::GetRenderSettings(), SCH_BASE_FRAME::HardRedraw(), HardRedraw(), SCH_EDITOR_CONTROL::ImportFPAssignments(), SCH_EDIT_TOOL::Init(), KiwayMailIn(), EE_POINT_EDITOR::Main(), EE_SELECTION_TOOL::Main(), SCH_MOVE_TOOL::Main(), SYMBOL_EDITOR_MOVE_TOOL::Main(), DIALOG_MIGRATE_BUSES::onAcceptClicked(), DIALOG_ANNOTATE::OnApplyClick(), DIALOG_ERC::OnERCItemRClick(), EE_SELECTION_TOOL::OnIdle(), DIALOG_MIGRATE_BUSES::onItemSelected(), OnModify(), OnPageSettingsChange(), DIALOG_SYMBOL_REMAP::OnRemapSymbols(), DIALOG_UPDATE_FROM_PCB::OnUpdateClick(), SYMBOL_TREE_PANE::onUpdateUI(), SCH_EDITOR_CONTROL::PageSetup(), SYMBOL_EDITOR_DRAWING_TOOLS::PlaceAnchor(), SCH_DRAWING_TOOLS::PlaceImage(), SCH_DRAWING_TOOLS::PlaceSymbol(), DIALOG_CHANGE_SYMBOLS::processSymbol(), SCH_EDIT_TOOL::Properties(), PutDataInPreviousState(), SYMBOL_EDIT_FRAME::RebuildView(), RecalculateConnections(), RecomputeIntersheetRefs(), SYMBOL_VIEWER_FRAME::ReCreateLibList(), SCH_EDITOR_CONTROL::Redo(), DIALOG_ERC::redrawDrawPanel(), SCH_BASE_FRAME::RedrawScreen(), SCH_BASE_FRAME::RefreshZoomDependentItems(), SCH_EDITOR_CONTROL::RemapSymbols(), SCH_BASE_FRAME::RemoveFromScreen(), SCH_EDIT_TOOL::RepeatDrawItem(), SCH_EDITOR_CONTROL::RescueLegacyProject(), SCH_EDITOR_CONTROL::rescueProject(), SCH_EDITOR_CONTROL::RescueSymbolLibTableProject(), SCH_EDITOR_CONTROL::Revert(), RollbackSchematicFromUndo(), SaveSymbolToSchematic(), EE_SELECTION_TOOL::selectMultiple(), SetCurrentSheet(), SYMBOL_EDIT_FRAME::SetCurSymbol(), EE_POINT_EDITOR::setEditedPoint(), SetScreen(), SYMBOL_VIEWER_FRAME::SetSelectedLibrary(), setupTools(), SYMBOL_EDIT_FRAME::setupTools(), SYMBOL_VIEWER_FRAME::setupTools(), ShowAllIntersheetRefs(), SYMBOL_EDIT_FRAME::ShowChangedLanguage(), SYMBOL_EDITOR_CONTROL::ShowElectricalTypes(), SYMBOL_EDITOR_CONTROL::ShowPinNumbers(), ShowSchematicSetupDialog(), SCH_DRAWING_TOOLS::SingleClickPlace(), SYMBOL_EDIT_FRAME::SwitchCanvas(), SYMBOL_VIEWER_FRAME::SYMBOL_VIEWER_FRAME(), SCH_BASE_FRAME::SyncView(), TestDanglingEnds(), DIALOG_ERC::testErc(), SCH_EDITOR_CONTROL::ToggleERCErrors(), SCH_EDITOR_CONTROL::ToggleERCExclusions(), SCH_EDITOR_CONTROL::ToggleERCWarnings(), SCH_EDITOR_CONTROL::ToggleHiddenFields(), SCH_EDITOR_CONTROL::ToggleHiddenPins(), DIALOG_JUNCTION_PROPS::TransferDataFromWindow(), DIALOG_LABEL_PROPERTIES::TransferDataFromWindow(), DIALOG_LINE_PROPERTIES::TransferDataFromWindow(), DIALOG_SHEET_PIN_PROPERTIES::TransferDataFromWindow(), DIALOG_TEXT_PROPERTIES::TransferDataFromWindow(), DIALOG_WIRE_BUS_PROPERTIES::TransferDataFromWindow(), SCH_DRAWING_TOOLS::TwoClickPlace(), SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace(), SCH_EDITOR_CONTROL::Undo(), SCH_EDITOR_CONTROL::UpdateFind(), SCH_BASE_FRAME::UpdateItem(), SCH_EDITOR_CONTROL::UpdateNetHighlighting(), SYMBOL_VIEWER_FRAME::updatePreviewSymbol(), SCH_BASE_FRAME::UpdateStatusBar(), ~SCH_EDIT_FRAME(), and SYMBOL_VIEWER_FRAME::~SYMBOL_VIEWER_FRAME().

GetColorSettings()

COLOR_SETTINGS * SCH_BASE_FRAME::GetColorSettings ( bool  aForceRefresh = false ) const

overridevirtualinherited

Returns a pointer to the active color theme settings.

Reimplemented from EDA_DRAW_FRAME.

Reimplemented in SYMBOL_EDIT_FRAME.

Definition at line 506 of file sch_base_frame.cpp.

{
 if( !m_colorSettings || aForceRefresh )
 {
 SETTINGS_MANAGER& mgr = Pgm().GetSettingsManager();
 EESCHEMA_SETTINGS* cfg = mgr.GetAppSettings<EESCHEMA_SETTINGS>();
 wxString colorTheme = cfg->m_ColorTheme;
 
 if( IsType( FRAME_SCH_SYMBOL_EDITOR ) )
 {
 SYMBOL_EDITOR_SETTINGS* symCfg = mgr.GetAppSettings<SYMBOL_EDITOR_SETTINGS>();
 
 if( !symCfg->m_UseEeschemaColorSettings )
 colorTheme = symCfg->m_ColorTheme;
 }
 
 COLOR_SETTINGS* colorSettings = mgr.GetColorSettings( colorTheme );
 
 const_cast<SCH_BASE_FRAME*>( this )->m_colorSettings = colorSettings;
 }
 
 return m_colorSettings;
}

References FRAME_SCH_SYMBOL_EDITOR, SETTINGS_MANAGER::GetAppSettings(), SETTINGS_MANAGER::GetColorSettings(), EDA_BASE_FRAME::IsType(), EDA_DRAW_FRAME::m_colorSettings, APP_SETTINGS_BASE::m_ColorTheme, SYMBOL_EDITOR_SETTINGS::m_UseEeschemaColorSettings, and Pgm().

Referenced by SCH_BASE_FRAME::CommonSettingsChanged(), DIALOG_FIELD_PROPERTIES::DIALOG_FIELD_PROPERTIES(), DIALOG_JUNCTION_PROPS::DIALOG_JUNCTION_PROPS(), DIALOG_LABEL_PROPERTIES::DIALOG_LABEL_PROPERTIES(), DIALOG_LINE_PROPERTIES::DIALOG_LINE_PROPERTIES(), DIALOG_SHAPE_PROPERTIES::DIALOG_SHAPE_PROPERTIES(), DIALOG_SHEET_PIN_PROPERTIES::DIALOG_SHEET_PIN_PROPERTIES(), DIALOG_SHEET_PROPERTIES::DIALOG_SHEET_PROPERTIES(), DIALOG_TEXT_PROPERTIES::DIALOG_TEXT_PROPERTIES(), DIALOG_WIRE_BUS_PROPERTIES::DIALOG_WIRE_BUS_PROPERTIES(), SCH_BASE_FRAME::GetDrawBgColor(), SCH_BASE_FRAME::GetLayerColor(), PrintPage(), SCH_PRINTOUT::PrintPage(), SYMBOL_VIEWER_FRAME::SYMBOL_VIEWER_FRAME(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), and DIALOG_SHEET_PROPERTIES::TransferDataToWindow().

GetCurrentFileName()

wxString SCH_EDIT_FRAME::GetCurrentFileName ( ) const

overridevirtual

Get the full filename + path of the currently opened file in the frame.

If no file is open, an empty string is returned.

Returns

the filename and full path to the open file

Reimplemented from EDA_BASE_FRAME.

Definition at line 1809 of file sch_edit_frame.cpp.

{
 return Schematic().GetFileName();
}

References SCHEMATIC::GetFileName(), and Schematic().

Referenced by OpenProjectFiles().

GetCurrentSelection()

SELECTION & SCH_EDIT_FRAME::GetCurrentSelection ( )

overridevirtual

Get the current selection from the canvas area.

Returns

the current selection.

Reimplemented from TOOLS_HOLDER.

Definition at line 1815 of file sch_edit_frame.cpp.

{
 return m_toolManager->GetTool<EE_SELECTION_TOOL>()->GetSelection();
}

References TOOL_MANAGER::GetTool(), and TOOLS_HOLDER::m_toolManager.

GetCurrentSheet()

SCH_SHEET_PATH & SCH_EDIT_FRAME::GetCurrentSheet

(

)

const

Definition at line 705 of file sch_edit_frame.cpp.

{
 return m_schematic->CurrentSheet();
}

References SCHEMATIC::CurrentSheet(), and m_schematic.

Referenced by AddItemToScreenAndUndoList(), AddSheetAndUpdateDisplay(), SYMBOL_EDITOR_CONTROL::AddSymbolToSchematic(), AnnotateSymbols(), SCH_EDITOR_CONTROL::AssignNetclass(), AutoRotateItem(), SCH_NAVIGATE_TOOL::CanGoNext(), SCH_NAVIGATE_TOOL::CanGoPrevious(), SCH_NAVIGATE_TOOL::CanGoUp(), CheckAnnotate(), CommonSettingsChanged(), DIALOG_PLOT_SCHEMATIC::createDXFFiles(), DIALOG_PLOT_SCHEMATIC::createHPGLFiles(), DIALOG_PLOT_SCHEMATIC::createPDFFile(), DIALOG_PLOT_SCHEMATIC::createPSFiles(), DIALOG_PLOT_SCHEMATIC::createSVGFiles(), DeleteAnnotation(), DisplayCurrentSheet(), KIGFX::SCH_VIEW::DisplaySheet(), doCloseWindow(), SCH_EDITOR_CONTROL::doCopy(), SCH_DRAWING_TOOLS::DrawSheet(), SCH_EDIT_TOOL::editFieldText(), SCH_EDIT_TOOL::EditPageNumber(), SCH_NAVIGATE_TOOL::EnterSheet(), SCH_EDITOR_CONTROL::FindNext(), SCH_EDITOR_CONTROL::FindSymbolAndItem(), FixupJunctions(), SCH_PIN::GetMsgPanelInfo(), SCH_SYMBOL::GetMsgPanelInfo(), GetScreen(), GetScreenDesc(), GetUniqueFilenameForCurrentSheet(), HardRedraw(), SCH_EDITOR_CONTROL::HasMatch(), importFile(), EE_SELECTION_TOOL::Init(), SCH_DRAWING_TOOLS::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), SCH_NAVIGATE_TOOL::LeaveSheet(), SCH_NAVIGATE_TOOL::Next(), DIALOG_ERC::OnERCItemSelected(), DIALOG_MIGRATE_BUSES::onItemSelected(), SCH_PRINTOUT::OnPrintPage(), DIALOG_SYMBOL_REMAP::OnRemapSymbols(), HIERARCHY_NAVIG_PANEL::onRightClick(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), DIALOG_UPDATE_FROM_PCB::OnUpdateClick(), DIALOG_SHEET_PROPERTIES::OnUpdateUI(), OpenProjectFiles(), SCH_EDITOR_CONTROL::Paste(), SCH_DRAWING_TOOLS::PlaceSymbol(), DIALOG_PLOT_SCHEMATIC::plotOneSheetDXF(), DIALOG_PLOT_SCHEMATIC::plotOneSheetHpgl(), DIALOG_PLOT_SCHEMATIC::plotOneSheetPDF(), DIALOG_PLOT_SCHEMATIC::plotOneSheetPS(), DIALOG_PLOT_SCHEMATIC::plotOneSheetSVG(), SCH_NAVIGATE_TOOL::Previous(), DIALOG_CHANGE_SYMBOLS::processMatchingSymbols(), SCH_EDIT_TOOL::Properties(), SCH_EDITOR_CONTROL::ReplaceAll(), SCH_EDITOR_CONTROL::ReplaceAndFindNext(), SCH_EDITOR_CONTROL::RescueLegacyProject(), SCH_EDITOR_CONTROL::RescueSymbolLibTableProject(), SCH_NAVIGATE_TOOL::ResetHistory(), DIALOG_PLOT_SCHEMATIC::restoreEnvironment(), SCH_EDITOR_CONTROL::Revert(), SCH_EDITOR_CONTROL::SaveCurrSheetCopyAs(), SaveSymbolToSchematic(), SelectUnit(), SendSelectItemsToPcb(), SetCurrentSheet(), SetSheetNumberAndCount(), ShowFindReplaceDialog(), DIALOG_GLOBAL_EDIT_TEXT_AND_GRAPHICS::TransferDataFromWindow(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), DIALOG_SYMBOL_FIELDS_TABLE::TransferDataFromWindow(), DIALOG_SHEET_PROPERTIES::TransferDataToWindow(), SCH_DRAWING_TOOLS::TwoClickPlace(), SCH_EDITOR_CONTROL::UpdateFind(), HIERARCHY_NAVIG_PANEL::UpdateHierarchySelection(), SCH_EDITOR_CONTROL::UpdateNetHighlighting(), and UpdateTitle().

GetDocumentExtents()

const BOX2I SCH_EDIT_FRAME::GetDocumentExtents ( bool  aIncludeAllVisible = true ) const

overridevirtual

Returns bbox of document with option to not include some items.

Used most commonly by "Zoom to Fit" and "Zoom to Objects". In Eeschema for "Zoom to Fit" it's passed "true" to include drawing sheet border, and "false" by "Zoom To Objects" to ignore drawing sheet border. In Pcbnew, false makes it ignore any items outside the PCB edge such as fabrication notes.

Parameters

aIncludeAllVisible

True to include everything visible in bbox calculations, false to ignore some visible items (program dependent).

Returns

Bounding box of the document (ignoring some items as requested).

Reimplemented from EDA_DRAW_FRAME.

Definition at line 1697 of file sch_edit_frame.cpp.

{
 BOX2I bBoxDoc;
 
 if( aIncludeAllVisible )
 {
 // Get the whole page size and return that
 int sizeX = GetScreen()->GetPageSettings().GetWidthIU( schIUScale.IU_PER_MILS );
 int sizeY = GetScreen()->GetPageSettings().GetHeightIU( schIUScale.IU_PER_MILS );
 bBoxDoc = BOX2I( VECTOR2I( 0, 0 ), VECTOR2I( sizeX, sizeY ) );
 }
 else
 {
 // Get current drawing-sheet in a form we can compare to an EDA_ITEM
 DS_PROXY_VIEW_ITEM* ds = SCH_BASE_FRAME::GetCanvas()->GetView()->GetDrawingSheet();
 EDA_ITEM* dsAsItem = static_cast<EDA_ITEM*>( ds );
 
 // Calc the bounding box of all items on screen except the page border
 for( EDA_ITEM* item : GetScreen()->Items() )
 {
 if( item != dsAsItem ) // Ignore the drawing-sheet itself
 bBoxDoc.Merge( item->GetBoundingBox() );
 }
 }
 
 return bBoxDoc;
}

References SCH_BASE_FRAME::GetCanvas(), KIGFX::SCH_VIEW::GetDrawingSheet(), PAGE_INFO::GetHeightIU(), SCH_SCREEN::GetPageSettings(), GetScreen(), SCH_DRAW_PANEL::GetView(), PAGE_INFO::GetWidthIU(), SCH_SCREEN::Items(), EDA_IU_SCALE::IU_PER_MILS, BOX2< Vec >::Merge(), and schIUScale.

GetDoImmediateActions()

bool TOOLS_HOLDER::GetDoImmediateActions ( ) const

inlineinherited

Indicate that hotkeys should perform an immediate action even if another tool is currently active.

If false, the first hotkey should select the relevant tool.

Definition at line 141 of file tools_holder.h.

{ return m_immediateActions; }

References TOOLS_HOLDER::m_immediateActions.

GetDragAction()

MOUSE_DRAG_ACTION TOOLS_HOLDER::GetDragAction ( ) const

inlineinherited

Indicates whether a drag should draw a selection rectangle or drag selected (or unselected) objects.

Definition at line 147 of file tools_holder.h.

{ return m_dragAction; }

References TOOLS_HOLDER::m_dragAction.

Referenced by EE_SELECTION_TOOL::Main(), PL_SELECTION_TOOL::Main(), and PCB_SELECTION_TOOL::Main().

GetDrawBgColor()

COLOR4D SCH_BASE_FRAME::GetDrawBgColor ( ) const

overridevirtualinherited

Reimplemented from EDA_DRAW_FRAME.

Definition at line 531 of file sch_base_frame.cpp.

{
 return GetColorSettings()->GetColor( LAYER_SCHEMATIC_BACKGROUND );
}

References COLOR_SETTINGS::GetColor(), SCH_BASE_FRAME::GetColorSettings(), and LAYER_SCHEMATIC_BACKGROUND.

Referenced by SCH_PRINTOUT::PrintPage().

GetFileFromHistory()

wxString EDA_BASE_FRAME::GetFileFromHistory ( int  cmdId, const wxString &  type, FILE_HISTORY *  aFileHistory = nullptr  )

inherited

Fetches the file name from the file history list.

This removes the selected file, if this file does not exist. The menu is also updated, if #FILE_HISTORY::UseMenu was called at initialization time.

Parameters

cmdId	The command ID associated with the aFileHistory object.
type	Please document me!
aFileHistory	The FILE_HISTORY in use. If null, the main application file history is used

Returns

a wxString containing the selected filename

Definition at line 908 of file eda_base_frame.cpp.

{
 if( !aFileHistory )
 aFileHistory = m_fileHistory;
 
 wxASSERT( aFileHistory );
 
 int baseId = aFileHistory->GetBaseId();
 
 wxASSERT( cmdId >= baseId && cmdId < baseId + (int) aFileHistory->GetCount() );
 
 unsigned i = cmdId - baseId;
 
 if( i < aFileHistory->GetCount() )
 {
 wxString fn = aFileHistory->GetHistoryFile( i );
 
 if( wxFileName::FileExists( fn ) )
 {
 return fn;
 }
 else
 {
 DisplayErrorMessage( this, wxString::Format( _( "File '%s' was not found." ), fn ) );
 aFileHistory->RemoveFileFromHistory( i );
 }
 }
 
 // Update the menubar to update the file history menu
 if( GetMenuBar() )
 {