Hold a record identifying a library accessed by the appropriate footprint library #PLUGIN object in the FP_LIB_TABLE. More...

#include <fp_lib_table.h>

Inheritance diagram for FP_LIB_TABLE_ROW:

Public Member Functions
	FP_LIB_TABLE_ROW (const wxString &aNick, const wxString &aURI, const wxString &aType, const wxString &aOptions, const wxString &aDescr=wxEmptyString)

	FP_LIB_TABLE_ROW ()

bool	operator== (const FP_LIB_TABLE_ROW &aRow) const

bool	operator!= (const FP_LIB_TABLE_ROW &aRow) const

const wxString	GetType () const override
	return the type of footprint library table represented by this row.

void	SetType (const wxString &aType) override
	Change the type represented by this row.

bool	LibraryExists () const override

PCB_IO_MGR::PCB_FILE_T	GetFileType ()

bool	operator== (const LIB_TABLE_ROW &r) const

bool	operator!= (const LIB_TABLE_ROW &r) const

const wxString &	GetNickName () const

void	SetNickName (const wxString &aNickName)
	Change the logical name of this library, useful for an editor.

bool	GetIsLoaded () const

void	SetLoaded (bool aLoaded)
	Mark the row as being a loaded library.

bool	GetIsEnabled () const

void	SetEnabled (bool aEnabled=true)
	Change the enabled status of this library.

bool	GetIsVisible () const

void	SetVisible (bool aVisible=true)

virtual bool	Refresh ()

virtual bool	SupportsSettingsDialog () const

virtual void	ShowSettingsDialog (wxWindow *aParent) const

const wxString	GetFullURI (bool aSubstituted=false) const
	Return the full location specifying URI for the LIB, either in original UI form or in environment variable expanded form.

void	SetFullURI (const wxString &aFullURI)
	Change the full URI for the library.

const wxString &	GetOptions () const
	Return the options string, which may hold a password or anything else needed to instantiate the underlying library plugin.

void	SetOptions (const wxString &aOptions)
	Change the library options strings.

const wxString &	GetDescr () const
	Return the description of the library referenced by this row.

void	SetDescr (const wxString &aDescr)
	Change the description of the library referenced by this row.

LIB_TABLE *	GetParent () const

void	SetParent (LIB_TABLE *aParent)

std::mutex &	GetMutex ()

const std::map< std::string, UTF8 > *	GetProperties () const
	Return the constant #PROPERTIES for this library (LIB_TABLE_ROW).

void	Format (OUTPUTFORMATTER *out, int nestLevel) const
	Serialize this object as utf8 text to an OUTPUTFORMATTER, and tries to make it look good using multiple lines and indentation.

LIB_TABLE_ROW *	clone () const

Protected Member Functions
	FP_LIB_TABLE_ROW (const FP_LIB_TABLE_ROW &aRow)

Private Member Functions
virtual LIB_TABLE_ROW *	do_clone () const override

void	setPlugin (PCB_IO *aPlugin)

void	setProperties (std::map< std::string, UTF8 > *aProperties)

Private Attributes
IO_RELEASER< PCB_IO >	plugin

PCB_IO_MGR::PCB_FILE_T	type

wxString	nickName

wxString	uri_user
	what user entered from UI or loaded from disk

wxString	options

wxString	description

bool	enabled = true
	Whether the LIB_TABLE_ROW is enabled.

bool	visible = true
	Whether the LIB_TABLE_ROW is visible in choosers.

bool	m_loaded = false
	Whether the LIB_TABLE_ROW is loaded.

LIB_TABLE *	m_parent
	Pointer to the table this row lives in (maybe null)

std::unique_ptr< std::map< std::string, UTF8 > >	properties

std::mutex	m_loadMutex

Friends
class	FP_LIB_TABLE

Detailed Description

Hold a record identifying a library accessed by the appropriate footprint library #PLUGIN object in the FP_LIB_TABLE.

Definition at line 41 of file fp_lib_table.h.

Constructor & Destructor Documentation

◆ FP_LIB_TABLE_ROW() [1/3]

