EAGLE_PLUGIN Class Reference

Works with Eagle 6.x XML board files and footprints to implement the Pcbnew PLUGIN API or a portion of it. More...

#include <eagle_plugin.h>

Inheritance diagram for EAGLE_PLUGIN:

Public Types
typedef int	BIU

Public Member Functions
const wxString	PluginName () const override
	Return a brief hard coded name for this PLUGIN. More...
BOARD *	Load (const wxString &aFileName, BOARD *aAppendToMe, const PROPERTIES *aProperties=nullptr, PROJECT *aProject=nullptr, PROGRESS_REPORTER *aProgressReporter=nullptr) override
	Load information from some input file format that this PLUGIN implementation knows about into either a new BOARD or an existing one. More...
std::vector< FOOTPRINT * >	GetImportedCachedLibraryFootprints () override
	Return a container with the cached library footprints generated in the last call to Load. More...
const wxString	GetFileExtension () const override
	Returns the file extension for the PLUGIN. More...
void	FootprintEnumerate (wxArrayString &aFootprintNames, const wxString &aLibraryPath, bool aBestEfforts, const PROPERTIES *aProperties=nullptr) override
	Return a list of footprint names contained within the library at aLibraryPath. More...
FOOTPRINT *	FootprintLoad (const wxString &aLibraryPath, const wxString &aFootprintName, bool aKeepUUID=false, const PROPERTIES *aProperties=nullptr) override
	Load a footprint having aFootprintName from the aLibraryPath containing a library format that this PLUGIN knows about. More...
long long	GetLibraryTimestamp (const wxString &aLibraryPath) const override
	Generate a timestamp representing all the files in the library (including the library directory). More...
bool	IsFootprintLibWritable (const wxString &aLibraryPath) override
	Return true if the library at aLibraryPath is writable. More...
void	FootprintLibOptions (PROPERTIES *aProperties) const override
	Append supported PLUGIN options to aListToAppenTo along with internationalized descriptions. More...
	EAGLE_PLUGIN ()
	~EAGLE_PLUGIN ()
std::map< wxString, PCB_LAYER_ID >	DefaultLayerMappingCallback (const std::vector< INPUT_LAYER_DESC > &aInputLayerDescriptionVector)
	Return the automapped layers. More...
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. More...
virtual void	Save (const wxString &aFileName, BOARD *aBoard, const PROPERTIES *aProperties=nullptr)
	Write aBoard to a storage file in a format that this PLUGIN implementation knows about or it can be used to write a portion of aBoard to a special kind of export file. More...
