ROUTER_TOOL Class Reference

#include <router_tool.h>

Inheritance diagram for ROUTER_TOOL:

Public Types
enum	RESET_REASON { RUN , MODEL_RELOAD , GAL_SWITCH , REDRAW }
	Determine the reason of reset for a tool. More...

Public Member Functions
	ROUTER_TOOL ()
	~ROUTER_TOOL ()
bool	Init () override
	Init() is called once upon a registration of the tool. More...
void	Reset (RESET_REASON aReason) override
	Bring the tool to a known, initial state. More...
int	MainLoop (const TOOL_EVENT &aEvent)
int	RouteSelected (const TOOL_EVENT &aEvent)
int	InlineBreakTrack (const TOOL_EVENT &aEvent)
bool	CanInlineDrag (int aDragMode)
int	InlineDrag (const TOOL_EVENT &aEvent)
int	SelectCopperLayerPair (const TOOL_EVENT &aEvent)
int	DpDimensionsDialog (const TOOL_EVENT &aEvent)
int	SettingsDialog (const TOOL_EVENT &aEvent)
int	ChangeRouterMode (const TOOL_EVENT &aEvent)
int	CycleRouterMode (const TOOL_EVENT &aEvent)
int	CustomTrackWidthDialog (const TOOL_EVENT &aEvent)
PNS::PNS_MODE	GetRouterMode ()
bool	RoutingInProgress ()
	Returns whether routing is currently active. More...
void	setTransitions () override
	This method is meant to be overridden in order to specify handlers for events. More...
void	UpdateMessagePanel ()
ROUTER *	Router () const
void	SetIsFootprintEditor (bool aEnabled)
	Function SetIsFootprintEditor() More...
bool	IsFootprintEditor () const
void	SetIsBoardEditor (bool aEnabled)
bool	IsBoardEditor () const
virtual bool	Is45Limited () const
	Should the tool use its 45° mode option? More...
void	Activate ()
	Run the tool. More...
TOOL_MENU &	GetToolMenu ()
void	SetContextMenu (ACTION_MENU *aMenu, CONTEXT_MENU_TRIGGER aTrigger=CMENU_BUTTON)
	Assign a context menu and tells when it should be activated. More...
void	RunMainStack (std::function< void()> aFunc)
	Call a function using the main stack. More...
template<class T >
void	Go (int(T::*aStateFunc)(const TOOL_EVENT &), const TOOL_EVENT_LIST &aConditions=TOOL_EVENT(TC_ANY, TA_ANY))
	Define which state (aStateFunc) to go when a certain event arrives (aConditions). More...
TOOL_EVENT *	Wait (const TOOL_EVENT_LIST &aEventList=TOOL_EVENT(TC_ANY, TA_ANY))
	Suspend execution of the tool until an event specified in aEventList arrives. More...
TOOL_TYPE	GetType () const
	Return the type of the tool. More...
TOOL_ID	GetId () const
	Return the unique identifier of the tool. More...
const std::string &	GetName () const
	Return the name of the tool. More...
TOOL_MANAGER *	GetManager () const
	Return the instance of TOOL_MANAGER that takes care of the tool. More...
bool	IsToolActive () const

Static Public Member Functions
static void	NeighboringSegmentFilter (const VECTOR2I &aPt, GENERAL_COLLECTOR &aCollector)

Protected Types
enum	INTERACTIVE_PLACEMENT_OPTIONS { IPO_ROTATE = 0x01 , IPO_FLIP = 0x02 , IPO_SINGLE_CLICK = 0x04 , IPO_REPEAT = 0x08 }
	Options for placing items interactively. More...

Protected Member Functions
bool	checkSnap (ITEM *aItem)
const VECTOR2I	snapToItem (ITEM *aSnapToItem, const VECTOR2I &aP)
virtual ITEM *	pickSingleItem (const VECTOR2I &aWhere, int aNet=-1, int aLayer=-1, bool aIgnorePads=false, const std::vector< ITEM * > aAvoidItems={})
virtual void	highlightNets (bool aEnabled, std::set< int > aNetcodes={})
virtual void	updateStartItem (const TOOL_EVENT &aEvent, bool aIgnorePads=false)
virtual void	updateEndItem (const TOOL_EVENT &aEvent)
void	doInteractiveItemPlacement (const TOOL_EVENT &aTool, INTERACTIVE_PLACER_BASE *aPlacer, const wxString &aCommitMessage, int aOptions=IPO_ROTATE|IPO_FLIP|IPO_REPEAT)
	Helper function for performing a common interactive idiom: wait for a left click, place an item there (perhaps with a dialog or other user interaction), then have it move with the mouse and respond to rotate/flip, etc. More...
KIGFX::PCB_VIEW *	view () const
KIGFX::VIEW_CONTROLS *	controls () const
PCB_BASE_EDIT_FRAME *	frame () const
BOARD *	board () const
FOOTPRINT *	footprint () const
PCBNEW_SETTINGS::DISPLAY_OPTIONS &	displayOptions () const
PCB_DRAW_PANEL_GAL *	canvas () const
const PCB_SELECTION &	selection () const
PCB_SELECTION &	selection ()
void	attachManager (TOOL_MANAGER *aManager)
	Set the TOOL_MANAGER the tool will belong to. More...
KIGFX::VIEW *	getView () const
	Returns the instance of #VIEW object used in the application. More...
KIGFX::VIEW_CONTROLS *	getViewControls () const
	Return the instance of VIEW_CONTROLS object used in the application. More...
template<typename T >
T *	getEditFrame () const
	Return the application window object, casted to requested user type. More...
template<typename T >
T *	getModel () const
	Return the model object if it matches the requested type. More...

Protected Attributes
SIZES_SETTINGS	m_savedSizes
ITEM *	m_startItem
VECTOR2I	m_startSnapPoint
std::set< int >	m_startHighlightNetcodes
ITEM *	m_endItem
VECTOR2I	m_endSnapPoint
PCB_GRID_HELPER *	m_gridHelper
PNS_KICAD_IFACE *	m_iface
ROUTER *	m_router
bool	m_cancelled
bool	m_isFootprintEditor
bool	m_isBoardEditor
TOOL_MENU	m_menu
	The functions below are not yet implemented - their interface may change. More...
TOOL_TYPE	m_type
	Unique identifier for the tool, assigned by a TOOL_MANAGER instance. More...
TOOL_ID	m_toolId
	Name of the tool. More...
std::string	m_toolName
TOOL_MANAGER *	m_toolMgr

Private Member Functions
void	performRouting ()
void	performDragging (int aMode=PNS::DM_ANY)
void	breakTrack ()
void	handleCommonEvents (TOOL_EVENT &evt)
int	handleLayerSwitch (const TOOL_EVENT &aEvent, bool aForceVia)
int	getStartLayer (const PNS::ITEM *aItem)
void	switchLayerOnViaPlacement ()
void	updateSizesAfterLayerSwitch (PCB_LAYER_ID targetLayer)
bool	getNearestRatnestAnchor (VECTOR2I &aPoint, LAYER_RANGE &aLayers)
int	onLayerCommand (const TOOL_EVENT &aEvent)
int	onViaCommand (const TOOL_EVENT &aEvent)
int	onTrackViaSizeChanged (const TOOL_EVENT &aEvent)
bool	prepareInteractive ()
bool	finishInteractive ()
void	saveRouterDebugLog ()
void	resetTransitions ()
	Clear the current transition map and restores the default one created by setTransitions(). More...
void	goInternal (TOOL_STATE_FUNC &aState, const TOOL_EVENT_LIST &aConditions)
EDA_ITEM *	getModelInt () const
TOOLS_HOLDER *	getToolHolderInt () const

Private Attributes
std::shared_ptr< ACTION_MENU >	m_diffPairMenu
std::shared_ptr< ACTION_MENU >	m_trackViaMenu
int	m_lastTargetLayer
PCB_LAYER_ID	m_originalActiveLayer
bool	m_inRouterTool

Detailed Description

Definition at line 28 of file router_tool.h.

Member Enumeration Documentation

INTERACTIVE_PLACEMENT_OPTIONS

enum PCB_TOOL_BASE::INTERACTIVE_PLACEMENT_OPTIONS

protectedinherited

Options for placing items interactively.

Enumerator
IPO_ROTATE	Handle the rotate action in the loop by calling the item's rotate method.
IPO_FLIP	Handle flip action in the loop by calling the item's flip method.
IPO_SINGLE_CLICK	Create an item immediately on placement starting, otherwise show the pencil cursor until the item is created.
IPO_REPEAT	Allow repeat placement of the item.

Definition at line 121 of file pcb_tool_base.h.

 {
 IPO_ROTATE = 0x01,
 
 IPO_FLIP = 0x02,
 
 IPO_SINGLE_CLICK = 0x04,
 
 IPO_REPEAT = 0x08
 };

RESET_REASON

enum TOOL_BASE::RESET_REASON

inherited

Determine the reason of reset for a tool.

Enumerator
RUN	Tool is invoked after being inactive.
MODEL_RELOAD	Model changes (required full reload)
GAL_SWITCH	Rendering engine changes.
REDRAW	Full drawing refresh.

Definition at line 77 of file tool_base.h.

 {
 RUN, 
 MODEL_RELOAD, 
 GAL_SWITCH, 
 REDRAW 
 };

Constructor & Destructor Documentation

ROUTER_TOOL()

ROUTER_TOOL::ROUTER_TOOL

(

)

Definition at line 184 of file router_tool.cpp.

 :
 TOOL_BASE( "pcbnew.InteractiveRouter" ),
 m_lastTargetLayer( UNDEFINED_LAYER ),
 m_originalActiveLayer( UNDEFINED_LAYER ),
 m_inRouterTool( false )
{
}

~ROUTER_TOOL()

ROUTER_TOOL::~ROUTER_TOOL

(

)

Definition at line 439 of file router_tool.cpp.

{
}

Member Function Documentation

Activate()

void TOOL_INTERACTIVE::Activate ( )

inherited

Run the tool.

After activation, the tool starts receiving events until it is finished.

Definition at line 51 of file tool_interactive.cpp.

{
 m_toolMgr->InvokeTool( m_toolId );
}

References TOOL_MANAGER::InvokeTool(), TOOL_BASE::m_toolId, and TOOL_BASE::m_toolMgr.

