#include <design_block_library_adapter.h>

Inheritance diagram for DESIGN_BLOCK_LIBRARY_ADAPTER:

Public Types
enum	SAVE_T { SAVE_OK , SAVE_SKIPPED }
	The set of return values from DesignBlockSave() below. More...

Public Member Functions
	DESIGN_BLOCK_LIBRARY_ADAPTER (LIBRARY_MANAGER &aManager)

LIBRARY_TABLE_TYPE	Type () const override
	The type of library table this adapter works with.

std::optional< LIB_STATUS >	LoadOne (LIB_DATA *aLib) override

std::optional< LIB_STATUS >	LoadOne (const wxString &nickname)

std::vector< DESIGN_BLOCK * >	GetDesignBlocks (const wxString &aNickname)

std::vector< wxString >	GetDesignBlockNames (const wxString &aNickname)

DESIGN_BLOCK *	LoadDesignBlock (const wxString &aNickname, const wxString &aDesignBlockName, bool aKeepUUID=false)
	Load a design block having aDesignBlockName from the library given by aNickname.

bool	DesignBlockExists (const wxString &aNickname, const wxString &aDesignBlockName)
	Indicates whether or not the given design block already exists in the given library.

const DESIGN_BLOCK *	GetEnumeratedDesignBlock (const wxString &aNickname, const wxString &aDesignBlockName)
	A version of #DesignBlockLoad() for use after #DesignBlockEnumerate() for more efficient cache management.

SAVE_T	SaveDesignBlock (const wxString &aNickname, const DESIGN_BLOCK *aDesignBlock, bool aOverwrite=true)
	Write aDesignBlock to an existing library given by aNickname.

void	DeleteDesignBlock (const wxString &aNickname, const wxString &aDesignBlockName)
	Delete the aDesignBlockName from the library given by aNickname.

bool	IsDesignBlockLibWritable (const wxString &aNickname)
	Return true if the library given by aNickname is writable.

DESIGN_BLOCK *	DesignBlockLoadWithOptionalNickname (const LIB_ID &aDesignBlockId, bool aKeepUUID=false)
	Load a design block having aDesignBlockId with possibly an empty nickname.

LIBRARY_MANAGER &	Manager () const

LIBRARY_TABLE *	GlobalTable () const
	Retrieves the global library table for this adapter type.

std::optional< LIBRARY_TABLE * >	ProjectTable () const
	Retrieves the project library table for this adapter type, or nullopt if one doesn't exist.

std::optional< wxString >	FindLibraryByURI (const wxString &aURI) const

std::vector< wxString >	GetLibraryNames () const
	Returns a list of library nicknames that are available (skips any that failed to load)

bool	HasLibrary (const wxString &aNickname, bool aCheckEnabled=false) const
	Test for the existence of aNickname in the library tables.

bool	DeleteLibrary (const wxString &aNickname)
	Deletes the given library from disk if it exists; returns true if deleted.

std::optional< wxString >	GetLibraryDescription (const wxString &aNickname) const

std::vector< LIBRARY_TABLE_ROW * >	Rows (LIBRARY_TABLE_SCOPE aScope=LIBRARY_TABLE_SCOPE::BOTH, bool aIncludeInvalid=false) const
	Like LIBRARY_MANAGER::Rows but filtered to the LIBRARY_TABLE_TYPE of this adapter.

std::optional< LIBRARY_TABLE_ROW * >	GetRow (const wxString &aNickname, LIBRARY_TABLE_SCOPE aScope=LIBRARY_TABLE_SCOPE::BOTH) const
	Like LIBRARY_MANAGER::GetRow but filtered to the LIBRARY_TABLE_TYPE of this adapter.

std::optional< LIBRARY_TABLE_ROW * >	FindRowByURI (const wxString &aUri, LIBRARY_TABLE_SCOPE aScope=LIBRARY_TABLE_SCOPE::BOTH) const
	Like LIBRARY_MANAGER::FindRowByURI but filtered to the LIBRARY_TABLE_TYPE of this adapter.

virtual void	ProjectChanged ()
	Notify the adapter that the active project has changed.

void	GlobalTablesChanged (std::initializer_list< LIBRARY_TABLE_TYPE > aChangedTables={})
	Notify the adapter that the global library tables have changed.

void	ProjectTablesChanged (std::initializer_list< LIBRARY_TABLE_TYPE > aChangedTables={})
	Notify the adapter that the project library tables are about to be rebuilt.

void	ProjectTablesReloaded (std::initializer_list< LIBRARY_TABLE_TYPE > aChangedTables={})
	Complements ProjectTablesChanged by erasing project-scope cache entries whose nicknames no longer appear in the rebuilt project table.

void	CheckTableRow (LIBRARY_TABLE_ROW &aRow)

void	AsyncLoad ()
	Loads all available libraries for this adapter type in the background.

std::optional< float >	AsyncLoadProgress () const
	Returns async load progress between 0.0 and 1.0, or nullopt if load is not in progress.

void	BlockUntilLoaded ()

void	AbortAsyncLoad ()
	Aborts any async load in progress; blocks until fully done aborting.

bool	IsLibraryLoaded (const wxString &aNickname)

std::optional< LIB_STATUS >	GetLibraryStatus (const wxString &aNickname) const
	Returns the status of a loaded library, or nullopt if the library hasn't been loaded (yet)

std::vector< std::pair< wxString, LIB_STATUS > >	GetLibraryStatuses () const
	Returns a list of all library nicknames and their status (even if they failed to load)

wxString	GetLibraryLoadErrors () const
	Returns all library load errors as newline-separated strings for display.

void	ReloadLibraryEntry (const wxString &aNickname, LIBRARY_TABLE_SCOPE aScope=LIBRARY_TABLE_SCOPE::BOTH)

std::optional< LIB_STATUS >	LoadLibraryEntry (const wxString &aNickname)
	Synchronously loads the named library to LOADED state.

virtual bool	IsWritable (const wxString &aNickname) const
	Return true if the given nickname exists and is not a read-only library.

bool	CreateLibrary (const wxString &aNickname)
	Creates the library (i.e. saves to disk) for the given row if it exists.

virtual bool	SupportsConfigurationDialog (const wxString &aNickname) const

virtual void	ShowConfigurationDialog (const wxString &aNickname, wxWindow *aParent) const

virtual std::optional< LIBRARY_ERROR >	LibraryError (const wxString &aNickname) const

Static Public Member Functions
static wxString	GlobalPathEnvVariableName ()

Protected Member Functions
std::map< wxString, LIB_DATA > &	globalLibs () override

std::map< wxString, LIB_DATA > &	globalLibs () const override

std::shared_mutex &	globalLibsMutex () override

std::shared_mutex &	globalLibsMutex () const override