FP_LIB_TABLE_ROW::FP_LIB_TABLE_ROW	(	const wxString &	aNick,
		const wxString &	aURI,
		const wxString &	aType,
		const wxString &	aOptions,
		const wxString &	aDescr = `wxEmptyString`
	)

inline

Definition at line 44 of file fp_lib_table.h.

References SetType().

◆ FP_LIB_TABLE_ROW() [2/3]

FP_LIB_TABLE_ROW::FP_LIB_TABLE_ROW ( )

inline

Definition at line 51 of file fp_lib_table.h.

Referenced by do_clone().

◆ FP_LIB_TABLE_ROW() [3/3]

FP_LIB_TABLE_ROW::FP_LIB_TABLE_ROW ( const FP_LIB_TABLE_ROW & aRow )

inlineprotected

Definition at line 75 of file fp_lib_table.h.

Member Function Documentation

◆ clone()

LIB_TABLE_ROW * LIB_TABLE_ROW::clone ( ) const

inlineinherited

Definition at line 266 of file lib_table_base.h.

Referenced by new_clone(), DESIGN_BLOCK_GRID_TRICKS::paste_text(), SYMBOL_GRID_TRICKS::paste_text(), and FP_GRID_TRICKS::paste_text().

◆ do_clone()

virtual LIB_TABLE_ROW * FP_LIB_TABLE_ROW::do_clone ( ) const

inlineoverrideprivatevirtual

Implements LIB_TABLE_ROW.

Definition at line 82 of file fp_lib_table.h.

References FP_LIB_TABLE_ROW().

◆ Format()

void LIB_TABLE_ROW::Format	(	OUTPUTFORMATTER *	out,
		int	nestLevel
	)		const

inherited

Serialize this object as utf8 text to an OUTPUTFORMATTER, and tries to make it look good using multiple lines and indentation.

Parameters

out	is an OUTPUTFORMATTER
nestLevel	is the indentation level to base all lines of the output. Actual indentation will be 2 spaces for each nestLevel.

Definition at line 125 of file lib_table_base.cpp.

References LIB_TABLE_ROW::GetDescr(), LIB_TABLE_ROW::GetFullURI(), LIB_TABLE_ROW::GetIsEnabled(), LIB_TABLE_ROW::GetIsVisible(), LIB_TABLE_ROW::GetNickName(), LIB_TABLE_ROW::GetOptions(), LIB_TABLE_ROW::GetType(), OUTPUTFORMATTER::Print(), and OUTPUTFORMATTER::Quotew().

◆ GetDescr()

const wxString & LIB_TABLE_ROW::GetDescr ( ) const

inlineinherited

Return the description of the library referenced by this row.

Definition at line 237 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::Format(), LIB_TABLE::GetDescription(), LIB_TABLE_GRID::GetValue(), SYMBOL_TREE_SYNCHRONIZING_ADAPTER::GetValue(), FP_TREE_SYNCHRONIZING_ADAPTER::GetValue(), SCH_EDIT_FRAME::LoadSheetFromFile(), and DIALOG_FOOTPRINT_ASSOCIATIONS::TransferDataToWindow().

◆ GetFileType()

PCB_IO_MGR::PCB_FILE_T FP_LIB_TABLE_ROW::GetFileType ( )

inline

Definition at line 72 of file fp_lib_table.h.

References type.

◆ GetFullURI()

const wxString LIB_TABLE_ROW::GetFullURI ( bool aSubstituted = false ) const

inherited

Return the full location specifying URI for the LIB, either in original UI form or in environment variable expanded form.

Parameters

aSubstituted Tells if caller wanted the substituted form, else not.

Definition at line 114 of file lib_table_base.cpp.

References ExpandEnvVarSubstitutions(), and LIB_TABLE_ROW::uri_user.

◆ GetIsEnabled()

bool LIB_TABLE_ROW::GetIsEnabled ( ) const

inlineinherited

Returns: the enabled status of this library row

Definition at line 180 of file lib_table_base.h.

Referenced by LIB_TABLE::findRow(), LIB_TABLE_ROW::Format(), LIB_TABLE::GetLogicalLibs(), LIB_TABLE_GRID::GetValue(), LIB_TABLE_GRID::GetValueAsBool(), SYMBOL_LIB_TABLE_ROW::SYMBOL_LIB_TABLE_ROW(), PANEL_DESIGN_BLOCK_LIB_TABLE::verifyTables(), and PANEL_SYM_LIB_TABLE::verifyTables().

