KiCad PCB EDA Suite
Loading...
Searching...
No Matches
grid_helper.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 The KiCad Developers, see AUTHORS.txt for contributors.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, you may find one here:
18 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19 * or you may search the http://www.gnu.org website for the version 2 license,
20 * or you may write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23
24#include "tool/grid_helper.h"
25
26#include <functional>
27
28#include <advanced_config.h>
30#include <gal/painter.h>
31#include <math/util.h> // for KiROUND
32#include <math/vector2d.h>
33#include <render_settings.h>
34#include <tool/tool_manager.h>
35#include <tool/tools_holder.h>
36#include <view/view.h>
38
39
42{
44 m_enableSnap = true;
45 m_enableSnapLine = true;
46 m_enableGrid = true;
47 m_snapItem = std::nullopt;
48
49 m_manualGrid = VECTOR2D( 1, 1 );
51 m_manualOrigin = VECTOR2I( 0, 0 );
53}
54
55
56GRID_HELPER::GRID_HELPER( TOOL_MANAGER* aToolMgr, int aConstructionLayer ) :
58{
59 m_toolMgr = aToolMgr;
60
61 if( !m_toolMgr )
62 return;
63
64 KIGFX::VIEW* view = m_toolMgr->GetView();
65 KIGFX::RENDER_SETTINGS* settings = view->GetPainter()->GetSettings();
66
67 const KIGFX::COLOR4D constructionColour = settings->GetLayerColor( aConstructionLayer );
68 m_constructionGeomPreview.SetPersistentColor( constructionColour );
69 m_constructionGeomPreview.SetColor( constructionColour.WithAlpha( 0.7 ) );
70
73
74 m_snapManager.SetUpdateCallback(
75 [view, this]( bool aAnythingShown )
76 {
77 const bool currentlyVisible = view->IsVisible( &m_constructionGeomPreview );
78
79 if( currentlyVisible && aAnythingShown )
80 {
81 view->Update( &m_constructionGeomPreview, KIGFX::GEOMETRY );
82 }
83 else
84 {
85 view->SetVisible( &m_constructionGeomPreview, aAnythingShown );
86 }
87
88 m_toolMgr->GetToolHolder()->RefreshCanvas();
89 } );
90
91 // Initialise manual values from view for compatibility
92 m_manualGrid = view->GetGAL()->GetGridSize();
93 m_manualVisibleGrid = view->GetGAL()->GetVisibleGridSize();
94 m_manualOrigin = VECTOR2I( view->GetGAL()->GetGridOrigin() );
95 m_manualGridSnapping = view->GetGAL()->GetGridSnapping();
96}
97
98
100{
101 if( !m_toolMgr )
102 return;
103
104 KIGFX::VIEW& view = *m_toolMgr->GetView();
106
107 if( m_anchorDebug )
108 view.Remove( m_anchorDebug.get() );
109}
110
111
113{
114 static bool permitted = ADVANCED_CFG::GetCfg().m_EnableSnapAnchorsDebug;
115
116 if( !m_toolMgr )
117 return nullptr;
118
119 if( permitted && !m_anchorDebug )
120 {
121 KIGFX::VIEW& view = *m_toolMgr->GetView();
122 m_anchorDebug = std::make_unique<KIGFX::ANCHOR_DEBUG>();
123 view.Add( m_anchorDebug.get() );
124 view.SetVisible( m_anchorDebug.get(), true );
125 }
126
127 return m_anchorDebug.get();
128}
129
130
132{
133 if( m_toolMgr )
134 m_toolMgr->GetView()->SetVisible( &m_constructionGeomPreview, aShow );
135}
136
137
139{
140 if( !m_toolMgr )
141 return;
142
143 m_viewSnapPoint.SetPosition( aPoint.m_point );
144 m_viewSnapPoint.SetSnapTypes( aPoint.m_types );
145
146 if( m_toolMgr->GetView()->IsVisible( &m_viewSnapPoint ) )
147 m_toolMgr->GetView()->Update( &m_viewSnapPoint, KIGFX::GEOMETRY );
148 else
149 m_toolMgr->GetView()->SetVisible( &m_viewSnapPoint, true );
150}
151
152
154{
155 VECTOR2D size = m_toolMgr ? m_toolMgr->GetView()->GetGAL()->GetGridSize() : m_manualGrid;
156 return VECTOR2I( KiROUND( size.x ), KiROUND( size.y ) );
157}
158
159
161{
162 return m_toolMgr ? m_toolMgr->GetView()->GetGAL()->GetVisibleGridSize() : m_manualVisibleGrid;
163}
164
165
167{
168 if( m_toolMgr )
169 {
170 VECTOR2D origin = m_toolMgr->GetView()->GetGAL()->GetGridOrigin();
171 return VECTOR2I( origin );
172 }
173
174 return m_manualOrigin;
175}
176
177
179{
180 GRID_HELPER_GRIDS grid = GetItemGrid( aSelection.Front() );
181
182 // Find the largest grid of all the items and use that
183 for( EDA_ITEM* item : aSelection )
184 {
185 GRID_HELPER_GRIDS itemGrid = GetItemGrid( item );
186
187 if( GetGridSize( itemGrid ) > GetGridSize( grid ) )
188 grid = itemGrid;
189 }
190
191 return grid;
192}
193
194
196{
197 return m_toolMgr ? m_toolMgr->GetView()->GetGAL()->GetGridSize() : m_manualGrid;
198}
199
200
201void GRID_HELPER::SetAuxAxes( bool aEnable, const VECTOR2I& aOrigin )
202{
203 if( aEnable )
204 {
205 m_auxAxis = aOrigin;
206 m_viewAxis.SetPosition( aOrigin );
207 if( m_toolMgr )
208 m_toolMgr->GetView()->SetVisible( &m_viewAxis, true );
209 }
210 else
211 {
212 m_auxAxis = std::optional<VECTOR2I>();
213 if( m_toolMgr )
214 m_toolMgr->GetView()->SetVisible( &m_viewAxis, false );
215 }
216}
217
218
220{
221 return computeNearest( aPoint, GetGrid(), GetOrigin() );
222}
223
224
226 const VECTOR2D& aOffset ) const
227{
228 return computeNearest( aPoint, aGrid, aOffset );
229}
230
231
233 const VECTOR2I& aOffset ) const
234{
235 return VECTOR2I( KiROUND( (double) ( aPoint.x - aOffset.x ) / aGrid.x ) * aGrid.x + aOffset.x,
236 KiROUND( (double) ( aPoint.y - aOffset.y ) / aGrid.y ) * aGrid.y + aOffset.y );
237}
238
239
241{
242 return Align( aPoint, GetGrid(), GetOrigin() );
243}
244
245
246VECTOR2I GRID_HELPER::Align( const VECTOR2I& aPoint, const VECTOR2D& aGrid,
247 const VECTOR2D& aOffset ) const
248{
249 if( !canUseGrid() )
250 return aPoint;
251
252 VECTOR2I nearest = AlignGrid( aPoint, aGrid, aOffset );
253
254 if( !m_auxAxis )
255 return nearest;
256
257 if( std::abs( m_auxAxis->x - aPoint.x ) < std::abs( nearest.x - aPoint.x ) )
258 nearest.x = m_auxAxis->x;
259
260 if( std::abs( m_auxAxis->y - aPoint.y ) < std::abs( nearest.y - aPoint.y ) )
261 nearest.y = m_auxAxis->y;
262
263 return nearest;
264}
265
266
268{
269 return m_enableGrid && ( m_toolMgr ? m_toolMgr->GetView()->GetGAL()->GetGridSnapping()
271}
272
273
274std::optional<VECTOR2I> GRID_HELPER::GetSnappedPoint() const
275{
276 if( m_snapItem )
277 return m_snapItem->pos;
278
279 return std::nullopt;
280}
constexpr BOX2I KiROUND(const BOX2D &aBoxD)
Definition box2.h:990
static const ADVANCED_CFG & GetCfg()
Get the singleton instance's config, which is shared by all consumers.
A base class for most all the KiCad significant classes used in schematics and boards.
Definition eda_item.h:98
KIGFX::CONSTRUCTION_GEOM m_constructionGeomPreview
Show construction geometry (if any) on the canvas.
std::optional< VECTOR2I > m_auxAxis
VECTOR2I computeNearest(const VECTOR2I &aPoint, const VECTOR2I &aGrid, const VECTOR2I &aOffset) const
bool m_enableGrid
virtual GRID_HELPER_GRIDS GetItemGrid(const EDA_ITEM *aItem) const
Get the coarsest grid that applies to an item.
void showConstructionGeometry(bool aShow)
SNAP_MANAGER m_snapManager
Manage the construction geometry, snap lines, reference points, etc.
virtual ~GRID_HELPER()
VECTOR2D m_manualVisibleGrid
bool m_manualGridSnapping
VECTOR2I m_manualOrigin
virtual GRID_HELPER_GRIDS GetSelectionGrid(const SELECTION &aSelection) const
Gets the coarsest grid that applies to a selecion of items.
TOOL_MANAGER * m_toolMgr
std::optional< VECTOR2I > GetSnappedPoint() const
void SetAuxAxes(bool aEnable, const VECTOR2I &aOrigin=VECTOR2I(0, 0))
VECTOR2D GetVisibleGrid() const
std::unique_ptr< KIGFX::ANCHOR_DEBUG > m_anchorDebug
#VIEW_ITEM for visualising anchor points, if enabled.
virtual VECTOR2D GetGridSize(GRID_HELPER_GRIDS aGrid) const
Return the size of the specified grid.
VECTOR2I GetGrid() const
bool m_enableSnapLine
bool m_enableSnap
VECTOR2I GetOrigin() const
bool canUseGrid() const
Check whether it is possible to use the grid – this depends both on local grid helper settings and gl...
std::optional< ANCHOR > m_snapItem
KIGFX::ANCHOR_DEBUG * enableAndGetAnchorDebug()
Enable the anchor debug if permitted and return it.
KIGFX::SNAP_INDICATOR m_viewSnapPoint
virtual VECTOR2I Align(const VECTOR2I &aPoint, GRID_HELPER_GRIDS aGrid) const
Definition grid_helper.h:74
void updateSnapPoint(const TYPED_POINT2I &aPoint)
KIGFX::ORIGIN_VIEWITEM m_viewAxis
VECTOR2D m_manualGrid
virtual VECTOR2I AlignGrid(const VECTOR2I &aPoint, GRID_HELPER_GRIDS aGrid) const
Definition grid_helper.h:79
View item to draw debug items for anchors.
A color representation with 4 components: red, green, blue, alpha.
Definition color4d.h:104
COLOR4D WithAlpha(double aAlpha) const
Return a color with the same color, but the given alpha.
Definition color4d.h:311
const VECTOR2D & GetGridOrigin() const
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
const COLOR4D & GetLayerColor(int aLayer) const
Return the color used to draw a layer.
Hold a (potentially large) number of VIEW_ITEMs and renders them on a graphics device provided by the...
Definition view.h:66
virtual void Add(VIEW_ITEM *aItem, int aDrawPriority=-1)
Add a VIEW_ITEM to the view.
Definition view.cpp:298
virtual void Remove(VIEW_ITEM *aItem)
Remove a VIEW_ITEM from the view.
Definition view.cpp:341
GAL * GetGAL() const
Return the GAL this view is using to draw graphical primitives.
Definition view.h:202
PAINTER * GetPainter() const
Return the painter object used by the view for drawing #VIEW_ITEMS.
Definition view.h:220
void SetVisible(VIEW_ITEM *aItem, bool aIsVisible=true)
Set the item visibility.
Definition view.cpp:1612
EDA_ITEM * Front() const
Definition selection.h:177
Master controller class:
GRID_HELPER_GRIDS
Definition grid_helper.h:43
bool m_EnableSnapAnchorsDebug
Enable snap anchors debug visualization.
@ GEOMETRY
Position or shape has changed.
Definition view_item.h:55
EDA_ANGLE abs(const EDA_ANGLE &aAngle)
Definition eda_angle.h:400
VECTOR2I m_point
Definition point_types.h:77
VECTOR2< int32_t > VECTOR2I
Definition vector2d.h:695
VECTOR2< double > VECTOR2D
Definition vector2d.h:694