RESCUER Class Reference

#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. More...
virtual void	OpenRescueLibrary ()=0
virtual void	FindCandidates ()=0
	Populate the RESCUER with all possible candidates. More...
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. More...
void	RemoveDuplicates ()
	Filter out duplicately named rescue candidates. More...
size_t	GetCandidateCount ()
	Return the number of rescue candidates found. More...
size_t	GetChosenCandidateCount ()
	Get the number of rescue candidates chosen by the user. More...
std::vector< SCH_SYMBOL * > *	GetSymbols ()
	Get the list of symbols that need rescued. More...
PROJECT *	GetPrj ()
	Return the #SCH_PROJECT object for access to the symbol libraries. More...
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. More...
bool	DoRescues ()
	Perform all chosen rescue actions, logging them to be undone if necessary. More...
void	UndoRescues ()
	Reverse the effects of all rescues on the project. More...

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 235 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 535 of file project_rescue.cpp.

{
 m_schematic = aSchematic ? aSchematic : aCurrentSheet->LastScreen()->Schematic();
 
 wxASSERT( m_schematic );
 
 if( m_schematic )
 getSymbols( m_schematic, m_symbols );
 
 m_prj = &aProject;
 m_currentSheet = aCurrentSheet;
 m_galBackEndType = aGalBackEndType;
}

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 241 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 562 of file project_rescue.cpp.

{
 for( RESCUE_CANDIDATE* each_candidate : m_chosen_candidates )
 {
 if( ! each_candidate->PerformAction( this ) )
 return false;
 }
 
 return true;
}

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 278 of file project_rescue.h.

{ return m_all_candidates.size(); }

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 283 of file project_rescue.h.

{ return m_chosen_candidates.size(); }

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 293 of file project_rescue.h.

{ return m_prj; }

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 288 of file project_rescue.h.

{ return &m_symbols; }

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 551 of file project_rescue.cpp.

{
 RESCUE_LOG logitem;
 logitem.symbol = aSymbol;
 logitem.old_name = aOldName;
 logitem.new_name = aNewName;
 m_rescue_log.push_back( logitem );
}

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 633 of file project_rescue.cpp.

{
 std::vector<wxString> names_seen;
 
 for( boost::ptr_vector<RESCUE_CANDIDATE>::iterator it = m_all_candidates.begin();
 it != m_all_candidates.end(); )
 {
 bool seen_already = false;
 
 for( wxString& name_seen : names_seen )
 {
 if( name_seen == it->GetRequestedName() )
 {
 seen_already = true;
 break;
 }
 }
 
 if( seen_already )
 {
 it = m_all_candidates.erase( it );
 }
 else
 {
 names_seen.push_back( it->GetRequestedName() );
 ++it;
 }
 }
}

References m_all_candidates.

Referenced by RescueProject().

RescueProject()

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

static

Definition at line 587 of file project_rescue.cpp.

{
 aRescuer.FindCandidates();
 
 if( !aRescuer.GetCandidateCount() )
 {
 if( aRunningOnDemand )
 {
 wxMessageDialog dlg( aParent, _( "This project has nothing to rescue." ),
 _( "Project Rescue Helper" ) );
 dlg.ShowModal();
 }
 
 return true;
 }
 
 aRescuer.RemoveDuplicates();
 aRescuer.InvokeDialog( aParent, !aRunningOnDemand );
 
 // If no symbols were rescued, let the user know what's going on. He might
 // have clicked cancel by mistake, and should have some indication of that.
 if( !aRescuer.GetChosenCandidateCount() )
 {
 wxMessageDialog dlg( aParent, _( "No symbols were rescued." ),
 _( "Project Rescue Helper" ) );
 dlg.ShowModal();
 
 // Set the modified flag even on Cancel. Many users seem to instinctively want to Save at
 // this point, due to the reloading of the symbols, so we'll make the save button active.
 return true;
 }
 
 aRescuer.OpenRescueLibrary();
 
 if( !aRescuer.DoRescues() )
 {
 aRescuer.UndoRescues();
 return false;
 }
 
 aRescuer.WriteRescueLibrary( aParent );
 
 return true;
}

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 295 of file project_rescue.h.

{ return m_schematic; }

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 574 of file project_rescue.cpp.

{
 for( RESCUE_LOG& each_logitem : m_rescue_log )
 {
 LIB_ID libId;
 
 libId.SetLibItemName( each_logitem.old_name );
 each_logitem.symbol->SetLibId( libId );
 each_logitem.symbol->ClearFlags();
 }
}

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 317 of file project_rescue.h.

Member Data Documentation

m_all_candidates

boost::ptr_vector<RESCUE_CANDIDATE> RESCUER::m_all_candidates

protected

Definition at line 325 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 326 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 323 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 322 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 320 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 328 of file project_rescue.h.

Referenced by LogRescue(), and UndoRescues().

m_schematic

SCHEMATIC* RESCUER::m_schematic

protected

Definition at line 321 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 319 of file project_rescue.h.

Referenced by GetSymbols(), and RESCUER().

---

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

• project_rescue.h
• project_rescue.cpp