◆ GetIsLoaded()

bool LIB_TABLE_ROW::GetIsLoaded ( ) const

inlineinherited

Returns: true if the library was loaded without error

Definition at line 170 of file lib_table_base.h.

Referenced by SYMBOL_LIB_TABLE::IsSymbolLibLoaded().

◆ GetIsVisible()

bool LIB_TABLE_ROW::GetIsVisible ( ) const

inlineinherited

Definition at line 187 of file lib_table_base.h.

Referenced by SYMBOL_TREE_MODEL_ADAPTER::AddLibraries(), LIB_TABLE_ROW::Format(), LIB_TABLE_GRID::GetValue(), LIB_TABLE_GRID::GetValueAsBool(), PANEL_SYMBOL_CHOOSER::PANEL_SYMBOL_CHOOSER(), and SYMBOL_VIEWER_FRAME::ReCreateLibList().

◆ GetMutex()

std::mutex & LIB_TABLE_ROW::GetMutex ( )

inlineinherited

Definition at line 248 of file lib_table_base.h.

Referenced by SYMBOL_LIB_TABLE::LoadSymbol(), and SYMBOL_LIB_TABLE::LoadSymbolLib().

◆ GetNickName()

const wxString & LIB_TABLE_ROW::GetNickName ( ) const

inlineinherited

Returns: the logical name of this library table row.

Definition at line 160 of file lib_table_base.h.

Referenced by BOOST_AUTO_TEST_CASE(), LIB_TABLE_GRID::ContainsNickname(), DESIGN_BLOCK_LIB_TABLE::DesignBlockLoad(), LIB_TABLE::doInsertRow(), PCB_EDIT_FRAME::ExportFootprintsToLibrary(), SCH_EDITOR_CONTROL::ExportSymbolsToLibrary(), FP_LIB_TABLE::FootprintLoad(), LIB_TABLE_ROW::Format(), LIB_TABLE::GetLogicalLibs(), LIB_TABLE_GRID::GetValue(), SYMBOL_EDIT_FRAME::KiwayMailIn(), FOOTPRINT_EDIT_FRAME::KiwayMailIn(), DESIGN_BLOCK_LIB_TABLE::LoadGlobalTable(), FP_LIB_TABLE::LoadGlobalTable(), SYMBOL_LIB_TABLE::LoadGlobalTable(), SYMBOL_LIB_TABLE::LoadSymbol(), SYMBOL_LIB_TABLE::LoadSymbolLib(), DESIGN_BLOCK_GRID_TRICKS::optionsEditor(), SYMBOL_GRID_TRICKS::optionsEditor(), FP_GRID_TRICKS::optionsEditor(), DIALOG_SYMBOL_REMAP::remapSymbolToLibTable(), LIB_TABLE::RemoveRow(), PANEL_DESIGN_BLOCK_LIB_TABLE::verifyTables(), and PANEL_SYM_LIB_TABLE::verifyTables().

◆ GetOptions()

const wxString & LIB_TABLE_ROW::GetOptions ( ) const

inlineinherited

Return the options string, which may hold a password or anything else needed to instantiate the underlying library plugin.

Definition at line 227 of file lib_table_base.h.

Referenced by SYMBOL_LIB_TABLE::EnumerateSymbolLib(), LIB_TABLE_ROW::Format(), LIB_TABLE_GRID::GetValue(), SCH_EDIT_FRAME::LoadSheetFromFile(), SYMBOL_LIB_TABLE::LoadSymbolLib(), DESIGN_BLOCK_GRID_TRICKS::optionsEditor(), SYMBOL_GRID_TRICKS::optionsEditor(), and FP_GRID_TRICKS::optionsEditor().

◆ GetParent()

LIB_TABLE * LIB_TABLE_ROW::GetParent ( ) const

inlineinherited

Definition at line 244 of file lib_table_base.h.

Referenced by SYMBOL_LIB_TABLE_ROW::Refresh().

