pns_walkaround.h

Go to the documentation of this file.

/*
 * KiRouter - a push-and-(sometimes-)shove PCB router
 *
 * Copyright (C) 2013-2014 CERN
 * Copyright (C) 2016 KiCad Developers, see AUTHORS.txt for contributors.
 * Author: Tomasz Wlostowski <[email protected]>
 *
 * 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 <http://www.gnu.org/licenses/>.
 */
 
#ifndef __PNS_WALKAROUND_H
#define __PNS_WALKAROUND_H
 
#include <set>
 
#include "pns_line.h"
#include "pns_node.h"
#include "pns_router.h"
#include "pns_logger.h"
#include "pns_algo_base.h"
#include "pns_topology.h"
 
namespace PNS {
 
class WALKAROUND : public ALGO_BASE
{
    static constexpr int MaxWalkPolicies = 3;
    
public:
    WALKAROUND( NODE* aWorld, ROUTER* aRouter ) :
        ALGO_BASE ( aRouter ),
        m_world( aWorld )
    {
        m_forceWinding = false;
        m_itemMask = ITEM::ANY_T;
 
        // Initialize other members, to avoid uninitialized variables.
        m_iteration = 0;
        m_forceCw = false;
        m_forceLongerPath = false;
        m_lengthLimitOn = true;
        m_useShortestPath = false;
        m_lengthExpansionFactor = 10.0;
        m_iterationLimit = Settings().WalkaroundIterationLimit();
    }
 
    ~WALKAROUND() {};
 
    enum STATUS
    {
        ST_IN_PROGRESS = 0,
        ST_ALMOST_DONE,
        ST_DONE,
        ST_STUCK,
        ST_NONE
    };
 
    enum WALK_POLICY
    {
        WP_CW = 0,
        WP_CCW = 1,
        WP_SHORTEST = 2
    };
 
    struct RESULT
    {
        RESULT()
        {
            for( int i = 0; i < MaxWalkPolicies; i++ )
                status [i] = ST_NONE;
        }
 
        STATUS status[ MaxWalkPolicies ];
        LINE lines[ MaxWalkPolicies ];
    };
 
    void SetWorld( NODE* aNode )
    {
        m_world = aNode;
    }
 
    void SetIterationLimit( const int aIterLimit )
    {
        m_iterationLimit = aIterLimit;
    }
 
    void SetSolidsOnly( bool aSolidsOnly )
    {
        if( aSolidsOnly )
            m_itemMask = ITEM::SOLID_T;
        else
            m_itemMask = ITEM::ANY_T;
    }
 
    void SetItemMask( int aMask )
    {
        m_itemMask = aMask;
    }
 
    void SetForceWinding ( bool aEnabled, bool aCw )
    {
        m_forceCw = aCw;
        m_forceWinding = aEnabled;
    }
 
    void SetPickShortestPath( bool aEnabled )
    {
        m_useShortestPath = aEnabled;
    }
 
    void RestrictToCluster( bool aEnabled, const TOPOLOGY::CLUSTER& aCluster );
 
    STATUS Route( const LINE& aInitialPath, LINE& aWalkPath,
            bool aOptimize = true );
 
    const RESULT Route( const LINE& aInitialPath );
 
    void SetLengthLimit( bool aEnable, double aLengthExpansionFactor )
    {
        m_lengthLimitOn = aEnable;
        m_lengthExpansionFactor = aLengthExpansionFactor;
    }
 
    void SetAllowedPolicies( std::vector<WALK_POLICY> aPolicies);
    
private:
    void start( const LINE& aInitialPath );
    bool singleStep();
 
    NODE::OPT_OBSTACLE nearestObstacle( const LINE& aPath );
    NODE* m_world;
 
    int m_iteration;
    int m_iterationLimit;
    int m_itemMask;
    bool m_forceWinding;
    bool m_forceCw;
    VECTOR2I m_cursorPos;
    VECTOR2I m_lastP;
    std::set<const ITEM*> m_restrictedSet;
    std::vector<VECTOR2I> m_restrictedVertices;
    bool m_forceLongerPath;
    bool m_lengthLimitOn;
    bool m_useShortestPath;
    double m_lengthExpansionFactor;
    bool m_enabledPolicies[ MaxWalkPolicies ];
    NODE::OPT_OBSTACLE m_currentObstacle[ MaxWalkPolicies ];
    TOPOLOGY::CLUSTER m_currentCluster[ MaxWalkPolicies ];
    std::optional<TOPOLOGY::CLUSTER> m_lastShortestCluster;
    RESULT m_currentResult;
    double m_initialLength;
};
 
}
 
#endif    // __PNS_WALKAROUND_H