void	enumerateLibrary (LIB_DATA *aLib, const wxString &aUri) override
	Override in derived class to perform library-specific enumeration.

LIBRARY_RESULT< IO_BASE * >	createPlugin (const LIBRARY_TABLE_ROW *row) override
	Creates a concrete plugin for the given row.

IO_BASE *	plugin (const LIB_DATA *aRow) override

std::optional< const LIB_DATA * >	fetchIfLoaded (const wxString &aNickname) const

std::optional< LIB_DATA * >	fetchIfLoaded (const wxString &aNickname)

LIBRARY_RESULT< LIB_DATA * >	loadIfNeeded (const wxString &aNickname)
	Fetches a loaded library, triggering a load of that library if it isn't loaded yet.

LIBRARY_RESULT< LIB_DATA * >	loadFromScope (const wxString &aNickname, LIBRARY_TABLE_SCOPE aScope, std::map< wxString, LIB_DATA > &aTarget, std::shared_mutex &aMutex)

void	abortLoad ()
	Aborts any async load in progress; blocks until fully done aborting.

void	resetProjectCache ()
	Aborts pending loads and resets every project-scope cache entry in place (plugin and row cleared, status returned to INVALID) while preserving the nickname keys.

Static Protected Member Functions
static wxString	getUri (const LIBRARY_TABLE_ROW *aRow)

Protected Attributes
LIBRARY_MANAGER &	m_manager

std::map< wxString, LIB_DATA >	m_libraries

std::shared_mutex	m_librariesMutex

std::atomic_bool	m_abort

std::vector< std::future< void > >	m_futures

std::atomic< size_t >	m_loadCount { 0 }

std::atomic< size_t >	m_loadTotal { 0 }

std::mutex	m_loadMutex

Static Private Member Functions
static DESIGN_BLOCK_IO *	dbplugin (const LIB_DATA *aRow)
	Helper to cast the ABC plugin in the LIB_DATA* to a concrete plugin.

Static Private Attributes
static LEAK_AT_EXIT< std::map< wxString, LIB_DATA > >	GlobalLibraries

static std::shared_mutex	GlobalLibraryMutex

Detailed Description

Definition at line 35 of file design_block_library_adapter.h.

Member Enumeration Documentation

◆ SAVE_T

enum DESIGN_BLOCK_LIBRARY_ADAPTER::SAVE_T

The set of return values from DesignBlockSave() below.

Enumerator
SAVE_OK
SAVE_SKIPPED

Definition at line 87 of file design_block_library_adapter.h.

Constructor & Destructor Documentation

◆ DESIGN_BLOCK_LIBRARY_ADAPTER()

DESIGN_BLOCK_LIBRARY_ADAPTER::DESIGN_BLOCK_LIBRARY_ADAPTER ( LIBRARY_MANAGER & aManager )

Definition at line 39 of file design_block_library_adapter.cpp.

References LIBRARY_MANAGER_ADAPTER::LIBRARY_MANAGER_ADAPTER().

Member Function Documentation

◆ AbortAsyncLoad()

void LIBRARY_MANAGER_ADAPTER::AbortAsyncLoad ( )

inherited

Aborts any async load in progress; blocks until fully done aborting.

This is the public interface to allow LIBRARY_MANAGER to abort loads before project changes.

Definition at line 948 of file library_manager.cpp.

References abortLoad().

Referenced by LoadOne().

◆ abortLoad()

void LIBRARY_MANAGER_ADAPTER::abortLoad ( )

protectedinherited

Aborts any async load in progress; blocks until fully done aborting.

Definition at line 1191 of file library_manager.cpp.

References BlockUntilLoaded(), m_abort, m_futures, m_loadCount, m_loadMutex, m_loadTotal, and traceLibraries.

Referenced by AbortAsyncLoad(), CheckTableRow(), enumerateLibrary(), GlobalTablesChanged(), and resetProjectCache().

◆ AsyncLoad()

void LIBRARY_MANAGER_ADAPTER::AsyncLoad ( )

inherited

Loads all available libraries for this adapter type in the background.

Definition at line 1584 of file library_manager.cpp.

References GetKiCadThreadPool(), getUri(), globalLibs(), globalLibsMutex(), LOADED, LOADING, m_futures, m_libraries, m_librariesMutex, m_loadCount, m_loadMutex, m_loadTotal, m_manager, tp, traceLibraries, and Type().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), filterFootprints(), PCBNEW_JOBS_HANDLER::JobExportDrc(), EESCHEMA_JOBS_HANDLER::JobSchErc(), PANEL_FOOTPRINT_CHOOSER::PANEL_FOOTPRINT_CHOOSER(), PGM_BASE::PreloadDesignBlockLibraries(), PCB::IFACE::PreloadLibraries(), and SCH::IFACE::PreloadLibraries().

◆ AsyncLoadProgress()

std::optional< float > LIBRARY_MANAGER_ADAPTER::AsyncLoadProgress ( ) const

inherited

Returns async load progress between 0.0 and 1.0, or nullopt if load is not in progress.

Definition at line 1216 of file library_manager.cpp.

References m_loadCount, and m_loadTotal.

Referenced by BOOST_AUTO_TEST_CASE(), LoadOne(), PGM_BASE::PreloadDesignBlockLibraries(), PCB::IFACE::PreloadLibraries(), and SCH::IFACE::PreloadLibraries().

◆ BlockUntilLoaded()

void LIBRARY_MANAGER_ADAPTER::BlockUntilLoaded ( )

inherited

Definition at line 1228 of file library_manager.cpp.

References m_futures, m_loadCount, m_loadMutex, m_loadTotal, and traceLibraries.

Referenced by abortLoad(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), filterFootprints(), PCBNEW_JOBS_HANDLER::JobExportDrc(), EESCHEMA_JOBS_HANDLER::JobSchErc(), LoadOne(), PANEL_FOOTPRINT_CHOOSER::PANEL_FOOTPRINT_CHOOSER(), PGM_BASE::PreloadDesignBlockLibraries(), PCB::IFACE::PreloadLibraries(), SCH::IFACE::PreloadLibraries(), and SYMBOL_EDIT_FRAME::SyncLibraries().

◆ CheckTableRow()

void LIBRARY_MANAGER_ADAPTER::CheckTableRow ( LIBRARY_TABLE_ROW & aRow )

inherited

Definition at line 1033 of file library_manager.cpp.

References abortLoad(), createPlugin(), fetchIfLoaded(), LIBRARY_TABLE_ROW::IsOk(), LOADED, LoadOne(), LIBRARY_TABLE_ROW::Nickname(), LIB_DATA::plugin, plugin(), LIB_DATA::row, LIBRARY_TABLE_ROW::SetErrorDescription(), LIBRARY_TABLE_ROW::SetOk(), LIBRARY_TABLE_ROW::Type(), and LIBRARY_TABLE_ROW::URI().