◆ GetProperties()

const std::map< std::string, UTF8 > * LIB_TABLE_ROW::GetProperties ( ) const

inlineinherited

Return the constant #PROPERTIES for this library (LIB_TABLE_ROW).

These are the "options" in a table.

Definition at line 254 of file lib_table_base.h.

◆ GetType()

const wxString FP_LIB_TABLE_ROW::GetType ( ) const

inlineoverridevirtual

return the type of footprint library table represented by this row.

Implements LIB_TABLE_ROW.

Definition at line 63 of file fp_lib_table.h.

References PCB_IO_MGR::ShowType(), and type.

◆ LibraryExists()

bool FP_LIB_TABLE_ROW::LibraryExists ( ) const

overridevirtual

Implements LIB_TABLE_ROW.

Definition at line 66 of file fp_lib_table.cpp.

References LIB_TABLE_ROW::GetFullURI(), and plugin.

◆ operator!=() [1/2]

bool FP_LIB_TABLE_ROW::operator!= ( const FP_LIB_TABLE_ROW & aRow ) const

inline

Definition at line 58 of file fp_lib_table.h.

◆ operator!=() [2/2]

bool LIB_TABLE_ROW::operator!= ( const LIB_TABLE_ROW & r ) const

inlineinherited

Definition at line 155 of file lib_table_base.h.

◆ operator==() [1/2]

bool FP_LIB_TABLE_ROW::operator== ( const FP_LIB_TABLE_ROW & aRow ) const

Definition at line 49 of file fp_lib_table.cpp.

References LIB_TABLE_ROW::operator==(), and type.

◆ operator==() [2/2]

bool LIB_TABLE_ROW::operator== ( const LIB_TABLE_ROW & r ) const

inherited

Definition at line 150 of file lib_table_base.cpp.

References LIB_TABLE_ROW::description, LIB_TABLE_ROW::enabled, LIB_TABLE_ROW::nickName, LIB_TABLE_ROW::options, LIB_TABLE_ROW::uri_user, and LIB_TABLE_ROW::visible.

Referenced by DESIGN_BLOCK_LIB_TABLE_ROW::operator==(), operator==(), and SYMBOL_LIB_TABLE_ROW::operator==().

◆ Refresh()

virtual bool LIB_TABLE_ROW::Refresh ( )

inlinevirtualinherited

Reimplemented in SYMBOL_LIB_TABLE_ROW, and DESIGN_BLOCK_LIB_TABLE_ROW.

Definition at line 193 of file lib_table_base.h.

Referenced by LIB_TABLE_GRID_TRICKS::doPopupSelection().

◆ SetDescr()

void LIB_TABLE_ROW::SetDescr ( const wxString & aDescr )

inlineinherited

Change the description of the library referenced by this row.

Definition at line 242 of file lib_table_base.h.

Referenced by LIB_TABLE_GRID::SetValue().

◆ SetEnabled()

void LIB_TABLE_ROW::SetEnabled ( bool aEnabled = true )

inlineinherited

Change the enabled status of this library.

Definition at line 185 of file lib_table_base.h.

Referenced by LIB_TABLE_GRID::SetValue(), LIB_TABLE_GRID::SetValueAsBool(), and SYMBOL_LIB_TABLE_ROW::SYMBOL_LIB_TABLE_ROW().

◆ SetFullURI()

void LIB_TABLE_ROW::SetFullURI ( const wxString & aFullURI )

inherited

Change the full URI for the library.

Definition at line 108 of file lib_table_base.cpp.

References LIB_TABLE_ROW::uri_user.

Referenced by SYMBOL_EDIT_FRAME::addLibTableEntry(), SYMBOL_EDIT_FRAME::replaceLibTableEntry(), PCB::IFACE::SaveFileAs(), and LIB_TABLE_GRID::SetValue().

◆ SetLoaded()

void LIB_TABLE_ROW::SetLoaded ( bool aLoaded )

inlineinherited

Mark the row as being a loaded library.

Definition at line 175 of file lib_table_base.h.

