KiCad PCB EDA Suite
pcb_target.cpp
Go to the documentation of this file.
1 /*
2  * This program source code file is part of KiCad, a free EDA CAD application.
3  *
4  * Copyright (C) 2012 Jean-Pierre Charras, jp.charras at wanadoo.fr
5  * Copyright (C) 2012 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
6  * Copyright (C) 2012 Wayne Stambaugh <stambaughw@verizon.net>
7  * Copyright (C) 1992-2020 KiCad Developers, see AUTHORS.txt for contributors.
8  *
9  * This program is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU General Public License
11  * as published by the Free Software Foundation; either version 2
12  * of the License, or (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, you may find one here:
21  * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
22  * or you may search the http://www.gnu.org website for the version 2 license,
23  * or you may write to the Free Software Foundation, Inc.,
24  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
25  */
26 
27 #include <bitmaps.h>
28 #include <board.h>
29 #include <board_design_settings.h>
30 #include <pcb_target.h>
31 #include <base_units.h>
34 #include <trigo.h>
35 #include <i18n_utility.h>
36 #include <geometry/shape_circle.h>
37 #include <eda_draw_frame.h>
38 
40  BOARD_ITEM( aParent, PCB_TARGET_T )
41 {
42  m_shape = 0;
43  m_size = Millimeter2iu( 5 ); // Gives a decent size
45  m_layer = Edge_Cuts; // a target is on all layers
46 }
47 
48 PCB_TARGET::PCB_TARGET( BOARD_ITEM* aParent, int aShape, PCB_LAYER_ID aLayer,
49  const wxPoint& aPos, int aSize, int aWidth ) :
50  BOARD_ITEM( aParent, PCB_TARGET_T )
51 {
52  m_shape = aShape;
53  m_layer = aLayer;
54  m_pos = aPos;
55  m_size = aSize;
56  m_lineWidth = aWidth;
57 }
58 
59 
61 {
62 }
63 
64 
65 bool PCB_TARGET::HitTest( const wxPoint& aPosition, int aAccuracy ) const
66 {
67  int dX = aPosition.x - m_pos.x;
68  int dY = aPosition.y - m_pos.y;
69  int radius = aAccuracy + ( m_size / 2 );
70  return abs( dX ) <= radius && abs( dY ) <= radius;
71 }
72 
73 
74 bool PCB_TARGET::HitTest( const EDA_RECT& aRect, bool aContained, int aAccuracy ) const
75 {
76  EDA_RECT arect = aRect;
77  arect.Inflate( aAccuracy );
78 
79  if( aContained )
80  return arect.Contains( GetBoundingBox() );
81  else
82  return GetBoundingBox().Intersects( arect );
83 }
84 
85 
86 void PCB_TARGET::Rotate(const wxPoint& aRotCentre, double aAngle)
87 {
88  RotatePoint( &m_pos, aRotCentre, aAngle );
89 }
90 
91 
92 void PCB_TARGET::Flip(const wxPoint& aCentre, bool aFlipLeftRight )
93 {
94  if( aFlipLeftRight )
95  m_pos.x = aCentre.x - ( m_pos.x - aCentre.x );
96  else
97  m_pos.y = aCentre.y - ( m_pos.y - aCentre.y );
98 
99  SetLayer( FlipLayer( GetLayer(), GetBoard()->GetCopperLayerCount() ) );
100 }
101 
102 
104 {
105  EDA_RECT bBox;
106  bBox.SetX( m_pos.x - m_size / 2 );
107  bBox.SetY( m_pos.y - m_size / 2 );
108  bBox.SetWidth( m_size );
109  bBox.SetHeight( m_size );
110 
111  return bBox;
112 }
113 
114 
115 std::shared_ptr<SHAPE> PCB_TARGET::GetEffectiveShape( PCB_LAYER_ID aLayer ) const
116 {
117  return std::make_shared<SHAPE_CIRCLE>( m_pos, m_size / 2 );
118 }
119 
120 
121 wxString PCB_TARGET::GetSelectMenuText( EDA_UNITS aUnits ) const
122 {
123  // Targets are on *every* layer by definition
124  return _( "Target" );
125 }
126 
127 
129 {
131 }
132 
133 
135 {
136  return new PCB_TARGET( *this );
137 }
138 
139 
141 {
142  assert( aImage->Type() == PCB_TARGET_T );
143 
144  std::swap( *((PCB_TARGET*) this), *((PCB_TARGET*) aImage) );
145 }
146 
147 
148 void PCB_TARGET::GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList )
149 {
150  EDA_UNITS units = aFrame->GetUserUnits();
151 
152  aList.emplace_back( _( "PCB Target" ), wxEmptyString );
153 
154  aList.emplace_back( _( "Layer" ), GetLayerName() );
155 
156  aList.emplace_back( _( "Size" ), MessageTextFromValue( units, GetSize() ) );
157  aList.emplace_back( _( "Width" ), MessageTextFromValue( units, GetWidth() ) );
158  aList.emplace_back( _( "Shape" ), GetShape() == 0 ? "+" : "X" );
159 }
160 
161 
162 static struct PCB_TARGET_DESC
163 {
165  {
169  propMgr.AddProperty( new PROPERTY<PCB_TARGET, int>( _HKI( "Size" ),
171  propMgr.AddProperty( new PROPERTY<PCB_TARGET, int>( _HKI( "Width" ),
173 
174  auto shape = new PROPERTY<PCB_TARGET, int>( _HKI( "Shape" ),
176  // TODO change the integer to an enum?
177  //shape->SetValues( { { 0, _HKI( "Cross" ) }, { 1, ( "Plus" ) } } );
178  propMgr.AddProperty( shape );
179  }
wxString MessageTextFromValue(EDA_UNITS aUnits, int aValue, bool aAddUnitLabel, EDA_DATA_TYPE aType)
Convert a value to a string using double notation.
Definition: base_units.cpp:104
static PROPERTY_MANAGER & Instance()
Definition: property_mgr.h:65
BITMAPS GetMenuImage() const override
Return a pointer to an image to be used in menus.
Definition: pcb_target.cpp:128
#define TYPE_HASH(x)
Definition: property.h:59
virtual void SetLayer(PCB_LAYER_ID aLayer)
Set the layer this item is on.
Definition: board_item.h:192
Implementation of conversion functions that require both schematic and board internal units.
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:80
void SetSize(int aSize)
Definition: pcb_target.h:61
wxString GetSelectMenuText(EDA_UNITS aUnits) const override
Return the text to display to be used in the selection clarification context menu when multiple items...
Definition: pcb_target.cpp:121
int GetSize() const
Definition: pcb_target.h:62
PCB_LAYER_ID FlipLayer(PCB_LAYER_ID aLayerId, int aCopperLayersCount)
Definition: lset.cpp:521
#define DEFAULT_COPPER_LINE_WIDTH
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:228
The base class for create windows for drawing purpose.
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.
Definition: pcb_target.cpp:148
#define REGISTER_TYPE(x)
Definition: property_mgr.h:248
bool Contains(const wxPoint &aPoint) const
Definition: eda_rect.cpp:57
bool HitTest(const wxPoint &aPosition, int aAccuracy=0) const override
Test if aPosition is contained within or on the bounding box of an item.
Definition: pcb_target.cpp:65
int GetWidth() const
Definition: pcb_target.h:65
std::shared_ptr< SHAPE > GetEffectiveShape(PCB_LAYER_ID aLayer) const override
Some pad shapes can be complex (rounded/chamfered rectangle), even without considering custom shapes.
Definition: pcb_target.cpp:115
PCB_LAYER_ID
A quick note on layer IDs:
Display value expressed in distance units (mm/inch)
Definition: property.h:53
void SetHeight(int val)
Definition: eda_rect.h:176
EDA_ITEM * Clone() const override
Create a duplicate of this item with linked list members set to NULL.
Definition: pcb_target.cpp:134
virtual void SwapData(BOARD_ITEM *aImage) override
Swap data between aItem and aImage.
Definition: pcb_target.cpp:140
void Flip(const wxPoint &aCentre, bool aFlipLeftRight) override
Flip this object, i.e.
Definition: pcb_target.cpp:92
virtual BOARD * GetBoard() const
Return the BOARD in which this BOARD_ITEM resides, or NULL if none.
Definition: board_item.cpp:51
void InheritsAfter(TYPE_ID aDerived, TYPE_ID aBase)
Declare an inheritance relationship between types.
#define _(s)
void SetShape(int aShape)
Definition: pcb_target.h:58
void SetX(int val)
Definition: eda_rect.h:158
void SetWidth(int val)
Definition: eda_rect.h:170
void SetY(int val)
Definition: eda_rect.h:164
static struct PCB_TARGET_DESC _PCB_TARGET_DESC
class PCB_TARGET, a target (graphic item)
Definition: typeinfo.h:104
int m_lineWidth
Definition: pcb_target.h:106
Some functions to handle hotkeys in KiCad.
wxPoint m_pos
Definition: pcb_target.h:107
EDA_UNITS
Definition: eda_units.h:38
void Rotate(const wxPoint &aRotCentre, double aAngle) override
Rotate this object.
Definition: pcb_target.cpp:86
BITMAPS
A list of all bitmap identifiers.
Definition: bitmaps_list.h:32
void AddProperty(PROPERTY_BASE *aProperty)
Register a property.
Handle the component boundary box.
Definition: eda_rect.h:42
int GetShape() const
Definition: pcb_target.h:59
A base class for most all the KiCad significant classes used in schematics and boards.
Definition: eda_item.h:100
bool Intersects(const EDA_RECT &aRect) const
Test for a common area between rectangles.
Definition: eda_rect.cpp:150
void SetWidth(int aWidth)
Definition: pcb_target.h:64
PCB_LAYER_ID m_layer
Definition: board_item.h:352
Provide class metadata.Helper macro to map type hashes to names.
Definition: property_mgr.h:62
PCB_TARGET(BOARD_ITEM *aParent)
Definition: pcb_target.cpp:39
wxString GetLayerName() const
Return the name of the PCB layer on which the item resides.
Definition: board_item.cpp:74
static constexpr int Millimeter2iu(double mm)
#define _HKI(x)
virtual PCB_LAYER_ID GetLayer() const
Return the primary layer this item is on.
Definition: board_item.h:171
EDA_UNITS GetUserUnits() const
Return the user units currently in use.
const EDA_RECT GetBoundingBox() const override
Return the orthogonal bounding box of this object for display purposes.
Definition: pcb_target.cpp:103
EDA_RECT & Inflate(wxCoord dx, wxCoord dy)
Inflate the rectangle horizontally by dx and vertically by dy.
Definition: eda_rect.cpp:364
KICAD_T Type() const
Returns the type of object.
Definition: eda_item.h:113