LEGACY_RESCUER Class Reference

#include <project_rescue.h>

Inheritance diagram for LEGACY_RESCUER:

Public Member Functions
	LEGACY_RESCUER (PROJECT &aProject, SCHEMATIC *aSchematic, SCH_SHEET_PATH *aCurrentSheet, EDA_DRAW_PANEL_GAL::GAL_TYPE aGalBackEndType)
virtual	~LEGACY_RESCUER ()
virtual void	FindCandidates () override
	Populate the RESCUER with all possible candidates. More...
virtual void	InvokeDialog (wxWindow *aParent, bool aAskShowAgain) override
	Display a dialog to allow the user to select rescues. More...
virtual void	OpenRescueLibrary () override
virtual bool	WriteRescueLibrary (wxWindow *aParent) override
	Write the rescue library. More...
virtual void	AddSymbol (LIB_SYMBOL *aNewSymbol) override
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

Private Attributes
std::unique_ptr< SYMBOL_LIB >	m_rescue_lib

Detailed Description

Definition at line 332 of file project_rescue.h.

Constructor & Destructor Documentation

LEGACY_RESCUER()

LEGACY_RESCUER::LEGACY_RESCUER ( PROJECT &  aProject, SCHEMATIC *  aSchematic, SCH_SHEET_PATH *  aCurrentSheet, EDA_DRAW_PANEL_GAL::GAL_TYPE  aGalBackEndType  )

inline

Definition at line 335 of file project_rescue.h.

 :
 RESCUER( aProject, aSchematic, aCurrentSheet, aGalBackEndType )
 {
 }

~LEGACY_RESCUER()

virtual LEGACY_RESCUER::~LEGACY_RESCUER ( )

inlinevirtual

Definition at line 341 of file project_rescue.h.

 {
 }

Member Function Documentation

AddSymbol()

void LEGACY_RESCUER::AddSymbol ( LIB_SYMBOL *  aNewSymbol )

overridevirtual

Implements RESCUER.

Definition at line 789 of file project_rescue.cpp.

{
 wxCHECK_RET( aNewSymbol, wxS( "Invalid LIB_SYMBOL pointer." ) );
 
 aNewSymbol->SetLib( m_rescue_lib.get() );
 m_rescue_lib->AddSymbol( aNewSymbol );
}

References m_rescue_lib, and LIB_SYMBOL::SetLib().

DoRescues()

bool RESCUER::DoRescues ( )

inherited

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 RESCUER::m_chosen_candidates.

Referenced by RESCUER::RescueProject().

FindCandidates()

void LEGACY_RESCUER::FindCandidates ( )

overridevirtual

Populate the RESCUER with all possible candidates.

Implements RESCUER.

Definition at line 664 of file project_rescue.cpp.

{
 RESCUE_CASE_CANDIDATE::FindRescues( *this, m_all_candidates );
 RESCUE_CACHE_CANDIDATE::FindRescues( *this, m_all_candidates );
}

References RESCUE_CASE_CANDIDATE::FindRescues(), RESCUE_CACHE_CANDIDATE::FindRescues(), and RESCUER::m_all_candidates.

GetCandidateCount()

size_t RESCUER::GetCandidateCount ( )

inlineinherited

Return the number of rescue candidates found.

Definition at line 278 of file project_rescue.h.

{ return m_all_candidates.size(); }

References RESCUER::m_all_candidates.

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

GetChosenCandidateCount()

size_t RESCUER::GetChosenCandidateCount ( )

inlineinherited

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 RESCUER::m_chosen_candidates.

Referenced by RESCUER::RescueProject().

GetPrj()

PROJECT * RESCUER::GetPrj ( )

inlineinherited

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

Definition at line 293 of file project_rescue.h.

{ return m_prj; }

References RESCUER::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 ( )

inlineinherited

Get the list of symbols that need rescued.

Definition at line 288 of file project_rescue.h.

{ return &m_symbols; }

References RESCUER::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()

void LEGACY_RESCUER::InvokeDialog ( wxWindow *  aParent, bool  aAskShowAgain  )