Referenced by SYMBOL_LIB_TABLE::EnumerateSymbolLib(), SYMBOL_LIB_TABLE::LoadSymbolLib(), SYMBOL_LIB_TABLE_ROW::Refresh(), and DESIGN_BLOCK_LIB_TABLE_ROW::Refresh().

◆ SetNickName()

void LIB_TABLE_ROW::SetNickName ( const wxString & aNickName )

inlineinherited

Change the logical name of this library, useful for an editor.

Definition at line 165 of file lib_table_base.h.

Referenced by SYMBOL_EDIT_FRAME::addLibTableEntry(), and LIB_TABLE_GRID::SetValue().

◆ SetOptions()

void LIB_TABLE_ROW::SetOptions ( const wxString & aOptions )

inherited

Change the library options strings.

Definition at line 161 of file lib_table_base.cpp.

References LIB_TABLE_ROW::options, LIB_TABLE::ParseOptions(), LIB_TABLE_ROW::setProperties(), and TO_UTF8.

Referenced by SYMBOL_LIB_TABLE::EnumerateSymbolLib(), SYMBOL_LIB_TABLE::LoadSymbolLib(), DESIGN_BLOCK_GRID_TRICKS::optionsEditor(), SYMBOL_GRID_TRICKS::optionsEditor(), FP_GRID_TRICKS::optionsEditor(), and LIB_TABLE_GRID::SetValue().

◆ SetParent()

void LIB_TABLE_ROW::SetParent ( LIB_TABLE * aParent )

inlineinherited

Definition at line 246 of file lib_table_base.h.

Referenced by LIB_TABLE::doInsertRow(), PANEL_DESIGN_BLOCK_LIB_TABLE::verifyTables(), and PANEL_SYM_LIB_TABLE::verifyTables().

◆ setPlugin()

void FP_LIB_TABLE_ROW::setPlugin ( PCB_IO * aPlugin )

inlineprivate

Definition at line 87 of file fp_lib_table.h.

References plugin.

Referenced by FP_LIB_TABLE::FindRow().

◆ setProperties()

void LIB_TABLE_ROW::setProperties ( std::map< std::string, UTF8 > * aProperties )

privateinherited

Definition at line 102 of file lib_table_base.cpp.

References LIB_TABLE_ROW::properties.

Referenced by LIB_TABLE_ROW::SetOptions().

◆ SetType()

void FP_LIB_TABLE_ROW::SetType ( const wxString & aType )

overridevirtual

Change the type represented by this row.

Implements LIB_TABLE_ROW.

Definition at line 55 of file fp_lib_table.cpp.

References PCB_IO_MGR::EnumFromStr(), PCB_IO_MGR::KICAD_SEXP, plugin, and type.

Referenced by FP_LIB_TABLE_ROW().

◆ SetVisible()

void LIB_TABLE_ROW::SetVisible ( bool aVisible = true )

inlineinherited

Definition at line 189 of file lib_table_base.h.

Referenced by LIB_TABLE_GRID::SetValue(), and LIB_TABLE_GRID::SetValueAsBool().

◆ ShowSettingsDialog()

virtual void LIB_TABLE_ROW::ShowSettingsDialog ( wxWindow * aParent ) const

inlinevirtualinherited

Reimplemented in SYMBOL_LIB_TABLE_ROW.

Definition at line 208 of file lib_table_base.h.

Referenced by LIB_TABLE_GRID_TRICKS::doPopupSelection().

◆ SupportsSettingsDialog()

virtual bool LIB_TABLE_ROW::SupportsSettingsDialog ( ) const

inlinevirtualinherited

Reimplemented in SYMBOL_LIB_TABLE_ROW.

Definition at line 206 of file lib_table_base.h.

Referenced by LIB_TABLE_GRID_TRICKS::showPopupMenu().

Friends And Related Function Documentation

◆ FP_LIB_TABLE

friend class FP_LIB_TABLE

friend

Definition at line 92 of file fp_lib_table.h.

Member Data Documentation

◆ description

wxString LIB_TABLE_ROW::description

privateinherited

Definition at line 299 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::operator==().

◆ enabled

bool LIB_TABLE_ROW::enabled = true

privateinherited

Whether the LIB_TABLE_ROW is enabled.

Definition at line 301 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::operator==().

◆ m_loaded