Referenced by LIB_TABLE_NOTEBOOK_PANEL::onGridCellChanging().

◆ CreateLibrary()

bool LIBRARY_MANAGER_ADAPTER::CreateLibrary ( const wxString & aNickname )

inherited

Creates the library (i.e. saves to disk) for the given row if it exists.

Definition at line 1405 of file library_manager.cpp.

References IO_BASE::CreateLibrary(), LIBRARY_TABLE_ROW::GetOptionsMap(), getUri(), loadIfNeeded(), LIB_DATA::plugin, result, LIB_DATA::row, traceLibraries, and IO_ERROR::What().

Referenced by SYMBOL_LIBRARY_MANAGER::addLibrary(), and LoadOne().

◆ createPlugin()

LIBRARY_RESULT< IO_BASE * > DESIGN_BLOCK_LIBRARY_ADAPTER::createPlugin ( const LIBRARY_TABLE_ROW * row )

overrideprotectedvirtual

Creates a concrete plugin for the given row.

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 59 of file design_block_library_adapter.cpp.

References _, DESIGN_BLOCK_IO_MGR::DESIGN_BLOCK_FILE_UNKNOWN, DESIGN_BLOCK_IO_MGR::EnumFromStr(), DESIGN_BLOCK_IO_MGR::FindPlugin(), LIBRARY_MANAGER_ADAPTER::m_manager, DESIGN_BLOCK_IO_MGR::NESTED_TABLE, plugin(), traceLibraries, LIBRARY_TABLE_ROW::Type(), and LIBRARY_TABLE_ROW::URI().

◆ dbplugin()

DESIGN_BLOCK_IO * DESIGN_BLOCK_LIBRARY_ADAPTER::dbplugin ( const LIB_DATA * aRow )

staticprivate

Helper to cast the ABC plugin in the LIB_DATA* to a concrete plugin.

Definition at line 51 of file design_block_library_adapter.cpp.

References LIB_DATA::plugin.

Referenced by DeleteDesignBlock(), DesignBlockExists(), enumerateLibrary(), GetDesignBlockNames(), GetDesignBlocks(), GetEnumeratedDesignBlock(), LoadDesignBlock(), LoadOne(), plugin(), and SaveDesignBlock().

◆ DeleteDesignBlock()

void DESIGN_BLOCK_LIBRARY_ADAPTER::DeleteDesignBlock	(	const wxString &	aNickname,
		const wxString &	aDesignBlockName )

Delete the aDesignBlockName from the library given by aNickname.

Parameters

aNickname	is a locator for the "library", it is a "name" in #LIB_TABLE_ROW.
aDesignBlockName	is the name of a design block to delete from the specified library.

Exceptions

IO_ERROR if there is a problem finding the design block or the library, or deleting it.

Definition at line 281 of file design_block_library_adapter.cpp.

References dbplugin(), DESIGN_BLOCK_IO::DesignBlockDelete(), LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), and LIB_DATA::row.

◆ DeleteLibrary()

bool LIBRARY_MANAGER_ADAPTER::DeleteLibrary ( const wxString & aNickname )

inherited

Deletes the given library from disk if it exists; returns true if deleted.

Definition at line 1139 of file library_manager.cpp.

References IO_BASE::DeleteLibrary(), LIBRARY_TABLE_ROW::GetOptionsMap(), getUri(), loadIfNeeded(), LIB_DATA::plugin, result, and LIB_DATA::row.

Referenced by Type().

◆ DesignBlockExists()

bool DESIGN_BLOCK_LIBRARY_ADAPTER::DesignBlockExists	(	const wxString &	aNickname,
		const wxString &	aDesignBlockName )

Indicates whether or not the given design block already exists in the given library.

Definition at line 233 of file design_block_library_adapter.cpp.

References dbplugin(), DESIGN_BLOCK_IO::DesignBlockExists(), LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), and LIB_DATA::row.

Referenced by SaveDesignBlock().

◆ DesignBlockLoadWithOptionalNickname()

DESIGN_BLOCK * DESIGN_BLOCK_LIBRARY_ADAPTER::DesignBlockLoadWithOptionalNickname	(	const LIB_ID &	aDesignBlockId,
		bool	aKeepUUID = false )

Load a design block having aDesignBlockId with possibly an empty nickname.

Parameters

aDesignBlockId	the [nickname] and name of the design block to load.
aKeepUUID	= true to keep initial items UUID, false to set new UUID normally true if loaded in the design block editor, false if loaded in the board editor used only in kicad_plugin

Returns: the DESIGN_BLOCK if found caller owns it, else NULL if not found.

Exceptions

IO_ERROR	if the library cannot be found or read. No exception is thrown in the case where aDesignBlockName cannot be found.
PARSE_ERROR	if aDesignBlockId is not parsed OK.

Definition at line 305 of file design_block_library_adapter.cpp.

References LIB_ID::GetLibItemName(), LIB_ID::GetLibNickname(), LIBRARY_MANAGER_ADAPTER::GetLibraryNames(), library, and LoadDesignBlock().

Referenced by DESIGN_BLOCK_PANE::GetDesignBlock().

◆ enumerateLibrary()

void DESIGN_BLOCK_LIBRARY_ADAPTER::enumerateLibrary	(	LIB_DATA *	aLib,
		const wxString &	aUri )

overrideprotectedvirtual

Override in derived class to perform library-specific enumeration.

Parameters

aUri	is the pre-resolved library URI (must be resolved on the main thread since URI expansion accesses PROJECT data that is not thread-safe).

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 96 of file design_block_library_adapter.cpp.

References dbplugin(), DESIGN_BLOCK_IO::DesignBlockEnumerate(), LIBRARY_TABLE_ROW::GetOptionsMap(), and LIB_DATA::row.

◆ fetchIfLoaded() [1/2]

std::optional< LIB_DATA * > LIBRARY_MANAGER_ADAPTER::fetchIfLoaded ( const wxString & aNickname )

protectedinherited

Definition at line 1472 of file library_manager.cpp.

References find, globalLibs(), globalLibsMutex(), LOADED, m_libraries, and m_librariesMutex.

◆ fetchIfLoaded() [2/2]

std::optional< const LIB_DATA * > LIBRARY_MANAGER_ADAPTER::fetchIfLoaded ( const wxString & aNickname ) const

protectedinherited

Definition at line 1442 of file library_manager.cpp.

References find, globalLibs(), globalLibsMutex(), LOADED, m_libraries, and m_librariesMutex.

◆ FindLibraryByURI()

std::optional< wxString > LIBRARY_MANAGER_ADAPTER::FindLibraryByURI ( const wxString & aURI ) const

