/* * 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 * * 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_ROUTER_H #define __PNS_ROUTER_H #include #include #include #include #include "pns_routing_settings.h" #include "pns_sizes_settings.h" #include "pns_item.h" #include "pns_itemset.h" #include "pns_node.h" namespace KIGFX { class VIEW; class VIEW_GROUP; }; namespace PNS { class DEBUG_DECORATOR; class NODE; class DIFF_PAIR_PLACER; class PLACEMENT_ALGO; class LINE_PLACER; class ITEM; class LINE; class SOLID; class SEGMENT; class JOINT; class VIA; class RULE_RESOLVER; class SHOVE; class DRAGGER; enum ROUTER_MODE { PNS_MODE_ROUTE_SINGLE = 1, PNS_MODE_ROUTE_DIFF_PAIR, PNS_MODE_TUNE_SINGLE, PNS_MODE_TUNE_DIFF_PAIR, PNS_MODE_TUNE_DIFF_PAIR_SKEW }; /** * Class ROUTER * * Main router class. */ class ROUTER_IFACE { public: ROUTER_IFACE() {}; virtual ~ROUTER_IFACE() {}; virtual void SetRouter( ROUTER* aRouter ) = 0; virtual void SyncWorld( NODE* aNode ) = 0; virtual void AddItem( ITEM* aItem ) = 0; virtual void RemoveItem( ITEM* aItem ) = 0; virtual void DisplayItem( const ITEM* aItem, int aColor = -1, int aClearance = -1 ) = 0; virtual void HideItem( ITEM* aItem ) = 0; virtual void Commit() = 0; // virtual void Abort () = 0; virtual void EraseView() = 0; virtual void UpdateNet( int aNetCode ) = 0; virtual RULE_RESOLVER* GetRuleResolver() = 0; virtual DEBUG_DECORATOR* GetDebugDecorator() = 0; }; class ROUTER { private: enum RouterState { IDLE, DRAG_SEGMENT, ROUTE_TRACK }; public: ROUTER(); ~ROUTER(); void SetInterface( ROUTER_IFACE* aIface ); void SetMode ( ROUTER_MODE aMode ); ROUTER_MODE Mode() const { return m_mode; } static ROUTER* GetInstance(); void ClearWorld(); void SyncWorld(); void SetView( KIGFX::VIEW* aView ); bool RoutingInProgress() const; bool StartRouting( const VECTOR2I& aP, ITEM* aItem, int aLayer ); void Move( const VECTOR2I& aP, ITEM* aItem ); bool FixRoute( const VECTOR2I& aP, ITEM* aItem ); void StopRouting(); int GetClearance( const ITEM* aA, const ITEM* aB ) const; NODE* GetWorld() const { return m_world; } void FlipPosture(); void DisplayItem( const ITEM* aItem, int aColor = -1, int aClearance = -1 ); void DisplayItems( const ITEM_SET& aItems ); void DeleteTraces( ITEM* aStartItem, bool aWholeTrack ); void SwitchLayer( int layer ); void ToggleViaPlacement(); void SetOrthoMode ( bool aEnable ); int GetCurrentLayer() const; const std::vector GetCurrentNets() const; void DumpLog(); RULE_RESOLVER* GetRuleResolver() const { return m_iface->GetRuleResolver(); } bool IsPlacingVia() const; const ITEM_SET QueryHoverItems( const VECTOR2I& aP ); const VECTOR2I SnapToItem( ITEM* aItem, VECTOR2I aP, bool& aSplitsSegment ); bool StartDragging( const VECTOR2I& aP, ITEM* aItem ); void SetIterLimit( int aX ) { m_iterLimit = aX; } int GetIterLimit() const { return m_iterLimit; }; void SetShowIntermediateSteps( bool aX, int aSnapshotIter = -1 ) { m_showInterSteps = aX; m_snapshotIter = aSnapshotIter; } bool GetShowIntermediateSteps() const { return m_showInterSteps; } int GetShapshotIter() const { return m_snapshotIter; } ROUTING_SETTINGS& Settings() { return m_settings; } void CommitRouting( NODE* aNode ); /** * Applies stored settings. * @see Settings() */ void UpdateSizes( const SIZES_SETTINGS& aSizes ); /** * Changes routing settings to ones passed in the parameter. * @param aSettings are the new settings. */ void LoadSettings( const ROUTING_SETTINGS& aSettings ) { m_settings = aSettings; } void EnableSnapping( bool aEnable ) { m_snappingEnabled = aEnable; } bool SnappingEnabled() const { return m_snappingEnabled; } SIZES_SETTINGS& Sizes() { return m_sizes; } ITEM* QueryItemByParent( const BOARD_ITEM* aItem ) const; void SetFailureReason ( const wxString& aReason ) { m_failureReason = aReason; } const wxString& FailureReason() const { return m_failureReason; } PLACEMENT_ALGO* Placer() { return m_placer; } ROUTER_IFACE* GetInterface() const { return m_iface; } private: void movePlacing( const VECTOR2I& aP, ITEM* aItem ); void moveDragging( const VECTOR2I& aP, ITEM* aItem ); void eraseView(); void updateView( NODE* aNode, ITEM_SET& aCurrent ); void clearViewFlags(); // optHoverItem queryHoverItemEx(const VECTOR2I& aP); ITEM* pickSingleItem( ITEM_SET& aItems ) const; void splitAdjacentSegments( NODE* aNode, ITEM* aSeg, const VECTOR2I& aP ); ITEM* syncPad( D_PAD* aPad ); ITEM* syncTrack( TRACK* aTrack ); ITEM* syncVia( VIA* aVia ); void commitPad( SOLID* aPad ); void commitSegment( SEGMENT* aTrack ); void commitVia( VIA* aVia ); void highlightCurrent( bool enabled ); void markViolations( NODE* aNode, ITEM_SET& aCurrent, NODE::ITEM_VECTOR& aRemoved ); VECTOR2I m_currentEnd; RouterState m_state; NODE* m_world; NODE* m_lastNode; PLACEMENT_ALGO * m_placer; DRAGGER* m_dragger; SHOVE* m_shove; ROUTER_IFACE* m_iface; int m_iterLimit; bool m_showInterSteps; int m_snapshotIter; KIGFX::VIEW* m_view; bool m_snappingEnabled; bool m_violation; ROUTING_SETTINGS m_settings; ///> Stores list of modified items in the current operation SIZES_SETTINGS m_sizes; ROUTER_MODE m_mode; wxString m_toolStatusbarName; wxString m_failureReason; }; } #endif