overridevirtual

Display a dialog to allow the user to select rescues.

Parameters

aAskShowAgain

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

Implements RESCUER.

Definition at line 671 of file project_rescue.cpp.

{
 InvokeDialogRescueEach( aParent, static_cast< RESCUER& >( *this ), m_currentSheet,
 m_galBackEndType, aAskShowAgain );
}

References InvokeDialogRescueEach(), RESCUER::m_currentSheet, and RESCUER::m_galBackEndType.

LogRescue()

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

inherited

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 RESCUER::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()

void LEGACY_RESCUER::OpenRescueLibrary ( )

overridevirtual

Implements RESCUER.

Definition at line 678 of file project_rescue.cpp.

{
 wxFileName fn = GetRescueLibraryFileName( m_schematic );
 
 std::unique_ptr<SYMBOL_LIB> rescue_lib = std::make_unique<SYMBOL_LIB>( SCH_LIB_TYPE::LT_EESCHEMA,
 fn.GetFullPath() );
 
 m_rescue_lib = std::move( rescue_lib );
 m_rescue_lib->EnableBuffering();
 
 // If a rescue library already exists copy the contents of that library so we do not
 // lose any previous rescues.
 SYMBOL_LIB* rescueLib = m_prj->SchLibs()->FindLibrary( fn.GetName() );
 
 if( rescueLib )
 {
 // For items in the rescue library, aliases are the root symbol.
 std::vector< LIB_SYMBOL* > symbols;
 
 rescueLib->GetSymbols( symbols );
 
 for( LIB_SYMBOL* symbol : symbols )
 {
 // The LIB_SYMBOL copy constructor flattens derived symbols (formerly known as aliases).
 m_rescue_lib->AddSymbol( new LIB_SYMBOL( *symbol, m_rescue_lib.get() ) );
 }
 }
}

References GetRescueLibraryFileName(), SYMBOL_LIB::GetSymbols(), LT_EESCHEMA, RESCUER::m_prj, m_rescue_lib, and RESCUER::m_schematic.

RemoveDuplicates()

void RESCUER::RemoveDuplicates ( )

inherited

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 RESCUER::m_all_candidates.

Referenced by RESCUER::RescueProject().

RescueProject()

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

staticinherited

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 _, RESCUER::DoRescues(), RESCUER::FindCandidates(), RESCUER::GetCandidateCount(), RESCUER::GetChosenCandidateCount(), RESCUER::InvokeDialog(), RESCUER::OpenRescueLibrary(), RESCUER::RemoveDuplicates(), RESCUER::UndoRescues(), and RESCUER::WriteRescueLibrary().

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

Schematic()

SCHEMATIC * RESCUER::Schematic ( )

inlineinherited

Definition at line 295 of file project_rescue.h.

{ return m_schematic; }

References RESCUER::m_schematic.

Referenced by RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::FindRescues().

UndoRescues()

void RESCUER::UndoRescues ( )

inherited

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 RESCUER::m_rescue_log, and LIB_ID::SetLibItemName().

Referenced by RESCUER::RescueProject().

WriteRescueLibrary()

bool LEGACY_RESCUER::WriteRescueLibrary ( wxWindow *  aParent )

overridevirtual

Write the rescue library.

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

Returns

True on success.

Implements RESCUER.

Definition at line 708 of file project_rescue.cpp.