Referenced by AUTOPLACE_TOOL::autoplace(), EDIT_TOOL::copyToClipboard(), SCH_EDIT_TOOL::DeleteItemCursor(), SYMBOL_EDITOR_EDIT_TOOL::DeleteItemCursor(), PL_EDIT_TOOL::DeleteItemCursor(), PCB_CONTROL::DeleteItemCursor(), SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::DragArcTrack(), DRAWING_TOOL::DrawArc(), DRAWING_TOOL::DrawCircle(), DRAWING_TOOL::DrawDimension(), DRAWING_TOOL::DrawLine(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::DrawRectangle(), SCH_DRAWING_TOOLS::DrawShape(), SYMBOL_EDITOR_DRAWING_TOOLS::DrawShape(), PL_DRAWING_TOOLS::DrawShape(), SCH_DRAWING_TOOLS::DrawSheet(), DRAWING_TOOL::DrawZone(), BOARD_EDITOR_CONTROL::DrillOrigin(), PAD_TOOL::EnumeratePads(), PCB_CONTROL::GridSetOrigin(), SCH_EDITOR_CONTROL::HighlightNetCursor(), InlineBreakTrack(), InlineDrag(), DRAWING_TOOL::InteractivePlaceWithPreview(), BOARD_INSPECTION_TOOL::LocalRatsnestTool(), EE_POINT_EDITOR::Main(), SCH_MOVE_TOOL::Main(), SYMBOL_EDITOR_MOVE_TOOL::Main(), PICKER_TOOL::Main(), PL_EDIT_TOOL::Main(), PL_POINT_EDITOR::Main(), PCB_PICKER_TOOL::Main(), LENGTH_TUNER_TOOL::MainLoop(), MainLoop(), GERBVIEW_INSPECTION_TOOL::MeasureTool(), PCB_VIEWER_TOOLS::MeasureTool(), PCB_POINT_EDITOR::OnSelectionChange(), GROUP_TOOL::PickNewMember(), SYMBOL_EDITOR_DRAWING_TOOLS::PlaceAnchor(), BOARD_EDITOR_CONTROL::PlaceFootprint(), SCH_DRAWING_TOOLS::PlaceImage(), DRAWING_TOOL::PlaceImage(), DRAWING_TOOL::PlaceImportedGraphics(), PL_DRAWING_TOOLS::PlaceItem(), SCH_DRAWING_TOOLS::PlaceSymbol(), DRAWING_TOOL::PlaceText(), EDIT_TOOL::Remove(), RouteSelected(), POSITION_RELATIVE_TOOL::SelectPositionRelativeItem(), DRAWING_TOOL::SetAnchor(), DRC_TOOL::ShowDRCDialog(), SCH_DRAWING_TOOLS::SingleClickPlace(), SCH_DRAWING_TOOLS::TwoClickPlace(), SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace(), and SCH_LINE_WIRE_BUS_TOOL::UnfoldBus().

attachManager()

void TOOL_BASE::attachManager ( TOOL_MANAGER *  aManager )

protectedinherited

Set the TOOL_MANAGER the tool will belong to.

Called by TOOL_MANAGER::RegisterTool()

Definition at line 60 of file tool_base.cpp.

{
 m_toolMgr = aManager;
}

References TOOL_BASE::m_toolMgr.

Referenced by TOOL_MANAGER::RegisterTool().

board()

BOARD * PCB_TOOL_BASE::board ( ) const

inlineprotectedinherited

Definition at line 170 of file pcb_tool_base.h.

{ return getModel<BOARD>(); }

Referenced by PCB_CONTROL::AppendBoard(), BOARD_EDITOR_CONTROL::AssignNetclass(), AUTOPLACE_TOOL::autoplace(), BOARD_INSPECTION_TOOL::calculateSelectionRatsnest(), EDIT_TOOL::ChangeTrackWidth(), ZONE_FILLER_TOOL::CheckAllZones(), BOARD_INSPECTION_TOOL::ClearHighlight(), EDIT_TOOL::copyToClipboard(), FOOTPRINT_EDITOR_CONTROL::CreateFootprint(), MICROWAVE_TOOL::createInductorBetween(), CustomTrackWidthDialog(), PCB_CONTROL::DeleteItemCursor(), PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::DragArcTrack(), DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawDimension(), DRAWING_TOOL::drawShape(), PAD_TOOL::EnumeratePads(), PAD_TOOL::explodePad(), BOARD_EDITOR_CONTROL::ExportNetlist(), ZONE_FILLER_TOOL::FillAllZones(), EDIT_TOOL::FilletTracks(), PCB_TOOL_BASE::footprint(), GROUP_TOOL::Group(), handleLayerSwitch(), BOARD_INSPECTION_TOOL::highlightNet(), Init(), InlineDrag(), DRAWING_TOOL::InteractivePlaceWithPreview(), PCB_CONTROL::LayerNext(), PCB_CONTROL::LayerPrev(), BOARD_INSPECTION_TOOL::LocalRatsnestTool(), EDIT_TOOL::MoveExact(), FOOTPRINT_EDITOR_CONTROL::NewFootprint(), PCB_CONTROL::Paste(), PCB_CONTROL::placeBoardItems(), BOARD_EDITOR_CONTROL::PlaceFootprint(), PAD_TOOL::PlacePad(), DRAWING_TOOL::PlaceText(), PCB_CONTROL::pruneItemLayers(), EDIT_TOOL::rebuildConnectivity(), ZONE_FILLER_TOOL::rebuildConnectivity(), PAD_TOOL::RecombinePad(), BOARD_EDITOR_CONTROL::RepairBoard(), FOOTPRINT_EDITOR_CONTROL::RepairFootprint(), PNS::TOOL_BASE::Reset(), PAD_TOOL::Reset(), PCB_CONTROL::Reset(), PCB_CONTROL::TrackDisplayMode(), PCB_CONTROL::unfilledZoneCheck(), GROUP_TOOL::Ungroup(), UpdateMessagePanel(), updateSizesAfterLayerSwitch(), PCB_CONTROL::ViaDisplayMode(), PCB_CONTROL::ZoneDisplayMode(), ZONE_FILLER_TOOL::ZoneFill(), ZONE_FILLER_TOOL::ZoneFillDirty(), BOARD_EDITOR_CONTROL::ZoneMerge(), and ZONE_FILLER_TOOL::ZoneUnfillAll().

breakTrack()

void ROUTER_TOOL::breakTrack ( )

private

Definition at line 1536 of file router_tool.cpp.

{
 if( m_startItem && m_startItem->OfKind( PNS::ITEM::SEGMENT_T ) )
 m_router->BreakSegment( m_startItem, m_startSnapPoint );
}

References PNS::ROUTER::BreakSegment(), PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::TOOL_BASE::m_startSnapPoint, PNS::ITEM::OfKind(), and PNS::ITEM::SEGMENT_T.

Referenced by InlineBreakTrack(), and MainLoop().

CanInlineDrag()

bool ROUTER_TOOL::CanInlineDrag

(

int

aDragMode

)

Definition at line 2000 of file router_tool.cpp.

{
 m_toolMgr->RunAction( PCB_ACTIONS::selectionCursor, true, NeighboringSegmentFilter );
 const PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
 if( selection.Size() == 1 )
 {
 const BOARD_ITEM* item = static_cast<const BOARD_ITEM*>( selection.Front() );
 
 // Note: EDIT_TOOL::Drag temporarily handles items of type PCB_ARC_T on its own using
 // DragArcTrack(), so PCB_ARC_T should never occur here.
 if( item->IsType( GENERAL_COLLECTOR::DraggableItems ) )
 {
 // Footprints cannot be dragged freely.
 if( item->IsType( { PCB_FOOTPRINT_T } ) )
 return !( aDragMode & PNS::DM_FREE_ANGLE );
 else
 return true;
 }
 }
 
 return false;
}

References PNS::DM_FREE_ANGLE, GENERAL_COLLECTOR::DraggableItems, SELECTION::Front(), TOOL_MANAGER::GetTool(), EDA_ITEM::IsType(), TOOL_BASE::m_toolMgr, NeighboringSegmentFilter(), TOOL_MANAGER::RunAction(), PCB_TOOL_BASE::selection(), PCB_ACTIONS::selectionCursor, and SELECTION::Size().

canvas()

PCB_DRAW_PANEL_GAL * PCB_TOOL_BASE::canvas ( ) const

protectedinherited

Definition at line 310 of file pcb_tool_base.cpp.

{
 return static_cast<PCB_DRAW_PANEL_GAL*>( frame()->GetCanvas() );
}

References PCB_TOOL_BASE::frame(), and PCB_BASE_FRAME::GetCanvas().

Referenced by BOARD_EDITOR_CONTROL::AssignNetclass(), FOOTPRINT_EDITOR_CONTROL::CreateFootprint(), EDIT_TOOL::DeleteItems(), EDIT_TOOL::doMoveSelection(), PAD_TOOL::EditPad(), PAD_TOOL::EnumeratePads(), ZONE_FILLER_TOOL::FillAllZones(), EDIT_TOOL::Init(), FOOTPRINT_EDITOR_CONTROL::NewFootprint(), LENGTH_TUNER_TOOL::performTuning(), EDIT_TOOL::pickReferencePoint(), PCB_CONTROL::RatsnestModeCycle(), EDIT_TOOL::rebuildConnectivity(), ZONE_FILLER_TOOL::rebuildConnectivity(), ZONE_FILLER_TOOL::refresh(), POSITION_RELATIVE_TOOL::RelativeItemSelectionMove(), EDIT_TOOL::Remove(), FOOTPRINT_EDITOR_CONTROL::Save(), FOOTPRINT_EDITOR_CONTROL::SaveAs(), POSITION_RELATIVE_TOOL::SelectPositionRelativeItem(), ZONE_FILLER_TOOL::singleShotRefocus(), PCB_CONTROL::ToggleRatsnest(), PCB_CONTROL::TrackDisplayMode(), PCB_CONTROL::ViaDisplayMode(), PCB_CONTROL::ZoneDisplayMode(), and ZONE_FILLER_TOOL::ZoneFillDirty().

ChangeRouterMode()

int ROUTER_TOOL::ChangeRouterMode

(

const TOOL_EVENT &

aEvent

)

Definition at line 1495 of file router_tool.cpp.

{
 PNS::PNS_MODE mode = aEvent.Parameter<PNS::PNS_MODE>();
 PNS::ROUTING_SETTINGS& settings = m_router->Settings();
 
 settings.SetMode( mode );
 
 return 0;
}

References PNS::TOOL_BASE::m_router, TOOL_EVENT::Parameter(), PNS::ROUTING_SETTINGS::SetMode(), and PNS::ROUTER::Settings().

Referenced by setTransitions().

checkSnap()

bool TOOL_BASE::checkSnap ( ITEM *  aItem )

protectedinherited

Definition at line 263 of file pns_tool_base.cpp.

{
 // Sync PNS engine settings with the general PCB editor options.
 auto& pnss = m_router->Settings();
 
 // If we're dragging a track segment, don't try to snap to items that are part of the original line.
 if( m_startItem && aItem && m_router->GetState() == ROUTER::DRAG_SEGMENT
 && m_router->GetDragger() )
 {
 DRAGGER* dragger = dynamic_cast<DRAGGER*>( m_router->GetDragger() );
 LINKED_ITEM* liItem = dynamic_cast<LINKED_ITEM*>( aItem );
 
 if( dragger && liItem && dragger->GetOriginalLine().ContainsLink( liItem ) )
 {
 return false;
 }
 }
 
 pnss.SetSnapToPads(
 frame()->GetMagneticItemsSettings()->pads == MAGNETIC_OPTIONS::CAPTURE_CURSOR_IN_TRACK_TOOL ||
 frame()->GetMagneticItemsSettings()->pads == MAGNETIC_OPTIONS::CAPTURE_ALWAYS );
 
 pnss.SetSnapToTracks(
 frame()->GetMagneticItemsSettings()->tracks == MAGNETIC_OPTIONS::CAPTURE_CURSOR_IN_TRACK_TOOL
 || frame()->GetMagneticItemsSettings()->tracks == MAGNETIC_OPTIONS::CAPTURE_ALWAYS );
 
 if( aItem )
 {
 if( aItem->OfKind( ITEM::VIA_T | ITEM::SEGMENT_T | ITEM::ARC_T ) )
 return pnss.GetSnapToTracks();
 else if( aItem->OfKind( ITEM::SOLID_T ) )
 return pnss.GetSnapToPads();
 }
 
 return false;
}

References PNS::ITEM::ARC_T, CAPTURE_ALWAYS, CAPTURE_CURSOR_IN_TRACK_TOOL, PNS::LINK_HOLDER::ContainsLink(), PNS::ROUTER::DRAG_SEGMENT, PCB_TOOL_BASE::frame(), PNS::ROUTER::GetDragger(), PCB_BASE_FRAME::GetMagneticItemsSettings(), PNS::DRAGGER::GetOriginalLine(), PNS::ROUTER::GetState(), PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::ITEM::OfKind(), MAGNETIC_SETTINGS::pads, PNS::ITEM::SEGMENT_T, PNS::ROUTER::Settings(), PNS::ITEM::SOLID_T, MAGNETIC_SETTINGS::tracks, and PNS::ITEM::VIA_T.

Referenced by PNS::TOOL_BASE::updateEndItem().

controls()

KIGFX::VIEW_CONTROLS * PCB_TOOL_BASE::controls ( ) const

inlineprotectedinherited

Definition at line 160 of file pcb_tool_base.h.

 {
 return getViewControls();
 }

References TOOL_BASE::getViewControls().

Referenced by PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::DragArcTrack(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::DrawZone(), finishInteractive(), handleLayerSwitch(), InlineBreakTrack(), InlineDrag(), PCB_PICKER_TOOL::Main(), LENGTH_TUNER_TOOL::MainLoop(), MainLoop(), performRouting(), LENGTH_TUNER_TOOL::performTuning(), BOARD_EDITOR_CONTROL::PlaceFootprint(), prepareInteractive(), RouteSelected(), PCB_PICKER_TOOL::setControls(), PCB_POINT_EDITOR::setEditedPoint(), PNS::TOOL_BASE::updateEndItem(), and PNS::TOOL_BASE::updateStartItem().

CustomTrackWidthDialog()

int ROUTER_TOOL::CustomTrackWidthDialog

(

const TOOL_EVENT &

aEvent

)

Definition at line 2426 of file router_tool.cpp.

{
 BOARD_DESIGN_SETTINGS& bds = board()->GetDesignSettings();
 DIALOG_TRACK_VIA_SIZE sizeDlg( frame(), bds );
 
 if( sizeDlg.ShowModal() == wxID_OK )
 {
 bds.m_TempOverrideTrackWidth = true;
 bds.UseCustomTrackViaSize( true );
 
 TOOL_EVENT dummy;
 onTrackViaSizeChanged( dummy );
 }
 
 return 0;
}

References PCB_TOOL_BASE::board(), dummy, PCB_TOOL_BASE::frame(), BOARD::GetDesignSettings(), BOARD_DESIGN_SETTINGS::m_TempOverrideTrackWidth, onTrackViaSizeChanged(), and BOARD_DESIGN_SETTINGS::UseCustomTrackViaSize().

Referenced by setTransitions().

CycleRouterMode()

int ROUTER_TOOL::CycleRouterMode

(

const TOOL_EVENT &

aEvent

)

Definition at line 1506 of file router_tool.cpp.

{
 PNS::ROUTING_SETTINGS& settings = m_router->Settings();
 PNS::PNS_MODE mode = settings.Mode();
 
 switch( mode )
 {
 case PNS::RM_MarkObstacles: mode = PNS::RM_Shove; break;
 case PNS::RM_Shove: mode = PNS::RM_Walkaround; break;
 case PNS::RM_Walkaround: mode = PNS::RM_MarkObstacles; break;
 }
 
 settings.SetMode( mode );
 
 return 0;
}

References PNS::TOOL_BASE::m_router, PNS::ROUTING_SETTINGS::Mode(), PNS::RM_MarkObstacles, PNS::RM_Shove, PNS::RM_Walkaround, PNS::ROUTING_SETTINGS::SetMode(), and PNS::ROUTER::Settings().

Referenced by setTransitions().

displayOptions()

PCBNEW_SETTINGS::DISPLAY_OPTIONS & PCB_TOOL_BASE::displayOptions ( ) const

protectedinherited

Definition at line 305 of file pcb_tool_base.cpp.

{
 return frame()->GetPcbNewSettings()->m_Display;
}

References PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetPcbNewSettings(), and PCBNEW_SETTINGS::m_Display.

Referenced by BOARD_INSPECTION_TOOL::calculateSelectionRatsnest(), InlineDrag(), BOARD_INSPECTION_TOOL::LocalRatsnestTool(), PCB_CONTROL::RatsnestModeCycle(), PCB_CONTROL::ToggleRatsnest(), PCB_CONTROL::TrackDisplayMode(), and PCB_CONTROL::ViaDisplayMode().

doInteractiveItemPlacement()

void PCB_TOOL_BASE::doInteractiveItemPlacement ( const TOOL_EVENT &  aTool, INTERACTIVE_PLACER_BASE *  aPlacer, const wxString &  aCommitMessage, int  aOptions = IPO_ROTATE | IPO_FLIP | IPO_REPEAT  )

protectedinherited

Helper function for performing a common interactive idiom: wait for a left click, place an item there (perhaps with a dialog or other user interaction), then have it move with the mouse and respond to rotate/flip, etc.

More complex interactive processes are not supported here, you should implement a customised event loop for those.

Parameters

aItemCreator	the callable that will attempt to create the item
aCommitMessage	the message used on a successful commit

Definition at line 41 of file pcb_tool_base.cpp.

{
 using namespace std::placeholders;
 std::unique_ptr<BOARD_ITEM> newItem;
 
 frame()->PushTool( aTool );
 
 BOARD_COMMIT commit( frame() );
 
 GetManager()->RunAction( PCB_ACTIONS::selectionClear, true );
 
 Activate();
 // Must be done after Activate() so that it gets set into the correct context
 controls()->ShowCursor( true );
 controls()->ForceCursorPosition( false );
 // do not capture or auto-pan until we start placing an item
 
 PCB_GRID_HELPER grid( m_toolMgr, frame()->GetMagneticItemsSettings() );
 
 // Add a VIEW_GROUP that serves as a preview for the new item
 PCB_SELECTION preview;
 view()->Add( &preview );
 
 aPlacer->m_board = board();
 aPlacer->m_frame = frame();
 aPlacer->m_modifiers = 0;
 
 auto makeNewItem =
 [&]( VECTOR2I aPosition )
 {
 if( frame()->GetModel() )
 newItem = aPlacer->CreateItem();
 
 if( newItem )
 {
 newItem->SetPosition( aPosition );
 preview.Add( newItem.get() );
 
 if( newItem->Type() == PCB_FOOTPRINT_T )
 {
 FOOTPRINT* fp = dyn_cast<FOOTPRINT*>( newItem.get() );
 
 // footprints have more drawable parts
 fp->RunOnChildren( std::bind( &KIGFX::VIEW_GROUP::Add, &preview, _1 ) );
 }
 }
 };
 
 if( aOptions & IPO_SINGLE_CLICK )
 makeNewItem( controls()->GetCursorPosition() );
 
 auto setCursor =
 [&]()
 {
 if( !newItem )
 frame()->GetCanvas()->SetCurrentCursor( KICURSOR::PENCIL );
 else
 frame()->GetCanvas()->SetCurrentCursor( KICURSOR::PLACE );
 };
 
 // Set initial cursor
 setCursor();
 
 // Main loop: keep receiving events
 while( TOOL_EVENT* evt = Wait() )
 {
 setCursor();
 
 grid.SetSnap( false ); // Interactive placement tools need to set their own item snaps
 grid.SetUseGrid( getView()->GetGAL()->GetGridSnapping() && !evt->DisableGridSnapping() );
 VECTOR2I cursorPos = grid.BestSnapAnchor( controls()->GetMousePosition(), nullptr );
 
 aPlacer->m_modifiers = evt->Modifier();
 
 auto cleanup =
 [&] ()
 {
 newItem = nullptr;
 preview.Clear();
 view()->Update( &preview );
 controls()->SetAutoPan( false );
 controls()->CaptureCursor( false );
 controls()->ShowCursor( true );
  controls()->ForceCursorPosition( false );
 };
 
 if( evt->IsCancelInteractive() )
 {
 if( aOptions & IPO_SINGLE_CLICK )
 {
 cleanup();
 frame()->PopTool( aTool );
 break;
 }
 else if( newItem )
 {
 cleanup();
 }
 else
 {
 frame()->PopTool( aTool );
 break;
 }
 }
 else if( evt->IsActivate() )
 {
 if( newItem )
 cleanup();
 
 if( evt->IsPointEditor() )
 {
 // don't exit (the point editor runs in the background)
 }
 else if( evt->IsMoveTool() )
 {
 // leave ourselves on the stack so we come back after the move
 break;
 }
 else
 {
 frame()->PopTool( aTool );
 break;
 }
 }
 else if( evt->IsClick( BUT_LEFT ) || evt->IsDblClick( BUT_LEFT ) )
 {
 if( !newItem )
 {
 // create the item if possible
 makeNewItem( cursorPos );
 
 // no item created, so wait for another click
 if( !newItem )
 continue;
 
 controls()->CaptureCursor( true );
 controls()->SetAutoPan( true );
 }
 else
 {
 BOARD_ITEM* newBoardItem = newItem.release();
 EDA_ITEM_FLAGS oldFlags = newBoardItem->GetFlags();
 
 newBoardItem->ClearFlags();
 
 if( !aPlacer->PlaceItem( newBoardItem, commit ) )
 {
 newBoardItem->SetFlags( oldFlags );
 newItem.reset( newBoardItem );
 continue;
 }
 
 preview.Clear();
 commit.Push( aCommitMessage );
 
 controls()->CaptureCursor( false );
 controls()->SetAutoPan( false );
 controls()->ShowCursor( true );
 
 if( !( aOptions & IPO_REPEAT ) )
 break;
 
 if( aOptions & IPO_SINGLE_CLICK )
 makeNewItem( controls()->GetCursorPosition() );
 
 setCursor();
 }
 }
 else if( evt->IsClick( BUT_RIGHT ) )
 {
 m_menu.ShowContextMenu( selection() );
 }
 else if( evt->IsAction( &PCB_ACTIONS::trackViaSizeChanged ) )
 {
 m_toolMgr->RunAction( ACTIONS::refreshPreview );
 }
 else if( newItem && evt->Category() == TC_COMMAND )
 {
 /*
 * Handle any events that can affect the item as we move it around
 */
 if( TOOL_EVT_UTILS::IsRotateToolEvt( *evt ) && ( aOptions & IPO_ROTATE ) )
 {
 EDA_ANGLE rotationAngle = TOOL_EVT_UTILS::GetEventRotationAngle( *frame(), *evt );
 newItem->Rotate( newItem->GetPosition(), rotationAngle );
 view()->Update( &preview );
 }
 else if( evt->IsAction( &PCB_ACTIONS::flip ) && ( aOptions & IPO_FLIP ) )
 {
 newItem->Flip( newItem->GetPosition(), frame()->GetPcbNewSettings()->m_FlipLeftRight );
 view()->Update( &preview );
 }
 else if( evt->IsAction( &PCB_ACTIONS::properties ) )
 {
 frame()->OnEditItemRequest( newItem.get() );
 
 // Notify other tools of the changes
 m_toolMgr->ProcessEvent( EVENTS::SelectedItemsModified );
 }
 else if( evt->IsAction( &ACTIONS::refreshPreview ) )
 {
 preview.Clear();
 newItem.reset();
 
 makeNewItem( cursorPos );
 aPlacer->SnapItem( newItem.get() );
 view()->Update( &preview );
 }
 else
 {
 evt->SetPassEvent();
 }
 }
 else if( newItem && evt->IsMotion() )
 {
 // track the cursor
 newItem->SetPosition( cursorPos );
 aPlacer->SnapItem( newItem.get() );
 
 // Show a preview of the item
 view()->Update( &preview );
 }
 else
 {
 evt->SetPassEvent();
 }
 }
 
 view()->Remove( &preview );
 frame()->GetCanvas()->SetCurrentCursor( KICURSOR::ARROW );
 controls()->SetAutoPan( false );
 controls()->CaptureCursor( false );
 controls()->ForceCursorPosition( false );
}

References TOOL_INTERACTIVE::Activate(), SELECTION::Add(), KIGFX::VIEW_GROUP::Add(), KIGFX::PCB_VIEW::Add(), ARROW, PCB_TOOL_BASE::board(), BUT_LEFT, BUT_RIGHT, KIGFX::VIEW_CONTROLS::CaptureCursor(), SELECTION::Clear(), EDA_ITEM::ClearFlags(), PCB_TOOL_BASE::controls(), INTERACTIVE_PLACER_BASE::CreateItem(), PCB_ACTIONS::flip, KIGFX::VIEW_CONTROLS::ForceCursorPosition(), PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetCanvas(), TOOL_EVT_UTILS::GetEventRotationAngle(), EDA_ITEM::GetFlags(), TOOL_BASE::GetManager(), PCB_BASE_FRAME::GetModel(), TOOL_BASE::getView(), grid, PCB_TOOL_BASE::IPO_FLIP, PCB_TOOL_BASE::IPO_REPEAT, PCB_TOOL_BASE::IPO_ROTATE, PCB_TOOL_BASE::IPO_SINGLE_CLICK, TOOL_EVT_UTILS::IsRotateToolEvt(), INTERACTIVE_PLACER_BASE::m_board, INTERACTIVE_PLACER_BASE::m_frame, TOOL_INTERACTIVE::m_menu, INTERACTIVE_PLACER_BASE::m_modifiers, TOOL_BASE::m_toolMgr, PCB_BASE_EDIT_FRAME::OnEditItemRequest(), PCB_FOOTPRINT_T, PENCIL, PLACE, INTERACTIVE_PLACER_BASE::PlaceItem(), TOOLS_HOLDER::PopTool(), TOOL_MANAGER::ProcessEvent(), PCB_ACTIONS::properties, BOARD_COMMIT::Push(), TOOLS_HOLDER::PushTool(), ACTIONS::refreshPreview, KIGFX::PCB_VIEW::Remove(), TOOL_MANAGER::RunAction(), FOOTPRINT::RunOnChildren(), EVENTS::SelectedItemsModified, PCB_TOOL_BASE::selection(), PCB_ACTIONS::selectionClear, KIGFX::VIEW_CONTROLS::SetAutoPan(), EDA_DRAW_PANEL_GAL::SetCurrentCursor(), EDA_ITEM::SetFlags(), TOOL_MENU::ShowContextMenu(), KIGFX::VIEW_CONTROLS::ShowCursor(), INTERACTIVE_PLACER_BASE::SnapItem(), TC_COMMAND, PCB_ACTIONS::trackViaSizeChanged, KIGFX::PCB_VIEW::Update(), PCB_TOOL_BASE::view(), and TOOL_INTERACTIVE::Wait().

Referenced by MICROWAVE_TOOL::addMicrowaveFootprint(), DRAWING_TOOL::DrawVia(), and PAD_TOOL::PlacePad().

DpDimensionsDialog()

int ROUTER_TOOL::DpDimensionsDialog

(

const TOOL_EVENT &

aEvent

)

Definition at line 1463 of file router_tool.cpp.

{
 PNS::SIZES_SETTINGS sizes = m_router->Sizes();
 DIALOG_PNS_DIFF_PAIR_DIMENSIONS settingsDlg( frame(), sizes );
 
 if( settingsDlg.ShowModal() == wxID_OK )
 {
 m_router->UpdateSizes( sizes );
 m_savedSizes = sizes;
 
 BOARD_DESIGN_SETTINGS& bds = frame()->GetBoard()->GetDesignSettings();
 bds.SetCustomDiffPairWidth( sizes.DiffPairWidth() );
 bds.SetCustomDiffPairGap( sizes.DiffPairGap() );
 bds.SetCustomDiffPairViaGap( sizes.DiffPairViaGap() );
 }
 
 return 0;
}

References PNS::SIZES_SETTINGS::DiffPairGap(), PNS::SIZES_SETTINGS::DiffPairViaGap(), PNS::SIZES_SETTINGS::DiffPairWidth(), PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetBoard(), BOARD::GetDesignSettings(), PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_savedSizes, BOARD_DESIGN_SETTINGS::SetCustomDiffPairGap(), BOARD_DESIGN_SETTINGS::SetCustomDiffPairViaGap(), BOARD_DESIGN_SETTINGS::SetCustomDiffPairWidth(), PNS::ROUTER::Sizes(), and PNS::ROUTER::UpdateSizes().

Referenced by setTransitions().

finishInteractive()

bool ROUTER_TOOL::finishInteractive ( )

private

Definition at line 1253 of file router_tool.cpp.

{
 m_router->StopRouting();
 
 m_startItem = nullptr;
 m_endItem = nullptr;
 
 frame()->SetActiveLayer( m_originalActiveLayer );
 UpdateMessagePanel();
 frame()->GetCanvas()->SetCurrentCursor( KICURSOR::ARROW );
 controls()->SetAutoPan( false );
 controls()->ForceCursorPosition( false );
 frame()->UndoRedoBlock( false );
 highlightNets( false );
 
 return true;
}

References ARROW, PCB_TOOL_BASE::controls(), KIGFX::VIEW_CONTROLS::ForceCursorPosition(), PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetCanvas(), PNS::TOOL_BASE::highlightNets(), PNS::TOOL_BASE::m_endItem, m_originalActiveLayer, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PCB_BASE_FRAME::SetActiveLayer(), KIGFX::VIEW_CONTROLS::SetAutoPan(), EDA_DRAW_PANEL_GAL::SetCurrentCursor(), PNS::ROUTER::StopRouting(), PCB_BASE_EDIT_FRAME::UndoRedoBlock(), and UpdateMessagePanel().

Referenced by performRouting().

footprint()

FOOTPRINT * PCB_TOOL_BASE::footprint ( ) const

inlineprotectedinherited

Definition at line 172 of file pcb_tool_base.h.

 {
 return board()->GetFirstFootprint();
 }

References PCB_TOOL_BASE::board(), and BOARD::GetFirstFootprint().

Referenced by PCB_CONTROL::AppendBoard(), MICROWAVE_TOOL::createBaseFootprint(), FOOTPRINT_EDITOR_CONTROL::CreateFootprint(), MICROWAVE_TOOL::createFootprint(), MICROWAVE_TOOL::createMicrowaveInductor(), EDIT_TOOL::doMoveSelection(), DRAWING_TOOL::DrawSpecificationStackup(), DRAWING_TOOL::DrawVia(), FOOTPRINT_EDITOR_CONTROL::DuplicateFootprint(), GLOBAL_EDIT_TOOL::ExchangeFootprints(), BOARD_EDITOR_CONTROL::ExportNetlist(), InlineDrag(), BOARD_INSPECTION_TOOL::makeDRCEngine(), PCB_CONTROL::Paste(), PCB_CONTROL::placeBoardItems(), FOOTPRINT_EDITOR_CONTROL::Properties(), PAD_TOOL::pushPadSettings(), PAD_TOOL::RecombinePad(), FOOTPRINT_EDITOR_CONTROL::RenameFootprint(), BOARD_EDITOR_CONTROL::RepairBoard(), FOOTPRINT_EDITOR_CONTROL::RepairFootprint(), FOOTPRINT_EDITOR_CONTROL::Save(), FOOTPRINT_EDITOR_CONTROL::SaveAs(), and DRAWING_TOOL::SetAnchor().

frame()

PCB_BASE_EDIT_FRAME * PCB_TOOL_BASE::frame ( ) const

inlineprotectedinherited

Definition at line 165 of file pcb_tool_base.h.

 {
 return getEditFrame<PCB_BASE_EDIT_FRAME>();
 }

Referenced by PCB_POINT_EDITOR::addCorner(), AUTOPLACE_TOOL::autoplace(), PCB_TOOL_BASE::canvas(), ZONE_FILLER_TOOL::CheckAllZones(), PNS::TOOL_BASE::checkSnap(), PAD_TOOL::copyPadSettings(), EDIT_TOOL::copyToClipboard(), CustomTrackWidthDialog(), FOOTPRINT_EDITOR_CONTROL::DeleteFootprint(), EDIT_TOOL::DeleteItems(), PCB_TOOL_BASE::displayOptions(), BOARD_EDITOR_CONTROL::doCrossProbePcbToSch(), PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), DpDimensionsDialog(), EDIT_TOOL::DragArcTrack(), DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawDimension(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::drawShape(), DRAWING_TOOL::DrawVia(), DRAWING_TOOL::DrawZone(), PAD_TOOL::EditPad(), PAD_TOOL::EnumeratePads(), PAD_TOOL::explodePad(), BOARD_EDITOR_CONTROL::ExportSpecctraDSN(), ZONE_FILLER_TOOL::FillAllZones(), EDIT_TOOL::FilletTracks(), finishInteractive(), EDIT_TOOL::Flip(), PCB_CONTROL::FlipPcbView(), GLOBAL_EDIT_TOOL::GlobalDeletions(), handleLayerSwitch(), PCB_CONTROL::HighContrastMode(), PCB_CONTROL::HighContrastModeCycle(), BOARD_INSPECTION_TOOL::HighlightItem(), FOOTPRINT_EDITOR_CONTROL::ImportFootprint(), BOARD_EDITOR_CONTROL::ImportSpecctraSession(), SCRIPTING_TOOL::Init(), Init(), EDIT_TOOL::Init(), InlineBreakTrack(), InlineDrag(), DRAWING_TOOL::InteractivePlaceWithPreview(), PCB_TOOL_BASE::Is45Limited(), PCB_PICKER_TOOL::Main(), LENGTH_TUNER_TOOL::MainLoop(), MainLoop(), LENGTH_TUNER_TOOL::meanderSettingsDialog(), EDIT_TOOL::MoveExact(), PCB_CONTROL::NetColorModeCycle(), PCB_POINT_EDITOR::OnSelectionChange(), onViaCommand(), PCB_CONTROL::Paste(), PAD_TOOL::pastePadProperties(), performDragging(), performRouting(), LENGTH_TUNER_TOOL::performTuning(), GROUP_TOOL::PickNewMember(), PNS::TOOL_BASE::pickSingleItem(), BOARD_EDITOR_CONTROL::PlaceFootprint(), DRAWING_TOOL::PlaceText(), prepareInteractive(), PCB_CONTROL::pruneItemLayers(), PAD_TOOL::pushPadSettings(), PCB_CONTROL::RatsnestModeCycle(), POSITION_RELATIVE_TOOL::RelativeItemSelectionMove(), SCRIPTING_TOOL::reloadPlugins(), PCB_POINT_EDITOR::removeCorner(), PNS::TOOL_BASE::Reset(), PAD_TOOL::Reset(), EDIT_TOOL::Rotate(), RouteSelected(), SelectCopperLayerPair(), POSITION_RELATIVE_TOOL::SelectPositionRelativeItem(), PCB_POINT_EDITOR::setEditedPoint(), SettingsDialog(), GLOBAL_EDIT_TOOL::swapBoardItem(), GLOBAL_EDIT_TOOL::SwapLayers(), switchLayerOnViaPlacement(), DRAWING_TOOL::ToggleHV45Mode(), PCB_CONTROL::ToggleRatsnest(), PCB_CONTROL::unfilledZoneCheck(), PCB_POINT_EDITOR::updateItem(), UpdateMessagePanel(), EDIT_TOOL::updateModificationPoint(), BOARD_EDITOR_CONTROL::UpdateSchematicFromPCB(), PCB_CONTROL::ZoneDisplayMode(), ZONE_FILLER_TOOL::ZoneFill(), ZONE_FILLER_TOOL::ZoneFillAll(), and ZONE_FILLER_TOOL::ZoneFillDirty().

getEditFrame()

template<typename T >

T * TOOL_BASE::getEditFrame ( ) const

inlineprotectedinherited

Return the application window object, casted to requested user type.

Definition at line 185 of file tool_base.h.

 {
#if !defined( QA_TEST ) // Dynamic casts give the linker a seizure in the test framework
 wxASSERT( dynamic_cast<T*>( getToolHolderInt() ) );
#endif
 return static_cast<T*>( getToolHolderInt() );
 }

References TOOL_BASE::getToolHolderInt().

Referenced by ZONE_CREATE_HELPER::createNewZone(), and ZONE_CREATE_HELPER::setUniquePriority().

GetId()

TOOL_ID TOOL_BASE::GetId ( ) const

inlineinherited

Return the unique identifier of the tool.

The identifier is set by an instance of TOOL_MANAGER.

Returns

Identifier of the tool.

Definition at line 121 of file tool_base.h.

 {
 return m_toolId;
 }

References TOOL_BASE::m_toolId.

Referenced by TOOL_MANAGER::finishTool(), TOOL_MANAGER::InitTools(), TOOL_MANAGER::isActive(), TOOL_MANAGER::RegisterTool(), ACTION_MANAGER::RunHotKey(), TOOL_MANAGER::runTool(), TOOL_MANAGER::saveViewControls(), and TOOL_MANAGER::ShutdownTool().

GetManager()

TOOL_MANAGER * TOOL_BASE::GetManager ( ) const

inlineinherited

Return the instance of TOOL_MANAGER that takes care of the tool.

Returns

Instance of the TOOL_MANAGER or NULL if there is no associated tool manager.

Definition at line 144 of file tool_base.h.

 {
 return m_toolMgr;
 }

References TOOL_BASE::m_toolMgr.

Referenced by BOARD_COMMIT::BOARD_COMMIT(), ZONE_CREATE_HELPER::commitZone(), ZONE_CREATE_HELPER::createNewZone(), PNS_KICAD_IFACE::DisplayItem(), PCB_TOOL_BASE::doInteractiveItemPlacement(), ACTION_MENU::getToolManager(), PNS_KICAD_IFACE::GetUnits(), ZONE_CREATE_HELPER::OnFirstPoint(), ACTION_MENU::OnMenuEvent(), and ZONE_CREATE_HELPER::performZoneCutout().

getModel()

template<typename T >

T * TOOL_BASE::getModel ( ) const

inlineprotectedinherited

Return the model object if it matches the requested type.

Store the type of the tool.

Definition at line 197 of file tool_base.h.

References TOOL_BASE::getModelInt().

Referenced by ZONE_CREATE_HELPER::commitZone(), and ZONE_CREATE_HELPER::createZoneFromExisting().

getModelInt()

EDA_ITEM * TOOL_BASE::getModelInt ( ) const

privateinherited

Definition at line 54 of file tool_base.cpp.

{
 return m_toolMgr->GetModel();
}

References TOOL_MANAGER::GetModel(), and TOOL_BASE::m_toolMgr.

Referenced by TOOL_BASE::getModel().

GetName()

const std::string & TOOL_BASE::GetName ( void  ) const

inlineinherited

Return the name of the tool.

Tool names are expected to obey the format: application.ToolName (eg. pcbnew.InteractiveSelection).

Returns

The name of the tool.

Definition at line 134 of file tool_base.h.

 {
 return m_toolName;
 }

References TOOL_BASE::m_toolName.

Referenced by TOOL_MANAGER::dispatchInternal(), TOOL_MANAGER::InitTools(), TOOL_MANAGER::invokeTool(), TOOL_MANAGER::RegisterTool(), TOOL_MANAGER::runTool(), and TOOL_MANAGER::ShutdownTool().

getNearestRatnestAnchor()

bool ROUTER_TOOL::getNearestRatnestAnchor ( VECTOR2I &  aPoint, LAYER_RANGE &  aLayers  )

private

GetRouterMode()

PNS::PNS_MODE ROUTER_TOOL::GetRouterMode

(

)

Definition at line 1524 of file router_tool.cpp.

{
 return m_router->Settings().Mode();
}

References PNS::TOOL_BASE::m_router, PNS::ROUTING_SETTINGS::Mode(), and PNS::ROUTER::Settings().

Referenced by PCB_EDIT_FRAME::setupUIConditions().

getStartLayer()

int ROUTER_TOOL::getStartLayer ( const PNS::ITEM *  aItem )

private

Definition at line 660 of file router_tool.cpp.

{
 int tl = getView()->GetTopLayer();
 
 if( m_startItem )
 {
 const LAYER_RANGE& ls = m_startItem->Layers();
 
 if( ls.Overlaps( tl ) )
 return tl;
 else
 return ls.Start();
 }
 
 return tl;
}

References KIGFX::VIEW::GetTopLayer(), TOOL_BASE::getView(), PNS::ITEM::Layers(), PNS::TOOL_BASE::m_startItem, LAYER_RANGE::Overlaps(), and LAYER_RANGE::Start().

Referenced by prepareInteractive().

getToolHolderInt()

TOOLS_HOLDER * TOOL_BASE::getToolHolderInt ( ) const

privateinherited

Definition at line 48 of file tool_base.cpp.

{
 return m_toolMgr->GetToolHolder();
}

References TOOL_MANAGER::GetToolHolder(), and TOOL_BASE::m_toolMgr.

Referenced by TOOL_BASE::getEditFrame().

GetToolMenu()

TOOL_MENU & TOOL_INTERACTIVE::GetToolMenu ( )

inlineinherited

Definition at line 77 of file tool_interactive.h.

{ return m_menu; }

References TOOL_INTERACTIVE::m_menu.

Referenced by EE_INSPECTION_TOOL::Init(), EE_POINT_EDITOR::Init(), SCH_EDIT_TOOL::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), SCH_MOVE_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), SYMBOL_EDITOR_MOVE_TOOL::Init(), SYMBOL_EDITOR_PIN_TOOL::Init(), PL_EDIT_TOOL::Init(), BOARD_EDITOR_CONTROL::Init(), BOARD_INSPECTION_TOOL::Init(), CONVERT_TOOL::Init(), EDIT_TOOL::Init(), GROUP_TOOL::Init(), PAD_TOOL::Init(), PCB_POINT_EDITOR::Init(), and ALIGN_DISTRIBUTE_TOOL::Init().

