30#include <magic_enum.hpp>
95 return wxT(
"TUNING_STATUS" );
99void TUNING_STATUS_VIEW_ITEM::Show(
int nestLevel, std::ostream& os )
const {}
122 m_max = std::numeric_limits<double>::max();
167 gal->
Scale( { 1., 1. } );
178 VECTOR2I offset( margin.
x * 2, -( size.
y + margin.
y * 2 ) );
180 if( drawingDropShadows )
185 gal->
SetStrokeColor( wxSystemSettings::GetColour( wxSYS_COLOUR_BTNTEXT ) );
186 KIGFX::COLOR4D bgColor( wxSystemSettings::GetColour( wxSYS_COLOUR_BTNFACE ) );
195 COLOR4D bg = wxSystemSettings::GetColour( wxSYS_COLOUR_BTNFACE );
196 COLOR4D normal = wxSystemSettings::GetColour( wxSYS_COLOUR_BTNTEXT );
200 double bg_h, bg_s, bg_l;
201 bg.
ToHSL( bg_h, bg_s, bg_l );
204 red.FromHSL( 0.0, 1.0, bg_l < 0.5 ? 0.7 : 0.3 );
205 green.FromHSL( 120.0, 1.0, bg_l < 0.5 ? 0.8 : 0.2 );
230 textPos.
x += glyphWidth * 11 + margin.
x;
231 font->
Draw( gal,
_(
"min" ), textPos, textAttrs, fontMetrics );
233 textPos.
x += glyphWidth * 7 + margin.
x;
234 font->
Draw( gal,
_(
"max" ), textPos, textAttrs, fontMetrics );
244 textPos.
x += glyphWidth * 11 + margin.
x;
246 font->
Draw( gal,
m_minText, textPos, textAttrs, fontMetrics );
248 textPos.
x += glyphWidth * 7 + margin.
x;
250 font->
Draw( gal,
m_maxText, textPos, textAttrs, fontMetrics );
258 if( aStr ==
"single" )
260 else if( aStr ==
"diff_pair" )
262 else if( aStr ==
"diff_pair_skew" )
266 wxFAIL_MSG( wxS(
"Unknown length tuning token" ) );
279 default: wxFAIL;
return "";
286 switch( aRouterMode )
298 if( aStr ==
"default" )
300 else if( aStr ==
"left" )
302 else if( aStr ==
"right" )
306 wxFAIL_MSG( wxS(
"Unknown length-tuning side token" ) );
319 default: wxFAIL;
return "";
326 if( aStr ==
"too_long" )
328 else if( aStr ==
"too_short" )
330 else if( aStr ==
"tuned" )
334 wxFAIL_MSG( wxS(
"Unknown tuning status token" ) );
347 default: wxFAIL;
return "";
377 if( aNet && track->GetNet() != aNet )
392 SEG seg( track->GetStart(), track->GetEnd() );
396 SEG::ecoord dist_sq = ( nearest - aP ).SquaredEuclideanNorm();
398 if( dist_sq < minDist_sq )
400 minDist_sq = dist_sq;
404 *aNearestTrack = track;
449 if( !constraint.
IsNull() )
467 const std::shared_ptr<TUNING_PROFILES> tuningParams =
480 if( !constraint.
IsNull() )
508 aCommit->
Add(
this );
534 centerlineOffsetEnd =
541 baseEnd.
A += centerlineOffsetEnd;
542 baseEnd.
B += centerlineOffsetEnd;
544 if( baseEnd.
A != baseEnd.
B )
574 &pnsItem,
nullptr, layer, &constraint ) )
605 pnsCoupledItem.
SetParent( coupledTrack );
606 pnsCoupledItem.
SetNet( coupledNet );
611 &pnsItem, &pnsCoupledItem, layer, &constraint ) )
636 &pnsItem, &pnsCoupledItem, layer, &constraint ) )
664 static const int candidateCount = 2;
670 for(
int i = 0; i < candidateCount; i++ )
672 prioritized[i] =
nullptr;
677 for(
int slopRadius : { 0, maxSlopRadius } )
686 if( !item->IsRoutable() )
689 if( !item->Layers().Overlaps( aLayer ) )
699 SEG::ecoord d0 = ( nearest - aWhere ).SquaredEuclideanNorm();
704 if( aBaseline.PointCount() > 0 )
709 if( aBaseline.SegmentCount() > 0 )
712 dcBaseline = ( aBaseline.CPoint( 0 ) - target ).SquaredEuclideanNorm();
714 if( dcBaseline > distBaseline[1] )
717 distBaseline[1] = dcBaseline;
720 prioritized[1] = linked;
729 SEG::ecoord dd = ( aWhere - nearest ).SquaredEuclideanNorm();
734 if( aBaseline.PointCount() > 0 )
739 if( aBaseline.SegmentCount() > 0 )
742 dcBaseline = ( aBaseline.CPoint( 0 ) - target ).SquaredEuclideanNorm();
744 if( dcBaseline > distBaseline[1] )
747 distBaseline[1] = dcBaseline;
750 prioritized[1] = segm;
759 for(
int i = 0; i < candidateCount; i++ )
763 if( item && ( aLayer < 0 || item->Layers().Overlaps( aLayer ) ) )
766 aPointOut = point[i];
802 std::optional<SHAPE_LINE_CHAIN>& aBaseLine )
809 VECTOR2I startSnapPoint, endSnapPoint;
814 wxASSERT( startItem );
817 if( !startItem || !endItem )
825 wxASSERT(
chain.PointOnEdge( startSnapPoint, 40000 ) );
826 wxASSERT(
chain.PointOnEdge( endSnapPoint, 40000 ) );
832 chain.Split( startSnapPoint, endSnapPoint, pre, mid, post );
847 wxCHECK( track,
false );
863 return initBaseLine( aRouter, aPNSLayer, aBoard, coupledStart, coupledEnd, coupledNet,
898 VECTOR2I startSnapPoint, endSnapPoint;
901 aPNSLayer, startSnapPoint, endSnapPoint );
903 wxCHECK( pnsLine,
false );
908 pnsLine->CLine().
Split( startSnapPoint, endSnapPoint, pre, mid, post );
916 straightChain.
Append( pre );
917 straightChain.
Append( aBaseLine );
918 straightChain.
Append( post );
921 PNS::LINE straightLine( *pnsLine, straightChain );
962 const std::vector<GENERATOR_PNS_CHANGES>& allPnsChanges = aTool->
GetRouterChanges();
966 const std::set<BOARD_ITEM*> routerRemovedItems = pnsChanges.removedItems;
967 const std::set<BOARD_ITEM*> routerAddedItems = pnsChanges.addedItems;
975 item->ClearSelected();
980 aCommit->
Add( item );
1013 if( lineWidth == 0 || li->Width() < lineWidth )
1014 lineWidth = li->Width();
1024 if( lineWidth == 0 )
1035 recoverLine.
SetNet( recoverNet );
1036 branch->
Add( recoverLine,
false );
1044 recoverLineCoupled.
SetWidth( lineWidth );
1046 recoverLineCoupled.
SetNet( recoverCoupledNet );
1047 branch->
Add( recoverLineCoupled,
false );
1065 VECTOR2I startSnapPoint, endSnapPoint;
1068 aPNSLayer, startSnapPoint, endSnapPoint );
1082 pnsLine->CLine().
Split( startSnapPoint, endSnapPoint, pre, mid, post );
1084 straightChain.
Append( pre );
1085 straightChain.
Append( aBaseLine );
1086 straightChain.
Append( post );
1090 branch->
Remove( *pnsLine );
1103 m_end = endSnapPoint;
1110 newLineChain.
Append( pre );
1111 newLineChain.
Append( mid );
1112 newLineChain.
Append( post );
1124 straightChain.
Split( start,
end, pre, mid, post );
1126 newLineChain.
Append( pre );
1127 newLineChain.
Append( mid );
1128 newLineChain.
Append( post );
1134 PNS::LINE newLine( *pnsLine, newLineChain );
1136 branch->
Add( newLine,
false );
1159 auto hideRemovedItems = [&](
bool aHide )
1165 for(
BOARD_ITEM* item : pnsCommit.removedItems )
1168 view->
Hide( item, aHide, aHide );
1211 hideRemovedItems(
true );
1213 VECTOR2I startSnapPoint, endSnapPoint;
1220 wxASSERT( startItem );
1221 wxASSERT( endItem );
1223 if( !startItem || !endItem )
1228 if( !router->
StartRouting( startSnapPoint, startItem, pnslayer ) )
1257 wxString statusMessage;
1264 default: statusMessage =
_(
"unknown" );
break;
1307 bool forceFinish =
true;
1308 bool forceCommit =
false;
1310 router->
FixRoute(
m_end,
nullptr, forceFinish, forceCommit );
1314 const std::vector<GENERATOR_PNS_CHANGES>& pnsCommits = aTool->
GetRouterChanges();
1318 const std::set<BOARD_ITEM*> routerRemovedItems = pnsCommit.removedItems;
1319 const std::set<BOARD_ITEM*> routerAddedItems = pnsCommit.addedItems;
1328 view->
Hide( item,
false );
1335 aCommit->
Add( item );
1365 for(
BOARD_ITEM* item : pnsCommit.removedItems )
1366 view->Hide( item,
false );
1391 base.
A += centerlineOffset;
1392 base.
B += centerlineOffset;
1402 VECTOR2I widthHandleOffset = ( base.
B - base.
A ).Perpendicular().Resize( amplitude );
1404 aPoints.
AddPoint( base.
A + widthHandleOffset );
1410 aPoints.
AddPoint( base.
A + spacingHandleOffset );
1431 base.
A += centerlineOffset;
1432 base.
B += centerlineOffset;
1450 int side = base.
Side( wHandle );
1486 base.
A += centerlineOffset;
1487 base.
B += centerlineOffset;
1497 VECTOR2I widthHandleOffset = ( base.
B - base.
A ).Perpendicular().Resize( amplitude );
1517 int clampedMaxAmplitude =
m_settings.m_maxAmplitude;
1518 int minAllowedAmplitude = 0;
1528 minAllowedAmplitude = baselineOffset +
correction;
1531 clampedMaxAmplitude = std::max( clampedMaxAmplitude, minAllowedAmplitude );
1549 chain.SetClosed(
true );
1654 size = std::max( size,
pcbIUScale.mmToIU( 0.05 ) );
1660 for(
int i = 0; i <
m_baseLine->SegmentCount(); i++ )
1683 for(
int i = 0; i <
chain.SegmentCount(); i++ )
1701 props.
set(
"corner_radius_percent",
m_settings.m_cornerRadiusPercentage );
1722 props.
set(
"override_custom_rules",
m_settings.m_overrideCustomRules );
1738 wxString tuningMode;
1739 aProps.
get_to(
"tuning_mode", tuningMode );
1743 aProps.
get_to(
"initial_side", side );
1747 aProps.
get_to(
"last_status", status );
1753 aProps.
get_to(
"corner_radius_percent",
m_settings.m_cornerRadiusPercentage );
1757 bool rounded =
false;
1758 aProps.
get_to(
"rounded", rounded );
1763 aProps.
get_to_iu(
"target_length", val );
1766 if( aProps.
get_to_iu(
"target_length_min", val ) )
1769 if( aProps.
get_to_iu(
"target_length_max", val ) )
1772 aProps.
get_to_iu(
"target_delay", val );
1775 if( aProps.
get_to_iu(
"target_delay_min", val ) )
1776 m_settings.m_targetLengthDelay.SetMin( val );
1778 if( aProps.
get_to_iu(
"target_delay_max", val ) )
1779 m_settings.m_targetLengthDelay.SetMax( val );
1783 aProps.
get_to_iu(
"target_skew", int_val );
1786 if( aProps.
get_to_iu(
"target_skew_min", int_val ) )
1789 if( aProps.
get_to_iu(
"target_skew_max", int_val ) )
1798 aProps.
get_to(
"override_custom_rules",
m_settings.m_overrideCustomRules );
1811 wxString statusMessage;
1818 default: statusMessage =
_(
"unknown" );
break;
1825 m_tuningInfo.Printf( wxS(
"%s (%s)" ), lengthStr, statusMessage );
1895 commit.
Push(
_(
"Edit Tuning Pattern" ) );
1902 bool aStatusItemsOnly )
1904 std::vector<EDA_ITEM*> previewItems;
1909 if( !aStatusItemsOnly )
1939 static_cast<double>(
m_settings.m_targetLengthDelay.Max() ) );
1951 static_cast<double>(
m_settings.m_targetLength.Max() ) );
1961 statusItem->
SetCurrent(
static_cast<double>( placer->TuningDelayResult() ),
_(
"current skew" ) );
1963 statusItem->
SetCurrent(
static_cast<double>( placer->TuningLengthResult() ),
_(
"current skew" ) );
1968 statusItem->
SetCurrent(
static_cast<double>( placer->TuningDelayResult() ),
_(
"current delay" ) );
1970 statusItem->
SetCurrent(
static_cast<double>( placer->TuningLengthResult() ),
_(
"current length" ) );
1974 previewItems.push_back( statusItem );
1977 return previewItems;
1982 std::vector<MSG_PANEL_ITEM>& aList )
1991 bool mixedWidth =
false;
2003 primaryItem = track;
2004 primaryNet = track->GetNet();
2006 else if( !coupledNet && track->GetNet() != primaryNet )
2008 coupledItem = track;
2009 coupledNet = track->GetNet();
2013 netclass = track->GetEffectiveNetClass();
2016 width = track->GetWidth();
2017 else if( width != track->GetWidth() )
2028 else if( primaryNet )
2034 aList.emplace_back(
_(
"Resolved Netclass" ),
2039 if( width && !mixedWidth )
2047 if( board && primaryItem && primaryItem->
GetNetCode() > 0 )
2050 double trackLen = 0.0;
2051 double lenPadToDie = 0.0;
2052 double trackDelay = 0.0;
2053 double delayPadToDie = 0.0;
2055 std::tie( count, trackLen, lenPadToDie, trackDelay, delayPadToDie ) = board->
GetTrackLength( *primaryItem );
2057 if( coupledItem && coupledItem->
GetNetCode() > 0 )
2059 double coupledLen = 0.0;
2060 double coupledLenPadToDie = 0.0;
2061 double coupledTrackDelay = 0.0;
2062 double doubledDelayPadToDie = 0.0;
2064 std::tie( count, coupledLen, coupledLenPadToDie, coupledTrackDelay, doubledDelayPadToDie ) =
2067 if( trackDelay == 0.0 || coupledTrackDelay == 0.0 )
2075 _(
"Routed Delays" ),
2082 if( trackDelay == 0.0 )
2088 aList.emplace_back(
_(
"Routed Delay" ),
2093 if( lenPadToDie != 0 && delayPadToDie == 0.0 )
2096 aList.emplace_back(
_(
"Pad To Die Length" ), msg );
2099 aList.emplace_back(
_(
"Full Length" ), msg );
2101 else if( delayPadToDie > 0.0 )
2104 aList.emplace_back(
_(
"Pad To Die Delay" ), msg );
2107 aList.emplace_back(
_(
"Full Delay" ), msg );
2119 aList.emplace_back( wxString::Format(
_(
"Target Skew: %s" ), msg ),
2120 wxString::Format(
_(
"(from tuning pattern properties)" ) ) );
2126 if( !msg.IsEmpty() )
2128 aList.emplace_back( wxString::Format(
_(
"Skew Constraints: %s" ), msg ),
2129 wxString::Format(
_(
"(from %s)" ), constraint.
GetName() ) );
2143 caption =
_(
"Target Delay: %s" );
2149 caption =
_(
"Target Length: %s" );
2153 aList.emplace_back( wxString::Format( caption, msg ),
2154 wxString::Format(
_(
"(from tuning pattern properties)" ) ) );
2160 wxString caption =
m_settings.m_isTimeDomain ?
_(
"Delay Constraints: %s" ) :
_(
"Length Constraints: %s" );
2162 if( !msg.IsEmpty() )
2164 aList.emplace_back( wxString::Format( caption, msg ),
2165 wxString::Format(
_(
"(from %s)" ), constraint.
GetName() ) );
2179#define HITTEST_THRESHOLD_PIXELS 5
2199 std::shared_ptr<DRC_ENGINE>& drcEngine = bds.
m_DRCEngine;
2225 auto applyCommonSettings =
2228 const auto& origTargetLength = aPattern->GetSettings().m_targetLength;
2229 const auto& origTargetSkew = aPattern->GetSettings().m_targetSkew;
2231 aPattern->GetSettings() = meanderSettings;
2237 aPattern->GetSettings().m_targetSkew = origTargetSkew;
2240 auto updateHoverStatus =
2243 std::unique_ptr<PCB_TUNING_PATTERN> dummyPattern;
2249 dummyPattern->SetPosition(
m_pickerItem->GetFocusPosition() );
2250 dummyPattern->SetEnd(
m_pickerItem->GetFocusPosition() );
2255 applyCommonSettings( dummyPattern.get() );
2257 dummyPattern->EditStart( generatorTool,
m_board,
nullptr );
2258 dummyPattern->Update( generatorTool,
m_board,
nullptr );
2262 for(
EDA_ITEM* item : dummyPattern->GetPreviewItems( generatorTool,
m_frame ) )
2277 auto updateTuningPattern =
2298 if( evt->IsCancelInteractive() || evt->IsActivate()
2314 else if( evt->IsMotion() )
2324 guide.SetIncludeSecondary(
false );
2326 guide.SetIncludeSecondary(
true );
2328 guide.SetPreferredLayer(
m_frame->GetActiveLayer() );
2339 double min_dist_sq = std::numeric_limits<double>::max();
2341 for(
EDA_ITEM* candidate : collector )
2347 candidatePos =
static_cast<PCB_TRACK*
>( candidate )->GetCenter();
2349 else if( candidate->Type() ==
PCB_ARC_T )
2351 candidatePos =
static_cast<PCB_ARC*
>( candidate )->GetMid();
2354 double dist_sq = ( cursorPos - candidatePos ).SquaredEuclideanNorm();
2356 if( dist_sq < min_dist_sq )
2358 min_dist_sq = dist_sq;
2364 updateHoverStatus();
2373 updateTuningPattern();
2376 else if( evt->IsClick(
BUT_LEFT ) )
2384 m_frame->ShowInfoBarWarning(
_(
"Unable to tune segments inside other "
2385 "tuning patterns." ) );
2398 int dummyClearance = std::numeric_limits<int>::max() / 2;
2403 if(
m_pickerItem->GetEffectiveShape()->Collide( cursorPos, dummyClearance,
2404 &dummyDist, &closestPt ) )
2422 commit.
Push(
_(
"Tune" ) );
2442 meanderSettings.
m_spacing = placer->MeanderSettings().m_spacing;
2444 updateTuningPattern();
2448 m_frame->ShowInfoBarWarning(
_(
"Select a track to tune first." ) );
2459 m_tuningPattern->SetMaxAmplitude( placer->MeanderSettings().m_maxAmplitude );
2460 meanderSettings.
m_maxAmplitude = placer->MeanderSettings().m_maxAmplitude;
2462 updateTuningPattern();
2466 m_frame->ShowInfoBarWarning(
_(
"Select a track to tune first." ) );
2492 updateTuningPattern();
2503 evt->SetPassEvent();
2512 controls->ForceCursorPosition(
false );
2519 m_frame->GetCanvas()->Refresh();
2552 if( layerEnum.
Choices().GetCount() == 0 )
2562 layer->SetChoices( layerEnum.
Choices() );
2572 const wxString groupTechLayers =
_HKI(
"Technical Layers" );
2584 const wxString groupTab =
_HKI(
"Pattern Properties" );
2635 auto isTimeDomain = [](
INSPECTABLE* aItem ) ->
bool
2638 return pattern->GetSettings().m_isTimeDomain;
2643 auto isLengthIsSpaceDomain = [&](
INSPECTABLE* aItem ) ->
bool
2645 return !isSkew( aItem ) && !isTimeDomain( aItem );
2648 auto isLengthIsTimeDomain = [&](
INSPECTABLE* aItem ) ->
bool
2650 return !isSkew( aItem ) && isTimeDomain( aItem );
2653 auto isSkewIsSpaceDomain = [&](
INSPECTABLE* aItem ) ->
bool
2655 return isSkew( aItem ) && !isTimeDomain( aItem );
2658 auto isSkewIsTimeDomain = [&](
INSPECTABLE* aItem ) ->
bool
2660 return isSkew( aItem ) && isTimeDomain( aItem );
2708template <typename
T>
constexpr EDA_IU_SCALE pcbIUScale
constexpr int ARC_LOW_DEF
@ NORMAL
Inactive layers are shown normally (no high-contrast mode)
constexpr BOX2I KiROUND(const BOX2D &aBoxD)
static TOOL_ACTION selectionClear
Clear the current selection.
virtual void Push(const wxString &aMessage=wxEmptyString, int aCommitFlags=0) override
Execute the changes.
A base class derived from BOARD_ITEM for items that can be connected and have a net,...
virtual NETCLASS * GetEffectiveNetClass() const
Return the NETCLASS for this item.
PCB_LAYER_ID GetLayer() const override
Return the primary layer this item is on.
NETINFO_ITEM * GetNet() const
Return #NET_INFO object for a given item.
Container for design settings for a BOARD object.
std::shared_ptr< DRC_ENGINE > m_DRCEngine
int GetDRCEpsilon() const
Return an epsilon which accounts for rounding errors, etc.
PNS::MEANDER_SETTINGS m_DiffPairMeanderSettings
PNS::MEANDER_SETTINGS m_SingleTrackMeanderSettings
PNS::MEANDER_SETTINGS m_SkewMeanderSettings
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
BOARD_ITEM(BOARD_ITEM *aParent, KICAD_T idtype, PCB_LAYER_ID aLayer=F_Cu)
virtual PCB_LAYER_ID GetLayer() const
Return the primary layer this item is on.
virtual const BOARD * GetBoard() const
Return the BOARD in which this BOARD_ITEM resides, or NULL if none.
virtual wxString LayerMaskDescribe() const
Return a string (to be shown to the user) describing a layer mask.
Information pertinent to a Pcbnew printed circuit board.
NETINFO_ITEM * DpCoupledNet(const NETINFO_ITEM *aNet)
std::tuple< int, double, double, double, double > GetTrackLength(const PCB_TRACK &aTrack) const
Return data on the length and number of track segments connected to a given track.
NETINFO_ITEM * FindNet(int aNetcode) const
Search for a net with the given netcode.
const TRACKS & Tracks() const
PROJECT * GetProject() const
BOARD_DESIGN_SETTINGS & GetDesignSettings() const
constexpr void SetMaximum()
int GetCount() const
Return the number of objects in the list.
COMMIT & Remove(EDA_ITEM *aItem, BASE_SCREEN *aScreen=nullptr)
Remove a new item from the model.
COMMIT & Modify(EDA_ITEM *aItem, BASE_SCREEN *aScreen=nullptr, RECURSE_MODE aRecurse=RECURSE_MODE::NO_RECURSE)
Modify a given item in the model.
COMMIT & Add(EDA_ITEM *aItem, BASE_SCREEN *aScreen=nullptr)
Add a new item to the model.
const MINOPTMAX< int > & GetValue() const
bool GetOption(OPTIONS option) const
DRC_CONSTRAINT EvalRules(DRC_CONSTRAINT_T aConstraintType, const BOARD_ITEM *a, const BOARD_ITEM *b, PCB_LAYER_ID aLayer, REPORTER *aReporter=nullptr)
The base class for create windows for drawing purpose.
std::unordered_set< EDA_ITEM * > m_items
std::unordered_set< EDA_ITEM * > & GetItems()
void AddItem(EDA_ITEM *aItem)
Add item to group.
A base class for most all the KiCad significant classes used in schematics and boards.
void SetFlags(EDA_ITEM_FLAGS aMask)
void ClearFlags(EDA_ITEM_FLAGS aMask=EDA_ITEM_ALL_FLAGS)
bool HasFlag(EDA_ITEM_FLAGS aFlag) const
EDA_ITEM_FLAGS GetFlags() const
EDA_ITEM(EDA_ITEM *parent, KICAD_T idType, bool isSCH_ITEM=false, bool isBOARD_ITEM=false)
EDIT_POINTS is a VIEW_ITEM that manages EDIT_POINTs and EDIT_LINEs and draws them.
void AddPoint(const EDIT_POINT &aPoint)
Add an EDIT_POINT.
EDIT_POINT & Point(unsigned int aIndex)
void SetGridConstraint(GRID_CONSTRAINT_TYPE aConstraint)
static const int POINT_SIZE
Single point size in pixels.
virtual void SetPosition(const VECTOR2I &aPosition)
Set new coordinates for an EDIT_POINT.
virtual VECTOR2I GetPosition() const
Return coordinates of an EDIT_POINT.
ENUM_MAP & Map(T aValue, const wxString &aName)
static ENUM_MAP< T > & Instance()
ENUM_MAP & Undefined(T aValue)
static const TOOL_EVENT SelectedItemsModified
Selected items were moved, this can be very high frequency on the canvas, use with care.
A general implementation of a COLLECTORS_GUIDE.
Used when the right click button is pressed, or when the select tool is in effect.
void Collect(BOARD_ITEM *aItem, const std::vector< KICAD_T > &aScanList, const VECTOR2I &aRefPos, const COLLECTORS_GUIDE &aGuide)
Scan a BOARD_ITEM using this class's Inspector method, which does the collection.
A factory which returns an instance of a PCB_GENERATOR.
void Register(const wxString &aTypeStr, const wxString &aName, std::function< PCB_GENERATOR *(void)> aCreateFunc)
Associate a type string to display name and create function.
static GENERATORS_MGR & Instance()
Class that other classes need to inherit from, in order to be inspectable.
FONT is an abstract base class for both outline and stroke fonts.
static FONT * GetFont(const wxString &aFontName=wxEmptyString, bool aBold=false, bool aItalic=false, const std::vector< wxString > *aEmbeddedFiles=nullptr, bool aForDrawingSheet=false)
void Draw(KIGFX::GAL *aGal, const wxString &aText, const VECTOR2I &aPosition, const VECTOR2I &aCursor, const TEXT_ATTRIBUTES &aAttributes, const METRICS &aFontMetrics, std::optional< VECTOR2I > aMousePos=std::nullopt, wxString *aActiveUrl=nullptr) const
Draw a string.
static const METRICS & Default()
A color representation with 4 components: red, green, blue, alpha.
COLOR4D WithAlpha(double aAlpha) const
Return a color with the same color, but the given alpha.
void ToHSL(double &aOutHue, double &aOutSaturation, double &aOutLightness) const
Converts current color (stored in RGB) to HSL format.
Abstract interface for drawing on a 2D-surface.
virtual void SetIsFill(bool aIsFillEnabled)
Enable/disable fill.
virtual void DrawRectangle(const VECTOR2D &aStartPoint, const VECTOR2D &aEndPoint)
Draw a rectangle.
virtual void SetFillColor(const COLOR4D &aColor)
Set the fill color.
const MATRIX3x3D & GetScreenWorldMatrix() const
Get the screen <-> world transformation matrix.
virtual void Restore()
Restore the context.
virtual void SetLineWidth(float aLineWidth)
Set the line width.
virtual void SetStrokeColor(const COLOR4D &aColor)
Set the stroke color.
virtual void SetIsStroke(bool aIsStrokeEnabled)
Enable/disable stroked outlines.
virtual void Scale(const VECTOR2D &aScale)
Scale the context.
virtual void Save()
Save the context.
A KIGFX::PREVIEW::DRAW_CONTEXT is a wrapper around a GAL and some other settings that makes it easy t...
void DrawLineDashed(const VECTOR2I &aStart, const VECTOR2I &aEn, int aDashStep, int aDashFill, bool aDeEmphasised)
Draw a dashed line on the current layer.
An interface for classes handling user events controlling the view behavior such as zooming,...
Hold a (potentially large) number of VIEW_ITEMs and renders them on a graphics device provided by the...
GAL * GetGAL() const
Return the GAL this view is using to draw graphical primitives.
VECTOR2D ToWorld(const VECTOR2D &aCoord, bool aAbsolute=true) const
Converts a screen space point/vector to a point/vector in world space coordinates.
void Hide(VIEW_ITEM *aItem, bool aHide=true, bool aHideOverlay=false)
Temporarily hide the item in the view (e.g.
static const LSET & AllLayersMask()
static wxString Name(PCB_LAYER_ID aLayerId)
Return the fixed name association with aLayerId.
VECTOR2< T > GetScale() const
Get the scale components of the matrix.
A collection of nets and the parameters used to route or test these nets.
const wxString GetHumanReadableName() const
Gets the consolidated name of this netclass (which may be an aggregate).
wxString GetTuningProfile() const
bool HasTuningProfile() const
Handle the data for a net.
const wxString & GetNetname() const
static TOOL_ACTION properties
Activation of the edit tool.
static TOOL_ACTION spacingDecrease
static TOOL_ACTION amplIncrease
static TOOL_ACTION amplDecrease
static TOOL_ACTION lengthTunerSettings
static TOOL_ACTION spacingIncrease
const VECTOR2I & GetMid() const
Common, abstract interface for edit frames.
PCB_DRAW_PANEL_GAL * GetCanvas() const override
Return a pointer to GAL-based canvas of given EDA draw frame.
virtual KIGFX::PCB_VIEW * GetView() const override
Return a pointer to the #VIEW instance used in the panel.
virtual void SetProperties(const STRING_ANY_MAP &aProps)
PCB_GENERATOR(BOARD_ITEM *aParent, PCB_LAYER_ID aLayer)
virtual const STRING_ANY_MAP GetProperties() const
const VECTOR2I & GetStart() const
const VECTOR2I & GetEnd() const
virtual int GetWidth() const
void SetTargetSkew(int aValue)
bool initBaseLines(PNS::ROUTER *aRouter, int aPNSLayer, BOARD *aBoard)
const STRING_ANY_MAP GetProperties() const override
void SetLocalSolderMaskMargin(std::optional< int > aMargin)
void SetMinAmplitude(int aValue)
void SetSpacing(int aValue)
static const wxString DISPLAY_NAME
void GetMsgPanelInfo(EDA_DRAW_FRAME *aFrame, std::vector< MSG_PANEL_ITEM > &aList) override
Populate aList of MSG_PANEL_ITEM objects with it's internal state for display purposes.
PNS::ROUTER_MODE GetPNSMode()
bool initBaseLine(PNS::ROUTER *aRouter, int aPNSLayer, BOARD *aBoard, VECTOR2I &aStart, VECTOR2I &aEnd, NETINFO_ITEM *aNet, std::optional< SHAPE_LINE_CHAIN > &aBaseLine)
void SetTargetSkewDelay(int aValue)
PCB_TUNING_PATTERN(BOARD_ITEM *aParent=nullptr, PCB_LAYER_ID aLayer=F_Cu, LENGTH_TUNING_MODE aMode=LENGTH_TUNING_MODE::SINGLE)
void SetLayer(PCB_LAYER_ID aLayer) override
Set the layer this item is on.
bool recoverBaseline(PNS::ROUTER *aRouter)
void SetWidth(int aValue)
PNS::MEANDER_SIDE GetInitialSide() const
std::optional< int > GetLocalSolderMaskMargin() const
bool HasSolderMask() const
void SetInitialSide(PNS::MEANDER_SIDE aValue)
wxString GetFriendlyName() const override
void SetTargetDelay(std::optional< int > aValue)
LENGTH_TUNING_MODE GetTuningMode() const
void SetHasSolderMask(bool aVal)
std::optional< int > GetTargetDelay() const
std::vector< EDA_ITEM * > GetPreviewItems(GENERATOR_TOOL *aTool, PCB_BASE_EDIT_FRAME *aFrame, bool aStatusItemsOnly=false) override
int GetMinAmplitude() const
void EditStart(GENERATOR_TOOL *aTool, BOARD *aBoard, BOARD_COMMIT *aCommit) override
void SetOverrideCustomRules(bool aOverride)
void SetRounded(bool aFlag)
LENGTH_TUNING_MODE m_tuningMode
static const wxString GENERATOR_TYPE
bool resetToBaseline(GENERATOR_TOOL *aTool, int aPNSLayer, SHAPE_LINE_CHAIN &aBaseLine, bool aPrimary)
bool MakeEditPoints(EDIT_POINTS &points) const override
void SetCornerRadiusPercentage(int aValue)
PNS::MEANDER_PLACER_BASE::TUNING_STATUS m_tuningStatus
std::optional< SHAPE_LINE_CHAIN > m_baseLineCoupled
void SetProperties(const STRING_ANY_MAP &aProps) override
void ViewDraw(int aLayer, KIGFX::VIEW *aView) const override final
Draw the parts of the object belonging to layer aLayer.
void Remove(GENERATOR_TOOL *aTool, BOARD *aBoard, BOARD_COMMIT *aCommit) override
bool UpdateFromEditPoints(EDIT_POINTS &aEditPoints) override
std::optional< SHAPE_LINE_CHAIN > m_baseLine
int GetMaxAmplitude() const
PNS::MEANDER_SETTINGS m_settings
void ShowPropertiesDialog(PCB_BASE_EDIT_FRAME *aEditFrame) override
PCB_LAYER_ID GetLayer() const override
Return the primary layer this item is on.
bool Update(GENERATOR_TOOL *aTool, BOARD *aBoard, BOARD_COMMIT *aCommit) override
void SetNetCode(int aNetCode)
bool UpdateEditPoints(EDIT_POINTS &aEditPoints) override
int GetTargetSkewDelay() const
void EditCancel(GENERATOR_TOOL *aTool, BOARD *aBoard, BOARD_COMMIT *aCommit) override
bool GetOverrideCustomRules() const
void SetMaxAmplitude(int aValue)
PNS::MEANDER_SETTINGS & GetSettings()
void SetSingleSided(bool aValue)
bool removeToBaseline(PNS::ROUTER *aRouter, int aPNSLayer, SHAPE_LINE_CHAIN &aBaseLine)
std::optional< int > GetTargetLength() const
void EditFinish(GENERATOR_TOOL *aTool, BOARD *aBoard, BOARD_COMMIT *aCommit) override
int GetCornerRadiusPercentage() const
SHAPE_LINE_CHAIN getOutline() const
void SetTargetLength(std::optional< int > aValue)
bool IsSingleSided() const
static PCB_TUNING_PATTERN * CreateNew(GENERATOR_TOOL *aTool, PCB_BASE_EDIT_FRAME *aFrame, BOARD_CONNECTED_ITEM *aStartItem, LENGTH_TUNING_MODE aMode)
int GetTargetSkew() const
Differential Pair length-matching/meandering tool.
std::vector< ITEM * > & Items()
Base class for PNS router board items.
virtual NET_HANDLE Net() const
void SetNet(NET_HANDLE aNet)
void SetLayer(int aLayer)
void SetParent(BOARD_ITEM *aParent)
bool OfKind(int aKindMask) const
virtual VECTOR2I Anchor(int n) const
Represents a track on a PCB, connecting two non-trivial joints (that is, vias, pads,...
const SHAPE_LINE_CHAIN & CLine() const
SHAPE_LINE_CHAIN & Line()
void SetWidth(int aWidth)
Return line width.
virtual int Width() const
bool ContainsLink(const LINKED_ITEM *aItem) const
std::vector< LINKED_ITEM * > & Links()
Base class for Single trace & Differential pair meandering tools, as both of them share a lot of code...
virtual void UpdateSettings(const MEANDER_SETTINGS &aSettings)
TUNING_STATUS
< Result of the length tuning operation
virtual void SpacingStep(int aSign)
Increase/decrease the current meandering spacing by one step.
virtual TUNING_STATUS TuningStatus() const =0
Return the tuning status (too short, too long, etc.) of the trace(s) being tuned.
virtual const MEANDER_SETTINGS & MeanderSettings() const
Return the current meandering configuration.
virtual void AmplitudeStep(int aSign)
Increase/decreases the current meandering amplitude by one step.
virtual long long int TuningLengthResult() const =0
Return the resultant length or skew of the tuned traces.
Dimensions for the meandering algorithm.
void SetTargetLength(long long int aOpt)
bool m_isTimeDomain
The net class this meander pattern belongs to.
static const long long int LENGTH_UNCONSTRAINED
void SetTargetLengthDelay(long long int aOpt)
MINOPTMAX< long long int > m_targetLength
Desired propagation delay of the tuned line.
void SetTargetSkew(int aOpt)
MINOPTMAX< int > m_targetSkew
Target skew value for diff pair de-skewing.
int m_maxAmplitude
Meandering period/spacing (see dialog picture for explanation).
bool m_overrideCustomRules
Type of corners for the meandered line.
void SetTargetSkewDelay(int aOpt)
static const long long int DELAY_UNCONSTRAINED
int m_spacing
Amplitude/spacing adjustment step.
Keep the router "world" - i.e.
NODE * Branch()
Create a lightweight copy (called branch) of self that tracks the changes (added/removed items) wrs t...
bool Add(std::unique_ptr< SEGMENT > aSegment, bool aAllowRedundant=false)
Add an item to the current node.
std::set< OBSTACLE > OBSTACLES
const LINE AssembleLine(LINKED_ITEM *aSeg, int *aOriginSegmentIndex=nullptr, bool aStopAtLockedJoints=false, bool aFollowLockedSegments=false, bool aAllowSegmentSizeMismatch=true)
Follow the joint map to assemble a line connecting two non-trivial joints starting from segment aSeg.
int QueryColliding(const ITEM *aItem, OBSTACLES &aObstacles, const COLLISION_SEARCH_OPTIONS &aOpts=COLLISION_SEARCH_OPTIONS()) const
Find items colliding (closer than clearance) with the item aItem.
void Remove(ARC *aArc)
Remove an item from this branch.
virtual int GetPNSLayerFromBoardLayer(PCB_LAYER_ID aLayer) const =0
virtual void RemoveItem(ITEM *aItem)=0
virtual void AddItem(ITEM *aItem)=0
void SetMode(ROUTER_MODE aMode)
PLACEMENT_ALGO * Placer()
ROUTER_IFACE * GetInterface() const
const ITEM_SET QueryHoverItems(const VECTOR2I &aP, int aSlopRadius=0)
RULE_RESOLVER * GetRuleResolver() const
bool RoutingInProgress() const
bool StartRouting(const VECTOR2I &aP, ITEM *aItem, int aLayer)
bool FixRoute(const VECTOR2I &aP, ITEM *aItem, bool aForceFinish, bool aForceCommit)
bool Move(const VECTOR2I &aP, ITEM *aItem)
virtual int Clearance(const ITEM *aA, const ITEM *aB, bool aUseClearanceEpsilon=true)=0
const SHAPE_LINE_CHAIN CLine() const
const SHAPE * Shape(int aLayer) const override
Return the geometrical shape of the item.
void SetShape(SHAPE *shape)
void SetStartLayerFromPCBNew(PCB_LAYER_ID aLayer)
int GetPNSLayerFromBoardLayer(PCB_LAYER_ID aLayer) const override
void DisplayItem(const PNS::ITEM *aItem, int aClearance, bool aEdit=false, int aFlags=0) override
void EraseView() override
wxString GetNetName(PNS::NET_HANDLE aNet) const override
std::shared_ptr< TUNING_PROFILES > & TuningProfileParameters()
virtual PROJECT_FILE & GetProjectFile() const
PROPERTY_BASE & SetAvailableFunc(std::function< bool(INSPECTABLE *)> aFunc)
Set a callback function to determine whether an object provides this property.
Provide class metadata.Helper macro to map type hashes to names.
void InheritsAfter(TYPE_ID aDerived, TYPE_ID aBase)
Declare an inheritance relationship between types.
static PROPERTY_MANAGER & Instance()
PROPERTY_BASE & AddProperty(PROPERTY_BASE *aProperty, const wxString &aGroup=wxEmptyString)
Register a property.
PROPERTY_BASE & ReplaceProperty(PROPERTY_BASE *aProperty, const wxString &aGroup)
Replace an existing property.
void AddTypeCast(TYPE_CAST_BASE *aCast)
Register a type converter.
RAII class that sets an value at construction and resets it to the original value at destruction.
int LineDistance(const VECTOR2I &aP, bool aDetermineSide=false) const
Return the closest Euclidean distance between point aP and the line defined by the ends of segment (t...
VECTOR2I::extended_type ecoord
const VECTOR2I NearestPoint(const VECTOR2I &aP) const
Compute a point on the segment (this) that is closest to point aP.
int Side(const VECTOR2I &aP) const
Determine on which side of directed line passing via segment ends point aP lies.
const VECTOR2I & GetArcMid() const
VECTOR2I NearestPoint(const VECTOR2I &aP) const
bool PointOnEdge(const VECTOR2I &aP, int aAccuracy=0) const
Check if point aP lies on an edge or vertex of the line chain.
bool PointInside(const VECTOR2I &aPt, int aAccuracy=0, bool aUseBBoxCache=false) const override
Check if point aP lies inside a closed shape.
Represent a polyline containing arcs as well as line segments: A chain of connected line and/or arc s...
const SHAPE_LINE_CHAIN Reverse() const
Reverse point order in the line chain.
int Split(const VECTOR2I &aP, bool aExact=false)
Insert the point aP belonging to one of the our segments, splitting the adjacent segment in two.
void SetClosed(bool aClosed)
Mark the line chain as closed (i.e.
void Simplify(int aTolerance=0)
Simplify the line chain by removing colinear adjacent segments and duplicate vertices.
void Append(int aX, int aY, bool aAllowDuplication=false)
Append a new point at the end of the line chain.
const VECTOR2I & CPoint(int aIndex) const
Return a reference to a given point in the line chain.
const VECTOR2I NearestPoint(const VECTOR2I &aP, bool aAllowInternalShapePoints=true) const
Find a point on the line chain that is closest to point aP.
const VECTOR2I & CLastPoint() const
Return the last point in the line chain.
SHAPE * Clone() const override
Return a dynamically allocated copy of the shape.
bool OffsetLine(int aAmount, CORNER_STRATEGY aCornerStrategy, int aMaxError, SHAPE_LINE_CHAIN &aLeft, SHAPE_LINE_CHAIN &aRight, bool aSimplify=false) const
Creates line chains aLeft and aRight offset to this line chain.
Represent a set of closed polygons.
void BooleanAdd(const SHAPE_POLY_SET &b)
Perform boolean polyset union.
void ClearArcs()
Removes all arc references from all the outlines and holes in the polyset.
SHAPE_LINE_CHAIN & Outline(int aIndex)
Return the reference to aIndex-th outline in the set.
void OffsetLineChain(const SHAPE_LINE_CHAIN &aLine, int aAmount, CORNER_STRATEGY aCornerStrategy, int aMaxError, bool aSimplify)
Perform offsetting of a line chain.
int OutlineCount() const
Return the number of outlines in the set.
virtual VECTOR2I Centre() const
Compute a center-of-mass of the shape.
A name/value tuple with unique names and wxAny values.
void set_iu(const std::string &aKey, const T &aVar)
bool get_to(const std::string &aKey, T &aVar) const
std::optional< T > get_opt(const std::string &aKey) const
void set(const std::string &aKey, const T &aVar)
bool get_to_iu(const std::string &aKey, T &aVar) const
GR_TEXT_H_ALIGN_T m_Halign
void SetIsTimeDomain(const bool aIsTimeDomain)
void SetCurrent(const double aCurrent, const wxString &aLabel)
wxString GetClass() const override
Return the class name.
VECTOR2I GetPosition() const override
void SetMinMax(const double aMin, const double aMax)
void ViewDraw(int aLayer, KIGFX::VIEW *aView) const override
Draw the parts of the object belonging to layer aLayer.
std::vector< int > ViewGetLayers() const override
Return the all the layers within the VIEW the object is painted on.
TUNING_STATUS_VIEW_ITEM(PCB_BASE_EDIT_FRAME *aFrame)
const BOX2I ViewBBox() const override
Return the bounding box of the item covering all its layers.
void SetPosition(const VECTOR2I &aPos) override
wxString MessageTextFromValue(double aValue, bool aAddUnitLabel=true, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE) const
A lower-precision version of StringFromValue().
wxString MessageTextFromMinOptMax(const MINOPTMAX< int > &aValue, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE) const
PCB_TUNING_PATTERN * m_pattern
UNLOCKER(PCB_TUNING_PATTERN *aPattern)
constexpr extended_type SquaredDistance(const VECTOR2< T > &aVector) const
Compute the squared distance between two vectors.
static constexpr extended_type ECOORD_MAX
@ ROUND_ALL_CORNERS
All angles are rounded.
#define IS_NEW
New item, just created.
#define IN_EDIT
Item currently edited.
EDA_DATA_TYPE
The type of unit.
static FILENAME_RESOLVER * resolver
a few functions useful in geometry calculations.
PCB_LAYER_ID
A quick note on layer IDs:
KICOMMON_API wxString MessageTextFromValue(const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, double aValue, bool aAddUnitsText=true, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
A helper to convert the double length aValue to a string in inches, millimeters, or unscaled units.
TEXT_DIMS GetConstantGlyphHeight(KIGFX::GAL *aGal, int aRelativeSize=0)
Set the GAL glyph height to a constant scaled value, so that it always looks the same on screen.
Push and Shove diff pair dimensions (gap) settings dialog.
@ PNS_MODE_TUNE_DIFF_PAIR
@ PNS_MODE_TUNE_DIFF_PAIR_SKEW
Class to handle a set of BOARD_ITEMs.
static PNS::MEANDER_SIDE sideFromString(const std::string &aStr)
static LENGTH_TUNING_MODE tuningFromString(const std::string &aStr)
static std::string tuningToString(const LENGTH_TUNING_MODE aTuning)
static struct PCB_TUNING_PATTERN_DESC _PCB_TUNING_PATTERN_DESC
static LENGTH_TUNING_MODE fromPNSMode(PNS::ROUTER_MODE aRouterMode)
static PNS::MEANDER_PLACER_BASE::TUNING_STATUS statusFromString(const std::string &aStr)
static std::string sideToString(const PNS::MEANDER_SIDE aValue)
static std::string statusToString(const PNS::MEANDER_PLACER_BASE::TUNING_STATUS aStatus)
static GENERATORS_MGR::REGISTER< PCB_TUNING_PATTERN > registerMe
static PNS::LINKED_ITEM * pickSegment(PNS::ROUTER *aRouter, const VECTOR2I &aWhere, int aLayer, VECTOR2I &aPointOut, const SHAPE_LINE_CHAIN &aBaseline=SHAPE_LINE_CHAIN())
static std::optional< PNS::LINE > getPNSLine(const VECTOR2I &aStart, const VECTOR2I &aEnd, PNS::ROUTER *router, int layer, VECTOR2I &aStartOut, VECTOR2I &aEndOut)
static VECTOR2I snapToNearestTrack(const VECTOR2I &aP, BOARD *aBoard, NETINFO_ITEM *aNet, PCB_TRACK **aNearestTrack)
SCOPED_SET_RESET< DRAWING_TOOL::MODE > SCOPED_DRAW_MODE
static REGISTER_LEGACY_TUNING_PATTERN< PCB_TUNING_PATTERN > registerMeToo
#define NO_SETTER(owner, type)
#define ENUM_TO_WXANY(type)
Macro to define read-only fields (no setter method available)
@ PT_DEFAULT
Default property for a given type.
@ PT_SIZE
Size expressed in distance units (mm/inch)
@ PT_NET
Net selection property.
@ PT_TIME
Time expressed in ps.
constexpr double correction
#define HITTEST_THRESHOLD_PIXELS
std::vector< FAB_LAYER_COLOR > dummy
wxString UnescapeString(const wxString &aSource)
PCB_TUNING_PATTERN_DESC()
bool m_useClearanceEpsilon
An abstract function object, returning a design rule (clearance, diff pair gap, etc) required between...
Hold an object colliding with another object, along with some useful data about the collision.
REGISTER_LEGACY_TUNING_PATTERN()
Represents a single line in the tuning profile configuration grid.
bool m_EnableTimeDomainTuning
const SHAPE_LINE_CHAIN chain
wxString result
Test unit parsing edge cases and error handling.
double DEG2RAD(double deg)
@ NOT_USED
the 3d code uses this value
@ PCB_ARC_T
class PCB_ARC, an arc track segment on a copper layer
@ PCB_TRACE_T
class PCB_TRACK, a track segment (segment on a copper layer)
VECTOR2< int32_t > VECTOR2I
VECTOR2< double > VECTOR2D