inherited

Definition at line 1095 of file library_manager.cpp.

References m_manager, Type(), and LIBRARY_MANAGER::UrisAreEquivalent().

Referenced by Type().

◆ FindRowByURI()

std::optional< LIBRARY_TABLE_ROW * > LIBRARY_MANAGER_ADAPTER::FindRowByURI	(	const wxString &	aUri,
		LIBRARY_TABLE_SCOPE	aScope = LIBRARY_TABLE_SCOPE::BOTH ) const

inherited

Like LIBRARY_MANAGER::FindRowByURI but filtered to the LIBRARY_TABLE_TYPE of this adapter.

Definition at line 1183 of file library_manager.cpp.

References m_manager, and Type().

Referenced by FOOTPRINT_EDIT_FRAME::KiwayMailIn(), SYMBOL_EDIT_FRAME::KiwayMailIn(), and Type().

◆ GetDesignBlockNames()

std::vector< wxString > DESIGN_BLOCK_LIBRARY_ADAPTER::GetDesignBlockNames ( const wxString & aNickname )

Returns: all the names of design blocks in the given library, if it exists and is loaded (or an empty list)

Definition at line 180 of file design_block_library_adapter.cpp.

References dbplugin(), DESIGN_BLOCK_IO::DesignBlockEnumerate(), LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), name, and LIB_DATA::row.

◆ GetDesignBlocks()

std::vector< DESIGN_BLOCK * > DESIGN_BLOCK_LIBRARY_ADAPTER::GetDesignBlocks ( const wxString & aNickname )

Returns: all the design blocks in the given library, if it exists and is loaded (or an empty list)

Definition at line 142 of file design_block_library_adapter.cpp.

References dbplugin(), DESIGN_BLOCK_IO::DesignBlockEnumerate(), LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), LIBRARY_TABLE_ROW::Nickname(), LIB_DATA::row, traceLibraries, and IO_ERROR::What().

Referenced by DESIGN_BLOCK_TREE_MODEL_ADAPTER::getDesignBlocks().

◆ GetEnumeratedDesignBlock()

const DESIGN_BLOCK * DESIGN_BLOCK_LIBRARY_ADAPTER::GetEnumeratedDesignBlock	(	const wxString &	aNickname,
		const wxString &	aDesignBlockName )

A version of #DesignBlockLoad() for use after #DesignBlockEnumerate() for more efficient cache management.

The return value is const to allow it to return a reference to a cached item.

Definition at line 247 of file design_block_library_adapter.cpp.

References dbplugin(), LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), DESIGN_BLOCK_IO::GetEnumeratedDesignBlock(), LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), and LIB_DATA::row.

◆ GetLibraryDescription()

std::optional< wxString > LIBRARY_MANAGER_ADAPTER::GetLibraryDescription ( const wxString & aNickname ) const

inherited

Definition at line 1160 of file library_manager.cpp.

References fetchIfLoaded().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), PCB_BASE_FRAME::GetLibraryItemsForListDialog(), SCH_BASE_FRAME::GetLibraryItemsForListDialog(), and Type().

◆ GetLibraryLoadErrors()

wxString LIBRARY_MANAGER_ADAPTER::GetLibraryLoadErrors ( ) const

inherited

Returns all library load errors as newline-separated strings for display.

Definition at line 1311 of file library_manager.cpp.

References _, GetLibraryStatuses(), and LOAD_ERROR.

Referenced by PCB_EDIT_FRAME::KiwayMailIn(), SCH_EDIT_FRAME::KiwayMailIn(), LoadOne(), PCB::IFACE::PreloadLibraries(), and SCH::IFACE::PreloadLibraries().

◆ GetLibraryNames()

std::vector< wxString > LIBRARY_MANAGER_ADAPTER::GetLibraryNames ( ) const

inherited

Returns a list of library nicknames that are available (skips any that failed to load)

Definition at line 1107 of file library_manager.cpp.

References fetchIfLoaded(), m_manager, traceLibraries, and Type().

Referenced by CVPCB_MAINFRAME::BuildLibrariesList(), DIALOG_SYMBOL_REMAP::createProjectSymbolLibTable(), DESIGN_BLOCK_LIBRARY_ADAPTER::DesignBlockLoadWithOptionalNickname(), filterFootprints(), FOOTPRINT_LIBRARY_ADAPTER::GenerateTimestamp(), SYMBOL_LIBRARY_MANAGER::GetLibraryCount(), PCB_BASE_FRAME::GetLibraryItemsForListDialog(), SCH_BASE_FRAME::GetLibraryItemsForListDialog(), guessNickname(), FOOTPRINT_LIBRARY_ADAPTER::LoadFootprintWithOptionalNickname(), FOOTPRINT_VIEWER_FRAME::OnActivate(), DIALOG_EDIT_SYMBOLS_LIBID::onClickOrphansButton(), SCH_EDIT_FRAME::OpenProjectFiles(), FOOTPRINT_LIST_IMPL::ReadFootprintFiles(), SYMBOL_VIEWER_FRAME::ReCreateLibList(), FOOTPRINT_VIEWER_FRAME::ReCreateLibraryList(), SAVE_AS_DIALOG::SAVE_AS_DIALOG(), and Type().

◆ GetLibraryStatus()

std::optional< LIB_STATUS > LIBRARY_MANAGER_ADAPTER::GetLibraryStatus ( const wxString & aNickname ) const

inherited

Returns the status of a loaded library, or nullopt if the library hasn't been loaded (yet)

Definition at line 1564 of file library_manager.cpp.

References find, globalLibs(), globalLibsMutex(), m_libraries, and m_librariesMutex.

Referenced by GetLibraryStatuses(), CV::kiface(), LoadOne(), SCH_EDIT_FRAME::OpenProjectFiles(), and SYMBOL_TREE_SYNCHRONIZING_ADAPTER::Sync().

◆ GetLibraryStatuses()

std::vector< std::pair< wxString, LIB_STATUS > > LIBRARY_MANAGER_ADAPTER::GetLibraryStatuses ( ) const

inherited

Returns a list of all library nicknames and their status (even if they failed to load)

Definition at line 1283 of file library_manager.cpp.

References _, GetLibraryStatus(), LOAD_ERROR, m_manager, result, and Type().

Referenced by BOOST_AUTO_TEST_CASE(), GetLibraryLoadErrors(), LoadOne(), and SYMBOL_TREE_SYNCHRONIZING_ADAPTER::Sync().

◆ GetRow()

std::optional< LIBRARY_TABLE_ROW * > LIBRARY_MANAGER_ADAPTER::GetRow	(	const wxString &	aNickname,
		LIBRARY_TABLE_SCOPE	aScope = LIBRARY_TABLE_SCOPE::BOTH ) const