bool LIB_TABLE_ROW::m_loaded = false

privateinherited

Whether the LIB_TABLE_ROW is loaded.

Definition at line 303 of file lib_table_base.h.

◆ m_loadMutex

std::mutex LIB_TABLE_ROW::m_loadMutex

privateinherited

Definition at line 308 of file lib_table_base.h.

◆ m_parent

LIB_TABLE* LIB_TABLE_ROW::m_parent

privateinherited

Pointer to the table this row lives in (maybe null)

Definition at line 304 of file lib_table_base.h.

◆ nickName

wxString LIB_TABLE_ROW::nickName

privateinherited

Definition at line 296 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::operator==().

◆ options

wxString LIB_TABLE_ROW::options

privateinherited

Definition at line 298 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::operator==(), and LIB_TABLE_ROW::SetOptions().

◆ plugin

IO_RELEASER<PCB_IO> FP_LIB_TABLE_ROW::plugin

private

Definition at line 95 of file fp_lib_table.h.

Referenced by FP_LIB_TABLE::FindRow(), FP_LIB_TABLE::FootprintDelete(), FP_LIB_TABLE::FootprintEnumerate(), FP_LIB_TABLE::FootprintExists(), FP_LIB_TABLE::FootprintLibCreate(), FP_LIB_TABLE::FootprintLibDelete(), FP_LIB_TABLE::FootprintLoad(), FP_LIB_TABLE::FootprintSave(), FP_LIB_TABLE::GenerateTimestamp(), FP_LIB_TABLE::GetEnumeratedFootprint(), FP_LIB_TABLE::IsFootprintLibWritable(), LibraryExists(), setPlugin(), and SetType().

◆ properties

std::unique_ptr<std::map<std::string, UTF8> > LIB_TABLE_ROW::properties

privateinherited

Definition at line 306 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::LIB_TABLE_ROW(), and LIB_TABLE_ROW::setProperties().

◆ type

PCB_IO_MGR::PCB_FILE_T FP_LIB_TABLE_ROW::type

private

Definition at line 96 of file fp_lib_table.h.

Referenced by FP_LIB_TABLE::FindRow(), GetFileType(), GetType(), operator==(), and SetType().

◆ uri_user

wxString LIB_TABLE_ROW::uri_user

privateinherited

what user entered from UI or loaded from disk

Definition at line 297 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::GetFullURI(), LIB_TABLE_ROW::operator==(), and LIB_TABLE_ROW::SetFullURI().

◆ visible

bool LIB_TABLE_ROW::visible = true

privateinherited

Whether the LIB_TABLE_ROW is visible in choosers.

Definition at line 302 of file lib_table_base.h.

Referenced by LIB_TABLE_ROW::operator==().

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

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ FP_LIB_TABLE_ROW() [1/3]

◆ FP_LIB_TABLE_ROW() [2/3]

◆ FP_LIB_TABLE_ROW() [3/3]

Member Function Documentation

◆ clone()

◆ do_clone()

◆ Format()

◆ GetDescr()

◆ GetFileType()

◆ GetFullURI()

◆ GetIsEnabled()

◆ GetIsLoaded()

◆ GetIsVisible()

◆ GetMutex()

◆ GetNickName()

◆ GetOptions()

◆ GetParent()

◆ GetProperties()

◆ GetType()

◆ LibraryExists()

◆ operator!=() [1/2]

◆ operator!=() [2/2]

◆ operator==() [1/2]

◆ operator==() [2/2]

◆ Refresh()

◆ SetDescr()

◆ SetEnabled()

◆ SetFullURI()

◆ SetLoaded()

◆ SetNickName()

◆ SetOptions()

◆ SetParent()

◆ setPlugin()

◆ setProperties()

◆ SetType()

◆ SetVisible()

◆ ShowSettingsDialog()

◆ SupportsSettingsDialog()

Friends And Related Function Documentation

◆ FP_LIB_TABLE

Member Data Documentation

◆ description

◆ enabled

◆ m_loaded

◆ m_loadMutex

◆ m_parent

◆ nickName

◆ options

◆ plugin

◆ properties

◆ type

◆ uri_user

◆ visible