kicad/pcbnew/ratsnest/ratsnest_data.h

125 lines
3.6 KiB
C
Raw Normal View History

2013-11-25 15:50:03 +00:00
/*
* This program source code file is part of KICAD, a free EDA CAD application.
*
* Copyright (C) 2013-2015 CERN
* Copyright (C) 2019-2022 KiCad Developers, see AUTHORS.txt for contributors.
*
2013-11-25 15:50:03 +00:00
* @author Maciej Suminski <maciej.suminski@cern.ch>
*
* 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, you may find one here:
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
* or you may search the http://www.gnu.org website for the version 2 license,
* or you may write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
/**
* @file ratsnest_data.h
* @brief Class that computes missing connections on a PCB.
*/
#ifndef RATSNEST_DATA_H
#define RATSNEST_DATA_H
2017-03-22 13:43:10 +00:00
#include <core/typeinfo.h>
2013-11-25 15:50:03 +00:00
#include <math/box2.h>
2020-06-23 02:18:46 +00:00
#include <set>
#include <vector>
2017-03-22 13:43:10 +00:00
#include <connectivity/connectivity_algo.h>
2017-03-22 13:43:10 +00:00
2013-11-25 15:50:03 +00:00
class BOARD_ITEM;
class BOARD_CONNECTED_ITEM;
2017-03-22 13:43:10 +00:00
class CN_CLUSTER;
2020-06-23 02:18:46 +00:00
struct CN_PTR_CMP
{
bool operator()( const std::shared_ptr<CN_ANCHOR>& aItem,
const std::shared_ptr<CN_ANCHOR>& bItem ) const
2020-06-23 02:18:46 +00:00
{
if( aItem->Pos().x == bItem->Pos().x )
return aItem->Pos().y < bItem->Pos().y;
else
return aItem->Pos().x < bItem->Pos().x;
}
};
2013-11-25 15:50:03 +00:00
/**
* Describe ratsnest for a single net.
2013-11-25 15:50:03 +00:00
*/
class RN_NET
{
public:
2017-03-22 13:43:10 +00:00
RN_NET();
2013-11-25 15:50:03 +00:00
/**
* Return state of the 'dirty' flag, indicating that ratsnest for a given net is invalid
2013-11-25 15:50:03 +00:00
* and requires an update.
*
2013-11-25 15:50:03 +00:00
* @return True if ratsnest requires recomputation, false otherwise.
*/
2021-11-30 14:19:39 +00:00
bool IsDirty() const { return m_dirty; }
2013-11-25 15:50:03 +00:00
/**
* Recompute ratsnest for a net.
2013-11-25 15:50:03 +00:00
*/
void UpdateNet();
/**
* Find optimal ends of RNEdges. The MST will have found the closest anchors, but when
* zones are involved we might have points closer than the anchors.
*
* Normally called after UpdateNet(), but from a separate multi-threaded loop for safety.
*/
void OptimizeRNEdges();
2017-03-22 13:43:10 +00:00
void Clear();
2013-11-25 15:50:03 +00:00
2017-03-22 13:43:10 +00:00
void AddCluster( std::shared_ptr<CN_CLUSTER> aCluster );
2013-11-25 15:50:03 +00:00
2021-11-30 14:19:39 +00:00
unsigned int GetNodeCount() const { return m_nodes.size(); }
2013-11-25 15:50:03 +00:00
2021-11-30 14:19:39 +00:00
const std::vector<CN_EDGE>& GetEdges() const { return m_rnEdges; }
std::vector<CN_EDGE>& GetEdges() { return m_rnEdges; }
2017-03-22 13:43:10 +00:00
bool NearestBicoloredPair( RN_NET* aOtherNet, VECTOR2I& aPos1, VECTOR2I& aPos2 ) const;
2013-11-25 15:50:03 +00:00
protected:
///< Recompute ratsnest from scratch.
void compute();
2013-11-25 15:50:03 +00:00
///< Compute the minimum spanning tree using Kruskal's algorithm
void kruskalMST( const std::vector<CN_EDGE> &aEdges );
protected:
///< Vector of nodes
std::multiset<std::shared_ptr<CN_ANCHOR>, CN_PTR_CMP> m_nodes;
2013-11-25 15:50:03 +00:00
///< Vector of edges that make pre-defined connections
2017-03-22 13:43:10 +00:00
std::vector<CN_EDGE> m_boardEdges;
///< Vector of edges that makes ratsnest for a given net.
2017-03-22 13:43:10 +00:00
std::vector<CN_EDGE> m_rnEdges;
///< Flag indicating necessity of recalculation of ratsnest for a net.
2013-11-25 15:50:03 +00:00
bool m_dirty;
2017-03-22 13:43:10 +00:00
class TRIANGULATOR_STATE;
2017-03-22 13:43:10 +00:00
std::shared_ptr<TRIANGULATOR_STATE> m_triangulator;
2013-11-25 15:50:03 +00:00
};
#endif /* RATSNEST_DATA_H */