KiCad PCB EDA Suite: RESCUER Class Reference

KiCad PCB EDA Suite

Loading...

Searching...

No Matches

#include <project_rescue.h>

Inheritance diagram for RESCUER:

Public Member Functions
	RESCUER (PROJECT &aProject, SCHEMATIC aSchematic, SCH_SHEET_PATH aCurrentSheet, EDA_DRAW_PANEL_GAL::GAL_TYPE aGalBackeEndType)

virtual	~RESCUER ()

virtual bool	WriteRescueLibrary (wxWindow *aParent)=0
	Write the rescue library.

virtual void	OpenRescueLibrary ()=0

virtual void	FindCandidates ()=0
	Populate the RESCUER with all possible candidates.

virtual void	AddSymbol (LIB_SYMBOL *aNewSymbol)=0

virtual void	InvokeDialog (wxWindow *aParent, bool aAskShowAgain)=0
	Display a dialog to allow the user to select rescues.

void	RemoveDuplicates ()
	Filter out duplicately named rescue candidates.

size_t	GetCandidateCount ()
	Return the number of rescue candidates found.

size_t	GetChosenCandidateCount ()
	Get the number of rescue candidates chosen by the user.

std::vector< SCH_SYMBOL * > *	GetSymbols ()
	Get the list of symbols that need rescued.

PROJECT *	GetPrj ()
	Return the #SCH_PROJECT object for access to the symbol libraries.

SCHEMATIC *	Schematic ()

void	LogRescue (SCH_SYMBOL *aSymbol, const wxString &aOldName, const wxString &aNewName)
	Used by individual RESCUE_CANDIDATE objects to log a rescue for undoing.

bool	DoRescues ()
	Perform all chosen rescue actions, logging them to be undone if necessary.

void	UndoRescues ()
	Reverse the effects of all rescues on the project.

Static Public Member Functions
static bool	RescueProject (wxWindow *aParent, RESCUER &aRescuer, bool aRunningOnDemand)

Protected Attributes
std::vector< SCH_SYMBOL * >	m_symbols

PROJECT *	m_prj

SCHEMATIC *	m_schematic

EDA_DRAW_PANEL_GAL::GAL_TYPE	m_galBackEndType

SCH_SHEET_PATH *	m_currentSheet

boost::ptr_vector< RESCUE_CANDIDATE >	m_all_candidates

std::vector< RESCUE_CANDIDATE * >	m_chosen_candidates

std::vector< RESCUE_LOG >	m_rescue_log

Friends
class	DIALOG_RESCUE_EACH

Detailed Description

Definition at line 232 of file project_rescue.h.

Constructor & Destructor Documentation

◆ RESCUER()

RESCUER::RESCUER	(	PROJECT &	aProject,
		SCHEMATIC *	aSchematic,
		SCH_SHEET_PATH *	aCurrentSheet,
		EDA_DRAW_PANEL_GAL::GAL_TYPE	aGalBackeEndType
	)

Definition at line 533 of file project_rescue.cpp.

References getSymbols(), SCH_SHEET_PATH::LastScreen(), m_currentSheet, m_galBackEndType, m_prj, m_schematic, m_symbols, and SCH_SCREEN::Schematic().

◆ ~RESCUER()

virtual RESCUER::~RESCUER ( )

inlinevirtual

Definition at line 238 of file project_rescue.h.

Member Function Documentation

◆ AddSymbol()

virtual void RESCUER::AddSymbol ( LIB_SYMBOL * aNewSymbol )

pure virtual

Implemented in LEGACY_RESCUER, and SYMBOL_LIB_TABLE_RESCUER.

Referenced by RESCUE_CASE_CANDIDATE::PerformAction(), RESCUE_CACHE_CANDIDATE::PerformAction(), and RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::PerformAction().

◆ DoRescues()

bool RESCUER::DoRescues ( )

Perform all chosen rescue actions, logging them to be undone if necessary.

Returns: True on success

Definition at line 560 of file project_rescue.cpp.

References m_chosen_candidates.

Referenced by RescueProject().

◆ FindCandidates()

virtual void RESCUER::FindCandidates ( )

pure virtual