GetType()

TOOL_TYPE TOOL_BASE::GetType ( ) const

inlineinherited

Return the type of the tool.

Returns

The type of the tool.

Definition at line 109 of file tool_base.h.

 {
 return m_type;
 }

References TOOL_BASE::m_type.

Referenced by TOOL_MANAGER::finishTool(), TOOL_MANAGER::InvokeTool(), TOOL_MANAGER::ResetTools(), TOOL_MANAGER::runTool(), and TOOL_MANAGER::ShutdownTool().

getView()

KIGFX::VIEW * TOOL_BASE::getView ( ) const

protectedinherited

Returns the instance of #VIEW object used in the application.

It allows tools to draw.

Returns

The instance of VIEW.

Definition at line 36 of file tool_base.cpp.

{
 return m_toolMgr->GetView();
}

References TOOL_MANAGER::GetView(), and TOOL_BASE::m_toolMgr.

Referenced by EE_POINT_EDITOR::addCornerCondition(), ALIGN_DISTRIBUTE_TOOL::AlignLeft(), ALIGN_DISTRIBUTE_TOOL::AlignRight(), COMMON_TOOLS::CenterContents(), SCH_EDIT_TOOL::ChangeTextType(), EE_INSPECTION_TOOL::CheckSymbol(), GERBVIEW_CONTROL::ClearAllLayers(), PL_SELECTION_TOOL::ClearSelection(), EE_SELECTION_TOOL::ClearSelection(), EE_SELECTION_TOOL::CollectHits(), SCH_LINE_WIRE_BUS_TOOL::computeBreakPoint(), COMMON_TOOLS::CursorControl(), SCH_EDIT_TOOL::DeleteItemCursor(), PL_EDIT_TOOL::DeleteItemCursor(), PCB_CONTROL::DeleteItemCursor(), EDIT_TOOL::DeleteItems(), PL_EDIT_TOOL::DoDelete(), SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), SELECTION_TOOL::doSelectionMenu(), COMMON_TOOLS::doZoomFit(), COMMON_TOOLS::doZoomInOut(), COMMON_TOOLS::doZoomToPreset(), EDIT_TOOL::DragArcTrack(), DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawDimension(), MICROWAVE_TOOL::drawMicrowaveInductor(), SCH_LINE_WIRE_BUS_TOOL::DrawSegments(), PL_DRAWING_TOOLS::DrawShape(), DRAWING_TOOL::drawShape(), DRAWING_TOOL::DrawZone(), BOARD_EDITOR_CONTROL::DrillOrigin(), SYMBOL_EDITOR_EDIT_TOOL::Duplicate(), PAD_TOOL::EnumeratePads(), EE_SELECTION_TOOL::GetNode(), getStartLayer(), PCB_CONTROL::GridResetOrigin(), PCB_CONTROL::GridSetOrigin(), EE_SELECTION_TOOL::GuessSelectionCandidates(), PCB_SELECTION_TOOL::GuessSelectionCandidates(), handleCommonEvents(), EE_SELECTION_TOOL::highlight(), PL_SELECTION_TOOL::highlight(), PCB_SELECTION_TOOL::highlight(), GERBVIEW_CONTROL::HighlightControl(), BOARD_INSPECTION_TOOL::highlightNet(), PNS::TOOL_BASE::highlightNets(), PCB_SELECTION_TOOL::hitTestDistance(), SCH_EDIT_TOOL::Init(), EDIT_TOOL::Init(), InlineDrag(), EE_POINT_EDITOR::Main(), SCH_MOVE_TOOL::Main(), PL_POINT_EDITOR::Main(), PCB_PICKER_TOOL::Main(), GERBVIEW_INSPECTION_TOOL::MeasureTool(), PCB_VIEWER_TOOLS::MeasureTool(), SCH_EDIT_TOOL::Mirror(), EDIT_TOOL::MoveExact(), PL_EDIT_TOOL::moveItem(), COMMON_TOOLS::OnGridChanged(), PCB_POINT_EDITOR::OnSelectionChange(), COMMON_TOOLS::PanControl(), SCH_EDITOR_CONTROL::Paste(), SYMBOL_EDITOR_EDIT_TOOL::Paste(), PL_EDIT_TOOL::Paste(), performRouting(), PNS::TOOL_BASE::pickSingleItem(), BOARD_EDITOR_CONTROL::PlaceFootprint(), DRAWING_TOOL::PlaceImage(), DRAWING_TOOL::PlaceImportedGraphics(), PL_DRAWING_TOOLS::PlaceItem(), SCH_DRAWING_TOOLS::PlaceSymbol(), DRAWING_TOOL::PlaceText(), prepareInteractive(), SCH_EDIT_TOOL::Properties(), EDIT_TOOL::Properties(), EE_SELECTION_TOOL::Reset(), EE_TOOL_BASE< T >::Reset(), GERBVIEW_SELECTION_TOOL::Reset(), PNS::TOOL_BASE::Reset(), BOARD_EDITOR_CONTROL::Reset(), DRAWING_TOOL::Reset(), PCB_CONTROL::Reset(), PCB_SELECTION_TOOL::Reset(), SCH_EDIT_TOOL::Rotate(), GERBVIEW_SELECTION_TOOL::select(), PCB_SELECTION_TOOL::Selectable(), EE_SELECTION_TOOL::SelectAll(), PCB_SELECTION_TOOL::SelectAll(), EE_SELECTION_TOOL::selectionContains(), PL_SELECTION_TOOL::selectionContains(), PCB_SELECTION_TOOL::selectionContains(), EE_SELECTION_TOOL::selectMultiple(), PL_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::selectMultiple(), PL_SELECTION_TOOL::SelectPoint(), EE_SELECTION_TOOL::selectPoint(), ZOOM_TOOL::selectRegion(), GERBVIEW_SELECTION_TOOL::selectVisually(), DRAWING_TOOL::SetAnchor(), SCH_DRAWING_TOOLS::SingleClickPlace(), SCH_EDITOR_CONTROL::ToggleERCErrors(), SCH_EDITOR_CONTROL::ToggleERCExclusions(), SCH_EDITOR_CONTROL::ToggleERCWarnings(), SCH_EDITOR_CONTROL::ToggleHiddenFields(), SCH_EDITOR_CONTROL::ToggleHiddenPins(), SCH_EDITOR_CONTROL::ToggleOPCurrents(), SCH_EDITOR_CONTROL::ToggleOPVoltages(), SCH_DRAWING_TOOLS::TwoClickPlace(), SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace(), EE_SELECTION_TOOL::unhighlight(), PL_SELECTION_TOOL::unhighlight(), PCB_SELECTION_TOOL::unhighlight(), GERBVIEW_SELECTION_TOOL::unselect(), GERBVIEW_SELECTION_TOOL::unselectVisually(), EE_POINT_EDITOR::updateEditedPoint(), PL_POINT_EDITOR::updateEditedPoint(), PCB_POINT_EDITOR::updateEditedPoint(), SCH_FIND_REPLACE_TOOL::UpdateFind(), PL_POINT_EDITOR::updateItem(), PCB_POINT_EDITOR::updateItem(), EE_TOOL_BASE< T >::updateItem(), SCH_EDITOR_CONTROL::UpdateNetHighlighting(), EE_POINT_EDITOR::updatePoints(), PL_POINT_EDITOR::updatePoints(), PCB_POINT_EDITOR::updatePoints(), PCB_SELECTION_TOOL::updateSelection(), PNS::TOOL_BASE::updateStartItem(), PCB_SELECTION_TOOL::view(), PCB_TOOL_BASE::view(), PCB_VIEWER_TOOLS::view(), EE_SELECTION_TOOL::ZoomFitCrossProbeBBox(), PCB_SELECTION_TOOL::ZoomFitCrossProbeBBox(), PCB_SELECTION_TOOL::zoomFitSelection(), EE_SELECTION_TOOL::~EE_SELECTION_TOOL(), GERBVIEW_SELECTION_TOOL::~GERBVIEW_SELECTION_TOOL(), and PCB_SELECTION_TOOL::~PCB_SELECTION_TOOL().

getViewControls()

KIGFX::VIEW_CONTROLS * TOOL_BASE::getViewControls ( ) const

protectedinherited

Return the instance of VIEW_CONTROLS object used in the application.

It allows tools to read & modify user input and its settings (eg. show cursor, enable snapping to grid, etc.).

Returns

The instance of VIEW_CONTROLS.

Definition at line 42 of file tool_base.cpp.

{
 return m_toolMgr->GetViewControls();
}

References TOOL_MANAGER::GetViewControls(), and TOOL_BASE::m_toolMgr.