inherited

Like LIBRARY_MANAGER::GetRow but filtered to the LIBRARY_TABLE_TYPE of this adapter.

Definition at line 1176 of file library_manager.cpp.

References m_manager, and Type().

Referenced by EXPORTER_STEP::buildFootprint3DShapes(), SYMBOL_VIEWER_FRAME::DisplayLibInfos(), CVPCB_MAINFRAME::DisplayStatus(), SCH_EDITOR_CONTROL::ExportSymbolsToLibrary(), EXPORTER_PCB_VRML::ExportVrmlFootprint(), SYMBOL_TREE_SYNCHRONIZING_ADAPTER::GetValue(), idf_export_footprint(), SYMBOL_EDIT_FRAME::IsSymbolFromLegacyLibrary(), SYMBOL_EDIT_FRAME::KiwayMailIn(), SYMBOL_VIEWER_FRAME::KiwayMailIn(), RENDER_3D_RAYTRACE_BASE::load3DModels(), RENDER_3D_OPENGL::load3dModels(), SCH_EDIT_FRAME::LoadSheetFromFile(), PANEL_FP_PROPERTIES_3D_MODEL::OnAdd3DModel(), PANEL_SYMBOL_CHOOSER::PANEL_SYMBOL_CHOOSER(), SYMBOL_VIEWER_FRAME::ReCreateLibList(), SYMBOL_EDIT_FRAME::replaceLibTableEntry(), DRC_TEST_PROVIDER_LIBRARY_PARITY::Run(), SYMBOL_EDIT_FRAME::saveLibrary(), PCB_BASE_FRAME::setFPWatcher(), SYMBOL_TREE_SYNCHRONIZING_ADAPTER::Sync(), DIALOG_FOOTPRINT_ASSOCIATIONS::TransferDataToWindow(), Type(), SCH_SCREEN::UpdateSymbolLinks(), and PANEL_FP_PROPERTIES_3D_MODEL::validateModelExists().

◆ getUri()

wxString LIBRARY_MANAGER_ADAPTER::getUri ( const LIBRARY_TABLE_ROW * aRow )

staticprotectedinherited

Definition at line 1436 of file library_manager.cpp.

References LIBRARY_MANAGER::ExpandURI(), Pgm(), Prj(), and LIBRARY_TABLE_ROW::URI().

◆ globalLibs() [1/2]

std::map< wxString, LIB_DATA > & DESIGN_BLOCK_LIBRARY_ADAPTER::globalLibs ( ) const

inlineoverrideprotectedvirtual

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 150 of file design_block_library_adapter.h.

References GlobalLibraries.

◆ globalLibs() [2/2]

std::map< wxString, LIB_DATA > & DESIGN_BLOCK_LIBRARY_ADAPTER::globalLibs ( )

inlineoverrideprotectedvirtual

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 149 of file design_block_library_adapter.h.

References GlobalLibraries.

◆ globalLibsMutex() [1/2]

std::shared_mutex & DESIGN_BLOCK_LIBRARY_ADAPTER::globalLibsMutex ( ) const

inlineoverrideprotectedvirtual

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 152 of file design_block_library_adapter.h.

References GlobalLibraryMutex.

◆ globalLibsMutex() [2/2]

std::shared_mutex & DESIGN_BLOCK_LIBRARY_ADAPTER::globalLibsMutex ( )

inlineoverrideprotectedvirtual

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 151 of file design_block_library_adapter.h.

References GlobalLibraryMutex.

◆ GlobalPathEnvVariableName()

wxString DESIGN_BLOCK_LIBRARY_ADAPTER::GlobalPathEnvVariableName ( )

static

Definition at line 45 of file design_block_library_adapter.cpp.

References ENV_VAR::GetVersionedEnvVarName().

Referenced by PANEL_DESIGN_BLOCK_LIB_TABLE::populateEnvironReadOnlyTable().

◆ GlobalTable()

LIBRARY_TABLE * LIBRARY_MANAGER_ADAPTER::GlobalTable ( ) const

inherited

Retrieves the global library table for this adapter type.

Definition at line 1082 of file library_manager.cpp.

References GLOBAL, m_manager, and Type().

Referenced by Type().

◆ GlobalTablesChanged()

void LIBRARY_MANAGER_ADAPTER::GlobalTablesChanged ( std::initializer_list< LIBRARY_TABLE_TYPE > aChangedTables = {} )

inherited

Notify the adapter that the global library tables have changed.

Definition at line 954 of file library_manager.cpp.

References abortLoad(), globalLibs(), globalLibsMutex(), and Type().

Referenced by Type().

◆ HasLibrary()

bool LIBRARY_MANAGER_ADAPTER::HasLibrary	(	const wxString &	aNickname,
		bool	aCheckEnabled = false ) const

inherited

Test for the existence of aNickname in the library tables.

Parameters

aCheckEnabled if true will only return true for enabled libraries

Returns: true if a library aNickname exists in the loaded tables.

Definition at line 1128 of file library_manager.cpp.

References fetchIfLoaded().

Referenced by SYMBOL_EDIT_FRAME::AddLibraryFile(), SYMBOL_EDIT_FRAME::addLibTableEntry(), SYMBOL_VIEWER_FRAME::ClickOnLibList(), SYMBOL_EDIT_FRAME::DdAddLibrary(), BOARD_INSPECTION_TOOL::DiffFootprint(), SCH_INSPECTION_TOOL::DiffSymbol(), FOOTPRINT_LIBRARY_ADAPTER::GenerateTimestamp(), DISPLAY_FOOTPRINTS_FRAME::GetFootprint(), CV::kiface(), FOOTPRINT_EDIT_FRAME::KiwayMailIn(), SYMBOL_EDIT_FRAME::KiwayMailIn(), SYMBOL_LIBRARY_MANAGER::LibraryExists(), SCH_EDIT_FRAME::LoadSheetFromFile(), PANEL_SYMBOL_CHOOSER::PANEL_SYMBOL_CHOOSER(), DRC_TEST_PROVIDER_LIBRARY_PARITY::Run(), SYMBOL_EDIT_FRAME::saveLibrary(), SCH_BASE_FRAME::SelectLibrary(), Type(), and SCH_SCREEN::UpdateSymbolLinks().

◆ IsDesignBlockLibWritable()

bool DESIGN_BLOCK_LIBRARY_ADAPTER::IsDesignBlockLibWritable ( const wxString & aNickname )

Return true if the library given by aNickname is writable.

Often system libraries are read only because of where they are installed.

Exceptions

IO_ERROR if no library at aLibraryPath exists.

Definition at line 293 of file design_block_library_adapter.cpp.

References LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), LIBRARY_MANAGER_ADAPTER::getUri(), IO_BASE::IsLibraryWritable(), plugin(), and LIB_DATA::row.

◆ IsLibraryLoaded()

bool LIBRARY_MANAGER_ADAPTER::IsLibraryLoaded ( const wxString & aNickname )

inherited

Definition at line 1243 of file library_manager.cpp.

References find, globalLibs(), globalLibsMutex(), LOADED, m_libraries, and m_librariesMutex.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SYMBOL_LIBRARY_MANAGER::IsLibraryLoaded(), LoadOne(), DRC_TEST_PROVIDER_LIBRARY_PARITY::Run(), and ERC_TESTER::TestLibSymbolIssues().

◆ IsWritable()

bool LIBRARY_MANAGER_ADAPTER::IsWritable ( const wxString & aNickname ) const

virtualinherited

Return true if the given nickname exists and is not a read-only library.

Definition at line 1393 of file library_manager.cpp.

References fetchIfLoaded(), getUri(), IO_BASE::IsLibraryWritable(), LIB_DATA::plugin, result, and LIB_DATA::row.

Referenced by LoadOne().

◆ LibraryError()

std::optional< LIBRARY_ERROR > LIBRARY_MANAGER_ADAPTER::LibraryError ( const wxString & aNickname ) const

virtualinherited

Definition at line 1263 of file library_manager.cpp.

References find, globalLibs(), globalLibsMutex(), m_libraries, and m_librariesMutex.

Referenced by LIB_TABLE_GRID_TRICKS::onGridCellLeftClick().

◆ LoadDesignBlock()

DESIGN_BLOCK * DESIGN_BLOCK_LIBRARY_ADAPTER::LoadDesignBlock	(	const wxString &	aNickname,
		const wxString &	aDesignBlockName,
		bool	aKeepUUID = false )

Load a design block having aDesignBlockName from the library given by aNickname.

Parameters

aNickname	is a locator for the "library", it is a "name" in #LIB_TABLE_ROW.
aDesignBlockName	is the name of the design block to load.
aKeepUUID	= true to keep initial items UUID, false to set new UUID normally true if loaded in the design block editor, false if loaded in the board editor. Used only in kicad_plugin

Returns: the design block if found caller owns it, else NULL if not found.

Exceptions

IO_ERROR if the library cannot be found or read. No exception is thrown in the case where aDesignBlockName cannot be found.

Definition at line 201 of file design_block_library_adapter.cpp.

References dbplugin(), LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), LIB_DATA::row, traceLibraries, and IO_ERROR::What().

Referenced by DesignBlockLoadWithOptionalNickname(), and PANEL_DESIGN_BLOCK_CHOOSER::rebuildHistoryNode().

◆ loadFromScope()

LIBRARY_RESULT< LIB_DATA * > LIBRARY_MANAGER_ADAPTER::loadFromScope	(	const wxString &	aNickname,
		LIBRARY_TABLE_SCOPE	aScope,
		std::map< wxString, LIB_DATA > &	aTarget,
		std::shared_mutex &	aMutex )

protectedinherited

Definition at line 1502 of file library_manager.cpp.

References createPlugin(), LOADING, m_manager, LIBRARY_TABLE_ROW::Nickname(), plugin(), result, traceLibraries, and Type().

Referenced by enumerateLibrary(), loadIfNeeded(), and ReloadLibraryEntry().

◆ loadIfNeeded()

LIBRARY_RESULT< LIB_DATA * > LIBRARY_MANAGER_ADAPTER::loadIfNeeded ( const wxString & aNickname )

protectedinherited

Fetches a loaded library, triggering a load of that library if it isn't loaded yet.

Definition at line 1546 of file library_manager.cpp.

References _, GLOBAL, globalLibs(), globalLibsMutex(), loadFromScope(), m_libraries, m_librariesMutex, PROJECT, and result.

Referenced by CreateLibrary(), DeleteLibrary(), enumerateLibrary(), LoadLibraryEntry(), DESIGN_BLOCK_LIBRARY_ADAPTER::LoadOne(), FOOTPRINT_LIBRARY_ADAPTER::LoadOne(), SYMBOL_LIBRARY_ADAPTER::LoadOne(), and SYMBOL_LIBRARY_ADAPTER::SaveSymbol().

◆ LoadLibraryEntry()

std::optional< LIB_STATUS > LIBRARY_MANAGER_ADAPTER::LoadLibraryEntry ( const wxString & aNickname )

inherited

Synchronously loads the named library to LOADED state.

Returns the resulting status, or nullopt if the library is not found in any table.

Definition at line 1331 of file library_manager.cpp.

References loadIfNeeded(), LoadOne(), and result.

Referenced by LoadOne().

◆ LoadOne() [1/2]

std::optional< LIB_STATUS > DESIGN_BLOCK_LIBRARY_ADAPTER::LoadOne ( const wxString & nickname )

Definition at line 128 of file design_block_library_adapter.cpp.

References LOAD_ERROR, LIBRARY_MANAGER_ADAPTER::loadIfNeeded(), LoadOne(), and result.

◆ LoadOne() [2/2]

std::optional< LIB_STATUS > DESIGN_BLOCK_LIBRARY_ADAPTER::LoadOne ( LIB_DATA * aLib )

overridevirtual

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 104 of file design_block_library_adapter.cpp.

References dbplugin(), DESIGN_BLOCK_IO::DesignBlockEnumerate(), LIB_STATUS::error, LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), LOAD_ERROR, LIB_STATUS::load_status, LOADED, LOADING, LIBRARY_TABLE_ROW::Nickname(), LIB_DATA::row, LIB_DATA::status, traceLibraries, and IO_ERROR::What().

Referenced by DESIGN_BLOCK_PANE::AddDesignBlockLibrary(), and LoadOne().

◆ Manager()

LIBRARY_MANAGER & LIBRARY_MANAGER_ADAPTER::Manager ( ) const

inherited

Definition at line 919 of file library_manager.cpp.

References m_manager.

◆ plugin()

IO_BASE * DESIGN_BLOCK_LIBRARY_ADAPTER::plugin ( const LIB_DATA * aRow )

overrideprotectedvirtual

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 90 of file design_block_library_adapter.cpp.

References dbplugin().

Referenced by createPlugin(), and IsDesignBlockLibWritable().

◆ ProjectChanged()

void LIBRARY_MANAGER_ADAPTER::ProjectChanged ( )

virtualinherited

Notify the adapter that the active project has changed.

Definition at line 925 of file library_manager.cpp.

References resetProjectCache().

◆ ProjectTable()

std::optional< LIBRARY_TABLE * > LIBRARY_MANAGER_ADAPTER::ProjectTable ( ) const

inherited

Retrieves the project library table for this adapter type, or nullopt if one doesn't exist.