{
 try
 {
 m_rescue_lib->Save( false );
 }
 catch( ... /* IO_ERROR ioe */ )
 {
 wxString msg;
 
 msg.Printf( _( "Failed to create symbol library file '%s'." ),
 m_rescue_lib->GetFullFileName() );
 DisplayError( aParent, msg );
 return false;
 }
 
 wxArrayString libNames;
 wxString libPaths;
 
 wxString libName = m_rescue_lib->GetName();
 SYMBOL_LIBS *libs = dynamic_cast<SYMBOL_LIBS*>( m_prj->GetElem( PROJECT::ELEM_SCH_SYMBOL_LIBS ) );
 
 if( !libs )
 {
 libs = new SYMBOL_LIBS();
 m_prj->SetElem( PROJECT::ELEM_SCH_SYMBOL_LIBS, libs );
 }
 
 try
 {
 SYMBOL_LIBS::GetLibNamesAndPaths( m_prj, &libPaths, &libNames );
 
 // Make sure the library is not already in the list
 while( libNames.Index( libName ) != wxNOT_FOUND )
 libNames.Remove( libName );
 
 // Add the library to the top of the list and save.
 libNames.Insert( libName, 0 );
 SYMBOL_LIBS::SetLibNamesAndPaths( m_prj, libPaths, libNames );
 }
 catch( const IO_ERROR& )
 {
 // Could not get or save the current libraries.
 return false;
 }
 
 // Save the old libraries in case there is a problem after clear(). We'll
 // put them back in.
 boost::ptr_vector<SYMBOL_LIB> libsSave;
 libsSave.transfer( libsSave.end(), libs->begin(), libs->end(), *libs );
 
 m_prj->SetElem( PROJECT::ELEM_SCH_SYMBOL_LIBS, nullptr );
 
 libs = new SYMBOL_LIBS();
 
 try
 {
 libs->LoadAllLibraries( m_prj );
 }
 catch( const PARSE_ERROR& )
 {
 // Some libraries were not found. There's no point in showing the error,
 // because it was already shown. Just don't do anything.
 }
 catch( const IO_ERROR& )
 {
 // Restore the old list
 libs->clear();
 libs->transfer( libs->end(), libsSave.begin(), libsSave.end(), libsSave );
 return false;
 }
 
 m_prj->SetElem( PROJECT::ELEM_SCH_SYMBOL_LIBS, libs );
 
 // Update the schematic symbol library links since the library list has changed.
 SCH_SCREENS schematic( m_schematic->Root() );
 schematic.UpdateSymbolLinks();
 return true;
}

References _, DisplayError(), PROJECT::ELEM_SCH_SYMBOL_LIBS, PROJECT::GetElem(), SYMBOL_LIBS::GetLibNamesAndPaths(), SYMBOL_LIBS::LoadAllLibraries(), RESCUER::m_prj, m_rescue_lib, RESCUER::m_schematic, SCHEMATIC::Root(), PROJECT::SetElem(), SYMBOL_LIBS::SetLibNamesAndPaths(), and SCH_SCREENS::UpdateSymbolLinks().

Member Data Documentation

m_all_candidates

boost::ptr_vector<RESCUE_CANDIDATE> RESCUER::m_all_candidates

protectedinherited

Definition at line 325 of file project_rescue.h.

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

m_chosen_candidates

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

protectedinherited

Definition at line 326 of file project_rescue.h.

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

m_currentSheet

SCH_SHEET_PATH* RESCUER::m_currentSheet

protectedinherited

Definition at line 323 of file project_rescue.h.

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

m_galBackEndType

EDA_DRAW_PANEL_GAL::GAL_TYPE RESCUER::m_galBackEndType

protectedinherited

Definition at line 322 of file project_rescue.h.

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

m_prj

PROJECT* RESCUER::m_prj

protectedinherited

Definition at line 320 of file project_rescue.h.

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

m_rescue_lib

std::unique_ptr<SYMBOL_LIB> LEGACY_RESCUER::m_rescue_lib

private

Definition at line 356 of file project_rescue.h.

Referenced by AddSymbol(), OpenRescueLibrary(), and WriteRescueLibrary().

m_rescue_log

std::vector<RESCUE_LOG> RESCUER::m_rescue_log

protectedinherited

Definition at line 328 of file project_rescue.h.

Referenced by RESCUER::LogRescue(), and RESCUER::UndoRescues().

m_schematic

SCHEMATIC* RESCUER::m_schematic

protectedinherited

Definition at line 321 of file project_rescue.h.

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

m_symbols

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

protectedinherited

Definition at line 319 of file project_rescue.h.

Referenced by RESCUER::GetSymbols(), and RESCUER::RESCUER().

---

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

• project_rescue.h
• project_rescue.cpp