virtual void	PrefetchLib (const wxString &aLibraryPath, const PROPERTIES *aProperties=nullptr)
	If possible, prefetches the specified library (e.g. More...
virtual const FOOTPRINT *	GetEnumeratedFootprint (const wxString &aLibraryPath, const wxString &aFootprintName, const PROPERTIES *aProperties=nullptr)
	A version of FootprintLoad() for use after FootprintEnumerate() for more efficient cache management. More...
virtual bool	FootprintExists (const wxString &aLibraryPath, const wxString &aFootprintName, const PROPERTIES *aProperties=nullptr)
	Check for the existence of a footprint. More...
virtual void	FootprintSave (const wxString &aLibraryPath, const FOOTPRINT *aFootprint, const PROPERTIES *aProperties=nullptr)
	Write aFootprint to an existing library located at aLibraryPath. More...
virtual void	FootprintDelete (const wxString &aLibraryPath, const wxString &aFootprintName, const PROPERTIES *aProperties=nullptr)
	Delete aFootprintName from the library at aLibraryPath. More...
virtual void	FootprintLibCreate (const wxString &aLibraryPath, const PROPERTIES *aProperties=nullptr)
	Create a new empty footprint library at aLibraryPath empty. More...
virtual bool	FootprintLibDelete (const wxString &aLibraryPath, const PROPERTIES *aProperties=nullptr)
	Delete an existing footprint 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. More...
virtual void	RegisterLayerMappingCallback (LAYER_MAPPING_HANDLER aLayerMappingHandler)
	Register a different handler to be called when mapping of input layers to KiCad layers occurs. More...

Protected Attributes
LAYER_MAPPING_HANDLER	m_layer_mapping_handler
	Callback to get layer mapping. More...

Private Types
typedef std::vector< ELAYER >	ELAYERS
typedef ELAYERS::const_iterator	EITER

Private Member Functions
void	init (const PROPERTIES *aProperties)
	initialize PLUGIN like a constructor would, and futz with fresh BOARD if needed. More...
void	checkpoint ()
void	clear_cu_map ()
int	kicad_y (const ECOORD &y) const
	Convert an Eagle distance to a KiCad distance. More...
int	kicad_x (const ECOORD &x) const
wxSize	kicad_fontz (const ECOORD &d, int aTextThickness) const
	create a font size (fontz) from an eagle font size scalar and KiCad font thickness More...
void	mapEagleLayersToKicad (bool aIsLibraryCache=false)
	Generate mapping between Eagle and KiCad layers. More...
PCB_LAYER_ID	kicad_layer (int aLayer) const
	Convert an Eagle layer to a KiCad layer. More...
std::tuple< PCB_LAYER_ID, LSET, bool >	defaultKicadLayer (int aEagleLayer, bool aIsLibraryCache=false) const
	Get the default KiCad layer corresponding to an Eagle layer of the board, a set of sensible layer mapping options and required flag. More...
const wxString &	eagle_layer_name (int aLayer) const
	Get Eagle layer name by its number. More...
int	eagle_layer_id (const wxString &aLayerName) const
	Get Eagle layer number by its name. More...
void	cacheLib (const wxString &aLibraryPath)
	This PLUGIN only caches one footprint library, this determines which one. More...
void	loadAllSections (wxXmlNode *aDocument)
void	loadDesignRules (wxXmlNode *aDesignRules)
void	loadLayerDefs (wxXmlNode *aLayers)
void	loadPlain (wxXmlNode *aPlain)
void	loadClasses (wxXmlNode *aClasses)
void	loadSignals (wxXmlNode *aSignals)
void	loadLibrary (wxXmlNode *aLib, const wxString *aLibName)
	Load the Eagle "library" XML element, which can occur either under a "libraries" element (if a *.brd file) or under a "drawing" element if a *.lbr file. More...
void	loadLibraries (wxXmlNode *aLibs)
void	loadElements (wxXmlNode *aElements)
ZONE *	loadPolygon (wxXmlNode *aPolyNode)
	Load a copper or keepout polygon and adds it to the board. More...
void	orientFootprintAndText (FOOTPRINT *aFootprint, const EELEMENT &e, const EATTR *aNameAttr, const EATTR *aValueAttr)
void	orientFPText (FOOTPRINT *aFootprint, const EELEMENT &e, FP_TEXT *aFPText, const EATTR *aAttr)
void	centerBoard ()
	move the BOARD into the center of the page More...
FOOTPRINT *	makeFootprint (wxXmlNode *aPackage, const wxString &aPkgName)
	Create a FOOTPRINT from an Eagle package. More...
void	packageWire (FOOTPRINT *aFootprint, wxXmlNode *aTree) const
void	packagePad (FOOTPRINT *aFootprint, wxXmlNode *aTree)
void	packageText (FOOTPRINT *aFootprint, wxXmlNode *aTree) const
void	packageRectangle (FOOTPRINT *aFootprint, wxXmlNode *aTree) const
void	packagePolygon (FOOTPRINT *aFootprint, wxXmlNode *aTree) const
void	packageCircle (FOOTPRINT *aFootprint, wxXmlNode *aTree) const
void	packageHole (FOOTPRINT *aFootprint, wxXmlNode *aTree, bool aCenter) const
void	packageSMD (FOOTPRINT *aFootprint, wxXmlNode *aTree) const
	Handles common pad properties. More...
void	transferPad (const EPAD_COMMON &aEaglePad, PAD *aPad) const
	Deletes the footprint templates list. More...
void	deleteTemplates ()

Static Private Member Functions
static wxDateTime	getModificationTime (const wxString &aPath)
	get a file's or dir's modification time. More...

Private Attributes
int	m_cu_map [17]
	map eagle to KiCad, cu layers only. More...
std::map< int, ELAYER >	m_eagleLayers
	Eagle layer data stored by layer number. More...
std::map< wxString, int >	m_eagleLayersIds
	Eagle layer ids stored by layer name. More...
std::map< wxString, PCB_LAYER_ID >	m_layer_map
	Map of Eagle layers to KiCad layers. More...
std::map< wxString, std::shared_ptr< NETCLASS > >	m_classMap
wxString	m_customRules
ERULES *	m_rules
	Eagle design rules. More...
XPATH *	m_xpath
	keeps track of what we are working on within XML document during a Load(). More...
int	m_hole_count
	generates unique footprint names from eagle "hole"s. More...
NET_MAP	m_pads_to_nets
	net list More...
FOOTPRINT_MAP	m_templates
	is part of a FOOTPRINT factory that operates using copy construction. More...
const PROPERTIES *	m_props
	passed via Save() or Load(), no ownership, may be NULL. More...
BOARD *	m_board
	which BOARD is being worked on, no ownership here More...
PROGRESS_REPORTER *	m_progressReporter
	optional; may be nullptr More...
unsigned	m_doneCount
unsigned	m_lastProgressCount
unsigned	m_totalCount
	for progress reporting More...
int	m_min_trace
	smallest trace we find on Load(), in BIU. More...
int	m_min_hole
	smallest diameter hole we find on Load(), in BIU. More...
int	m_min_via
	smallest via we find on Load(), in BIU. More...
int	m_min_annulus
	smallest via annulus we find on Load(), in BIU. More...
wxString	m_lib_path
wxDateTime	m_mod_time

Detailed Description

Works with Eagle 6.x XML board files and footprints to implement the Pcbnew PLUGIN API or a portion of it.

Definition at line 129 of file eagle_plugin.h.

Member Typedef Documentation

BIU

typedef int EAGLE_PLUGIN::BIU

Definition at line 161 of file eagle_plugin.h.

EITER

typedef ELAYERS::const_iterator EAGLE_PLUGIN::EITER

private

Definition at line 310 of file eagle_plugin.h.

ELAYERS

typedef std::vector<ELAYER> EAGLE_PLUGIN::ELAYERS

private

Definition at line 309 of file eagle_plugin.h.

Constructor & Destructor Documentation

EAGLE_PLUGIN()

EAGLE_PLUGIN::EAGLE_PLUGIN

(

)

Definition at line 294 of file eagle_plugin.cpp.

 :
 m_rules( new ERULES() ),
 m_xpath( new XPATH() ),
 m_progressReporter( nullptr ),
 m_doneCount( 0 ),
 m_lastProgressCount( 0 ),
 m_totalCount( 0 ),
 m_mod_time( wxDateTime::Now() )
{
 using namespace std::placeholders;
 
 init( nullptr );
 clear_cu_map();
 RegisterLayerMappingCallback( std::bind( &EAGLE_PLUGIN::DefaultLayerMappingCallback,
 this, _1 ) );
}

References clear_cu_map(), DefaultLayerMappingCallback(), init(), and LAYER_REMAPPABLE_PLUGIN::RegisterLayerMappingCallback().

~EAGLE_PLUGIN()

EAGLE_PLUGIN::~EAGLE_PLUGIN

(

)

Definition at line 312 of file eagle_plugin.cpp.

{
 deleteTemplates();
 delete m_rules;
 delete m_xpath;
}

References deleteTemplates(), m_rules, and m_xpath.

Member Function Documentation

cacheLib()

void EAGLE_PLUGIN::cacheLib ( const wxString &  aLibraryPath )

private

This PLUGIN only caches one footprint library, this determines which one.

Definition at line 3149 of file eagle_plugin.cpp.

{
 try
 {
 wxDateTime modtime = getModificationTime( aLibPath );
 
 // Fixes assertions in wxWidgets debug builds for the wxDateTime object. Refresh the
 // cache if either of the wxDateTime objects are invalid or the last file modification
 // time differs from the current file modification time.
 bool load = !m_mod_time.IsValid() || !modtime.IsValid() || m_mod_time != modtime;
 
 if( aLibPath != m_lib_path || load )
 {
 wxXmlNode* doc;
 LOCALE_IO toggle; // toggles on, then off, the C locale.
 
 deleteTemplates();
 
 // Set this before completion of loading, since we rely on it for
 // text of an exception. Delay setting m_mod_time until after successful load
 // however.
 m_lib_path = aLibPath;
 
 // 8 bit "filename" should be encoded according to disk filename encoding,
 // (maybe this is current locale, maybe not, its a filesystem issue),
 // and is not necessarily utf8.
 string filename = (const char*) aLibPath.char_str( wxConvFile );
 
 // Load the document
 wxFileName fn( filename );
 wxFFileInputStream stream( fn.GetFullPath() );
 wxXmlDocument xmlDocument;
 
 if( !stream.IsOk() || !xmlDocument.Load( stream ) )
 {
 THROW_IO_ERROR( wxString::Format( _( "Unable to read file '%s'." ),
 fn.GetFullPath() ) );
 }
 
 doc = xmlDocument.GetRoot();
 
 wxXmlNode* drawing = MapChildren( doc )["drawing"];
 NODE_MAP drawingChildren = MapChildren( drawing );
 
 // clear the cu map and then rebuild it.
 clear_cu_map();
 
 m_xpath->push( "eagle.drawing.layers" );
 wxXmlNode* layers = drawingChildren["layers"];
 loadLayerDefs( layers );
 mapEagleLayersToKicad( true );
 m_xpath->pop();
 
 m_xpath->push( "eagle.drawing.library" );
 wxXmlNode* library = drawingChildren["library"];
 loadLibrary( library, nullptr );
 m_xpath->pop();
 
 m_mod_time = modtime;
 }
 }
 catch(...){}
 // TODO: Handle exceptions
 // catch( file_parser_error fpe )
 // {
 // // for xml_parser_error, what() has the line number in it,
 // // but no byte offset. That should be an adequate error message.
 // THROW_IO_ERROR( fpe.what() );
 // }
 //
 // // Class ptree_error is a base class for xml_parser_error & file_parser_error,
 // // so one catch should be OK for all errors.
 // catch( ptree_error pte )
 // {
 // string errmsg = pte.what();
 //
 // errmsg += " @\n";
 // errmsg += m_xpath->Contents();
 //
 // THROW_IO_ERROR( errmsg );
 // }
}

References _, clear_cu_map(), deleteTemplates(), Format(), getModificationTime(), library, loadLayerDefs(), loadLibrary(), m_lib_path, m_mod_time, m_xpath, MapChildren(), mapEagleLayersToKicad(), XPATH::pop(), XPATH::push(), and THROW_IO_ERROR.

Referenced by FootprintEnumerate(), and FootprintLoad().

centerBoard()

void EAGLE_PLUGIN::centerBoard ( )

private

move the BOARD into the center of the page

Definition at line 3110 of file eagle_plugin.cpp.

{
 if( m_props )
 {
 UTF8 page_width;
 UTF8 page_height;
 
 if( m_props->Value( "page_width", &page_width ) &&
 m_props->Value( "page_height", &page_height ) )
 {
 BOX2I bbbox = m_board->GetBoardEdgesBoundingBox();
 
 int w = atoi( page_width.c_str() );
 int h = atoi( page_height.c_str() );
 
 int desired_x = ( w - bbbox.GetWidth() ) / 2;
 int desired_y = ( h - bbbox.GetHeight() ) / 2;
 
 m_board->Move( VECTOR2I( desired_x - bbbox.GetX(), desired_y - bbbox.GetY() ) );
 }
 }
}

References UTF8::c_str(), BOARD::GetBoardEdgesBoundingBox(), BOX2< Vec >::GetHeight(), BOX2< Vec >::GetWidth(), BOX2< Vec >::GetX(), BOX2< Vec >::GetY(), m_board, m_props, BOARD::Move(), and PROPERTIES::Value().

Referenced by Load().

checkpoint()

void EAGLE_PLUGIN::checkpoint ( )

private

Definition at line 332 of file eagle_plugin.cpp.

{
 const unsigned PROGRESS_DELTA = 50;
 
 if( m_progressReporter )
 {
 if( ++m_doneCount > m_lastProgressCount + PROGRESS_DELTA )
 {
 m_progressReporter->SetCurrentProgress( ( (double) m_doneCount )
 / std::max( 1U, m_totalCount ) );
 
 if( !m_progressReporter->KeepRefreshing() )
 THROW_IO_ERROR( _( "Open cancelled by user." ) );
 
 m_lastProgressCount = m_doneCount;
 }
 }
}

References _, PROGRESS_REPORTER::KeepRefreshing(), m_doneCount, m_lastProgressCount, m_progressReporter, m_totalCount, PROGRESS_REPORTER::SetCurrentProgress(), and THROW_IO_ERROR.

Referenced by loadClasses(), loadDesignRules(), loadElements(), loadLibrary(), loadPlain(), and loadSignals().

clear_cu_map()

void EAGLE_PLUGIN::clear_cu_map ( )

private

Definition at line 523 of file eagle_plugin.cpp.

{
 // All cu layers are invalid until we see them in the <layers> section while
 // loading either a board or library. See loadLayerDefs().
 for( unsigned i = 0; i < arrayDim(m_cu_map); ++i )
 m_cu_map[i] = -1;
}

References arrayDim(), and m_cu_map.

Referenced by cacheLib(), and EAGLE_PLUGIN().

defaultKicadLayer()

std::tuple< PCB_LAYER_ID, LSET, bool > EAGLE_PLUGIN::defaultKicadLayer ( int  aEagleLayer, bool  aIsLibraryCache = false  ) const

private

Get the default KiCad layer corresponding to an Eagle layer of the board, a set of sensible layer mapping options and required flag.

Note

The Eagle MILLING, TTEST, BTEST, and HOLES layers are set to UNDEFINED_LAYER for historical purposes. All other Eagle layers that do not directly map to KiCad layers will be set to UNDEFINED_LAYER when loading Eagle footprint libraries. This should be addressed in the future because in some cases this will cause data loss.

See also

EAGLE_LAYER and defaultKiCadLayer().

Parameters

aEagleLayer	is the Eagle layer to map.
aIsLibraryCache	is a flag to indicate if the mapping is for board or footprint library cache objects.

Returns

a tuple containing the mapped layer.

Definition at line 2960 of file eagle_plugin.cpp.

{
 // eagle copper layer:
 if( aEagleLayer >= 1 && aEagleLayer < int( arrayDim( m_cu_map ) ) )
 {
 LSET copperLayers;
 
 for( int copperLayer : m_cu_map )
 {
 if( copperLayer >= 0 )
 copperLayers[copperLayer] = true;
 }
 
 return { PCB_LAYER_ID( m_cu_map[aEagleLayer] ), copperLayers, true };
 }
 
 int kiLayer = UNSELECTED_LAYER;
 bool required = false;
 LSET permittedLayers;
 
 permittedLayers.set();
 
 // translate non-copper eagle layer to pcbnew layer
 switch( aEagleLayer )
 {
 // Eagle says "Dimension" layer, but it's for board perimeter
 case EAGLE_LAYER::DIMENSION:
 kiLayer = Edge_Cuts;
 required = true;
 permittedLayers = LSET( 1, Edge_Cuts );
 break;
 
 case EAGLE_LAYER::TPLACE:
 kiLayer = F_SilkS;
 break;
 case EAGLE_LAYER::BPLACE:
 kiLayer = B_SilkS;
 break;
 case EAGLE_LAYER::TNAMES:
 kiLayer = F_SilkS;
 break;
 case EAGLE_LAYER::BNAMES:
 kiLayer = B_SilkS;
 break;
 case EAGLE_LAYER::TVALUES:
 kiLayer = F_Fab;
 break;
 case EAGLE_LAYER::BVALUES:
 kiLayer = B_Fab;
 break;
 case EAGLE_LAYER::TSTOP:
 kiLayer = F_Mask;
 break;
 case EAGLE_LAYER::BSTOP:
 kiLayer = B_Mask;
 break;
 case EAGLE_LAYER::TCREAM:
 kiLayer = F_Paste;
 break;
 case EAGLE_LAYER::BCREAM:
 kiLayer = B_Paste;
 break;
 case EAGLE_LAYER::TFINISH:
 kiLayer = F_Mask;
 break;
 case EAGLE_LAYER::BFINISH:
 kiLayer = B_Mask;
 break;
 case EAGLE_LAYER::TGLUE:
 kiLayer = F_Adhes;
 break;
 case EAGLE_LAYER::BGLUE:
 kiLayer = B_Adhes;
 break;
 case EAGLE_LAYER::DOCUMENT:
 kiLayer = Cmts_User;
 break;
 case EAGLE_LAYER::REFERENCELC:
 kiLayer = Cmts_User;
 break;
 case EAGLE_LAYER::REFERENCELS:
 kiLayer = Cmts_User;
 break;
 
 // Packages show the future chip pins on SMD parts using layer 51.
 // This is an area slightly smaller than the PAD/SMD copper area.
 // Carry those visual aids into the FOOTPRINT on the fabrication layer,
 // not silkscreen. This is perhaps not perfect, but there is not a lot
 // of other suitable paired layers
 case EAGLE_LAYER::TDOCU:
 kiLayer = F_Fab;
 break;
 case EAGLE_LAYER::BDOCU:
 kiLayer = B_Fab;
 break;
 
 // these layers are defined as user layers. put them on ECO layers
 case EAGLE_LAYER::USERLAYER1:
 kiLayer = Eco1_User;
 break;
 case EAGLE_LAYER::USERLAYER2:
 kiLayer = Eco2_User;
 break;
 
 // these will also appear in the ratsnest, so there's no need for a warning
 case EAGLE_LAYER::UNROUTED:
 kiLayer = Dwgs_User;
 break;
 
 case EAGLE_LAYER::TKEEPOUT:
 kiLayer = F_CrtYd;
 break;
 case EAGLE_LAYER::BKEEPOUT:
 kiLayer = B_CrtYd;
 break;
 
 case EAGLE_LAYER::MILLING:
 case EAGLE_LAYER::TTEST:
 case EAGLE_LAYER::BTEST:
 case EAGLE_LAYER::HOLES:
 default:
 if( aIsLibraryCache )
 kiLayer = UNDEFINED_LAYER;
 else
 kiLayer = UNSELECTED_LAYER;
 
 break;
 }
 
 return { PCB_LAYER_ID( kiLayer ), permittedLayers, required };
}

References arrayDim(), B_Adhes, B_CrtYd, B_Fab, B_Mask, B_Paste, B_SilkS, EAGLE_LAYER::BCREAM, EAGLE_LAYER::BDOCU, EAGLE_LAYER::BFINISH, EAGLE_LAYER::BGLUE, EAGLE_LAYER::BKEEPOUT, EAGLE_LAYER::BNAMES, EAGLE_LAYER::BPLACE, EAGLE_LAYER::BSTOP, EAGLE_LAYER::BTEST, EAGLE_LAYER::BVALUES, Cmts_User, EAGLE_LAYER::DIMENSION, EAGLE_LAYER::DOCUMENT, Dwgs_User, Eco1_User, Eco2_User, Edge_Cuts, F_Adhes, F_CrtYd, F_Fab, F_Mask, F_Paste, F_SilkS, EAGLE_LAYER::HOLES, m_cu_map, EAGLE_LAYER::MILLING, EAGLE_LAYER::REFERENCELC, EAGLE_LAYER::REFERENCELS, EAGLE_LAYER::TCREAM, EAGLE_LAYER::TDOCU, EAGLE_LAYER::TFINISH, EAGLE_LAYER::TGLUE, EAGLE_LAYER::TKEEPOUT, EAGLE_LAYER::TNAMES, EAGLE_LAYER::TPLACE, EAGLE_LAYER::TSTOP, EAGLE_LAYER::TTEST, EAGLE_LAYER::TVALUES, UNDEFINED_LAYER, EAGLE_LAYER::UNROUTED, UNSELECTED_LAYER, EAGLE_LAYER::USERLAYER1, and EAGLE_LAYER::USERLAYER2.

Referenced by DefaultLayerMappingCallback(), and mapEagleLayersToKicad().

DefaultLayerMappingCallback()

std::map< wxString, PCB_LAYER_ID > EAGLE_PLUGIN::DefaultLayerMappingCallback

(

const std::vector< INPUT_LAYER_DESC > &

aInputLayerDescriptionVector

)

Return the automapped layers.

The callback needs to have the context of the current board so it can correctly determine copper layer mapping. Thus, it is not static and is expected to be bind to an instance of EAGLE_PLUGIN.

Parameters

aInputLayerDescriptionVector

Returns

Auto-mapped layers

Definition at line 2908 of file eagle_plugin.cpp.

{
 std::map<wxString, PCB_LAYER_ID> layer_map;
 
 for ( const INPUT_LAYER_DESC& layer : aInputLayerDescriptionVector )
 {
 PCB_LAYER_ID layerId = std::get<0>( defaultKicadLayer( eagle_layer_id( layer.Name ) ) );
 layer_map.emplace( layer.Name, layerId );
 }
 
 return layer_map;
}

References defaultKicadLayer(), and eagle_layer_id().

Referenced by EAGLE_PLUGIN().

deleteTemplates()

void EAGLE_PLUGIN::deleteTemplates ( )

private

Definition at line 2562 of file eagle_plugin.cpp.

{
 for( auto& t : m_templates )
 delete t.second;
 
 m_templates.clear();
}

References m_templates.

Referenced by cacheLib(), and ~EAGLE_PLUGIN().

eagle_layer_id()

int EAGLE_PLUGIN::eagle_layer_id ( const wxString &  aLayerName ) const

private

Get Eagle layer number by its name.

Definition at line 3102 of file eagle_plugin.cpp.

{
 static const int unknown = -1;
 auto it = m_eagleLayersIds.find( aLayerName );
 return it == m_eagleLayersIds.end() ? unknown : it->second;
}

References m_eagleLayersIds, and unknown.

Referenced by DefaultLayerMappingCallback().

eagle_layer_name()

const wxString & EAGLE_PLUGIN::eagle_layer_name ( int  aLayer ) const

private

Get Eagle layer name by its number.

Definition at line 3094 of file eagle_plugin.cpp.

{
 static const wxString unknown( "unknown" );
 auto it = m_eagleLayers.find( aLayer );
 return it == m_eagleLayers.end() ? unknown : it->second.name;
}

References m_eagleLayers, and unknown.

Referenced by kicad_layer(), loadPolygon(), packageCircle(), packagePolygon(), packageRectangle(), packageText(), and packageWire().

FootprintDelete()

void PLUGIN::FootprintDelete ( const wxString &  aLibraryPath, const wxString &  aFootprintName, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

Delete aFootprintName from the library at aLibraryPath.

Parameters

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.

Exceptions

IO_ERROR

if there is a problem finding the footprint or the library, or deleting it.

Reimplemented in GPCB_PLUGIN, and PCB_PLUGIN.

Definition at line 116 of file plugin.cpp.

{
 // not pure virtual so that plugins only have to implement subset of the PLUGIN interface.
 not_implemented( this, __FUNCTION__ );
}

References not_implemented().

Referenced by FP_LIB_TABLE::FootprintDelete().

FootprintEnumerate()

void EAGLE_PLUGIN::FootprintEnumerate ( wxArrayString &  aFootprintNames, const wxString &  aLibraryPath, bool  aBestEfforts, const PROPERTIES *  aProperties = nullptr  )

overridevirtual

Return a list of footprint names contained within the library at aLibraryPath.

Parameters

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.

Exceptions

IO_ERROR

if the library cannot be found, or footprint cannot be loaded.

Reimplemented from PLUGIN.

Definition at line 3233 of file eagle_plugin.cpp.

{
 wxString errorMsg;
 
 init( aProperties );
 
 try
 {
 cacheLib( aLibraryPath );
 }
 catch( const IO_ERROR& ioe )
 {
 errorMsg = ioe.What();
 }
 
 // Some of the files may have been parsed correctly so we want to add the valid files to
 // the library.
 
 for( FOOTPRINT_MAP::const_iterator it = m_templates.begin(); it != m_templates.end(); ++it )
 aFootprintNames.Add( it->first );
 
 if( !errorMsg.IsEmpty() && !aBestEfforts )
 THROW_IO_ERROR( errorMsg );
}

References cacheLib(), init(), m_templates, THROW_IO_ERROR, and IO_ERROR::What().

FootprintExists()

bool PLUGIN::FootprintExists ( const wxString &  aLibraryPath, const wxString &  aFootprintName, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

Check for the existence of a footprint.

Reimplemented in PCB_PLUGIN.

Definition at line 89 of file plugin.cpp.

{
 // default implementation
 return FootprintLoad( aLibraryPath, aFootprintName, true, aProperties ) != nullptr;
}

References PLUGIN::FootprintLoad().

Referenced by FP_LIB_TABLE::FootprintExists().

FootprintLibCreate()

void PLUGIN::FootprintLibCreate ( const wxString &  aLibraryPath, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

Create a new empty footprint 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.

Parameters

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 library create 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.

Exceptions

IO_ERROR

if there is a problem finding the library, or creating it.

Reimplemented in PCB_PLUGIN.

Definition at line 124 of file plugin.cpp.

{
 // not pure virtual so that plugins only have to implement subset of the PLUGIN interface.
 not_implemented( this, __FUNCTION__ );
}

References not_implemented().

Referenced by PCB_BASE_EDIT_FRAME::createNewLibrary(), and FP_LIB_TABLE::FootprintLibCreate().

FootprintLibDelete()

bool PLUGIN::FootprintLibDelete ( const wxString &  aLibraryPath, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

Delete an existing footprint 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.

Parameters

aLibraryPath	is a locator for the "library", usually a directory or file which will contain footprints.
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.

Returns

true if library deleted, false if library did not exist.

Exceptions

IO_ERROR

if there is a problem deleting an existing library.

Reimplemented in GPCB_PLUGIN, PCB_PLUGIN, and LEGACY_PLUGIN.

Definition at line 131 of file plugin.cpp.

{
 // not pure virtual so that plugins only have to implement subset of the PLUGIN interface.
 not_implemented( this, __FUNCTION__ );
 return false;
}

References not_implemented().

Referenced by PCB_BASE_EDIT_FRAME::createNewLibrary(), and FP_LIB_TABLE::FootprintLibDelete().

FootprintLibOptions()

void EAGLE_PLUGIN::FootprintLibOptions ( PROPERTIES *  aListToAppendTo ) const

overridevirtual

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.

Note

Since aListToAppendTo is a PROPERTIES object, all options will be unique and last guy wins.

Parameters

aListToAppendTo

holds a tuple of option This eventually is what shows up into the fp-lib-table "options" field, possibly combined with others. internationalized description The internationalized description is displayed in DIALOG_FP_PLUGIN_OPTIONS. It may be multi-line and be quite explanatory of the option. 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 PLUGIN.

Definition at line 3278 of file eagle_plugin.cpp.

{
 PLUGIN::FootprintLibOptions( aListToAppendTo );
}

References PLUGIN::FootprintLibOptions().

FootprintLoad()

FOOTPRINT * EAGLE_PLUGIN::FootprintLoad ( const wxString &  aLibraryPath, const wxString &  aFootprintName, bool  aKeepUUID = false, const PROPERTIES *  aProperties = nullptr  )

overridevirtual

Load a footprint having aFootprintName from the aLibraryPath containing a library format that this PLUGIN knows about.

Parameters

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

Returns

the FOOTPRINT object 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 aFootprintName cannot be found.

Reimplemented from PLUGIN.

Definition at line 3260 of file eagle_plugin.cpp.

{
 init( aProperties );
 cacheLib( aLibraryPath );
 FOOTPRINT_MAP::const_iterator it = m_templates.find( aFootprintName );
 
 if( it == m_templates.end() )
 return nullptr;
 
 // Return a copy of the template
 FOOTPRINT* copy = (FOOTPRINT*) it->second->Duplicate();
 copy->SetParent( nullptr );
 return copy;
}

References cacheLib(), copy, init(), and m_templates.

FootprintSave()

void PLUGIN::FootprintSave ( const wxString &  aLibraryPath, const FOOTPRINT *  aFootprint, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

Write aFootprint to an existing library located at aLibraryPath.

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

Parameters

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.

Exceptions

IO_ERROR

if there is a problem saving.

Reimplemented in PCB_PLUGIN.

Definition at line 108 of file plugin.cpp.

{
 // not pure virtual so that plugins only have to implement subset of the PLUGIN interface.
 not_implemented( this, __FUNCTION__ );
}

References not_implemented().

Referenced by PCB_EDIT_FRAME::ExportFootprintsToLibrary(), FP_LIB_TABLE::FootprintSave(), PCB_EDIT_FRAME::OpenProjectFiles(), and FOOTPRINT_EDIT_FRAME::SaveLibraryAs().

GetEnumeratedFootprint()

const FOOTPRINT * PLUGIN::GetEnumeratedFootprint ( const wxString &  aLibraryPath, const wxString &  aFootprintName, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

A version of FootprintLoad() for use after FootprintEnumerate() for more efficient cache management.

Reimplemented in GPCB_PLUGIN, and PCB_PLUGIN.

Definition at line 80 of file plugin.cpp.

{
 // default implementation
 return FootprintLoad( aLibraryPath, aFootprintName, false, aProperties );
}

References PLUGIN::FootprintLoad().

Referenced by FP_LIB_TABLE::GetEnumeratedFootprint(), and FOOTPRINT_EDIT_FRAME::SaveLibraryAs().

GetFileExtension()

const wxString EAGLE_PLUGIN::GetFileExtension ( ) const

overridevirtual

Returns the file extension for the PLUGIN.

Implements PLUGIN.

Definition at line 326 of file eagle_plugin.cpp.

{
 return wxT( "brd" );
}

GetImportedCachedLibraryFootprints()

std::vector< FOOTPRINT * > EAGLE_PLUGIN::GetImportedCachedLibraryFootprints ( )

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.

Returns

Footprints (caller owns the objects)

Reimplemented from PLUGIN.

Definition at line 493 of file eagle_plugin.cpp.

{
 std::vector<FOOTPRINT*> retval;
 
 for( std::pair<wxString, FOOTPRINT*> fp : m_templates )
 retval.push_back( static_cast<FOOTPRINT*>( fp.second->Clone() ) );
 
 return retval;
}

References m_templates.

GetLibraryTimestamp()

long long EAGLE_PLUGIN::GetLibraryTimestamp ( const wxString &  aLibraryPath ) const

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 PLUGIN.

Definition at line 149 of file eagle_plugin.h.

 {
 return getModificationTime( aLibraryPath ).GetValue().GetValue();
 }

References getModificationTime().

getModificationTime()

wxDateTime EAGLE_PLUGIN::getModificationTime ( const wxString &  aPath )

staticprivate

get a file's or dir's modification time.

Definition at line 3134 of file eagle_plugin.cpp.

{
 // File hasn't been loaded yet.
 if( aPath.IsEmpty() )
 return wxDateTime::Now();
 
 wxFileName fn( aPath );
 
 if( fn.IsFileReadable() )
 return fn.GetModificationTime();
 else
 return wxDateTime( 0.0 );
}

Referenced by cacheLib(), and GetLibraryTimestamp().

init()

void EAGLE_PLUGIN::init ( const PROPERTIES *  aProperties )

private

initialize PLUGIN like a constructor would, and futz with fresh BOARD if needed.

Definition at line 504 of file eagle_plugin.cpp.

{
 m_hole_count = 0;
 m_min_trace = 0;
 m_min_hole = 0;
 m_min_via = 0;
 m_min_annulus = 0;
 m_xpath->clear();
 m_pads_to_nets.clear();
 
 m_board = nullptr;
 m_props = aProperties;
 
 
 delete m_rules;
 m_rules = new ERULES();
}

References XPATH::clear(), m_board, m_hole_count, m_min_annulus, m_min_hole, m_min_trace, m_min_via, m_pads_to_nets, m_props, m_rules, and m_xpath.

Referenced by EAGLE_PLUGIN(), FootprintEnumerate(), FootprintLoad(), and Load().

IsFootprintLibWritable()

bool EAGLE_PLUGIN::IsFootprintLibWritable ( const wxString &  aLibraryPath )

inlineoverridevirtual

Return true if the library at aLibraryPath is writable.

The system libraries are typically read only because of where they are installed..

Parameters

aLibraryPath

is a locator for the "library", usually a directory, file, or URL containing several footprints.

Exceptions

IO_ERROR

if no library at aLibraryPath exists.

Reimplemented from PLUGIN.

Definition at line 154 of file eagle_plugin.h.

 {
 return false; // until someone writes others like FootprintSave(), etc.
 }

kicad_fontz()

wxSize EAGLE_PLUGIN::kicad_fontz ( const ECOORD &  d, int  aTextThickness  ) const

inlineprivate

create a font size (fontz) from an eagle font size scalar and KiCad font thickness

Definition at line 352 of file eagle_plugin.cpp.

{
 // Eagle includes stroke thickness in the text size, KiCAD does not
 int kz = d.ToPcbUnits();
 return wxSize( kz - aTextThickness, kz - aTextThickness );
}

References ECOORD::ToPcbUnits().

Referenced by loadPlain(), orientFPText(), and packageText().

kicad_layer()

PCB_LAYER_ID EAGLE_PLUGIN::kicad_layer ( int  aLayer ) const

private

Convert an Eagle layer to a KiCad layer.

Definition at line 2953 of file eagle_plugin.cpp.

{
 auto result = m_layer_map.find( eagle_layer_name( aEagleLayer ) );
 return result == m_layer_map.end() ? UNDEFINED_LAYER : result->second;
}

References eagle_layer_name(), m_layer_map, and UNDEFINED_LAYER.

Referenced by loadLayerDefs(), loadPlain(), loadPolygon(), loadSignals(), makeFootprint(), packageCircle(), packagePolygon(), packageRectangle(), packageSMD(), packageText(), and packageWire().

kicad_x()

int EAGLE_PLUGIN::kicad_x ( const ECOORD &  x ) const

inlineprivate

Definition at line 189 of file eagle_plugin.h.

{ return x.ToPcbUnits(); }

References ECOORD::ToPcbUnits().

Referenced by loadElements(), loadPlain(), loadPolygon(), loadSignals(), orientFPText(), packageCircle(), packageHole(), packagePolygon(), packageRectangle(), packageText(), packageWire(), and transferPad().

kicad_y()

int EAGLE_PLUGIN::kicad_y ( const ECOORD &  y ) const

inlineprivate

Convert an Eagle distance to a KiCad distance.

Definition at line 188 of file eagle_plugin.h.

{ return -y.ToPcbUnits(); }

References ECOORD::ToPcbUnits().

Referenced by loadElements(), loadPlain(), loadPolygon(), loadSignals(), orientFPText(), packageCircle(), packageHole(), packagePolygon(), packageRectangle(), packageText(), packageWire(), and transferPad().

Load()

BOARD * EAGLE_PLUGIN::Load ( const wxString &  aFileName, BOARD *  aAppendToMe, const PROPERTIES *  aProperties = nullptr, PROJECT *  aProject = nullptr, PROGRESS_REPORTER *  aProgressReporter = nullptr  )

overridevirtual

Load information from some input file format that this PLUGIN implementation knows about into either a new BOARD or an existing one.

This may be used to load an entire new BOARD, or to augment an existing one if aAppendToMe is not NULL.

Parameters

aFileName	is the name of the file to use as input and may be foreign in nature or native in nature.
aAppendToMe	is an existing BOARD to append to, but if NULL then this means "do not append, rather load anew".
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.
aProgressReporter	an optional progress reporter
aLineCount	a line count (necessary if a progress reporter is supplied)

Returns

the successfully loaded board, or the same one as aAppendToMe if aAppendToMe was not NULL, and caller owns it.

Exceptions

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.

Reimplemented from PLUGIN.

Definition at line 360 of file eagle_plugin.cpp.

{
 LOCALE_IO toggle; // toggles on, then off, the C locale.
 wxXmlNode* doc;
 
 init( aProperties );
 
 m_board = aAppendToMe ? aAppendToMe : new BOARD();
 m_progressReporter = aProgressReporter;
 
 // Give the filename to the board if it's new
 if( !aAppendToMe )
 m_board->SetFileName( aFileName );
 
 // delete on exception, if I own m_board, according to aAppendToMe
 unique_ptr<BOARD> deleter( aAppendToMe ? nullptr : m_board );
 
 try
 {
 if( m_progressReporter )
 {
 m_progressReporter->Report( wxString::Format( _( "Loading %s..." ), aFileName ) );
 
 if( !m_progressReporter->KeepRefreshing() )
 THROW_IO_ERROR( _( "Open cancelled by user." ) );
 }
 
 wxFileName fn = aFileName;
 
 // Load the document
 wxFFileInputStream stream( fn.GetFullPath() );
 wxXmlDocument xmlDocument;
 
 if( !stream.IsOk() || !xmlDocument.Load( stream ) )
 {
 THROW_IO_ERROR( wxString::Format( _( "Unable to read file '%s'" ),
 fn.GetFullPath() ) );
 }
 
 doc = xmlDocument.GetRoot();
 
 m_min_trace = INT_MAX;
 m_min_hole = INT_MAX;
 m_min_via = INT_MAX;
 m_min_annulus = INT_MAX;
 
 loadAllSections( doc );
 
 BOARD_DESIGN_SETTINGS& bds = m_board->GetDesignSettings();
 
 if( m_min_trace < bds.m_TrackMinWidth )
 bds.m_TrackMinWidth = m_min_trace;
 
 if( m_min_via < bds.m_ViasMinSize )
 bds.m_ViasMinSize = m_min_via;
 
 if( m_min_hole < bds.m_MinThroughDrill )
 bds.m_MinThroughDrill = m_min_hole;
 
 if( m_min_annulus < bds.m_ViasMinAnnularWidth )
 bds.m_ViasMinAnnularWidth = m_min_annulus;
 
 if( m_rules->mdWireWire )
 bds.m_MinClearance = KiROUND( m_rules->mdWireWire );
 
 NETCLASS defaults( wxT( "dummy" ) );
 
 auto finishNetclass =
 [&]( std::shared_ptr<NETCLASS> netclass )
 {
 // If Eagle has a clearance matrix then we'll build custom rules from that.
 // Netclasses should just be the board minimum clearance.
 netclass->SetClearance( KiROUND( bds.m_MinClearance ) );
 
 if( netclass->GetTrackWidth() == INT_MAX )
 netclass->SetTrackWidth( defaults.GetTrackWidth() );
 
 if( netclass->GetViaDiameter() == INT_MAX )
 netclass->SetViaDiameter( defaults.GetViaDiameter() );
 
 if( netclass->GetViaDrill() == INT_MAX )
 netclass->SetViaDrill( defaults.GetViaDrill() );
 };
 
 std::shared_ptr<NET_SETTINGS>& netSettings = bds.m_NetSettings;
 
 finishNetclass( netSettings->m_DefaultNetClass );
 
 for( const auto& [ name, netclass ] : netSettings->m_NetClasses )
 finishNetclass( netclass );
 
 m_board->m_LegacyNetclassesLoaded = true;
 m_board->m_LegacyDesignSettingsLoaded = true;
 
 fn.SetExt( wxT( "kicad_dru" ) );
 wxFile rulesFile( fn.GetFullPath(), wxFile::write );
 rulesFile.Write( m_customRules );
 
 // should be empty, else missing m_xpath->pop()
 wxASSERT( m_xpath->Contents().size() == 0 );
 }
 catch( const XML_PARSER_ERROR &exc )
 {
 wxString errmsg = exc.what();
 
 errmsg += wxT( "\[email protected] " );
 errmsg += m_xpath->Contents();
 
 THROW_IO_ERROR( errmsg );
 }
 
 // IO_ERROR exceptions are left uncaught, they pass upwards from here.
 
 // Ensure the copper layers count is a multiple of 2
 // Pcbnew does not like boards with odd layers count
 // (these boards cannot exist. they actually have a even layers count)
 int lyrcnt = m_board->GetCopperLayerCount();
 
 if( (lyrcnt % 2) != 0 )
 {
 lyrcnt++;
 m_board->SetCopperLayerCount( lyrcnt );
 }
 
 centerBoard();
 
 deleter.release();
 return m_board;
}

References _, centerBoard(), XPATH::Contents(), Format(), BOARD::GetCopperLayerCount(), BOARD::GetDesignSettings(), NETCLASS::GetTrackWidth(), NETCLASS::GetViaDiameter(), NETCLASS::GetViaDrill(), init(), PROGRESS_REPORTER::KeepRefreshing(), KiROUND(), loadAllSections(), m_board, m_customRules, BOARD::m_LegacyDesignSettingsLoaded, BOARD::m_LegacyNetclassesLoaded, m_min_annulus, m_min_hole, m_min_trace, m_min_via, BOARD_DESIGN_SETTINGS::m_MinClearance, BOARD_DESIGN_SETTINGS::m_MinThroughDrill, BOARD_DESIGN_SETTINGS::m_NetSettings, m_progressReporter, m_rules, BOARD_DESIGN_SETTINGS::m_TrackMinWidth, BOARD_DESIGN_SETTINGS::m_ViasMinAnnularWidth, BOARD_DESIGN_SETTINGS::m_ViasMinSize, m_xpath, ERULES::mdWireWire, name, PROGRESS_REPORTER::Report(), BOARD::SetCopperLayerCount(), BOARD::SetFileName(), and THROW_IO_ERROR.

loadAllSections()

void EAGLE_PLUGIN::loadAllSections ( wxXmlNode *  aDocument )

private

Definition at line 532 of file eagle_plugin.cpp.

{
 wxXmlNode* drawing = MapChildren( aDoc )["drawing"];
 NODE_MAP drawingChildren = MapChildren( drawing );
 
 wxXmlNode* board = drawingChildren["board"];
 NODE_MAP boardChildren = MapChildren( board );
 
 auto count_children = [this]( wxXmlNode* aNode )
 {
 if( aNode )
 {
 wxXmlNode* child = aNode->GetChildren();
 
 while( child )
 {
 m_totalCount++;
 child = child->GetNext();
 }
 }
 };
 
 wxXmlNode* designrules = boardChildren["designrules"];
 wxXmlNode* layers = drawingChildren["layers"];
 wxXmlNode* plain = boardChildren["plain"];
 wxXmlNode* classes = boardChildren["classes"];
 wxXmlNode* signals = boardChildren["signals"];
 wxXmlNode* libs = boardChildren["libraries"];
 wxXmlNode* elems = boardChildren["elements"];
 
 if( m_progressReporter )
 {
 m_totalCount = 0;
 m_doneCount = 0;
 
 count_children( designrules );
 count_children( layers );
 count_children( plain );
 count_children( signals );
 count_children( elems );
 
 while( libs )
 {
 count_children( MapChildren( libs )["packages"] );
 libs = libs->GetNext();
 }
 
 // Rewind
 libs = boardChildren["libraries"];
 }
 
 m_xpath->push( "eagle.drawing" );
 
 {
 m_xpath->push( "board" );
 
 loadDesignRules( designrules );
 
 m_xpath->pop();
 }
 
 {
 m_xpath->push( "layers" );
 
 loadLayerDefs( layers );
 mapEagleLayersToKicad();
 
 m_xpath->pop();
 }
 
 {
 m_xpath->push( "board" );
 
 loadPlain( plain );
 loadClasses( classes );
 loadSignals( signals );
 loadLibraries( libs );
 loadElements( elems );
 
 m_xpath->pop();
 }
 
 m_xpath->pop(); // "eagle.drawing"
}

References loadClasses(), loadDesignRules(), loadElements(), loadLayerDefs(), loadLibraries(), loadPlain(), loadSignals(), m_doneCount, m_progressReporter, m_totalCount, m_xpath, MapChildren(), mapEagleLayersToKicad(), XPATH::pop(), and XPATH::push().

Referenced by Load().

loadClasses()

void EAGLE_PLUGIN::loadClasses ( wxXmlNode *  aClasses )

private

Definition at line 2571 of file eagle_plugin.cpp.

{
 BOARD_DESIGN_SETTINGS& bds = m_board->GetDesignSettings();
 
 m_xpath->push( "classes.class", "number" );
 
 std::vector<ECLASS> eClasses;
 wxXmlNode* classNode = aClasses->GetChildren();
 
 while( classNode )
 {
 checkpoint();
 
 ECLASS eClass( classNode );
 std::shared_ptr<NETCLASS> netclass;
 
 if( eClass.name.CmpNoCase( wxT( "default" ) ) == 0 )
 {
 netclass = bds.m_NetSettings->m_DefaultNetClass;
 }
 else
 {
 netclass.reset( new NETCLASS( eClass.name ) );
 bds.m_NetSettings->m_NetClasses[ eClass.name ] = netclass;
 }
 
 netclass->SetTrackWidth( INT_MAX );
 netclass->SetViaDiameter( INT_MAX );
 netclass->SetViaDrill( INT_MAX );
 
 eClasses.emplace_back( eClass );
 m_classMap[ eClass.number ] = netclass;
 
 // Get next class
 classNode = classNode->GetNext();
 }
 
 m_customRules = wxT( "(version 1)" );
 
 for( ECLASS& eClass : eClasses )
 {
 for( std::pair<const wxString&, ECOORD> entry : eClass.clearanceMap )
 {
 if( m_classMap[ entry.first ] != nullptr )
 {
 wxString rule;
 rule.Printf( wxT( "(rule \"class %s:%s\"\n"
 " (condition \"A.NetClass == '%s' && B.NetClass == '%s'\")\n"
 " (constraint clearance (min %smm)))\n" ),
 eClass.number,
 entry.first,
 eClass.name,
 m_classMap[ entry.first ]->GetName(),
 EDA_UNIT_UTILS::UI::StringFromValue( pcbIUScale, EDA_UNITS::MILLIMETRES, entry.second.ToPcbUnits() ) );
 
 m_customRules += wxT( "\n" ) + rule;
 }
 }
 }
 
 m_xpath->pop(); // "classes.class"
}

References checkpoint(), BOARD::GetDesignSettings(), m_board, m_classMap, m_customRules, BOARD_DESIGN_SETTINGS::m_NetSettings, m_xpath, MILLIMETRES, ECLASS::name, ECLASS::number, pcbIUScale, XPATH::pop(), XPATH::push(), and EDA_UNIT_UTILS::UI::StringFromValue().

Referenced by loadAllSections().

loadDesignRules()

void EAGLE_PLUGIN::loadDesignRules ( wxXmlNode *  aDesignRules )

private

Definition at line 618 of file eagle_plugin.cpp.

{
 if( aDesignRules )
 {
 m_xpath->push( "designrules" );
 m_rules->parse( aDesignRules, [this](){ checkpoint(); } );
 m_xpath->pop(); // "designrules"
 }
}

References checkpoint(), m_rules, m_xpath, ERULES::parse(), XPATH::pop(), and XPATH::push().

Referenced by loadAllSections().

loadElements()

void EAGLE_PLUGIN::loadElements ( wxXmlNode *  aElements )

private

Definition at line 1225 of file eagle_plugin.cpp.

{
 if( !aElements )
 return;
 
 m_xpath->push( "elements.element", "name" );
 
 EATTR name;
 EATTR value;
 bool refanceNamePresetInPackageLayout;
 bool valueNamePresetInPackageLayout;
 
 // Get the first element and iterate
 wxXmlNode* element = aElements->GetChildren();
 
 while( element )
 {
 checkpoint();
 
 if( element->GetName() != wxT( "element" ) )
 {
 // Get next item
 element = element->GetNext();
 continue;
 }
 
 EELEMENT e( element );
 
 // use "NULL-ness" as an indication of presence of the attribute:
 EATTR* nameAttr = nullptr;
 EATTR* valueAttr = nullptr;
 
 m_xpath->Value( e.name.c_str() );
 
 wxString pkg_key = makeKey( e.library, e.package );
 
 FOOTPRINT_MAP::const_iterator it = m_templates.find( pkg_key );
 
 if( it == m_templates.end() )
 {
 wxString emsg = wxString::Format( _( "No '%s' package in library '%s'." ),
 e.package, e.library );
 THROW_IO_ERROR( emsg );
 }
 
 FOOTPRINT* footprint = static_cast<FOOTPRINT*>( it->second->Duplicate() );
 
 m_board->Add( footprint, ADD_MODE::APPEND );
 
 // update the nets within the pads of the clone
 for( PAD* pad : footprint->Pads() )
 {
 wxString pn_key = makeKey( e.name, pad->GetNumber() );
 
 NET_MAP_CITER ni = m_pads_to_nets.find( pn_key );
 if( ni != m_pads_to_nets.end() )
 {
 const ENET* enet = &ni->second;
 pad->SetNetCode( enet->netcode );
 }
 }
 
 refanceNamePresetInPackageLayout = true;
 valueNamePresetInPackageLayout = true;
 footprint->SetPosition( VECTOR2I( kicad_x( e.x ), kicad_y( e.y ) ) );
 
 // Is >NAME field set in package layout ?
 if( footprint->GetReference().size() == 0 )
 {
 footprint->Reference().SetVisible( false ); // No so no show
 refanceNamePresetInPackageLayout = false;
 }
 
 // Is >VALUE field set in package layout
 if( footprint->GetValue().size() == 0 )
 {
 footprint->Value().SetVisible( false ); // No so no show
 valueNamePresetInPackageLayout = false;
 }
 
 wxString reference = e.name;
 
 // EAGLE allows references to be single digits. This breaks KiCad
 // netlisting, which requires parts to have non-digit + digit
 // annotation. If the reference begins with a number, we prepend
 // 'UNK' (unknown) for the symbol designator.
 if( reference.find_first_not_of( "0123456789" ) != 0 )
 reference.Prepend( "UNK" );
 
 // EAGLE allows designator to start with # but that is used in KiCad
 // for symbols which do not have a footprint
 if( reference.find_first_not_of( "#" ) != 0 )
 reference.Prepend( "UNK" );
 
 // reference must end with a number but EAGLE does not enforce this
 if( reference.find_last_not_of( "0123456789" ) == (reference.Length()-1) )
 reference.Append( "0" );
 
 footprint->SetReference( reference );
 footprint->SetValue( e.value );
 
 if( !e.smashed )
 {
 // Not smashed so show NAME & VALUE
 if( valueNamePresetInPackageLayout )
 footprint->Value().SetVisible( true ); // Only if place holder in package layout
 
 if( refanceNamePresetInPackageLayout )
 footprint->Reference().SetVisible( true ); // Only if place holder in package layout
 }
 else if( *e.smashed == true )
 {
 // Smashed so set default to no show for NAME and VALUE
 footprint->Value().SetVisible( false );
 footprint->Reference().SetVisible( false );
 
 // initialize these to default values in case the <attribute> elements are not present.
 m_xpath->push( "attribute", "name" );
 
 // VALUE and NAME can have something like our text "effects" overrides
 // in SWEET and new schematic. Eagle calls these XML elements "attribute".
 // There can be one for NAME and/or VALUE both. Features present in the
 // EATTR override the ones established in the package only if they are
 // present here (except for rot, which if not present means angle zero).
 // So the logic is a bit different than in packageText() and in plain text.
 
 // Get the first attribute and iterate
 wxXmlNode* attribute = element->GetChildren();
 
 while( attribute )
 {
 if( attribute->GetName() != wxT( "attribute" ) )
 {
 attribute = attribute->GetNext();
 continue;
 }
 
 EATTR a( attribute );
 
 if( a.name == wxT( "NAME" ) )
 {
 name = a;
 nameAttr = &name;
 
 // do we have a display attribute ?
 if( a.display )
 {
 // Yes!
 switch( *a.display )
 {
 case EATTR::VALUE :
 {
 nameAttr->name = reference;
 
 if( refanceNamePresetInPackageLayout )
 footprint->Reference().SetVisible( true );
 
 break;
 }
 
 case EATTR::NAME :
 if( refanceNamePresetInPackageLayout )
 {
 footprint->SetReference( "NAME" );
 footprint->Reference().SetVisible( true );
 }
 
 break;
 
 case EATTR::BOTH :
 if( refanceNamePresetInPackageLayout )
 footprint->Reference().SetVisible( true );
 
 nameAttr->name = nameAttr->name + wxT( " = " ) + e.name;
 footprint->SetReference( wxT( "NAME = " ) + e.name );
 break;
 
 case EATTR::Off :
 footprint->Reference().SetVisible( false );
 break;
 
 default:
 nameAttr->name = e.name;
 
 if( refanceNamePresetInPackageLayout )
 footprint->Reference().SetVisible( true );
 }
 }
 else
 {
 // No display, so default is visible, and show value of NAME
 footprint->Reference().SetVisible( true );
 }
 }
 else if( a.name == wxT( "VALUE" ) )
 {
 value = a;
 valueAttr = &value;
 
 if( a.display )
 {
 // Yes!
 switch( *a.display )
 {
 case EATTR::VALUE :
 valueAttr->value = opt_wxString( e.value );
 footprint->SetValue( e.value );
 
 if( valueNamePresetInPackageLayout )
 footprint->Value().SetVisible( true );
 
 break;
 
 case EATTR::NAME :
 if( valueNamePresetInPackageLayout )
 footprint->Value().SetVisible( true );
 
 footprint->SetValue( wxT( "VALUE" ) );
 break;
 
 case EATTR::BOTH :
 if( valueNamePresetInPackageLayout )
 footprint->Value().SetVisible( true );
 
 valueAttr->value = opt_wxString( wxT( "VALUE = " ) + e.value );
 footprint->SetValue( wxT( "VALUE = " ) + e.value );
 break;
 
 case EATTR::Off :
 footprint->Value().SetVisible( false );
 break;
 
 default:
 valueAttr->value = opt_wxString( e.value );
 
 if( valueNamePresetInPackageLayout )
 footprint->Value().SetVisible( true );
 }
 }
 else
 {
 // No display, so default is visible, and show value of NAME
 footprint->Value().SetVisible( true );
 }
 
 }
 
 attribute = attribute->GetNext();
 }
 
 m_xpath->pop(); // "attribute"
 }
 
 orientFootprintAndText( footprint, e, nameAttr, valueAttr );
 
 // Set the local coordinates for the footprint text items
 footprint->Reference().SetLocalCoord();
 footprint->Value().SetLocalCoord();
 
 // Get next element
 element = element->GetNext();
 }
 
 m_xpath->pop(); // "elements.element"
}

References _, BOARD::Add(), APPEND, EATTR::BOTH, checkpoint(), EATTR::display, Format(), FOOTPRINT::GetReference(), FOOTPRINT::GetValue(), kicad_x(), kicad_y(), EELEMENT::library, m_board, m_pads_to_nets, m_templates, m_xpath, makeKey(), name, EATTR::name, EATTR::NAME, EELEMENT::name, ENET::netcode, EATTR::Off, orientFootprintAndText(), EELEMENT::package, pad, FOOTPRINT::Pads(), XPATH::pop(), XPATH::push(), FOOTPRINT::Reference(), FP_TEXT::SetLocalCoord(), FOOTPRINT::SetPosition(), FOOTPRINT::SetReference(), FOOTPRINT::SetValue(), EDA_TEXT::SetVisible(), EELEMENT::smashed, THROW_IO_ERROR, EATTR::VALUE, EELEMENT::value, FOOTPRINT::Value(), XPATH::Value(), EATTR::value, EELEMENT::x, and EELEMENT::y.

Referenced by loadAllSections().

loadLayerDefs()

void EAGLE_PLUGIN::loadLayerDefs ( wxXmlNode *  aLayers )

private

Definition at line 629 of file eagle_plugin.cpp.

{
 if( !aLayers )
 return;
 
 ELAYERS cu; // copper layers
 
 // Get the first layer and iterate
 wxXmlNode* layerNode = aLayers->GetChildren();
 
 m_eagleLayers.clear();
 m_eagleLayersIds.clear();
 
 while( layerNode )
 {
 ELAYER elayer( layerNode );
 m_eagleLayers.insert( std::make_pair( elayer.number, elayer ) );
 m_eagleLayersIds.insert( std::make_pair( elayer.name, elayer.number ) );
 
 // find the subset of layers that are copper and active
 if( elayer.number >= 1 && elayer.number <= 16 && ( !elayer.active || *elayer.active ) )
 cu.push_back( elayer );
 
 layerNode = layerNode->GetNext();
 }
 
 // establish cu layer map:
 int ki_layer_count = 0;
 
 for( EITER it = cu.begin(); it != cu.end(); ++it, ++ki_layer_count )
 {
 if( ki_layer_count == 0 )
 {
 m_cu_map[it->number] = F_Cu;
 }
 else if( ki_layer_count == int( cu.size()-1 ) )
 {
 m_cu_map[it->number] = B_Cu;
 }
 else
 {
 // some eagle boards do not have contiguous layer number sequences.
 m_cu_map[it->number] = ki_layer_count;
 }
 }
 
 // Set the layer names and cu count if we're loading a board.
 if( m_board )
 {
 m_board->SetCopperLayerCount( cu.size() );
 
 for( EITER it = cu.begin(); it != cu.end(); ++it )
 {
 PCB_LAYER_ID layer = kicad_layer( it->number );
 
 // these function provide their own protection against non enabled layers:
 if( layer >= 0 && layer < PCB_LAYER_ID_COUNT ) // layer should be valid
 {
 m_board->SetLayerName( layer, it->name );
 m_board->SetLayerType( layer, LT_SIGNAL );
 }
 
 // could map the colors here
 }
 }
}

References ELAYER::active, B_Cu, F_Cu, kicad_layer(), LT_SIGNAL, m_board, m_cu_map, m_eagleLayers, m_eagleLayersIds, ELAYER::name, ELAYER::number, PCB_LAYER_ID_COUNT, BOARD::SetCopperLayerCount(), BOARD::SetLayerName(), and BOARD::SetLayerType().

Referenced by cacheLib(), and loadAllSections().

loadLibraries()

void EAGLE_PLUGIN::loadLibraries ( wxXmlNode *  aLibs )

private

Definition at line 1202 of file eagle_plugin.cpp.

{
 if( !aLibs )
 return;
 
 m_xpath->push( "libraries.library", "name" );
 
 // Get the first library and iterate
 wxXmlNode* library = aLibs->GetChildren();
 
 while( library )
 {
 const wxString& lib_name = library->GetAttribute( "name" );
 
 m_xpath->Value( lib_name.c_str() );
 loadLibrary( library, &lib_name );
 library = library->GetNext();
 }
 
 m_xpath->pop();
}

References library, loadLibrary(), m_xpath, XPATH::pop(), XPATH::push(), and XPATH::Value().

Referenced by loadAllSections().

loadLibrary()

void EAGLE_PLUGIN::loadLibrary ( wxXmlNode *  aLib, const wxString *  aLibName  )

private

Load the Eagle "library" XML element, which can occur either under a "libraries" element (if a *.brd file) or under a "drawing" element if a *.lbr file.

Parameters

aLib	is the portion of the loaded XML document tree that is the "library" element.
aLibName	is a pointer to the library name or NULL. If NULL this means we are loading a *.lbr not a *.brd file and the key used in m_templates is to exclude the library name.

Definition at line 1144 of file eagle_plugin.cpp.

{
 if( !aLib )
 return;
 
 // library will have <xmlattr> node, skip that and get the single packages node
 wxXmlNode* packages = MapChildren( aLib )["packages"];
 
 if( !packages )
 return;
 
 m_xpath->push( "packages" );
 
 // Create a FOOTPRINT for all the eagle packages, for use later via a copy constructor
 // to instantiate needed footprints in our BOARD. Save the FOOTPRINT templates in
 // a FOOTPRINT_MAP using a single lookup key consisting of libname+pkgname.
 
 // Get the first package and iterate
 wxXmlNode* package = packages->GetChildren();
 
 while( package )
 {
 checkpoint();
 
 m_xpath->push( "package", "name" );
 
 wxString pack_ref = package->GetAttribute( "name" );
 ReplaceIllegalFileNameChars( pack_ref, '_' );
 
 m_xpath->Value( pack_ref.ToUTF8() );
 
 wxString key = aLibName ? makeKey( *aLibName, pack_ref ) : pack_ref;
 
 FOOTPRINT* footprint = makeFootprint( package, pack_ref );
 
 // add the templating FOOTPRINT to the FOOTPRINT template factory "m_templates"
 std::pair<FOOTPRINT_MAP::iterator, bool> r = m_templates.insert( { key, footprint} );
 
 if( !r.second /* && !( m_props && m_props->Value( "ignore_duplicates" ) ) */ )
 {
 wxString lib = aLibName ? *aLibName : m_lib_path;
 const wxString& pkg = pack_ref;
 
 wxString emsg = wxString::Format( _( "<package> '%s' duplicated in <library> '%s'" ),
  pkg,
 lib );
 THROW_IO_ERROR( emsg );
 }
 
 m_xpath->pop();
 
 package = package->GetNext();
 }
 
 m_xpath->pop(); // "packages"
}

References _, checkpoint(), Format(), m_lib_path, m_templates, m_xpath, makeFootprint(), makeKey(), MapChildren(), XPATH::pop(), XPATH::push(), r, ReplaceIllegalFileNameChars(), THROW_IO_ERROR, and XPATH::Value().

Referenced by cacheLib(), and loadLibraries().

loadPlain()

void EAGLE_PLUGIN::loadPlain ( wxXmlNode *  aPlain )

private

Definition at line 700 of file eagle_plugin.cpp.

{
 if( !aGraphics )
 return;
 
 m_xpath->push( "plain" );
 
 // Get the first graphic and iterate
 wxXmlNode* gr = aGraphics->GetChildren();
 
 // (polygon | wire | text | circle | rectangle | frame | hole)*
 while( gr )
 {
 checkpoint();
 
 wxString grName = gr->GetName();
 
 if( grName == wxT( "wire" ) )
 {
 m_xpath->push( "wire" );
 
 EWIRE w( gr );
 PCB_LAYER_ID layer = kicad_layer( w.layer );
 
 VECTOR2I start( kicad_x( w.x1 ), kicad_y( w.y1 ) );
 VECTOR2I end( kicad_x( w.x2 ), kicad_y( w.y2 ) );
 
 if( layer != UNDEFINED_LAYER )
 {
 PCB_SHAPE* shape = new PCB_SHAPE( m_board );
 int width = w.width.ToPcbUnits();
 
 // KiCad cannot handle zero or negative line widths
 if( width <= 0 )
 width = m_board->GetDesignSettings().GetLineThickness( layer );
 
 m_board->Add( shape, ADD_MODE::APPEND );
 
 if( !w.curve )
 {
 shape->SetShape( SHAPE_T::SEGMENT );
 shape->SetStart( start );
 shape->SetEnd( end );
 }
 else
 {
 VECTOR2I center = ConvertArcCenter( start, end, *w.curve );
 
 shape->SetShape( SHAPE_T::ARC );
 shape->SetCenter( center );
 shape->SetStart( start );
 shape->SetArcAngleAndEnd( -EDA_ANGLE( *w.curve, DEGREES_T ), true ); // KiCad rotates the other way
 }
 
 shape->SetLayer( layer );
 shape->SetStroke( STROKE_PARAMS( width, PLOT_DASH_TYPE::SOLID ) );
 }
 
 m_xpath->pop();
 }
 else if( grName == wxT( "text" ) )
 {
 m_xpath->push( "text" );
 
 ETEXT t( gr );
 PCB_LAYER_ID layer = kicad_layer( t.layer );
 
 if( layer != UNDEFINED_LAYER )
 {
 PCB_TEXT* pcbtxt = new PCB_TEXT( m_board );
 m_board->Add( pcbtxt, ADD_MODE::APPEND );
 
 pcbtxt->SetLayer( layer );
 wxString kicadText = interpret_text( t.text );
 pcbtxt->SetText( kicadText );
 pcbtxt->SetTextPos( VECTOR2I( kicad_x( t.x ), kicad_y( t.y ) ) );
 
 double ratio = t.ratio ? *t.ratio : 8; // DTD says 8 is default
 int textThickness = KiROUND( t.size.ToPcbUnits() * ratio / 100 );
 pcbtxt->SetTextThickness( textThickness );
 pcbtxt->SetTextSize( kicad_fontz( t.size, textThickness ) );
 
 int align = t.align ? *t.align : ETEXT::BOTTOM_LEFT;
 
 if( t.rot )
 {
 int sign = t.rot->mirror ? -1 : 1;
 pcbtxt->SetMirrored( t.rot->mirror );
 
 double degrees = t.rot->degrees;
 
 if( degrees == 90 || t.rot->spin )
 {
 pcbtxt->SetTextAngle( EDA_ANGLE( sign * t.rot->degrees, DEGREES_T ) );
 }
 else if( degrees == 180 )
 {
 align = -align;
 }
 else if( degrees == 270 )
 {
 pcbtxt->SetTextAngle( EDA_ANGLE( sign * 90, DEGREES_T ) );
 align = -align;
 }
 else
 {
 // Ok so text is not at 90,180 or 270 so do some funny stuff to get
 // placement right.
 if( ( degrees > 0 ) && ( degrees < 90 ) )
 {
 pcbtxt->SetTextAngle( EDA_ANGLE( sign * t.rot->degrees, DEGREES_T ) );
 }
 else if( ( degrees > 90 ) && ( degrees < 180 ) )
 {
 pcbtxt->SetTextAngle( EDA_ANGLE( sign * ( t.rot->degrees + 180 ), DEGREES_T ) );
 align = ETEXT::TOP_RIGHT;
 }
 else if( ( degrees > 180 ) && ( degrees < 270 ) )
 {
 pcbtxt->SetTextAngle( EDA_ANGLE( sign * ( t.rot->degrees - 180 ), DEGREES_T ) );
 align = ETEXT::TOP_RIGHT;
 }
 else if( ( degrees > 270 ) && ( degrees < 360 ) )
 {
 pcbtxt->SetTextAngle( EDA_ANGLE( sign * t.rot->degrees, DEGREES_T ) );
 align = ETEXT::BOTTOM_LEFT;
 }
 }
 }
 
 switch( align )
 {
 case ETEXT::CENTER:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::CENTER_LEFT:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::CENTER_RIGHT:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::TOP_CENTER:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::TOP_LEFT:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::TOP_RIGHT:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::BOTTOM_CENTER:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 
 case ETEXT::BOTTOM_LEFT:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 
 case ETEXT::BOTTOM_RIGHT:
 pcbtxt->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 pcbtxt->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 }
 }
 
 m_xpath->pop();
 }
 else if( grName == wxT( "circle" ) )
 {
 m_xpath->push( "circle" );
 
 ECIRCLE c( gr );
 
 int width = c.width.ToPcbUnits();
 int radius = c.radius.ToPcbUnits();
 
 if( c.layer == EAGLE_LAYER::TRESTRICT || c.layer == EAGLE_LAYER::BRESTRICT
 || c.layer == EAGLE_LAYER::VRESTRICT )
 {
 ZONE* zone = new ZONE( m_board );
 m_board->Add( zone, ADD_MODE::APPEND );
 
 setKeepoutSettingsToZone( zone, c.layer );
 
 // approximate circle as polygon
 VECTOR2I center( kicad_x( c.x ), kicad_y( c.y ) );
 int outlineRadius = radius + ( width / 2 );
 int segsInCircle = GetArcToSegmentCount( outlineRadius, ARC_HIGH_DEF, FULL_CIRCLE );
 EDA_ANGLE delta = ANGLE_360 / segsInCircle;
 
 for( EDA_ANGLE angle = ANGLE_0; angle < ANGLE_360; angle += delta )
 {
 VECTOR2I rotatedPoint( outlineRadius, 0 );
 RotatePoint( rotatedPoint, angle );
 zone->AppendCorner( center + rotatedPoint, -1 );
 }
 
 if( width > 0 )
 {
 zone->NewHole();
 int innerRadius = radius - ( width / 2 );
 segsInCircle = GetArcToSegmentCount( innerRadius, ARC_HIGH_DEF, FULL_CIRCLE );
 delta = ANGLE_360 / segsInCircle;
 
 for( EDA_ANGLE angle = ANGLE_0; angle < ANGLE_360; angle += delta )
 {
 VECTOR2I rotatedPoint( innerRadius, 0 );
 RotatePoint( rotatedPoint, angle );
 zone->AppendCorner( center + rotatedPoint, 0 );
 }
 }
 
 zone->SetBorderDisplayStyle( ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_EDGE,
 ZONE::GetDefaultHatchPitch(), true );
 }
 else
 {
 PCB_LAYER_ID layer = kicad_layer( c.layer );
 
 if( layer != UNDEFINED_LAYER ) // unsupported layer
 {
 PCB_SHAPE* shape = new PCB_SHAPE( m_board, SHAPE_T::CIRCLE );
 m_board->Add( shape, ADD_MODE::APPEND );
 shape->SetFilled( false );
 shape->SetLayer( layer );
 shape->SetStart( VECTOR2I( kicad_x( c.x ), kicad_y( c.y ) ) );
 shape->SetEnd( VECTOR2I( kicad_x( c.x ) + radius, kicad_y( c.y ) ) );
 shape->SetStroke( STROKE_PARAMS( width, PLOT_DASH_TYPE::SOLID ) );
 }
 }
 
 m_xpath->pop();
 }
 else if( grName == wxT( "rectangle" ) )
 {
 // This seems to be a simplified rectangular [copper] zone, cannot find any
 // net related info on it from the DTD.
 m_xpath->push( "rectangle" );
 
 ERECT r( gr );
 PCB_LAYER_ID layer = kicad_layer( r.layer );
 
 if( IsCopperLayer( layer ) )
 {
 // use a "netcode = 0" type ZONE:
 ZONE* zone = new ZONE( m_board );
 m_board->Add( zone, ADD_MODE::APPEND );
 
 zone->SetLayer( layer );
 zone->SetNetCode( NETINFO_LIST::UNCONNECTED );
 
 ZONE_BORDER_DISPLAY_STYLE outline_hatch = ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_EDGE;
 
 const int outlineIdx = -1; // this is the id of the copper zone main outline
 zone->AppendCorner( VECTOR2I( kicad_x( r.x1 ), kicad_y( r.y1 ) ), outlineIdx );
 zone->AppendCorner( VECTOR2I( kicad_x( r.x2 ), kicad_y( r.y1 ) ), outlineIdx );
 zone->AppendCorner( VECTOR2I( kicad_x( r.x2 ), kicad_y( r.y2 ) ), outlineIdx );
 zone->AppendCorner( VECTOR2I( kicad_x( r.x1 ), kicad_y( r.y2 ) ), outlineIdx );
 
 if( r.rot )
 zone->Rotate( zone->GetPosition(), EDA_ANGLE( r.rot->degrees, DEGREES_T ) );
 
 // this is not my fault:
 zone->SetBorderDisplayStyle( outline_hatch, ZONE::GetDefaultHatchPitch(),
 true );
 }
 
 m_xpath->pop();
 }
 else if( grName == wxT( "hole" ) )
 {
 m_xpath->push( "hole" );
 
 // Fabricate a FOOTPRINT with a single PAD_ATTRIB::NPTH pad.
 // Use m_hole_count to gen up a unique name.
 
 FOOTPRINT* footprint = new FOOTPRINT( m_board );
 m_board->Add( footprint, ADD_MODE::APPEND );
 footprint->SetReference( wxString::Format( wxT( "@HOLE%d" ), m_hole_count++ ) );
 footprint->Reference().SetVisible( false );
 
 packageHole( footprint, gr, true );
 
 m_xpath->pop();
 }
 else if( grName == wxT( "frame" ) )
 {
 // picture this
 }
 else if( grName == wxT( "polygon" ) )
 {
 m_xpath->push( "polygon" );
 loadPolygon( gr );
 m_xpath->pop(); // "polygon"
 }
 else if( grName == wxT( "dimension" ) )
 {
 const BOARD_DESIGN_SETTINGS& designSettings = m_board->GetDesignSettings();
 
 EDIMENSION d( gr );
 PCB_LAYER_ID layer = kicad_layer( d.layer );
 VECTOR2I pt1( kicad_x( d.x1 ), kicad_y( d.y1 ) );
 VECTOR2I pt2( kicad_x( d.x2 ), kicad_y( d.y2 ) );
 VECTOR2I pt3( kicad_x( d.x3 ), kicad_y( d.y3 ) );
 wxSize textSize = designSettings.GetTextSize( layer );
 int textThickness = designSettings.GetLineThickness( layer );
 
 if( d.textsize )
 {
 double ratio = 8; // DTD says 8 is default
 textThickness = KiROUND( d.textsize->ToPcbUnits() * ratio / 100 );
 textSize = kicad_fontz( *d.textsize, textThickness );
 }
 
 if( layer != UNDEFINED_LAYER )
 {
 if( d.dimensionType == wxT( "angle" ) )
 {
 // Kicad doesn't (at present) support angle dimensions
 }
 else if( d.dimensionType == wxT( "radius" ) )
 {
 PCB_DIM_RADIAL* dimension = new PCB_DIM_RADIAL( m_board );
 m_board->Add( dimension, ADD_MODE::APPEND );
 
 dimension->SetLayer( layer );
 dimension->SetPrecision( DIMENSION_PRECISION );
 
 dimension->SetStart( pt1 );
 dimension->SetEnd( pt2 );
 dimension->Text().SetPosition( pt3 );
 dimension->Text().SetTextSize( textSize );
 dimension->Text().SetTextThickness( textThickness );
 dimension->SetLineThickness( designSettings.GetLineThickness( layer ) );
 dimension->SetUnits( EDA_UNITS::MILLIMETRES );
 }
 else if( d.dimensionType == wxT( "leader" ) )
 {
 PCB_DIM_LEADER* leader = new PCB_DIM_LEADER( m_board );
 m_board->Add( leader, ADD_MODE::APPEND );
 
 leader->SetLayer( layer );
 leader->SetPrecision( DIMENSION_PRECISION );
 
 leader->SetStart( pt1 );
 leader->SetEnd( pt2 );
 leader->Text().SetPosition( pt3 );
 leader->Text().SetTextSize( textSize );
 leader->Text().SetTextThickness( textThickness );
 leader->SetText( wxEmptyString );
 leader->SetLineThickness( designSettings.GetLineThickness( layer ) );
 }
 else // horizontal, vertical, <default>, diameter
 {
 PCB_DIM_ALIGNED* dimension = new PCB_DIM_ALIGNED( m_board, PCB_DIM_ALIGNED_T );
 m_board->Add( dimension, ADD_MODE::APPEND );
 
 if( d.dimensionType )
 {
 // Eagle dimension graphic arms may have different lengths, but they look
 // incorrect in KiCad (the graphic is tilted). Make them even length in
 // such case.
 if( *d.dimensionType == wxT( "horizontal" ) )
 {
 int newY = ( pt1.y + pt2.y ) / 2;
 pt1.y = newY;
 pt2.y = newY;
 }
 else if( *d.dimensionType == wxT( "vertical" ) )
 {
 int newX = ( pt1.x + pt2.x ) / 2;
 pt1.x = newX;
 pt2.x = newX;
 }
 }
 
 dimension->SetLayer( layer );
 dimension->SetPrecision( DIMENSION_PRECISION );
 
 // The origin and end are assumed to always be in this order from eagle
 dimension->SetStart( pt1 );
 dimension->SetEnd( pt2 );
 dimension->Text().SetTextSize( textSize );
 dimension->Text().SetTextThickness( textThickness );
 dimension->SetLineThickness( designSettings.GetLineThickness( layer ) );
 dimension->SetUnits( EDA_UNITS::MILLIMETRES );
 
 // check which axis the dimension runs in
 // because the "height" of the dimension is perpendicular to that axis
 // Note the check is just if two axes are close enough to each other
 // Eagle appears to have some rounding errors
 if( abs( pt1.x - pt2.x ) < 50000 ) // 50000 nm = 0.05 mm
 {
 int offset = pt3.x - pt1.x;
 
 if( pt1.y > pt2.y )
 dimension->SetHeight( offset );
 else
 dimension->SetHeight( -offset );
 }
 else if( abs( pt1.y - pt2.y ) < 50000 )
 {
 int offset = pt3.y - pt1.y;
 
 if( pt1.x > pt2.x )
 dimension->SetHeight( -offset );
 else
 dimension->SetHeight( offset );
 }
 else
 {
 int offset = GetLineLength( pt3, pt1 );
 
 if( pt1.y > pt2.y )
 dimension->SetHeight( offset );
 else
 dimension->SetHeight( -offset );
 }
 }
 }
 }
 
 // Get next graphic
 gr = gr->GetNext();
 }
 
 m_xpath->pop();
}

References std::abs(), BOARD::Add(), ETEXT::align, PNS::angle(), ANGLE_0, ANGLE_360, APPEND, ZONE::AppendCorner(), ARC, ARC_HIGH_DEF, ETEXT::BOTTOM_CENTER, ETEXT::BOTTOM_LEFT, ETEXT::BOTTOM_RIGHT, EAGLE_LAYER::BRESTRICT, ETEXT::CENTER, ETEXT::CENTER_LEFT, ETEXT::CENTER_RIGHT, checkpoint(), CIRCLE, ConvertArcCenter(), EWIRE::curve, EROT::degrees, DEGREES_T, delta, DIAGONAL_EDGE, DIMENSION_PRECISION, EDIMENSION::dimensionType, Format(), FULL_CIRCLE, GetArcToSegmentCount(), ZONE::GetDefaultHatchPitch(), BOARD::GetDesignSettings(), GetLineLength(), BOARD_DESIGN_SETTINGS::GetLineThickness(), ZONE::GetPosition(), BOARD_DESIGN_SETTINGS::GetTextSize(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_H_ALIGN_LEFT, GR_TEXT_H_ALIGN_RIGHT, GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_V_ALIGN_CENTER, GR_TEXT_V_ALIGN_TOP, interpret_text(), IsCopperLayer(), kicad_fontz(), kicad_layer(), kicad_x(), kicad_y(), KiROUND(), EWIRE::layer, ECIRCLE::layer, EDIMENSION::layer, ETEXT::layer, loadPolygon(), m_board, m_hole_count, m_xpath, MILLIMETRES, EROT::mirror, ZONE::NewHole(), packageHole(), PCB_DIM_ALIGNED_T, XPATH::pop(), XPATH::push(), r, ECIRCLE::radius, ETEXT::ratio, FOOTPRINT::Reference(), ETEXT::rot, ZONE::Rotate(), RotatePoint(), SEGMENT, EDA_SHAPE::SetArcAngleAndEnd(), ZONE::SetBorderDisplayStyle(), EDA_SHAPE::SetCenter(), EDA_SHAPE::SetEnd(), PCB_DIMENSION_BASE::SetEnd(), EDA_SHAPE::SetFilled(), PCB_DIM_ALIGNED::SetHeight(), EDA_TEXT::SetHorizJustify(), setKeepoutSettingsToZone(), BOARD_ITEM::SetLayer(), PCB_DIMENSION_BASE::SetLayer(), ZONE::SetLayer(), PCB_DIMENSION_BASE::SetLineThickness(), EDA_TEXT::SetMirrored(), BOARD_CONNECTED_ITEM::SetNetCode(), PCB_TEXT::SetPosition(), PCB_DIMENSION_BASE::SetPrecision(), FOOTPRINT::SetReference(), EDA_SHAPE::SetShape(), PCB_DIMENSION_BASE::SetStart(), EDA_SHAPE::SetStart(), PCB_SHAPE::SetStroke(), PCB_DIMENSION_BASE::SetText(), EDA_TEXT::SetText(), EDA_TEXT::SetTextAngle(), EDA_TEXT::SetTextPos(), EDA_TEXT::SetTextSize(), EDA_TEXT::SetTextThickness(), PCB_DIMENSION_BASE::SetUnits(), EDA_TEXT::SetVertJustify(), EDA_TEXT::SetVisible(), sign(), ETEXT::size, SOLID, EROT::spin, ETEXT::text, PCB_DIMENSION_BASE::Text(), EDIMENSION::textsize, ETEXT::TOP_CENTER, ETEXT::TOP_LEFT, ETEXT::TOP_RIGHT, ECOORD::ToPcbUnits(), EAGLE_LAYER::TRESTRICT, NETINFO_LIST::UNCONNECTED, UNDEFINED_LAYER, EAGLE_LAYER::VRESTRICT, EWIRE::width, ECIRCLE::width, ECIRCLE::x, ETEXT::x, VECTOR2< T >::x, EWIRE::x1, EDIMENSION::x1, EWIRE::x2, EDIMENSION::x2, EDIMENSION::x3, ECIRCLE::y, ETEXT::y, VECTOR2< T >::y, EWIRE::y1, EDIMENSION::y1, EWIRE::y2, EDIMENSION::y2, and EDIMENSION::y3.

Referenced by loadAllSections().

loadPolygon()

ZONE * EAGLE_PLUGIN::loadPolygon ( wxXmlNode *  aPolyNode )

private

Load a copper or keepout polygon and adds it to the board.

Returns

The loaded zone or nullptr if was not processed.

Definition at line 1492 of file eagle_plugin.cpp.

{
 EPOLYGON p( aPolyNode );
 PCB_LAYER_ID layer = kicad_layer( p.layer );
 ZONE* zone = nullptr;
 bool keepout = ( p.layer == EAGLE_LAYER::TRESTRICT
 || p.layer == EAGLE_LAYER::BRESTRICT
 || p.layer == EAGLE_LAYER::VRESTRICT );
 
 if( layer == UNDEFINED_LAYER )
  {
 wxLogMessage( wxString::Format( _( "Ignoring a polygon since Eagle layer '%s' (%d) "
 "was not mapped" ),
 eagle_layer_name( p.layer ), p.layer ) );
 return nullptr;
 }
 
 if( !IsCopperLayer( layer ) && !keepout )
 return nullptr;
 
 // use a "netcode = 0" type ZONE:
 zone = new ZONE( m_board );
 m_board->Add( zone, ADD_MODE::APPEND );
 
 if( !keepout )
 zone->SetLayer( layer );
 else
 setKeepoutSettingsToZone( zone, p.layer );
 
 // Get the first vertex and iterate
 wxXmlNode* vertex = aPolyNode->GetChildren();
 std::vector<EVERTEX> vertices;
 
 // Create a circular vector of vertices
 // The "curve" parameter indicates a curve from the current
 // to the next vertex, so we keep the first at the end as well
 // to allow the curve to link back
 while( vertex )
 {
 if( vertex->GetName() == wxT( "vertex" ) )
 vertices.emplace_back( vertex );
 
 vertex = vertex->GetNext();
 }
 
 vertices.push_back( vertices[0] );
 
 SHAPE_POLY_SET polygon;
 polygon.NewOutline();
 
 for( size_t i = 0; i < vertices.size() - 1; i++ )
 {
 EVERTEX v1 = vertices[i];
 
 // Append the corner
 polygon.Append( kicad_x( v1.x ), kicad_y( v1.y ) );
 
 if( v1.curve )
 {
 EVERTEX v2 = vertices[i + 1];
 VECTOR2I center =
 ConvertArcCenter( VECTOR2I( kicad_x( v1.x ), kicad_y( v1.y ) ),
 VECTOR2I( kicad_x( v2.x ), kicad_y( v2.y ) ), *v1.curve );
 double angle = DEG2RAD( *v1.curve );
 double end_angle = atan2( kicad_y( v2.y ) - center.y, kicad_x( v2.x ) - center.x );
 double radius = sqrt( pow( center.x - kicad_x( v1.x ), 2 )
 + pow( center.y - kicad_y( v1.y ), 2 ) );
 
 int segCount = GetArcToSegmentCount( KiROUND( radius ), ARC_HIGH_DEF,
 EDA_ANGLE( *v1.curve, DEGREES_T ) );
 double delta_angle = angle / segCount;
 
 for( double a = end_angle + angle; fabs( a - end_angle ) > fabs( delta_angle );
 a -= delta_angle )
 {
 polygon.Append( KiROUND( radius * cos( a ) ) + center.x,
 KiROUND( radius * sin( a ) ) + center.y );
 }
 }
 }
 
 // Eagle traces the zone such that half of the pen width is outside the polygon.
 // We trace the zone such that the copper is completely inside.
 if( p.width.ToPcbUnits() > 0 )
 {
 polygon.Inflate( p.width.ToPcbUnits() / 2, 32, SHAPE_POLY_SET::ALLOW_ACUTE_CORNERS );
 polygon.Fracture( SHAPE_POLY_SET::PM_STRICTLY_SIMPLE );
 }
 
 zone->AddPolygon( polygon.COutline( 0 ) );
 
 // If the pour is a cutout it needs to be set to a keepout
 if( p.pour == EPOLYGON::CUTOUT )
 {
 zone->SetIsRuleArea( true );
 zone->SetDoNotAllowVias( false );
 zone->SetDoNotAllowTracks( false );
 zone->SetDoNotAllowPads( false );
 zone->SetDoNotAllowFootprints( false );
 zone->SetDoNotAllowCopperPour( true );
 zone->SetHatchStyle( ZONE_BORDER_DISPLAY_STYLE::NO_HATCH );
 }
 else if( p.pour == EPOLYGON::HATCH )
 {
 int spacing = p.spacing ? p.spacing->ToPcbUnits() : 50 * pcbIUScale.IU_PER_MILS;
 
 zone->SetFillMode( ZONE_FILL_MODE::HATCH_PATTERN );
 zone->SetHatchThickness( p.width.ToPcbUnits() );
 zone->SetHatchGap( spacing - p.width.ToPcbUnits() );
 zone->SetHatchOrientation( ANGLE_0 );
 }
 
 // We divide the thickness by half because we are tracing _inside_ the zone outline
 // This means the radius of curvature will be twice the size for an equivalent EAGLE zone
 zone->SetMinThickness( std::max<int>( ZONE_THICKNESS_MIN_VALUE_MIL * pcbIUScale.IU_PER_MILS,
 p.width.ToPcbUnits() / 2 ) );
 
 if( p.isolate )
 zone->SetLocalClearance( p.isolate->ToPcbUnits() );
 else
 zone->SetLocalClearance( 1 ); // @todo: set minimum clearance value based on board settings
 
 // missing == yes per DTD.
 bool thermals = !p.thermals || *p.thermals;
 zone->SetPadConnection( thermals ? ZONE_CONNECTION::THERMAL : ZONE_CONNECTION::FULL );
 
 if( thermals )
 {
 // FIXME: eagle calculates dimensions for thermal spokes
 // based on what the zone is connecting to.
 // (i.e. width of spoke is half of the smaller side of an smd pad)
 // This is a basic workaround
 zone->SetThermalReliefGap( p.width.ToPcbUnits() + 50000 ); // 50000nm == 0.05mm
 zone->SetThermalReliefSpokeWidth( p.width.ToPcbUnits() + 50000 );
 }
 
 int rank = p.rank ? (p.max_priority - *p.rank) : p.max_priority;
 zone->SetAssignedPriority( rank );
 
 return zone;
}

References _, BOARD::Add(), ZONE::AddPolygon(), SHAPE_POLY_SET::ALLOW_ACUTE_CORNERS, PNS::angle(), ANGLE_0, SHAPE_POLY_SET::Append(), APPEND, ARC_HIGH_DEF, EAGLE_LAYER::BRESTRICT, ConvertArcCenter(), SHAPE_POLY_SET::COutline(), EVERTEX::curve, EPOLYGON::CUTOUT, DEG2RAD(), DEGREES_T, eagle_layer_name(), Format(), SHAPE_POLY_SET::Fracture(), FULL, GetArcToSegmentCount(), EPOLYGON::HATCH, HATCH_PATTERN, SHAPE_POLY_SET::Inflate(), IsCopperLayer(), EPOLYGON::isolate, EDA_IU_SCALE::IU_PER_MILS, kicad_layer(), kicad_x(), kicad_y(), KiROUND(), EPOLYGON::layer, m_board, EPOLYGON::max_priority, SHAPE_POLY_SET::NewOutline(), NO_HATCH, pcbIUScale, SHAPE_POLY_SET::PM_STRICTLY_SIMPLE, EPOLYGON::pour, EPOLYGON::rank, ZONE::SetAssignedPriority(), ZONE::SetDoNotAllowCopperPour(), ZONE::SetDoNotAllowFootprints(), ZONE::SetDoNotAllowPads(), ZONE::SetDoNotAllowTracks(), ZONE::SetDoNotAllowVias(), ZONE::SetFillMode(), ZONE::SetHatchGap(), ZONE::SetHatchOrientation(), ZONE::SetHatchStyle(), ZONE::SetHatchThickness(), ZONE::SetIsRuleArea(), setKeepoutSettingsToZone(), ZONE::SetLayer(), ZONE::SetLocalClearance(), ZONE::SetMinThickness(), ZONE::SetPadConnection(), ZONE::SetThermalReliefGap(), ZONE::SetThermalReliefSpokeWidth(), EPOLYGON::spacing, THERMAL, EPOLYGON::thermals, ECOORD::ToPcbUnits(), EAGLE_LAYER::TRESTRICT, UNDEFINED_LAYER, v2, EAGLE_LAYER::VRESTRICT, EPOLYGON::width, EVERTEX::x, VECTOR2< T >::x, EVERTEX::y, VECTOR2< T >::y, and ZONE_THICKNESS_MIN_VALUE_MIL.

Referenced by loadPlain(), and loadSignals().

loadSignals()

void EAGLE_PLUGIN::loadSignals ( wxXmlNode *  aSignals )

private

This is, at best, a guess. Eagle doesn't seem to differentiate between blind/buried vias that only go one layer and micro vias so the user will need to clean up a bit

Definition at line 2635 of file eagle_plugin.cpp.

{
 ZONES zones; // per net
 int netCode = 1;
 
 m_xpath->push( "signals.signal", "name" );
 
 // Get the first signal and iterate
 wxXmlNode* net = aSignals->GetChildren();
 
 while( net )
 {
 checkpoint();
 
 bool sawPad = false;
 
 zones.clear();
 
 const wxString& netName = escapeName( net->GetAttribute( "name" ) );
 NETINFO_ITEM* netInfo = new NETINFO_ITEM( m_board, netName, netCode );
 std::shared_ptr<NETCLASS> netclass;
 
 if( net->HasAttribute( "class" ) )
 {
 netclass = m_classMap[ net->GetAttribute( "class" ) ];
 
 m_board->GetDesignSettings().m_NetSettings->m_NetClassPatternAssignments.push_back(
 {
 std::make_unique<EDA_COMBINED_MATCHER>( netName, CTX_NETCLASS ),
 netclass->GetName()
 } );
 
 netInfo->SetNetClass( netclass );
 }
 
 m_board->Add( netInfo );
 
 m_xpath->Value( netName.c_str() );
 
 // Get the first net item and iterate
 wxXmlNode* netItem = net->GetChildren();
 
 // (contactref | polygon | wire | via)*
 while( netItem )
 {
 const wxString& itemName = netItem->GetName();
 
 if( itemName == wxT( "wire" ) )
 {
 m_xpath->push( "wire" );
 
 EWIRE w( netItem );
 PCB_LAYER_ID layer = kicad_layer( w.layer );
 
 if( IsCopperLayer( layer ) )
 {
 VECTOR2I start( kicad_x( w.x1 ), kicad_y( w.y1 ) );
 double angle = 0.0;
 double end_angle = 0.0;
 double radius = 0.0;
 double delta_angle = 0.0;
 VECTOR2I center;
 
 int width = w.width.ToPcbUnits();
 
 if( width < m_min_trace )
 m_min_trace = width;
 
 if( netclass && width < netclass->GetTrackWidth() )
 netclass->SetTrackWidth( width );
 
 if( w.curve )
 {
 center = ConvertArcCenter( VECTOR2I( kicad_x( w.x1 ), kicad_y( w.y1 ) ),
 VECTOR2I( kicad_x( w.x2 ), kicad_y( w.y2 ) ),
 *w.curve );
 
 angle = DEG2RAD( *w.curve );
 
 end_angle = atan2( kicad_y( w.y2 ) - center.y,
 kicad_x( w.x2 ) - center.x );
 
 radius = sqrt( pow( center.x - kicad_x( w.x1 ), 2 ) +
 pow( center.y - kicad_y( w.y1 ), 2 ) );
 
 int segs = GetArcToSegmentCount( KiROUND( radius ), ARC_HIGH_DEF,
 EDA_ANGLE( *w.curve, DEGREES_T ) );
  delta_angle = angle / segs;
 }
 
 while( fabs( angle ) > fabs( delta_angle ) )
 {
 wxASSERT( radius > 0.0 );
 VECTOR2I end( KiROUND( radius * cos( end_angle + angle ) + center.x ),
 KiROUND( radius * sin( end_angle + angle ) + center.y ) );
 
 PCB_TRACK* t = new PCB_TRACK( m_board );
 
 t->SetPosition( start );
 t->SetEnd( end );
 t->SetWidth( width );
 t->SetLayer( layer );
 t->SetNetCode( netCode );
 
 m_board->Add( t );
 
 start = end;
 angle -= delta_angle;
 }
 
 PCB_TRACK* t = new PCB_TRACK( m_board );
 
 t->SetPosition( start );
 t->SetEnd( VECTOR2I( kicad_x( w.x2 ), kicad_y( w.y2 ) ) );
 t->SetWidth( width );
 t->SetLayer( layer );
 t->SetNetCode( netCode );
 
 m_board->Add( t );
 }
 else
 {
 // put non copper wires where the sun don't shine.
 }
 
 m_xpath->pop();
 }
 else if( itemName == wxT( "via" ) )
 {
 m_xpath->push( "via" );
 EVIA v( netItem );
 
 if( v.layer_front_most > v.layer_back_most )
 std::swap( v.layer_front_most, v.layer_back_most );
 
 PCB_LAYER_ID layer_front_most = kicad_layer( v.layer_front_most );
 PCB_LAYER_ID layer_back_most = kicad_layer( v.layer_back_most );
 
 if( IsCopperLayer( layer_front_most ) && IsCopperLayer( layer_back_most )
 && layer_front_most != layer_back_most )
 {
 int kidiam;
 int drillz = v.drill.ToPcbUnits();
 PCB_VIA* via = new PCB_VIA( m_board );
 m_board->Add( via );
 
 if( v.diam )
 {
 kidiam = v.diam->ToPcbUnits();
 via->SetWidth( kidiam );
 }
 else
 {
 double annulus = drillz * m_rules->rvViaOuter; // eagle "restring"
 annulus = eagleClamp( m_rules->rlMinViaOuter, annulus,
 m_rules->rlMaxViaOuter );
 kidiam = KiROUND( drillz + 2 * annulus );
 via->SetWidth( kidiam );
 }
 
 via->SetDrill( drillz );
 
 // make sure the via diameter respects the restring rules
 
 if( !v.diam || via->GetWidth() <= via->GetDrill() )
 {
 double annulus =
 eagleClamp( m_rules->rlMinViaOuter,
 (double) ( via->GetWidth() / 2 - via->GetDrill() ),
 m_rules->rlMaxViaOuter );
 via->SetWidth( drillz + 2 * annulus );
 }
 
 if( kidiam < m_min_via )
 m_min_via = kidiam;
 
 if( netclass && kidiam < netclass->GetViaDiameter() )
 netclass->SetViaDiameter( kidiam );
 
 if( drillz < m_min_hole )
 m_min_hole = drillz;
 
 if( netclass && drillz < netclass->GetViaDrill() )
 netclass->SetViaDrill( drillz );
 
 if( ( kidiam - drillz ) / 2 < m_min_annulus )
 m_min_annulus = ( kidiam - drillz ) / 2;
 
 if( layer_front_most == F_Cu && layer_back_most == B_Cu )
 {
 via->SetViaType( VIATYPE::THROUGH );
 }
 else if( v.layer_back_most - v.layer_front_most == 1 )
 {
 via->SetViaType( VIATYPE::MICROVIA );
 }
 else
 {
 via->SetViaType( VIATYPE::BLIND_BURIED );
  }
 
 VECTOR2I pos( kicad_x( v.x ), kicad_y( v.y ) );
 
 via->SetLayerPair( layer_front_most, layer_back_most );
 via->SetPosition( pos );
 via->SetEnd( pos );
 
 via->SetNetCode( netCode );
 }
 
 m_xpath->pop();
 }
 
 else if( itemName == wxT( "contactref" ) )
 {
 m_xpath->push( "contactref" );
 // <contactref element="RN1" pad="7"/>
 
 const wxString& reference = netItem->GetAttribute( "element" );
 const wxString& pad = netItem->GetAttribute( "pad" );
 wxString key = makeKey( reference, pad ) ;
 
 m_pads_to_nets[ key ] = ENET( netCode, netName );
 
 m_xpath->pop();
 
 sawPad = true;
 }
 
 else if( itemName == wxT( "polygon" ) )
 {
 m_xpath->push( "polygon" );
 auto* zone = loadPolygon( netItem );
 
 if( zone )
 {
 zones.push_back( zone );
 
 if( !zone->GetIsRuleArea() )
 zone->SetNetCode( netCode );
 }
 
 m_xpath->pop(); // "polygon"
 }
 
 netItem = netItem->GetNext();
 }
 
 if( zones.size() && !sawPad )
 {
 // KiCad does not support an unconnected zone with its own non-zero netcode,
 // but only when assigned netcode = 0 w/o a name...
 for( ZONE* zone : zones )
 zone->SetNetCode( NETINFO_LIST::UNCONNECTED );
 
 // therefore omit this signal/net.
 }
 else
 {
 netCode++;
 }
 
 // Get next signal
 net = net->GetNext();
 }
 
 m_xpath->pop(); // "signals.signal"
}

References BOARD::Add(), PNS::angle(), ARC_HIGH_DEF, B_Cu, BLIND_BURIED, checkpoint(), ConvertArcCenter(), CTX_NETCLASS, EWIRE::curve, DEG2RAD(), DEGREES_T, EVIA::diam, EVIA::drill, eagleClamp(), escapeName(), F_Cu, GetArcToSegmentCount(), BOARD::GetDesignSettings(), IsCopperLayer(), kicad_layer(), kicad_x(), kicad_y(), KiROUND(), EWIRE::layer, EVIA::layer_back_most, EVIA::layer_front_most, loadPolygon(), m_board, m_classMap, m_min_annulus, m_min_hole, m_min_trace, m_min_via, BOARD_DESIGN_SETTINGS::m_NetSettings, m_pads_to_nets, m_rules, m_xpath, makeKey(), MICROVIA, pad, XPATH::pop(), XPATH::push(), ERULES::rlMaxViaOuter, ERULES::rlMinViaOuter, ERULES::rvViaOuter, PCB_TRACK::SetEnd(), BOARD_ITEM::SetLayer(), NETINFO_ITEM::SetNetClass(), BOARD_CONNECTED_ITEM::SetNetCode(), PCB_TRACK::SetPosition(), PCB_TRACK::SetWidth(), THROUGH, ECOORD::ToPcbUnits(), NETINFO_LIST::UNCONNECTED, XPATH::Value(), via, EWIRE::width, EVIA::x, VECTOR2< T >::x, EWIRE::x1, EWIRE::x2, EVIA::y, VECTOR2< T >::y, EWIRE::y1, and EWIRE::y2.

Referenced by loadAllSections().

makeFootprint()

FOOTPRINT * EAGLE_PLUGIN::makeFootprint ( wxXmlNode *  aPackage, const wxString &  aPkgName  )

private

Create a FOOTPRINT from an Eagle package.

Definition at line 1809 of file eagle_plugin.cpp.

{
 std::unique_ptr<FOOTPRINT> m = std::make_unique<FOOTPRINT>( m_board );
 
 LIB_ID fpID;
 fpID.Parse( aPkgName, true );
 m->SetFPID( fpID );
 
 // Get the first package item and iterate
 wxXmlNode* packageItem = aPackage->GetChildren();
 
 // layer 27 is default layer for tValues
 // set default layer for created footprint
 PCB_LAYER_ID layer = kicad_layer( 27 );
 m.get()->Value().SetLayer( layer );
 
 while( packageItem )
 {
 const wxString& itemName = packageItem->GetName();
 
 if( itemName == wxT( "description" ) )
 m->SetDescription( packageItem->GetNodeContent() );
 else if( itemName == wxT( "wire" ) )
 packageWire( m.get(), packageItem );
 else if( itemName == wxT( "pad" ) )
 packagePad( m.get(), packageItem );
 else if( itemName == wxT( "text" ) )
 packageText( m.get(), packageItem );
 else if( itemName == wxT( "rectangle" ) )
 packageRectangle( m.get(), packageItem );
 else if( itemName == wxT( "polygon" ) )
 packagePolygon( m.get(), packageItem );
 else if( itemName == wxT( "circle" ) )
 packageCircle( m.get(), packageItem );
 else if( itemName == wxT( "hole" ) )
 packageHole( m.get(), packageItem, false );
 else if( itemName == wxT( "smd" ) )
 packageSMD( m.get(), packageItem );
 
 packageItem = packageItem->GetNext();
 }
 
 return m.release();
}

References kicad_layer(), m_board, packageCircle(), packageHole(), packagePad(), packagePolygon(), packageRectangle(), packageSMD(), packageText(), packageWire(), and LIB_ID::Parse().

Referenced by loadLibrary().

mapEagleLayersToKicad()

void EAGLE_PLUGIN::mapEagleLayersToKicad ( bool  aIsLibraryCache = false )

private

Generate mapping between Eagle and KiCad layers.

Warning

It is imperative that this gets called correctly because footprint libraries do not get remapped by the user on load. Otherwise, Pcbnew will crash when attempting to load footprint libraries that contain layers that do not exist in the EAGLE_LAYER definitions.

Parameters

aIsLibraryCache

is the flag to indicate when mapping the footprint library cache layers rather than the board layers.

Definition at line 2923 of file eagle_plugin.cpp.

{
 std::vector<INPUT_LAYER_DESC> inputDescs;
 
 for ( const std::pair<const int, ELAYER>& layerPair : m_eagleLayers )
 {
 const ELAYER& eLayer = layerPair.second;
 
 INPUT_LAYER_DESC layerDesc;
 std::tie( layerDesc.AutoMapLayer, layerDesc.PermittedLayers, layerDesc.Required ) =
 defaultKicadLayer( eLayer.number, aIsLibraryCache );
 
 if( layerDesc.AutoMapLayer == UNDEFINED_LAYER )
 continue; // Ignore unused copper layers
 
 layerDesc.Name = eLayer.name;
 
 inputDescs.push_back( layerDesc );
 }
 
 if( m_progressReporter && dynamic_cast<wxWindow*>( m_progressReporter ) )
 dynamic_cast<wxWindow*>( m_progressReporter )->Hide();
 
 m_layer_map = m_layer_mapping_handler( inputDescs );
 
 if( m_progressReporter && dynamic_cast<wxWindow*>( m_progressReporter ))
 dynamic_cast<wxWindow*>( m_progressReporter )->Show();
}

References INPUT_LAYER_DESC::AutoMapLayer, defaultKicadLayer(), m_eagleLayers, m_layer_map, LAYER_REMAPPABLE_PLUGIN::m_layer_mapping_handler, m_progressReporter, ELAYER::name, INPUT_LAYER_DESC::Name, ELAYER::number, INPUT_LAYER_DESC::PermittedLayers, INPUT_LAYER_DESC::Required, and UNDEFINED_LAYER.

Referenced by cacheLib(), and loadAllSections().

orientFootprintAndText()

void EAGLE_PLUGIN::orientFootprintAndText ( FOOTPRINT *  aFootprint, const EELEMENT &  e, const EATTR *  aNameAttr, const EATTR *  aValueAttr  )

private

Definition at line 1635 of file eagle_plugin.cpp.

{
 if( e.rot )
 {
 if( e.rot->mirror )
 {
 aFootprint->SetOrientation( EDA_ANGLE( e.rot->degrees + 180.0, DEGREES_T ) );
 aFootprint->Flip( aFootprint->GetPosition(), false );
 }
 else
 {
 aFootprint->SetOrientation( EDA_ANGLE( e.rot->degrees, DEGREES_T ) );
 }
 }
 
 orientFPText( aFootprint, e, &aFootprint->Reference(), aNameAttr );
 orientFPText( aFootprint, e, &aFootprint->Value(), aValueAttr );
}

References EROT::degrees, DEGREES_T, FOOTPRINT::Flip(), FOOTPRINT::GetPosition(), EROT::mirror, orientFPText(), FOOTPRINT::Reference(), EELEMENT::rot, FOOTPRINT::SetOrientation(), and FOOTPRINT::Value().

Referenced by loadElements().

orientFPText()

void EAGLE_PLUGIN::orientFPText ( FOOTPRINT *  aFootprint, const EELEMENT &  e, FP_TEXT *  aFPText, const EATTR *  aAttr  )

private

Definition at line 1656 of file eagle_plugin.cpp.

{
 // Smashed part ?
 if( aAttr )
 {
 // Yes
 const EATTR& a = *aAttr;
 
 if( a.value )
 {
 aFPText->SetText( *a.value );
 }
 
 if( a.x && a.y ) // std::optional
 {
 VECTOR2I pos( kicad_x( *a.x ), kicad_y( *a.y ) );
 aFPText->SetTextPos( pos );
 }
 
 // Even though size and ratio are both optional, I am not seeing
 // a case where ratio is present but size is not.
 double ratio = 8;
 
 if( a.ratio )
 ratio = *a.ratio;
 
 VECTOR2I fontz = aFPText->GetTextSize();
 int textThickness = KiROUND( fontz.y * ratio / 100 );
 
 aFPText->SetTextThickness( textThickness );
 if( a.size )
 {
 fontz = kicad_fontz( *a.size, textThickness );
 aFPText->SetTextSize( fontz );
 }
 
 
 int align = ETEXT::BOTTOM_LEFT; // bottom-left is eagle default
 
 if( a.align )
 align = a.align;
 
 // The "rot" in a EATTR seems to be assumed to be zero if it is not
 // present, and this zero rotation becomes an override to the
 // package's text field. If they did not want zero, they specify
 // what they want explicitly.
 double degrees = a.rot ? a.rot->degrees : 0.0;
 double orient; // relative to parent
 
 int sign = 1;
 bool spin = false;
 
 if( a.rot )
 {
 spin = a.rot->spin;
 sign = a.rot->mirror ? -1 : 1;
 aFPText->SetMirrored( a.rot->mirror );
 }
 
 if( degrees == 90 || degrees == 0 || spin )
 {
 orient = degrees - aFootprint->GetOrientation().AsDegrees();
 aFPText->SetTextAngle( EDA_ANGLE( sign * orient, DEGREES_T ) );
 }
 else if( degrees == 180 )
 {
 orient = 0 - aFootprint->GetOrientation().AsDegrees();
 aFPText->SetTextAngle( EDA_ANGLE( sign * orient, DEGREES_T ) );
 align = -align;
 }
 else if( degrees == 270 )
 {
 orient = 90 - aFootprint->GetOrientation().AsDegrees();
 align = -align;
 aFPText->SetTextAngle( EDA_ANGLE( sign * orient, DEGREES_T ) );
 }
 else
 {
 orient = 90 - degrees - aFootprint->GetOrientation().AsDegrees();
 aFPText->SetTextAngle( EDA_ANGLE( sign * orient, DEGREES_T ) );
 }
 
 switch( align )
 {
 case ETEXT::TOP_RIGHT:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::BOTTOM_LEFT:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 
 case ETEXT::TOP_LEFT:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::BOTTOM_RIGHT:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 
 case ETEXT::TOP_CENTER:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::BOTTOM_CENTER:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 
 case ETEXT::CENTER:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::CENTER_LEFT:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::CENTER_RIGHT:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 default:
 ;
 }
 }
 else
 {
 // Part is not smash so use Lib default for NAME/VALUE
 // the text is per the original package, sans <attribute>.
 double degrees = aFPText->GetTextAngle().AsDegrees()
 + aFootprint->GetOrientation().AsDegrees();
 
 // @todo there are a few more cases than these to contend with:
 if( ( !aFPText->IsMirrored() && ( abs( degrees ) == 180 || abs( degrees ) == 270 ) )
 || ( aFPText->IsMirrored() && ( degrees == 360 ) ) )
 {
 // ETEXT::TOP_RIGHT:
 aFPText->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 aFPText->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 }
 }
}

References std::abs(), EATTR::align, EDA_ANGLE::AsDegrees(), ETEXT::BOTTOM_CENTER, ETEXT::BOTTOM_LEFT, ETEXT::BOTTOM_RIGHT, ETEXT::CENTER, ETEXT::CENTER_LEFT, ETEXT::CENTER_RIGHT, EROT::degrees, DEGREES_T, FOOTPRINT::GetOrientation(), EDA_TEXT::GetTextAngle(), EDA_TEXT::GetTextSize(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_H_ALIGN_LEFT, GR_TEXT_H_ALIGN_RIGHT, GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_V_ALIGN_CENTER, GR_TEXT_V_ALIGN_TOP, EDA_TEXT::IsMirrored(), kicad_fontz(), kicad_x(), kicad_y(), KiROUND(), EROT::mirror, EATTR::ratio, EATTR::rot, EDA_TEXT::SetHorizJustify(), EDA_TEXT::SetMirrored(), EDA_TEXT::SetText(), EDA_TEXT::SetTextAngle(), EDA_TEXT::SetTextPos(), EDA_TEXT::SetTextSize(), EDA_TEXT::SetTextThickness(), EDA_TEXT::SetVertJustify(), sign(), EATTR::size, EROT::spin, ETEXT::TOP_CENTER, ETEXT::TOP_LEFT, ETEXT::TOP_RIGHT, EATTR::value, EATTR::x, EATTR::y, and VECTOR2< T >::y.

Referenced by orientFootprintAndText().

packageCircle()

void EAGLE_PLUGIN::packageCircle ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree  ) const

private

Definition at line 2326 of file eagle_plugin.cpp.

{
 ECIRCLE e( aTree );
 
 int width = e.width.ToPcbUnits();
 int radius = e.radius.ToPcbUnits();
 
 if( e.layer == EAGLE_LAYER::TRESTRICT
 || e.layer == EAGLE_LAYER::BRESTRICT
 || e.layer == EAGLE_LAYER::VRESTRICT )
 {
 FP_ZONE* zone = new FP_ZONE( aFootprint );
 aFootprint->Add( zone, ADD_MODE::APPEND );
 
 setKeepoutSettingsToZone( zone, e.layer );
 
 // approximate circle as polygon
 VECTOR2I center( kicad_x( e.x ), kicad_y( e.y ) );
 int outlineRadius = radius + ( width / 2 );
 int segsInCircle = GetArcToSegmentCount( outlineRadius, ARC_HIGH_DEF, FULL_CIRCLE );
 EDA_ANGLE delta = ANGLE_360 / segsInCircle;
 
 for( EDA_ANGLE angle = ANGLE_0; angle < ANGLE_360; angle += delta )
 {
 VECTOR2I rotatedPoint( outlineRadius, 0 );
 RotatePoint( rotatedPoint, angle );
 zone->AppendCorner( center + rotatedPoint, -1 );
 }
 
 if( width > 0 )
 {
 zone->NewHole();
 int innerRadius = radius - ( width / 2 );
 segsInCircle = GetArcToSegmentCount( innerRadius, ARC_HIGH_DEF, FULL_CIRCLE );
 delta = ANGLE_360 / segsInCircle;
 
 for( EDA_ANGLE angle = ANGLE_0; angle < ANGLE_360; angle += delta )
 {
 VECTOR2I rotatedPoint( innerRadius, 0 );
 RotatePoint( rotatedPoint, angle );
 zone->AppendCorner( center + rotatedPoint, 0 );
 }
 }
 
 zone->SetBorderDisplayStyle( ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_EDGE,
 ZONE::GetDefaultHatchPitch(), true );
 }
 else
 {
 PCB_LAYER_ID layer = kicad_layer( e.layer );
 
 if( layer == UNDEFINED_LAYER )
 {
 wxLogMessage( wxString::Format( _( "Ignoring a circle since Eagle layer '%s' (%d) "
 "was not mapped" ),
 eagle_layer_name( e.layer ), e.layer ) );
 return;
 }
 
 FP_SHAPE* gr = new FP_SHAPE( aFootprint, SHAPE_T::CIRCLE );
 
 // width == 0 means filled circle
 if( width <= 0 )
 {
 width = radius;
 radius = radius / 2;
 gr->SetFilled( true );
 }
 
 aFootprint->Add( gr );
 gr->SetStroke( STROKE_PARAMS( width, PLOT_DASH_TYPE::SOLID ) );
 
 switch( (int) layer )
 {
 case UNDEFINED_LAYER:
 layer = Cmts_User;
 break;
 default:
 break;
 }
 
 gr->SetLayer( layer );
 gr->SetStart0( VECTOR2I( kicad_x( e.x ), kicad_y( e.y ) ) );
 gr->SetEnd0( VECTOR2I( kicad_x( e.x ) + radius, kicad_y( e.y ) ) );
 gr->SetDrawCoord();
 }
}

References _, FOOTPRINT::Add(), PNS::angle(), ANGLE_0, ANGLE_360, APPEND, ZONE::AppendCorner(), ARC_HIGH_DEF, EAGLE_LAYER::BRESTRICT, CIRCLE, Cmts_User, delta, DIAGONAL_EDGE, eagle_layer_name(), Format(), FULL_CIRCLE, GetArcToSegmentCount(), ZONE::GetDefaultHatchPitch(), kicad_layer(), kicad_x(), kicad_y(), ECIRCLE::layer, ZONE::NewHole(), ECIRCLE::radius, RotatePoint(), ZONE::SetBorderDisplayStyle(), FP_SHAPE::SetDrawCoord(), FP_SHAPE::SetEnd0(), EDA_SHAPE::SetFilled(), setKeepoutSettingsToZone(), BOARD_ITEM::SetLayer(), FP_SHAPE::SetStart0(), PCB_SHAPE::SetStroke(), SOLID, ECOORD::ToPcbUnits(), EAGLE_LAYER::TRESTRICT, UNDEFINED_LAYER, EAGLE_LAYER::VRESTRICT, ECIRCLE::width, ECIRCLE::x, and ECIRCLE::y.

Referenced by makeFootprint().

packageHole()

void EAGLE_PLUGIN::packageHole ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree, bool  aCenter  ) const

private

Parameters

aFootprint	The KiCad footprint to which to assign the hole.
aTree	The Eagle XML node that is of type "hole".
aCenter	If true, center the hole in the footprint and offset the footprint position.

Definition at line 2415 of file eagle_plugin.cpp.

{
 EHOLE e( aTree );
 
 if( e.drill.value == 0 )
 return;
 
 // we add a PAD_ATTRIB::NPTH pad to this footprint.
 PAD* pad = new PAD( aFootprint );
 aFootprint->Add( pad );
 
 pad->SetKeepTopBottom( false ); // TODO: correct? This seems to be KiCad default on import
 
 pad->SetShape( PAD_SHAPE::CIRCLE );
 pad->SetAttribute( PAD_ATTRIB::NPTH );
 
 // Mechanical purpose only:
 // no offset, no net name, no pad name allowed
 // pad->SetOffset( VECTOR2I( 0, 0 ) );
 // pad->SetNumber( wxEmptyString );
 
 VECTOR2I padpos( kicad_x( e.x ), kicad_y( e.y ) );
 
 if( aCenter )
 {
 pad->SetPos0( VECTOR2I( 0, 0 ) );
 aFootprint->SetPosition( padpos );
 pad->SetPosition( padpos );
 }
 else
 {
 pad->SetPos0( padpos );
 pad->SetPosition( padpos + aFootprint->GetPosition() );
 }
 
 wxSize sz( e.drill.ToPcbUnits(), e.drill.ToPcbUnits() );
 
 pad->SetDrillSize( sz );
 pad->SetSize( sz );
 
 pad->SetLayerSet( LSET::AllCuMask().set( B_Mask ).set( F_Mask ) );
}

References FOOTPRINT::Add(), LSET::AllCuMask(), B_Mask, CIRCLE, EHOLE::drill, F_Mask, FOOTPRINT::GetPosition(), kicad_x(), kicad_y(), NPTH, pad, PAD, FOOTPRINT::SetPosition(), ECOORD::ToPcbUnits(), ECOORD::value, EHOLE::x, and EHOLE::y.

Referenced by loadPlain(), and makeFootprint().

packagePad()

void EAGLE_PLUGIN::packagePad ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree  )

private

Definition at line 1927 of file eagle_plugin.cpp.

{
 // this is thru hole technology here, no SMDs
 EPAD e( aTree );
 int shape = EPAD::UNDEF;
 int eagleDrillz = e.drill.ToPcbUnits();
 
 std::unique_ptr<PAD> pad = std::make_unique<PAD>( aFootprint );
 transferPad( e, pad.get() );
 
 if( e.first && *e.first && m_rules->psFirst != EPAD::UNDEF )
 shape = m_rules->psFirst;
 else if( aFootprint->GetLayer() == F_Cu && m_rules->psTop != EPAD::UNDEF )
 shape = m_rules->psTop;
 else if( aFootprint->GetLayer() == B_Cu && m_rules->psBottom != EPAD::UNDEF )
 shape = m_rules->psBottom;
 
 pad->SetDrillSize( wxSize( eagleDrillz, eagleDrillz ) );
 pad->SetLayerSet( LSET::AllCuMask() );
 
 if( eagleDrillz < m_min_hole )
 m_min_hole = eagleDrillz;
 
 // Solder mask
 if( !e.stop || *e.stop == true ) // enabled by default
 pad->SetLayerSet( pad->GetLayerSet().set( B_Mask ).set( F_Mask ) );
 
 if( shape == EPAD::ROUND || shape == EPAD::SQUARE || shape == EPAD::OCTAGON )
 e.shape = shape;
 
 if( e.shape )
 {
 switch( *e.shape )
 {
 case EPAD::ROUND:
 pad->SetShape( PAD_SHAPE::CIRCLE );
 break;
 
 case EPAD::OCTAGON:
 pad->SetShape( PAD_SHAPE::CHAMFERED_RECT );
 pad->SetChamferPositions( RECT_CHAMFER_ALL );
 pad->SetChamferRectRatio( 1 - M_SQRT1_2 ); // Regular polygon
 break;
 
 case EPAD::LONG:
 pad->SetShape( PAD_SHAPE::OVAL );
 break;
 
 case EPAD::SQUARE:
 pad->SetShape( PAD_SHAPE::RECT );
 break;
 
 case EPAD::OFFSET:
 pad->SetShape( PAD_SHAPE::OVAL );
 break;
 }
 }
 else
 {
 // if shape is not present, our default is circle and that matches their default "round"
 }
 
 if( e.diameter && e.diameter->value > 0 )
 {
 int diameter = e.diameter->ToPcbUnits();
 pad->SetSize( wxSize( diameter, diameter ) );
 }
 else
 {
 double drillz = pad->GetDrillSize().x;
 double annulus = drillz * m_rules->rvPadTop; // copper annulus, eagle "restring"
 annulus = eagleClamp( m_rules->rlMinPadTop, annulus, m_rules->rlMaxPadTop );
 int diameter = KiROUND( drillz + 2 * annulus );
 pad->SetSize( wxSize( KiROUND( diameter ), KiROUND( diameter ) ) );
 }
 
 if( pad->GetShape() == PAD_SHAPE::OVAL )
 {
 // The Eagle "long" pad is wider than it is tall; m_elongation is percent elongation
 VECTOR2I sz = pad->GetSize();
 sz.x = ( sz.x * ( 100 + m_rules->psElongationLong ) ) / 100;
 pad->SetSize( sz );
 
 if( e.shape && *e.shape == EPAD::OFFSET )
 {
 int offset = KiROUND( ( sz.x - sz.y ) / 2.0 );
 pad->SetOffset( VECTOR2I( offset, 0 ) );
 }
 }
 
 if( e.rot )
 pad->SetOrientation( EDA_ANGLE( e.rot->degrees, DEGREES_T ) );
 
 if( pad->GetSizeX() > 0 && pad->GetSizeY() > 0 )
 {
 aFootprint->Add( pad.release() );
 }
 else
 {
 wxLogError( _( "Invalid zero-sized pad ignored in\nfile: %s" ), m_board->GetFileName() );
 }
}

References _, FOOTPRINT::Add(), LSET::AllCuMask(), B_Cu, B_Mask, CHAMFERED_RECT, CIRCLE, EROT::degrees, DEGREES_T, EPAD::diameter, EPAD::drill, eagleClamp(), F_Cu, F_Mask, EPAD::first, BOARD::GetFileName(), BOARD_ITEM::GetLayer(), KiROUND(), EPAD::LONG, m_board, m_min_hole, m_rules, EPAD::OCTAGON, EPAD::OFFSET, OVAL, pad, ERULES::psBottom, ERULES::psElongationLong, ERULES::psFirst, ERULES::psTop, RECT, RECT_CHAMFER_ALL, ERULES::rlMaxPadTop, ERULES::rlMinPadTop, EPAD_COMMON::rot, EPAD::ROUND, ERULES::rvPadTop, EPAD::shape, EPAD::SQUARE, EPAD_COMMON::stop, ECOORD::ToPcbUnits(), transferPad(), EPAD::UNDEF, ECOORD::value, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by makeFootprint().

packagePolygon()

void EAGLE_PLUGIN::packagePolygon ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree  ) const

private

Definition at line 2223 of file eagle_plugin.cpp.

{
 EPOLYGON p( aTree );
 
 std::vector<VECTOR2I> pts;
 
 // Get the first vertex and iterate
 wxXmlNode* vertex = aTree->GetChildren();
 std::vector<EVERTEX> vertices;
 
 // Create a circular vector of vertices
 // The "curve" parameter indicates a curve from the current
 // to the next vertex, so we keep the first at the end as well
 // to allow the curve to link back
 while( vertex )
 {
 if( vertex->GetName() == wxT( "vertex" ) )
 vertices.emplace_back( vertex );
 
 vertex = vertex->GetNext();
 }
 
 vertices.push_back( vertices[0] );
 
 for( size_t i = 0; i < vertices.size() - 1; i++ )
 {
 EVERTEX v1 = vertices[i];
 
 // Append the corner
 pts.emplace_back( kicad_x( v1.x ), kicad_y( v1.y ) );
 
 if( v1.curve )
 {
 EVERTEX v2 = vertices[i + 1];
 VECTOR2I center =
 ConvertArcCenter( VECTOR2I( kicad_x( v1.x ), kicad_y( v1.y ) ),
 VECTOR2I( kicad_x( v2.x ), kicad_y( v2.y ) ), *v1.curve );
 double angle = DEG2RAD( *v1.curve );
 double end_angle = atan2( kicad_y( v2.y ) - center.y, kicad_x( v2.x ) - center.x );
 double radius = sqrt( pow( center.x - kicad_x( v1.x ), 2 )
 + pow( center.y - kicad_y( v1.y ), 2 ) );
 
 // Don't allow a zero-radius curve
 if( KiROUND( radius ) == 0 )
 radius = 1.0;
 
 int segCount = GetArcToSegmentCount( KiROUND( radius ), ARC_HIGH_DEF,
 EDA_ANGLE( *v1.curve, DEGREES_T ) );
 double delta = angle / segCount;
 
 for( double a = end_angle + angle; fabs( a - end_angle ) > fabs( delta ); a -= delta )
 {
 pts.push_back(
 VECTOR2I( KiROUND( radius * cos( a ) ), KiROUND( radius * sin( a ) ) )
 + center );
 }
 }
 }
 
 if( p.layer == EAGLE_LAYER::TRESTRICT
 || p.layer == EAGLE_LAYER::BRESTRICT
 || p.layer == EAGLE_LAYER::VRESTRICT )
 {
 FP_ZONE* zone = new FP_ZONE( aFootprint );
 aFootprint->Add( zone, ADD_MODE::APPEND );
 
 setKeepoutSettingsToZone( zone, p.layer );
 
 SHAPE_LINE_CHAIN outline( pts );
 outline.SetClosed( true );
 zone->Outline()->AddOutline( outline );
 
 zone->SetBorderDisplayStyle( ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_EDGE,
 ZONE::GetDefaultHatchPitch(), true );
 }
 else
 {
 PCB_LAYER_ID layer = kicad_layer( p.layer );
 
 if( layer == UNDEFINED_LAYER )
 {
 wxLogMessage( wxString::Format( _( "Ignoring a polygon since Eagle layer '%s' (%d) "
 "was not mapped" ),
 eagle_layer_name( p.layer ), p.layer ) );
 return;
 }
 
 FP_SHAPE* dwg = new FP_SHAPE( aFootprint, SHAPE_T::POLY );
 
 aFootprint->Add( dwg );
 
 dwg->SetStroke( STROKE_PARAMS( 0 ) );
 dwg->SetFilled( true );
 dwg->SetLayer( layer );
 
 dwg->SetPolyPoints( pts );
 dwg->SetDrawCoord();
 dwg->GetPolyShape().Inflate( p.width.ToPcbUnits() / 2, 32,
 SHAPE_POLY_SET::ALLOW_ACUTE_CORNERS );
 }
}

References _, FOOTPRINT::Add(), SHAPE_POLY_SET::AddOutline(), SHAPE_POLY_SET::ALLOW_ACUTE_CORNERS, PNS::angle(), APPEND, ARC_HIGH_DEF, EAGLE_LAYER::BRESTRICT, ConvertArcCenter(), EVERTEX::curve, DEG2RAD(), DEGREES_T, delta, DIAGONAL_EDGE, eagle_layer_name(), Format(), GetArcToSegmentCount(), ZONE::GetDefaultHatchPitch(), EDA_SHAPE::GetPolyShape(), SHAPE_POLY_SET::Inflate(), kicad_layer(), kicad_x(), kicad_y(), KiROUND(), EPOLYGON::layer, ZONE::Outline(), POLY, ZONE::SetBorderDisplayStyle(), SHAPE_LINE_CHAIN::SetClosed(), FP_SHAPE::SetDrawCoord(), EDA_SHAPE::SetFilled(), setKeepoutSettingsToZone(), BOARD_ITEM::SetLayer(), EDA_SHAPE::SetPolyPoints(), PCB_SHAPE::SetStroke(), ECOORD::ToPcbUnits(), EAGLE_LAYER::TRESTRICT, UNDEFINED_LAYER, v2, EAGLE_LAYER::VRESTRICT, EPOLYGON::width, EVERTEX::x, VECTOR2< T >::x, EVERTEX::y, and VECTOR2< T >::y.

Referenced by makeFootprint().

packageRectangle()

void EAGLE_PLUGIN::packageRectangle ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree  ) const

private

Definition at line 2157 of file eagle_plugin.cpp.

{
 ERECT r( aTree );
 
 if( r.layer == EAGLE_LAYER::TRESTRICT || r.layer == EAGLE_LAYER::BRESTRICT
 || r.layer == EAGLE_LAYER::VRESTRICT )
 {
 FP_ZONE* zone = new FP_ZONE( aFootprint );
 aFootprint->Add( zone, ADD_MODE::APPEND );
 
 setKeepoutSettingsToZone( zone, r.layer );
 
 const int outlineIdx = -1; // this is the id of the copper zone main outline
 zone->AppendCorner( VECTOR2I( kicad_x( r.x1 ), kicad_y( r.y1 ) ), outlineIdx );
 zone->AppendCorner( VECTOR2I( kicad_x( r.x2 ), kicad_y( r.y1 ) ), outlineIdx );
 zone->AppendCorner( VECTOR2I( kicad_x( r.x2 ), kicad_y( r.y2 ) ), outlineIdx );
 zone->AppendCorner( VECTOR2I( kicad_x( r.x1 ), kicad_y( r.y2 ) ), outlineIdx );
 
 if( r.rot )
 {
 VECTOR2I center( ( kicad_x( r.x1 ) + kicad_x( r.x2 ) ) / 2,
  ( kicad_y( r.y1 ) + kicad_y( r.y2 ) ) / 2 );
 zone->Rotate( center, EDA_ANGLE( r.rot->degrees, DEGREES_T ) );
 }
 
 zone->SetBorderDisplayStyle( ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_EDGE,
 ZONE::GetDefaultHatchPitch(), true );
 }
 else
 {
 PCB_LAYER_ID layer = kicad_layer( r.layer );
 
 if( layer == UNDEFINED_LAYER )
 {
 wxLogMessage( wxString::Format( _( "Ignoring a rectangle since Eagle layer '%s' (%d) "
 "was not mapped" ),
 eagle_layer_name( r.layer ), r.layer ) );
 return;
 }
 
 FP_SHAPE* dwg = new FP_SHAPE( aFootprint, SHAPE_T::POLY );
 
 aFootprint->Add( dwg );
 
 dwg->SetLayer( layer );
 dwg->SetStroke( STROKE_PARAMS( 0 ) );
 dwg->SetFilled( true );
 
 std::vector<VECTOR2I> pts;
 
 VECTOR2I start( VECTOR2I( kicad_x( r.x1 ), kicad_y( r.y1 ) ) );
 VECTOR2I end( VECTOR2I( kicad_x( r.x1 ), kicad_y( r.y2 ) ) );
 
 pts.push_back( start );
 pts.emplace_back( kicad_x( r.x2 ), kicad_y( r.y1 ) );
 pts.emplace_back( kicad_x( r.x2 ), kicad_y( r.y2 ) );
 pts.push_back( end );
 
 dwg->SetPolyPoints( pts );
 
 if( r.rot )
 dwg->Rotate( dwg->GetCenter(), EDA_ANGLE( r.rot->degrees, DEGREES_T ) );
 }
}

References _, FOOTPRINT::Add(), APPEND, ZONE::AppendCorner(), EAGLE_LAYER::BRESTRICT, DEGREES_T, DIAGONAL_EDGE, eagle_layer_name(), Format(), PCB_SHAPE::GetCenter(), ZONE::GetDefaultHatchPitch(), kicad_layer(), kicad_x(), kicad_y(), POLY, r, ZONE::Rotate(), FP_SHAPE::Rotate(), ZONE::SetBorderDisplayStyle(), EDA_SHAPE::SetFilled(), setKeepoutSettingsToZone(), BOARD_ITEM::SetLayer(), EDA_SHAPE::SetPolyPoints(), PCB_SHAPE::SetStroke(), EAGLE_LAYER::TRESTRICT, UNDEFINED_LAYER, and EAGLE_LAYER::VRESTRICT.

Referenced by makeFootprint().

packageSMD()

void EAGLE_PLUGIN::packageSMD ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree  ) const

private

Handles common pad properties.

Definition at line 2459 of file eagle_plugin.cpp.

{
 ESMD e( aTree );
 PCB_LAYER_ID layer = kicad_layer( e.layer );
 
 if( !IsCopperLayer( layer ) || e.dx.value == 0 || e.dy.value == 0 )
 return;
 
 PAD* pad = new PAD( aFootprint );
 aFootprint->Add( pad );
 transferPad( e, pad );
 
 pad->SetKeepTopBottom( false ); // TODO: correct? This seems to be KiCad default on import
 
 pad->SetShape( PAD_SHAPE::RECT );
 pad->SetAttribute( PAD_ATTRIB::SMD );
 
 wxSize padSize( e.dx.ToPcbUnits(), e.dy.ToPcbUnits() );
 pad->SetSize( padSize );
 pad->SetLayer( layer );
 
 const LSET front( 3, F_Cu, F_Paste, F_Mask );
 const LSET back( 3, B_Cu, B_Paste, B_Mask );
 
 if( layer == F_Cu )
 pad->SetLayerSet( front );
 else if( layer == B_Cu )
 pad->SetLayerSet( back );
 
 int minPadSize = std::min( padSize.x, padSize.y );
 
 // Rounded rectangle pads
 int roundRadius =
 eagleClamp( m_rules->srMinRoundness * 2, (int) ( minPadSize * m_rules->srRoundness ),
 m_rules->srMaxRoundness * 2 );
 
 if( e.roundness || roundRadius > 0 )
 {
 double roundRatio = (double) roundRadius / minPadSize / 2.0;
 
 // Eagle uses a different definition of roundness, hence division by 200
 if( e.roundness )
 roundRatio = std::fmax( *e.roundness / 200.0, roundRatio );
 
 pad->SetShape( PAD_SHAPE::ROUNDRECT );
 pad->SetRoundRectRadiusRatio( roundRatio );
 }
 
 if( e.rot )
 pad->SetOrientation( EDA_ANGLE( e.rot->degrees, DEGREES_T ) );
 
 pad->SetLocalSolderPasteMargin( -eagleClamp( m_rules->mlMinCreamFrame,
 (int) ( m_rules->mvCreamFrame * minPadSize ),
 m_rules->mlMaxCreamFrame ) );
 
 // Solder mask
 if( e.stop && *e.stop == false ) // enabled by default
 {
 if( layer == F_Cu )
 pad->SetLayerSet( pad->GetLayerSet().set( F_Mask, false ) );
 else if( layer == B_Cu )
 pad->SetLayerSet( pad->GetLayerSet().set( B_Mask, false ) );
 }
 
 // Solder paste (only for SMD pads)
 if( e.cream && *e.cream == false ) // enabled by default
 {
 if( layer == F_Cu )
 pad->SetLayerSet( pad->GetLayerSet().set( F_Paste, false ) );
 else if( layer == B_Cu )
 pad->SetLayerSet( pad->GetLayerSet().set( B_Paste, false ) );
 }
}

References FOOTPRINT::Add(), B_Cu, B_Mask, B_Paste, ESMD::cream, EROT::degrees, DEGREES_T, ESMD::dx, ESMD::dy, eagleClamp(), F_Cu, F_Mask, F_Paste, IsCopperLayer(), kicad_layer(), ESMD::layer, m_rules, ERULES::mlMaxCreamFrame, ERULES::mlMinCreamFrame, ERULES::mvCreamFrame, pad, PAD, RECT, EPAD_COMMON::rot, ESMD::roundness, ROUNDRECT, SMD, ERULES::srMaxRoundness, ERULES::srMinRoundness, ERULES::srRoundness, EPAD_COMMON::stop, ECOORD::ToPcbUnits(), transferPad(), and ECOORD::value.

Referenced by makeFootprint().

packageText()

void EAGLE_PLUGIN::packageText ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree  ) const

private

Definition at line 2031 of file eagle_plugin.cpp.

{
 ETEXT t( aTree );
 PCB_LAYER_ID layer = kicad_layer( t.layer );
 
 if( layer == UNDEFINED_LAYER )
 {
 wxLogMessage( wxString::Format( _( "Ignoring a text since Eagle layer '%s' (%d) "
 "was not mapped" ),
 eagle_layer_name( t.layer ), t.layer ) );
 return;
 }
 
 FP_TEXT* textItem;
 
 if( t.text.Upper() == wxT( ">NAME" ) && aFootprint->GetReference().IsEmpty() )
 {
 textItem = &aFootprint->Reference();
 
 textItem->SetText( wxT( "REF**" ) );
 }
 else if( t.text.Upper() == wxT( ">VALUE" ) && aFootprint->GetValue().IsEmpty() )
 {
 textItem = &aFootprint->Value();
 
 textItem->SetText( aFootprint->GetFPID().GetLibItemName() );
 }
 else
 {
 // FIXME: graphical text items are rotated for some reason.
 textItem = new FP_TEXT( aFootprint );
 aFootprint->Add( textItem );
 
 textItem->SetText( interpret_text( t.text ) );
 }
 
 VECTOR2I pos( kicad_x( t.x ), kicad_y( t.y ) );
 
 textItem->SetTextPos( pos );
 textItem->SetPos0( pos - aFootprint->GetPosition() );
 
 textItem->SetLayer( layer );
 
 double ratio = t.ratio ? *t.ratio : 8; // DTD says 8 is default
 int textThickness = KiROUND( t.size.ToPcbUnits() * ratio / 100 );
 
 textItem->SetTextThickness( textThickness );
 textItem->SetTextSize( kicad_fontz( t.size, textThickness ) );
 
 int align = t.align ? *t.align : ETEXT::BOTTOM_LEFT; // bottom-left is eagle default
 
 // An eagle package is never rotated, the DTD does not allow it.
 // angle -= aFootprint->GetOrienation();
 
 if( t.rot )
 {
 int sign = t.rot->mirror ? -1 : 1;
 textItem->SetMirrored( t.rot->mirror );
 
 double degrees = t.rot->degrees;
 
 if( degrees == 90 || t.rot->spin )
 {
 textItem->SetTextAngle( EDA_ANGLE( sign * degrees, DEGREES_T ) );
 }
 else if( degrees == 180 )
 {
 align = ETEXT::TOP_RIGHT;
 }
 else if( degrees == 270 )
 {
 align = ETEXT::TOP_RIGHT;
 textItem->SetTextAngle( EDA_ANGLE( sign * 90, DEGREES_T ) );
 }
 }
 
 switch( align )
 {
 case ETEXT::CENTER:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::CENTER_LEFT:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::CENTER_RIGHT:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
 break;
 
 case ETEXT::TOP_CENTER:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::TOP_LEFT:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::TOP_RIGHT:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_TOP );
 break;
 
 case ETEXT::BOTTOM_CENTER:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 
 case ETEXT::BOTTOM_LEFT:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 
 case ETEXT::BOTTOM_RIGHT:
 textItem->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );
 textItem->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );
 break;
 }
}

