pcb_io_eagle.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2012 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
 
/*
 
Pcbnew PLUGIN for Eagle 6.x XML *.brd and footprint format.
 
XML parsing and converting:
Getting line numbers and byte offsets from the source XML file is not
possible using currently available XML libraries within KiCad project:
wxXmlDocument and boost::property_tree.
 
property_tree will give line numbers but no byte offsets, and only during
document loading. This means that if we have a problem after the document is
successfully loaded, there is no way to correlate back to line number and byte
offset of the problem. So a different approach is taken, one which relies on the
XML elements themselves using an XPATH type of reporting mechanism. The path to
the problem is reported in the error messages. This means keeping track of that
path as we traverse the XML document for the sole purpose of accurate error
reporting.
 
User can load the source XML file into firefox or other xml browser and follow
our error message.
 
Load() TODO's
 
*) verify zone fill clearances are correct
 
*/
 
#include <cerrno>
#include <set>
 
#include <wx/string.h>
#include <wx/xml/xml.h>
#include <wx/filename.h>
#include <wx/log.h>
#include <wx/wfstream.h>
#include <wx/txtstrm.h>
#include <wx/window.h>
 
#include <convert_basic_shapes_to_polygon.h>
#include <font/fontconfig.h>
#include <geometry/geometry_utils.h>
#include <string_utils.h>
#include <trigo.h>
#include <progress_reporter.h>
#include <project.h>
#include <board.h>
#include <board_design_settings.h>
#include <project/net_settings.h>
#include <footprint.h>
#include <pad.h>
#include <pcb_track.h>
#include <pcb_shape.h>
#include <zone.h>
#include <padstack.h>
#include <pcb_text.h>
#include <pcb_dimension.h>
#include <reporter.h>
 
#include <pcb_io/pcb_io.h>
#include <pcb_io/eagle/pcb_io_eagle.h>
#include <io/eagle/eagle_bin_parser.h>
 
using namespace std;
 

static int parseEagle( const wxString& aDistance )
{
    ECOORD::EAGLE_UNIT unit = ( aDistance.npos != aDistance.find( "mil" ) )
                                    ? ECOORD::EAGLE_UNIT::EU_MIL
                                    : ECOORD::EAGLE_UNIT::EU_MM;
 
    ECOORD coord( aDistance, unit );
 
    return coord.ToPcbUnits();
}
 
 
// In Eagle one can specify DRC rules where min value > max value,
// in such case the max value has the priority
template<typename T>
static T eagleClamp( T aMin, T aValue, T aMax )
{
    T ret = std::max( aMin, aValue );
    return std::min( aMax, ret );
}
 

