2013-09-18 17:55:16 +00:00
|
|
|
/*
|
|
|
|
* KiRouter - a push-and-(sometimes-)shove PCB router
|
|
|
|
*
|
2017-01-17 14:06:33 +00:00
|
|
|
* Copyright (C) 2013-2017 CERN
|
2019-07-21 22:35:41 +00:00
|
|
|
* Copyright (C) 2016-2019 KiCad Developers, see AUTHORS.txt for contributors.
|
2013-09-18 17:55:16 +00:00
|
|
|
* Author: Tomasz Wlostowski <tomasz.wlostowski@cern.ch>
|
2013-09-26 21:53:54 +00:00
|
|
|
*
|
2013-09-18 17:55:16 +00:00
|
|
|
* 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 3 of the License, or (at your
|
|
|
|
* option) any later version.
|
2013-09-26 21:53:54 +00:00
|
|
|
*
|
2013-09-18 17:55:16 +00:00
|
|
|
* 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.
|
2013-09-26 21:53:54 +00:00
|
|
|
*
|
2013-09-18 17:55:16 +00:00
|
|
|
* You should have received a copy of the GNU General Public License along
|
2014-05-14 13:53:54 +00:00
|
|
|
* with this program. If not, see <http://www.gnu.org/licenses/>.
|
2013-09-18 17:55:16 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __PNS_ITEM_H
|
|
|
|
#define __PNS_ITEM_H
|
|
|
|
|
2016-08-30 15:28:35 +00:00
|
|
|
#include <memory>
|
2013-09-18 17:55:16 +00:00
|
|
|
#include <math/vector2d.h>
|
|
|
|
|
|
|
|
#include <geometry/shape.h>
|
|
|
|
#include <geometry/shape_line_chain.h>
|
|
|
|
|
|
|
|
#include "pns_layerset.h"
|
|
|
|
|
2014-01-29 14:35:25 +00:00
|
|
|
class BOARD_CONNECTED_ITEM;
|
2016-08-29 14:38:11 +00:00
|
|
|
|
|
|
|
namespace PNS {
|
|
|
|
|
2016-08-29 17:31:13 +00:00
|
|
|
class NODE;
|
2013-09-18 17:55:16 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
enum LineMarker {
|
|
|
|
MK_HEAD = ( 1 << 0 ),
|
|
|
|
MK_VIOLATION = ( 1 << 3 ),
|
2015-02-18 00:29:54 +00:00
|
|
|
MK_LOCKED = ( 1 << 4 ),
|
|
|
|
MK_DP_COUPLED = ( 1 << 5 )
|
2014-05-14 13:53:54 +00:00
|
|
|
};
|
|
|
|
|
2015-08-03 19:11:51 +00:00
|
|
|
|
2013-09-18 17:55:16 +00:00
|
|
|
/**
|
2020-01-10 14:31:00 +00:00
|
|
|
* ITEM
|
2013-09-18 17:55:16 +00:00
|
|
|
*
|
|
|
|
* Base class for PNS router board items. Implements the shared properties of all PCB items -
|
|
|
|
* net, spanned layers, geometric shape & refererence to owning model.
|
|
|
|
*/
|
2016-08-29 17:31:13 +00:00
|
|
|
class ITEM
|
2013-09-18 17:55:16 +00:00
|
|
|
{
|
|
|
|
public:
|
2013-09-26 21:53:54 +00:00
|
|
|
static const int UnusedNet = INT_MAX;
|
|
|
|
|
|
|
|
///> Supported item types
|
|
|
|
enum PnsKind
|
|
|
|
{
|
2016-08-29 16:11:42 +00:00
|
|
|
SOLID_T = 1,
|
|
|
|
LINE_T = 2,
|
|
|
|
JOINT_T = 4,
|
|
|
|
SEGMENT_T = 8,
|
|
|
|
VIA_T = 16,
|
|
|
|
DIFF_PAIR_T = 32,
|
|
|
|
ANY_T = 0xff
|
2013-09-26 21:53:54 +00:00
|
|
|
};
|
|
|
|
|
2016-08-29 17:31:13 +00:00
|
|
|
ITEM( PnsKind aKind )
|
2013-09-26 21:53:54 +00:00
|
|
|
{
|
|
|
|
m_net = UnusedNet;
|
|
|
|
m_movable = true;
|
|
|
|
m_kind = aKind;
|
|
|
|
m_parent = NULL;
|
|
|
|
m_owner = NULL;
|
2014-05-14 13:53:54 +00:00
|
|
|
m_marker = 0;
|
|
|
|
m_rank = -1;
|
2018-02-03 09:39:46 +00:00
|
|
|
m_routable = true;
|
2013-09-26 21:53:54 +00:00
|
|
|
}
|
|
|
|
|
2016-08-29 17:31:13 +00:00
|
|
|
ITEM( const ITEM& aOther )
|
2013-09-26 21:53:54 +00:00
|
|
|
{
|
|
|
|
m_layers = aOther.m_layers;
|
|
|
|
m_net = aOther.m_net;
|
|
|
|
m_movable = aOther.m_movable;
|
|
|
|
m_kind = aOther.m_kind;
|
|
|
|
m_parent = aOther.m_parent;
|
2019-08-07 21:45:38 +00:00
|
|
|
m_owner = aOther.m_owner; // fixme: wtf this was null?
|
2014-05-14 13:53:54 +00:00
|
|
|
m_marker = aOther.m_marker;
|
|
|
|
m_rank = aOther.m_rank;
|
2018-02-03 09:39:46 +00:00
|
|
|
m_routable = aOther.m_routable;
|
2013-09-26 21:53:54 +00:00
|
|
|
}
|
|
|
|
|
2016-08-29 17:31:13 +00:00
|
|
|
virtual ~ITEM();
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
/**
|
|
|
|
* Function Clone()
|
|
|
|
*
|
2014-11-02 16:25:04 +00:00
|
|
|
* Returns a deep copy of the item
|
2014-05-14 13:53:54 +00:00
|
|
|
*/
|
2016-08-29 17:31:13 +00:00
|
|
|
virtual ITEM* Clone() const = 0;
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
/*
|
|
|
|
* Function Hull()
|
|
|
|
*
|
|
|
|
* Returns a convex polygon "hull" of a the item, that is used as the walk-around
|
|
|
|
* path.
|
|
|
|
* @param aClearance defines how far from the body of the item the hull should be,
|
|
|
|
* @param aWalkaroundThickness is the width of the line that walks around this hull.
|
|
|
|
*/
|
2013-09-26 21:53:54 +00:00
|
|
|
virtual const SHAPE_LINE_CHAIN Hull( int aClearance = 0, int aWalkaroundThickness = 0 ) const
|
|
|
|
{
|
|
|
|
return SHAPE_LINE_CHAIN();
|
2014-05-16 11:37:31 +00:00
|
|
|
}
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
/**
|
|
|
|
* Function Kind()
|
|
|
|
*
|
|
|
|
* Returns the type (kind) of the item
|
|
|
|
*/
|
2014-11-02 16:25:04 +00:00
|
|
|
PnsKind Kind() const
|
|
|
|
{
|
2014-05-14 13:53:54 +00:00
|
|
|
return m_kind;
|
|
|
|
}
|
2014-11-02 16:25:04 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
/**
|
|
|
|
* Function OfKind()
|
|
|
|
*
|
|
|
|
* Returns true if the item's type matches the mask aKindMask.
|
|
|
|
*/
|
2014-11-02 16:25:04 +00:00
|
|
|
bool OfKind( int aKindMask ) const
|
2014-05-14 13:53:54 +00:00
|
|
|
{
|
2014-05-16 11:37:31 +00:00
|
|
|
return ( aKindMask & m_kind ) != 0;
|
2014-05-14 13:53:54 +00:00
|
|
|
}
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
/**
|
|
|
|
* Function KindStr()
|
|
|
|
*
|
|
|
|
* Returns the kind of the item, as string
|
|
|
|
*/
|
2019-07-21 22:35:41 +00:00
|
|
|
std::string KindStr() const;
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
void SetParent( BOARD_CONNECTED_ITEM* aParent ) { m_parent = aParent; }
|
|
|
|
BOARD_CONNECTED_ITEM* Parent() const { return m_parent; }
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
void SetNet( int aNet ) { m_net = aNet; }
|
|
|
|
int Net() const { return m_net; }
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
const LAYER_RANGE& Layers() const { return m_layers; }
|
|
|
|
void SetLayers( const LAYER_RANGE& aLayers ) { m_layers = aLayers; }
|
2014-05-14 13:53:54 +00:00
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
void SetLayer( int aLayer ) { m_layers = LAYER_RANGE( aLayer, aLayer ); }
|
|
|
|
virtual int Layer() const { return Layers().Start(); }
|
2014-05-14 13:53:54 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Function LayersOverlap()
|
|
|
|
*
|
|
|
|
* Returns true if the set of layers spanned by aOther overlaps our
|
|
|
|
* layers.
|
|
|
|
*/
|
2016-08-29 17:31:13 +00:00
|
|
|
bool LayersOverlap( const ITEM* aOther ) const
|
2014-05-14 13:53:54 +00:00
|
|
|
{
|
|
|
|
return Layers().Overlaps( aOther->Layers() );
|
|
|
|
}
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
/**
|
|
|
|
* Function Owner()
|
|
|
|
*
|
|
|
|
* Returns the owner of this item, or NULL if there's none.
|
|
|
|
*/
|
|
|
|
NODE* Owner() const { return m_owner; }
|
|
|
|
|
2015-08-19 15:27:23 +00:00
|
|
|
/**
|
|
|
|
* Functon SetOwner()
|
|
|
|
*
|
2019-07-21 22:35:41 +00:00
|
|
|
* Sets the node that owns this item. An item can belong to a single NODE or be unowned.
|
2015-08-19 15:27:23 +00:00
|
|
|
*/
|
2019-07-21 22:35:41 +00:00
|
|
|
void SetOwner( NODE* aOwner ) { m_owner = aOwner; }
|
2015-08-19 15:27:23 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Function BelongsTo()
|
|
|
|
*
|
|
|
|
* @return true if the item is owned by the node aNode.
|
|
|
|
*/
|
2016-08-29 17:31:13 +00:00
|
|
|
bool BelongsTo( NODE* aNode ) const
|
2015-08-19 15:27:23 +00:00
|
|
|
{
|
|
|
|
return m_owner == aNode;
|
|
|
|
}
|
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
/**
|
|
|
|
* Function Collide()
|
|
|
|
*
|
2014-11-02 16:25:04 +00:00
|
|
|
* Checks for a collision (clearance violation) with between us and item aOther.
|
2014-05-14 13:53:54 +00:00
|
|
|
* Collision checking takes all PCB stuff into accound (layers, nets, DRC rules).
|
2019-07-21 22:35:41 +00:00
|
|
|
* Optionally returns a minimum translation vector for force propagation algorithm.
|
2014-05-14 13:53:54 +00:00
|
|
|
*
|
|
|
|
* @param aOther item to check collision against
|
|
|
|
* @param aClearance desired clearance
|
|
|
|
* @param aNeedMTV when true, the minimum translation vector is calculated
|
|
|
|
* @param aMTV the minimum translation vector
|
2014-11-02 16:25:04 +00:00
|
|
|
* @return true, if a collision was found.
|
2014-05-14 13:53:54 +00:00
|
|
|
*/
|
2019-07-24 15:19:03 +00:00
|
|
|
virtual bool Collide( const ITEM* aOther, int aClearance, bool aNeedMTV, VECTOR2I* aMTV,
|
|
|
|
const NODE* aParentNode, bool aDifferentNetsOnly = true ) const;
|
2013-09-26 21:53:54 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
/**
|
|
|
|
* Function Shape()
|
|
|
|
*
|
|
|
|
* Returns the geometrical shape of the item. Used
|
|
|
|
* for collision detection & spatial indexing.
|
|
|
|
*/
|
|
|
|
virtual const SHAPE* Shape() const
|
2013-09-26 21:53:54 +00:00
|
|
|
{
|
|
|
|
return NULL;
|
|
|
|
}
|
2013-09-18 17:55:16 +00:00
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
virtual void Mark( int aMarker ) { m_marker = aMarker; }
|
|
|
|
virtual void Unmark( int aMarker = -1 ) { m_marker &= ~aMarker; }
|
|
|
|
virtual int Marker() const { return m_marker; }
|
2014-05-14 13:53:54 +00:00
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
virtual void SetRank( int aRank ) { m_rank = aRank; }
|
|
|
|
virtual int Rank() const { return m_rank; }
|
2014-05-14 13:53:54 +00:00
|
|
|
|
2014-05-16 11:37:31 +00:00
|
|
|
virtual VECTOR2I Anchor( int n ) const
|
2014-11-02 16:25:04 +00:00
|
|
|
{
|
2016-08-15 15:16:53 +00:00
|
|
|
return VECTOR2I();
|
2014-05-16 11:37:31 +00:00
|
|
|
}
|
2014-11-02 16:25:04 +00:00
|
|
|
|
|
|
|
virtual int AnchorCount() const
|
|
|
|
{
|
|
|
|
return 0;
|
2014-05-14 13:53:54 +00:00
|
|
|
}
|
|
|
|
|
2016-08-15 15:16:50 +00:00
|
|
|
bool IsLocked() const
|
|
|
|
{
|
|
|
|
return Marker() & MK_LOCKED;
|
|
|
|
}
|
|
|
|
|
2019-07-21 22:35:41 +00:00
|
|
|
void SetRoutable( bool aRoutable ) { m_routable = aRoutable; }
|
|
|
|
bool IsRoutable() const { return m_routable; }
|
2018-02-03 09:39:46 +00:00
|
|
|
|
2013-09-18 17:55:16 +00:00
|
|
|
private:
|
2019-07-24 15:19:03 +00:00
|
|
|
bool collideSimple( const ITEM* aOther, int aClearance, bool aNeedMTV, VECTOR2I* aMTV,
|
|
|
|
const NODE* aParentNode, bool aDifferentNetsOnly ) const;
|
2013-09-18 17:55:16 +00:00
|
|
|
|
|
|
|
protected:
|
2014-05-14 13:53:54 +00:00
|
|
|
PnsKind m_kind;
|
2013-09-18 17:55:16 +00:00
|
|
|
|
2014-05-16 11:37:31 +00:00
|
|
|
BOARD_CONNECTED_ITEM* m_parent;
|
2019-07-21 22:35:41 +00:00
|
|
|
NODE* m_owner;
|
|
|
|
LAYER_RANGE m_layers;
|
2013-09-18 17:55:16 +00:00
|
|
|
|
2014-05-14 13:53:54 +00:00
|
|
|
bool m_movable;
|
|
|
|
int m_net;
|
|
|
|
int m_marker;
|
|
|
|
int m_rank;
|
2018-02-03 09:39:46 +00:00
|
|
|
bool m_routable;
|
2013-09-18 17:55:16 +00:00
|
|
|
};
|
|
|
|
|
2016-08-30 15:28:35 +00:00
|
|
|
template< typename T, typename S >
|
|
|
|
std::unique_ptr< T > ItemCast( std::unique_ptr< S > aPtr )
|
|
|
|
{
|
|
|
|
static_assert(std::is_base_of< ITEM, S >::value, "Need to be handed a ITEM!");
|
|
|
|
static_assert(std::is_base_of< ITEM, T >::value, "Need to cast to an ITEM!");
|
|
|
|
return std::unique_ptr< T >( static_cast<T*>(aPtr.release()) );
|
|
|
|
}
|
|
|
|
|
|
|
|
template< typename T >
|
|
|
|
std::unique_ptr< typename std::remove_const< T >::type > Clone( const T& aItem )
|
|
|
|
{
|
|
|
|
static_assert(std::is_base_of< ITEM, T >::value, "Need to be handed an ITEM!");
|
|
|
|
return std::unique_ptr< typename std::remove_const< T >::type >( aItem.Clone() );
|
|
|
|
}
|
|
|
|
|
2016-08-29 14:38:11 +00:00
|
|
|
}
|
|
|
|
|
2013-10-14 14:13:35 +00:00
|
|
|
#endif // __PNS_ITEM_H
|