KiCad PCB EDA Suite
Loading...
Searching...
No Matches
create_3Dgraphic_brd_items.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) 2015-2016 Mario Luzeiro <[email protected]>
5 * Copyright (C) 2023 CERN
6 * Copyright (C) 1992-2024 KiCad Developers, see AUTHORS.txt for contributors.
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2
11 * of the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, you may find one here:
20 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
21 * or you may search the http://www.gnu.org website for the version 2 license,
22 * or you may write to the Free Software Foundation, Inc.,
23 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
24 */
25
32#include "../3d_rendering/raytracing/shapes2D/ring_2d.h"
33#include "../3d_rendering/raytracing/shapes2D/filled_circle_2d.h"
34#include "../3d_rendering/raytracing/shapes2D/round_segment_2d.h"
35#include "../3d_rendering/raytracing/shapes2D/triangle_2d.h"
36#include <board_adapter.h>
37#include <footprint.h>
38#include <pad.h>
39#include <pcb_text.h>
40#include <pcb_textbox.h>
41#include <pcb_table.h>
43#include <pcb_painter.h> // for PCB_RENDER_SETTINGS
44#include <zone.h>
46#include <trigo.h>
50#include <geometry/shape_rect.h>
52#include <utility>
53#include <vector>
54#include <wx/log.h>
55#include <macros.h>
56#include <callback_gal.h>
57
58
59#define TO_3DU( x ) ( ( x ) * m_biuTo3Dunits )
60
61#define TO_SFVEC2F( vec ) SFVEC2F( TO_3DU( vec.x ), TO_3DU( -vec.y ) )
62
63
64void addFILLED_CIRCLE_2D( CONTAINER_2D_BASE* aContainer, const SFVEC2F& aCenter, float aRadius,
65 const BOARD_ITEM& aBoardItem )
66{
67 if( aRadius > 0.0f )
68 aContainer->Add( new FILLED_CIRCLE_2D( aCenter, aRadius, aBoardItem ) );
69}
70
71
72void addRING_2D( CONTAINER_2D_BASE* aContainer, const SFVEC2F& aCenter, float aInnerRadius,
73 float aOuterRadius, const BOARD_ITEM& aBoardItem )
74{
75 if( aOuterRadius > aInnerRadius && aInnerRadius > 0.0f )
76 aContainer->Add( new RING_2D( aCenter, aInnerRadius, aOuterRadius, aBoardItem ) );
77}
78
79
80void addROUND_SEGMENT_2D( CONTAINER_2D_BASE* aContainer, const SFVEC2F& aStart, const SFVEC2F& aEnd,
81 float aWidth, const BOARD_ITEM& aBoardItem )
82{
83 if( Is_segment_a_circle( aStart, aEnd ) )
84 {
85 // Cannot add segments that have the same start and end point
86 addFILLED_CIRCLE_2D( aContainer, aStart, aWidth / 2, aBoardItem );
87 return;
88 }
89
90 if( aWidth > 0.0f )
91 aContainer->Add( new ROUND_SEGMENT_2D( aStart, aEnd, aWidth, aBoardItem ) );
92}
93
94
95void BOARD_ADAPTER::addText( const EDA_TEXT* aText, CONTAINER_2D_BASE* aContainer,
96 const BOARD_ITEM* aOwner )
97{
99 TEXT_ATTRIBUTES attrs = aText->GetAttributes();
100 float penWidth_3DU = TO_3DU( aText->GetEffectiveTextPenWidth() );
101 KIFONT::FONT* font = aText->GetFont();
102
103 if( !font )
104 font = KIFONT::FONT::GetFont( wxEmptyString, aText->IsBold(), aText->IsItalic() );
105
106 if( aOwner && aOwner->IsKnockout() )
107 {
108 SHAPE_POLY_SET finalPoly;
109 const PCB_TEXT* pcbText = static_cast<const PCB_TEXT*>( aOwner );
110
112 ERROR_INSIDE );
113
114 // Do not call finalPoly.Fracture() here: ConvertPolygonToTriangles() call it
115 // if needed, and Fracture() called twice can create bad results and is useless
116 ConvertPolygonToTriangles( finalPoly, *aContainer, m_biuTo3Dunits, *aOwner );
117 }
118 else
119 {
120 CALLBACK_GAL callback_gal( empty_opts,
121 // Stroke callback
122 [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2 )
123 {
124 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( aPt1 ), TO_SFVEC2F( aPt2 ),
125 penWidth_3DU, *aOwner );
126 },
127 // Triangulation callback
128 [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2, const VECTOR2I& aPt3 )
129 {
130 aContainer->Add( new TRIANGLE_2D( TO_SFVEC2F( aPt1 ), TO_SFVEC2F( aPt2 ),
131 TO_SFVEC2F( aPt3 ), *aOwner ) );
132 } );
133
134 attrs.m_Angle = aText->GetDrawRotation();
135
136 font->Draw( &callback_gal, aText->GetShownText( true ), aText->GetDrawPos(), attrs,
137 aOwner->GetFontMetrics() );
138 }
139}
140
141
143 const BOARD_ITEM* aOwner )
144{
145 addText( aDimension, aContainer, aDimension );
146
147 const int linewidth = aDimension->GetLineThickness();
148
149 for( const std::shared_ptr<SHAPE>& shape : aDimension->GetShapes() )
150 {
151 switch( shape->Type() )
152 {
153 case SH_SEGMENT:
154 {
155 const SEG& seg = static_cast<const SHAPE_SEGMENT*>( shape.get() )->GetSeg();
156
157 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( seg.A ), TO_SFVEC2F( seg.B ),
158 TO_3DU( linewidth ), *aOwner );
159 break;
160 }
161
162 case SH_CIRCLE:
163 {
164 int radius = static_cast<const SHAPE_CIRCLE*>( shape.get() )->GetRadius();
165 float innerR3DU = TO_3DU( radius ) - TO_3DU( aDimension->GetLineThickness() ) / 2.0f;
166 float outerR3DU = TO_3DU( radius ) + TO_3DU( aDimension->GetLineThickness() ) / 2.0f;
167
168 addRING_2D( aContainer, TO_SFVEC2F( shape->Centre() ), innerR3DU, outerR3DU, *aOwner );
169
170 break;
171 }
172
173 default:
174 break;
175 }
176 }
177}
178
179
181 PCB_LAYER_ID aLayerId,
182 const std::bitset<LAYER_3D_END>& aVisibilityFlags )
183{
185
186 for( PCB_FIELD* field : aFootprint->GetFields() )
187 {
188 if( field->GetLayer() == aLayerId && field->IsVisible() )
189 {
190 if( !aVisibilityFlags.test( LAYER_FP_TEXT ) )
191 continue;
192 else if( field->IsReference() && !aVisibilityFlags.test( LAYER_FP_REFERENCES ) )
193 continue;
194 else if( field->IsValue() && !aVisibilityFlags.test( LAYER_FP_VALUES ) )
195 continue;
196
197 addText( field, aContainer, field );
198 }
199 }
200
201 for( BOARD_ITEM* item : aFootprint->GraphicalItems() )
202 {
203 switch( item->Type() )
204 {
205 case PCB_TEXT_T:
206 {
207 PCB_TEXT* text = static_cast<PCB_TEXT*>( item );
208
209 if( text->GetLayer() == aLayerId && text->IsVisible() )
210 {
211 if( !aVisibilityFlags.test( LAYER_FP_TEXT ) )
212 continue;
213 else if( text->GetText() == wxT( "${REFERENCE}" ) && !aVisibilityFlags.test( LAYER_FP_REFERENCES ) )
214 continue;
215 else if( text->GetText() == wxT( "${VALUE}" ) && !aVisibilityFlags.test( LAYER_FP_VALUES ) )
216 continue;
217
218 addText( text, aContainer, text );
219 }
220
221 break;
222 }
223
224 case PCB_TEXTBOX_T:
225 {
226 PCB_TEXTBOX* textbox = static_cast<PCB_TEXTBOX*>( item );
227
228 if( textbox->GetLayer() == aLayerId )
229 addShape( textbox, aContainer, aFootprint );
230
231 break;
232 }
233
234 case PCB_TABLE_T:
235 {
236 PCB_TABLE* table = static_cast<PCB_TABLE*>( item );
237
238 if( table->GetLayer() == aLayerId )
239 addTable( table, aContainer, aFootprint );
240
241 break;
242 }
243
245 case PCB_DIM_CENTER_T:
247 case PCB_DIM_RADIAL_T:
248 case PCB_DIM_LEADER_T:
249 {
250 PCB_DIMENSION_BASE* dimension = static_cast<PCB_DIMENSION_BASE*>( item );
251
252 if( dimension->GetLayer() == aLayerId )
253 addShape( dimension, aContainer, aFootprint );
254
255 break;
256 }
257
258 case PCB_SHAPE_T:
259 {
260 PCB_SHAPE* shape = static_cast<PCB_SHAPE*>( item );
261
262 if( shape->GetLayer() == aLayerId )
263 addShape( shape, aContainer, aFootprint );
264
265 break;
266 }
267
268 default:
269 break;
270 }
271 }
272}
273
274
276 int aMargin )
277{
278 SFVEC2F start3DU = TO_SFVEC2F( aTrack->GetStart() );
279 SFVEC2F end3DU = TO_SFVEC2F( aTrack->GetEnd() );
280 const float radius3DU = TO_3DU( ( aTrack->GetWidth() / 2.0 ) + aMargin );
281
282 addFILLED_CIRCLE_2D( aDstContainer, start3DU, radius3DU, *aTrack );
283}
284
285
286void BOARD_ADAPTER::createTrack( const PCB_TRACK* aTrack, CONTAINER_2D_BASE* aDstContainer )
287{
288 SFVEC2F start3DU = TO_SFVEC2F( aTrack->GetStart() );
289 SFVEC2F end3DU = TO_SFVEC2F( aTrack->GetEnd() );
290
291 switch( aTrack->Type() )
292 {
293 case PCB_VIA_T:
294 addFILLED_CIRCLE_2D( aDstContainer, start3DU, TO_3DU( aTrack->GetWidth() / 2.0 ), *aTrack );
295 break;
296
297 case PCB_ARC_T:
298 {
299 const PCB_ARC* arc = static_cast<const PCB_ARC*>( aTrack );
300
301 if( arc->IsDegenerated() )
302 {
303 // Draw this very small arc like a track segment (a PCB_TRACE_T)
304 PCB_TRACK track( arc->GetParent() );
305 track.SetStart( arc->GetStart() );
306 track.SetEnd( arc->GetEnd() );
307 track.SetWidth( arc->GetWidth() );
308 track.SetLayer( arc->GetLayer() );
309
310 createTrack( &track, aDstContainer );
311 return;
312 }
313
314 VECTOR2I center( arc->GetCenter() );
315 EDA_ANGLE arc_angle = arc->GetAngle();
316 double radius = arc->GetRadius();
317 int arcsegcount = GetArcToSegmentCount( KiROUND( radius ), ARC_HIGH_DEF, arc_angle );
318 int circlesegcount;
319
320 // Avoid arcs that cannot be drawn
321 if( radius < std::numeric_limits<double>::min() || arc_angle.IsZero() )
322 break;
323
324 // We need a circle to segment count. However, the arc angle can be small, and the
325 // radius very big. so we calculate a reasonable value for circlesegcount.
326 if( arcsegcount <= 1 ) // The arc will be approximated by a segment
327 {
328 circlesegcount = 1;
329 }
330 else
331 {
332 circlesegcount = KiROUND( arcsegcount * 360.0 / std::abs( arc_angle.AsDegrees() ) );
333 circlesegcount = alg::clamp( 1, circlesegcount, 128 );
334 }
335
336 createArcSegments( center, arc->GetStart(), arc_angle, circlesegcount, arc->GetWidth(),
337 aDstContainer, *arc );
338 break;
339 }
340
341 case PCB_TRACE_T: // Track is a usual straight segment
342 {
343 addROUND_SEGMENT_2D( aDstContainer, start3DU, end3DU, TO_3DU( aTrack->GetWidth() ), *aTrack );
344 break;
345 }
346
347 default:
348 break;
349 }
350}
351
352
354 PCB_LAYER_ID aLayer, const VECTOR2I& aMargin ) const
355{
356 SHAPE_POLY_SET poly;
357 int maxError = GetBoard()->GetDesignSettings().m_MaxError;
358 VECTOR2I clearance = aMargin;
359
360 // Our shape-based builder can't handle negative or differing x:y clearance values (the
361 // former are common for solder paste while the later get generated when a relative paste
362 // margin is used with an oblong pad). So we apply this huge hack and fake a larger pad to
363 // run the general-purpose polygon builder on.
364 // Of course being a hack it falls down when dealing with custom shape pads (where the size
365 // is only the size of the anchor), so for those we punt and just use aMargin.x.
366
367 if( ( clearance.x < 0 || clearance.x != clearance.y )
368 && aPad->GetShape() != PAD_SHAPE::CUSTOM )
369 {
370 VECTOR2I dummySize = VECTOR2I( aPad->GetSize() ) + clearance + clearance;
371
372 if( dummySize.x <= 0 || dummySize.y <= 0 )
373 return;
374
375 PAD dummy( *aPad );
376 dummy.SetSize( VECTOR2I( dummySize.x, dummySize.y ) );
377 dummy.TransformShapeToPolygon( poly, aLayer, 0, maxError, ERROR_INSIDE );
378 clearance = { 0, 0 };
379
380 // Remove group membership from dummy item before deleting
381 dummy.SetParentGroup( nullptr );
382 }
383 else
384 {
385 auto padShapes = std::static_pointer_cast<SHAPE_COMPOUND>( aPad->GetEffectiveShape() );
386
387 for( const SHAPE* shape : padShapes->Shapes() )
388 {
389 switch( shape->Type() )
390 {
391 case SH_SEGMENT:
392 {
393 const SHAPE_SEGMENT* seg = static_cast<const SHAPE_SEGMENT*>( shape );
394
395 addROUND_SEGMENT_2D( aContainer,
396 TO_SFVEC2F( seg->GetSeg().A ),
397 TO_SFVEC2F( seg->GetSeg().B ),
398 TO_3DU( seg->GetWidth() + clearance.x * 2 ),
399 *aPad );
400 break;
401 }
402
403 case SH_CIRCLE:
404 {
405 const SHAPE_CIRCLE* circle = static_cast<const SHAPE_CIRCLE*>( shape );
406
407 addFILLED_CIRCLE_2D( aContainer,
408 TO_SFVEC2F( circle->GetCenter() ),
409 TO_3DU( circle->GetRadius() + clearance.x ),
410 *aPad );
411 break;
412 }
413
414 case SH_RECT:
415 {
416 const SHAPE_RECT* rect = static_cast<const SHAPE_RECT*>( shape );
417
418 poly.NewOutline();
419 poly.Append( rect->GetPosition() );
420 poly.Append( rect->GetPosition().x + rect->GetSize().x, rect->GetPosition().y );
421 poly.Append( rect->GetPosition() + rect->GetSize() );
422 poly.Append( rect->GetPosition().x, rect->GetPosition().y + rect->GetSize().y );
423 break;
424 }
425
426 case SH_SIMPLE:
427 poly.AddOutline( static_cast<const SHAPE_SIMPLE*>( shape )->Vertices() );
428 break;
429
430 case SH_POLY_SET:
431 poly = *(SHAPE_POLY_SET*) shape;
432 break;
433
434 case SH_ARC:
435 {
436 const SHAPE_ARC* arc = static_cast<const SHAPE_ARC*>( shape );
437 SHAPE_LINE_CHAIN l = arc->ConvertToPolyline( maxError );
438
439 for( int i = 0; i < l.SegmentCount(); i++ )
440 {
441 SHAPE_SEGMENT seg( l.Segment( i ).A, l.Segment( i ).B, arc->GetWidth() );
442
443 addROUND_SEGMENT_2D( aContainer,
444 TO_SFVEC2F( seg.GetSeg().A ),
445 TO_SFVEC2F( seg.GetSeg().B ),
446 TO_3DU( arc->GetWidth() + clearance.x * 2 ),
447 *aPad );
448 }
449
450 break;
451 }
452
453 default:
454 UNIMPLEMENTED_FOR( SHAPE_TYPE_asString( shape->Type() ) );
455 break;
456 }
457 }
458 }
459
460 if( !poly.IsEmpty() )
461 {
462 if( clearance.x )
463 poly.Inflate( clearance.x, CORNER_STRATEGY::ROUND_ALL_CORNERS, maxError );
464
465 // Add the PAD polygon
466 ConvertPolygonToTriangles( poly, *aContainer, m_biuTo3Dunits, *aPad );
467 }
468}
469
470
472 int aInflateValue )
473{
474 if( !aPad->HasHole() )
475 {
476 wxLogTrace( m_logTrace, wxT( "BOARD_ADAPTER::createPadWithHole - found an invalid pad" ) );
477 return;
478 }
479
480 std::shared_ptr<SHAPE_SEGMENT> slot = aPad->GetEffectiveHoleShape();
481
482 addROUND_SEGMENT_2D( aDstContainer,
483 TO_SFVEC2F( slot->GetSeg().A ),
484 TO_SFVEC2F( slot->GetSeg().B ),
485 TO_3DU( slot->GetWidth() + aInflateValue * 2 ),
486 *aPad );
487}
488
489
490void BOARD_ADAPTER::addPads( const FOOTPRINT* aFootprint, CONTAINER_2D_BASE* aContainer,
491 PCB_LAYER_ID aLayerId, bool aSkipPlatedPads, bool aSkipNonPlatedPads )
492{
493 for( PAD* pad : aFootprint->Pads() )
494 {
495 if( !pad->IsOnLayer( aLayerId ) )
496 continue;
497
498 if( IsCopperLayer( aLayerId ) )
499 {
500 // Skip pad annulus when there isn't one (note: this is more discerning than
501 // pad->IsOnLayer(), which doesn't check for NPTH pads with holes that consume
502 // the entire pad).
503 if( !pad->IsOnCopperLayer() )
504 continue;
505
506 // Skip pad annulus when not connected on this layer (if removing is enabled)
507 if( !pad->FlashLayer( aLayerId ) )
508 continue;
509 }
510
511 VECTOR2I margin( 0, 0 );
512
513 switch( aLayerId )
514 {
515 case F_Cu:
516 if( aSkipPlatedPads && pad->FlashLayer( F_Mask ) )
517 continue;
518
519 if( aSkipNonPlatedPads && !pad->FlashLayer( F_Mask ) )
520 continue;
521
522 break;
523
524 case B_Cu:
525 if( aSkipPlatedPads && pad->FlashLayer( B_Mask ) )
526 continue;
527
528 if( aSkipNonPlatedPads && !pad->FlashLayer( B_Mask ) )
529 continue;
530
531 break;
532
533 case F_Mask:
534 case B_Mask:
535 margin.x += pad->GetSolderMaskExpansion();
536 margin.y += pad->GetSolderMaskExpansion();
537 break;
538
539 case F_Paste:
540 case B_Paste:
541 margin += pad->GetSolderPasteMargin();
542 break;
543
544 default:
545 break;
546 }
547
548 createPadWithMargin( pad, aContainer, aLayerId, margin );
549 }
550}
551
552
553// based on TransformArcToPolygon function from
554// common/convert_basic_shapes_to_polygon.cpp
555void BOARD_ADAPTER::createArcSegments( const VECTOR2I& aCentre, const VECTOR2I& aStart,
556 const EDA_ANGLE& aArcAngle, int aCircleToSegmentsCount,
557 int aWidth, CONTAINER_2D_BASE* aContainer,
558 const BOARD_ITEM& aOwner )
559{
560 // Don't attempt to render degenerate shapes
561 if( aWidth == 0 )
562 return;
563
564 VECTOR2I arc_start, arc_end;
565 EDA_ANGLE arcAngle( aArcAngle );
566 EDA_ANGLE delta = ANGLE_360 / aCircleToSegmentsCount; // rotate angle
567
568 arc_end = arc_start = aStart;
569
570 if( arcAngle != ANGLE_360 )
571 RotatePoint( arc_end, aCentre, -arcAngle );
572
573 if( arcAngle < ANGLE_0 )
574 {
575 std::swap( arc_start, arc_end );
576 arcAngle = -arcAngle;
577 }
578
579 // Compute the ends of segments and creates poly
580 VECTOR2I curr_end = arc_start;
581 VECTOR2I curr_start = arc_start;
582
583 for( EDA_ANGLE ii = delta; ii < arcAngle; ii += delta )
584 {
585 curr_end = arc_start;
586 RotatePoint( curr_end, aCentre, -ii );
587
588 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( curr_start ), TO_SFVEC2F( curr_end ),
589 TO_3DU( aWidth ), aOwner );
590
591 curr_start = curr_end;
592 }
593
594 if( curr_end != arc_end )
595 {
596 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( curr_end ), TO_SFVEC2F( arc_end ),
597 TO_3DU( aWidth ), aOwner );
598 }
599}
600
601
602void BOARD_ADAPTER::addShape( const PCB_SHAPE* aShape, CONTAINER_2D_BASE* aContainer,
603 const BOARD_ITEM* aOwner )
604{
605 // The full width of the lines to create
606 const float linewidth3DU = TO_3DU( aShape->GetWidth() );
607 LINE_STYLE lineStyle = aShape->GetStroke().GetLineStyle();
608
609 if( lineStyle <= LINE_STYLE::FIRST_TYPE )
610 {
611 switch( aShape->GetShape() )
612 {
613 case SHAPE_T::CIRCLE:
614 {
615 SFVEC2F center3DU = TO_SFVEC2F( aShape->GetCenter() );
616 float innerR3DU = TO_3DU( aShape->GetRadius() ) - linewidth3DU / 2.0;
617 float outerR3DU = TO_3DU( aShape->GetRadius() ) + linewidth3DU / 2.0;
618
619 if( aShape->IsFilled() || innerR3DU <= 0.0 )
620 addFILLED_CIRCLE_2D( aContainer, center3DU, outerR3DU, *aOwner );
621 else
622 addRING_2D( aContainer, center3DU, innerR3DU, outerR3DU, *aOwner );
623
624 break;
625 }
626
627 case SHAPE_T::RECTANGLE:
628 if( aShape->IsFilled() )
629 {
630 SHAPE_POLY_SET polyList;
631
633 ERROR_INSIDE );
634
636
637 ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner );
638 }
639 else
640 {
641 std::vector<VECTOR2I> pts = aShape->GetRectCorners();
642
643 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[0] ), TO_SFVEC2F( pts[1] ),
644 linewidth3DU, *aOwner );
645 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[1] ), TO_SFVEC2F( pts[2] ),
646 linewidth3DU, *aOwner );
647 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[2] ), TO_SFVEC2F( pts[3] ),
648 linewidth3DU, *aOwner );
649 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[3] ), TO_SFVEC2F( pts[0] ),
650 linewidth3DU, *aOwner );
651 }
652 break;
653
654 case SHAPE_T::ARC:
655 {
656 unsigned int segCount = GetCircleSegmentCount( aShape->GetBoundingBox().GetSizeMax() );
657
658 createArcSegments( aShape->GetCenter(), aShape->GetStart(), aShape->GetArcAngle(),
659 segCount, aShape->GetWidth(), aContainer, *aOwner );
660 break;
661 }
662
663 case SHAPE_T::SEGMENT:
664 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( aShape->GetStart() ),
665 TO_SFVEC2F( aShape->GetEnd() ), linewidth3DU, *aOwner );
666 break;
667
668 case SHAPE_T::BEZIER:
669 case SHAPE_T::POLY:
670 {
671 SHAPE_POLY_SET polyList;
672
674 ERROR_INSIDE );
675
676 // Some polygons can be a bit complex (especially when coming from a
677 // picture ot a text converted to a polygon
678 // So call Simplify before calling ConvertPolygonToTriangles, just in case.
680
681 if( polyList.IsEmpty() ) // Just for caution
682 break;
683
684 ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner );
685 break;
686 }
687
688 default:
689 wxFAIL_MSG( wxT( "BOARD_ADAPTER::addShape no implementation for " )
690 + aShape->SHAPE_T_asString() );
691 break;
692 }
693 }
694 else
695 {
696 std::vector<SHAPE*> shapes = aShape->MakeEffectiveShapes( true );
697 SFVEC2F a3DU;
698 SFVEC2F b3DU;
699
700 const PCB_PLOT_PARAMS& plotParams = aShape->GetBoard()->GetPlotOptions();
701 KIGFX::PCB_RENDER_SETTINGS renderSettings;
702
703 renderSettings.SetDashLengthRatio( plotParams.GetDashedLineDashRatio() );
704 renderSettings.SetGapLengthRatio( plotParams.GetDashedLineGapRatio() );
705
706 for( SHAPE* shape : shapes )
707 {
708 STROKE_PARAMS::Stroke( shape, lineStyle, aShape->GetWidth(), &renderSettings,
709 [&]( const VECTOR2I& a, const VECTOR2I& b )
710 {
711 addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( a ), TO_SFVEC2F( b ),
712 linewidth3DU, *aOwner );
713 } );
714 }
715
716 for( SHAPE* shape : shapes )
717 delete shape;
718 }
719}
720
721
722void BOARD_ADAPTER::addShape( const PCB_TEXTBOX* aTextBox, CONTAINER_2D_BASE* aContainer,
723 const BOARD_ITEM* aOwner )
724{
725 addText( aTextBox, aContainer, aOwner );
726
727 if( !aTextBox->IsBorderEnabled() )
728 return;
729
730 // We cannot use PCB_TEXTBOX::TransformShapeToPolygon because it convert the textbox
731 // as filled polygon even if there's no background colour.
732 // So for polygon, we use PCB_SHAPE::TransformShapeToPolygon
733
734 if( aTextBox->GetShape() == SHAPE_T::RECTANGLE )
735 {
736 addShape( static_cast<const PCB_SHAPE*>( aTextBox ), aContainer, aOwner );
737 }
738 else
739 {
740 SHAPE_POLY_SET polyList;
741
742 aTextBox->PCB_SHAPE::TransformShapeToPolygon( polyList, UNDEFINED_LAYER, 0,
744
745 ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner );
746 }
747}
748
749
750void BOARD_ADAPTER::addTable( const PCB_TABLE* aTable, CONTAINER_2D_BASE* aContainer,
751 const BOARD_ITEM* aOwner )
752{
753 // JEY TODO: tables
754 // add borders
755
756 for( PCB_TABLECELL* cell : aTable->GetCells() )
757 addText( cell, aContainer, aOwner );
758}
759
760
762 PCB_LAYER_ID aLayerId )
763{
764 // This convert the poly in outline and holes
765 ConvertPolygonToTriangles( *aZone->GetFilledPolysList( aLayerId ), *aContainer, m_biuTo3Dunits,
766 *aZone );
767}
768
769
771 int aWidth )
772{
773 if( aPad->GetShape() == PAD_SHAPE::CIRCLE ) // Draw a ring
774 {
775 const SFVEC2F center3DU = TO_SFVEC2F( aPad->ShapePos() );
776 const int radius = aPad->GetSize().x / 2;
777 const float inner_radius3DU = TO_3DU( radius - aWidth / 2.0 );
778 const float outer_radius3DU = TO_3DU( radius + aWidth / 2.0 );
779
780 addRING_2D( aContainer, center3DU, inner_radius3DU, outer_radius3DU, *aPad );
781 }
782 else
783 {
784 // For other shapes, add outlines as thick segments in polygon buffer
785 const std::shared_ptr<SHAPE_POLY_SET>& corners = aPad->GetEffectivePolygon( ERROR_INSIDE );
786 const SHAPE_LINE_CHAIN& path = corners->COutline( 0 );
787
788 for( int j = 0; j < path.PointCount(); j++ )
789 {
790 SFVEC2F start3DU = TO_SFVEC2F( path.CPoint( j ) );
791 SFVEC2F end3DU = TO_SFVEC2F( path.CPoint( j + 1 ) );
792
793 addROUND_SEGMENT_2D( aContainer, start3DU, end3DU, TO_3DU( aWidth ), *aPad );
794 }
795 }
796}
constexpr int ARC_HIGH_DEF
Definition: base_units.h:121
void addSolidAreasShapes(const ZONE *aZone, CONTAINER_2D_BASE *aDstContainer, PCB_LAYER_ID aLayerId)
void addFootprintShapes(const FOOTPRINT *aFootprint, CONTAINER_2D_BASE *aDstContainer, PCB_LAYER_ID aLayerId, const std::bitset< LAYER_3D_END > &aVisibilityFlags)
void createArcSegments(const VECTOR2I &aCentre, const VECTOR2I &aStart, const EDA_ANGLE &aArcAngle, int aCircleToSegmentsCount, int aWidth, CONTAINER_2D_BASE *aContainer, const BOARD_ITEM &aOwner)
void createPadWithMargin(const PAD *aPad, CONTAINER_2D_BASE *aDstContainer, PCB_LAYER_ID aLayer, const VECTOR2I &aMargin) const
void addPads(const FOOTPRINT *aFootprint, CONTAINER_2D_BASE *aDstContainer, PCB_LAYER_ID aLayerId, bool aSkipPlatedPads, bool aSkipNonPlatedPads)
const BOARD * GetBoard() const noexcept
void createPadWithHole(const PAD *aPad, CONTAINER_2D_BASE *aDstContainer, int aInflateValue)
void buildPadOutlineAsSegments(const PAD *aPad, CONTAINER_2D_BASE *aDstContainer, int aWidth)
void addShape(const PCB_SHAPE *aShape, CONTAINER_2D_BASE *aContainer, const BOARD_ITEM *aOwner)
void createTrack(const PCB_TRACK *aTrack, CONTAINER_2D_BASE *aDstContainer)
void addTable(const PCB_TABLE *aTable, CONTAINER_2D_BASE *aContainer, const BOARD_ITEM *aOwner)
unsigned int GetCircleSegmentCount(float aDiameter3DU) const
void createViaWithMargin(const PCB_TRACK *aTrack, CONTAINER_2D_BASE *aDstContainer, int aMargin)
double m_biuTo3Dunits
Scale factor to convert board internal units to 3D units normalized between -1.0 and 1....
void addText(const EDA_TEXT *aText, CONTAINER_2D_BASE *aDstContainer, const BOARD_ITEM *aOwner)
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:77
virtual PCB_LAYER_ID GetLayer() const
Return the primary layer this item is on.
Definition: board_item.h:226
virtual bool IsKnockout() const
Definition: board_item.h:296
virtual void SetLayer(PCB_LAYER_ID aLayer)
Set the layer this item is on.
Definition: board_item.h:260
virtual const BOARD * GetBoard() const
Return the BOARD in which this BOARD_ITEM resides, or NULL if none.
Definition: board_item.cpp:46
const KIFONT::METRICS & GetFontMetrics() const
Definition: board_item.cpp:97
BOARD_ITEM_CONTAINER * GetParent() const
Definition: board_item.h:204
const PCB_PLOT_PARAMS & GetPlotOptions() const
Definition: board.h:653
BOARD_DESIGN_SETTINGS & GetDesignSettings() const
Definition: board.cpp:769
int GetSizeMax() const
Definition: box2.h:201
void Add(OBJECT_2D *aObject)
Definition: container_2d.h:49
double AsDegrees() const
Definition: eda_angle.h:155
bool IsZero() const
Definition: eda_angle.h:175
KICAD_T Type() const
Returns the type of object.
Definition: eda_item.h:97
EDA_ANGLE GetArcAngle() const
Definition: eda_shape.cpp:656
virtual std::vector< SHAPE * > MakeEffectiveShapes(bool aEdgeOnly=false) const
Make a set of SHAPE objects representing the EDA_SHAPE.
Definition: eda_shape.h:305
bool IsFilled() const
Definition: eda_shape.h:90
int GetRadius() const
Definition: eda_shape.cpp:586
SHAPE_T GetShape() const
Definition: eda_shape.h:119
const VECTOR2I & GetEnd() const
Return the ending point of the graphic.
Definition: eda_shape.h:151
const VECTOR2I & GetStart() const
Return the starting point of the graphic.
Definition: eda_shape.h:126
std::vector< VECTOR2I > GetRectCorners() const
Definition: eda_shape.cpp:1132
wxString SHAPE_T_asString() const
Definition: eda_shape.cpp:87
A mix-in class (via multiple inheritance) that handles texts such as labels, parts,...
Definition: eda_text.h:80
bool IsItalic() const
Definition: eda_text.h:141
KIFONT::FONT * GetFont() const
Definition: eda_text.h:208
virtual EDA_ANGLE GetDrawRotation() const
Definition: eda_text.h:338
virtual VECTOR2I GetDrawPos() const
Definition: eda_text.h:339
const TEXT_ATTRIBUTES & GetAttributes() const
Definition: eda_text.h:192
int GetEffectiveTextPenWidth(int aDefaultPenWidth=0) const
The EffectiveTextPenWidth uses the text thickness if > 1 or aDefaultPenWidth.
Definition: eda_text.cpp:324
bool IsBold() const
Definition: eda_text.h:145
virtual wxString GetShownText(bool aAllowExtraText, int aDepth=0) const
Return the string actually shown after processing of the base text.
Definition: eda_text.h:106
PADS & Pads()
Definition: footprint.h:188
void GetFields(std::vector< PCB_FIELD * > &aVector, bool aVisibleOnly)
Populate a std::vector with PCB_TEXTs.
Definition: footprint.cpp:317
DRAWINGS & GraphicalItems()
Definition: footprint.h:191
FONT is an abstract base class for both outline and stroke fonts.
Definition: font.h:131
static FONT * GetFont(const wxString &aFontName=wxEmptyString, bool aBold=false, bool aItalic=false)
Definition: font.cpp:146
void Draw(KIGFX::GAL *aGal, const wxString &aText, const VECTOR2I &aPosition, const VECTOR2I &aCursor, const TEXT_ATTRIBUTES &aAttributes, const METRICS &aFontMetrics) const
Draw a string.
Definition: font.cpp:257
PCB specific render settings.
Definition: pcb_painter.h:77
void SetGapLengthRatio(double aRatio)
void SetDashLengthRatio(double aRatio)
Definition: pad.h:59
VECTOR2I ShapePos() const
Definition: pad.cpp:757
const std::shared_ptr< SHAPE_POLY_SET > & GetEffectivePolygon(ERROR_LOC aErrorLoc=ERROR_INSIDE) const
Definition: pad.cpp:355
PAD_SHAPE GetShape() const
Definition: pad.h:190
virtual std::shared_ptr< SHAPE > GetEffectiveShape(PCB_LAYER_ID aLayer=UNDEFINED_LAYER, FLASHING flashPTHPads=FLASHING::DEFAULT) const override
Some pad shapes can be complex (rounded/chamfered rectangle), even without considering custom shapes.
Definition: pad.cpp:364
bool HasHole() const override
Definition: pad.h:106
std::shared_ptr< SHAPE_SEGMENT > GetEffectiveHoleShape() const override
Return a SHAPE_SEGMENT object representing the pad's hole.
Definition: pad.cpp:401
const VECTOR2I & GetSize() const
Definition: pad.h:244
bool IsDegenerated(int aThreshold=5) const
Definition: pcb_track.cpp:1363
double GetRadius() const
Definition: pcb_track.cpp:1332
EDA_ANGLE GetAngle() const
Definition: pcb_track.cpp:1339
virtual VECTOR2I GetCenter() const override
This defaults to the center of the bounding box if not overridden.
Definition: pcb_track.h:318
Abstract dimension API.
int GetLineThickness() const
const std::vector< std::shared_ptr< SHAPE > > & GetShapes() const
Parameters and options when plotting/printing a board.
double GetDashedLineGapRatio() const
double GetDashedLineDashRatio() const
const BOX2I GetBoundingBox() const override
Return the orthogonal bounding box of this object for display purposes.
Definition: pcb_shape.h:112
VECTOR2I GetCenter() const override
This defaults to the center of the bounding box if not overridden.
Definition: pcb_shape.h:72
int GetWidth() const override
Definition: pcb_shape.cpp:149
void TransformShapeToPolygon(SHAPE_POLY_SET &aBuffer, PCB_LAYER_ID aLayer, int aClearance, int aError, ERROR_LOC aErrorLoc, bool ignoreLineWidth=false) const override
Convert the shape to a closed polygon.
Definition: pcb_shape.cpp:568
STROKE_PARAMS GetStroke() const override
Definition: pcb_shape.h:82
PCB_LAYER_ID GetLayer() const override
Return the primary layer this item is on.
Definition: pcb_shape.h:67
std::vector< PCB_TABLECELL * > GetCells() const
Definition: pcb_table.h:137
bool IsBorderEnabled() const
Disables the border, this is done by changing the stroke internally.
void TransformTextToPolySet(SHAPE_POLY_SET &aBuffer, int aClearance, int aMaxError, ERROR_LOC aErrorLoc) const
Function TransformTextToPolySet Convert the text to a polygonSet describing the actual character stro...
Definition: pcb_text.cpp:460
void SetWidth(int aWidth)
Definition: pcb_track.h:106
int GetWidth() const
Definition: pcb_track.h:107
void SetEnd(const VECTOR2I &aEnd)
Definition: pcb_track.h:109
void SetStart(const VECTOR2I &aStart)
Definition: pcb_track.h:112
const VECTOR2I & GetStart() const
Definition: pcb_track.h:113
const VECTOR2I & GetEnd() const
Definition: pcb_track.h:110
Definition: seg.h:42
VECTOR2I A
Definition: seg.h:49
VECTOR2I B
Definition: seg.h:50
int GetWidth() const
Definition: shape_arc.h:159
const SHAPE_LINE_CHAIN ConvertToPolyline(double aAccuracy=DefaultAccuracyForPCB(), double *aEffectiveAccuracy=nullptr) const
Construct a SHAPE_LINE_CHAIN of segments from a given arc.
Definition: shape_arc.cpp:497
int GetRadius() const
Definition: shape_circle.h:108
const VECTOR2I GetCenter() const
Definition: shape_circle.h:113
Represent a polyline containing arcs as well as line segments: A chain of connected line and/or arc s...
SEG Segment(int aIndex) const
Return a copy of the aIndex-th segment in the line chain.
int SegmentCount() const
Return the number of segments in this line chain.
Represent a set of closed polygons.
int AddOutline(const SHAPE_LINE_CHAIN &aOutline)
Adds a new outline to the set and returns its index.
bool IsEmpty() const
Return true if the set is empty (no polygons at all)
void Inflate(int aAmount, CORNER_STRATEGY aCornerStrategy, int aMaxError, bool aSimplify=false)
Perform outline inflation/deflation.
int Append(int x, int y, int aOutline=-1, int aHole=-1, bool aAllowDuplication=false)
Appends a vertex at the end of the given outline/hole (default: the last outline)
void Simplify(POLYGON_MODE aFastMode)
Simplify the polyset (merges overlapping polys, eliminates degeneracy/self-intersections) For aFastMo...
int NewOutline()
Creates a new empty polygon in the set and returns its index.
const VECTOR2I & GetPosition() const
Definition: shape_rect.h:127
const VECTOR2I GetSize() const
Definition: shape_rect.h:135
const SEG & GetSeg() const
int GetWidth() const
Represent a simple polygon consisting of a zero-thickness closed chain of connected line segments.
Definition: shape_simple.h:42
const SHAPE_LINE_CHAIN & Vertices() const
Return the list of vertices defining this simple polygon.
Definition: shape_simple.h:124
An abstract shape on 2D plane.
Definition: shape.h:126
static void Stroke(const SHAPE *aShape, LINE_STYLE aLineStyle, int aWidth, const KIGFX::RENDER_SETTINGS *aRenderSettings, std::function< void(const VECTOR2I &a, const VECTOR2I &b)> aStroker)
LINE_STYLE GetLineStyle() const
Definition: stroke_params.h:94
Handle a list of polygons defining a copper zone.
Definition: zone.h:72
const std::shared_ptr< SHAPE_POLY_SET > & GetFilledPolysList(PCB_LAYER_ID aLayer) const
Definition: zone.h:615
#define TO_3DU(x)
void addFILLED_CIRCLE_2D(CONTAINER_2D_BASE *aContainer, const SFVEC2F &aCenter, float aRadius, const BOARD_ITEM &aBoardItem)
#define TO_SFVEC2F(vec)
void addROUND_SEGMENT_2D(CONTAINER_2D_BASE *aContainer, const SFVEC2F &aStart, const SFVEC2F &aEnd, float aWidth, const BOARD_ITEM &aBoardItem)
void addRING_2D(CONTAINER_2D_BASE *aContainer, const SFVEC2F &aCenter, float aInnerRadius, float aOuterRadius, const BOARD_ITEM &aBoardItem)
static constexpr EDA_ANGLE ANGLE_0
Definition: eda_angle.h:435
static constexpr EDA_ANGLE ANGLE_360
Definition: eda_angle.h:441
a few functions useful in geometry calculations.
@ ERROR_INSIDE
int GetArcToSegmentCount(int aRadius, int aErrorMax, const EDA_ANGLE &aArcAngle)
static const wxChar * m_logTrace
Trace mask used to enable or disable debug output for this class.
bool IsCopperLayer(int aLayerId)
Tests whether a layer is a copper layer.
Definition: layer_ids.h:879
@ LAYER_FP_REFERENCES
show footprints references (when texts are visible)
Definition: layer_ids.h:214
@ LAYER_FP_TEXT
Definition: layer_ids.h:201
@ LAYER_FP_VALUES
show footprints values (when texts are visible)
Definition: layer_ids.h:213
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
@ F_Paste
Definition: layer_ids.h:102
@ B_Mask
Definition: layer_ids.h:107
@ B_Cu
Definition: layer_ids.h:96
@ F_Mask
Definition: layer_ids.h:108
@ B_Paste
Definition: layer_ids.h:101
@ UNDEFINED_LAYER
Definition: layer_ids.h:61
@ F_Cu
Definition: layer_ids.h:65
This file contains miscellaneous commonly used macros and functions.
#define UNIMPLEMENTED_FOR(type)
Definition: macros.h:96
T clamp(T min, T value, T max)
Definition: kicad_algo.h:205
EDA_ANGLE abs(const EDA_ANGLE &aAngle)
Definition: eda_angle.h:424
bool Is_segment_a_circle(const SFVEC2F &aStart, const SFVEC2F &aEnd)
Check if segment start and end is very close to each other.
@ SH_POLY_SET
set of polygons (with holes, etc.)
Definition: shape.h:52
@ SH_RECT
axis-aligned rectangle
Definition: shape.h:47
@ SH_CIRCLE
circle
Definition: shape.h:50
@ SH_SIMPLE
simple polygon
Definition: shape.h:51
@ SH_SEGMENT
line segment
Definition: shape.h:48
@ SH_ARC
circular arc
Definition: shape.h:54
static wxString SHAPE_TYPE_asString(SHAPE_TYPE a)
Definition: shape.h:59
std::vector< FAB_LAYER_COLOR > dummy
LINE_STYLE
Dashed line types.
Definition: stroke_params.h:48
constexpr int delta
void ConvertPolygonToTriangles(const SHAPE_POLY_SET &aPolyList, CONTAINER_2D_BASE &aDstContainer, float aBiuTo3dUnitsScale, const BOARD_ITEM &aBoardItem)
void RotatePoint(int *pX, int *pY, const EDA_ANGLE &aAngle)
Calculate the new point of coord coord pX, pY, for a rotation center 0, 0.
Definition: trigo.cpp:228
@ PCB_SHAPE_T
class PCB_SHAPE, a segment not on copper layers
Definition: typeinfo.h:88
@ PCB_DIM_ORTHOGONAL_T
class PCB_DIM_ORTHOGONAL, a linear dimension constrained to x/y
Definition: typeinfo.h:105
@ PCB_DIM_LEADER_T
class PCB_DIM_LEADER, a leader dimension (graphic item)
Definition: typeinfo.h:102
@ PCB_VIA_T
class PCB_VIA, a via (like a track segment on a copper layer)
Definition: typeinfo.h:97
@ PCB_DIM_CENTER_T
class PCB_DIM_CENTER, a center point marking (graphic item)
Definition: typeinfo.h:103
@ PCB_TEXTBOX_T
class PCB_TEXTBOX, wrapped text on a layer
Definition: typeinfo.h:93
@ PCB_TEXT_T
class PCB_TEXT, text on a layer
Definition: typeinfo.h:92
@ PCB_DIM_ALIGNED_T
class PCB_DIM_ALIGNED, a linear dimension (graphic item)
Definition: typeinfo.h:101
@ PCB_ARC_T
class PCB_ARC, an arc track segment on a copper layer
Definition: typeinfo.h:98
@ PCB_TABLE_T
class PCB_TABLE, table of PCB_TABLECELLs
Definition: typeinfo.h:94
@ PCB_TRACE_T
class PCB_TRACK, a track segment (segment on a copper layer)
Definition: typeinfo.h:96
@ PCB_DIM_RADIAL_T
class PCB_DIM_RADIAL, a radius or diameter dimension
Definition: typeinfo.h:104
constexpr ret_type KiROUND(fp_type v)
Round a floating point number to an integer using "round halfway cases away from zero".
Definition: util.h:85
VECTOR2< int > VECTOR2I
Definition: vector2d.h:588
glm::vec2 SFVEC2F
Definition: xv3d_types.h:42