Definition at line 1089 of file library_manager.cpp.

References m_manager, PROJECT, and Type().

Referenced by SCH_IO_CADSTAR_ARCHIVE::LoadSchematicFile(), SCH_IO_EAGLE::LoadSchematicFile(), SCH_IO_EASYEDAPRO::LoadSchematicFile(), SCH_EDIT_FRAME::LoadSheetFromFile(), SCH_EDIT_FRAME::OpenProjectFiles(), and Type().

◆ ProjectTablesChanged()

void LIBRARY_MANAGER_ADAPTER::ProjectTablesChanged ( std::initializer_list< LIBRARY_TABLE_TYPE > aChangedTables = {} )

inherited

Notify the adapter that the project library tables are about to be rebuilt.

Mirrors GlobalTablesChanged: aborts any in-progress loads and invalidates cached LIB_DATA entries so raw LIBRARY_TABLE_ROW pointers do not dangle when the backing LIBRARY_TABLE objects are destroyed and rebuilt. Entries are reset in place (rather than erased) so their nicknames continue to mask same-named global libraries until the project scope is repopulated.

Definition at line 979 of file library_manager.cpp.

References resetProjectCache(), and Type().

◆ ProjectTablesReloaded()

void LIBRARY_MANAGER_ADAPTER::ProjectTablesReloaded ( std::initializer_list< LIBRARY_TABLE_TYPE > aChangedTables = {} )

inherited

Complements ProjectTablesChanged by erasing project-scope cache entries whose nicknames no longer appear in the rebuilt project table.

Must be called AFTER the new project table is loaded; otherwise removed libraries would be permanently masked by stale sentinels installed during the reset.

Definition at line 999 of file library_manager.cpp.

References m_libraries, m_librariesMutex, m_manager, PROJECT, and Type().

◆ ReloadLibraryEntry()

void LIBRARY_MANAGER_ADAPTER::ReloadLibraryEntry	(	const wxString &	aNickname,
		LIBRARY_TABLE_SCOPE	aScope = LIBRARY_TABLE_SCOPE::BOTH )

inherited

Definition at line 1342 of file library_manager.cpp.

References BOTH, GLOBAL, globalLibs(), globalLibsMutex(), loadFromScope(), m_libraries, m_librariesMutex, PROJECT, result, traceLibraries, and UNINITIALIZED.

Referenced by LoadOne().

◆ resetProjectCache()

void LIBRARY_MANAGER_ADAPTER::resetProjectCache ( )

protectedinherited

Aborts pending loads and resets every project-scope cache entry in place (plugin and row cleared, status returned to INVALID) while preserving the nickname keys.

Keeping the keys acts as a sentinel: fetchIfLoaded() finds the entry, sees it is no longer LOADED, and returns nullopt instead of falling through to globalLibs(), which is what preserves project-over- global shadowing across a project table reload. Shared between ProjectChanged() and ProjectTablesChanged() so both hooks stay in sync.

Definition at line 931 of file library_manager.cpp.

References abortLoad(), m_libraries, and m_librariesMutex.

Referenced by enumerateLibrary(), ProjectChanged(), and ProjectTablesChanged().

◆ Rows()

std::vector< LIBRARY_TABLE_ROW * > LIBRARY_MANAGER_ADAPTER::Rows	(	LIBRARY_TABLE_SCOPE	aScope = LIBRARY_TABLE_SCOPE::BOTH,
		bool	aIncludeInvalid = false ) const

inherited

Like LIBRARY_MANAGER::Rows but filtered to the LIBRARY_TABLE_TYPE of this adapter.

Definition at line 1169 of file library_manager.cpp.

References m_manager, and Type().

Referenced by CVPCB_MAINFRAME::LoadFootprintFiles(), and Type().

◆ SaveDesignBlock()

DESIGN_BLOCK_LIBRARY_ADAPTER::SAVE_T DESIGN_BLOCK_LIBRARY_ADAPTER::SaveDesignBlock	(	const wxString &	aNickname,
		const DESIGN_BLOCK *	aDesignBlock,
		bool	aOverwrite = true )

Write aDesignBlock to an existing library given by aNickname.

If a design block by the same name already exists, it is replaced.

Parameters

aNickname	is a locator for the "library", it is a "name" in #LIB_TABLE_ROW.
aDesignBlock	is what to store in the library. The caller continues to own the design block after this call.
aOverwrite	when true means overwrite any existing design block by the same name, else if false means skip the write and return SAVE_SKIPPED.

Returns: SAVE_OK or SAVE_SKIPPED. If error saving, then IO_ERROR is thrown.

Exceptions

IO_ERROR if there is a problem saving.

Definition at line 262 of file design_block_library_adapter.cpp.

References dbplugin(), DesignBlockExists(), DESIGN_BLOCK_IO::DesignBlockSave(), LIBRARY_MANAGER_ADAPTER::fetchIfLoaded(), DESIGN_BLOCK::GetName(), LIBRARY_TABLE_ROW::GetOptionsMap(), LIBRARY_MANAGER_ADAPTER::getUri(), LIB_DATA::row, SAVE_OK, and SAVE_SKIPPED.

Referenced by PCB_EDIT_FRAME::SaveBoardAsDesignBlock(), SCH_EDIT_FRAME::SaveSelectionAsDesignBlock(), PCB_EDIT_FRAME::saveSelectionToDesignBlock(), SCH_EDIT_FRAME::SaveSheetAsDesignBlock(), PCB_EDIT_FRAME::UpdateDesignBlockFromBoard(), SCH_EDIT_FRAME::UpdateDesignBlockFromSelection(), and SCH_EDIT_FRAME::UpdateDesignBlockFromSheet().

◆ ShowConfigurationDialog()

virtual void LIBRARY_MANAGER_ADAPTER::ShowConfigurationDialog	(	const wxString &	aNickname,
		wxWindow *	aParent ) const

inlinevirtualinherited

Reimplemented in SYMBOL_LIBRARY_ADAPTER.

Definition at line 187 of file library_manager.h.

Referenced by LIB_TABLE_GRID_TRICKS::doPopupSelection(), and LIB_TABLE_GRID_TRICKS::onGridCellLeftClick().

◆ SupportsConfigurationDialog()

virtual bool LIBRARY_MANAGER_ADAPTER::SupportsConfigurationDialog ( const wxString & aNickname ) const

inlinevirtualinherited

Reimplemented in SYMBOL_LIBRARY_ADAPTER.

Definition at line 185 of file library_manager.h.

Referenced by LIB_TABLE_GRID_TRICKS::onGridCellLeftClick().

◆ Type()

LIBRARY_TABLE_TYPE DESIGN_BLOCK_LIBRARY_ADAPTER::Type ( ) const