static wxString makeKey( const wxString& aFirst, const wxString& aSecond )
{
    wxString key = aFirst + '\x02' +  aSecond;
    return key;
}
 
 
void PCB_IO_EAGLE::setKeepoutSettingsToZone( ZONE* aZone, int aLayer ) const
{
    if( aLayer == EAGLE_LAYER::TRESTRICT || aLayer == EAGLE_LAYER::BRESTRICT )
    {
        aZone->SetIsRuleArea( true );
        aZone->SetDoNotAllowVias( true );
        aZone->SetDoNotAllowTracks( true );
        aZone->SetDoNotAllowZoneFills( true );
        aZone->SetDoNotAllowPads( true );
        aZone->SetDoNotAllowFootprints( false );
 
        if( aLayer == EAGLE_LAYER::TRESTRICT ) // front layer keepout
            aZone->SetLayer( F_Cu );
        else // bottom layer keepout
            aZone->SetLayer( B_Cu );
    }
    else if( aLayer == EAGLE_LAYER::VRESTRICT )
    {
        aZone->SetIsRuleArea( true );
        aZone->SetDoNotAllowVias( true );
        aZone->SetDoNotAllowTracks( false );
        aZone->SetDoNotAllowZoneFills( false );
        aZone->SetDoNotAllowPads( false );
        aZone->SetDoNotAllowFootprints( false );
 
        aZone->SetLayerSet( LSET::AllCuMask() );
    }
    else    // copper pour cutout
    {
        aZone->SetIsRuleArea( true );
        aZone->SetDoNotAllowVias( false );
        aZone->SetDoNotAllowTracks( false );
        aZone->SetDoNotAllowZoneFills( true );
        aZone->SetDoNotAllowPads( false );
        aZone->SetDoNotAllowFootprints( false );
 
        aZone->SetLayerSet( { kicad_layer( aLayer ) } );
    }
}
 
 
void ERULES::parse( wxXmlNode* aRules, std::function<void()> aCheckpoint )
{
    wxXmlNode* child = aRules->GetChildren();
 
    while( child )
    {
        aCheckpoint();
 
        if( child->GetName() == wxT( "param" ) )
        {
            const wxString& name = child->GetAttribute( wxT( "name" ) );
            const wxString& value = child->GetAttribute( wxT( "value" ) );
 
            if( name == wxT( "psElongationLong" ) )
                psElongationLong = wxAtoi( value );
            else if( name == wxT( "psElongationOffset" ) )
                psElongationOffset = wxAtoi( value );
            else if( name == wxT( "mvStopFrame" ) )
                value.ToCDouble( &mvStopFrame );
            else if( name == wxT( "mvCreamFrame" ) )
                value.ToCDouble( &mvCreamFrame );
            else if( name == wxT( "mlMinStopFrame" ) )
                mlMinStopFrame = parseEagle( value );
            else if( name == wxT( "mlMaxStopFrame" ) )
                mlMaxStopFrame = parseEagle( value );
            else if( name == wxT( "mlMinCreamFrame" ) )
                mlMinCreamFrame = parseEagle( value );
            else if( name == wxT( "mlMaxCreamFrame" ) )
                mlMaxCreamFrame = parseEagle( value );
            else if( name == wxT( "srRoundness" ) )
                value.ToCDouble( &srRoundness );
            else if( name == wxT( "srMinRoundness" ) )
                srMinRoundness = parseEagle( value );
            else if( name == wxT( "srMaxRoundness" ) )
                srMaxRoundness = parseEagle( value );
            else if( name == wxT( "psTop" ) )
                psTop = wxAtoi( value );
            else if( name == wxT( "psBottom" ) )
                psBottom = wxAtoi( value );
            else if( name == wxT( "psFirst" ) )
                psFirst = wxAtoi( value );
            else if( name == wxT( "rvPadTop" ) )
                value.ToCDouble( &rvPadTop );
            else if( name == wxT( "rlMinPadTop" ) )
                rlMinPadTop = parseEagle( value );
            else if( name == wxT( "rlMaxPadTop" ) )
                rlMaxPadTop = parseEagle( value );
            else if( name == wxT( "rlMinPadInner" ) )
                rlMinPadInner = parseEagle( value );
            else if( name == wxT( "rlMaxPadInner" ) )
                rlMaxPadInner = parseEagle( value );
            else if( name == wxT( "rlMinPadBottom" ) )
                rlMinPadBottom = parseEagle( value );
            else if( name == wxT( "rlMaxPadBottom" ) )
                rlMaxPadBottom = parseEagle( value );
            else if( name == wxT( "rvViaOuter" ) )
                value.ToCDouble( &rvViaOuter );
            else if( name == wxT( "rlMinViaOuter" ) )
                rlMinViaOuter = parseEagle( value );
            else if( name == wxT( "rlMaxViaOuter" ) )
                rlMaxViaOuter = parseEagle( value );
            else if( name == wxT( "mdWireWire" ) )
                mdWireWire = parseEagle( value );
        }
 
        child = child->GetNext();
    }
}
 
 
PCB_IO_EAGLE::PCB_IO_EAGLE() :
        PCB_IO( wxS( "Eagle" ) ),
        m_rules( new ERULES() ),
        m_xpath( new XPATH() ),
        m_progressReporter( nullptr ),
        m_doneCount( 0 ),
        m_lastProgressCount( 0 ),
        m_totalCount( 0 ),
        m_timestamp( wxDateTime::Now().GetValue().GetValue() )
{
    using namespace std::placeholders;
 
    init( nullptr );
    clear_cu_map();
    RegisterCallback( std::bind( &PCB_IO_EAGLE::DefaultLayerMappingCallback, this, _1 ) );
}
 
 
PCB_IO_EAGLE::~PCB_IO_EAGLE()
{
    deleteTemplates();
    delete m_rules;
    delete m_xpath;
}
 
 
bool PCB_IO_EAGLE::CanReadBoard( const wxString& aFileName ) const
{
    if( !PCB_IO::CanReadBoard( aFileName ) )
        return false;
 
    return checkHeader( aFileName );
}
 
 
bool PCB_IO_EAGLE::CanReadLibrary( const wxString& aFileName ) const
{
    if( !PCB_IO::CanReadLibrary( aFileName ) )
        return false;
 
    return checkHeader( aFileName );
}
 
 
bool PCB_IO_EAGLE::CanReadFootprint( const wxString& aFileName ) const
{
    return CanReadLibrary( aFileName );
}
 
 
bool PCB_IO_EAGLE::checkHeader(const wxString& aFileName) const
{
    wxFileInputStream input( aFileName );
 
    if( !input.IsOk() )
        return false;
 
    // Pre-v6 boards are a binary stream identified by a two-byte magic.
    if( EAGLE_BIN_PARSER::IsBinaryEagle( input ) )
        return true;
 
    input.SeekI( 0 );
 
    wxTextInputStream text( input );
 
    for( int i = 0; i < 8; i++ )
    {
        if( input.Eof() )
            return false;
 
        if( text.ReadLine().Contains( wxS( "<eagle" ) ) )
            return true;
    }
 
    return false;
}
 
 
void PCB_IO_EAGLE::checkpoint()
{
    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( _( "File import canceled by user." ) );
 
            m_lastProgressCount = m_doneCount;
        }
    }
}
 
 
VECTOR2I inline PCB_IO_EAGLE::kicad_fontsize( const ECOORD& d, int aTextThickness ) const
{
    // Eagle includes stroke thickness in the text size, KiCAD does not
    int kz = d.ToPcbUnits();
    return VECTOR2I( kz - aTextThickness, kz - aTextThickness );
}
 
 
BOARD* PCB_IO_EAGLE::LoadBoard( const wxString& aFileName, BOARD* aAppendToMe,
                                const std::map<std::string, UTF8>* aProperties, PROJECT* aProject )
{
    wxXmlNode*      doc;
 
    // Collect the font substitution warnings (RAII - automatically reset on scope exit)
    FONTCONFIG_REPORTER_SCOPE fontconfigScope( &LOAD_INFO_REPORTER::GetInstance() );
 
    init( aProperties );
 
    m_board = aAppendToMe ? aAppendToMe : new BOARD();
 
    // 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( _( "File import canceled by user." ) );
        }
 
        wxFileName fn = aFileName;
 
        // Load the document
        wxFFileInputStream stream( fn.GetFullPath() );
 
        if( !stream.IsOk() )
            THROW_IO_ERRORF( _( "Unable to read file '%s'" ), fn.GetFullPath() );
 
        // The binary parser synthesizes a DOM identical to what the XML loader
        // produces; both paths then share the common tail below. The document
        // must outlive loadAllSections(), so keep it in this scope.
        wxXmlDocument                  xmlDocument;
        std::unique_ptr<wxXmlDocument> binDocument;
 
        // IsBinaryEagle consumes the two-byte magic, so rewind before reading on.
        bool isBinary = EAGLE_BIN_PARSER::IsBinaryEagle( stream );
        stream.SeekI( 0 );
 
        if( isBinary )
        {
            std::vector<uint8_t> bytes;
            bytes.resize( static_cast<size_t>( stream.GetLength() ) );
            stream.Read( bytes.data(), bytes.size() );
 
            if( stream.LastRead() != bytes.size() )
                THROW_IO_ERRORF( _( "Unable to read file '%s'" ), fn.GetFullPath() );
 
            EAGLE_BIN_PARSER binParser;
            binDocument = binParser.Parse( bytes );
            doc = binDocument->GetRoot();
        }
        else
        {
            if( !xmlDocument.Load( stream ) )
                THROW_IO_ERRORF( _( "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 =
                [&]( const std::shared_ptr<NETCLASS>& netclass )
                {
                    // If Eagle has a clearance matrix then we'll build custom rules from that.
                    // For classes with a clearance-to-default, use that; otherwise use board minimum.
                    if( !netclass->HasClearance() )
                    {
                        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->GetDefaultNetclass() );
 
        for( const auto& [name, netclass] : netSettings->GetNetclasses() )
            finishNetclass( netclass );
 
        m_board->m_LegacyNetclassesLoaded = true;
        m_board->m_LegacyDesignSettingsLoaded = true;
 
        // Only emit a design rules sidecar when the Eagle board carried an actual
        // clearance matrix. A version-only file has no rules and is just clutter.
        if( m_customRules.Contains( wxT( "(rule " ) ) )
        {
            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 )
    {
        THROW_IO_ERRORF( wxT( "%s\n@ %s" ), exc.what(), m_xpath->Contents() );
    }
 
    // IO_ERROR exceptions are left uncaught, they pass upwards from here.
 
    m_board->SetCopperLayerCount( getMinimumCopperLayerCount() );
 
    LSET enabledLayers = m_board->GetDesignSettings().GetEnabledLayers();
 
    for( const auto& [eagleLayerName, layer] : m_layer_map )
    {
        if( layer >= 0 && layer < PCB_LAYER_ID_COUNT )
            enabledLayers.set( layer );
    }
 
    m_board->GetDesignSettings().SetEnabledLayers( enabledLayers );
 
    centerBoard();
 
    deleter.release();
    return m_board;
}
 
 
std::vector<FOOTPRINT*> PCB_IO_EAGLE::GetImportedCachedLibraryFootprints()
{
    std::vector<FOOTPRINT*> retval;
 
    for( const auto& [ name, footprint ] : m_templates )
        retval.push_back( static_cast<FOOTPRINT*>( footprint->Clone() ) );
 
    return retval;
}
 
 
void PCB_IO_EAGLE::init( const std::map<std::string, UTF8>* aProperties )
{
    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();
}
 
 
void PCB_IO_EAGLE::clear_cu_map()
{
    // 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;
}
 
 
void PCB_IO_EAGLE::loadAllSections( wxXmlNode* aDoc )
{
    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"
}
 
 
void PCB_IO_EAGLE::loadDesignRules( wxXmlNode* aDesignRules )
{
    if( aDesignRules )
    {
        m_xpath->push( "designrules" );
        m_rules->parse( aDesignRules,
                        [this]()
                        {
                            checkpoint();
                        } );
        m_xpath->pop();     // "designrules"
    }
}
 
 
void PCB_IO_EAGLE::loadLayerDefs( wxXmlNode* aLayers )
{
    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] = BoardLayerFromLegacyId( 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
        }
    }
}
 
 
#define DIMENSION_PRECISION DIM_PRECISION::X_XX // 0.01 mm
 
 
std::tuple<GR_TEXT_V_ALIGN_T, GR_TEXT_H_ALIGN_T> KiCadAlignmentFromEagle( int aAlign )
{
    std::map<int, std::tuple<GR_TEXT_V_ALIGN_T, GR_TEXT_H_ALIGN_T>> alignmentmap{
        { ETEXT::BOTTOM_LEFT, { GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_H_ALIGN_LEFT } },
        { ETEXT::BOTTOM_RIGHT, { GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_H_ALIGN_RIGHT } },
        { ETEXT::BOTTOM_CENTER, { GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_H_ALIGN_CENTER } },
        { ETEXT::CENTER_RIGHT, { GR_TEXT_V_ALIGN_CENTER, GR_TEXT_H_ALIGN_RIGHT } },
        { ETEXT::CENTER, { GR_TEXT_V_ALIGN_CENTER, GR_TEXT_H_ALIGN_CENTER } },
        { ETEXT::CENTER_LEFT, { GR_TEXT_V_ALIGN_CENTER, GR_TEXT_H_ALIGN_LEFT } },
        { ETEXT::TOP_CENTER, { GR_TEXT_V_ALIGN_TOP, GR_TEXT_H_ALIGN_CENTER } },
        { ETEXT::TOP_LEFT, { GR_TEXT_V_ALIGN_TOP, GR_TEXT_H_ALIGN_LEFT } },
        { ETEXT::TOP_RIGHT, { GR_TEXT_V_ALIGN_TOP, GR_TEXT_H_ALIGN_RIGHT } },
    };
    return alignmentmap[aAlign];
}
 
 
int EagleAlignmentFromKiCad( std::tuple<GR_TEXT_V_ALIGN_T, GR_TEXT_H_ALIGN_T> aAlign )
{
    std::map<std::tuple<GR_TEXT_V_ALIGN_T, GR_TEXT_H_ALIGN_T>, int> alignmentmap{
        { { GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_H_ALIGN_LEFT }, ETEXT::BOTTOM_LEFT },
        { { GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_H_ALIGN_RIGHT }, ETEXT::BOTTOM_RIGHT },
        { { GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_H_ALIGN_CENTER }, ETEXT::BOTTOM_CENTER },
        { { GR_TEXT_V_ALIGN_CENTER, GR_TEXT_H_ALIGN_RIGHT }, ETEXT::CENTER_RIGHT },
        { { GR_TEXT_V_ALIGN_CENTER, GR_TEXT_H_ALIGN_CENTER }, ETEXT::CENTER },
        { { GR_TEXT_V_ALIGN_CENTER, GR_TEXT_H_ALIGN_LEFT }, ETEXT::CENTER_LEFT },
        { { GR_TEXT_V_ALIGN_TOP, GR_TEXT_H_ALIGN_CENTER }, ETEXT::TOP_CENTER },
        { { GR_TEXT_V_ALIGN_TOP, GR_TEXT_H_ALIGN_LEFT }, ETEXT::TOP_LEFT },
        { { GR_TEXT_V_ALIGN_TOP, GR_TEXT_H_ALIGN_RIGHT }, ETEXT::TOP_RIGHT },
    };
    return alignmentmap[aAlign];
}
 
 
void EaglePcbTextToKiCadAlignment( EDA_TEXT* aTxt, int aTxtAlign, double aTxtDegrees, bool aTxtMirror, bool aTxtSpin,
                                   double aElementDegrees = 0.0, bool aElementMirror = false,
                                   bool aElementSpin = false )
{
    GR_TEXT_H_ALIGN_T halign{ GR_TEXT_H_ALIGN_INDETERMINATE };
    GR_TEXT_V_ALIGN_T valign{ GR_TEXT_V_ALIGN_INDETERMINATE };
    int               align{ aTxtAlign };
 
    bool   spin = aTxtSpin != aElementSpin;
    bool   mirror = aTxtMirror != aElementMirror;
    double textDefDegrees = EDA_ANGLE( aTxtDegrees, DEGREES_T ).Normalize().AsDegrees();
    double elementDegrees = EDA_ANGLE( aElementDegrees, DEGREES_T ).Normalize().AsDegrees();
    double degrees = ( aTxtMirror ? -1.0 : 1.0 ) * textDefDegrees + elementDegrees;
    degrees = EDA_ANGLE( degrees, DEGREES_T ).Normalize().AsDegrees();
 
    if( !spin )
    {
        if( ( !aTxtMirror && degrees > 90 && degrees <= 270 ) || ( aTxtMirror && degrees >= 90 && degrees < 270 ) )
        {
            align = -align;
            degrees = degrees - 180;
        }
    }
 
    if( aElementMirror )
        degrees = -degrees;
 
    aTxt->SetTextAngle( EDA_ANGLE( degrees, DEGREES_T ).Normalize() );
    aTxt->SetMirrored( mirror );
    aTxt->SetKeepUpright( false ); // we just aligned the text exactly as EAGLE does
 
    std::tie( valign, halign ) = KiCadAlignmentFromEagle( align );
    aTxt->SetHorizJustify( halign );
    aTxt->SetVertJustify( valign );
}
 
 
void PCB_IO_EAGLE::loadPlain( wxXmlNode* aGraphics )
{
    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, LINE_STYLE::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 = interpretText( t.text );
                pcbtxt->SetText( kicadText );
 
                double ratio = t.ratio ? *t.ratio : 8;     // DTD says 8 is default
                int textThickness = KiROUND( t.size.ToPcbUnits() * ratio / 100.0 );
                pcbtxt->SetTextThickness( textThickness );
                pcbtxt->SetTextSize( kicad_fontsize( t.size, textThickness ) );
                pcbtxt->SetKeepUpright( false );
 
                VECTOR2I eagleAnchor( kicad_x( t.x ), kicad_y( t.y ) );
                pcbtxt->SetTextPos( eagleAnchor );
 
                int    align = t.align ? *t.align : ETEXT::BOTTOM_LEFT;
                double degrees = t.rot ? t.rot->degrees : 0.0;
                bool   mirror = t.rot ? t.rot->mirror : false;
                bool   spin = t.rot ? t.rot->spin : false;
 
                EaglePcbTextToKiCadAlignment( pcbtxt, align, degrees, mirror, spin );
            }
 
            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, LINE_STYLE::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 );
            bool         keepout = ( r.layer == EAGLE_LAYER::TRESTRICT
                                  || r.layer == EAGLE_LAYER::BRESTRICT
                                  || r.layer == EAGLE_LAYER::VRESTRICT );
 
            // A rectangle on a restrict layer is a keepout area, the same as a circle
            // or polygon there; it takes its layer set from setKeepoutSettingsToZone(),
            // so an unmapped layer must not drop it.
            if( keepout || layer != UNDEFINED_LAYER )
            {
                ZONE* zone = new ZONE( m_board );
 
                m_board->Add( zone, ADD_MODE::APPEND );
 
                if( keepout )
                {
                    setKeepoutSettingsToZone( zone, r.layer );
                }
                else
                {
                    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 )
                {
                    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 ) );
                }
 
                // 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 reference designator.
 
            FOOTPRINT* footprint = new FOOTPRINT( m_board );
            m_board->Add( footprint, ADD_MODE::APPEND );
            int hole_count = m_hole_count++;
            footprint->SetReference( wxString::Format( wxT( "UNK_HOLE_%d" ), hole_count ) );
            footprint->Reference().SetVisible( false );
            // Mandatory: gives a dummy but valid LIB_ID
            LIB_ID fpid( wxEmptyString, wxString::Format( wxT( "dummyfp%d" ), hole_count ) );
            footprint->SetFPID( fpid );
 
            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 ) );
            VECTOR2I     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.0 );
                textSize = kicad_fontsize( *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->SetTextPos( pt3 );
                    dimension->SetTextSize( textSize );
                    dimension->SetTextThickness( textThickness );
                    dimension->SetLineThickness( designSettings.GetLineThickness( layer ) );
                    dimension->SetUnits( EDA_UNITS::MM );
                }
                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->SetTextPos( pt3 );
                    leader->SetTextSize( textSize );
                    leader->SetTextThickness( textThickness );
                    leader->SetOverrideText( 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->SetTextSize( textSize );
                    dimension->SetTextThickness( textThickness );
                    dimension->SetLineThickness( designSettings.GetLineThickness( layer ) );
                    dimension->SetUnits( EDA_UNITS::MM );
 
                    // 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 = KiROUND( pt3.Distance( pt1 ) );
 
                        if( pt1.y > pt2.y )
                            dimension->SetHeight( offset );
                        else
                            dimension->SetHeight( -offset );
                    }
                }
            }
        }
 
        // Get next graphic
        gr = gr->GetNext();
    }
 
    m_xpath->pop();
}
 
 
void PCB_IO_EAGLE::loadLibrary( wxXmlNode* aLib, const wxString* aLibName )
{
    if( !aLib )
        return;
 
    wxString urn = aLib->GetAttribute( "urn" );
 
    // Parse the URN with EURN so the asset id matches the one extracted by
    // EELEMENT in loadElements(); using raw urn.AfterLast(':') would leave the
    // version component attached for URNs like
    // "urn:adsk.eagle:library:38243636/1", and the two halves would build
    // keys that no longer compare equal.
    EURN libraryUrn;
 
    if( !urn.IsEmpty() )
        libraryUrn.Parse( urn );
 
    // 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" );
 
    // Build the per-library half of the m_templates key once. Eagle managed
    // libraries can carry the same library name at multiple URN versions in
    // the same board; the URN asset id disambiguates them. The package name
    // itself is left untouched so the FPID written into the board (and the
    // .pretty filename) matches the schematic importer's footprint field.
    wxString libKey;
 
    if( aLibName )
    {
        libKey = *aLibName;
 
        if( libraryUrn.IsValid() )
            libKey += wxS( "_" ) + libraryUrn.assetId;
    }
 
    // 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( libKey, pack_ref ) : pack_ref;
 
        FOOTPRINT* footprint = makeFootprint( package, pack_ref );
 
        // add the templating FOOTPRINT to the FOOTPRINT template factory "m_templates"
        auto r = m_templates.insert( { key, footprint } );
 
        if( !r.second /* && !( m_props && m_props->Value( "ignore_duplicates" ) ) */ )
        {
            THROW_IO_ERRORF( _( "<package> '%s' duplicated in <library> '%s'" ),
                             pack_ref,
                             aLibName ? *aLibName : m_lib_path );
        }
 
        m_xpath->pop();
 
        package = package->GetNext();
    }
 
    m_xpath->pop();     // "packages"
}
 
 
void PCB_IO_EAGLE::loadLibraries( wxXmlNode* aLibs )
{
    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();
}
 
 
void PCB_IO_EAGLE::loadElements( wxXmlNode* aElements )
{
    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() );
 
        // Mirror loadLibrary(): the package name is taken verbatim from Eagle,
        // and the library key is disambiguated with the library URN ordinal so
        // multiple managed-library versions resolve to the right footprint.
        wxString libKey = e.library;
 
        if( e.library_urn )
            libKey += wxS( "_" ) + e.library_urn->assetId;
 
        wxString pkg_key = makeKey( libKey, e.package );
        auto     it = m_templates.find( pkg_key );
 
        if( it == m_templates.end() )
            THROW_IO_ERRORF( _( "No '%s' package in library '%s'." ), e.package, e.library );
 
        FOOTPRINT* footprint = static_cast<FOOTPRINT*>( it->second->Duplicate( IGNORE_PARENT_GROUP ) );
 
        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 );
        adjustFootprintForDesignRules( footprint );
 
        // Get next element
        element = element->GetNext();
    }
 
    m_xpath->pop();     // "elements.element"
}
 
 
ZONE* PCB_IO_EAGLE::loadPolygon( wxXmlNode* aPolyNode )
{
    EPOLYGON     p( aPolyNode );
    PCB_LAYER_ID layer = kicad_layer( p.layer );
    bool         keepout = ( p.layer == EAGLE_LAYER::TRESTRICT
                          || p.layer == EAGLE_LAYER::BRESTRICT
                          || p.layer == EAGLE_LAYER::VRESTRICT );
 
    // Keepout polygons live on the restrict layers, which have no copper/graphic
    // KiCad target; they take their layer set from setKeepoutSettingsToZone(), so an
    // unmapped layer must not drop them.
    if( !keepout && layer == UNDEFINED_LAYER )
    {
        Report( wxString::Format( _( "Ignoring a polygon since Eagle layer '%s' (%d) was not mapped" ),
                                  eagle_layer_name( p.layer ),
                                  p.layer ) , RPT_SEVERITY_INFO );
        return nullptr;
    }
 
    // use a "netcode = 0" type ZONE:
    std::unique_ptr<ZONE> zone = std::make_unique<ZONE>( m_board );
 
    if( !keepout )
        zone->SetLayer( layer );
    else
        setKeepoutSettingsToZone( zone.get(), 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();
    }
 
    // According to Eagle's doc, by default, the orphans (islands in KiCad parlance)
    // are always removed
    if( !p.orphans || !p.orphans.Get() )
        zone->SetIslandRemovalMode( ISLAND_REMOVAL_MODE::ALWAYS );
    else
        zone->SetIslandRemovalMode( ISLAND_REMOVAL_MODE::NEVER );
 
    if( vertices.size() < 3 )
    {
        Report( wxString::Format( _( "Skipping a polygon on layer '%s' (%d): less than 3 vertices" ),
                                  eagle_layer_name( p.layer ),
                                  p.layer ) , RPT_SEVERITY_INFO );
        return nullptr;
    }
 
    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, CORNER_STRATEGY::ALLOW_ACUTE_CORNERS, ARC_HIGH_DEF, true );
 
    if( polygon.OutlineCount() != 1 )
    {
        Report( wxString::Format( _( "Skipping a polygon on layer '%s' (%d): outline count is not 1" ),
                                  eagle_layer_name( p.layer ),
                                  p.layer ) , RPT_SEVERITY_INFO );
 
        return nullptr;
    }
 
    zone->AddPolygon( polygon.COutline( 0 ) );
 
    // If the pour is a cutout it needs to be set to a keepout
    if( p.pour == EPOLYGON::ECUTOUT )
    {
        zone->SetIsRuleArea( true );
        zone->SetDoNotAllowVias( false );
        zone->SetDoNotAllowTracks( false );
        zone->SetDoNotAllowPads( false );
        zone->SetDoNotAllowFootprints( false );
        zone->SetDoNotAllowZoneFills( true );
        zone->SetHatchStyle( ZONE_BORDER_DISPLAY_STYLE::NO_HATCH );
    }
    else if( p.pour == EPOLYGON::EHATCH )
    {
        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_MM * pcbIUScale.IU_PER_MM,
                                          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 );
 
    ZONE* zonePtr = zone.release();
    m_board->Add( zonePtr, ADD_MODE::APPEND );
 
    return zonePtr;
}
 
 
void PCB_IO_EAGLE::orientFootprintAndText( FOOTPRINT* aFootprint, const EELEMENT& e,
                                           const EATTR* aNameAttr, const EATTR* aValueAttr )
{
    std::vector<std::tuple<PCB_FIELD*, double, bool, bool, const EATTR*>> textRotDefs{};
 
    std::vector<PCB_FIELD*> fields{};
    aFootprint->GetFields( fields, false );
 
    for( PCB_FIELD* field : fields )
    {
        double       defDegrees = field->GetLibTextAngle().AsDegrees();
        bool         defMirror = field->IsMirrored();
        bool         defSpin = !field->IsKeepUpright();
        const EATTR* attr = nullptr;
 
        if( field == &aFootprint->Reference() )
            attr = aNameAttr;
        else if( field == &aFootprint->Value() )
            attr = aValueAttr;
 
        textRotDefs.push_back( std::tuple<PCB_FIELD*, double, bool, bool, const EATTR*>( field, defDegrees, defMirror,
                                                                                         defSpin, attr ) );
    }
 
    if( e.rot )
    {
        if( e.rot->mirror )
        {
            aFootprint->SetOrientation( EDA_ANGLE( e.rot->degrees + 180.0, DEGREES_T ) );
            aFootprint->Flip( aFootprint->GetPosition(), FLIP_DIRECTION::TOP_BOTTOM );
        }
        else
        {
            aFootprint->SetOrientation( EDA_ANGLE( e.rot->degrees, DEGREES_T ) );
        }
    }
 
    for( auto textRotDef : textRotDefs )
    {
        PCB_FIELD*   field{};
        double       defDegrees{};
        bool         defMirror{};
        bool         defSpin{};
        const EATTR* attr{};
        std::tie( field, defDegrees, defMirror, defSpin, attr ) = textRotDef;
        orientFPText( aFootprint, e, field, attr, defDegrees, defMirror, defSpin );
    }
}
 
 
void PCB_IO_EAGLE::orientFPText( FOOTPRINT* aFootprint, const EELEMENT& e, PCB_TEXT* aFPText, const EATTR* aAttr,
                                 double aTextDefAngle, bool aTextDefMirror, bool aTextDefSpin )
{
    // 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.0 );
 
        aFPText->SetTextThickness( textThickness );
 
        if( a.size )
        {
            fontz = kicad_fontsize( *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;
        bool    mirror = a.rot ? a.rot->mirror : false;
        bool    spin = a.rot ? a.rot->spin : false;
 
        EaglePcbTextToKiCadAlignment( aFPText, align, degrees, mirror, spin );
    }
    else
    {
        // Part is not smash so use Lib default for NAME/VALUE
        // the text is per the original package, sans <attribute>.
        int align = EagleAlignmentFromKiCad( std::tuple<GR_TEXT_V_ALIGN_T, GR_TEXT_H_ALIGN_T>(
                aFPText->GetVertJustify(), aFPText->GetHorizJustify() ) );
 
        double elementAngle = e.rot ? e.rot->degrees : 0.0;
        bool   elementMirror = e.rot ? e.rot->mirror : false;
        bool   elementSpin = e.rot ? e.rot->spin : false;
 
        // To mimic EAGLE correctly, we need to know here in addition to the element rotation specification
        // the rotation specification (i.e. angle, mirror flag and spin flag) of the original <text ...>
        // definition within the package
        EaglePcbTextToKiCadAlignment( aFPText, align, aTextDefAngle, aTextDefMirror, aTextDefSpin, elementAngle,
                                      elementMirror, elementSpin );
    }
}
 
 
void PCB_IO_EAGLE::adjustFootprintForDesignRules( FOOTPRINT* aFootprint )
{
    // If there is no `designrules` section in the board or library file, there is nothing to do.
    if( !aFootprint || !m_rules )
        return;
 
    // Adjust through hole pads per rlMinPadTop, rlMinPadInner, and rlMinPatBottom design rule settings.
    for( PAD* pad : aFootprint->Pads() )
    {
        if( !pad || !pad->HasDrilledHole() || ( pad->GetFrontShape() != PAD_SHAPE::CIRCLE ) )
            continue;
 
        int adjustedPadDiameter = 0.0;
        PADSTACK& padstack = pad->Padstack();
 
        if( m_rules->rlMinPadTop != 0.0 && padstack.LayerSet().test( F_Cu ) )
        {
            adjustedPadDiameter = padstack.Drill().size.x + ( m_rules->rlMinPadTop * 2 );
 
            if(  ( padstack.Size( F_Cu ).x < adjustedPadDiameter ) )
                padstack.SetSize( VECTOR2I( adjustedPadDiameter, adjustedPadDiameter ), F_Cu );
 
            // For normal pad stacks, the first layer defines the pad for all layers.
            if( padstack.Mode() == PADSTACK::MODE::NORMAL )
                continue;
        }
 
        if( m_rules->rlMinPadBottom != 0.0 && padstack.LayerSet().test( B_Cu ) )
        {
            adjustedPadDiameter = padstack.Drill().size.x + ( m_rules->rlMinPadBottom * 2 );
 
            if( padstack.Size( B_Cu ).x < adjustedPadDiameter )
                padstack.SetSize( VECTOR2I( adjustedPadDiameter, adjustedPadDiameter ), B_Cu );
        }
 
        if( m_rules->rlMinPadInner != 0.0 )
        {
            LSET innerLayers = padstack.LayerSet() & LSET::InternalCuMask();
 
            for( PCB_LAYER_ID layerId : innerLayers.Seq() )
            {
                if( !padstack.LayerSet().test( layerId ) )
                    continue;
 
                adjustedPadDiameter = padstack.Drill().size.x + ( m_rules->rlMinPadInner * 2 );
 
                if( padstack.Size( layerId ).x < adjustedPadDiameter )
                    padstack.SetSize( VECTOR2I( adjustedPadDiameter, adjustedPadDiameter ), layerId );
            }
        }
    }
}
 
 
 
FOOTPRINT* PCB_IO_EAGLE::makeFootprint( wxXmlNode* aPackage, const wxString& aPkgName )
{
    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" ) )
        {
            wxString descr = convertDescription( UnescapeHTML( packageItem->GetNodeContent() ) );
            m->SetLibDescription( descr );
        }
        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();
}
 
 
void PCB_IO_EAGLE::packageWire( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const
{
    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 )
    {
        Report( wxString::Format( _( "Ignoring a wire since Eagle layer '%s' (%d) was not mapped" ),
                                  eagle_layer_name( w.layer ),
                                  w.layer ) , RPT_SEVERITY_INFO );
        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.
    PCB_SHAPE* dwg;
 
    if( !w.curve )
    {
        dwg = new PCB_SHAPE( aFootprint, SHAPE_T::SEGMENT );
 
        dwg->SetStart( start );
        dwg->SetEnd( end );
    }
    else
    {
        dwg = new PCB_SHAPE( aFootprint, SHAPE_T::ARC );
        VECTOR2I center = ConvertArcCenter( start, end, *w.curve );
 
        dwg->SetCenter( center );
        dwg->SetStart( start );
        dwg->SetArcAngleAndEnd( -EDA_ANGLE( *w.curve, DEGREES_T ), true ); // KiCad rotates the other way
    }
 
    dwg->SetLayer( layer );
    dwg->SetStroke( STROKE_PARAMS( width, LINE_STYLE::SOLID ) );
    dwg->Rotate( { 0, 0 }, aFootprint->GetOrientation() );
    dwg->Move( aFootprint->GetPosition() );
 
    aFootprint->Add( dwg );
}
 
 
void PCB_IO_EAGLE::packagePad( FOOTPRINT* aFootprint, wxXmlNode* aTree )
{
    // this is thru hole technology here, no SMDs
    EPAD e( aTree );
    int  shape = EPAD::UNDEF;
    int  eagleDrillz = e.drill ? e.drill->ToPcbUnits() : 0;
 
    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( VECTOR2I( 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( PADSTACK::ALL_LAYERS, PAD_SHAPE::CIRCLE );
            break;
 
        case EPAD::OCTAGON:
            pad->SetShape( PADSTACK::ALL_LAYERS, PAD_SHAPE::CHAMFERED_RECT );
            pad->SetChamferPositions( PADSTACK::ALL_LAYERS, RECT_CHAMFER_ALL );
            pad->SetChamferRectRatio( PADSTACK::ALL_LAYERS, 1 - M_SQRT1_2 );    // Regular polygon
            break;
 
        case EPAD::LONG:
            pad->SetShape( PADSTACK::ALL_LAYERS, PAD_SHAPE::OVAL );
            break;
 
        case EPAD::SQUARE:
            pad->SetShape( PADSTACK::ALL_LAYERS, PAD_SHAPE::RECTANGLE );
            break;
 
        case EPAD::OFFSET:
            pad->SetShape( PADSTACK::ALL_LAYERS, 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( PADSTACK::ALL_LAYERS, VECTOR2I( 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( PADSTACK::ALL_LAYERS, VECTOR2I( diameter, diameter ) );
    }
 
    if( pad->GetShape( PADSTACK::ALL_LAYERS ) == PAD_SHAPE::OVAL )
    {
        // The Eagle "long" pad is wider than it is tall; m_elongation is percent elongation
        VECTOR2I sz = pad->GetSize( PADSTACK::ALL_LAYERS );
        sz.x = ( sz.x * ( 100 + m_rules->psElongationLong ) ) / 100;
        pad->SetSize( PADSTACK::ALL_LAYERS, sz );
 
        if( e.shape && *e.shape == EPAD::OFFSET )
        {
            int offset = KiROUND( ( sz.x - sz.y ) / 2.0 );
            pad->SetOffset( PADSTACK::ALL_LAYERS, VECTOR2I( offset, 0 ) );
        }
    }
 
    if( e.rot )
        pad->SetOrientation( EDA_ANGLE( e.rot->degrees, DEGREES_T ) );
 
    // Eagle spokes are always '+'
    pad->SetThermalSpokeAngle( ANGLE_0 );
 
    if( pad->GetSizeX() > 0 && pad->GetSizeY() > 0 && pad->HasHole() )
    {
        aFootprint->Add( pad.release() );
    }
    else
    {
        wxFileName fileName( m_lib_path );
 
        if( m_board)
            Report( wxString::Format( _( "Invalid zero-sized pad ignored in\nfile: %s" ),
                                      m_board->GetFileName() ), RPT_SEVERITY_ERROR );
        else
            Report( wxString::Format( _( "Invalid zero-sized pad ignored in\nfile: %s" ),
                                      fileName.GetFullName() ), RPT_SEVERITY_ERROR );
    }
}
 
 
void PCB_IO_EAGLE::packageText( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const
{
    ETEXT        t( aTree );
    PCB_LAYER_ID layer = kicad_layer( t.layer );
 
    if( layer == UNDEFINED_LAYER )
    {
        Report( wxString::Format( _( "Ignoring a text since Eagle layer '%s' (%d) was not mapped" ),
                                  eagle_layer_name( t.layer ),
                                  t.layer ) , RPT_SEVERITY_INFO );
        return;
    }
 
    PCB_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
    {
        textItem = new PCB_TEXT( aFootprint );
        aFootprint->Add( textItem );
 
        textItem->SetText( interpretText( t.text ) );
    }
 
    VECTOR2I pos( kicad_x( t.x ), kicad_y( t.y ) );
 
    textItem->SetPosition( pos );
    textItem->SetLayer( layer );
 
    double ratio = t.ratio ? *t.ratio : 8;  // DTD says 8 is default
    int    textThickness = KiROUND( t.size.ToPcbUnits() * ratio / 100.0 );
 
    textItem->SetTextThickness( textThickness );
    textItem->SetTextSize( kicad_fontsize( 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();
 
    double degrees = t.rot ? t.rot->degrees : 0.0; // range used by EAGLE is [0° ; 360°[
    bool   mirror = t.rot ? t.rot->mirror : false;
    bool   spin = t.rot ? t.rot->spin : false;
 
    textItem->SetKeepUpright( !spin );
 
    if( mirror )
        textItem->SetMirrored( mirror );
 
    GR_TEXT_H_ALIGN_T halign{ GR_TEXT_H_ALIGN_INDETERMINATE };
    GR_TEXT_V_ALIGN_T valign{ GR_TEXT_V_ALIGN_INDETERMINATE };
    std::tie( valign, halign ) = KiCadAlignmentFromEagle( align );
    textItem->SetHorizJustify( halign );
    textItem->SetVertJustify( valign );
 
    textItem->SetTextAngle( EDA_ANGLE( degrees, DEGREES_T ) );
    textItem->SetLibTextAngle( EDA_ANGLE( degrees, DEGREES_T ) );
    // EaglePcbTextToKiCadAlignment (called from orientFPText) will tidy up the final orientation on the PCB
}
 
 
void PCB_IO_EAGLE::packageRectangle( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const
{
    ERECT r( aTree );
 
    if( r.layer == EAGLE_LAYER::TRESTRICT || r.layer == EAGLE_LAYER::BRESTRICT
            || r.layer == EAGLE_LAYER::VRESTRICT )
    {
        ZONE* zone = new 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 )
        {
            Report( wxString::Format( _( "Ignoring a rectangle since Eagle layer '%s' (%d) was not mapped" ),
                                      eagle_layer_name( r.layer ),
                                      r.layer ) , RPT_SEVERITY_INFO );
            return;
        }
 
        PCB_SHAPE* dwg = new PCB_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 ) );
 
        dwg->Rotate( { 0, 0 }, aFootprint->GetOrientation() );
        dwg->Move( aFootprint->GetPosition() );
    }
}
 
 
void PCB_IO_EAGLE::packagePolygon( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const
{
    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();
    }
 
    // A polygon needs at least three corners to enclose an area. Degenerate
    // outlines occur in malformed or partially-decoded sources; skip them rather
    // than dereferencing an empty vertex list.
    if( vertices.size() < 3 )
    {
        Report( wxString::Format( _( "Skipping a polygon on layer '%s' (%d): less than 3 vertices" ),
                                  eagle_layer_name( p.layer ),
                                  p.layer ) , RPT_SEVERITY_INFO );
        return;
    }
 
    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 );
            }
        }
    }
 
    PCB_LAYER_ID layer = kicad_layer( p.layer );
 
    if( ( p.pour == EPOLYGON::ECUTOUT && layer != UNDEFINED_LAYER )
        || p.layer == EAGLE_LAYER::TRESTRICT
        || p.layer == EAGLE_LAYER::BRESTRICT
        || p.layer == EAGLE_LAYER::VRESTRICT )
    {
        ZONE* zone = new 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
    {
        if( layer == UNDEFINED_LAYER )
        {
            Report( wxString::Format( _( "Ignoring a polygon since Eagle layer '%s' (%d) was not mapped" ),
                                      eagle_layer_name( p.layer ),
                                      p.layer ) , RPT_SEVERITY_INFO );
            return;
        }
 
        PCB_SHAPE* dwg = new PCB_SHAPE( aFootprint, SHAPE_T::POLY );
 
        aFootprint->Add( dwg );
 
        dwg->SetStroke( STROKE_PARAMS( 0 ) );
        dwg->SetFilled( true );
        dwg->SetLayer( layer );
 
        dwg->SetPolyPoints( pts );
        dwg->Rotate( { 0, 0 }, aFootprint->GetOrientation() );
        dwg->Move( aFootprint->GetPosition() );
        dwg->GetPolyShape().Inflate( p.width.ToPcbUnits() / 2, CORNER_STRATEGY::ALLOW_ACUTE_CORNERS,
                                     ARC_HIGH_DEF );
    }
}
 
 
void PCB_IO_EAGLE::packageCircle( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const
{
    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 )
    {
        ZONE* zone = new 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 )
        {
            Report( wxString::Format( _( "Ignoring a circle since Eagle layer '%s' (%d) was not mapped" ),
                                      eagle_layer_name( e.layer ),
                                      e.layer ) , RPT_SEVERITY_INFO );
            return;
        }
 
        PCB_SHAPE* gr = new PCB_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, LINE_STYLE::SOLID ) );
 
        switch( (int) layer )
        {
        case UNDEFINED_LAYER:
            layer = Cmts_User;
            break;
        default:
            break;
        }
 
        gr->SetLayer( layer );
        gr->SetStart( VECTOR2I( kicad_x( e.x ), kicad_y( e.y ) ) );
        gr->SetEnd( VECTOR2I( kicad_x( e.x ) + radius, kicad_y( e.y ) ) );
        gr->Rotate( { 0, 0 }, aFootprint->GetOrientation() );
        gr->Move( aFootprint->GetPosition() );
    }
}
 
 
void PCB_IO_EAGLE::packageHole( FOOTPRINT* aFootprint, wxXmlNode* aTree, bool aCenter ) const
{
    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->SetShape( PADSTACK::ALL_LAYERS, 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 )
    {
        aFootprint->SetPosition( padpos );
        pad->SetPosition( padpos );
    }
    else
    {
        pad->SetPosition( padpos + aFootprint->GetPosition() );
    }
 
    VECTOR2I sz( e.drill.ToPcbUnits(), e.drill.ToPcbUnits() );
 
    pad->SetDrillSize( sz );
    pad->SetSize( PADSTACK::ALL_LAYERS, sz );
 
    pad->SetLayerSet( LSET( LSET::AllCuMask() ).set( B_Mask ).set( F_Mask ) );
}
 
 
void PCB_IO_EAGLE::packageSMD( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const
{
    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->SetShape( PADSTACK::ALL_LAYERS, PAD_SHAPE::RECTANGLE );
    pad->SetAttribute( PAD_ATTRIB::SMD );
 
    VECTOR2I padSize( e.dx.ToPcbUnits(), e.dy.ToPcbUnits() );
    pad->SetSize( PADSTACK::ALL_LAYERS, padSize );
    pad->SetLayer( layer );
 
    const LSET front( { F_Cu, F_Paste, F_Mask } );
    const LSET back( { 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( PADSTACK::ALL_LAYERS, PAD_SHAPE::ROUNDRECT );
        pad->SetRoundRectRadiusRatio( PADSTACK::ALL_LAYERS, roundRatio );
    }
 
    if( e.rot )
        pad->SetOrientation( EDA_ANGLE( e.rot->degrees, DEGREES_T ) );
 
    // Eagle spokes are always '+'
    pad->SetThermalSpokeAngle( ANGLE_0 );
 
    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 ) );
    }
}
 
 
void PCB_IO_EAGLE::transferPad( const EPAD_COMMON& aEaglePad, PAD* aPad ) const
{
    aPad->SetNumber( aEaglePad.name );
 
    VECTOR2I padPos( kicad_x( aEaglePad.x ), kicad_y( aEaglePad.y ) );
 
    // Solder mask
    const VECTOR2I& padSize( aPad->GetSize( PADSTACK::ALL_LAYERS ) );
 
    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->SetLocalZoneConnection( ZONE_CONNECTION::FULL );
 
    FOOTPRINT* footprint = aPad->GetParentFootprint();
    wxCHECK( footprint, /* void */ );
    RotatePoint( padPos, footprint->GetOrientation() );
    aPad->SetPosition( padPos + footprint->GetPosition() );
}
 
 
void PCB_IO_EAGLE::deleteTemplates()
{
    for( const auto& [ name, footprint ] : m_templates )
    {
        footprint->SetParent( nullptr );
        delete footprint;
    }
 
    m_templates.clear();
}
 
 
void PCB_IO_EAGLE::loadClasses( wxXmlNode* aClasses )
{
    // Eagle board DTD defines the "classes" element as 0 or 1.
    if( !aClasses )
        return;
 
    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->GetDefaultNetclass();
        }
        else
        {
            netclass.reset( new NETCLASS( eClass.name ) );
            bds.m_NetSettings->SetNetclass( eClass.name, netclass );
        }
 
        netclass->SetTrackWidth( INT_MAX );
        netclass->SetViaDiameter( INT_MAX );
        netclass->SetViaDrill( INT_MAX );
 
        eClasses.emplace_back( eClass );
        m_classMap[ eClass.number ] = netclass;
 
        // Set netclass clearance to the clearance-to-default-class value
        auto clearanceToDefaultIt = eClass.clearanceMap.find( wxT( "0" ) );
 
        if( clearanceToDefaultIt != eClass.clearanceMap.end() )
        {
            netclass->SetClearance( clearanceToDefaultIt->second.ToPcbUnits() );
        }
 
        // Get next class
        classNode = classNode->GetNext();
    }
 
    m_customRules = wxT( "(version 2)" );
 
    for( ECLASS& eClass : eClasses )
    {
        for( const auto& [className, pt] : eClass.clearanceMap )
        {
            // Skip clearances to default class (class "0") - these are handled via netclass clearances
            if( className == wxT( "0" ) )
                continue;
 
            if( m_classMap[className] != 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,
                             className,
                             eClass.name,
                             m_classMap[className]->GetName(),
                             EDA_UNIT_UTILS::UI::StringFromValue( pcbIUScale, EDA_UNITS::MM, pt.ToPcbUnits() ) );
 
                m_customRules += wxT( "\n" ) + rule;
            }
        }
    }
 
    m_xpath->pop(); // "classes.class"
}
 
 
void PCB_IO_EAGLE::loadSignals( wxXmlNode* aSignals )
{
    // Eagle board DTD defines the "signals" element as 0 or 1.
    if( !aSignals )
        return;
 
    BOARD_DESIGN_SETTINGS& bds = m_board->GetDesignSettings();
 
    int   netCode = 1;
 
    // Eagle auto-named nets are stored without a name; we synthesize an N$<n>
    // fallback for them below. Collect the explicit names first so a fallback can
    // never collide with a real signal and silently merge two distinct nets.
    std::set<wxString> usedNetNames;
 
    for( wxXmlNode* signal = aSignals->GetChildren(); signal; signal = signal->GetNext() )
    {
        wxString explicitName = escapeName( signal->GetAttribute( "name" ) );
 
        if( !explicitName.IsEmpty() )
            usedNetNames.insert( explicitName );
    }
 
    m_xpath->push( "signals.signal", "name" );
 
    // Get the first signal and iterate
    wxXmlNode* net = aSignals->GetChildren();
 
    while( net )
    {
        checkpoint();
 
        wxString                  netName = escapeName( net->GetAttribute( "name" ) );
 
        // Eagle leaves auto-generated nets unnamed in the binary stream. An empty
        // name collides with the board's reserved unconnected net (code 0), so
        // NETINFO_LIST would silently drop the net and orphan every item routed on
        // it. Synthesize a unique fallback that avoids every explicit signal name,
        // matching Eagle's own N$x naming without merging distinct nets.
        if( netName.IsEmpty() )
        {
            int candidate = netCode;
 
            do
            {
                netName = wxString::Format( wxT( "N$%d" ), candidate++ );
            } while( usedNetNames.count( netName ) );
 
            usedNetNames.insert( netName );
        }
 
        NETINFO_ITEM*             netInfo = new NETINFO_ITEM( m_board, netName, netCode );
        std::shared_ptr<NETCLASS> netclass;
 
        if( net->HasAttribute( "class" ) )
        {
            auto netclassIt = m_classMap.find( net->GetAttribute( "class" ) );
 
            if( netclassIt != m_classMap.end() )
            {
                bds.m_NetSettings->SetNetclassPatternAssignment( netName, netclassIt->second->GetName() );
                netInfo->SetNetClass( netclassIt->second );
                netclass = netclassIt->second;
            }
        }
 
        m_board->Add( netInfo );
 
        // AppendNet deduplicates by name and renumbers to keep net codes
        // consecutive, so the authoritative code for this signal's items is
        // whatever the board accepted, not the local request counter.
        netCode = netInfo->GetNetCode();
 
        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 ) );
                    VECTOR2I end( kicad_x( w.x2 ), kicad_y( w.y2 ) );
 
                    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 )
                    {
                        VECTOR2I center = ConvertArcCenter( start, end, *w.curve );
                        double   radius = sqrt( pow( center.x - kicad_x( w.x1 ), 2 ) +
                                                pow( center.y - kicad_y( w.y1 ), 2 ) );
                        VECTOR2I mid = CalcArcMid( start, end, center, true );
                        VECTOR2I otherMid = CalcArcMid( start, end, center, false );
 
                        double   radiusA = ( mid - center ).EuclideanNorm();
                        double   radiusB = ( otherMid - center ).EuclideanNorm();
 
                        if( abs( radiusA - radius ) > abs( radiusB - radius ) )
                            std::swap( mid, otherMid );
 
                        PCB_ARC* arc = new PCB_ARC( m_board );
 
                        arc->SetPosition( start );
                        arc->SetMid( mid );
                        arc->SetEnd( end );
                        arc->SetWidth( width );
                        arc->SetLayer( layer );
                        arc->SetNetCode( netCode );
 
                        m_board->Add( arc );
                    }
                    else
                    {
                        PCB_TRACK* track = new PCB_TRACK( m_board );
 
                        track->SetPosition( start );
                        track->SetEnd( VECTOR2I( kicad_x( w.x2 ), kicad_y( w.y2 ) ) );
                        track->SetWidth( width );
                        track->SetLayer( layer );
                        track->SetNetCode( netCode );
 
                        m_board->Add( track );
                    }
                }
                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( PADSTACK::ALL_LAYERS, 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( PADSTACK::ALL_LAYERS, kidiam );
                    }
 
                    via->SetDrill( drillz );
 
                    // make sure the via diameter respects the restring rules
 
                    int via_width = via->GetWidth( PADSTACK::ALL_LAYERS );
 
                    if( !v.diam || via_width <= via->GetDrill() )
                    {
                        double annular_width = ( via_width - via->GetDrill() ) / 2.0;
                        double clamped_annular_width = eagleClamp( m_rules->rlMinViaOuter,
                                                                   annular_width,
                                                                   m_rules->rlMaxViaOuter );
                        via->SetWidth( PADSTACK::ALL_LAYERS, drillz + 2 * clamped_annular_width );
                    }
 
                    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( layer_front_most == F_Cu || layer_back_most == B_Cu )
                    {
                        via->SetViaType( VIATYPE::BLIND );
                    }
                    else
                    {
                        via->SetViaType( VIATYPE::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();
            }
 
            else if( itemName == wxT( "polygon" ) )
            {
                m_xpath->push( "polygon" );
                auto* zone = loadPolygon( netItem );
 
                if( zone && !zone->GetIsRuleArea() )
                    zone->SetNetCode( netCode );
 
                m_xpath->pop();     // "polygon"
            }
 
            netItem = netItem->GetNext();
        }
 
        //Next signal needs a new netCode
        netCode++;
 
        // Get next signal
        net = net->GetNext();
    }
 
    m_xpath->pop();     // "signals.signal"
}
 
 
std::map<wxString, PCB_LAYER_ID> PCB_IO_EAGLE::DefaultLayerMappingCallback(
            const std::vector<INPUT_LAYER_DESC>& aInputLayerDescriptionVector )
{
    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;
}
 
 
void PCB_IO_EAGLE::mapEagleLayersToKicad( bool aIsLibraryCache )
{
    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 );
 
    // A layer the handler leaves at UNSELECTED_LAYER has no placement target: the
    // headless default callback has no user to consult, and the item loaders only
    // skip UNDEFINED_LAYER. Normalize it so those items are dropped rather than
    // stranded on an out-of-range layer.
    for( auto& [name, layer] : m_layer_map )
    {
        if( layer == UNSELECTED_LAYER )
            layer = UNDEFINED_LAYER;
    }
 
    if( m_progressReporter && dynamic_cast<wxWindow*>( m_progressReporter ))
        dynamic_cast<wxWindow*>( m_progressReporter )->Show();
}
 
 
PCB_LAYER_ID PCB_IO_EAGLE::kicad_layer( int aEagleLayer ) const
{
    auto result = m_layer_map.find( eagle_layer_name( aEagleLayer ) );
    return result == m_layer_map.end() ? UNDEFINED_LAYER : result->second;
}
 
 
std::tuple<PCB_LAYER_ID, LSET, bool> PCB_IO_EAGLE::defaultKicadLayer( int aEagleLayer,
                                                                      bool aIsLibraryCache ) const
{
    // 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( { 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;
 
    case EAGLE_LAYER::USERDRAWINGS:
        kiLayer = Dwgs_User;
        break;
    case EAGLE_LAYER::USERMARGIN:
        kiLayer = Margin;
        break;
 
    case EAGLE_LAYER::USER1:
        kiLayer = User_1;
        break;
    case EAGLE_LAYER::USER2:
        kiLayer = User_2;
        break;
    case EAGLE_LAYER::USER3:
        kiLayer = User_3;
        break;
    case EAGLE_LAYER::USER4:
        kiLayer = User_4;
        break;
    case EAGLE_LAYER::USER5:
        kiLayer = User_5;
        break;
    case EAGLE_LAYER::USER6:
        kiLayer = User_6;
        break;
    case EAGLE_LAYER::USER7:
        kiLayer = User_7;
        break;
    case EAGLE_LAYER::USER8:
        kiLayer = User_8;
        break;
    case EAGLE_LAYER::USER9:
        kiLayer = User_9;
        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 };
}
 
 
const wxString& PCB_IO_EAGLE::eagle_layer_name( int aLayer ) const
{
    static const wxString unknown( "unknown" );
    auto it = m_eagleLayers.find( aLayer );
    return it == m_eagleLayers.end() ? unknown : it->second.name;
}
 
 
int PCB_IO_EAGLE::eagle_layer_id( const wxString& aLayerName ) const
{
    static const int unknown = -1;
    auto it = m_eagleLayersIds.find( aLayerName );
    return it == m_eagleLayersIds.end() ? unknown : it->second;
}
 
 
void PCB_IO_EAGLE::centerBoard()
{
    if( m_props )
    {
        UTF8 page_width;
        UTF8 page_height;
 
        if( auto it = m_props->find( "page_width" ); it != m_props->end() )
            page_width = it->second;
 
        if( auto it = m_props->find( "page_height" ); it != m_props->end() )
            page_height = it->second;
 
        if( !page_width.empty() && !page_height.empty() )
        {
            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;
 
            VECTOR2I movementVector{ desired_x - bbbox.GetX(), desired_y - bbbox.GetY() };
            m_board->Move( movementVector );
 
            BOARD_DESIGN_SETTINGS& bds = m_board->GetDesignSettings();
            bds.SetAuxOrigin( bds.GetAuxOrigin() + movementVector );
            bds.SetGridOrigin( bds.GetGridOrigin() + movementVector );
 
            m_board->SetModified();
        }
    }
}
 
 
long long PCB_IO_EAGLE::GetLibraryTimestamp( const wxString& aPath ) const
{
    // File hasn't been loaded yet.
    if( aPath.IsEmpty() )
        return wxDateTime::Now().GetValue().GetValue();
 
    wxFileName  fn( aPath );
 
    if( fn.IsFileReadable() && fn.GetModificationTime().IsValid() )
        return fn.GetModificationTime().GetValue().GetValue();
    else
        return 0;
}
 
 
void PCB_IO_EAGLE::cacheLib( const wxString& aLibPath )
{
    // Suppress font substitution warnings (RAII - automatically restored on scope exit)
    FONTCONFIG_REPORTER_SCOPE fontconfigScope( nullptr );
 
    try
    {
        long long timestamp = GetLibraryTimestamp( aLibPath );
 
        if( aLibPath != m_lib_path || m_timestamp != timestamp )
        {
            wxXmlNode*  doc;
 
            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_ERRORF( _( "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_timestamp = timestamp;
        }
    }
    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 );
    // }
}
 
 
void PCB_IO_EAGLE::FootprintEnumerate( wxArrayString& aFootprintNames, const wxString& aLibraryPath,
                                       bool aBestEfforts, const std::map<std::string, UTF8>* aProperties )
{
    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( const auto& [ name, footprint ] : m_templates )
        aFootprintNames.Add( name );
 
    if( !errorMsg.IsEmpty() && !aBestEfforts )
        THROW_IO_ERROR( errorMsg );
}
 
 
FOOTPRINT* PCB_IO_EAGLE::FootprintLoad( const wxString& aLibraryPath, const wxString& aFootprintName,
                                        bool aKeepUUID, const std::map<std::string, UTF8>* aProperties )
{
    init( aProperties );
    cacheLib( aLibraryPath );
    auto it = m_templates.find( aFootprintName );
 
    if( it == m_templates.end() )
        return nullptr;
 
    // Return a copy of the template
    FOOTPRINT* copy = (FOOTPRINT*) it->second->Duplicate( IGNORE_PARENT_GROUP );
    copy->SetParent( nullptr );
    return copy;
}
 
 
int PCB_IO_EAGLE::getMinimumCopperLayerCount() const
{
    int minLayerCount = 2;
 
    std::map<wxString, PCB_LAYER_ID>::const_iterator it;
 
    for( it = m_layer_map.begin(); it != m_layer_map.end(); ++it )
    {
        PCB_LAYER_ID layerId = it->second;
 
        if( !IsCopperLayer( layerId ) || layerId == F_Cu || layerId == B_Cu )
            continue;
 
        int ordinal = CopperLayerToOrdinal( layerId );
 
        if( ( ordinal + 2 ) > minLayerCount )
            minLayerCount = ordinal + 2;
    }
 
    // 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)
    if( ( minLayerCount % 2 ) != 0 )
        minLayerCount++;
 
    return minLayerCount;
}