Referenced by EE_POINT_EDITOR::addCorner(), PCB_POINT_EDITOR::addCorner(), EE_POINT_EDITOR::addCornerCondition(), EE_SELECTION_TOOL::autostartEvent(), SCH_EDIT_TOOL::BreakWire(), PCB_SELECTION_TOOL::controls(), PCB_TOOL_BASE::controls(), EDIT_TOOL::copyToClipboard(), COMMON_TOOLS::CursorControl(), EDIT_TOOL::DeleteItems(), SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), EDIT_TOOL::doMoveSelection(), SCH_LINE_WIRE_BUS_TOOL::doUnfoldBus(), COMMON_TOOLS::doZoomToPreset(), EDIT_TOOL::DragArcTrack(), DRAWING_TOOL::DrawCircle(), DRAWING_TOOL::DrawLine(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::DrawRectangle(), SCH_DRAWING_TOOLS::DrawShape(), SYMBOL_EDITOR_DRAWING_TOOLS::DrawShape(), PL_DRAWING_TOOLS::DrawShape(), SCH_DRAWING_TOOLS::DrawSheet(), SYMBOL_EDITOR_EDIT_TOOL::Duplicate(), PAD_TOOL::EnumeratePads(), SCH_LINE_WIRE_BUS_TOOL::finishSegments(), SCH_EDITOR_CONTROL::HighlightNet(), BOARD_INSPECTION_TOOL::HighlightNet(), FOOTPRINT_EDITOR_CONTROL::ImportFootprint(), SCH_EDIT_TOOL::Init(), EDIT_TOOL::Init(), EE_POINT_EDITOR::Main(), EE_SELECTION_TOOL::Main(), SCH_MOVE_TOOL::Main(), SYMBOL_EDITOR_MOVE_TOOL::Main(), PICKER_TOOL::Main(), PL_EDIT_TOOL::Main(), PL_POINT_EDITOR::Main(), PCB_PICKER_TOOL::Main(), MainLoop(), GERBVIEW_INSPECTION_TOOL::MeasureTool(), PCB_VIEWER_TOOLS::MeasureTool(), COMMON_TOOLS::OnGridChanged(), PCB_POINT_EDITOR::OnSelectionChange(), SCH_EDITOR_CONTROL::Paste(), SYMBOL_EDITOR_EDIT_TOOL::Paste(), performDragging(), LENGTH_TUNER_TOOL::performTuning(), SYMBOL_EDITOR_DRAWING_TOOLS::PlaceAnchor(), PCB_CONTROL::placeBoardItems(), BOARD_EDITOR_CONTROL::PlaceFootprint(), SCH_DRAWING_TOOLS::PlaceImage(), DRAWING_TOOL::PlaceImage(), PL_DRAWING_TOOLS::PlaceItem(), SCH_DRAWING_TOOLS::PlaceSymbol(), SCH_EDIT_TOOL::Properties(), EDIT_TOOL::Properties(), SCH_EDIT_TOOL::RepeatDrawItem(), PL_SELECTION_TOOL::RequestSelection(), EE_SELECTION_TOOL::RequestSelection(), DRAWING_TOOL::Reset(), PCB_POINT_EDITOR::Reset(), COMMON_TOOLS::ResetLocalCoords(), RouteSelected(), PCB_SELECTION_TOOL::selectCursor(), EE_SELECTION_TOOL::selectMultiple(), PL_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::selectMultiple(), EE_SELECTION_TOOL::SelectNode(), ZOOM_TOOL::selectRegion(), ALIGN_DISTRIBUTE_TOOL::selectTarget(), PICKER_TOOL::setControls(), PCB_PICKER_TOOL::setControls(), EE_POINT_EDITOR::setEditedPoint(), PL_POINT_EDITOR::setEditedPoint(), PCB_POINT_EDITOR::setEditedPoint(), SCH_DRAWING_TOOLS::SingleClickPlace(), SCH_DRAWING_TOOLS::TwoClickPlace(), SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace(), EE_POINT_EDITOR::updateEditedPoint(), PL_POINT_EDITOR::updateEditedPoint(), PCB_POINT_EDITOR::updateEditedPoint(), PCB_POINT_EDITOR::updateItem(), PL_EDIT_TOOL::updateModificationPoint(), and COMMON_TOOLS::ZoomCenter().

Go()

template<class T >

void TOOL_INTERACTIVE::Go ( int(T::*)(const TOOL_EVENT &)  aStateFunc, const TOOL_EVENT_LIST &  aConditions = TOOL_EVENT( TC_ANY, TA_ANY )  )

inherited

Define which state (aStateFunc) to go when a certain event arrives (aConditions).

No conditions means any event.

Definition at line 147 of file tool_interactive.h.

{
 TOOL_STATE_FUNC sptr = std::bind( aStateFunc, static_cast<T*>( this ), std::placeholders::_1 );
 
 goInternal( sptr, aConditions );
}

References TOOL_INTERACTIVE::goInternal().

Referenced by EDA_3D_CONTROLLER::setTransitions(), CVPCB_ASSOCIATION_TOOL::setTransitions(), CVPCB_CONTROL::setTransitions(), CVPCB_FOOTPRINT_VIEWER_SELECTION_TOOL::setTransitions(), EE_INSPECTION_TOOL::setTransitions(), EE_POINT_EDITOR::setTransitions(), EE_SELECTION_TOOL::setTransitions(), SCH_DRAWING_TOOLS::setTransitions(), SCH_EDIT_TOOL::setTransitions(), SCH_EDITOR_CONTROL::setTransitions(), SCH_FIND_REPLACE_TOOL::setTransitions(), SCH_LINE_WIRE_BUS_TOOL::setTransitions(), SCH_MOVE_TOOL::setTransitions(), SCH_NAVIGATE_TOOL::setTransitions(), SIMULATOR_CONTROL::setTransitions(), SYMBOL_EDITOR_CONTROL::setTransitions(), SYMBOL_EDITOR_DRAWING_TOOLS::setTransitions(), SYMBOL_EDITOR_EDIT_TOOL::setTransitions(), SYMBOL_EDITOR_MOVE_TOOL::setTransitions(), SYMBOL_EDITOR_PIN_TOOL::setTransitions(), GERBVIEW_CONTROL::setTransitions(), GERBVIEW_INSPECTION_TOOL::setTransitions(), GERBVIEW_SELECTION_TOOL::setTransitions(), COMMON_CONTROL::setTransitions(), COMMON_TOOLS::setTransitions(), PICKER_TOOL::setTransitions(), ZOOM_TOOL::setTransitions(), KICAD_MANAGER_CONTROL::setTransitions(), PL_DRAWING_TOOLS::setTransitions(), PL_EDIT_TOOL::setTransitions(), PL_EDITOR_CONTROL::setTransitions(), PL_POINT_EDITOR::setTransitions(), PL_SELECTION_TOOL::setTransitions(), AUTOPLACE_TOOL::setTransitions(), MICROWAVE_TOOL::setTransitions(), SCRIPTING_TOOL::setTransitions(), LENGTH_TUNER_TOOL::setTransitions(), setTransitions(), BOARD_EDITOR_CONTROL::setTransitions(), BOARD_INSPECTION_TOOL::setTransitions(), BOARD_REANNOTATE_TOOL::setTransitions(), CONVERT_TOOL::setTransitions(), DRAWING_TOOL::setTransitions(), DRC_TOOL::setTransitions(), EDIT_TOOL::setTransitions(), FOOTPRINT_EDITOR_CONTROL::setTransitions(), GLOBAL_EDIT_TOOL::setTransitions(), GROUP_TOOL::setTransitions(), PAD_TOOL::setTransitions(), PCB_CONTROL::setTransitions(), PCB_PICKER_TOOL::setTransitions(), PCB_POINT_EDITOR::setTransitions(), PCB_SELECTION_TOOL::setTransitions(), PCB_VIEWER_TOOLS::setTransitions(), ALIGN_DISTRIBUTE_TOOL::setTransitions(), POSITION_RELATIVE_TOOL::setTransitions(), PROPERTIES_TOOL::setTransitions(), and ZONE_FILLER_TOOL::setTransitions().

goInternal()

void TOOL_INTERACTIVE::goInternal ( TOOL_STATE_FUNC &  aState, const TOOL_EVENT_LIST &  aConditions  )

privateinherited

Definition at line 70 of file tool_interactive.cpp.

{
 m_toolMgr->ScheduleNextState( this, aState, aConditions );
}

References TOOL_BASE::m_toolMgr, and TOOL_MANAGER::ScheduleNextState().

Referenced by TOOL_INTERACTIVE::Go().

handleCommonEvents()

void ROUTER_TOOL::handleCommonEvents ( TOOL_EVENT &  evt )

private

Definition at line 633 of file router_tool.cpp.

{
 if( aEvent.Category() == TC_VIEW || aEvent.Category() == TC_MOUSE )
 {
 BOX2D viewAreaD = getView()->GetGAL()->GetVisibleWorldExtents();
 m_router->SetVisibleViewArea( BOX2I( viewAreaD.GetOrigin(), viewAreaD.GetSize() ) );
 }
 
 if( !aEvent.IsKeyPressed() )
 return;
 
 switch( aEvent.KeyCode() )
 {
 case '0':
 if( !ADVANCED_CFG::GetCfg().m_ShowRouterDebugGraphics )
 return;
 
 saveRouterDebugLog();
 aEvent.SetPassEvent( false );
 break;
 
 default:
 break;
 }
}

References TOOL_EVENT::Category(), ADVANCED_CFG::GetCfg(), KIGFX::VIEW::GetGAL(), BOX2< Vec >::GetOrigin(), BOX2< Vec >::GetSize(), TOOL_BASE::getView(), KIGFX::GAL::GetVisibleWorldExtents(), TOOL_EVENT::IsKeyPressed(), TOOL_EVENT::KeyCode(), PNS::TOOL_BASE::m_router, saveRouterDebugLog(), TOOL_EVENT::SetPassEvent(), PNS::ROUTER::SetVisibleViewArea(), TC_MOUSE, and TC_VIEW.

Referenced by InlineDrag(), performDragging(), and performRouting().

handleLayerSwitch()

int ROUTER_TOOL::handleLayerSwitch ( const TOOL_EVENT &  aEvent, bool  aForceVia  )

private

Definition at line 889 of file router_tool.cpp.

{
 wxCHECK( m_router, 0 );
 
 if( !IsToolActive() )
 return 0;
 
 // First see if this is one of the switch layer commands
 LSEQ layers = LSET( board()->GetEnabledLayers() & LSET::AllCuMask() ).Seq();
 PCB_LAYER_ID currentLayer = (PCB_LAYER_ID) m_router->GetCurrentLayer();
 PCB_LAYER_ID targetLayer = UNDEFINED_LAYER;
 
 if( aEvent.IsAction( &PCB_ACTIONS::layerNext ) )
 {
 if( m_lastTargetLayer == UNDEFINED_LAYER )
 m_lastTargetLayer = currentLayer;
 
 size_t idx = 0;
 
 for( size_t i = 0; i < layers.size(); i++ )
 {
 if( layers[i] == m_lastTargetLayer )
 {
 idx = i;
 break;
 }
 }
 
 idx = ( idx + 1 ) % layers.size();
 targetLayer = layers[idx];
 }
 else if( aEvent.IsAction( &PCB_ACTIONS::layerPrev ) )
 {
 if( m_lastTargetLayer == UNDEFINED_LAYER )
 m_lastTargetLayer = currentLayer;
 
 size_t idx = 0;
 
 for( size_t i = 0; i < layers.size(); i++ )
 {
 if( layers[i] == m_lastTargetLayer )
 {
 idx = i;
 break;
 }
 }
 
 idx = ( idx > 0 ) ? ( idx - 1 ) : ( layers.size() - 1 );
 targetLayer = layers[idx];
 }
 else
 {
 targetLayer = getTargetLayerFromEvent( aEvent );
 }
 
 if( targetLayer != UNDEFINED_LAYER )
 {
 m_lastTargetLayer = targetLayer;
 
 if( targetLayer == currentLayer )
 return 0;
 
 if( !aForceVia && m_router && m_router->SwitchLayer( targetLayer ) )
 {
 updateSizesAfterLayerSwitch( targetLayer );
 updateEndItem( aEvent );
 m_router->Move( m_endSnapPoint, m_endItem ); // refresh
 return 0;
 }
 }
 
 BOARD_DESIGN_SETTINGS& bds = board()->GetDesignSettings();
 const int layerCount = bds.GetCopperLayerCount();
 
 PCB_LAYER_ID pairTop = frame()->GetScreen()->m_Route_Layer_TOP;
 PCB_LAYER_ID pairBottom = frame()->GetScreen()->m_Route_Layer_BOTTOM;
 
 PNS::SIZES_SETTINGS sizes = m_router->Sizes();
 
 VIATYPE viaType = VIATYPE::THROUGH;
 bool selectLayer = false;
 
 // Otherwise it is one of the router-specific via commands
 if( targetLayer == UNDEFINED_LAYER )
 {
 const int actViaFlags = aEvent.Parameter<intptr_t>();
 selectLayer = actViaFlags & VIA_ACTION_FLAGS::SELECT_LAYER;
 
 viaType = getViaTypeFromFlags( actViaFlags );
 
 // ask the user for a target layer
 if( selectLayer )
 {
 wxPoint endPoint = ToWxPoint( view()->ToScreen( m_endSnapPoint ) );
 endPoint = frame()->GetCanvas()->ClientToScreen( endPoint );
 
 // Build the list of not allowed layer for the target layer
 LSET not_allowed_ly = LSET::AllNonCuMask();
 
 if( viaType != VIATYPE::THROUGH )
 not_allowed_ly.set( currentLayer );
 
 if( viaType == VIATYPE::MICROVIA )
 {
 // Allows only the previous or the next layer from the current layer
 int previous_layer = currentLayer == B_Cu ? layerCount - 2
 : currentLayer - 1;
 
 int next_layer = currentLayer >= layerCount-2 ? B_Cu
 : currentLayer + 1;
 
 not_allowed_ly = LSET::AllLayersMask();
 
  if( previous_layer >= F_Cu && previous_layer != currentLayer )
 not_allowed_ly.reset( previous_layer );
 
 if( next_layer != currentLayer )
 not_allowed_ly.reset( next_layer );
 }
 
 targetLayer = frame()->SelectOneLayer( static_cast<PCB_LAYER_ID>( currentLayer ),
 not_allowed_ly, endPoint );
 
 // Reset the cursor to the end of the track
 controls()->SetCursorPosition( m_endSnapPoint );
 
 if( targetLayer == UNDEFINED_LAYER ) // cancelled by user
 return 0;
 
 // One cannot place a blind/buried via on only one layer:
 if( viaType != VIATYPE::THROUGH )
 {
 if( currentLayer == targetLayer )
 return 0;
 }
 }
 }
 
 // fixme: P&S supports more than one fixed layer pair. Update the dialog?
 sizes.ClearLayerPairs();
 
 // Convert blind/buried via to a through hole one, if it goes through all layers
 if( viaType == VIATYPE::BLIND_BURIED
 && ( ( targetLayer == B_Cu && currentLayer == F_Cu )
 || ( targetLayer == F_Cu && currentLayer == B_Cu ) ) )
 {
 viaType = VIATYPE::THROUGH;
 }
 
 if( targetLayer == UNDEFINED_LAYER )
 {
 // Implicic layer selection
 
 switch( viaType )
 {
 case VIATYPE::THROUGH:
 // use the default layer pair
 currentLayer = pairTop;
 targetLayer = pairBottom;
 break;
 
 case VIATYPE::MICROVIA:
 // Try to use the layer pair preset, if the layers are adjacent,
 // because a microvia is usually restricted to 2 adjacent copper layers
 if( pairTop > pairBottom ) std::swap( pairTop, pairBottom );
 
 if( currentLayer == pairTop && pairBottom == pairTop+1 )
 {
 targetLayer = pairBottom;
 }
 else if( currentLayer == pairBottom && pairBottom == pairTop+1 )
 {
 targetLayer = pairTop;
 }
 else if( currentLayer == F_Cu || currentLayer == In1_Cu )
 {
 // front-side microvia
 currentLayer = F_Cu;
 
 if( layerCount > 2 ) // Ensure the inner layer In1_Cu exists
 targetLayer = In1_Cu;
 else
 targetLayer = B_Cu;
 }
 else if( currentLayer == B_Cu || currentLayer == layerCount - 2 )
 {
 // back-side microvia
 currentLayer = B_Cu,
 targetLayer = (PCB_LAYER_ID) ( layerCount - 2 );
 }
 else
 {
 // This is not optimal: from an internal layer one can want to switch
 // to the previous or the next internal layer
 // but at this point we do not know what the user want.
 targetLayer = PCB_LAYER_ID( currentLayer + 1 );
 }
 
 break;
 
 case VIATYPE::BLIND_BURIED:
 if( currentLayer == pairTop || currentLayer == pairBottom )
 {
 // the current layer is on the defined layer pair,
 // swap to the other side
 currentLayer = pairTop;
 targetLayer = pairBottom;
 }
 else
 {
 // the current layer is not part of the current layer pair,
 // so fallback and swap to the top layer of the pair by default
 targetLayer = pairTop;
 }
 
 // Do not create a broken via (i.e. a via on only one copper layer)
 if( currentLayer == targetLayer )
 {
 WX_INFOBAR* infobar = frame()->GetInfoBar();
 infobar->ShowMessageFor( _( "Blind/buried via need 2 different layers." ),
 2000, wxICON_ERROR,
 WX_INFOBAR::MESSAGE_TYPE::DRC_VIOLATION );
 return 0;
 }
 
 break;
 
 default:
 wxFAIL_MSG( wxT( "unexpected via type" ) );
 return 0;
 break;
 }
 }
 
 sizes.SetViaDiameter( bds.m_ViasMinSize );
 sizes.SetViaDrill( bds.m_MinThroughDrill );
 
 if( bds.UseNetClassVia() || viaType == VIATYPE::MICROVIA )
 {
 PCB_VIA dummyVia( board() );
 dummyVia.SetViaType( viaType );
 dummyVia.SetLayerPair( currentLayer, targetLayer );
 
 if( !m_router->GetCurrentNets().empty() )
 dummyVia.SetNetCode( m_router->GetCurrentNets()[0] );
 
 DRC_CONSTRAINT constraint;
 
 constraint = bds.m_DRCEngine->EvalRules( VIA_DIAMETER_CONSTRAINT, &dummyVia, nullptr,
 currentLayer );
 
 if( !constraint.IsNull() )
 sizes.SetViaDiameter( constraint.m_Value.Opt() );
 
 constraint = bds.m_DRCEngine->EvalRules( HOLE_SIZE_CONSTRAINT, &dummyVia, nullptr,
 currentLayer );
 
 if( !constraint.IsNull() )
 sizes.SetViaDrill( constraint.m_Value.Opt() );
 }
 else
 {
 sizes.SetViaDiameter( bds.GetCurrentViaSize() );
 sizes.SetViaDrill( bds.GetCurrentViaDrill() );
 }
 
 sizes.SetViaType( viaType );
 sizes.AddLayerPair( currentLayer, targetLayer );
 
 m_router->UpdateSizes( sizes );
 
 if( !m_router->IsPlacingVia() )
 m_router->ToggleViaPlacement();
 
 m_lastTargetLayer = targetLayer;
 
 if( m_router->RoutingInProgress() )
 {
 updateEndItem( aEvent );
 m_router->Move( m_endSnapPoint, m_endItem );
 }
 else
 {
 updateStartItem( aEvent );
 }
 
 return 0;
}

References _, PNS::SIZES_SETTINGS::AddLayerPair(), LSET::AllCuMask(), LSET::AllLayersMask(), LSET::AllNonCuMask(), B_Cu, BLIND_BURIED, PCB_TOOL_BASE::board(), PNS::SIZES_SETTINGS::ClearLayerPairs(), PCB_TOOL_BASE::controls(), WX_INFOBAR::DRC_VIOLATION, F_Cu, PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetCanvas(), BOARD_DESIGN_SETTINGS::GetCopperLayerCount(), PNS::ROUTER::GetCurrentLayer(), PNS::ROUTER::GetCurrentNets(), BOARD_DESIGN_SETTINGS::GetCurrentViaDrill(), BOARD_DESIGN_SETTINGS::GetCurrentViaSize(), BOARD::GetDesignSettings(), EDA_BASE_FRAME::GetInfoBar(), PCB_BASE_FRAME::GetScreen(), getTargetLayerFromEvent(), getViaTypeFromFlags(), HOLE_SIZE_CONSTRAINT, In1_Cu, TOOL_EVENT::IsAction(), DRC_CONSTRAINT::IsNull(), PNS::ROUTER::IsPlacingVia(), TOOL_BASE::IsToolActive(), PCB_ACTIONS::layerNext, PCB_ACTIONS::layerPrev, BOARD_DESIGN_SETTINGS::m_DRCEngine, PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, m_lastTargetLayer, BOARD_DESIGN_SETTINGS::m_MinThroughDrill, PCB_SCREEN::m_Route_Layer_BOTTOM, PCB_SCREEN::m_Route_Layer_TOP, PNS::TOOL_BASE::m_router, DRC_CONSTRAINT::m_Value, BOARD_DESIGN_SETTINGS::m_ViasMinSize, MICROVIA, PNS::ROUTER::Move(), MINOPTMAX< T >::Opt(), TOOL_EVENT::Parameter(), PNS::ROUTER::RoutingInProgress(), SELECT_LAYER, PCB_BASE_FRAME::SelectOneLayer(), LSET::Seq(), KIGFX::VIEW_CONTROLS::SetCursorPosition(), PCB_VIA::SetLayerPair(), BOARD_CONNECTED_ITEM::SetNetCode(), PNS::SIZES_SETTINGS::SetViaDiameter(), PNS::SIZES_SETTINGS::SetViaDrill(), PCB_VIA::SetViaType(), PNS::SIZES_SETTINGS::SetViaType(), WX_INFOBAR::ShowMessageFor(), PNS::ROUTER::Sizes(), PNS::ROUTER::SwitchLayer(), THROUGH, PNS::ROUTER::ToggleViaPlacement(), ToWxPoint(), UNDEFINED_LAYER, PNS::TOOL_BASE::updateEndItem(), PNS::ROUTER::UpdateSizes(), updateSizesAfterLayerSwitch(), PNS::TOOL_BASE::updateStartItem(), BOARD_DESIGN_SETTINGS::UseNetClassVia(), VIA_DIAMETER_CONSTRAINT, and PCB_TOOL_BASE::view().

Referenced by onLayerCommand(), and onViaCommand().

highlightNets()

void TOOL_BASE::highlightNets ( bool  aEnabled, std::set< int >  aNetcodes = {}  )

protectedvirtualinherited

Definition at line 224 of file pns_tool_base.cpp.

{
 RENDER_SETTINGS* rs = getView()->GetPainter()->GetSettings();
 
 if( aNetcodes.size() > 0 && aEnabled )
 {
 // If the user has previously set some of the routed nets to be highlighted,
 // we assume they want to keep them highlighted after routing
 
 const std::set<int>& currentNetCodes = rs->GetHighlightNetCodes();
 bool keep = false;
 
 for( const int& netcode : aNetcodes )
 {
 if( currentNetCodes.find( netcode ) != currentNetCodes.end() )
 {
 keep = true;
 break;
 }
 }
 
 if( rs->IsHighlightEnabled() && keep )
 m_startHighlightNetcodes = currentNetCodes;
 else
 m_startHighlightNetcodes.clear();
 
 rs->SetHighlight( aNetcodes, true );
 }
 else
 {
 rs->SetHighlight( m_startHighlightNetcodes, m_startHighlightNetcodes.size() > 0 );
 }
 
 // Do not remove this call. This is required to update the layers when we highlight a net.
 // In this case, highlighting a net dims all other elements, so the colors need to update
 getView()->UpdateAllLayersColor();
}

References KIGFX::RENDER_SETTINGS::GetHighlightNetCodes(), KIGFX::VIEW::GetPainter(), KIGFX::PAINTER::GetSettings(), TOOL_BASE::getView(), KIGFX::RENDER_SETTINGS::IsHighlightEnabled(), PNS::TOOL_BASE::m_startHighlightNetcodes, KIGFX::RENDER_SETTINGS::SetHighlight(), and KIGFX::VIEW::UpdateAllLayersColor().

Referenced by finishInteractive(), InlineDrag(), performDragging(), LENGTH_TUNER_TOOL::performTuning(), and prepareInteractive().

Init()

bool ROUTER_TOOL::Init ( )

overridevirtual

Init() is called once upon a registration of the tool.

Returns

True if the initialization went fine, false - otherwise.

Reimplemented from PCB_TOOL_BASE.

Definition at line 444 of file router_tool.cpp.

{
 m_lastTargetLayer = UNDEFINED_LAYER;
 m_originalActiveLayer = UNDEFINED_LAYER;
 
 PCB_EDIT_FRAME* frame = getEditFrame<PCB_EDIT_FRAME>();
 
 wxASSERT( frame );
 
 auto& menu = m_menu.GetMenu();
 menu.SetTitle( _( "Interactive Router" ) );
 
 m_trackViaMenu = std::make_shared<TRACK_WIDTH_MENU>( *frame );
 m_trackViaMenu->SetTool( this );
 m_menu.RegisterSubMenu( m_trackViaMenu );
 
 m_diffPairMenu = std::make_shared<DIFF_PAIR_MENU>( *frame );
 m_diffPairMenu->SetTool( this );
 m_menu.RegisterSubMenu( m_diffPairMenu );
 
 auto haveHighlight =
 [&]( const SELECTION& sel )
 {
 KIGFX::RENDER_SETTINGS* cfg = m_toolMgr->GetView()->GetPainter()->GetSettings();
 
 return !cfg->GetHighlightNetCodes().empty();
 };
 
 auto notRoutingCond =
 [this]( const SELECTION& )
 {
 return !m_router->RoutingInProgress();
 };
 
 auto hasOtherEnd =
 [&]( const SELECTION& )
 {
 std::vector<int> currentNets = m_router->GetCurrentNets();
 
 // Need to have something unconnected to finish to
 int currentNet = currentNets.empty() ? -1 : currentNets[0];
 BOARD* board = getEditFrame<PCB_EDIT_FRAME>()->GetBoard();
 RN_NET* ratsnest = board->GetConnectivity()->GetRatsnestForNet( currentNet );
 
 return ratsnest && !ratsnest->GetEdges().empty();
 };
 
 menu.AddItem( ACTIONS::cancelInteractive, SELECTION_CONDITIONS::ShowAlways, 1 );
 menu.AddSeparator( 1 );
 
 menu.AddItem( PCB_ACTIONS::clearHighlight, haveHighlight, 2 );
 menu.AddSeparator( haveHighlight, 2 );
 
 menu.AddItem( PCB_ACTIONS::routeSingleTrack, notRoutingCond );
 menu.AddItem( PCB_ACTIONS::routeDiffPair, notRoutingCond );
 menu.AddItem( ACT_EndTrack, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( PCB_ACTIONS::routerUndoLastSegment, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( PCB_ACTIONS::routerContinueFromEnd, hasOtherEnd );
 menu.AddItem( PCB_ACTIONS::routerAttemptFinish, hasOtherEnd );
 menu.AddItem( PCB_ACTIONS::breakTrack, notRoutingCond );
 
 menu.AddItem( PCB_ACTIONS::drag45Degree, notRoutingCond );
 menu.AddItem( PCB_ACTIONS::dragFreeAngle, notRoutingCond );
 
 menu.AddItem( ACT_PlaceThroughVia, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( ACT_PlaceBlindVia, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( ACT_PlaceMicroVia, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( ACT_SelLayerAndPlaceThroughVia, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( ACT_SelLayerAndPlaceBlindVia, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( ACT_SelLayerAndPlaceMicroVia, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( ACT_SwitchPosture, SELECTION_CONDITIONS::ShowAlways );
 menu.AddItem( ACT_SwitchCornerMode, SELECTION_CONDITIONS::ShowAlways );
 
 menu.AddSeparator();
 
 auto diffPairCond =
 [this]( const SELECTION& )
 {
 return m_router->Mode() == PNS::PNS_MODE_ROUTE_DIFF_PAIR;
 };
 
 menu.AddMenu( m_trackViaMenu.get(), SELECTION_CONDITIONS::ShowAlways );
 menu.AddMenu( m_diffPairMenu.get(), diffPairCond );
 
 menu.AddItem( PCB_ACTIONS::routerSettingsDialog, SELECTION_CONDITIONS::ShowAlways );
 
 menu.AddSeparator();
 
 frame->AddStandardSubMenus( m_menu );
 
 return true;
}

References _, ACT_EndTrack, ACT_PlaceBlindVia, ACT_PlaceMicroVia, ACT_PlaceThroughVia, ACT_SelLayerAndPlaceBlindVia, ACT_SelLayerAndPlaceMicroVia, ACT_SelLayerAndPlaceThroughVia, ACT_SwitchCornerMode, ACT_SwitchPosture, EDA_DRAW_FRAME::AddStandardSubMenus(), PCB_TOOL_BASE::board(), PCB_ACTIONS::breakTrack, ACTIONS::cancelInteractive, PCB_ACTIONS::clearHighlight, PCB_ACTIONS::drag45Degree, PCB_ACTIONS::dragFreeAngle, PCB_TOOL_BASE::frame(), BOARD_ITEM::GetBoard(), BOARD::GetConnectivity(), PNS::ROUTER::GetCurrentNets(), RN_NET::GetEdges(), KIGFX::RENDER_SETTINGS::GetHighlightNetCodes(), TOOL_MENU::GetMenu(), KIGFX::VIEW::GetPainter(), KIGFX::PAINTER::GetSettings(), TOOL_MANAGER::GetView(), m_diffPairMenu, m_lastTargetLayer, TOOL_INTERACTIVE::m_menu, m_originalActiveLayer, PNS::TOOL_BASE::m_router, TOOL_BASE::m_toolMgr, m_trackViaMenu, PNS::ROUTER::Mode(), PNS::PNS_MODE_ROUTE_DIFF_PAIR, TOOL_MENU::RegisterSubMenu(), PCB_ACTIONS::routeDiffPair, PCB_ACTIONS::routerAttemptFinish, PCB_ACTIONS::routerContinueFromEnd, PCB_ACTIONS::routerSettingsDialog, PCB_ACTIONS::routerUndoLastSegment, PCB_ACTIONS::routeSingleTrack, PNS::ROUTER::RoutingInProgress(), ACTION_MENU::SetTitle(), SELECTION_CONDITIONS::ShowAlways(), and UNDEFINED_LAYER.

InlineBreakTrack()

int ROUTER_TOOL::InlineBreakTrack

(

const TOOL_EVENT &

aEvent

)

Definition at line 2364 of file router_tool.cpp.

{
 const SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
 if( selection.Size() != 1 )
 return 0;
 
 const BOARD_CONNECTED_ITEM* item =
 static_cast<const BOARD_CONNECTED_ITEM*>( selection.Front() );
 
 if( item->Type() != PCB_TRACE_T )
 return 0;
 
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true );
 
 Activate();
 
 m_startItem = m_router->GetWorld()->FindItemByParent( item );
 
 TOOL_MANAGER* toolManager = frame()->GetToolManager();
 GAL* gal = toolManager->GetView()->GetGAL();
 
 m_gridHelper->SetUseGrid( gal->GetGridSnapping() && !aEvent.DisableGridSnapping() );
 m_gridHelper->SetSnap( !aEvent.Modifier( MD_SHIFT ) );
 
 if( toolManager->IsContextMenuActive() )
 {
 // If we're here from a context menu then we need to get the position of the
 // cursor when the context menu was invoked. This is used to figure out the
 // break point on the track.
 m_startSnapPoint = snapToItem( m_startItem, toolManager->GetMenuCursorPos() );
 }
 else
 {
 // If we're here from a hotkey, then get the current mouse position so we know
 // where to break the track.
 m_startSnapPoint = snapToItem( m_startItem, controls()->GetCursorPosition() );
 }
 
 if( m_startItem && m_startItem->IsLocked() )
 {
 KIDIALOG dlg( frame(), _( "The selected item is locked." ), _( "Confirmation" ),
 wxOK | wxCANCEL | wxICON_WARNING );
 dlg.SetOKLabel( _( "Break Track" ) );
 dlg.DoNotShowCheckbox( __FILE__, __LINE__ );
 
 if( dlg.ShowModal() == wxID_CANCEL )
 return 0;
 }
 
 frame()->UndoRedoBlock( true );
 breakTrack();
 
 if( m_router->RoutingInProgress() )
 m_router->StopRouting();
 
 frame()->UndoRedoBlock( false );
 
 return 0;
}

References _, TOOL_INTERACTIVE::Activate(), breakTrack(), PCB_TOOL_BASE::controls(), TOOL_EVENT::DisableGridSnapping(), KIDIALOG::DoNotShowCheckbox(), PNS::NODE::FindItemByParent(), PCB_TOOL_BASE::frame(), SELECTION::Front(), KIGFX::VIEW::GetGAL(), KIGFX::GAL::GetGridSnapping(), TOOL_MANAGER::GetMenuCursorPos(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::GetToolManager(), TOOL_MANAGER::GetView(), PNS::ROUTER::GetWorld(), TOOL_MANAGER::IsContextMenuActive(), PNS::ITEM::IsLocked(), PNS::TOOL_BASE::m_gridHelper, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::TOOL_BASE::m_startSnapPoint, TOOL_BASE::m_toolMgr, MD_SHIFT, TOOL_EVENT::Modifier(), PCB_TRACE_T, PNS::ROUTER::RoutingInProgress(), TOOL_MANAGER::RunAction(), PCB_TOOL_BASE::selection(), PCB_ACTIONS::selectionClear, GRID_HELPER::SetSnap(), GRID_HELPER::SetUseGrid(), KIDIALOG::ShowModal(), SELECTION::Size(), PNS::TOOL_BASE::snapToItem(), PNS::ROUTER::StopRouting(), EDA_ITEM::Type(), and PCB_BASE_EDIT_FRAME::UndoRedoBlock().

Referenced by setTransitions().

InlineDrag()

int ROUTER_TOOL::InlineDrag

(

const TOOL_EVENT &

aEvent

)

Definition at line 2025 of file router_tool.cpp.

{
 const PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
 if( selection.Empty() )
 m_toolMgr->RunAction( PCB_ACTIONS::selectionCursor, true, NeighboringSegmentFilter );
 
 if( selection.Size() != 1 )
 return 0;
 
 BOARD_ITEM* item = static_cast<BOARD_ITEM*>( selection.Front() );
 
 if( item->Type() != PCB_TRACE_T
 && item->Type() != PCB_VIA_T
 && item->Type() != PCB_FOOTPRINT_T )
 {
 return 0;
 }
 
 // If we overrode locks, we want to clear the flag from the source item before SyncWorld is
 // called so that virtual vias are not generated for the (now unlocked) track segment. Note in
 // this case the lock can't be reliably re-applied, because there is no guarantee that the end
 // state of the drag results in the same number of segments so it's not clear which segment to
 // apply the lock state to.
 bool wasLocked = false;
 
 if( item->IsLocked() )
 {
 wasLocked = true;
 item->SetLocked( false );
 }
 
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true );
 
 Activate();
 
 m_startItem = nullptr;
 
 PNS::ITEM* startItem = nullptr;
 PNS::ITEM_SET itemsToDrag;
 FOOTPRINT* footprint = nullptr;
 
 bool showCourtyardConflicts = frame()->GetPcbNewSettings()->m_ShowCourtyardCollisions;
 
 std::shared_ptr<DRC_ENGINE> drcEngine = m_toolMgr->GetTool<DRC_TOOL>()->GetDRCEngine();
 DRC_INTERACTIVE_COURTYARD_CLEARANCE courtyardClearanceDRC( drcEngine );
 
 std::shared_ptr<CONNECTIVITY_DATA> connectivityData = board()->GetConnectivity();
 std::vector<BOARD_ITEM*> dynamicItems;
 std::unique_ptr<CONNECTIVITY_DATA> dynamicData = nullptr;
 VECTOR2I lastOffset;
 
 if( item->Type() == PCB_FOOTPRINT_T )
 {
 footprint = static_cast<FOOTPRINT*>( item );
 
 for( PAD* pad : footprint->Pads() )
 {
 PNS::ITEM* solid = m_router->GetWorld()->FindItemByParent( pad );
 
 if( solid )
 itemsToDrag.Add( solid );
 
 if( pad->GetLocalRatsnestVisible() || displayOptions().m_ShowModuleRatsnest )
 {
 if( connectivityData->GetRatsnestForPad( pad ).size() > 0 )
 dynamicItems.push_back( pad );
 }
 }
 
 if( showCourtyardConflicts )
 {
 courtyardClearanceDRC.Init( board() );
 courtyardClearanceDRC.m_FpInMove.push_back( footprint );
 }
 
 dynamicData = std::make_unique<CONNECTIVITY_DATA>( dynamicItems, true );
 connectivityData->BlockRatsnestItems( dynamicItems );
 }
 else
 {
 startItem = m_router->GetWorld()->FindItemByParent( item );
 
 if( startItem )
 itemsToDrag.Add( startItem );
 }
 
 GAL* gal = m_toolMgr->GetView()->GetGAL();
 VECTOR2I p0 = controls()->GetCursorPosition( false );
 VECTOR2I p = p0;
 
 m_gridHelper->SetUseGrid( gal->GetGridSnapping() && !aEvent.DisableGridSnapping() );
 m_gridHelper->SetSnap( !aEvent.Modifier( MD_SHIFT ) );
 
 if( startItem )
 {
 p = snapToItem( startItem, p0 );
 m_startItem = startItem;
 
 if( m_startItem && m_startItem->Net() > 0 )
 highlightNets( true, { m_startItem->Net() } );
 }
 else if( footprint )
 {
 // The mouse is going to be moved on grid before dragging begins.
 VECTOR2I tweakedMousePos;
 PCB_BASE_EDIT_FRAME* editFrame = getEditFrame<PCB_BASE_EDIT_FRAME>();
 
 // Check if user wants to warp the mouse to origin of moved object
 
 if( editFrame->GetMoveWarpsCursor() )
 tweakedMousePos = footprint->GetPosition(); // Use footprint anchor to warp mouse
 else
 tweakedMousePos = controls()->GetCursorPosition(); // Just use current mouse pos
 
 // We tweak the mouse position using the value from above, and then use that as the
 // start position to prevent the footprint from jumping when we start dragging.
 // First we move the visual cross hair cursor...
 controls()->ForceCursorPosition( true, tweakedMousePos );
 controls()->SetCursorPosition( tweakedMousePos ); // ...then the mouse pointer
 
 // Now that the mouse is in the right position, get a copy of the position to use later
 p = controls()->GetCursorPosition();
 }
 
 int dragMode = aEvent.Parameter<int64_t> ();
 
 bool dragStarted = m_router->StartDragging( p, itemsToDrag, dragMode );
 
 if( !dragStarted )
 {
 if( wasLocked )
 item->SetLocked( true );
 
 return 0;
 }
 
 m_gridHelper->SetAuxAxes( true, p );
 controls()->ShowCursor( true );
 controls()->SetAutoPan( true );
 frame()->UndoRedoBlock( true );
 
 view()->ClearPreview();
 view()->InitPreview();
 
 auto setCursor =
 [&]()
 {
 frame()->GetCanvas()->SetCurrentCursor( KICURSOR::ARROW );
 };
 
 // Set initial cursor
 setCursor();
 
 // Set the initial visible area
 BOX2D viewAreaD = getView()->GetGAL()->GetVisibleWorldExtents();
 m_router->SetVisibleViewArea( BOX2I( viewAreaD.GetOrigin(), viewAreaD.GetSize() ) );
 
 // Send an initial movement to prime the collision detection
 m_router->Move( p, nullptr );
 
 bool hasMouseMoved = false;
 
 while( TOOL_EVENT* evt = Wait() )
 {
 setCursor();
 
 if( evt->IsCancelInteractive() )
 {
 if( wasLocked )
 item->SetLocked( true );
 
 break;
 }
 else if( evt->IsMotion() || evt->IsDrag( BUT_LEFT ) )
 {
 hasMouseMoved = true;
 updateEndItem( *evt );
 m_router->Move( m_endSnapPoint, m_endItem );
 
 if( footprint )
 {
 VECTOR2I offset = m_endSnapPoint - p;
 BOARD_ITEM* previewItem;
 
 VECTOR2I fp_offset( offset );
 RotatePoint( fp_offset, -footprint->GetOrientation() );
 
 view()->ClearPreview();
 
 for( BOARD_ITEM* drawing : footprint->GraphicalItems() )
 {
 previewItem = static_cast<BOARD_ITEM*>( drawing->Clone() );
 
 if( drawing->Type() == PCB_FP_SHAPE_T )
 {
 FP_SHAPE* shape = static_cast<FP_SHAPE*>( previewItem );
 shape->FP_SHAPE::Move( fp_offset );
 }
 else
 {
 previewItem->Move( offset );
 }
 
 view()->AddToPreview( previewItem );
 view()->Hide( drawing, true );
 }
 
 for( PAD* pad : footprint->Pads() )
 {
 if( ( pad->GetLayerSet() & LSET::AllCuMask() ).none()
 && pad->GetDrillSize().x == 0 )
 {
 previewItem = static_cast<BOARD_ITEM*>( pad->Clone() );
 previewItem->Move( offset );
 
  view()->AddToPreview( previewItem );
 }
 else
 {
 // Pads with copper or holes are handled by the router
 }
 
 view()->Hide( pad, true );
 }
 
 previewItem = static_cast<BOARD_ITEM*>( footprint->Reference().Clone() );
 previewItem->Move( offset );
 view()->AddToPreview( previewItem );
 view()->Hide( &footprint->Reference() );
 
 previewItem = static_cast<BOARD_ITEM*>( footprint->Value().Clone() );
 previewItem->Move( offset );
 view()->AddToPreview( previewItem );
 view()->Hide( &footprint->Value() );
 
 for( ZONE* zone : footprint->Zones() )
 {
 previewItem = static_cast<BOARD_ITEM*>( zone->Clone() );
 previewItem->Move( offset );
 view()->AddToPreview( previewItem );
 view()->Hide( zone, true );
 }
 
 if( showCourtyardConflicts )
 {
 footprint->Move( offset );
 courtyardClearanceDRC.Run();
 courtyardClearanceDRC.UpdateConflicts( getView(), false );
 footprint->Move( -offset );
 }
 
 // Update ratsnest
 dynamicData->Move( offset - lastOffset );
 lastOffset = offset;
 connectivityData->ComputeLocalRatsnest( dynamicItems, dynamicData.get(), offset );
 }
 }
 else if( hasMouseMoved && ( evt->IsMouseUp( BUT_LEFT ) || evt->IsClick( BUT_LEFT ) ) )
 {
 updateEndItem( *evt );
 m_router->FixRoute( m_endSnapPoint, m_endItem );
 break;
 }
 else if( evt->IsUndoRedo() )
 {
 // We're in an UndoRedoBlock. If we get here, something's broken.
 wxFAIL;
 break;
 }
 else if( evt->Category() == TC_COMMAND )
 {
 // TODO: It'd be nice to be able to say "don't allow any non-trivial editing actions",
 // but we don't at present have that, so we just knock out some of the egregious ones.
 if( evt->IsAction( &ACTIONS::cut )
 || evt->IsAction( &ACTIONS::copy )
 || evt->IsAction( &ACTIONS::paste )
 || evt->IsAction( &ACTIONS::pasteSpecial )
 || ZONE_FILLER_TOOL::IsZoneFillAction( evt ) )
 {
 wxBell();
 }
 // treat an undo as an escape
 else if( evt->IsAction( &ACTIONS::undo ) )
 {
 if( wasLocked )
 item->SetLocked( true );
 
 break;
 }
 else
 {
 evt->SetPassEvent();
 }
 }
 else
 {
 evt->SetPassEvent();
 }
 
 handleCommonEvents( *evt );
 }
 
 if( footprint )
 {
 for( BOARD_ITEM* drawing : footprint->GraphicalItems() )
 view()->Hide( drawing, false );
 
 view()->Hide( &footprint->Reference(), false );
 view()->Hide( &footprint->Value(), false );
 
 for( ZONE* zone : footprint->Zones() )
 view()->Hide( zone, false );
 
 for( PAD* pad : footprint->Pads() )
 view()->Hide( pad, false );
 
 view()->ClearPreview();
 view()->ShowPreview( false );
 
 connectivityData->ClearLocalRatsnest();
 }
 
 // Clear temporary COURTYARD_CONFLICT flag and ensure the conflict shadow is cleared
 courtyardClearanceDRC.ClearConflicts( getView() );
 
 if( m_router->RoutingInProgress() )
 m_router->StopRouting();
 
 m_gridHelper->SetAuxAxes( false );
 controls()->SetAutoPan( false );
 controls()->ForceCursorPosition( false );
 frame()->UndoRedoBlock( false );
 highlightNets( false );
 
 return 0;
}

References TOOL_INTERACTIVE::Activate(), PNS::ITEM_SET::Add(), KIGFX::VIEW::AddToPreview(), LSET::AllCuMask(), ARROW, PCB_TOOL_BASE::board(), BUT_LEFT, DRC_INTERACTIVE_COURTYARD_CLEARANCE::ClearConflicts(), KIGFX::VIEW::ClearPreview(), FP_TEXT::Clone(), PCB_TOOL_BASE::controls(), ACTIONS::copy, ACTIONS::cut, TOOL_EVENT::DisableGridSnapping(), PCB_TOOL_BASE::displayOptions(), SELECTION::Empty(), PNS::NODE::FindItemByParent(), PNS::ROUTER::FixRoute(), PCB_TOOL_BASE::footprint(), KIGFX::VIEW_CONTROLS::ForceCursorPosition(), PCB_TOOL_BASE::frame(), SELECTION::Front(), PCB_BASE_FRAME::GetCanvas(), BOARD::GetConnectivity(), KIGFX::VIEW_CONTROLS::GetCursorPosition(), KIGFX::VIEW::GetGAL(), KIGFX::GAL::GetGridSnapping(), TOOLS_HOLDER::GetMoveWarpsCursor(), FOOTPRINT::GetOrientation(), BOX2< Vec >::GetOrigin(), PCB_BASE_FRAME::GetPcbNewSettings(), FOOTPRINT::GetPosition(), BOX2< Vec >::GetSize(), TOOL_MANAGER::GetTool(), TOOL_BASE::getView(), TOOL_MANAGER::GetView(), KIGFX::GAL::GetVisibleWorldExtents(), PNS::ROUTER::GetWorld(), FOOTPRINT::GraphicalItems(), handleCommonEvents(), KIGFX::VIEW::Hide(), PNS::TOOL_BASE::highlightNets(), DRC_INTERACTIVE_COURTYARD_CLEARANCE::Init(), KIGFX::VIEW::InitPreview(), BOARD_ITEM::IsLocked(), ZONE_FILLER_TOOL::IsZoneFillAction(), PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, DRC_INTERACTIVE_COURTYARD_CLEARANCE::m_FpInMove, PNS::TOOL_BASE::m_gridHelper, PNS::TOOL_BASE::m_router, PCBNEW_SETTINGS::m_ShowCourtyardCollisions, PCBNEW_SETTINGS::DISPLAY_OPTIONS::m_ShowModuleRatsnest, PNS::TOOL_BASE::m_startItem, TOOL_BASE::m_toolMgr, MD_SHIFT, TOOL_EVENT::Modifier(), BOARD_ITEM::Move(), FOOTPRINT::Move(), PNS::ROUTER::Move(), NeighboringSegmentFilter(), PNS::ITEM::Net(), pad, FOOTPRINT::Pads(), TOOL_EVENT::Parameter(), ACTIONS::paste, ACTIONS::pasteSpecial, PCB_FOOTPRINT_T, PCB_FP_SHAPE_T, PCB_TRACE_T, PCB_VIA_T, FOOTPRINT::Reference(), RotatePoint(), PNS::ROUTER::RoutingInProgress(), DRC_INTERACTIVE_COURTYARD_CLEARANCE::Run(), TOOL_MANAGER::RunAction(), PCB_TOOL_BASE::selection(), PCB_ACTIONS::selectionClear, PCB_ACTIONS::selectionCursor, KIGFX::VIEW_CONTROLS::SetAutoPan(), GRID_HELPER::SetAuxAxes(), EDA_DRAW_PANEL_GAL::SetCurrentCursor(), KIGFX::VIEW_CONTROLS::SetCursorPosition(), BOARD_ITEM::SetLocked(), GRID_HELPER::SetSnap(), GRID_HELPER::SetUseGrid(), PNS::ROUTER::SetVisibleViewArea(), KIGFX::VIEW_CONTROLS::ShowCursor(), KIGFX::VIEW::ShowPreview(), SELECTION::Size(), PNS::TOOL_BASE::snapToItem(), PNS::ROUTER::StartDragging(), PNS::ROUTER::StopRouting(), TC_COMMAND, EDA_ITEM::Type(), ACTIONS::undo, PCB_BASE_EDIT_FRAME::UndoRedoBlock(), DRC_INTERACTIVE_COURTYARD_CLEARANCE::UpdateConflicts(), PNS::TOOL_BASE::updateEndItem(), FOOTPRINT::Value(), PCB_TOOL_BASE::view(), TOOL_INTERACTIVE::Wait(), and FOOTPRINT::Zones().

Referenced by setTransitions().

Is45Limited()

bool PCB_TOOL_BASE::Is45Limited ( ) const

virtualinherited

Should the tool use its 45° mode option?

Returns

True if set to use 45°

Definition at line 332 of file pcb_tool_base.cpp.

{
 SETTINGS_MANAGER& mgr = Pgm().GetSettingsManager();
 
 if( frame()->IsType( FRAME_PCB_EDITOR ) )
 return mgr.GetAppSettings<PCBNEW_SETTINGS>()->m_Use45DegreeLimit;
 else
 return mgr.GetAppSettings<FOOTPRINT_EDITOR_SETTINGS>()->m_Use45Limit;
}

References PCB_TOOL_BASE::frame(), FRAME_PCB_EDITOR, SETTINGS_MANAGER::GetAppSettings(), and Pgm().

Referenced by DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawDimension(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::drawShape(), DRAWING_TOOL::DrawZone(), and ZONE_CREATE_HELPER::OnFirstPoint().

IsBoardEditor()

bool PCB_TOOL_BASE::IsBoardEditor ( ) const

inlineinherited

Definition at line 109 of file pcb_tool_base.h.

{ return m_isBoardEditor; }

References PCB_TOOL_BASE::m_isBoardEditor.

Referenced by BOARD_COMMIT::BOARD_COMMIT().

IsFootprintEditor()

bool PCB_TOOL_BASE::IsFootprintEditor ( ) const

inlineinherited

Definition at line 106 of file pcb_tool_base.h.

{ return m_isFootprintEditor; }

References PCB_TOOL_BASE::m_isFootprintEditor.

Referenced by BOARD_COMMIT::BOARD_COMMIT(), EDIT_TOOL::DeleteItems(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::Flip(), EDIT_TOOL::Mirror(), EDIT_TOOL::MoveExact(), PCB_GRID_HELPER::queryVisible(), and EDIT_TOOL::Rotate().

IsToolActive()

bool TOOL_BASE::IsToolActive ( ) const

inherited

Definition at line 31 of file tool_base.cpp.

{
 return m_toolMgr->IsToolActive( m_toolId );
}

References TOOL_MANAGER::IsToolActive(), TOOL_BASE::m_toolId, and TOOL_BASE::m_toolMgr.

Referenced by EDIT_TOOL::Drag(), handleLayerSwitch(), PCB_SELECTION_TOOL::Main(), BOARD_EDITOR_CONTROL::TrackWidthDec(), and BOARD_EDITOR_CONTROL::TrackWidthInc().

MainLoop()

int ROUTER_TOOL::MainLoop

(

const TOOL_EVENT &

aEvent

)

Definition at line 1667 of file router_tool.cpp.

{
 if( m_inRouterTool )
 return 0;
 
 REENTRANCY_GUARD guard( &m_inRouterTool );
 
 PNS::ROUTER_MODE mode = aEvent.Parameter<PNS::ROUTER_MODE>();
 PCB_EDIT_FRAME* frame = getEditFrame<PCB_EDIT_FRAME>();
 VIEW_CONTROLS* controls = getViewControls();
 
 if( m_router->RoutingInProgress() )
 {
 if( m_router->Mode() == mode )
 return 0;
 else
 m_router->StopRouting();
 }
 
 // Deselect all items
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true );
 
 frame->PushTool( aEvent );
 
 auto setCursor =
 [&]()
 {
 frame->GetCanvas()->SetCurrentCursor( KICURSOR::PENCIL );
 };
 
 Activate();
 // Must be done after Activate() so that it gets set into the correct context
 controls->ShowCursor( true );
 controls->ForceCursorPosition( false );
 // Set initial cursor
 setCursor();
 
 m_router->SetMode( mode );
 m_cancelled = false;
 
 if( aEvent.HasPosition() )
 m_toolMgr->PrimeTool( aEvent.Position() );
 
 // Main loop: keep receiving events
 while( TOOL_EVENT* evt = Wait() )
 {
 if( !evt->IsDrag() )
 setCursor();
 
 if( evt->IsCancelInteractive() )
 {
 frame->PopTool( aEvent );
 break;
 }
 else if( evt->IsActivate() )
 {
 if( evt->IsMoveTool() || evt->IsEditorTool() )
 {
 // leave ourselves on the stack so we come back after the move
 break;
 }
 else
 {
 frame->PopTool( aEvent );
 break;
 }
 }
 else if( evt->Action() == TA_UNDO_REDO_PRE )
 {
 m_router->ClearWorld();
 }
 else if( evt->Action() == TA_UNDO_REDO_POST || evt->Action() == TA_MODEL_CHANGE )
 {
 m_router->SyncWorld();
 }
 else if( evt->IsMotion() )
 {
 updateStartItem( *evt );
 }
 else if( evt->IsAction( &PCB_ACTIONS::dragFreeAngle ) )
 {
 updateStartItem( *evt, true );
 performDragging( PNS::DM_ANY | PNS::DM_FREE_ANGLE );
 }
 else if( evt->IsAction( &PCB_ACTIONS::drag45Degree ) )
 {
 updateStartItem( *evt, true );
 performDragging( PNS::DM_ANY );
 }
 else if( evt->IsAction( &PCB_ACTIONS::breakTrack ) )
 {
 updateStartItem( *evt, true );
 breakTrack( );
 evt->SetPassEvent( false );
 }
 else if( evt->IsClick( BUT_LEFT )
 || evt->IsAction( &PCB_ACTIONS::routeSingleTrack )
 || evt->IsAction( &PCB_ACTIONS::routeDiffPair ) )
 {
 updateStartItem( *evt );
 
 if( evt->HasPosition() )
 {
 if( evt->Modifier( MD_SHIFT ) )
 performDragging( PNS::DM_ANY );
 else
 performRouting();
 }
 }
 else if( evt->IsAction( &ACT_PlaceThroughVia ) )
 {
 m_toolMgr->RunAction( PCB_ACTIONS::layerToggle, true );
 }
 else if( evt->IsAction( &PCB_ACTIONS::layerChanged ) )
 {
 m_router->SwitchLayer( frame->GetActiveLayer() );
 updateSizesAfterLayerSwitch( frame->GetActiveLayer() );
 updateStartItem( *evt );
 }
 else if( evt->IsKeyPressed() )
 {
 // wxWidgets fails to correctly translate shifted keycodes on the wxEVT_CHAR_HOOK
 // event so we need to process the wxEVT_CHAR event that will follow as long as we
 // pass the event.
 evt->SetPassEvent();
 }
 else if( evt->IsClick( BUT_RIGHT ) )
 {
 m_menu.ShowContextMenu( selection() );
 }
 else
 {
 evt->SetPassEvent();
 }
 
 if( m_cancelled )
 {
 frame->PopTool( aEvent );
 break;
 }
 }
 
 // Store routing settings till the next invocation
 m_savedSizes = m_router->Sizes();
 m_router->ClearViewDecorations();
 
 return 0;
}

References ACT_PlaceThroughVia, TOOL_INTERACTIVE::Activate(), breakTrack(), PCB_ACTIONS::breakTrack, BUT_LEFT, BUT_RIGHT, PNS::ROUTER::ClearViewDecorations(), PNS::ROUTER::ClearWorld(), PCB_TOOL_BASE::controls(), PNS::DM_ANY, PNS::DM_FREE_ANGLE, PCB_ACTIONS::drag45Degree, PCB_ACTIONS::dragFreeAngle, KIGFX::VIEW_CONTROLS::ForceCursorPosition(), PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetActiveLayer(), PCB_BASE_FRAME::GetCanvas(), TOOL_BASE::getViewControls(), TOOL_EVENT::HasPosition(), PCB_ACTIONS::layerChanged, PCB_ACTIONS::layerToggle, PNS::TOOL_BASE::m_cancelled, m_inRouterTool, TOOL_INTERACTIVE::m_menu, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_savedSizes, TOOL_BASE::m_toolMgr, MD_SHIFT, PNS::ROUTER::Mode(), TOOL_EVENT::Parameter(), PENCIL, performDragging(), performRouting(), TOOLS_HOLDER::PopTool(), TOOL_EVENT::Position(), TOOL_MANAGER::PrimeTool(), TOOLS_HOLDER::PushTool(), PCB_ACTIONS::routeDiffPair, PCB_ACTIONS::routeSingleTrack, PNS::ROUTER::RoutingInProgress(), TOOL_MANAGER::RunAction(), PCB_TOOL_BASE::selection(), PCB_ACTIONS::selectionClear, EDA_DRAW_PANEL_GAL::SetCurrentCursor(), PNS::ROUTER::SetMode(), TOOL_MENU::ShowContextMenu(), KIGFX::VIEW_CONTROLS::ShowCursor(), PNS::ROUTER::Sizes(), PNS::ROUTER::StopRouting(), PNS::ROUTER::SwitchLayer(), PNS::ROUTER::SyncWorld(), TA_MODEL_CHANGE, TA_UNDO_REDO_POST, TA_UNDO_REDO_PRE, updateSizesAfterLayerSwitch(), PNS::TOOL_BASE::updateStartItem(), and TOOL_INTERACTIVE::Wait().

Referenced by setTransitions().

NeighboringSegmentFilter()

void ROUTER_TOOL::NeighboringSegmentFilter ( const VECTOR2I &  aPt, GENERAL_COLLECTOR &  aCollector  )

static

Definition at line 1945 of file router_tool.cpp.

{
 /*
 * If the collection contains a trivial line corner (two connected segments)
 * or a non-fanout-via (a via with no more than two connected segments), then
 * trim the collection down to a single item (which one won't matter since
 * they're all connected).
 */
 
 // First make sure we've got something that *might* match.
 int vias = aCollector.CountType( PCB_VIA_T );
 int traces = aCollector.CountType( PCB_TRACE_T );
 int arcs = aCollector.CountType( PCB_ARC_T );
 
 if( arcs > 0 || vias > 1 || traces > 2 || vias + traces < 1 )
 return;
 
 // Fetch first PCB_TRACK (via or trace) as our reference
 PCB_TRACK* reference = nullptr;
 
 for( int i = 0; !reference && i < aCollector.GetCount(); i++ )
 reference = dynamic_cast<PCB_TRACK*>( aCollector[i] );
 
 int refNet = reference->GetNetCode();
 
 VECTOR2I refPoint( aPt.x, aPt.y );
 EDA_ITEM_FLAGS flags = reference->IsPointOnEnds( refPoint, -1 );
 
 if( flags & STARTPOINT )
 refPoint = reference->GetStart();
 else if( flags & ENDPOINT )
 refPoint = reference->GetEnd();
 
 // Check all items to ensure that any TRACKs are co-terminus with the reference and on
 // the same net.
 for( int i = 0; i < aCollector.GetCount(); i++ )
 {
 PCB_TRACK* neighbor = dynamic_cast<PCB_TRACK*>( aCollector[i] );
 
 if( neighbor && neighbor != reference )
 {
 if( neighbor->GetNetCode() != refNet )
 return;
 
 if( neighbor->GetStart() != refPoint && neighbor->GetEnd() != refPoint )
 return;
 }
 }
 
 // Selection meets criteria; trim it to the reference item.
 aCollector.Empty();
 aCollector.Append( reference );
}

References COLLECTOR::Append(), COLLECTOR::CountType(), COLLECTOR::Empty(), ENDPOINT, COLLECTOR::GetCount(), PCB_TRACK::GetEnd(), BOARD_CONNECTED_ITEM::GetNetCode(), PCB_TRACK::GetStart(), PCB_TRACK::IsPointOnEnds(), PCB_ARC_T, PCB_TRACE_T, PCB_VIA_T, STARTPOINT, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by CanInlineDrag(), and InlineDrag().

onLayerCommand()

int ROUTER_TOOL::onLayerCommand ( const TOOL_EVENT &  aEvent )

private

Definition at line 865 of file router_tool.cpp.

{
 return handleLayerSwitch( aEvent, false );
}

References handleLayerSwitch().

Referenced by setTransitions().

onTrackViaSizeChanged()

int ROUTER_TOOL::onTrackViaSizeChanged ( const TOOL_EVENT &  aEvent )

private

Definition at line 2444 of file router_tool.cpp.

{
 PNS::SIZES_SETTINGS sizes( m_router->Sizes() );
 
 if( !m_router->GetCurrentNets().empty() )
 m_iface->ImportSizes( sizes, m_startItem, m_router->GetCurrentNets()[0] );
 
 m_router->UpdateSizes( sizes );
 
 // Changing the track width can affect the placement, so call the
 // move routine without changing the destination
 // Update end item first to avoid moving to an invalid/missing item
 updateEndItem( aEvent );
 m_router->Move( m_endSnapPoint, m_endItem );
 
 UpdateMessagePanel();
 
 return 0;
}

References PNS::ROUTER::GetCurrentNets(), PNS_KICAD_IFACE_BASE::ImportSizes(), PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, PNS::TOOL_BASE::m_iface, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::ROUTER::Move(), PNS::ROUTER::Sizes(), PNS::TOOL_BASE::updateEndItem(), UpdateMessagePanel(), and PNS::ROUTER::UpdateSizes().

Referenced by CustomTrackWidthDialog(), and setTransitions().

onViaCommand()

int ROUTER_TOOL::onViaCommand ( const TOOL_EVENT &  aEvent )

private

Definition at line 871 of file router_tool.cpp.

{
 if( !m_router->IsPlacingVia() )
 {
 return handleLayerSwitch( aEvent, true );
 }
 else
 {
 m_router->ToggleViaPlacement();
 frame()->SetActiveLayer( static_cast<PCB_LAYER_ID>( m_router->GetCurrentLayer() ) );
 updateEndItem( aEvent );
 m_router->Move( m_endSnapPoint, m_endItem );
 }
 
 return 0;
}

References PCB_TOOL_BASE::frame(), PNS::ROUTER::GetCurrentLayer(), handleLayerSwitch(), PNS::ROUTER::IsPlacingVia(), PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, PNS::TOOL_BASE::m_router, PNS::ROUTER::Move(), PCB_BASE_FRAME::SetActiveLayer(), PNS::ROUTER::ToggleViaPlacement(), and PNS::TOOL_BASE::updateEndItem().

Referenced by setTransitions().

performDragging()

void ROUTER_TOOL::performDragging ( int  aMode = PNS::DM_ANY )

private

Definition at line 1817 of file router_tool.cpp.

{
 m_router->ClearViewDecorations();
 
 VIEW_CONTROLS* ctls = getViewControls();
 
 if( m_startItem && m_startItem->IsLocked() )
 {
 KIDIALOG dlg( frame(), _( "The selected item is locked." ), _( "Confirmation" ),
 wxOK | wxCANCEL | wxICON_WARNING );
 dlg.SetOKLabel( _( "Drag Anyway" ) );
 dlg.DoNotShowCheckbox( __FILE__, __LINE__ );
 
 if( dlg.ShowModal() == wxID_CANCEL )
 return;
 }
 
 // We don't support dragging arcs inside the PNS right now
 if( m_startItem && m_startItem->Kind() == PNS::ITEM::ARC_T )
 {
 if( m_router->RoutingInProgress() )
 m_router->StopRouting();
 
 m_startItem = nullptr;
 
 m_gridHelper->SetAuxAxes( false );
 ctls->ForceCursorPosition( false );
 highlightNets( false );
 
 m_cancelled = true;
 
 m_toolMgr->RunAction( PCB_ACTIONS::drag45Degree, false );
 
 return;
 }
 
 bool dragStarted = m_router->StartDragging( m_startSnapPoint, m_startItem, aMode );
 
 if( !dragStarted )
 return;
 
 if( m_startItem && m_startItem->Net() > 0 )
 highlightNets( true, { m_startItem->Net() } );
 
 ctls->SetAutoPan( true );
 m_gridHelper->SetAuxAxes( true, m_startSnapPoint );
 frame()->UndoRedoBlock( true );
 
 while( TOOL_EVENT* evt = Wait() )
 {
 ctls->ForceCursorPosition( false );
 
 if( evt->IsMotion() )
 {
 updateEndItem( *evt );
 m_router->Move( m_endSnapPoint, m_endItem );
 }
 else if( evt->IsClick( BUT_LEFT ) )
 {
 if( m_router->FixRoute( m_endSnapPoint, m_endItem ) )
 break;
 }
 else if( evt->IsClick( BUT_RIGHT ) )
 {
 m_menu.ShowContextMenu( selection() );
 }
 else if( evt->IsCancelInteractive() || evt->IsActivate() )
 {
 if( evt->IsCancelInteractive() && !m_startItem )
 m_cancelled = true;
 
 if( evt->IsActivate() && !evt->IsMoveTool() )
 m_cancelled = true;
 
 break;
 }
 else if( evt->IsUndoRedo() )
 {
 // We're in an UndoRedoBlock. If we get here, something's broken.
 wxFAIL;
 break;
 }
 else if( evt->Category() == TC_COMMAND )
 {
 // TODO: It'd be nice to be able to say "don't allow any non-trivial editing actions",
 // but we don't at present have that, so we just knock out some of the egregious ones.
 if( evt->IsAction( &ACTIONS::cut )
 || evt->IsAction( &ACTIONS::copy )
 || evt->IsAction( &ACTIONS::paste )
 || evt->IsAction( &ACTIONS::pasteSpecial )
 || ZONE_FILLER_TOOL::IsZoneFillAction( evt ) )
 {
 wxBell();
 }
 // treat an undo as an escape
 else if( evt->IsAction( &ACTIONS::undo ) )
 {
 if( m_startItem )
 break;
 else
 wxBell();
 }
 else
 {
 evt->SetPassEvent();
 }
 }
 else
 {
 evt->SetPassEvent();
 }
 
 handleCommonEvents( *evt );
 }
 
 if( m_router->RoutingInProgress() )
 m_router->StopRouting();
 
 m_startItem = nullptr;
 
 m_gridHelper->SetAuxAxes( false );
 frame()->UndoRedoBlock( false );
 ctls->SetAutoPan( false );
 ctls->ForceCursorPosition( false );
 highlightNets( false );
}

References _, PNS::ITEM::ARC_T, BUT_LEFT, BUT_RIGHT, PNS::ROUTER::ClearViewDecorations(), ACTIONS::copy, ACTIONS::cut, KIDIALOG::DoNotShowCheckbox(), PCB_ACTIONS::drag45Degree, PNS::ROUTER::FixRoute(), KIGFX::VIEW_CONTROLS::ForceCursorPosition(), PCB_TOOL_BASE::frame(), TOOL_BASE::getViewControls(), handleCommonEvents(), PNS::TOOL_BASE::highlightNets(), PNS::ITEM::IsLocked(), ZONE_FILLER_TOOL::IsZoneFillAction(), PNS::ITEM::Kind(), PNS::TOOL_BASE::m_cancelled, PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, PNS::TOOL_BASE::m_gridHelper, TOOL_INTERACTIVE::m_menu, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::TOOL_BASE::m_startSnapPoint, TOOL_BASE::m_toolMgr, PNS::ROUTER::Move(), PNS::ITEM::Net(), ACTIONS::paste, ACTIONS::pasteSpecial, PNS::ROUTER::RoutingInProgress(), TOOL_MANAGER::RunAction(), PCB_TOOL_BASE::selection(), KIGFX::VIEW_CONTROLS::SetAutoPan(), GRID_HELPER::SetAuxAxes(), TOOL_MENU::ShowContextMenu(), KIDIALOG::ShowModal(), PNS::ROUTER::StartDragging(), PNS::ROUTER::StopRouting(), TC_COMMAND, ACTIONS::undo, PCB_BASE_EDIT_FRAME::UndoRedoBlock(), PNS::TOOL_BASE::updateEndItem(), and TOOL_INTERACTIVE::Wait().

Referenced by MainLoop().

performRouting()

void ROUTER_TOOL::performRouting ( )

private

Definition at line 1272 of file router_tool.cpp.

{
 m_router->ClearViewDecorations();
 
 if( !prepareInteractive() )
 return;
 
 auto setCursor =
 [&]()
 {
 frame()->GetCanvas()->SetCurrentCursor( KICURSOR::PENCIL );
 };
 
 auto syncRouterAndFrameLayer =
 [&]()
 {
 PCB_LAYER_ID routingLayer = ToLAYER_ID( m_router->GetCurrentLayer() );
 PCB_EDIT_FRAME* editFrame = getEditFrame<PCB_EDIT_FRAME>();
 
 editFrame->SetActiveLayer( routingLayer );
 
 if( !getView()->IsLayerVisible( routingLayer ) )
 {
 editFrame->GetAppearancePanel()->SetLayerVisible( routingLayer, true );
 editFrame->GetCanvas()->Refresh();
 }
 };
 
 // Set initial cursor
 setCursor();
 
 while( TOOL_EVENT* evt = Wait() )
 {
 setCursor();
 
 // Don't crash if we missed an operation that canceled routing.
 if( !m_router->RoutingInProgress() )
 {
 if( evt->IsCancelInteractive() )
 m_cancelled = true;
 
 break;
 }
 
 handleCommonEvents( *evt );
 
 if( evt->IsMotion() )
 {
 updateEndItem( *evt );
 m_router->Move( m_endSnapPoint, m_endItem );
 }
 else if( evt->IsAction( &PCB_ACTIONS::routerUndoLastSegment ) )
 {
 m_router->UndoLastSegment();
 updateEndItem( *evt );
 m_router->Move( m_endSnapPoint, m_endItem );
 }
 else if( evt->IsAction( &PCB_ACTIONS::routerAttemptFinish ) )
 {
 bool* autoRouted = evt->Parameter<bool*>();
 
 if( m_router->Finish() )
 {
 // When we're routing a group of signals automatically we want
 // to break up the undo stack every time we have to manually route
 // so the user gets nice checkpoints. Remove the APPEND_UNDO flag.
 if( autoRouted != nullptr )
 *autoRouted = true;
 
 break;
 }
 else
 {
 // This acts as check if we were called by the autorouter; we don't want
 // to reset APPEND_UNDO if we're auto finishing after route-other-end
 if( autoRouted != nullptr )
 {
 *autoRouted = false;
 m_iface->SetCommitFlags( 0 );
 }
 
 // Warp the mouse so the user is at the point we managed to route to
 controls()->WarpMouseCursor( m_router->Placer()->CurrentEnd(), true, true );
 }
 }
 else if( evt->IsAction( &PCB_ACTIONS::routerContinueFromEnd ) )
 {
 bool needsAppend = m_router->Placer()->HasPlacedAnything();
 
 if( m_router->ContinueFromEnd() )
 {
 syncRouterAndFrameLayer();
 m_startSnapPoint = m_router->Placer()->CurrentStart();
 
 // Warp the mouse to wherever we actually ended up routing to
 controls()->WarpMouseCursor( m_router->Placer()->CurrentEnd(), true, true );
 
 // We want the next router commit to be one undo at the UI layer
 m_iface->SetCommitFlags( needsAppend ? APPEND_UNDO : 0 );
 }
 }
 else if( evt->IsClick( BUT_LEFT ) || evt->IsDrag( BUT_LEFT ) || evt->IsAction( &PCB_ACTIONS::routeSingleTrack ) )
 {
 updateEndItem( *evt );
 bool needLayerSwitch = m_router->IsPlacingVia();
 bool forceFinish = evt->Modifier( MD_SHIFT );
 
 if( m_router->FixRoute( m_endSnapPoint, m_endItem, forceFinish ) )
 break;
 
 if( needLayerSwitch )
 switchLayerOnViaPlacement();
 
 // Synchronize the indicated layer
 syncRouterAndFrameLayer();
 
 updateEndItem( *evt );
 m_router->Move( m_endSnapPoint, m_endItem );
 m_startItem = nullptr;
 }
 else if( evt->IsAction( &ACT_SwitchCornerMode ) )
 {
 m_router->ToggleCornerMode();
 UpdateMessagePanel();
 updateEndItem( *evt );
 m_router->Move( m_endSnapPoint, m_endItem ); // refresh
  }
 else if( evt->IsAction( &ACT_SwitchPosture ) )
 {
 m_router->FlipPosture();
 updateEndItem( *evt );
 m_router->Move( m_endSnapPoint, m_endItem ); // refresh
 }
 else if( evt->IsAction( &PCB_ACTIONS::properties ) )
 {
 frame()->GetCanvas()->SetCurrentCursor( KICURSOR::ARROW );
 controls()->SetAutoPan( false );
 {
 m_toolMgr->RunAction( ACT_CustomTrackWidth, true );
 }
 controls()->SetAutoPan( true );
 setCursor();
 UpdateMessagePanel();
 }
 else if( evt->IsAction( &ACT_EndTrack ) || evt->IsDblClick( BUT_LEFT ) )
 {
 // Stop current routing:
 m_router->FixRoute( m_endSnapPoint, m_endItem, true );
 break;
 }
 else if( evt->IsCancelInteractive() || evt->IsActivate()
 || evt->IsAction( &PCB_ACTIONS::routerInlineDrag ) )
 {
 if( evt->IsCancelInteractive() && !m_router->RoutingInProgress() )
 m_cancelled = true;
 
 if( evt->IsActivate() && !evt->IsMoveTool() )
 m_cancelled = true;
 
 break;
 }
 else if( evt->IsUndoRedo() )
 {
 // We're in an UndoRedoBlock. If we get here, something's broken.
 wxFAIL;
 break;
 }
 else if( evt->IsClick( BUT_RIGHT ) )
 {
 m_menu.ShowContextMenu( selection() );
 }
 // TODO: It'd be nice to be able to say "don't allow any non-trivial editing actions",
 // but we don't at present have that, so we just knock out some of the egregious ones.
 else if( ZONE_FILLER_TOOL::IsZoneFillAction( evt ) )
 {
 wxBell();
 }
 else
 {
 evt->SetPassEvent();
 }
 }
 
 m_router->CommitRouting();
 // Reset to normal for next route
 m_iface->SetCommitFlags( 0 );
 
 finishInteractive();
}

References ACT_CustomTrackWidth, ACT_EndTrack, ACT_SwitchCornerMode, ACT_SwitchPosture, APPEND_UNDO, ARROW, BUT_LEFT, BUT_RIGHT, PNS::ROUTER::ClearViewDecorations(), PNS::ROUTER::CommitRouting(), PNS::ROUTER::ContinueFromEnd(), PCB_TOOL_BASE::controls(), PNS::PLACEMENT_ALGO::CurrentEnd(), PNS::PLACEMENT_ALGO::CurrentStart(), PNS::ROUTER::Finish(), finishInteractive(), PNS::ROUTER::FixRoute(), PNS::ROUTER::FlipPosture(), PCB_TOOL_BASE::frame(), PCB_BASE_EDIT_FRAME::GetAppearancePanel(), PCB_BASE_FRAME::GetCanvas(), PNS::ROUTER::GetCurrentLayer(), TOOL_BASE::getView(), handleCommonEvents(), PNS::PLACEMENT_ALGO::HasPlacedAnything(), PNS::ROUTER::IsPlacingVia(), ZONE_FILLER_TOOL::IsZoneFillAction(), PNS::TOOL_BASE::m_cancelled, PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, PNS::TOOL_BASE::m_iface, TOOL_INTERACTIVE::m_menu, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::TOOL_BASE::m_startSnapPoint, TOOL_BASE::m_toolMgr, MD_SHIFT, PNS::ROUTER::Move(), PENCIL, PNS::ROUTER::Placer(), prepareInteractive(), PCB_ACTIONS::properties, EDA_DRAW_PANEL_GAL::Refresh(), PCB_ACTIONS::routerAttemptFinish, PCB_ACTIONS::routerContinueFromEnd, PCB_ACTIONS::routerInlineDrag, PCB_ACTIONS::routerUndoLastSegment, PCB_ACTIONS::routeSingleTrack, PNS::ROUTER::RoutingInProgress(), TOOL_MANAGER::RunAction(), PCB_TOOL_BASE::selection(), PCB_EDIT_FRAME::SetActiveLayer(), KIGFX::VIEW_CONTROLS::SetAutoPan(), PNS_KICAD_IFACE::SetCommitFlags(), EDA_DRAW_PANEL_GAL::SetCurrentCursor(), APPEARANCE_CONTROLS::SetLayerVisible(), TOOL_MENU::ShowContextMenu(), switchLayerOnViaPlacement(), PNS::ROUTER::ToggleCornerMode(), ToLAYER_ID(), PNS::ROUTER::UndoLastSegment(), PNS::TOOL_BASE::updateEndItem(), UpdateMessagePanel(), TOOL_INTERACTIVE::Wait(), and KIGFX::VIEW_CONTROLS::WarpMouseCursor().

Referenced by MainLoop(), and RouteSelected().

pickSingleItem()

ITEM * TOOL_BASE::pickSingleItem ( const VECTOR2I &  aWhere, int  aNet = -1, int  aLayer = -1, bool  aIgnorePads = false, const std::vector< ITEM * >  aAvoidItems = {}  )

protectedvirtualinherited

Definition at line 98 of file pns_tool_base.cpp.

{
 int tl = aLayer > 0 ? aLayer : getView()->GetTopLayer();
 
 static const int candidateCount = 5;
 ITEM* prioritized[candidateCount];
 SEG::ecoord dist[candidateCount];
 
 for( int i = 0; i < candidateCount; i++ )
 {
 prioritized[i] = nullptr;
 dist[i] = VECTOR2I::ECOORD_MAX;
 }
 
 ITEM_SET candidates = m_router->QueryHoverItems( aWhere );
 
 if( candidates.Empty() )
 candidates = m_router->QueryHoverItems( aWhere, true );
 
 for( ITEM* item : candidates.Items() )
 {
 if( !item->IsRoutable() )
 continue;
 
 if( !IsCopperLayer( item->Layers().Start() ) )
 continue;
 
 if( !m_iface->IsAnyLayerVisible( item->Layers() ) )
 continue;
 
 if( alg::contains( aAvoidItems, item ) )
 continue;
 
 // fixme: this causes flicker with live loop removal...
 //if( item->Parent() && !item->Parent()->ViewIsVisible() )
 // continue;
 
 if( item->OfKind( ITEM::SOLID_T ) && aIgnorePads )
 {
 continue;
 }
 else if( aNet <= 0 || item->Net() == aNet )
 {
 if( item->OfKind( ITEM::VIA_T | ITEM::SOLID_T ) )
 {
 SEG::ecoord d = ( item->Shape()->Centre() - aWhere ).SquaredEuclideanNorm();
 
 if( d < dist[2] )
 {
 prioritized[2] = item;
 dist[2] = d;
 }
 
 if( item->Layers().Overlaps( tl ) && d < dist[0] )
 {
 prioritized[0] = item;
 dist[0] = d;
 }
 }
 else // ITEM::SEGMENT_T | ITEM::ARC_T
 {
 LINKED_ITEM* li = static_cast<LINKED_ITEM*>( item );
 SEG::ecoord d = std::min( ( li->Anchor( 0 ) - aWhere ).SquaredEuclideanNorm(),
 ( li->Anchor( 1 ) - aWhere ).SquaredEuclideanNorm() );
 
 if( d < dist[3] )
 {
 prioritized[3] = item;
 dist[3] = d;
 }
 
 if( item->Layers().Overlaps( tl ) && d < dist[1] )
 {
 prioritized[1] = item;
 dist[1] = d;
 }
 }
 }
 else if( item->OfKind( ITEM::SOLID_T ) && item->IsFreePad() )
 {
 // Allow free pads only when already inside pad
 if( item->Shape()->Collide( aWhere ) )
 {
 prioritized[0] = item;
 dist[0] = 0;
 }
 }
 else if ( item->Net() == 0 && m_router->Settings().Mode() == RM_MarkObstacles )
 {
 // Allow unconnected items as last resort in RM_MarkObstacles mode
 if( item->Layers().Overlaps( tl ) )
 prioritized[4] = item;
 }
 }
 
  ITEM* rv = nullptr;
 
 bool highContrast = ( frame()->GetDisplayOptions().m_ContrastModeDisplay != HIGH_CONTRAST_MODE::NORMAL );
 
 for( int i = 0; i < candidateCount; i++ )
 {
 ITEM* item = prioritized[i];
 
 if( highContrast && item && !item->Layers().Overlaps( tl ) )
 item = nullptr;
 
 if( item && ( aLayer < 0 || item->Layers().Overlaps( aLayer ) ) )
 {
 rv = item;
 break;
 }
 }
 
 if( rv )
 {
 wxLogTrace( wxT( "PNS" ), wxT( "%s, layer : %d, tl: %d" ),
 rv->KindStr().c_str(),
 rv->Layers().Start(),
 tl );
 }
 
 return rv;
}

References PNS::ITEM::Anchor(), alg::contains(), VECTOR2< int >::ECOORD_MAX, PNS::ITEM_SET::Empty(), PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetDisplayOptions(), KIGFX::VIEW::GetTopLayer(), TOOL_BASE::getView(), PNS_KICAD_IFACE::IsAnyLayerVisible(), IsCopperLayer(), PNS::ITEM_SET::Items(), PNS::ITEM::KindStr(), PNS::ITEM::Layers(), PCB_DISPLAY_OPTIONS::m_ContrastModeDisplay, PNS::TOOL_BASE::m_iface, PNS::TOOL_BASE::m_router, PNS::ROUTING_SETTINGS::Mode(), NORMAL, LAYER_RANGE::Overlaps(), PNS::ROUTER::QueryHoverItems(), PNS::RM_MarkObstacles, PNS::ROUTER::Settings(), PNS::ITEM::SOLID_T, LAYER_RANGE::Start(), and PNS::ITEM::VIA_T.

Referenced by PNS::TOOL_BASE::updateEndItem(), and PNS::TOOL_BASE::updateStartItem().

prepareInteractive()

bool ROUTER_TOOL::prepareInteractive ( )

private

Definition at line 1179 of file router_tool.cpp.

{
 PCB_EDIT_FRAME* editFrame = getEditFrame<PCB_EDIT_FRAME>();
 int routingLayer = getStartLayer( m_startItem );
 
 if( !IsCopperLayer( routingLayer ) )
 {
 editFrame->ShowInfoBarError( _( "Tracks on Copper layers only." ) );
 return false;
 }
 
 m_originalActiveLayer = editFrame->GetActiveLayer();
 editFrame->SetActiveLayer( ToLAYER_ID( routingLayer ) );
 
 if( !getView()->IsLayerVisible( routingLayer ) )
 {
 editFrame->GetAppearancePanel()->SetLayerVisible( routingLayer, true );
 editFrame->GetCanvas()->Refresh();
 }
 
 PNS::SIZES_SETTINGS sizes( m_router->Sizes() );
 
 m_iface->SetStartLayer( routingLayer );
 
 frame()->GetBoard()->GetDesignSettings().m_TempOverrideTrackWidth = false;
 m_iface->ImportSizes( sizes, m_startItem, -1 );
 sizes.AddLayerPair( frame()->GetScreen()->m_Route_Layer_TOP,
 frame()->GetScreen()->m_Route_Layer_BOTTOM );
 
 m_router->UpdateSizes( sizes );
 
 if( m_startItem && m_startItem->Net() > 0 )
 {
 if( m_router->Mode() == PNS::PNS_MODE_ROUTE_DIFF_PAIR )
 {
 if( int coupledNet = m_router->GetRuleResolver()->DpCoupledNet( m_startItem->Net() ) )
 highlightNets( true, { m_startItem->Net(), coupledNet } );
 }
 else
 {
 highlightNets( true, { m_startItem->Net() } );
 }
 }
 
 controls()->SetAutoPan( true );
 
 if( !m_router->StartRouting( m_startSnapPoint, m_startItem, routingLayer ) )
 {
 // It would make more sense to leave the net highlighted as the higher-contrast mode
 // makes the router clearances more visible. However, since we just started routing
 // the conversion of the screen from low contrast to high contrast is a bit jarring and
 // makes the infobar coming up less noticeable.
 highlightNets( false );
 
 frame()->ShowInfoBarError( m_router->FailureReason(), true,
 [&]()
 {
 m_router->ClearViewDecorations();
 } );
 
 controls()->SetAutoPan( false );
 return false;
 }
 
 m_endItem = nullptr;
 m_endSnapPoint = m_startSnapPoint;
 
 UpdateMessagePanel();
 frame()->UndoRedoBlock( true );
 
 return true;
}

References _, PNS::SIZES_SETTINGS::AddLayerPair(), PCB_TOOL_BASE::controls(), PNS::RULE_RESOLVER::DpCoupledNet(), PNS::ROUTER::FailureReason(), PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetActiveLayer(), PCB_BASE_EDIT_FRAME::GetAppearancePanel(), PCB_BASE_FRAME::GetBoard(), PCB_BASE_FRAME::GetCanvas(), BOARD::GetDesignSettings(), PNS::ROUTER::GetRuleResolver(), getStartLayer(), TOOL_BASE::getView(), PNS::TOOL_BASE::highlightNets(), PNS_KICAD_IFACE_BASE::ImportSizes(), IsCopperLayer(), PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, PNS::TOOL_BASE::m_iface, m_originalActiveLayer, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::TOOL_BASE::m_startSnapPoint, BOARD_DESIGN_SETTINGS::m_TempOverrideTrackWidth, PNS::ROUTER::Mode(), PNS::ITEM::Net(), PNS::PNS_MODE_ROUTE_DIFF_PAIR, EDA_DRAW_PANEL_GAL::Refresh(), PCB_EDIT_FRAME::SetActiveLayer(), KIGFX::VIEW_CONTROLS::SetAutoPan(), APPEARANCE_CONTROLS::SetLayerVisible(), PNS_KICAD_IFACE_BASE::SetStartLayer(), EDA_BASE_FRAME::ShowInfoBarError(), PNS::ROUTER::Sizes(), PNS::ROUTER::StartRouting(), ToLAYER_ID(), PCB_BASE_EDIT_FRAME::UndoRedoBlock(), UpdateMessagePanel(), and PNS::ROUTER::UpdateSizes().

Referenced by performRouting().

Reset()

void ROUTER_TOOL::Reset ( RESET_REASON  aReason )

overridevirtual

Bring the tool to a known, initial state.

If the tool claimed anything from the model or the view, it must release it when its reset.

Parameters

aReason

contains information about the reason of tool reset.

Reimplemented from PNS::TOOL_BASE.

Definition at line 538 of file router_tool.cpp.

{
 m_lastTargetLayer = UNDEFINED_LAYER;
 
 if( aReason == RUN )
 TOOL_BASE::Reset( aReason );
}

References m_lastTargetLayer, TOOL_BASE::Reset(), TOOL_BASE::RUN, and UNDEFINED_LAYER.

resetTransitions()

void TOOL_INTERACTIVE::resetTransitions ( )

privateinherited

Clear the current transition map and restores the default one created by setTransitions().

Definition at line 63 of file tool_interactive.cpp.

{
 m_toolMgr->ClearTransitions( this );
 setTransitions();
}

References TOOL_MANAGER::ClearTransitions(), TOOL_BASE::m_toolMgr, and TOOL_INTERACTIVE::setTransitions().

Router()

ROUTER * TOOL_BASE::Router ( ) const

inherited

Definition at line 397 of file pns_tool_base.cpp.

{
 return m_router;
}

References PNS::TOOL_BASE::m_router.

Referenced by DRAWING_TOOL::DrawVia(), BOARD_EDITOR_CONTROL::TrackWidthDec(), and BOARD_EDITOR_CONTROL::TrackWidthInc().

RouteSelected()

int ROUTER_TOOL::RouteSelected

(

const TOOL_EVENT &

aEvent

)

Definition at line 1543 of file router_tool.cpp.

{
 PNS::ROUTER_MODE mode = aEvent.Parameter<PNS::ROUTER_MODE>();
 PCB_EDIT_FRAME* frame = getEditFrame<PCB_EDIT_FRAME>();
 VIEW_CONTROLS* controls = getViewControls();
 PCB_LAYER_ID originalLayer = frame->GetActiveLayer();
 bool autoRoute = aEvent.Matches( PCB_ACTIONS::routerAutorouteSelected.MakeEvent() );
 bool otherEnd = aEvent.Matches( PCB_ACTIONS::routerRouteSelectedFromEnd.MakeEvent() );
 
 if( m_router->RoutingInProgress() )
 return 0;
 
 // Save selection then clear it for interactive routing
 PCB_SELECTION selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
 if( selection.Size() == 0 )
 return 0;
 
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true );
 
 frame->PushTool( aEvent );
 
 auto setCursor =
 [&]()
 {
 frame->GetCanvas()->SetCurrentCursor( KICURSOR::PENCIL );
 };
 
 Activate();
 // Must be done after Activate() so that it gets set into the correct context
 controls->ShowCursor( true );
 controls->ForceCursorPosition( false );
 // Set initial cursor
 setCursor();
 
 // Get all connected board items, adding pads for any footprints selected
 std::vector<BOARD_CONNECTED_ITEM*> itemList;
 
 for( EDA_ITEM* item : selection.GetItemsSortedBySelectionOrder() )
 {
 if( item->Type() == PCB_FOOTPRINT_T )
 {
 const PADS& fpPads = ( static_cast<FOOTPRINT*>( item ) )->Pads();
 
 for( PAD* pad : fpPads )
 itemList.push_back( pad );
 }
 else if( dynamic_cast<BOARD_CONNECTED_ITEM*>( item ) != nullptr )
 {
 itemList.push_back( static_cast<BOARD_CONNECTED_ITEM*>( item ) );
 }
 }
 
 std::shared_ptr<CONNECTIVITY_DATA> connectivity = frame->GetBoard()->GetConnectivity();
 
 // For putting sequential tracks that successfully autoroute into one undo commit
 bool groupStart = true;
 
 for( BOARD_CONNECTED_ITEM* item : itemList )
 {
 // This code is similar to GetRatsnestForPad() but it only adds the anchor for
 // the side of the connectivity on this pad. It also checks for ratsnest points
 // inside the pad (like a trace end) and counts them.
 RN_NET* net = connectivity->GetRatsnestForNet( item->GetNetCode() );
 std::vector<std::shared_ptr<const CN_ANCHOR>> anchors;
 
 for( const CN_EDGE& edge : net->GetEdges() )
 {
 std::shared_ptr<const CN_ANCHOR> target = edge.GetTargetNode();
  std::shared_ptr<const CN_ANCHOR> source = edge.GetSourceNode();
 
 if( source->Parent() == item )
 anchors.push_back( edge.GetSourceNode() );
 else if( target->Parent() == item )
 anchors.push_back( edge.GetTargetNode() );
 }
 
 // Route them
 for( std::shared_ptr<const CN_ANCHOR> anchor : anchors )
 {
 // Try to return to the original layer as indicating the user's preferred
 // layer for autorouting tracks. The layer can be changed by the user to
 // finish tracks that can't complete automatically, but should be changed
 // back after.
 if( frame->GetActiveLayer() != originalLayer )
 frame->SetActiveLayer( originalLayer );
 
 VECTOR2I ignore;
 m_startItem = m_router->GetWorld()->FindItemByParent( anchor->Parent() );
 m_startSnapPoint = anchor->Pos();
 m_router->SetMode( mode );
 
 // Prime the interactive routing to attempt finish if we are autorouting
 bool autoRouted = false;
 
 if( autoRoute )
 m_toolMgr->RunAction( PCB_ACTIONS::routerAttemptFinish, false, &autoRouted );
 else if( otherEnd )
 m_toolMgr->RunAction( PCB_ACTIONS::routerContinueFromEnd, false );
 
 // We want autorouted tracks to all be in one undo group except for
 // any tracks that need to be manually finished.
 // The undo appending for manually finished tracks is handled in peformRouting()
 if( groupStart )
 groupStart = false;
 else
 m_iface->SetCommitFlags( APPEND_UNDO );
 
 // Start interactive routing. Will automatically finish if possible.
 performRouting();
 
 // Route didn't complete automatically, need to a new undo commit
 // for the next line so those can group as far as they autoroute
 if( !autoRouted )
 groupStart = true;
 }
 }
 
 m_iface->SetCommitFlags( 0 );
 frame->PopTool( aEvent );
 return 0;
}

References TOOL_INTERACTIVE::Activate(), anchor, APPEND_UNDO, PCB_TOOL_BASE::controls(), PNS::NODE::FindItemByParent(), KIGFX::VIEW_CONTROLS::ForceCursorPosition(), PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetActiveLayer(), PCB_BASE_FRAME::GetBoard(), PCB_BASE_FRAME::GetCanvas(), BOARD::GetConnectivity(), RN_NET::GetEdges(), SELECTION::GetItemsSortedBySelectionOrder(), TOOL_MANAGER::GetTool(), TOOL_BASE::getViewControls(), PNS::ROUTER::GetWorld(), PNS::TOOL_BASE::m_iface, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, PNS::TOOL_BASE::m_startSnapPoint, TOOL_BASE::m_toolMgr, TOOL_EVENT::Matches(), pad, TOOL_EVENT::Parameter(), PCB_FOOTPRINT_T, PENCIL, performRouting(), TOOLS_HOLDER::PopTool(), TOOLS_HOLDER::PushTool(), PCB_ACTIONS::routerAttemptFinish, PCB_ACTIONS::routerAutorouteSelected, PCB_ACTIONS::routerContinueFromEnd, PCB_ACTIONS::routerRouteSelectedFromEnd, PNS::ROUTER::RoutingInProgress(), TOOL_MANAGER::RunAction(), PCB_TOOL_BASE::selection(), PCB_ACTIONS::selectionClear, PCB_BASE_FRAME::SetActiveLayer(), PNS_KICAD_IFACE::SetCommitFlags(), EDA_DRAW_PANEL_GAL::SetCurrentCursor(), PNS::ROUTER::SetMode(), KIGFX::VIEW_CONTROLS::ShowCursor(), and SELECTION::Size().

Referenced by setTransitions().

RoutingInProgress()

bool ROUTER_TOOL::RoutingInProgress

(

)

Returns whether routing is currently active.

Returns

True if actively routing, false if not routing or tool is activated and idle.

Definition at line 1530 of file router_tool.cpp.

{
 return m_router->RoutingInProgress();
}

References PNS::TOOL_BASE::m_router, and PNS::ROUTER::RoutingInProgress().

Referenced by EDIT_TOOL::isRouterActive(), and PCB_SELECTION_TOOL::Main().

RunMainStack()

void TOOL_INTERACTIVE::RunMainStack ( std::function< void()>  aFunc )

inherited

Call a function using the main stack.

Parameters

aFunc

is the function to be calls.

Definition at line 87 of file tool_interactive.cpp.

{
 m_toolMgr->RunMainStack( this, std::move( aFunc ) );
}

References TOOL_BASE::m_toolMgr, and TOOL_MANAGER::RunMainStack().

Referenced by DRAWING_TOOL::PlaceText().

saveRouterDebugLog()

void ROUTER_TOOL::saveRouterDebugLog ( )

private

Definition at line 549 of file router_tool.cpp.

{
 auto logger = m_router->Logger();
 
 if( ! logger )
 return;
 
 wxString cwd = wxGetCwd();
 
 wxFileName fname_log;
 fname_log.SetPath( cwd );
 fname_log.SetName( "pns.log" );
 
 wxFileName fname_dump( cwd );
 fname_dump.SetPath( cwd );
 fname_dump.SetName( "pns.dump" );
 
 wxFileName fname_settings( cwd );
 fname_settings.SetPath( cwd );
 fname_settings.SetName( "pns.settings" );
 
 wxString msg = wxString::Format( _( "Event file: %s\nBoard dump: %s" ), fname_log.GetFullPath(), fname_log.GetFullPath() );
 
 int rv = OKOrCancelDialog( nullptr, _("Save router log"), _("Would you like to save the router\nevent log for debugging purposes?"), msg, _("OK"), _("Cancel") );
 
 if( !rv )
 return;
 
 FILE *f = fopen( fname_settings.GetFullPath().c_str(), "wb" );
 std::string settingsStr = m_router->Settings().FormatAsString();
 fprintf(f,"%s\n", settingsStr.c_str( ) );
 fclose(f);
 
 f = fopen( fname_log.GetFullPath().c_str(), "wb" );
 
 fprintf(f, "mode %d\n", m_router->Mode() );
 
 const auto& events = logger->GetEvents();
 
 for( const auto& evt : events)
 {
 fprintf( f, "event %d %d %d %s %d %d %d %d %d %d %d\n", evt.p.x, evt.p.y, evt.type,
 static_cast<const char*>( evt.uuid.AsString().c_str() ),
 evt.sizes.TrackWidth(),
 evt.sizes.ViaDiameter(),
 evt.sizes.ViaDrill(),
 evt.sizes.TrackWidthIsExplicit() ? 1: 0,
 evt.sizes.GetLayerBottom(),
 evt.sizes.GetLayerTop(),
 static_cast<int>( evt.sizes.ViaType() ) );
 }
 
 // Export as *.kicad_pcb format, using a strategy which is specifically chosen
 // as an example on how it could also be used to send it to the system clipboard.
 
 PCB_PLUGIN pcb_io;
 
 pcb_io.Save( fname_dump.GetFullPath(), m_iface->GetBoard(), nullptr );
 
 PROJECT* prj = m_iface->GetBoard()->GetProject();
 prj->GetProjectFile().SaveAs( cwd, "pns" );
 
 std::vector<PNS::ITEM*> added, removed, heads;
 m_router->GetUpdatedItems( removed, added, heads );
 
 for( auto item : removed )
 {
 fprintf(f, "removed %s\n", item->Parent()->m_Uuid.AsString().c_str().AsChar() );
 }
 
 for( auto item : added )
 {
 fprintf(f, "added %s\n", item->Format().c_str() );
 }
 
 for( auto item : heads )
 {
 fprintf(f, "head %s\n", item->Format().c_str() );
 }
 
 fclose( f );
}

References _, Format(), JSON_SETTINGS::FormatAsString(), PNS_KICAD_IFACE_BASE::GetBoard(), BOARD::GetProject(), PROJECT::GetProjectFile(), PNS::ROUTER::GetUpdatedItems(), PNS::ROUTER::Logger(), PNS::TOOL_BASE::m_iface, PNS::TOOL_BASE::m_router, PNS::ROUTER::Mode(), OKOrCancelDialog(), PCB_PLUGIN::Save(), PROJECT_FILE::SaveAs(), and PNS::ROUTER::Settings().

Referenced by handleCommonEvents().

SelectCopperLayerPair()

int ROUTER_TOOL::SelectCopperLayerPair

(

const TOOL_EVENT &

aEvent

)

Definition at line 326 of file sel_layer.cpp.

{
 PCB_SCREEN* screen = frame()->GetScreen();
 
 SELECT_COPPER_LAYERS_PAIR_DIALOG dlg( frame(), frame()->GetBoard(), screen->m_Route_Layer_TOP,
 screen->m_Route_Layer_BOTTOM );
 
 if( dlg.ShowModal() == wxID_OK )
 {
 dlg.GetLayerPair( screen->m_Route_Layer_TOP, screen->m_Route_Layer_BOTTOM );
 
 // select the same layer for both layers is allowed (normal in some boards)
 // but could be a mistake. So display an info message
 if( screen->m_Route_Layer_TOP == screen->m_Route_Layer_BOTTOM )
 DisplayInfoMessage( frame(), _( "Warning: top and bottom layers are same." ) );
 }
 
 return 0;
}

References _, DisplayInfoMessage(), PCB_TOOL_BASE::frame(), GetBoard(), SELECT_COPPER_LAYERS_PAIR_DIALOG::GetLayerPair(), PCB_BASE_FRAME::GetScreen(), PCB_SCREEN::m_Route_Layer_BOTTOM, and PCB_SCREEN::m_Route_Layer_TOP.

Referenced by setTransitions().

selection() [1/2]

PCB_SELECTION & PCB_TOOL_BASE::selection ( )

protectedinherited

Definition at line 324 of file pcb_tool_base.cpp.

{
 PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 
 return selTool->GetSelection();
}

References PCB_SELECTION_TOOL::GetSelection(), TOOL_MANAGER::GetTool(), and TOOL_BASE::m_toolMgr.

selection() [2/2]

const PCB_SELECTION & PCB_TOOL_BASE::selection ( ) const

protectedinherited

Definition at line 316 of file pcb_tool_base.cpp.

{
 PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 
 return selTool->GetSelection();
}

References PCB_SELECTION_TOOL::GetSelection(), TOOL_MANAGER::GetTool(), and TOOL_BASE::m_toolMgr.

Referenced by BOARD_EDITOR_CONTROL::AssignNetclass(), AUTOPLACE_TOOL::autoplaceSelected(), BOARD_INSPECTION_TOOL::calculateSelectionRatsnest(), CanInlineDrag(), EDIT_TOOL::ChangeTrackWidth(), PAD_TOOL::copyPadSettings(), EDIT_TOOL::copyToClipboard(), EDIT_TOOL::CreateArray(), DRC_TOOL::CrossProbe(), BOARD_EDITOR_CONTROL::doCrossProbePcbToSch(), BOARD_INSPECTION_TOOL::doHideRatsnestNet(), PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::Drag(), EDIT_TOOL::DragArcTrack(), DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawDimension(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::drawShape(), DRAWING_TOOL::DrawZone(), EDIT_TOOL::Duplicate(), BOARD_EDITOR_CONTROL::EditFpInFpEditor(), PAD_TOOL::EditPad(), GROUP_TOOL::EnterGroup(), PAD_TOOL::EnumeratePads(), GLOBAL_EDIT_TOOL::ExchangeFootprints(), EDIT_TOOL::FilletLines(), EDIT_TOOL::FilletTracks(), EDIT_TOOL::Flip(), DRAWING_TOOL::getSourceZoneForAction(), GROUP_TOOL::Group(), BOARD_INSPECTION_TOOL::highlightNet(), InlineBreakTrack(), InlineDrag(), BOARD_INSPECTION_TOOL::InspectClearance(), BOARD_INSPECTION_TOOL::InspectConstraints(), DRAWING_TOOL::InteractivePlaceWithPreview(), BOARD_INSPECTION_TOOL::LocalRatsnestTool(), LENGTH_TUNER_TOOL::MainLoop(), MainLoop(), EDIT_TOOL::Mirror(), BOARD_EDITOR_CONTROL::modifyLockSelected(), EDIT_TOOL::MoveExact(), PCB_POINT_EDITOR::OnSelectionChange(), EDIT_TOOL::PackAndMoveFootprints(), PAD_TOOL::pastePadProperties(), performDragging(), performRouting(), LENGTH_TUNER_TOOL::performTuning(), PCB_CONTROL::placeBoardItems(), BOARD_EDITOR_CONTROL::PlaceFootprint(), DRAWING_TOOL::PlaceImportedGraphics(), DRAWING_TOOL::PlaceText(), POSITION_RELATIVE_TOOL::PositionRelative(), EDIT_TOOL::Properties(), PAD_TOOL::pushPadSettings(), BOARD_REANNOTATE_TOOL::ReannotateDuplicatesInSelection(), GROUP_TOOL::RemoveFromGroup(), GLOBAL_EDIT_TOOL::RemoveUnusedPads(), EDIT_TOOL::Rotate(), RouteSelected(), DRAWING_TOOL::SetAnchor(), EDIT_TOOL::Swap(), BOARD_EDITOR_CONTROL::TrackWidthDec(), BOARD_EDITOR_CONTROL::TrackWidthInc(), GROUP_TOOL::Ungroup(), BOARD_INSPECTION_TOOL::UpdateLocalRatsnest(), PCB_CONTROL::UpdateMessagePanel(), BOARD_EDITOR_CONTROL::ViaSizeDec(), BOARD_EDITOR_CONTROL::ViaSizeInc(), BOARD_EDITOR_CONTROL::ZoneDuplicate(), ZONE_FILLER_TOOL::ZoneFill(), BOARD_EDITOR_CONTROL::ZoneMerge(), and ZONE_FILLER_TOOL::ZoneUnfill().

SetContextMenu()

void TOOL_INTERACTIVE::SetContextMenu ( ACTION_MENU *  aMenu, CONTEXT_MENU_TRIGGER  aTrigger = CMENU_BUTTON  )

inherited

Assign a context menu and tells when it should be activated.

Parameters

aMenu	is the menu to be assigned.
aTrigger	determines conditions upon which the context menu is activated.

Definition at line 76 of file tool_interactive.cpp.

{
 if( aMenu )
 aMenu->SetTool( this );
 else
 aTrigger = CMENU_OFF;
 
 m_toolMgr->ScheduleContextMenu( this, aMenu, aTrigger );
}

References CMENU_OFF, TOOL_BASE::m_toolMgr, TOOL_MANAGER::ScheduleContextMenu(), and ACTION_MENU::SetTool().

Referenced by SELECTION_TOOL::doSelectionMenu(), TOOL_MENU::ShowContextMenu(), and SCH_LINE_WIRE_BUS_TOOL::UnfoldBus().

SetIsBoardEditor()

void PCB_TOOL_BASE::SetIsBoardEditor ( bool  aEnabled )

inlineinherited

Definition at line 108 of file pcb_tool_base.h.

{ m_isBoardEditor = aEnabled; }

References PCB_TOOL_BASE::m_isBoardEditor.

SetIsFootprintEditor()

void PCB_TOOL_BASE::SetIsFootprintEditor ( bool  aEnabled )

inlineinherited

Function SetIsFootprintEditor()

Toggles edit footprint mode. When enabled, one may select parts of footprints individually (graphics, pads, etc.), so they can be modified.

Parameters

aEnabled

decides if the mode should be enabled.

Definition at line 105 of file pcb_tool_base.h.

{ m_isFootprintEditor = aEnabled; }

References PCB_TOOL_BASE::m_isFootprintEditor.

SettingsDialog()

int ROUTER_TOOL::SettingsDialog

(

const TOOL_EVENT &

aEvent

)

Definition at line 1483 of file router_tool.cpp.

{
 DIALOG_PNS_SETTINGS settingsDlg( frame(), m_router->Settings() );
 
 settingsDlg.ShowModal();
 
 UpdateMessagePanel();
 
 return 0;
}

References PCB_TOOL_BASE::frame(), PNS::TOOL_BASE::m_router, PNS::ROUTER::Settings(), and UpdateMessagePanel().

Referenced by setTransitions().

setTransitions()

void ROUTER_TOOL::setTransitions ( )

overridevirtual

This method is meant to be overridden in order to specify handlers for events.

It is called every time tool is reset or finished.

Reimplemented from PCB_TOOL_BASE.

Definition at line 2584 of file router_tool.cpp.

{
 Go( &ROUTER_TOOL::SelectCopperLayerPair, PCB_ACTIONS::selectLayerPair.MakeEvent() );
 
 Go( &ROUTER_TOOL::MainLoop, PCB_ACTIONS::routeSingleTrack.MakeEvent() );
 Go( &ROUTER_TOOL::MainLoop, PCB_ACTIONS::routeDiffPair.MakeEvent() );
 Go( &ROUTER_TOOL::RouteSelected, PCB_ACTIONS::routerRouteSelected.MakeEvent() );
 Go( &ROUTER_TOOL::RouteSelected, PCB_ACTIONS::routerRouteSelectedFromEnd.MakeEvent() );
 Go( &ROUTER_TOOL::RouteSelected, PCB_ACTIONS::routerAutorouteSelected.MakeEvent() );
 Go( &ROUTER_TOOL::DpDimensionsDialog, PCB_ACTIONS::routerDiffPairDialog.MakeEvent() );
 Go( &ROUTER_TOOL::SettingsDialog, PCB_ACTIONS::routerSettingsDialog.MakeEvent() );
 Go( &ROUTER_TOOL::ChangeRouterMode, PCB_ACTIONS::routerHighlightMode.MakeEvent() );
 Go( &ROUTER_TOOL::ChangeRouterMode, PCB_ACTIONS::routerShoveMode.MakeEvent() );
 Go( &ROUTER_TOOL::ChangeRouterMode, PCB_ACTIONS::routerWalkaroundMode.MakeEvent() );
 Go( &ROUTER_TOOL::CycleRouterMode, PCB_ACTIONS::cycleRouterMode.MakeEvent() );
 Go( &ROUTER_TOOL::InlineDrag, PCB_ACTIONS::routerInlineDrag.MakeEvent() );
 Go( &ROUTER_TOOL::InlineBreakTrack, PCB_ACTIONS::breakTrack.MakeEvent() );
 
 Go( &ROUTER_TOOL::onViaCommand, ACT_PlaceThroughVia.MakeEvent() );
 Go( &ROUTER_TOOL::onViaCommand, ACT_PlaceBlindVia.MakeEvent() );
 Go( &ROUTER_TOOL::onViaCommand, ACT_PlaceMicroVia.MakeEvent() );
 Go( &ROUTER_TOOL::onViaCommand, ACT_SelLayerAndPlaceThroughVia.MakeEvent() );
 Go( &ROUTER_TOOL::onViaCommand, ACT_SelLayerAndPlaceBlindVia.MakeEvent() );
 Go( &ROUTER_TOOL::onViaCommand, ACT_SelLayerAndPlaceMicroVia.MakeEvent() );
 
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerTop.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner1.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner2.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner3.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner4.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner5.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner6.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner7.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner8.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner9.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner10.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner11.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner12.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner13.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner14.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner15.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner16.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner17.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner18.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner19.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner20.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner21.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner22.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner23.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner24.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner25.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner26.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner27.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner28.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner29.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerInner30.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerBottom.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerNext.MakeEvent() );
 Go( &ROUTER_TOOL::onLayerCommand, PCB_ACTIONS::layerPrev.MakeEvent() );
 
 Go( &ROUTER_TOOL::CustomTrackWidthDialog, ACT_CustomTrackWidth.MakeEvent() );
 Go( &ROUTER_TOOL::onTrackViaSizeChanged, PCB_ACTIONS::trackViaSizeChanged.MakeEvent() );
}

References ACT_CustomTrackWidth, ACT_PlaceBlindVia, ACT_PlaceMicroVia, ACT_PlaceThroughVia, ACT_SelLayerAndPlaceBlindVia, ACT_SelLayerAndPlaceMicroVia, ACT_SelLayerAndPlaceThroughVia, PCB_ACTIONS::breakTrack, ChangeRouterMode(), CustomTrackWidthDialog(), CycleRouterMode(), PCB_ACTIONS::cycleRouterMode, DpDimensionsDialog(), TOOL_INTERACTIVE::Go(), InlineBreakTrack(), InlineDrag(), PCB_ACTIONS::layerBottom, PCB_ACTIONS::layerInner1, PCB_ACTIONS::layerInner10, PCB_ACTIONS::layerInner11, PCB_ACTIONS::layerInner12, PCB_ACTIONS::layerInner13, PCB_ACTIONS::layerInner14, PCB_ACTIONS::layerInner15, PCB_ACTIONS::layerInner16, PCB_ACTIONS::layerInner17, PCB_ACTIONS::layerInner18, PCB_ACTIONS::layerInner19, PCB_ACTIONS::layerInner2, PCB_ACTIONS::layerInner20, PCB_ACTIONS::layerInner21, PCB_ACTIONS::layerInner22, PCB_ACTIONS::layerInner23, PCB_ACTIONS::layerInner24, PCB_ACTIONS::layerInner25, PCB_ACTIONS::layerInner26, PCB_ACTIONS::layerInner27, PCB_ACTIONS::layerInner28, PCB_ACTIONS::layerInner29, PCB_ACTIONS::layerInner3, PCB_ACTIONS::layerInner30, PCB_ACTIONS::layerInner4, PCB_ACTIONS::layerInner5, PCB_ACTIONS::layerInner6, PCB_ACTIONS::layerInner7, PCB_ACTIONS::layerInner8, PCB_ACTIONS::layerInner9, PCB_ACTIONS::layerNext, PCB_ACTIONS::layerPrev, PCB_ACTIONS::layerTop, MainLoop(), TOOL_ACTION::MakeEvent(), onLayerCommand(), onTrackViaSizeChanged(), onViaCommand(), PCB_ACTIONS::routeDiffPair, PCB_ACTIONS::routerAutorouteSelected, PCB_ACTIONS::routerDiffPairDialog, PCB_ACTIONS::routerHighlightMode, PCB_ACTIONS::routerInlineDrag, PCB_ACTIONS::routerRouteSelected, PCB_ACTIONS::routerRouteSelectedFromEnd, PCB_ACTIONS::routerSettingsDialog, PCB_ACTIONS::routerShoveMode, PCB_ACTIONS::routerWalkaroundMode, RouteSelected(), PCB_ACTIONS::routeSingleTrack, SelectCopperLayerPair(), PCB_ACTIONS::selectLayerPair, SettingsDialog(), and PCB_ACTIONS::trackViaSizeChanged.

snapToItem()

const VECTOR2I TOOL_BASE::snapToItem ( ITEM *  aSnapToItem, const VECTOR2I &  aP  )

protectedinherited

Definition at line 403 of file pns_tool_base.cpp.

{
 if( !aItem || !m_iface->IsItemVisible( aItem ) )
 {
 return m_gridHelper->Align( aP );
 }
 
 switch( aItem->Kind() )
 {
 case ITEM::SOLID_T:
 return static_cast<SOLID*>( aItem )->Pos();
 
 case ITEM::VIA_T:
 return static_cast<VIA*>( aItem )->Pos();
 
 case ITEM::SEGMENT_T:
 case ITEM::ARC_T:
 {
 LINKED_ITEM* li = static_cast<LINKED_ITEM*>( aItem );
 VECTOR2I A = li->Anchor( 0 );
 VECTOR2I B = li->Anchor( 1 );
 SEG::ecoord w_sq = SEG::Square( li->Width() / 2 );
 SEG::ecoord distA_sq = ( aP - A ).SquaredEuclideanNorm();
 SEG::ecoord distB_sq = ( aP - B ).SquaredEuclideanNorm();
 
 if( distA_sq < w_sq || distB_sq < w_sq )
 {
 return ( distA_sq < distB_sq ) ? A : B;
 }
 else if( aItem->Kind() == ITEM::SEGMENT_T )
 {
 // TODO(snh): Clean this up
 SEGMENT* seg = static_cast<SEGMENT*>( li );
 return m_gridHelper->AlignToSegment( aP, seg->Seg() );
 }
 else if( aItem->Kind() == ITEM::ARC_T )
 {
 ARC* arc = static_cast<ARC*>( li );
 return m_gridHelper->AlignToArc( aP, *static_cast<const SHAPE_ARC*>( arc->Shape() ) );
 }
 
 break;
 }
 
 default:
 break;
 }
 
 return m_gridHelper->Align( aP );
}

References GRID_HELPER::Align(), PCB_GRID_HELPER::AlignToArc(), PCB_GRID_HELPER::AlignToSegment(), PNS::ITEM::Anchor(), PNS::ITEM::ARC_T, PNS_KICAD_IFACE::IsItemVisible(), PNS::ITEM::Kind(), PNS::TOOL_BASE::m_gridHelper, PNS::TOOL_BASE::m_iface, PNS::SEGMENT::Seg(), PNS::ITEM::SEGMENT_T, PNS::ARC::Shape(), PNS::ITEM::SOLID_T, SEG::Square(), PNS::ITEM::VIA_T, and PNS::LINKED_ITEM::Width().

Referenced by InlineBreakTrack(), InlineDrag(), PNS::TOOL_BASE::updateEndItem(), and PNS::TOOL_BASE::updateStartItem().

switchLayerOnViaPlacement()

void ROUTER_TOOL::switchLayerOnViaPlacement ( )

private

Definition at line 678 of file router_tool.cpp.

{
 int activeLayer = frame()->GetActiveLayer();
 int currentLayer = m_router->GetCurrentLayer();
 
 if( currentLayer != activeLayer )
 m_router->SwitchLayer( activeLayer );
 
 std::optional<int> newLayer = m_router->Sizes().PairedLayer( currentLayer );
 
 if( !newLayer )
 newLayer = m_router->Sizes().GetLayerTop();
 
 m_router->SwitchLayer( *newLayer );
 m_lastTargetLayer = *newLayer;
 
 updateSizesAfterLayerSwitch( ToLAYER_ID( *newLayer ) );
}

References PCB_TOOL_BASE::frame(), PCB_BASE_FRAME::GetActiveLayer(), PNS::ROUTER::GetCurrentLayer(), PNS::SIZES_SETTINGS::GetLayerTop(), m_lastTargetLayer, PNS::TOOL_BASE::m_router, PNS::SIZES_SETTINGS::PairedLayer(), PNS::ROUTER::Sizes(), PNS::ROUTER::SwitchLayer(), ToLAYER_ID(), and updateSizesAfterLayerSwitch().

Referenced by performRouting().

updateEndItem()

void TOOL_BASE::updateEndItem ( const TOOL_EVENT &  aEvent )

protectedvirtualinherited

Definition at line 328 of file pns_tool_base.cpp.

{
 int layer;
 GAL* gal = m_toolMgr->GetView()->GetGAL();
 
 m_gridHelper->SetUseGrid( gal->GetGridSnapping() && !aEvent.DisableGridSnapping() );
 m_gridHelper->SetSnap( !aEvent.Modifier( MD_SHIFT ) );
 
 controls()->ForceCursorPosition( false );
 
 VECTOR2I mousePos = controls()->GetMousePosition();
 
 if( m_router->GetState() == ROUTER::ROUTE_TRACK && aEvent.IsDrag() )
 {
 // If the user is moving the mouse quickly while routing then clicks will come in as
 // short drags. In this case we want to use the drag origin rather than the current
 // mouse position.
 mousePos = aEvent.DragOrigin();
 }
 
 if( m_router->Settings().Mode() != RM_MarkObstacles &&
 ( m_router->GetCurrentNets().empty() || m_router->GetCurrentNets().front() < 0 ) )
 {
 m_endSnapPoint = snapToItem( nullptr, mousePos );
 controls()->ForceCursorPosition( true, m_endSnapPoint );
 m_endItem = nullptr;
 
 return;
 }
 
 if( m_router->IsPlacingVia() )
 layer = -1;
 else
 layer = m_router->GetCurrentLayer();
 
 ITEM* endItem = nullptr;
 
 std::vector<int> nets = m_router->GetCurrentNets();
 
 for( int net : nets )
 {
 endItem = pickSingleItem( mousePos, net, layer, false, { m_startItem } );
 
 if( endItem )
 break;
 }
 
 if( m_gridHelper->GetSnap() && checkSnap( endItem ) )
 {
 m_endItem = endItem;
 m_endSnapPoint = snapToItem( endItem, mousePos );
 }
 else
 {
 m_endItem = nullptr;
 m_endSnapPoint = m_gridHelper->Align( mousePos );
 }
 
 controls()->ForceCursorPosition( true, m_endSnapPoint );
 
 if( m_endItem )
 {
 wxLogTrace( wxT( "PNS" ), wxT( "%s, layer : %d" ),
 m_endItem->KindStr().c_str(),
 m_endItem->Layers().Start() );
 }
}

References GRID_HELPER::Align(), PNS::TOOL_BASE::checkSnap(), PCB_TOOL_BASE::controls(), TOOL_EVENT::DisableGridSnapping(), TOOL_EVENT::DragOrigin(), KIGFX::VIEW_CONTROLS::ForceCursorPosition(), PNS::ROUTER::GetCurrentLayer(), PNS::ROUTER::GetCurrentNets(), KIGFX::VIEW::GetGAL(), KIGFX::GAL::GetGridSnapping(), KIGFX::VIEW_CONTROLS::GetMousePosition(), GRID_HELPER::GetSnap(), PNS::ROUTER::GetState(), TOOL_MANAGER::GetView(), TOOL_EVENT::IsDrag(), PNS::ROUTER::IsPlacingVia(), PNS::ITEM::KindStr(), PNS::ITEM::Layers(), PNS::TOOL_BASE::m_endItem, PNS::TOOL_BASE::m_endSnapPoint, PNS::TOOL_BASE::m_gridHelper, PNS::TOOL_BASE::m_router, PNS::TOOL_BASE::m_startItem, TOOL_BASE::m_toolMgr, MD_SHIFT, PNS::ROUTING_SETTINGS::Mode(), TOOL_EVENT::Modifier(), PNS::TOOL_BASE::pickSingleItem(), PNS::RM_MarkObstacles, PNS::ROUTER::ROUTE_TRACK, GRID_HELPER::SetSnap(), PNS::ROUTER::Settings(), GRID_HELPER::SetUseGrid(), PNS::TOOL_BASE::snapToItem(), and LAYER_RANGE::Start().

Referenced by handleLayerSwitch(), InlineDrag(), onTrackViaSizeChanged(), onViaCommand(), performDragging(), and performRouting().

UpdateMessagePanel()

void ROUTER_TOOL::UpdateMessagePanel

(

)

Definition at line 2465 of file router_tool.cpp.

{
 std::vector<MSG_PANEL_ITEM> items;
 
 if( m_router->GetState() == PNS::ROUTER::ROUTE_TRACK )
 {
 PNS::SIZES_SETTINGS sizes( m_router->Sizes() );
 PNS::RULE_RESOLVER* resolver = m_iface->GetRuleResolver();
 std::vector<int> nets = m_router->GetCurrentNets();
 wxString description;
 wxString secondary;
 
 if( m_router->Mode() == PNS::ROUTER_MODE::PNS_MODE_ROUTE_DIFF_PAIR )
 {
 wxASSERT( nets.size() >= 2 );
 
 NETINFO_ITEM* netA = board()->FindNet( nets[0] );
 NETINFO_ITEM* netB = board()->FindNet( nets[1] );
 wxASSERT( netA );
 wxASSERT( netB );
 
 description = wxString::Format( _( "Routing Diff Pair: %s" ),
 netA->GetNetname() + wxT( ", " ) + netB->GetNetname() );
 
 wxString netclass;
 NETCLASS* netclassA = netA->GetNetClass();
 NETCLASS* netclassB = netB->GetNetClass();
 
 if( netclassA == netclassB )
 netclass = netclassA->GetName();
 else
 netclass = netclassA->GetName() + wxT( ", " ) + netclassB->GetName();
 
 secondary = wxString::Format( _( "Resolved Netclass: %s" ),
 UnescapeString( netclass ) );
 }
 else if( !nets.empty() )
 {
 NETINFO_ITEM* net = board()->FindNet( nets[0] );
 wxASSERT( net );
 
 description = wxString::Format( _( "Routing Track: %s" ),
 net->GetNetname() );
 
 secondary = wxString::Format( _( "Resolved Netclass: %s" ),
 UnescapeString( net->GetNetClass()->GetName() ) );
 }
 else
 {
 description = _( "Routing Track" );
 secondary = _( "(no net)" );
 }
 
 items.emplace_back( description, secondary );
 
 wxString cornerMode;
 
 if( m_router->Settings().GetFreeAngleMode() )
 {
 cornerMode = _( "Free-angle" );
 }
 else
 {
 switch( m_router->Settings().GetCornerMode() )
 {
 case DIRECTION_45::CORNER_MODE::MITERED_45: cornerMode = _( "45-degree" ); break;
 case DIRECTION_45::CORNER_MODE::ROUNDED_45: cornerMode = _( "45-degree rounded" ); break;
 case DIRECTION_45::CORNER_MODE::MITERED_90: cornerMode = _( "90-degree" ); break;
 case DIRECTION_45::CORNER_MODE::ROUNDED_90: cornerMode = _( "90-degree rounded" ); break;
 default: break;
 }
 }
 
 items.emplace_back( _( "Corner Style" ), cornerMode );
 
#define FORMAT_VALUE( x ) frame()->MessageTextFromValue( x )
 
 if( m_router->Mode() == PNS::ROUTER_MODE::PNS_MODE_ROUTE_DIFF_PAIR )
 {
 items.emplace_back( wxString::Format( _( "Track Width: %s" ),
 FORMAT_VALUE( sizes.DiffPairWidth() ) ),
 wxString::Format( _( "(from %s)" ),
 sizes.GetDiffPairWidthSource() ) );
 
 items.emplace_back( wxString::Format( _( "Min Clearance: %s" ),
 FORMAT_VALUE( sizes.Clearance() ) ),
 wxString::Format( _( "(from %s)" ),
 sizes.GetClearanceSource() ) );
 
 items.emplace_back( wxString::Format( _( "Diff Pair Gap: %s" ),
 FORMAT_VALUE( sizes.DiffPairGap() ) ),
 wxString::Format( _( "(from %s)" ),
 sizes.GetDiffPairGapSource() ) );
 }
 else
 {
 items.emplace_back( wxString::Format( _( "Track Width: %s" ),
 FORMAT_VALUE( sizes.TrackWidth() ) ),
 wxString::Format( _( "(from %s)" ),
 sizes.GetWidthSource() ) );
 
 items.emplace_back( wxString::Format( _( "Min Clearance: %s" ),
 FORMAT_VALUE( sizes.Clearance() ) ),
 wxString::Format( _( "(from %s)" ),
 sizes.GetClearanceSource() ) );
 }
 
#undef FORMAT_VALUE
 
 frame()->SetMsgPanel( items );
 }
 else
 {
 frame()->SetMsgPanel( board() );
 return;
 }
}

References _, PCB_TOOL_BASE::board(), PNS::SIZES_SETTINGS::Clearance(), PNS::SIZES_SETTINGS::DiffPairGap(), PNS::SIZES_SETTINGS::DiffPairWidth(), BOARD::FindNet(), Format(), FORMAT_VALUE, PCB_TOOL_BASE::frame(), PNS::SIZES_SETTINGS::GetClearanceSource(), PNS::ROUTING_SETTINGS::GetCornerMode(), PNS::ROUTER::GetCurrentNets(), PNS::SIZES_SETTINGS::GetDiffPairGapSource(), PNS::SIZES_SETTINGS::GetDiffPairWidthSource(), PNS::ROUTING_SETTINGS::GetFreeAngleMode(), NETCLASS::GetName(), NETINFO_ITEM::GetNetClass(), NETINFO_ITEM::GetNetname(), PNS_KICAD_IFACE_BASE::GetRuleResolver(), PNS::ROUTER::GetState(), PNS::SIZES_SETTINGS::GetWidthSource(), PNS::TOOL_BASE::m_iface, PNS::TOOL_BASE::m_router, PNS::ROUTER::Mode(), PNS::PNS_MODE_ROUTE_DIFF_PAIR, resolver, PNS::ROUTER::ROUTE_TRACK, EDA_DRAW_FRAME::SetMsgPanel(), PNS::ROUTER::Settings(), PNS::ROUTER::Sizes(), PNS::SIZES_SETTINGS::TrackWidth(), and UnescapeString().

Referenced by finishInteractive(), onTrackViaSizeChanged(), performRouting(), prepareInteractive(), and SettingsDialog().

updateSizesAfterLayerSwitch()

void ROUTER_TOOL::updateSizesAfterLayerSwitch ( PCB_LAYER_ID  targetLayer )

private

Definition at line 698 of file router_tool.cpp.

{
 std::vector<int> nets = m_router->GetCurrentNets();
 
 PNS::SIZES_SETTINGS sizes = m_router->Sizes();
 BOARD_DESIGN_SETTINGS& bds = board()->GetDesignSettings();
 std::shared_ptr<DRC_ENGINE>& drcEngine = bds.m_DRCEngine;
 DRC_CONSTRAINT constraint;
 
 PCB_TRACK dummyTrack( board() );
 dummyTrack.SetLayer( targetLayer );
 dummyTrack.SetNetCode( nets.empty() ? 0 : nets[0] );
 
 if( bds.UseNetClassTrack() || !sizes.TrackWidthIsExplicit() )
 {
 constraint = drcEngine->EvalRules( TRACK_WIDTH_CONSTRAINT, &dummyTrack, nullptr,
 targetLayer );
 
 if( !constraint.IsNull() )
 {
 int width = sizes.TrackWidth();
 
 // Only change the size if we're explicitly using the net class, or we're out of range
 // for our new constraints. Otherwise, just leave the track width alone so we don't
 // change for no reason.
 if( bds.UseNetClassTrack()
 || ( width < bds.m_TrackMinWidth )
 || ( width < constraint.m_Value.Min() )
 || ( width > constraint.m_Value.Max() ) )
 {
 sizes.SetTrackWidth( std::max( bds.m_TrackMinWidth, constraint.m_Value.Opt() ) );
 }
 
 if( sizes.TrackWidth() == constraint.m_Value.Opt() )
 sizes.SetWidthSource( constraint.GetName() );
 else if( sizes.TrackWidth() == bds.m_TrackMinWidth )
 sizes.SetWidthSource( _( "board minimum track width" ) );
 else
 sizes.SetWidthSource( _( "existing track" ) );
 }
 }
 
 if( nets.size() >= 2 && ( bds.UseNetClassDiffPair() || !sizes.TrackWidthIsExplicit() ) )
 {
 PCB_TRACK dummyTrackB( board() );
 dummyTrackB.SetLayer( targetLayer );
 dummyTrackB.SetNetCode( nets[1] );
 
 constraint = drcEngine->EvalRules( TRACK_WIDTH_CONSTRAINT, &dummyTrack, &dummyTrackB,
 targetLayer );
 
 if( !constraint.IsNull() )
 {
 sizes.SetDiffPairWidth( std::max( bds.m_TrackMinWidth, constraint.m_Value.Opt() ) );
 
 if( sizes.DiffPairWidth() == constraint.m_Value.Opt() )
 sizes.SetDiffPairWidthSource( constraint.GetName() );
 else
 sizes.SetDiffPairWidthSource( _( "board minimum track width" ) );
 }
 
 constraint = drcEngine->EvalRules( DIFF_PAIR_GAP_CONSTRAINT, &dummyTrack, &dummyTrackB,
 targetLayer );
 
 if( !constraint.IsNull() )
 {
 sizes.SetDiffPairGap( std::max( bds.m_MinClearance, constraint.m_Value.Opt() ) );
 
 if( sizes.DiffPairGap() == constraint.m_Value.Opt() )
 sizes.SetDiffPairGapSource( constraint.GetName() );
 else
 sizes.SetDiffPairGapSource( _( "board minimum clearance" ) );
 }
 }
 
 m_router->UpdateSizes( sizes );
}

References _, PCB_TOOL_BASE::board(), DIFF_PAIR_GAP_CONSTRAINT, PNS::SIZES_SETTINGS::DiffPairGap(), PNS::SIZES_SETTINGS::DiffPairWidth(), PNS::ROUTER::GetCurrentNets(), BOARD::GetDesignSettings(), DRC_CONSTRAINT::GetName(), DRC_CONSTRAINT::IsNull(), BOARD_DESIGN_SETTINGS::m_DRCEngine, BOARD_DESIGN_SETTINGS::m_MinClearance, PNS::TOOL_BASE::m_router, BOARD_DESIGN_SETTINGS::m_TrackMinWidth, DRC_CONSTRAINT::m_Value, MINOPTMAX< T >::Max(), MINOPTMAX< T >::Min(), MINOPTMAX< T >::Opt(), PNS::SIZES_SETTINGS::SetDiffPairGap(), PNS::SIZES_SETTINGS::SetDiffPairGapSource(), PNS::SIZES_SETTINGS::SetDiffPairWidth(), PNS::SIZES_SETTINGS::SetDiffPairWidthSource(), BOARD_ITEM::SetLayer(), BOARD_CONNECTED_ITEM::SetNetCode(), PNS::SIZES_SETTINGS::SetTrackWidth(), PNS::SIZES_SETTINGS::SetWidthSource(), PNS::ROUTER::Sizes(), TRACK_WIDTH_CONSTRAINT, PNS::SIZES_SETTINGS::TrackWidth(), PNS::SIZES_SETTINGS::TrackWidthIsExplicit(), PNS::ROUTER::UpdateSizes(), BOARD_DESIGN_SETTINGS::UseNetClassDiffPair(), and BOARD_DESIGN_SETTINGS::UseNetClassTrack().

Referenced by handleLayerSwitch(), MainLoop(), and switchLayerOnViaPlacement().

updateStartItem()

void TOOL_BASE::updateStartItem ( const TOOL_EVENT &  aEvent, bool  aIgnorePads = false  )

protectedvirtualinherited

Definition at line 301 of file pns_tool_base.cpp.

{
 int tl = getView()->GetTopLayer();
 VECTOR2I cp = aEvent.IsPrime() ? aEvent.Position()
 : controls()->GetCursorPosition( !aEvent.Modifier( MD_SHIFT ) );
 VECTOR2I p;
 GAL* gal = m_toolMgr->GetView()->GetGAL();
 
 controls()->ForceCursorPosition( false );
 m_gridHelper->SetUseGrid( gal->GetGridSnapping() && !aEvent.DisableGridSnapping() );
 m_gridHelper->SetSnap( !aEvent.Modifier( MD_SHIFT ) );
 
 if( aEvent.IsMotion() || aEvent.IsClick() )
 p = aEvent.Position();
 else
 p = cp;
 
 m_startItem = pickSingleItem( aEvent.IsClick() ? cp : p, -1, -1, aIgnorePads );
 
 if( !m_gridHelper->GetUseGrid() && m_startItem && !m_startItem->Layers().Overlaps( tl ) )
 m_startItem = nullptr;
 
 m_startSnapPoint = snapToItem( m_startItem, p );
 controls()->ForceCursorPosition( true, m_startSnapPoint );
}

References PCB_TOOL_BASE::controls(), TOOL_EVENT::DisableGridSnapping(), KIGFX::VIEW_CONTROLS::ForceCursorPosition(), KIGFX::VIEW_CONTROLS::GetCursorPosition(), KIGFX::VIEW::GetGAL(), KIGFX::GAL::GetGridSnapping(), KIGFX::VIEW::GetTopLayer(), GRID_HELPER::GetUseGrid(), TOOL_BASE::getView(), TOOL_MANAGER::GetView(), TOOL_EVENT::IsClick(), TOOL_EVENT::IsMotion(), TOOL_EVENT::IsPrime(), PNS::ITEM::Layers(), PNS::TOOL_BASE::m_gridHelper, PNS::TOOL_BASE::m_startItem, PNS::TOOL_BASE::m_startSnapPoint, TOOL_BASE::m_toolMgr, MD_SHIFT, TOOL_EVENT::Modifier(), LAYER_RANGE::Overlaps(), PNS::TOOL_BASE::pickSingleItem(), TOOL_EVENT::Position(), GRID_HELPER::SetSnap(), GRID_HELPER::SetUseGrid(), and PNS::TOOL_BASE::snapToItem().

Referenced by handleLayerSwitch(), LENGTH_TUNER_TOOL::MainLoop(), and MainLoop().

view()

KIGFX::PCB_VIEW * PCB_TOOL_BASE::view ( ) const

inlineprotectedinherited

Definition at line 155 of file pcb_tool_base.h.

 {
 return static_cast<KIGFX::PCB_VIEW*>( getView() );
 }

References TOOL_BASE::getView().

Referenced by AUTOPLACE_TOOL::autoplace(), PCB_TOOL_BASE::doInteractiveItemPlacement(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::DrawVia(), PAD_TOOL::EditPad(), PCB_CONTROL::FlipPcbView(), handleLayerSwitch(), BOARD_INSPECTION_TOOL::highlightNet(), InlineDrag(), DRAWING_TOOL::InteractivePlaceWithPreview(), PCB_CONTROL::LayerAlphaDec(), PCB_CONTROL::LayerAlphaInc(), FOOTPRINT_EDITOR_CONTROL::Save(), FOOTPRINT_EDITOR_CONTROL::SaveAs(), PCB_CONTROL::TrackDisplayMode(), PCB_POINT_EDITOR::updateItem(), PCB_CONTROL::ViaDisplayMode(), and PCB_CONTROL::ZoneDisplayMode().

Wait()

TOOL_EVENT * TOOL_INTERACTIVE::Wait ( const TOOL_EVENT_LIST &  aEventList = TOOL_EVENT( TC_ANY, TA_ANY ) )

inherited

Suspend execution of the tool until an event specified in aEventList arrives.

No parameters means waiting for any event.

Definition at line 57 of file tool_interactive.cpp.

{
 return m_toolMgr->ScheduleWait( this, aEventList );
}

References TOOL_BASE::m_toolMgr, and TOOL_MANAGER::ScheduleWait().

Referenced by SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), SELECTION_TOOL::doSelectionMenu(), EDIT_TOOL::DragArcTrack(), DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawDimension(), MICROWAVE_TOOL::drawMicrowaveInductor(), SCH_DRAWING_TOOLS::DrawShape(), SYMBOL_EDITOR_DRAWING_TOOLS::DrawShape(), PL_DRAWING_TOOLS::DrawShape(), DRAWING_TOOL::drawShape(), SCH_DRAWING_TOOLS::DrawSheet(), DRAWING_TOOL::DrawZone(), PAD_TOOL::EnumeratePads(), InlineDrag(), DRAWING_TOOL::InteractivePlaceWithPreview(), EDA_3D_CONTROLLER::Main(), CVPCB_CONTROL::Main(), CVPCB_FOOTPRINT_VIEWER_SELECTION_TOOL::Main(), EE_POINT_EDITOR::Main(), EE_SELECTION_TOOL::Main(), SCH_MOVE_TOOL::Main(), SYMBOL_EDITOR_MOVE_TOOL::Main(), GERBVIEW_SELECTION_TOOL::Main(), PICKER_TOOL::Main(), ZOOM_TOOL::Main(), PL_EDIT_TOOL::Main(), PL_POINT_EDITOR::Main(), PL_SELECTION_TOOL::Main(), PCB_PICKER_TOOL::Main(), PCB_SELECTION_TOOL::Main(), LENGTH_TUNER_TOOL::MainLoop(), MainLoop(), GERBVIEW_INSPECTION_TOOL::MeasureTool(), PCB_VIEWER_TOOLS::MeasureTool(), PCB_POINT_EDITOR::OnSelectionChange(), performDragging(), performRouting(), LENGTH_TUNER_TOOL::performTuning(), EDIT_TOOL::pickReferencePoint(), SYMBOL_EDITOR_DRAWING_TOOLS::PlaceAnchor(), BOARD_EDITOR_CONTROL::PlaceFootprint(), SCH_DRAWING_TOOLS::PlaceImage(), DRAWING_TOOL::PlaceImage(), DRAWING_TOOL::PlaceImportedGraphics(), PL_DRAWING_TOOLS::PlaceItem(), SCH_DRAWING_TOOLS::PlaceSymbol(), DRAWING_TOOL::PlaceText(), EE_SELECTION_TOOL::selectMultiple(), PL_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::selectPoint(), POSITION_RELATIVE_TOOL::SelectPositionRelativeItem(), ZOOM_TOOL::selectRegion(), DRAWING_TOOL::SetAnchor(), SCH_DRAWING_TOOLS::SingleClickPlace(), SCH_DRAWING_TOOLS::TwoClickPlace(), SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace(), and SCH_LINE_WIRE_BUS_TOOL::UnfoldBus().

Member Data Documentation

m_cancelled

bool PNS::TOOL_BASE::m_cancelled

protectedinherited

Definition at line 81 of file pns_tool_base.h.

Referenced by MainLoop(), performDragging(), performRouting(), and PNS::TOOL_BASE::TOOL_BASE().

m_diffPairMenu

std::shared_ptr<ACTION_MENU> ROUTER_TOOL::m_diffPairMenu

private

Definition at line 91 of file router_tool.h.

Referenced by Init().

m_endItem

ITEM* PNS::TOOL_BASE::m_endItem

protectedinherited

Definition at line 74 of file pns_tool_base.h.

Referenced by finishInteractive(), handleLayerSwitch(), InlineDrag(), onTrackViaSizeChanged(), onViaCommand(), performDragging(), performRouting(), prepareInteractive(), PNS::TOOL_BASE::TOOL_BASE(), and PNS::TOOL_BASE::updateEndItem().

m_endSnapPoint

VECTOR2I PNS::TOOL_BASE::m_endSnapPoint

protectedinherited

Definition at line 75 of file pns_tool_base.h.

Referenced by handleLayerSwitch(), InlineDrag(), onTrackViaSizeChanged(), onViaCommand(), performDragging(), performRouting(), prepareInteractive(), and PNS::TOOL_BASE::updateEndItem().

m_gridHelper

PCB_GRID_HELPER* PNS::TOOL_BASE::m_gridHelper

protectedinherited

Definition at line 77 of file pns_tool_base.h.

Referenced by InlineBreakTrack(), InlineDrag(), performDragging(), PNS::TOOL_BASE::Reset(), PNS::TOOL_BASE::snapToItem(), PNS::TOOL_BASE::TOOL_BASE(), PNS::TOOL_BASE::updateEndItem(), PNS::TOOL_BASE::updateStartItem(), and PNS::TOOL_BASE::~TOOL_BASE().

m_iface

PNS_KICAD_IFACE* PNS::TOOL_BASE::m_iface

protectedinherited

Definition at line 78 of file pns_tool_base.h.

Referenced by onTrackViaSizeChanged(), performRouting(), PNS::TOOL_BASE::pickSingleItem(), prepareInteractive(), PNS::TOOL_BASE::Reset(), RouteSelected(), saveRouterDebugLog(), PNS::TOOL_BASE::snapToItem(), PNS::TOOL_BASE::TOOL_BASE(), UpdateMessagePanel(), and PNS::TOOL_BASE::~TOOL_BASE().

m_inRouterTool

bool ROUTER_TOOL::m_inRouterTool

private

Definition at line 97 of file router_tool.h.

Referenced by MainLoop().

m_isBoardEditor

bool PCB_TOOL_BASE::m_isBoardEditor

protectedinherited

Definition at line 187 of file pcb_tool_base.h.

Referenced by PCB_TOOL_BASE::IsBoardEditor(), PCB_CONTROL::placeBoardItems(), and PCB_TOOL_BASE::SetIsBoardEditor().

m_isFootprintEditor

<

bool PCB_TOOL_BASE::m_isFootprintEditor

protectedinherited