References _, FOOTPRINT::Add(), ETEXT::align, ETEXT::BOTTOM_CENTER, ETEXT::BOTTOM_LEFT, ETEXT::BOTTOM_RIGHT, ETEXT::CENTER, ETEXT::CENTER_LEFT, ETEXT::CENTER_RIGHT, EROT::degrees, DEGREES_T, eagle_layer_name(), Format(), FOOTPRINT::GetFPID(), LIB_ID::GetLibItemName(), FOOTPRINT::GetPosition(), FOOTPRINT::GetReference(), FOOTPRINT::GetValue(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_H_ALIGN_LEFT, GR_TEXT_H_ALIGN_RIGHT, GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_V_ALIGN_CENTER, GR_TEXT_V_ALIGN_TOP, interpret_text(), kicad_fontz(), kicad_layer(), kicad_x(), kicad_y(), KiROUND(), ETEXT::layer, EROT::mirror, ETEXT::ratio, FOOTPRINT::Reference(), ETEXT::rot, EDA_TEXT::SetHorizJustify(), BOARD_ITEM::SetLayer(), EDA_TEXT::SetMirrored(), FP_TEXT::SetPos0(), EDA_TEXT::SetText(), EDA_TEXT::SetTextAngle(), EDA_TEXT::SetTextPos(), EDA_TEXT::SetTextSize(), EDA_TEXT::SetTextThickness(), EDA_TEXT::SetVertJustify(), sign(), ETEXT::size, EROT::spin, ETEXT::text, ETEXT::TOP_CENTER, ETEXT::TOP_LEFT, ETEXT::TOP_RIGHT, ECOORD::ToPcbUnits(), UNDEFINED_LAYER, FOOTPRINT::Value(), ETEXT::x, and ETEXT::y.

Referenced by makeFootprint().

packageWire()

void EAGLE_PLUGIN::packageWire ( FOOTPRINT *  aFootprint, wxXmlNode *  aTree  ) const

private

Definition at line 1855 of file eagle_plugin.cpp.

{
 EWIRE w( aTree );
 PCB_LAYER_ID layer = kicad_layer( w.layer );
 VECTOR2I start( kicad_x( w.x1 ), kicad_y( w.y1 ) );
 VECTOR2I end( kicad_x( w.x2 ), kicad_y( w.y2 ) );
 int width = w.width.ToPcbUnits();
 
 if( layer == UNDEFINED_LAYER )
 {
 wxLogMessage( wxString::Format( _( "Ignoring a wire since Eagle layer '%s' (%d) "
 "was not mapped" ),
 eagle_layer_name( w.layer ), w.layer ) );
 return;
 }
 
 // KiCad cannot handle zero or negative line widths which apparently have meaning in Eagle.
 if( width <= 0 )
 {
 BOARD* board = aFootprint->GetBoard();
 
 if( board )
 {
 width = board->GetDesignSettings().GetLineThickness( layer );
 }
 else
 {
 // When loading footprint libraries, there is no board so use the default KiCad
 // line widths.
 switch( layer )
 {
 case Edge_Cuts: width = pcbIUScale.mmToIU( DEFAULT_EDGE_WIDTH ); break;
 
 case F_SilkS:
 case B_SilkS: width = pcbIUScale.mmToIU( DEFAULT_SILK_LINE_WIDTH ); break;
 
 case F_CrtYd:
 case B_CrtYd: width = pcbIUScale.mmToIU( DEFAULT_COURTYARD_WIDTH ); break;
 
 default: width = pcbIUScale.mmToIU( DEFAULT_LINE_WIDTH ); break;
 }
 }
 }
 
 // FIXME: the cap attribute is ignored because KiCad can't create lines with flat ends.
 FP_SHAPE* dwg;
 
 if( !w.curve )
 {
 dwg = new FP_SHAPE( aFootprint, SHAPE_T::SEGMENT );
 
 dwg->SetStart0( start );
 dwg->SetEnd0( end );
 }
 else
 {
 dwg = new FP_SHAPE( aFootprint, SHAPE_T::ARC );
 VECTOR2I center = ConvertArcCenter( start, end, *w.curve );
 
 dwg->SetCenter0( center );
 dwg->SetStart0( start );
 dwg->SetArcAngleAndEnd0( -EDA_ANGLE( *w.curve, DEGREES_T ), true ); // KiCad rotates the other way
 }
 
 dwg->SetLayer( layer );
 dwg->SetStroke( STROKE_PARAMS( width, PLOT_DASH_TYPE::SOLID ) );
 dwg->SetDrawCoord();
 
 aFootprint->Add( dwg );
}

References _, FOOTPRINT::Add(), ARC, B_CrtYd, B_SilkS, ConvertArcCenter(), EWIRE::curve, DEFAULT_COURTYARD_WIDTH, DEFAULT_EDGE_WIDTH, DEFAULT_LINE_WIDTH, DEFAULT_SILK_LINE_WIDTH, DEGREES_T, eagle_layer_name(), Edge_Cuts, F_CrtYd, F_SilkS, Format(), BOARD_ITEM::GetBoard(), BOARD::GetDesignSettings(), BOARD_DESIGN_SETTINGS::GetLineThickness(), kicad_layer(), kicad_x(), kicad_y(), EWIRE::layer, EDA_IU_SCALE::mmToIU(), pcbIUScale, SEGMENT, FP_SHAPE::SetArcAngleAndEnd0(), FP_SHAPE::SetCenter0(), FP_SHAPE::SetDrawCoord(), FP_SHAPE::SetEnd0(), BOARD_ITEM::SetLayer(), FP_SHAPE::SetStart0(), PCB_SHAPE::SetStroke(), SOLID, ECOORD::ToPcbUnits(), UNDEFINED_LAYER, EWIRE::width, EWIRE::x1, EWIRE::x2, EWIRE::y1, and EWIRE::y2.

Referenced by makeFootprint().

PluginName()

const wxString EAGLE_PLUGIN::PluginName ( ) const

overridevirtual

Return a brief hard coded name for this PLUGIN.

Implements PLUGIN.

Definition at line 320 of file eagle_plugin.cpp.

{
 return wxT( "Eagle" );
}

PrefetchLib()

void PLUGIN::PrefetchLib ( const wxString &  aLibraryPath, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

If possible, prefetches the specified library (e.g.

performing downloads). Does not parse. Threadsafe.

This is a no-op for libraries that cannot be prefetched. Plugins that cannot prefetch need not override this; a default no-op is provided.

Parameters

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.

Exceptions

IO_ERROR

if there is an error prefetching the library.

Definition at line 75 of file plugin.cpp.

{
}

Referenced by FP_LIB_TABLE::PrefetchLib().

RegisterLayerMappingCallback()

virtual void LAYER_REMAPPABLE_PLUGIN::RegisterLayerMappingCallback ( LAYER_MAPPING_HANDLER  aLayerMappingHandler )

inlinevirtualinherited

Register a different handler to be called when mapping of input layers to KiCad layers occurs.

The function is marked as virtual, so the plugins can implement extra logic (e.g., enable warnings or checks)

Parameters

aLayerMappingHandler

Reimplemented in CADSTAR_PCB_ARCHIVE_PLUGIN.

Definition at line 73 of file plugin_common_layer_mapping.h.

 {
 m_layer_mapping_handler = aLayerMappingHandler;
 }

References LAYER_REMAPPABLE_PLUGIN::m_layer_mapping_handler.

Referenced by CADSTAR_PCB_ARCHIVE_PLUGIN::CADSTAR_PCB_ARCHIVE_PLUGIN(), EAGLE_PLUGIN(), PCB_EDIT_FRAME::OpenProjectFiles(), and CADSTAR_PCB_ARCHIVE_PLUGIN::RegisterLayerMappingCallback().

Save()

void PLUGIN::Save ( const wxString &  aFileName, BOARD *  aBoard, const PROPERTIES *  aProperties = nullptr  )

virtualinherited

Write aBoard to a storage file in a format that this PLUGIN implementation knows about or it can be used to write a portion of aBoard to a special kind of export file.

Parameters

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.

Exceptions

IO_ERROR

if there is a problem saving or exporting.

Reimplemented in CLIPBOARD_IO, and PCB_PLUGIN.

Definition at line 60 of file plugin.cpp.

{
 // not pure virtual so that plugins only have to implement subset of the PLUGIN interface.
 not_implemented( this, __FUNCTION__ );
}

References not_implemented().

Referenced by IO_MGR::Save(), PCB_EDIT_FRAME::SavePcbCopy(), and PCB_EDIT_FRAME::SavePcbFile().

SetQueryUserCallback()

virtual void PLUGIN::SetQueryUserCallback ( std::function< bool(wxString aTitle, int aIcon, wxString aMessage, wxString aAction)>  aCallback )

inlinevirtualinherited

Registers a KIDIALOG callback for collecting info from the user.

Definition at line 285 of file io_mgr.h.

 { }

Referenced by PCB_CONTROL::AppendBoard(), and PCB_EDIT_FRAME::OpenProjectFiles().

transferPad()

void EAGLE_PLUGIN::transferPad ( const EPAD_COMMON &  aEaglePad, PAD *  aPad  ) const

private

Deletes the footprint templates list.

Definition at line 2534 of file eagle_plugin.cpp.

{
 aPad->SetNumber( aEaglePad.name );
 
 // pad's "Position" is not relative to the footprint's,
 // whereas Pos0 is relative to the footprint's but is the unrotated coordinate.
 VECTOR2I padPos( kicad_x( aEaglePad.x ), kicad_y( aEaglePad.y ) );
 aPad->SetPos0( padPos );
 
 // Solder mask
 const VECTOR2I& padSize( aPad->GetSize() );
 
 aPad->SetLocalSolderMaskMargin(
 eagleClamp( m_rules->mlMinStopFrame,
 (int) ( m_rules->mvStopFrame * std::min( padSize.x, padSize.y ) ),
 m_rules->mlMaxStopFrame ) );
 
 // Solid connection to copper zones
 if( aEaglePad.thermals && !*aEaglePad.thermals )
 aPad->SetZoneConnection( ZONE_CONNECTION::FULL );
 
 FOOTPRINT* footprint = aPad->GetParent();
 wxCHECK( footprint, /* void */ );
 RotatePoint( padPos, footprint->GetOrientation() );
 aPad->SetPosition( padPos + footprint->GetPosition() );
}

References eagleClamp(), FULL, FOOTPRINT::GetOrientation(), PAD::GetParent(), FOOTPRINT::GetPosition(), PAD::GetSize(), kicad_x(), kicad_y(), m_rules, ERULES::mlMaxStopFrame, ERULES::mlMinStopFrame, ERULES::mvStopFrame, EPAD_COMMON::name, RotatePoint(), PAD::SetLocalSolderMaskMargin(), PAD::SetNumber(), PAD::SetPos0(), PAD::SetPosition(), PAD::SetZoneConnection(), EPAD_COMMON::thermals, EPAD_COMMON::x, VECTOR2< T >::x, EPAD_COMMON::y, and VECTOR2< T >::y.

Referenced by packagePad(), and packageSMD().

Member Data Documentation

m_board

BOARD* EAGLE_PLUGIN::m_board

private

which BOARD is being worked on, no ownership here

Definition at line 336 of file eagle_plugin.h.

Referenced by centerBoard(), init(), Load(), loadClasses(), loadElements(), loadLayerDefs(), loadPlain(), loadPolygon(), loadSignals(), makeFootprint(), and packagePad().

m_classMap

std::map<wxString, std::shared_ptr<NETCLASS> > EAGLE_PLUGIN::m_classMap

private

Definition at line 318 of file eagle_plugin.h.

Referenced by loadClasses(), and loadSignals().

m_cu_map

int EAGLE_PLUGIN::m_cu_map[17]

private

map eagle to KiCad, cu layers only.

Definition at line 312 of file eagle_plugin.h.

Referenced by clear_cu_map(), defaultKicadLayer(), and loadLayerDefs().

m_customRules

wxString EAGLE_PLUGIN::m_customRules

private

Definition at line 320 of file eagle_plugin.h.

Referenced by Load(), and loadClasses().

m_doneCount

unsigned EAGLE_PLUGIN::m_doneCount

private

Definition at line 339 of file eagle_plugin.h.

Referenced by checkpoint(), and loadAllSections().

m_eagleLayers

std::map<int, ELAYER> EAGLE_PLUGIN::m_eagleLayers

private

Eagle layer data stored by layer number.

Definition at line 313 of file eagle_plugin.h.

Referenced by eagle_layer_name(), loadLayerDefs(), and mapEagleLayersToKicad().

m_eagleLayersIds

std::map<wxString, int> EAGLE_PLUGIN::m_eagleLayersIds

private

Eagle layer ids stored by layer name.

Definition at line 314 of file eagle_plugin.h.

Referenced by eagle_layer_id(), and loadLayerDefs().

m_hole_count

int EAGLE_PLUGIN::m_hole_count

private

generates unique footprint names from eagle "hole"s.

Definition at line 326 of file eagle_plugin.h.

Referenced by init(), and loadPlain().

m_lastProgressCount

unsigned EAGLE_PLUGIN::m_lastProgressCount

private

Definition at line 340 of file eagle_plugin.h.

Referenced by checkpoint().

m_layer_map

std::map<wxString, PCB_LAYER_ID> EAGLE_PLUGIN::m_layer_map

private

Map of Eagle layers to KiCad layers.

Eagle class number to KiCad netclass

Definition at line 315 of file eagle_plugin.h.

Referenced by kicad_layer(), and mapEagleLayersToKicad().

m_layer_mapping_handler

LAYER_MAPPING_HANDLER LAYER_REMAPPABLE_PLUGIN::m_layer_mapping_handler

protectedinherited

Callback to get layer mapping.

Definition at line 80 of file plugin_common_layer_mapping.h.

Referenced by CADSTAR_PCB_ARCHIVE_PLUGIN::Load(), mapEagleLayersToKicad(), and LAYER_REMAPPABLE_PLUGIN::RegisterLayerMappingCallback().

m_lib_path

wxString EAGLE_PLUGIN::m_lib_path

private

Definition at line 348 of file eagle_plugin.h.

Referenced by cacheLib(), and loadLibrary().

m_min_annulus

int EAGLE_PLUGIN::m_min_annulus

private

smallest via annulus we find on Load(), in BIU.

Definition at line 346 of file eagle_plugin.h.

Referenced by init(), Load(), and loadSignals().

m_min_hole

int EAGLE_PLUGIN::m_min_hole

private

smallest diameter hole we find on Load(), in BIU.

Definition at line 344 of file eagle_plugin.h.

Referenced by init(), Load(), loadSignals(), and packagePad().

m_min_trace

int EAGLE_PLUGIN::m_min_trace

private

smallest trace we find on Load(), in BIU.

Definition at line 343 of file eagle_plugin.h.

Referenced by init(), Load(), and loadSignals().

m_min_via

int EAGLE_PLUGIN::m_min_via

private

smallest via we find on Load(), in BIU.

Definition at line 345 of file eagle_plugin.h.

Referenced by init(), Load(), and loadSignals().

m_mod_time

wxDateTime EAGLE_PLUGIN::m_mod_time

private

Definition at line 349 of file eagle_plugin.h.

Referenced by cacheLib().

m_pads_to_nets

NET_MAP EAGLE_PLUGIN::m_pads_to_nets

private

net list

Definition at line 328 of file eagle_plugin.h.

Referenced by init(), loadElements(), and loadSignals().

m_progressReporter

PROGRESS_REPORTER* EAGLE_PLUGIN::m_progressReporter

private

optional; may be nullptr

Definition at line 338 of file eagle_plugin.h.

Referenced by checkpoint(), Load(), loadAllSections(), and mapEagleLayersToKicad().

m_props

const PROPERTIES* EAGLE_PLUGIN::m_props

private

passed via Save() or Load(), no ownership, may be NULL.

Definition at line 335 of file eagle_plugin.h.

Referenced by centerBoard(), and init().

m_rules

ERULES* EAGLE_PLUGIN::m_rules

private

Eagle design rules.

Definition at line 322 of file eagle_plugin.h.

Referenced by init(), Load(), loadDesignRules(), loadSignals(), packagePad(), packageSMD(), transferPad(), and ~EAGLE_PLUGIN().

m_templates

FOOTPRINT_MAP EAGLE_PLUGIN::m_templates

private

is part of a FOOTPRINT factory that operates using copy construction.

lookup key is either libname.packagename or simply packagename if FootprintLoad() or FootprintEnumberate()

Definition at line 330 of file eagle_plugin.h.

Referenced by deleteTemplates(), FootprintEnumerate(), FootprintLoad(), GetImportedCachedLibraryFootprints(), loadElements(), and loadLibrary().

m_totalCount

unsigned EAGLE_PLUGIN::m_totalCount

private

for progress reporting

Definition at line 341 of file eagle_plugin.h.

Referenced by checkpoint(), and loadAllSections().

m_xpath

XPATH* EAGLE_PLUGIN::m_xpath

private

keeps track of what we are working on within XML document during a Load().

Definition at line 323 of file eagle_plugin.h.

Referenced by cacheLib(), init(), Load(), loadAllSections(), loadClasses(), loadDesignRules(), loadElements(), loadLibraries(), loadLibrary(), loadPlain(), loadSignals(), and ~EAGLE_PLUGIN().

---

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

• eagle_plugin.h
• eagle_plugin.cpp