inlineoverridevirtual

The type of library table this adapter works with.

Implements LIBRARY_MANAGER_ADAPTER.

Definition at line 40 of file design_block_library_adapter.h.

References DESIGN_BLOCK.

Member Data Documentation

◆ GlobalLibraries

LEAK_AT_EXIT< std::map< wxString, LIB_DATA > > DESIGN_BLOCK_LIBRARY_ADAPTER::GlobalLibraries

staticprivate

Definition at line 168 of file design_block_library_adapter.h.

Referenced by globalLibs(), and globalLibs().

◆ GlobalLibraryMutex

std::shared_mutex DESIGN_BLOCK_LIBRARY_ADAPTER::GlobalLibraryMutex

staticprivate

Definition at line 170 of file design_block_library_adapter.h.

Referenced by globalLibsMutex(), and globalLibsMutex().

◆ m_abort

std::atomic_bool LIBRARY_MANAGER_ADAPTER::m_abort

protectedinherited

Definition at line 240 of file library_manager.h.

Referenced by abortLoad().

◆ m_futures

std::vector<std::future<void> > LIBRARY_MANAGER_ADAPTER::m_futures

protectedinherited

Definition at line 241 of file library_manager.h.

Referenced by abortLoad(), AsyncLoad(), and BlockUntilLoaded().

◆ m_libraries

std::map<wxString, LIB_DATA> LIBRARY_MANAGER_ADAPTER::m_libraries

protectedinherited

Definition at line 236 of file library_manager.h.

Referenced by AsyncLoad(), fetchIfLoaded(), fetchIfLoaded(), GetLibraryStatus(), FOOTPRINT_LIBRARY_ADAPTER::IsFootprintLibWritable(), IsLibraryLoaded(), SYMBOL_LIBRARY_ADAPTER::IsSymbolLibWritable(), LibraryError(), loadIfNeeded(), ProjectTablesReloaded(), ReloadLibraryEntry(), and resetProjectCache().

◆ m_librariesMutex

std::shared_mutex LIBRARY_MANAGER_ADAPTER::m_librariesMutex

mutableprotectedinherited

Definition at line 238 of file library_manager.h.

Referenced by AsyncLoad(), fetchIfLoaded(), fetchIfLoaded(), GetLibraryStatus(), FOOTPRINT_LIBRARY_ADAPTER::IsFootprintLibWritable(), IsLibraryLoaded(), SYMBOL_LIBRARY_ADAPTER::IsSymbolLibWritable(), LibraryError(), loadIfNeeded(), ProjectTablesReloaded(), ReloadLibraryEntry(), and resetProjectCache().

◆ m_loadCount

std::atomic<size_t> LIBRARY_MANAGER_ADAPTER::m_loadCount { 0 }

protectedinherited

Definition at line 243 of file library_manager.h.

Referenced by abortLoad(), AsyncLoad(), AsyncLoadProgress(), and BlockUntilLoaded().

◆ m_loadMutex

std::mutex LIBRARY_MANAGER_ADAPTER::m_loadMutex

protectedinherited

Definition at line 245 of file library_manager.h.

Referenced by abortLoad(), AsyncLoad(), and BlockUntilLoaded().

◆ m_loadTotal

std::atomic<size_t> LIBRARY_MANAGER_ADAPTER::m_loadTotal { 0 }

protectedinherited

Definition at line 244 of file library_manager.h.

Referenced by abortLoad(), AsyncLoad(), AsyncLoadProgress(), and BlockUntilLoaded().

◆ m_manager

LIBRARY_MANAGER& LIBRARY_MANAGER_ADAPTER::m_manager

protectedinherited

Definition at line 233 of file library_manager.h.

Referenced by AsyncLoad(), DESIGN_BLOCK_LIBRARY_ADAPTER::createPlugin(), FOOTPRINT_LIBRARY_ADAPTER::createPlugin(), SYMBOL_LIBRARY_ADAPTER::createPlugin(), FindLibraryByURI(), FindRowByURI(), GetLibraryNames(), GetLibraryStatuses(), SYMBOL_LIBRARY_ADAPTER::GetModifyHash(), GetRow(), GlobalTable(), LIBRARY_MANAGER_ADAPTER(), loadFromScope(), Manager(), ProjectTable(), ProjectTablesReloaded(), and Rows().

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

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Private Member Functions

Static Private Attributes

Detailed Description

Member Enumeration Documentation

◆ SAVE_T

Constructor & Destructor Documentation

◆ DESIGN_BLOCK_LIBRARY_ADAPTER()

Member Function Documentation

◆ AbortAsyncLoad()

◆ abortLoad()

◆ AsyncLoad()

◆ AsyncLoadProgress()

◆ BlockUntilLoaded()

◆ CheckTableRow()

◆ CreateLibrary()

◆ createPlugin()

◆ dbplugin()

◆ DeleteDesignBlock()

◆ DeleteLibrary()

◆ DesignBlockExists()

◆ DesignBlockLoadWithOptionalNickname()

◆ enumerateLibrary()

◆ fetchIfLoaded() [1/2]

◆ fetchIfLoaded() [2/2]

◆ FindLibraryByURI()

◆ FindRowByURI()

◆ GetDesignBlockNames()

◆ GetDesignBlocks()

◆ GetEnumeratedDesignBlock()

◆ GetLibraryDescription()

◆ GetLibraryLoadErrors()

◆ GetLibraryNames()

◆ GetLibraryStatus()

◆ GetLibraryStatuses()

◆ GetRow()

◆ getUri()

◆ globalLibs() [1/2]

◆ globalLibs() [2/2]

◆ globalLibsMutex() [1/2]

◆ globalLibsMutex() [2/2]

◆ GlobalPathEnvVariableName()

◆ GlobalTable()

◆ GlobalTablesChanged()

◆ HasLibrary()

◆ IsDesignBlockLibWritable()

◆ IsLibraryLoaded()

◆ IsWritable()

◆ LibraryError()

◆ LoadDesignBlock()

◆ loadFromScope()

◆ loadIfNeeded()

◆ LoadLibraryEntry()

◆ LoadOne() [1/2]

◆ LoadOne() [2/2]

◆ Manager()

◆ plugin()

◆ ProjectChanged()

◆ ProjectTable()

◆ ProjectTablesChanged()

◆ ProjectTablesReloaded()

◆ ReloadLibraryEntry()

◆ resetProjectCache()

◆ Rows()

◆ SaveDesignBlock()

◆ ShowConfigurationDialog()

◆ SupportsConfigurationDialog()

◆ Type()

Member Data Documentation

◆ GlobalLibraries

◆ GlobalLibraryMutex

◆ m_abort

◆ m_futures

◆ m_libraries

◆ m_librariesMutex