Populate the RESCUER with all possible candidates.

Implemented in LEGACY_RESCUER, and SYMBOL_LIB_TABLE_RESCUER.

Referenced by RescueProject().

◆ GetCandidateCount()

size_t RESCUER::GetCandidateCount ( )

inline

Return the number of rescue candidates found.

Definition at line 275 of file project_rescue.h.

References m_all_candidates.

Referenced by SCH_EDITOR_CONTROL::rescueProject(), RescueProject(), and DIALOG_RESCUE_EACH::TransferDataFromWindow().

◆ GetChosenCandidateCount()

size_t RESCUER::GetChosenCandidateCount ( )

inline

Get the number of rescue candidates chosen by the user.

Definition at line 280 of file project_rescue.h.

References m_chosen_candidates.

Referenced by RescueProject().

◆ GetPrj()

PROJECT * RESCUER::GetPrj ( )

inline

Return the #SCH_PROJECT object for access to the symbol libraries.

Definition at line 290 of file project_rescue.h.

References m_prj.

Referenced by RESCUE_CASE_CANDIDATE::FindRescues(), RESCUE_CACHE_CANDIDATE::FindRescues(), and RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::FindRescues().

◆ GetSymbols()

std::vector< SCH_SYMBOL * > * RESCUER::GetSymbols ( )

inline

Get the list of symbols that need rescued.

Definition at line 285 of file project_rescue.h.

References m_symbols.

Referenced by RESCUE_CASE_CANDIDATE::FindRescues(), RESCUE_CACHE_CANDIDATE::FindRescues(), RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::FindRescues(), RESCUE_CASE_CANDIDATE::PerformAction(), RESCUE_CACHE_CANDIDATE::PerformAction(), RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::PerformAction(), and DIALOG_RESCUE_EACH::PopulateInstanceList().

◆ InvokeDialog()

virtual void RESCUER::InvokeDialog	(	wxWindow *	aParent,
		bool	aAskShowAgain
	)

pure virtual

Display a dialog to allow the user to select rescues.

Parameters

aAskShowAgain - whether the "Never Show Again" button should be visible

Implemented in LEGACY_RESCUER, and SYMBOL_LIB_TABLE_RESCUER.

Referenced by RescueProject().

◆ LogRescue()

void RESCUER::LogRescue	(	SCH_SYMBOL *	aSymbol,
		const wxString &	aOldName,
		const wxString &	aNewName
	)

Used by individual RESCUE_CANDIDATE objects to log a rescue for undoing.

Definition at line 549 of file project_rescue.cpp.

References m_rescue_log, RESCUE_LOG::new_name, RESCUE_LOG::old_name, and RESCUE_LOG::symbol.

Referenced by RESCUE_CASE_CANDIDATE::PerformAction(), RESCUE_CACHE_CANDIDATE::PerformAction(), and RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::PerformAction().

◆ OpenRescueLibrary()

virtual void RESCUER::OpenRescueLibrary ( )

pure virtual

Implemented in LEGACY_RESCUER, and SYMBOL_LIB_TABLE_RESCUER.

Referenced by RescueProject().

◆ RemoveDuplicates()

void RESCUER::RemoveDuplicates ( )

Filter out duplicately named rescue candidates.

Definition at line 631 of file project_rescue.cpp.

References m_all_candidates.

Referenced by RescueProject().

◆ RescueProject()

bool RESCUER::RescueProject	(	wxWindow *	aParent,
		RESCUER &	aRescuer,
		bool	aRunningOnDemand
	)

static

Definition at line 585 of file project_rescue.cpp.

References _, DoRescues(), FindCandidates(), GetCandidateCount(), GetChosenCandidateCount(), InvokeDialog(), OpenRescueLibrary(), RemoveDuplicates(), UndoRescues(), and WriteRescueLibrary().

Referenced by DIALOG_SYMBOL_REMAP::OnRemapSymbols(), and SCH_EDITOR_CONTROL::rescueProject().

◆ Schematic()

SCHEMATIC * RESCUER::Schematic ( )

inline

Definition at line 292 of file project_rescue.h.

References m_schematic.

Referenced by RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::FindRescues().

