/* * KiRouter - a push-and-(sometimes-)shove PCB router * * Copyright (C) 2013-2014 CERN * Copyright (C) 2016-2020 KiCad Developers, see AUTHORS.txt for contributors. * Author: Tomasz Wlostowski * * 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. * * 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 . */ #ifndef __PNS_INDEX_H #define __PNS_INDEX_H #include #include #include #include #include #include #include "pns_item.h" namespace PNS { /** * INDEX * * Custom spatial index, holding our board items and allowing for very fast searches. Items * are assigned to separate R-Tree subindices depending on their type and spanned layers, reducing * overlap and improving search time. **/ class INDEX { public: typedef std::list NET_ITEMS_LIST; typedef SHAPE_INDEX ITEM_SHAPE_INDEX; typedef std::unordered_set ITEM_SET; INDEX(){}; /** * Adds item to the spatial index. */ void Add( ITEM* aItem ); /** * Removes an item from the spatial index. */ void Remove( ITEM* aItem ); /** * Replaces one item with another. */ void Replace( ITEM* aOldItem, ITEM* aNewItem ); /** * Searches items in the index that are in proximity of aItem. * For each item, function object aVisitor is called. Only items on * overlapping layers are considered. * * @param aItem item to search against * @param aMinDistance proximity distance (wrs to the item's shape) * @param aVisitor function object called on each found item. Return false from the visitor to stop searching. * @return number of items found. */ template int Query( const ITEM* aItem, int aMinDistance, Visitor& aVisitor ) const; /** * Searches items in the index that are in proximity of aShape. * For each item, function object aVisitor is called. Treats all * layers as colliding. * * @param aShape shape to search against * @param aMinDistance proximity distance (wrs to the item's shape) * @param aVisitor function object called on each found item. Return false from the visitor to stop searching. * @return number of items found. */ template int Query( const SHAPE* aShape, int aMinDistance, Visitor& aVisitor ) const; /** * Returns list of all items in a given net. */ NET_ITEMS_LIST* GetItemsForNet( int aNet ); /** * Function Contains() * * Returns true if item aItem exists in the index. */ bool Contains( ITEM* aItem ) const { return m_allItems.find( aItem ) != m_allItems.end(); } /** * Returns number of items stored in the index. */ int Size() const { return m_allItems.size(); } ITEM_SET::iterator begin() { return m_allItems.begin(); } ITEM_SET::iterator end() { return m_allItems.end(); } private: template int querySingle( std::size_t aIndex, const SHAPE* aShape, int aMinDistance, Visitor& aVisitor ) const; private: std::deque m_subIndices; std::map m_netMap; ITEM_SET m_allItems; }; template int INDEX::querySingle( std::size_t aIndex, const SHAPE* aShape, int aMinDistance, Visitor& aVisitor ) const { if( aIndex >= m_subIndices.size() ) return 0; return m_subIndices[aIndex].Query( aShape, aMinDistance, aVisitor); } template int INDEX::Query( const ITEM* aItem, int aMinDistance, Visitor& aVisitor ) const { int total = 0; const LAYER_RANGE& layers = aItem->Layers(); for( int i = layers.Start(); i <= layers.End(); ++i ) total += querySingle( i, aItem->Shape(), aMinDistance, aVisitor ); return total; } template int INDEX::Query( const SHAPE* aShape, int aMinDistance, Visitor& aVisitor ) const { int total = 0; for( std::size_t i = 0; i < m_subIndices.size(); ++i ) total += querySingle( i, aShape, aMinDistance, aVisitor ); return total; } }; #endif