|
KiCad PCB EDA Suite
|
#include <pcb_io_odbpp.h>
Public Member Functions | |
| PCB_IO_ODBPP () | |
| ~PCB_IO_ODBPP () override | |
| void | SaveBoard (const wxString &aFileName, BOARD &aBoard, const std::map< std::string, UTF8 > *aProperties=nullptr) override |
| Write aBoard to a storage file in a format that this PCB_IO implementation knows about or it can be used to write a portion of aBoard to a special kind of export file. | |
| const IO_BASE::IO_FILE_DESC | GetBoardFileDesc () const override |
| Returns board file description for the PCB_IO. | |
| const IO_BASE::IO_FILE_DESC | GetLibraryDesc () const override |
| Get the descriptor for the library container that this IO plugin operates on. | |
| std::vector< FOOTPRINT * > | GetImportedCachedLibraryFootprints () override |
| Return a container with the cached library footprints generated in the last call to Load. | |
| long long | GetLibraryTimestamp (const wxString &aLibraryPath) const override |
| Generate a timestamp representing all the files in the library (including the library directory). | |
| bool | CanReadBoard (const wxString &aFileName) const override |
| Checks if this PCB_IO can read the specified board file. | |
| bool | CanReadFootprint (const wxString &aFileName) const override |
| Checks if this PCB_IO can read a footprint from specified file or directory. | |
| bool | CanReadLibrary (const wxString &aFileName) const override |
| Checks if this IO object can read the specified library file/directory. | |
| std::vector< std::pair< PCB_LAYER_ID, wxString > > & | GetLayerNameList () |
| std::map< PCB_LAYER_ID, std::map< int, std::vector< BOARD_ITEM * > > > & | GetLayerElementsMap () |
| std::vector< std::shared_ptr< FOOTPRINT > > & | GetLoadedFootprintList () |
| std::map< ODB_DRILL_SPAN, std::vector< BOARD_ITEM * > > & | GetDrillLayerItemsMap () |
| std::map< ODB_DRILL_SPAN, wxString > & | GetDrillSpanNameMap () |
| std::map< std::tuple< ODB_AUX_LAYER_TYPE, PCB_LAYER_ID, PCB_LAYER_ID >, std::vector< BOARD_ITEM * > > & | GetAuxilliaryLayerItemsMap () |
| std::map< std::pair< PCB_LAYER_ID, PCB_LAYER_ID >, std::vector< BOARD_ITEM * > > & | GetSlotHolesMap () |
| std::map< const PAD *, EDA_DATA::SUB_NET_TOEPRINT * > & | GetPadSubnetMap () |
| std::map< std::pair< PCB_LAYER_ID, ZONE * >, EDA_DATA::SUB_NET_PLANE * > & | GetPlaneSubnetMap () |
| std::map< PCB_TRACK *, EDA_DATA::SUB_NET * > & | GetViaTraceSubnetMap () |
| bool | GenerateFiles (ODB_TREE_WRITER &writer) |
| bool | ExportODB (const wxString &aFileName) |
| void | CreateEntity () |
| bool | CreateDirectories (ODB_TREE_WRITER &writer) |
| void | ClearLoadedFootprints () |
| bool | IsPCB_IO () const override |
| Work-around for lack of dynamic_cast across compile units on Mac. | |
| virtual void | SetQueryUserCallback (std::function< bool(wxString aTitle, int aIcon, wxString aMessage, wxString aAction)> aCallback) |
| Registers a KIDIALOG callback for collecting info from the user. | |
| std::unique_ptr< BOARD > | LoadBoard (const wxString &aFileName, const std::map< std::string, UTF8 > *aProperties=nullptr, PROJECT *aProject=nullptr) |
| Load information from some input file format that this PCB_IO implementation knows about into new BOARD. | |
| void | LoadAndAppendBoard (const wxString &aFileName, BOARD &aAppendToMe, const std::map< std::string, UTF8 > *aProperties=nullptr, PROJECT *aProject=nullptr) |
| Same as LoadBoard(), but appends the loaded board to an existing board, which must already exist. | |
| virtual void | FootprintEnumerate (wxArrayString &aFootprintNames, const wxString &aLibraryPath, bool aBestEfforts, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Return a list of footprint names contained within the library at aLibraryPath. | |
| virtual std::unique_ptr< FOOTPRINT > | ImportFootprint (const wxString &aFootprintPath, wxString &aFootprintNameOut, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Load a single footprint from aFootprintPath and put its name in aFootprintNameOut. | |
| virtual std::unique_ptr< FOOTPRINT > | FootprintLoad (const wxString &aLibraryPath, const wxString &aFootprintName, bool aKeepUUID=false, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Load a footprint having aFootprintName from the aLibraryPath containing a library format that this PCB_IO knows about. | |
| virtual const FOOTPRINT * | GetEnumeratedFootprint (const wxString &aLibraryPath, const wxString &aFootprintName, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| A version of FootprintLoad() for use after FootprintEnumerate() for more efficient cache management in plugins that support it. | |
| virtual bool | CachesEnumeratedFootprints () const |
| Return true if GetEnumeratedFootprint() returns a borrowed pointer from an internal cache. | |
| virtual bool | FootprintExists (const wxString &aLibraryPath, const wxString &aFootprintName, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Check for the existence of a footprint. | |
| virtual void | FootprintSave (const wxString &aLibraryPath, const FOOTPRINT *aFootprint, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Write aFootprint to an existing library located at aLibraryPath. | |
| virtual void | FootprintDelete (const wxString &aLibraryPath, const wxString &aFootprintName, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Delete aFootprintName from the library at aLibraryPath. | |
| virtual void | ClearCachedFootprints (const wxString &aLibraryPath) |
| Clear any cached footprint data for the given library path. | |
| virtual void | GetLibraryOptions (std::map< std::string, UTF8 > *aListToAppendTo) const override |
| Append supported PLUGIN options to aListToAppenTo along with internationalized descriptions. | |
| const wxString & | GetName () const |
| Return a brief hard coded name for this IO interface. | |
| virtual void | SetReporter (REPORTER *aReporter) |
| Set an optional reporter for warnings/errors. | |
| virtual void | SetProgressReporter (PROGRESS_REPORTER *aReporter) |
| Set an optional progress reporter. | |
| virtual const IO_FILE_DESC | GetLibraryFileDesc () const |
| Get the descriptor for the individual library elements that this IO plugin operates on. | |
| virtual void | CreateLibrary (const wxString &aLibraryPath, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Create a new empty library at aLibraryPath empty. | |
| virtual bool | DeleteLibrary (const wxString &aLibraryPath, const std::map< std::string, UTF8 > *aProperties=nullptr) |
| Delete an existing library and returns true, or if library does not exist returns false, or throws an exception if library exists but is read only or cannot be deleted for some other reason. | |
| virtual bool | IsLibraryWritable (const wxString &aLibraryPath) |
| Return true if the library at aLibraryPath is writable. | |
| virtual bool | SupportsConfigurationDialog () const |
| virtual DIALOG_SHIM * | CreateConfigurationDialog (wxWindow *aParent) |
| virtual void | Report (const wxString &aText, SEVERITY aSeverity=RPT_SEVERITY_UNDEFINED) const |
| virtual void | AdvanceProgressPhase () |
Public Attributes | |
| std::shared_ptr< ODB_TREE_WRITER > | m_writer |
Static Public Attributes | |
| static double | m_scale = 1.0 / PCB_IU_PER_MM |
| Internal units to the output units named by m_unitsStr, for values written as data. | |
| static double | m_symbolScale = 1.0 / PL_IU_PER_MM |
| Internal units to thousandths of the output unit, the scale ODB++ symbol names use. | |
| static int | m_sigfig = 4 |
| static std::string | m_unitsStr = "MM" |
Protected Member Functions | |
| virtual void | loadBoard (const wxString &aFileName, BOARD &aBoard, bool aIsNewLoad, const std::map< std::string, UTF8 > *aProperties, PROJECT *aProject) |
| Parse aFileName into aBoard. | |
Protected Attributes | |
| const std::map< std::string, UTF8 > * | m_props |
| Properties passed via Save() or Load(), no ownership, may be NULL. | |
| wxString | m_name |
| Name of the IO loader. | |
| REPORTER * | m_reporter |
| Reporter to log errors/warnings to, may be nullptr. | |
| PROGRESS_REPORTER * | m_progressReporter |
| Progress reporter to track the progress of the operation, may be nullptr. | |
Private Member Functions | |
| template<typename T, typename... Args> | |
| void | Make (Args &&... args) |
Private Attributes | |
| BOARD * | m_board |
| std::vector< std::shared_ptr< FOOTPRINT > > | m_loaded_footprints |
| std::vector< std::pair< PCB_LAYER_ID, wxString > > | m_layer_name_list |
| std::map< ODB_DRILL_SPAN, std::vector< BOARD_ITEM * > > | m_drill_layers |
| std::map< ODB_DRILL_SPAN, wxString > | m_drill_span_names |
| std::map< std::tuple< ODB_AUX_LAYER_TYPE, PCB_LAYER_ID, PCB_LAYER_ID >, std::vector< BOARD_ITEM * > > | m_auxilliary_layers |
| std::map< std::pair< PCB_LAYER_ID, PCB_LAYER_ID >, std::vector< BOARD_ITEM * > > | m_slot_holes |
| std::map< PCB_LAYER_ID, std::map< int, std::vector< BOARD_ITEM * > > > | m_layer_elements |
| std::map< const PAD *, EDA_DATA::SUB_NET_TOEPRINT * > | m_topeprint_subnets |
| std::map< std::pair< PCB_LAYER_ID, ZONE * >, EDA_DATA::SUB_NET_PLANE * > | m_plane_subnets |
| std::map< PCB_TRACK *, EDA_DATA::SUB_NET * > | m_via_trace_subnets |
| std::vector< std::shared_ptr< ODB_ENTITY_BASE > > | m_entities |
Definition at line 114 of file pcb_io_odbpp.h.
|
inline |
Definition at line 117 of file pcb_io_odbpp.h.
References m_board, and PCB_IO::PCB_IO().
|
override |
Definition at line 39 of file pcb_io_odbpp.cpp.
References ClearLoadedFootprints().
|
virtualinherited |
Definition at line 133 of file io_base.cpp.
References m_progressReporter, and THROW_IO_CANCELLED.
|
inlinevirtualinherited |
Return true if GetEnumeratedFootprint() returns a borrowed pointer from an internal cache.
When true, the caller must NOT delete the returned pointer. When false (the default), GetEnumeratedFootprint() allocates a new FOOTPRINT and the caller owns the memory.
Reimplemented in PCB_IO_KICAD_SEXPR.
|
inlineoverridevirtual |
Checks if this PCB_IO can read the specified board file.
If not overriden, extension check is used.
Reimplemented from PCB_IO.
Definition at line 141 of file pcb_io_odbpp.h.
|
inlineoverridevirtual |
Checks if this PCB_IO can read a footprint from specified file or directory.
If not overriden, extension check is used.
Reimplemented from PCB_IO.
Definition at line 144 of file pcb_io_odbpp.h.
|
inlineoverridevirtual |
Checks if this IO object can read the specified library file/directory.
If not overridden, extension check is used.
Reimplemented from IO_BASE.
Definition at line 147 of file pcb_io_odbpp.h.
|
inlinevirtualinherited |
Clear any cached footprint data for the given library path.
This is used to free memory after footprints have been loaded into another cache. The default implementation does nothing; plugins with caches should override.
| aLibraryPath | is the path of the library whose cache should be cleared. |
Reimplemented in PCB_IO_KICAD_SEXPR.
| void PCB_IO_ODBPP::ClearLoadedFootprints | ( | ) |
Definition at line 45 of file pcb_io_odbpp.cpp.
References m_loaded_footprints.
Referenced by ~PCB_IO_ODBPP().
|
inlinevirtualinherited |
Reimplemented in SCH_IO_DATABASE.
| bool PCB_IO_ODBPP::CreateDirectories | ( | ODB_TREE_WRITER & | writer | ) |
| void PCB_IO_ODBPP::CreateEntity | ( | ) |
Definition at line 51 of file pcb_io_odbpp.cpp.
References m_board, and Make().
Referenced by ExportODB().
|
virtualinherited |
Create a new empty library at aLibraryPath empty.
It is an error to attempt to create an existing library or to attempt to create on a "read only" location.
| aLibraryPath | is a locator for the "library", usually a directory, file, or URL containing several elements. |
| aProperties | is an associative array that can be used to tell the library create function anything special, because it can take any number of additional named tuning arguments that the IO is known to support. The caller continues to own this object (IO may not delete it), and IOs should expect it to be optionally NULL. |
| IO_ERROR | if there is a problem finding the library, or creating it. |
Reimplemented in DESIGN_BLOCK_IO, PCB_IO_KICAD_SEXPR, SCH_IO_KICAD_LEGACY, and SCH_IO_KICAD_SEXPR.
Definition at line 46 of file io_base.cpp.
References NOT_IMPLEMENTED.
Referenced by LIBRARY_MANAGER_ADAPTER::CreateLibrary().
|
virtualinherited |
Delete an existing library and returns true, or if library does not exist returns false, or throws an exception if library exists but is read only or cannot be deleted for some other reason.
| aLibraryPath | is a locator for the "library", usually a directory or file which will contain several elements. |
| aProperties | is an associative array that can be used to tell the library delete implementation function anything special, because it can take any number of additional named tuning arguments that the plugin is known to support. The caller continues to own this object (plugin may not delete it), and plugins should expect it to be optionally NULL. |
| IO_ERROR | if there is a problem deleting an existing library. |
Reimplemented in DESIGN_BLOCK_IO, PCB_IO_GEDA, PCB_IO_KICAD_LEGACY, PCB_IO_KICAD_SEXPR, SCH_IO_KICAD_LEGACY, and SCH_IO_KICAD_SEXPR.
Definition at line 53 of file io_base.cpp.
References NOT_IMPLEMENTED.
Referenced by LIBRARY_MANAGER_ADAPTER::DeleteLibrary().
| bool PCB_IO_ODBPP::ExportODB | ( | const wxString & | aFileName | ) |
Definition at line 85 of file pcb_io_odbpp.cpp.
References _, CreateEntity(), GenerateFiles(), m_entities, IO_BASE::m_progressReporter, IO_BASE::Report(), and RPT_SEVERITY_ERROR.
Referenced by SaveBoard().
|
virtualinherited |
Delete aFootprintName from the library at aLibraryPath.
| aLibraryPath | is a locator for the "library", usually a directory, file, or URL containing several footprints. |
| aFootprintName | is the name of a footprint to delete from the specified library. |
| aProperties | is an associative array that can be used to tell the library delete function anything special, because it can take any number of additional named tuning arguments that the plugin is known to support. The caller continues to own this object (plugin may not delete it), and plugins should expect it to be optionally NULL. |
| IO_ERROR | if there is a problem finding the footprint or the library, or deleting it. |
Reimplemented in PCB_IO_GEDA, and PCB_IO_KICAD_SEXPR.
Definition at line 177 of file pcb_io.cpp.
References NOT_IMPLEMENTED.
Referenced by FOOTPRINT_LIBRARY_ADAPTER::DeleteFootprint().
|
virtualinherited |
Return a list of footprint names contained within the library at aLibraryPath.
| aLibraryPath | is a locator for the "library", usually a directory, file, or URL containing several footprints. |
| aProperties | is an associative array that can be used to tell the plugin anything needed about how to perform with respect to aLibraryPath. The caller continues to own this object (plugin may not delete it), and plugins should expect it to be optionally NULL. |
| aFootprintNames | is the array of available footprint names inside a library. |
| aBestEfforts | if true, don't throw on errors, just return an empty list. |
| IO_ERROR | if the library cannot be found, or footprint cannot be loaded. |
Reimplemented in PCB_IO_ALTIUM_DESIGNER, PCB_IO_CADSTAR_ARCHIVE, PCB_IO_EAGLE, PCB_IO_EASYEDA, PCB_IO_EASYEDAPRO, PCB_IO_EASYEDAPRO_V3, PCB_IO_GEDA, PCB_IO_KICAD_LEGACY, PCB_IO_KICAD_SEXPR, and PCB_IO_SPRINT_LAYOUT.
Definition at line 112 of file pcb_io.cpp.
References NOT_IMPLEMENTED.
Referenced by FOOTPRINT_LIBRARY_ADAPTER::GetFootprintNames(), ImportFootprint(), and FOOTPRINT_LIBRARY_ADAPTER::LoadOne().
|
virtualinherited |
Check for the existence of a footprint.
Reimplemented in PCB_IO_CADSTAR_ARCHIVE, and PCB_IO_KICAD_SEXPR.
Definition at line 152 of file pcb_io.cpp.
References FootprintLoad().
Referenced by FOOTPRINT_LIBRARY_ADAPTER::FootprintExists().
|
virtualinherited |
Load a footprint having aFootprintName from the aLibraryPath containing a library format that this PCB_IO knows about.
| aLibraryPath | is a locator for the "library", usually a directory, file, or URL containing several footprints. |
| aFootprintName | is the name of the footprint to load. |
| aProperties | is an associative array that can be used to tell the loader implementation to do something special, because it can take any number of additional named tuning arguments that the plugin is known to support. The caller continues to own this object (plugin may not delete it), and plugins should expect it to be optionally NULL. |
| aKeepUUID | = true to keep initial items UUID, false to set new UUID normally true if loaded in the footprint editor, false if loaded in the board editor. Make sense only in kicad_plugin |
| IO_ERROR | if the library cannot be found or read. No exception is thrown in the case where aFootprintName cannot be found. |
Reimplemented in PCB_IO_ALTIUM_DESIGNER, PCB_IO_CADSTAR_ARCHIVE, PCB_IO_EAGLE, PCB_IO_EASYEDA, PCB_IO_EASYEDAPRO, PCB_IO_EASYEDAPRO_V3, PCB_IO_GEDA, PCB_IO_KICAD_LEGACY, PCB_IO_KICAD_SEXPR, and PCB_IO_SPRINT_LAYOUT.
Definition at line 160 of file pcb_io.cpp.
References NOT_IMPLEMENTED.
Referenced by FootprintExists(), GetEnumeratedFootprint(), ImportFootprint(), FOOTPRINT_LIBRARY_ADAPTER::LoadFootprint(), and FOOTPRINT_LIBRARY_ADAPTER::SaveFootprint().
|
virtualinherited |
Write aFootprint to an existing library located at aLibraryPath.
If a footprint by the same name already exists, it is replaced.
| aLibraryPath | is a locator for the "library", usually a directory, file, or URL containing several footprints. |
| aFootprint | is what to store in the library. The caller continues to own the footprint after this call. |
| aProperties | is an associative array that can be used to tell the saver how to save the footprint, because it can take any number of additional named tuning arguments that the plugin is known to support. The caller continues to own this object (plugin may not delete it), and plugins should expect it to be optionally NULL. |
| IO_ERROR | if there is a problem saving. |
Reimplemented in PCB_IO_KICAD_SEXPR.
Definition at line 169 of file pcb_io.cpp.
References NOT_IMPLEMENTED.
Referenced by FOOTPRINT_LIBRARY_ADAPTER::SaveFootprint().
| bool PCB_IO_ODBPP::GenerateFiles | ( | ODB_TREE_WRITER & | writer | ) |
|
inline |
Definition at line 177 of file pcb_io_odbpp.h.
References m_auxilliary_layers.
|
inlineoverridevirtual |
Returns board file description for the PCB_IO.
Reimplemented from PCB_IO.
Definition at line 124 of file pcb_io_odbpp.h.
References _HKI.
|
inline |
Definition at line 165 of file pcb_io_odbpp.h.
References m_drill_layers.
|
inline |
Definition at line 170 of file pcb_io_odbpp.h.
References m_drill_span_names.
|
virtualinherited |
A version of FootprintLoad() for use after FootprintEnumerate() for more efficient cache management in plugins that support it.
Whether the returned pointer is borrowed or owned by the caller depends on the plugin. Use CachesEnumeratedFootprints() to determine.
Reimplemented in PCB_IO_KICAD_SEXPR.
Definition at line 144 of file pcb_io.cpp.
References FootprintLoad().
|
overridevirtual |
Return a container with the cached library footprints generated in the last call to Load.
This function is intended to be used ONLY by the non-KiCad board importers for the purpose of obtaining the footprint library of the design and creating a project-specific library.
Reimplemented from PCB_IO.
Definition at line 132 of file pcb_io_odbpp.cpp.
References m_loaded_footprints.
|
inline |
Definition at line 155 of file pcb_io_odbpp.h.
References m_layer_elements.
|
inline |
Definition at line 150 of file pcb_io_odbpp.h.
References m_layer_name_list.
|
inlineoverridevirtual |
Get the descriptor for the library container that this IO plugin operates on.
Implements IO_BASE.
Definition at line 129 of file pcb_io_odbpp.h.
|
inlinevirtualinherited |
Get the descriptor for the individual library elements that this IO plugin operates on.
For libraries where all the elements are in a single container (e.g. all elements in a single file), then this will return the descriptor from IO_BASE::GetLibraryDesc().
Reimplemented in PCB_IO_EASYEDA, PCB_IO_EASYEDAPRO, PCB_IO_GEDA, PCB_IO_KICAD_SEXPR, and PCB_IO_SPRINT_LAYOUT.
Definition at line 117 of file io_base.h.
References GetLibraryDesc().
Referenced by PCB_IO::CanReadFootprint().
|
overridevirtualinherited |
Append supported PLUGIN options to aListToAppenTo along with internationalized descriptions.
Options are typically appended so that a derived #PLUGIN can call its base class function by the same name first, thus inheriting options declared there. Some base class options could pertain to all Footprint*() functions in all derived PLUGINs.
| aListToAppendTo | holds a tuple of
In the future perhaps aListToAppendTo evolves to something capable of also holding a wxValidator for the cells in said dialog: http://forums.wxwidgets.org/viewtopic.php?t=23277&p=104180. This would require a 3 column list, and introducing wx GUI knowledge to PLUGIN, which has been avoided to date. |
Reimplemented from IO_BASE.
Definition at line 185 of file pcb_io.cpp.
References _, and IO_BASE::GetLibraryOptions().
|
inlineoverridevirtual |
Generate a timestamp representing all the files in the library (including the library directory).
Timestamps should not be considered ordered, they either match or they don't.
Implements PCB_IO.
Definition at line 138 of file pcb_io_odbpp.h.
|
inline |
Definition at line 160 of file pcb_io_odbpp.h.
References m_loaded_footprints.
|
inlineinherited |
Return a brief hard coded name for this IO interface.
Definition at line 79 of file io_base.h.
References m_name.
Referenced by SCH_IO_EASYEDAPRO_V3::EnumerateSymbolLib(), SCH_IO_EASYEDAPRO_V3::LoadSymbol(), SCH_IO_ALTIUM::ParseAltiumSch(), and SCH_IO_ALTIUM::ParseLibFile().
|
inline |
Definition at line 188 of file pcb_io_odbpp.h.
References m_topeprint_subnets.
Referenced by FEATURES_MANAGER::AddPad().
|
inline |
Definition at line 193 of file pcb_io_odbpp.h.
References m_plane_subnets.
Referenced by FEATURES_MANAGER::AddZone().
|
inline |
Definition at line 183 of file pcb_io_odbpp.h.
References m_slot_holes.
|
inline |
Definition at line 198 of file pcb_io_odbpp.h.
References m_via_trace_subnets.
Referenced by FEATURES_MANAGER::AddTrack().
|
virtualinherited |
Load a single footprint from aFootprintPath and put its name in aFootprintNameOut.
If this is a footprint library, the first footprint should be loaded. The default implementation uses FootprintEnumerate and FootprintLoad to load first footprint.
| aLibraryPath | is a path of the footprint file. |
| aFootprintNameOut | is the name output of the loaded footprint. |
| aProperties | is an associative array that can be used to tell the loader implementation to do something special, because it can take any number of additional named tuning arguments that the plugin is known to support. The caller continues to own this object (plugin may not delete it), and plugins should expect it to be optionally NULL. |
| IO_ERROR | if the footprint cannot be found or read. |
Reimplemented in PCB_IO_GEDA, and PCB_IO_KICAD_SEXPR.
Definition at line 120 of file pcb_io.cpp.
References _, FootprintEnumerate(), FootprintLoad(), IO_BASE::Report(), and RPT_SEVERITY_WARNING.
|
virtualinherited |
Return true if the library at aLibraryPath is writable.
The system libraries are typically read only because of where they are installed..
| aLibraryPath | is a locator for the "library", usually a directory, file, or URL containing several footprints. |
| IO_ERROR | if no library at aLibraryPath exists. |
Reimplemented in DESIGN_BLOCK_IO, PCB_IO_ALLEGRO, PCB_IO_ALTIUM_DESIGNER, PCB_IO_CADSTAR_ARCHIVE, PCB_IO_EAGLE, PCB_IO_EASYEDA, PCB_IO_EASYEDAPRO, PCB_IO_EASYEDAPRO_V3, PCB_IO_GEDA, PCB_IO_KICAD_LEGACY, PCB_IO_KICAD_SEXPR, PCB_IO_SPRINT_LAYOUT, SCH_IO_ALTIUM, SCH_IO_CADSTAR_ARCHIVE, SCH_IO_DATABASE, SCH_IO_DIPTRACE, SCH_IO_EAGLE, SCH_IO_EASYEDA, SCH_IO_EASYEDAPRO, SCH_IO_EASYEDAPRO_V3, SCH_IO_GEDA, SCH_IO_HTTP_LIB, SCH_IO_KICAD_LEGACY, SCH_IO_KICAD_SEXPR, SCH_IO_ORCAD, SCH_IO_PADS, and SCH_IO_PCAD.
Definition at line 60 of file io_base.cpp.
References NOT_IMPLEMENTED.
Referenced by DESIGN_BLOCK_LIBRARY_ADAPTER::IsDesignBlockLibWritable(), and LIBRARY_MANAGER_ADAPTER::IsWritable().
|
inlineoverridevirtualinherited |
|
inherited |
Same as LoadBoard(), but appends the loaded board to an existing board, which must already exist.
| aAppendToMe | is the existing board to append to. The caller always owns it. |
Definition at line 85 of file pcb_io.cpp.
References loadBoard().
Referenced by PCB_CONTROL::AppendBoard(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and BOOST_AUTO_TEST_CASE().
|
inherited |
Load information from some input file format that this PCB_IO implementation knows about into new BOARD.
| aFileName | is the name of the file to use as input and may be foreign in nature or native in nature. |
| aProperties | is an associative array that can be used to tell the loader how to load the file, because it can take any number of additional named arguments that the plugin is known to support. These are tuning parameters for the import or load. The caller continues to own this object (plugin may not delete it), and plugins should expect it to be optionally NULL. |
| aProject | is the optional PROJECT object primarily used by third party importers. |
| IO_ERROR | if there is a problem loading, and its contents should say what went wrong, using line number and character offsets of the input file if possible. |
| IO_CANCELLED | if the user cancelled the load. |
Definition at line 72 of file pcb_io.cpp.
References loadBoard().
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), CachedLoad(), checkAllCopperFillZonesHaveClearance(), checkImportedOriginOffset(), PNS_LOG_FILE::Load(), LoadAndVerify(), EAGLE_BINARY_IMPORT_FIXTURE::loadBoard(), and KI_TEST::LoadBoardWithCapture().
|
protectedvirtualinherited |
Parse aFileName into aBoard.
The caller owns aBoard in both cases.
| aIsNewLoad | is true for a fresh load (adopt the file's setup, keep the file's UUIDs) and false when merging into an existing board (preserve its setup, regenerate UUIDs that would clash). |
Reimplemented in PCB_IO_ALLEGRO, PCB_IO_ALTIUM_CIRCUIT_MAKER, PCB_IO_ALTIUM_CIRCUIT_STUDIO, PCB_IO_ALTIUM_DESIGNER, PCB_IO_AUTOTRAX, PCB_IO_CADSTAR_ARCHIVE, PCB_IO_DIPTRACE, PCB_IO_EAGLE, PCB_IO_EASYEDA, PCB_IO_EASYEDAPRO, PCB_IO_EASYEDAPRO_V3, PCB_IO_FABMASTER, PCB_IO_GEDA, PCB_IO_KICAD_LEGACY, PCB_IO_KICAD_SEXPR, PCB_IO_PADS, PCB_IO_PADS_BINARY, PCB_IO_PCAD, PCB_IO_SOLIDWORKS, and PCB_IO_SPRINT_LAYOUT.
Definition at line 92 of file pcb_io.cpp.
References NOT_IMPLEMENTED.
Referenced by LoadAndAppendBoard(), and LoadBoard().
|
inlineprivate |
|
virtualinherited |
Definition at line 124 of file io_base.cpp.
References m_reporter.
Referenced by PCB_IO_IPC2581::addShape(), SCH_IO_EASYEDAPRO_V3::EnumerateSymbolLib(), PCB_IO_ODBPP::ExportODB(), PCB_IO_IPC2581::generateBOMSection(), PCB_IO_IPC2581::generateComponents(), PCB_IO_IPC2581::generateLayerSetDrill(), PCB_IO_IPC2581::generateLayerSetNet(), PCB_IO_IPC2581::generateProfile(), PCB_IO::ImportFootprint(), PCB_IO_DIPTRACE::loadBoard(), PCB_IO_EASYEDAPRO_V3::loadBoard(), SCH_IO_EAGLE::loadInstance(), SCH_IO_EAGLE::loadLibrary(), PCB_IO_KICAD_LEGACY::loadPAD(), PCB_IO_EAGLE::loadPolygon(), SCH_IO_EASYEDAPRO_V3::LoadSchematicFile(), SCH_IO_DATABASE::loadSymbolFromRow(), PCB_IO_KICAD_LEGACY::loadZONE_CONTAINER(), PCB_IO_EAGLE::packageCircle(), PCB_IO_EAGLE::packagePad(), PCB_IO_EAGLE::packagePolygon(), PCB_IO_EAGLE::packageRectangle(), PCB_IO_EAGLE::packageText(), and PCB_IO_EAGLE::packageWire().
|
overridevirtual |
Write aBoard to a storage file in a format that this PCB_IO implementation knows about or it can be used to write a portion of aBoard to a special kind of export file.
| aFileName | is the name of a file to save to on disk. |
| aBoard | is the class BOARD in memory document tree from which to extract information when writing to aFileName. The caller continues to own the BOARD, and the plugin should refrain from modifying the BOARD if possible. |
| aProperties | is an associative array that can be used to tell the saver how to save the file, because it can take any number of additional named tuning arguments that the plugin is known to support. The caller continues to own this object (plugin may not delete it) and plugins should expect it to be optionally NULL. |
| IO_ERROR | if there is a problem saving or exporting. |
Reimplemented from PCB_IO.
Definition at line 146 of file pcb_io_odbpp.cpp.
References ExportODB(), m_board, m_scale, m_sigfig, m_symbolScale, m_unitsStr, PCB_IU_PER_MM, and PL_IU_PER_MM.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and ExportOdbTree().
|
inlinevirtualinherited |
Set an optional progress reporter.
Reimplemented in SCH_IO_CADSTAR_ARCHIVE.
Definition at line 94 of file io_base.h.
References m_progressReporter.
Referenced by PCB_CONTROL::AppendBoard().
|
inlinevirtualinherited |
Registers a KIDIALOG callback for collecting info from the user.
Definition at line 106 of file pcb_io.h.
Referenced by PCB_CONTROL::AppendBoard().
|
inlinevirtualinherited |
Set an optional reporter for warnings/errors.
Reimplemented in SCH_IO_CADSTAR_ARCHIVE.
Definition at line 89 of file io_base.h.
References m_reporter.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), KI_TEST::LoadBoardWithCapture(), SCH_IO_GEDA::loadDeferredSheets(), and SCH_IO_GEDA::LoadSchematicFile().
|
inlinevirtualinherited |
Reimplemented in SCH_IO_DATABASE.
|
private |
Definition at line 247 of file pcb_io_odbpp.h.
Referenced by GetAuxilliaryLayerItemsMap().
|
private |
Definition at line 235 of file pcb_io_odbpp.h.
Referenced by CreateEntity(), PCB_IO_ODBPP(), and SaveBoard().
|
private |
Definition at line 243 of file pcb_io_odbpp.h.
Referenced by GetDrillLayerItemsMap().
|
private |
Definition at line 244 of file pcb_io_odbpp.h.
Referenced by GetDrillSpanNameMap().
|
private |
Definition at line 261 of file pcb_io_odbpp.h.
Referenced by ExportODB(), GenerateFiles(), and Make().
|
private |
Definition at line 253 of file pcb_io_odbpp.h.
Referenced by GetLayerElementsMap().
|
private |
Definition at line 240 of file pcb_io_odbpp.h.
Referenced by GetLayerNameList().
|
private |
Definition at line 237 of file pcb_io_odbpp.h.
Referenced by ClearLoadedFootprints(), GetImportedCachedLibraryFootprints(), and GetLoadedFootprintList().
|
protectedinherited |
Name of the IO loader.
Definition at line 235 of file io_base.h.
Referenced by PCB_IO_IPC2581::generateBOMSection(), GetName(), and IO_BASE().
|
private |
Definition at line 257 of file pcb_io_odbpp.h.
Referenced by GetPlaneSubnetMap().
|
protectedinherited |
Progress reporter to track the progress of the operation, may be nullptr.
Definition at line 241 of file io_base.h.
Referenced by AdvanceProgressPhase(), SCH_IO_KICAD_LEGACY::checkpoint(), SCH_IO_CADSTAR_ARCHIVE::ensureLoadedLibrary(), SCH_IO_EAGLE::ensureLoadedLibrary(), PCB_IO_ODBPP::ExportODB(), PCB_IO_IPC2581::generateComponents(), PCB_IO_IPC2581::generatePhyNetGroup(), IO_BASE(), PCB_IO_ALTIUM_CIRCUIT_MAKER::loadBoard(), PCB_IO_ALTIUM_CIRCUIT_STUDIO::loadBoard(), PCB_IO_ALTIUM_DESIGNER::loadBoard(), PCB_IO_CADSTAR_ARCHIVE::loadBoard(), PCB_IO_DIPTRACE::loadBoard(), PCB_IO_EASYEDA::loadBoard(), PCB_IO_EASYEDAPRO::loadBoard(), PCB_IO_EASYEDAPRO_V3::loadBoard(), PCB_IO_FABMASTER::loadBoard(), PCB_IO_KICAD_SEXPR::loadBoard(), PCB_IO_PADS::loadBoard(), PCB_IO_PADS_BINARY::loadBoard(), PCB_IO_SOLIDWORKS::loadBoard(), PCB_IO_ALLEGRO::LoadBoardFromData(), SCH_IO_KICAD_LEGACY::loadFile(), SCH_IO_KICAD_SEXPR::loadFile(), SCH_IO_ORCAD::loadOlbSymbols(), SCH_IO_CADSTAR_ARCHIVE::LoadSchematicFile(), SCH_IO_DIPTRACE::LoadSchematicFile(), SCH_IO_EAGLE::LoadSchematicFile(), SCH_IO_LTSPICE::LoadSchematicFile(), SCH_IO_ORCAD::LoadSchematicFile(), SCH_IO_PADS::LoadSchematicFile(), SCH_IO_ALTIUM::ParseAltiumSch(), PCB_IO_IPC2581::reportPhase(), PCB_IO_IPC2581::SaveBoard(), SetProgressReporter(), SCH_IO_CADSTAR_ARCHIVE::SetProgressReporter(), and PCB_IO_IPC2581::tickProgress().
|
protectedinherited |
Properties passed via Save() or Load(), no ownership, may be NULL.
Definition at line 371 of file pcb_io.h.
Referenced by PCB_IO_EAGLE::centerBoard(), PCB_IO_EAGLE::init(), PCB_IO_GEDA::init(), PCB_IO_KICAD_LEGACY::init(), PCB_IO_KICAD_SEXPR::init(), PCB_IO_ALLEGRO::loadBoard(), PCB_IO_ALTIUM_CIRCUIT_MAKER::loadBoard(), PCB_IO_ALTIUM_CIRCUIT_STUDIO::loadBoard(), PCB_IO_ALTIUM_DESIGNER::loadBoard(), PCB_IO_AUTOTRAX::loadBoard(), PCB_IO_CADSTAR_ARCHIVE::loadBoard(), PCB_IO_DIPTRACE::loadBoard(), PCB_IO_EASYEDA::loadBoard(), PCB_IO_EASYEDAPRO::loadBoard(), PCB_IO_EASYEDAPRO_V3::loadBoard(), PCB_IO_FABMASTER::loadBoard(), PCB_IO_PCAD::loadBoard(), PCB_IO_SOLIDWORKS::loadBoard(), PCB_IO_SPRINT_LAYOUT::loadBoard(), and PCB_IO().
|
protectedinherited |
Reporter to log errors/warnings to, may be nullptr.
Definition at line 238 of file io_base.h.
Referenced by PCB_IO_CADSTAR_ARCHIVE::ensureLoadedLibrary(), SCH_IO_CADSTAR_ARCHIVE::ensureLoadedLibrary(), SCH_IO_GEDA::flushPendingComponent(), PCB_IO_ALTIUM_DESIGNER::FootprintLoad(), SCH_IO_GEDA::getOrLoadSymbol(), SCH_IO_GEDA::importHierarchicalSheet(), IO_BASE(), SCH_IO_PADS::loadBinarySchematicFile(), PCB_IO_ALTIUM_CIRCUIT_MAKER::loadBoard(), PCB_IO_ALTIUM_CIRCUIT_STUDIO::loadBoard(), PCB_IO_ALTIUM_DESIGNER::loadBoard(), PCB_IO_AUTOTRAX::loadBoard(), PCB_IO_CADSTAR_ARCHIVE::loadBoard(), PCB_IO_FABMASTER::loadBoard(), PCB_IO_PADS::loadBoard(), PCB_IO_PADS_BINARY::loadBoard(), PCB_IO_PCAD::loadBoard(), PCB_IO_SOLIDWORKS::loadBoard(), PCB_IO_ALLEGRO::LoadBoardFromData(), PCB_IO_PADS::loadCopperShapes(), PCB_IO_PADS_BINARY::loadCopperShapes(), SCH_IO_GEDA::loadDeferredSheets(), PCB_IO_PADS::loadFootprints(), PCB_IO_PADS_BINARY::loadFootprints(), SCH_IO_ORCAD::loadOlbSymbols(), SCH_IO_ALTIUM::LoadSchematicFile(), SCH_IO_CADSTAR_ARCHIVE::LoadSchematicFile(), SCH_IO_DIPTRACE::LoadSchematicFile(), SCH_IO_GEDA::LoadSchematicFile(), SCH_IO_LTSPICE::LoadSchematicFile(), SCH_IO_ORCAD::LoadSchematicFile(), SCH_IO_PADS::LoadSchematicFile(), PCB_IO_PADS::loadTracksAndVias(), PCB_IO_PADS_BINARY::loadTracksAndVias(), PCB_IO_PADS::loadZones(), PCB_IO_PADS_BINARY::loadZones(), SCH_IO_ALTIUM::ParseLibFile(), SCH_IO_ALTIUM::ParsePowerPort(), SCH_IO_PCAD::populateScreen(), Report(), SCH_IO_ALTIUM::SCH_IO_ALTIUM(), SCH_IO_CADSTAR_ARCHIVE::SCH_IO_CADSTAR_ARCHIVE(), SCH_IO_DIPTRACE::SCH_IO_DIPTRACE(), SCH_IO_EASYEDA::SCH_IO_EASYEDA(), SCH_IO_LTSPICE::SCH_IO_LTSPICE(), SCH_IO_ORCAD::SCH_IO_ORCAD(), SetReporter(), and SCH_IO_CADSTAR_ARCHIVE::SetReporter().
|
static |
Internal units to the output units named by m_unitsStr, for values written as data.
Definition at line 216 of file pcb_io_odbpp.h.
Referenced by ODB::AddXY(), ODB::Data2String(), SaveBoard(), and ODB_EXPORT_STATE_GUARD::~ODB_EXPORT_STATE_GUARD().
|
static |
Definition at line 221 of file pcb_io_odbpp.h.
Referenced by ODB::Double2String(), SaveBoard(), and ODB_EXPORT_STATE_GUARD::~ODB_EXPORT_STATE_GUARD().
|
private |
Definition at line 250 of file pcb_io_odbpp.h.
Referenced by GetSlotHolesMap().
|
static |
Internal units to thousandths of the output unit, the scale ODB++ symbol names use.
This is 1000x m_scale, so writing a data value with it overstates the value 1000-fold.
Definition at line 220 of file pcb_io_odbpp.h.
Referenced by SaveBoard(), ODB::SymDouble2String(), and ODB_EXPORT_STATE_GUARD::~ODB_EXPORT_STATE_GUARD().
|
private |
Definition at line 255 of file pcb_io_odbpp.h.
Referenced by GetPadSubnetMap().
|
static |
Definition at line 222 of file pcb_io_odbpp.h.
Referenced by FEATURES_MANAGER::GenerateFeatureFile(), FEATURES_MANAGER::GenerateProfileFeatures(), ODB_STEP_ENTITY::GenerateStepHeaderFile(), ODB_LAYER_ENTITY::InitDrillData(), ODB_MISC_ENTITY::ODB_MISC_ENTITY(), SaveBoard(), COMPONENTS_MANAGER::Write(), EDA_DATA::Write(), and ODB_EXPORT_STATE_GUARD::~ODB_EXPORT_STATE_GUARD().
|
private |
Definition at line 259 of file pcb_io_odbpp.h.
Referenced by GetViaTraceSubnetMap().
| std::shared_ptr<ODB_TREE_WRITER> PCB_IO_ODBPP::m_writer |
Definition at line 204 of file pcb_io_odbpp.h.