◆ UndoRescues()

void RESCUER::UndoRescues ( )

Reverse the effects of all rescues on the project.

Definition at line 572 of file project_rescue.cpp.

References m_rescue_log, and LIB_ID::SetLibItemName().

Referenced by RescueProject().

◆ WriteRescueLibrary()

virtual bool RESCUER::WriteRescueLibrary ( wxWindow * aParent )

pure virtual

Write the rescue library.

Called after successful PerformAction()s. If this fails, undo the actions.

Returns: True on success.

Implemented in LEGACY_RESCUER, and SYMBOL_LIB_TABLE_RESCUER.

Referenced by RescueProject().

Friends And Related Function Documentation

◆ DIALOG_RESCUE_EACH

friend class DIALOG_RESCUE_EACH

friend

Definition at line 314 of file project_rescue.h.

Member Data Documentation

◆ m_all_candidates

boost::ptr_vector<RESCUE_CANDIDATE> RESCUER::m_all_candidates

protected

Definition at line 322 of file project_rescue.h.

Referenced by DIALOG_RESCUE_EACH::displayItemsInConflict(), LEGACY_RESCUER::FindCandidates(), SYMBOL_LIB_TABLE_RESCUER::FindCandidates(), GetCandidateCount(), DIALOG_RESCUE_EACH::PopulateConflictList(), DIALOG_RESCUE_EACH::PopulateInstanceList(), RemoveDuplicates(), and DIALOG_RESCUE_EACH::TransferDataFromWindow().

◆ m_chosen_candidates

std::vector<RESCUE_CANDIDATE*> RESCUER::m_chosen_candidates

protected

Definition at line 323 of file project_rescue.h.

Referenced by DoRescues(), GetChosenCandidateCount(), DIALOG_RESCUE_EACH::OnCancelClick(), DIALOG_RESCUE_EACH::OnNeverShowClick(), and DIALOG_RESCUE_EACH::TransferDataFromWindow().

◆ m_currentSheet

SCH_SHEET_PATH* RESCUER::m_currentSheet

protected

Definition at line 320 of file project_rescue.h.

Referenced by LEGACY_RESCUER::InvokeDialog(), SYMBOL_LIB_TABLE_RESCUER::InvokeDialog(), and RESCUER().

◆ m_galBackEndType

EDA_DRAW_PANEL_GAL::GAL_TYPE RESCUER::m_galBackEndType

protected

Definition at line 319 of file project_rescue.h.

Referenced by LEGACY_RESCUER::InvokeDialog(), SYMBOL_LIB_TABLE_RESCUER::InvokeDialog(), and RESCUER().

◆ m_prj

PROJECT* RESCUER::m_prj

protected

Definition at line 317 of file project_rescue.h.

Referenced by GetPrj(), LEGACY_RESCUER::OpenRescueLibrary(), SYMBOL_LIB_TABLE_RESCUER::OpenRescueLibrary(), RESCUER(), LEGACY_RESCUER::WriteRescueLibrary(), and SYMBOL_LIB_TABLE_RESCUER::WriteRescueLibrary().

◆ m_rescue_log

std::vector<RESCUE_LOG> RESCUER::m_rescue_log

protected

Definition at line 325 of file project_rescue.h.

Referenced by LogRescue(), and UndoRescues().

◆ m_schematic

SCHEMATIC* RESCUER::m_schematic

protected

Definition at line 318 of file project_rescue.h.

Referenced by LEGACY_RESCUER::OpenRescueLibrary(), SYMBOL_LIB_TABLE_RESCUER::OpenRescueLibrary(), RESCUER(), Schematic(), LEGACY_RESCUER::WriteRescueLibrary(), and SYMBOL_LIB_TABLE_RESCUER::WriteRescueLibrary().

◆ m_symbols

std::vector<SCH_SYMBOL*> RESCUER::m_symbols

protected

Definition at line 316 of file project_rescue.h.

Referenced by GetSymbols(), and RESCUER().

The documentation for this class was generated from the following files:

RESCUER
Generated on Tue Aug 12 2025 00:07:38 for KiCad PCB EDA Suite by 1.9.6