create_3Dgraphic_brd_items.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2015-2016 Mario Luzeiro <[email protected]>
 * Copyright (C) 2023 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

 
#include "../3d_rendering/raytracing/shapes2D/ring_2d.h"
#include "../3d_rendering/raytracing/shapes2D/filled_circle_2d.h"
#include "../3d_rendering/raytracing/shapes2D/round_segment_2d.h"
#include "../3d_rendering/raytracing/shapes2D/triangle_2d.h"
#include <board_adapter.h>
#include <board.h>
#include <footprint.h>
#include <pad.h>
#include <pcb_text.h>
#include <pcb_textbox.h>
#include <pcb_table.h>
#include <pcb_track.h>
#include <pcb_painter.h>        // for PCB_RENDER_SETTINGS
#include <zone.h>
#include <convert_basic_shapes_to_polygon.h>
#include <trigo.h>
#include <geometry/shape_segment.h>
#include <geometry/geometry_utils.h>
#include <geometry/shape_circle.h>
#include <geometry/roundrect.h>
#include <geometry/shape_rect.h>
#include <geometry/shape_simple.h>
#include <geometry/shape_ellipse.h>
#include <bezier_curves.h>
#include <utility>
#include <vector>
#include <wx/log.h>
#include <macros.h>
#include <callback_gal.h>
#include <line_ending.h>
#include <pcb_barcode.h>
 
 
#define TO_3DU( x ) ( ( x ) * m_biuTo3Dunits )
 
#define TO_SFVEC2F( vec ) SFVEC2F( TO_3DU( vec.x ), TO_3DU( -vec.y ) )
 
 
void addFILLED_CIRCLE_2D( CONTAINER_2D_BASE* aContainer, const SFVEC2F& aCenter, float aRadius,
                          const BOARD_ITEM& aBoardItem )
{
    if( aRadius > 0.0f )
        aContainer->Add( new FILLED_CIRCLE_2D( aCenter, aRadius, aBoardItem ) );
}
 
 
void addRING_2D( CONTAINER_2D_BASE* aContainer, const SFVEC2F& aCenter, float aInnerRadius,
                 float aOuterRadius, const BOARD_ITEM& aBoardItem )
{
    if( aOuterRadius > aInnerRadius && aInnerRadius > 0.0f )
        aContainer->Add( new RING_2D( aCenter, aInnerRadius, aOuterRadius, aBoardItem ) );
}
 
 
void addROUND_SEGMENT_2D( CONTAINER_2D_BASE* aContainer, const SFVEC2F& aStart, const SFVEC2F& aEnd,
                          float aWidth, const BOARD_ITEM& aBoardItem )
{
    if( Is_segment_a_circle( aStart, aEnd ) )
    {
        // Cannot add segments that have the same start and end point
        addFILLED_CIRCLE_2D( aContainer, aStart, aWidth / 2, aBoardItem );
        return;
    }
 
    if( aWidth > 0.0f )
        aContainer->Add( new ROUND_SEGMENT_2D( aStart, aEnd, aWidth, aBoardItem ) );
}
 
 
void BOARD_ADAPTER::addText( const EDA_TEXT* aText, CONTAINER_2D_BASE* aContainer, const BOARD_ITEM* aOwner )
{
    KIGFX::GAL_DISPLAY_OPTIONS empty_opts;
    TEXT_ATTRIBUTES            attrs = aText->GetAttributes();
    float                      penWidth_3DU = TO_3DU( aText->GetEffectiveTextPenWidth() );
    KIFONT::FONT*              font = aText->GetFont();
    wxString                   shownText = aText->GetShownText( FOR_CANVAS );
 
    if( !font )
        font = KIFONT::FONT::GetFont( wxEmptyString, aText->IsBold(), aText->IsItalic() );
 
    if( aOwner && aOwner->IsKnockout() )
    {
        SHAPE_POLY_SET finalPoly;
 
        if( const PCB_TEXTBOX* pcbTextBox = dynamic_cast<const PCB_TEXTBOX*>( aOwner ) )
            pcbTextBox->TransformTextToPolySet( finalPoly, 0, aOwner->GetMaxError(), ERROR_INSIDE );
        else if( const PCB_TEXT* pcbText = dynamic_cast<const PCB_TEXT*>( aOwner ) )
            pcbText->TransformTextToPolySet( finalPoly, 0, aOwner->GetMaxError(), ERROR_INSIDE );
 
        // Do not call finalPoly.Fracture() here: ConvertPolygonToTriangles() call it
        // if needed, and Fracture() called twice can create bad results and is useless
        ConvertPolygonToTriangles( finalPoly, *aContainer, m_biuTo3Dunits, *aOwner );
    }
    else
    {
        CALLBACK_GAL callback_gal( empty_opts,
                // Stroke callback
                [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2 )
                {
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( aPt1 ), TO_SFVEC2F( aPt2 ),
                                         penWidth_3DU, *aOwner );
                },
                // Triangulation callback
                [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2, const VECTOR2I& aPt3 )
                {
                    aContainer->Add( new TRIANGLE_2D( TO_SFVEC2F( aPt1 ), TO_SFVEC2F( aPt2 ),
                                                      TO_SFVEC2F( aPt3 ), *aOwner ) );
                } );
 
        attrs.m_Angle = aText->GetDrawRotation();
 
        if( auto* cache = aText->GetRenderCache( font, shownText ) )
        {
            callback_gal.DrawGlyphs( *cache );
        }
        else
        {
            font->Draw( &callback_gal, shownText, aText->GetDrawPos(), attrs,
                        aOwner->GetFontMetrics() );
        }
    }
}
 
 
void BOARD_ADAPTER::addBarCode( const PCB_BARCODE* aBarCode, CONTAINER_2D_BASE* aDstContainer,
                                const BOARD_ITEM* aOwner )
{
    SHAPE_POLY_SET shape;
    aBarCode->TransformShapeToPolySet( shape, aBarCode->GetLayer(), 0, 0, ERROR_INSIDE );
    shape.Simplify();
 
    ConvertPolygonToTriangles( shape, *aDstContainer, m_biuTo3Dunits, *aOwner );
}
 
 
void BOARD_ADAPTER::addShape( const PCB_DIMENSION_BASE* aDimension, CONTAINER_2D_BASE* aContainer,
                              const BOARD_ITEM* aOwner )
{
    addText( aDimension, aContainer, aDimension );
 
    const int linewidth = aDimension->GetLineThickness();
 
    for( const std::shared_ptr<SHAPE>& shape : aDimension->GetShapes() )
    {
        switch( shape->Type() )
        {
        case SH_SEGMENT:
        {
            const SEG& seg = static_cast<const SHAPE_SEGMENT*>( shape.get() )->GetSeg();
 
            addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( seg.A ), TO_SFVEC2F( seg.B ),
                                 TO_3DU( linewidth ), *aOwner );
            break;
        }
 
        case SH_CIRCLE:
        {
            int radius = static_cast<const SHAPE_CIRCLE*>( shape.get() )->GetRadius();
            float innerR3DU = TO_3DU( radius ) - TO_3DU( aDimension->GetLineThickness() ) / 2.0f;
            float outerR3DU = TO_3DU( radius ) + TO_3DU( aDimension->GetLineThickness() ) / 2.0f;
 
            addRING_2D( aContainer, TO_SFVEC2F( shape->Centre() ), innerR3DU, outerR3DU, *aOwner );
 
            break;
        }
 
        default:
            break;
        }
    }
}
 
 
void BOARD_ADAPTER::addFootprintShapes( const FOOTPRINT* aFootprint, CONTAINER_2D_BASE* aContainer,
                                        PCB_LAYER_ID aLayerId,
                                        const std::bitset<LAYER_3D_END>& aFlags )
{
    KIGFX::GAL_DISPLAY_OPTIONS empty_opts;
 
    for( PCB_FIELD* field : aFootprint->GetFields() )
    {
        if( !aFlags.test( LAYER_FP_TEXT ) )
            continue;
 
        wxCHECK2( field, continue );
 
        if( field->IsReference() && !aFlags.test( LAYER_FP_REFERENCES ) )
            continue;
 
        if( field->IsValue() && !aFlags.test( LAYER_FP_VALUES ) )
            continue;
 
        if( field->GetLayer() == aLayerId && field->IsVisible() )
            addText( field, aContainer, field );
    }
 
    for( BOARD_ITEM* item : aFootprint->GraphicalItems() )
    {
        switch( item->Type() )
        {
        case PCB_TEXT_T:
        {
            PCB_TEXT* text = static_cast<PCB_TEXT*>( item );
 
            if( !aFlags.test( LAYER_FP_TEXT ) )
                continue;
 
            if( text->GetText() == wxT( "${REFERENCE}" ) && !aFlags.test( LAYER_FP_REFERENCES ) )
                continue;
 
            if( text->GetText() == wxT( "${VALUE}" ) && !aFlags.test( LAYER_FP_VALUES ) )
                continue;
 
            if( text->GetLayer() == aLayerId )
                addText( text, aContainer, text );
 
            break;
        }
 
        case PCB_TEXTBOX_T:
        {
            PCB_TEXTBOX* textbox = static_cast<PCB_TEXTBOX*>( item );
 
            if( textbox->GetLayer() == aLayerId )
                addShape( textbox, aContainer, textbox );
 
            break;
        }
 
        case PCB_TABLE_T:
        {
            PCB_TABLE* table = static_cast<PCB_TABLE*>( item );
 
            if( table->GetLayer() == aLayerId )
                addTable( table, aContainer, aFootprint );
 
            break;
        }
 
        case PCB_DIM_ALIGNED_T:
        case PCB_DIM_CENTER_T:
        case PCB_DIM_ORTHOGONAL_T:
        case PCB_DIM_RADIAL_T:
        case PCB_DIM_LEADER_T:
        {
            PCB_DIMENSION_BASE* dimension = static_cast<PCB_DIMENSION_BASE*>( item );
 
            if( dimension->GetLayer() == aLayerId )
                addShape( dimension, aContainer, aFootprint );
 
            break;
        }
 
        case PCB_SHAPE_T:
        {
            PCB_SHAPE* shape = static_cast<PCB_SHAPE*>( item );
 
            if( shape->IsOnLayer( aLayerId ) )
                addShape( shape, aContainer, aFootprint, aLayerId );
 
            break;
        }
 
        case PCB_BARCODE_T:
        {
            PCB_BARCODE* barcode = static_cast<PCB_BARCODE*>( item );
 
            if( barcode->GetLayer() == aLayerId )
                addBarCode( barcode, aContainer, aFootprint );
 
            break;
        }
 
        default:
            break;
        }
    }
}
 
 
void BOARD_ADAPTER::createTrackWithMargin( const PCB_TRACK* aTrack, CONTAINER_2D_BASE* aDstContainer,
                                           PCB_LAYER_ID aLayer, int aMargin )
{
    SFVEC2F start3DU = TO_SFVEC2F( aTrack->GetStart() );
    SFVEC2F end3DU = TO_SFVEC2F( aTrack->GetEnd() );
 
    switch( aTrack->Type() )
    {
    case PCB_VIA_T:
    {
        const PCB_VIA* via = static_cast<const PCB_VIA*>( aTrack );
        float          width3DU = TO_3DU( via->GetWidth( aLayer ) + aMargin * 2 );
 
        addFILLED_CIRCLE_2D( aDstContainer, start3DU, width3DU / 2.0, *aTrack );
        break;
    }
 
    case PCB_ARC_T:
    {
        const PCB_ARC* arc = static_cast<const PCB_ARC*>( aTrack );
 
        if( arc->IsDegenerated() )
        {
            // Draw this very small arc like a track segment (a PCB_TRACE_T)
            PCB_TRACK track( arc->GetParent() );
            track.SetStart( arc->GetStart() );
            track.SetEnd( arc->GetEnd() );
            track.SetWidth( arc->GetWidth() );
            track.SetLayer( arc->GetLayer() );
 
            createTrackWithMargin( &track, aDstContainer, aLayer, aMargin );
            return;
        }
 
        VECTOR2I  center( arc->GetCenter() );
        EDA_ANGLE arc_angle = arc->GetAngle();
        double    radius = arc->GetRadius();
        int       arcsegcount = GetArcToSegmentCount( KiROUND( radius ), arc->GetMaxError(), arc_angle );
        int       circlesegcount;
 
        // Avoid arcs that cannot be drawn
        if( radius < std::numeric_limits<double>::min() || arc_angle.IsZero() )
            break;
 
        // We need a circle to segment count. However, the arc angle can be small, and the
        // radius very big. so we calculate a reasonable value for circlesegcount.
        if( arcsegcount <= 1 )  // The arc will be approximated by a segment
        {
            circlesegcount = 1;
        }
        else
        {
            circlesegcount = KiROUND( arcsegcount * 360.0 / std::abs( arc_angle.AsDegrees() ) );
            circlesegcount = std::clamp( circlesegcount, 1, 128 );
        }
 
        createArcSegments( center, arc->GetStart(), arc_angle, circlesegcount,
                           arc->GetWidth() + aMargin * 2, aDstContainer, *arc );
        break;
    }
 
    case PCB_TRACE_T:    // Track is a usual straight segment
    {
        float width3DU = TO_3DU( aTrack->GetWidth() + aMargin * 2 );
        addROUND_SEGMENT_2D( aDstContainer, start3DU, end3DU, width3DU, *aTrack );
        break;
    }
 
    default:
        break;
    }
}
 
 
void BOARD_ADAPTER::createPadWithMargin( const PAD* aPad, CONTAINER_2D_BASE* aContainer,
                                         PCB_LAYER_ID aLayer, const VECTOR2I& aMargin ) const
{
    SHAPE_POLY_SET poly;
    VECTOR2I       clearance = aMargin;
 
    // Our shape-based builder can't handle negative or differing x:y clearance values (the
    // former are common for solder paste while the later get generated when a relative paste
    // margin is used with an oblong pad).  So we apply this huge hack and fake a larger pad to
    // run the general-purpose polygon builder on.
    // Of course being a hack it falls down when dealing with custom shape pads (where the size
    // is only the size of the anchor), so for those we punt and just use aMargin.x.
 
    if( ( clearance.x < 0 || clearance.x != clearance.y ) && aPad->GetShape( aLayer ) != PAD_SHAPE::CUSTOM )
    {
        VECTOR2I dummySize = VECTOR2I( aPad->GetSize( aLayer ) ) + clearance + clearance;
 
        if( dummySize.x <= 0 || dummySize.y <= 0 )
            return;
 
        PAD dummy( *aPad );
        dummy.SetSize( aLayer, VECTOR2I( dummySize.x, dummySize.y ) );
        dummy.TransformShapeToPolygon( poly, aLayer, 0, aPad->GetMaxError(), ERROR_INSIDE );
        clearance = { 0, 0 };
    }
    else if( aPad->GetShape( aLayer ) == PAD_SHAPE::CUSTOM )
    {
        // A custom pad can have many complex subshape items. To avoid issues, use its
        // final polygon shape, not its basic shape set. One cannot apply the clearance
        // to each subshape: it does no work
        aPad->TransformShapeToPolygon( poly, aLayer, 0, aPad->GetMaxError() );
    }
    else
    {
        auto padShapes = std::static_pointer_cast<SHAPE_COMPOUND>( aPad->GetEffectiveShape( aLayer ) );
 
        for( const SHAPE* shape : padShapes->Shapes() )
        {
            switch( shape->Type() )
            {
            case SH_SEGMENT:
            {
                const SHAPE_SEGMENT* seg = static_cast<const SHAPE_SEGMENT*>( shape );
 
                addROUND_SEGMENT_2D( aContainer,
                                     TO_SFVEC2F( seg->GetSeg().A ),
                                     TO_SFVEC2F( seg->GetSeg().B ),
                                     TO_3DU( seg->GetWidth() + clearance.x * 2 ),
                                     *aPad );
                break;
            }
 
            case SH_CIRCLE:
            {
                const SHAPE_CIRCLE* circle = static_cast<const SHAPE_CIRCLE*>( shape );
 
                addFILLED_CIRCLE_2D( aContainer,
                                     TO_SFVEC2F( circle->GetCenter() ),
                                     TO_3DU( circle->GetRadius() + clearance.x ),
                                     *aPad );
                break;
            }
 
            case SH_RECT:
            {
                const SHAPE_RECT* rect = static_cast<const SHAPE_RECT*>( shape );
 
                poly.NewOutline();
                poly.Append( rect->GetPosition() );
                poly.Append( rect->GetPosition().x + rect->GetSize().x, rect->GetPosition().y );
                poly.Append( rect->GetPosition() + rect->GetSize() );
                poly.Append( rect->GetPosition().x, rect->GetPosition().y + rect->GetSize().y );
                break;
            }
 
            case SH_SIMPLE:
                poly.AddOutline( static_cast<const SHAPE_SIMPLE*>( shape )->Vertices() );
                break;
 
            case SH_POLY_SET:
                poly.Append( *static_cast<const SHAPE_POLY_SET*>( shape ) );
                break;
 
            case SH_ARC:
            {
                const SHAPE_ARC* arc = static_cast<const SHAPE_ARC*>( shape );
                SHAPE_LINE_CHAIN l = arc->ConvertToPolyline( aPad->GetMaxError() );
 
                for( int i = 0; i < l.SegmentCount(); i++ )
                {
                    SHAPE_SEGMENT seg( l.Segment( i ).A, l.Segment( i ).B, arc->GetWidth() );
 
                    addROUND_SEGMENT_2D( aContainer,
                                         TO_SFVEC2F( seg.GetSeg().A ),
                                         TO_SFVEC2F( seg.GetSeg().B ),
                                         TO_3DU( arc->GetWidth() + clearance.x * 2 ),
                                         *aPad );
                }
 
                break;
            }
 
            case SH_ELLIPSE:
            {
                const SHAPE_ELLIPSE* ellipse = static_cast<const SHAPE_ELLIPSE*>( shape );
                SHAPE_LINE_CHAIN     l = ellipse->ConvertToPolyline( aPad->GetMaxError() );
                const int            width = ellipse->GetWidth();
 
                for( int i = 0; i < l.SegmentCount(); i++ )
                {
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( l.Segment( i ).A ), TO_SFVEC2F( l.Segment( i ).B ),
                                         TO_3DU( width + clearance.x * 2 ), *aPad );
                }
 
                break;
            }
 
            default:
                UNIMPLEMENTED_FOR( SHAPE_TYPE_asString( shape->Type() ) );
                break;
            }
        }
    }
 
    if( !poly.IsEmpty() )
    {
        if( clearance.x )
            poly.Inflate( clearance.x, CORNER_STRATEGY::ROUND_ALL_CORNERS, aPad->GetMaxError() );
 
        // Add the PAD polygon
        ConvertPolygonToTriangles( poly, *aContainer, m_biuTo3Dunits, *aPad );
    }
}
 
 
void BOARD_ADAPTER::createPadHoleShape( const PAD* aPad, CONTAINER_2D_BASE* aDstContainer,
                                        int aInflateValue )
{
    if( !aPad->HasHole() )
    {
        wxLogTrace( m_logTrace, wxT( "BOARD_ADAPTER::createPadHole pad has no hole" ) );
        return;
    }
 
    std::shared_ptr<SHAPE_SEGMENT> slot = aPad->GetEffectiveHoleShape();
 
    addROUND_SEGMENT_2D( aDstContainer,
                         TO_SFVEC2F( slot->GetSeg().A ),
                         TO_SFVEC2F( slot->GetSeg().B ),
                         TO_3DU( slot->GetWidth() + aInflateValue * 2 ),
                         *aPad );
}
 
 
void BOARD_ADAPTER::addPads( const FOOTPRINT* aFootprint, CONTAINER_2D_BASE* aContainer,
                             PCB_LAYER_ID aLayerId )
{
    for( PAD* pad : aFootprint->Pads() )
    {
        if( !pad->IsOnLayer( aLayerId ) )
            continue;
 
        if( IsCopperLayer( aLayerId ) )
        {
            // Skip pad annulus when there isn't one (note: this is more discerning than
            // pad->IsOnLayer(), which doesn't check for NPTH pads with holes that consume
            // the entire pad).
            if( !pad->IsOnCopperLayer() )
                continue;
 
            // Skip pad annulus when not connected on this layer (if removing is enabled)
            if( !pad->FlashLayer( aLayerId ) )
                continue;
        }
 
        VECTOR2I margin( 0, 0 );
 
        switch( aLayerId )
        {
        case F_Mask:
        case B_Mask:
            margin.x += pad->GetSolderMaskExpansion( aLayerId );
            margin.y += pad->GetSolderMaskExpansion( aLayerId );
            break;
 
        case F_Paste:
        case B_Paste:
            margin += pad->GetSolderPasteMargin( aLayerId );
            break;
 
        default:
            break;
        }
 
        createPadWithMargin( pad, aContainer, aLayerId, margin );
    }
}
 
 
// based on TransformArcToPolygon function from
// common/convert_basic_shapes_to_polygon.cpp
void BOARD_ADAPTER::createArcSegments( const VECTOR2I& aCentre, const VECTOR2I& aStart,
                                       const EDA_ANGLE& aArcAngle, int aCircleToSegmentsCount,
                                       int aWidth, CONTAINER_2D_BASE* aContainer,
                                       const BOARD_ITEM& aOwner )
{
    // Don't attempt to render degenerate shapes
    if( aWidth == 0 )
        return;
 
    VECTOR2I  arc_start, arc_end;
    EDA_ANGLE arcAngle( aArcAngle );
    EDA_ANGLE delta = ANGLE_360 / aCircleToSegmentsCount;   // rotate angle
 
    arc_end = arc_start = aStart;
 
    if( arcAngle != ANGLE_360 )
        RotatePoint( arc_end, aCentre, -arcAngle );
 
    if( arcAngle < ANGLE_0 )
    {
        std::swap( arc_start, arc_end );
        arcAngle = -arcAngle;
    }
 
    // Compute the ends of segments and creates poly
    VECTOR2I curr_end = arc_start;
    VECTOR2I curr_start = arc_start;
 
    for( EDA_ANGLE ii = delta; ii < arcAngle; ii += delta )
    {
        curr_end = arc_start;
        RotatePoint( curr_end, aCentre, -ii );
 
        addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( curr_start ), TO_SFVEC2F( curr_end ),
                             TO_3DU( aWidth ), aOwner );
 
        curr_start = curr_end;
    }
 
    if( curr_end != arc_end )
    {
        addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( curr_end ), TO_SFVEC2F( arc_end ),
                             TO_3DU( aWidth ), aOwner );
    }
}
 
 
void BOARD_ADAPTER::addShape( const PCB_SHAPE* aShape, CONTAINER_2D_BASE* aContainer,
                              const BOARD_ITEM* aOwner, PCB_LAYER_ID aLayer )
{
    LINE_STYLE lineStyle = aShape->GetStroke().GetLineStyle();
    int        linewidth = aShape->GetWidth();
    int        margin = 0;
    bool       isSolidFill = aShape->IsSolidFill();
    bool       isHatchedFill = aShape->IsHatchedFill();
 
    if( IsSolderMaskLayer( aLayer )
            && aShape->HasSolderMask()
            && ( aShape->IsOnLayer( F_Cu ) || aShape->IsOnLayer( B_Cu ) ) )
    {
        margin = aShape->GetSolderMaskExpansion();
        linewidth += margin * 2;
        lineStyle = LINE_STYLE::SOLID;
 
        if( isHatchedFill )
        {
            isSolidFill = true;
            isHatchedFill = false;
        }
    }
 
    float linewidth3DU = TO_3DU( linewidth );
 
    if( lineStyle <= LINE_STYLE::FIRST_TYPE || isSolidFill )
    {
        switch( aShape->GetShape() )
        {
        case SHAPE_T::CIRCLE:
        {
            SFVEC2F center3DU = TO_SFVEC2F( aShape->GetCenter() );
            float   innerR3DU = TO_3DU( aShape->GetRadius() ) - linewidth3DU / 2.0;
            float   outerR3DU = TO_3DU( aShape->GetRadius() ) + linewidth3DU / 2.0;
 
            if( isSolidFill || innerR3DU <= 0.0 )
            {
                // For a filled circle with a line style not a simple line, ignore line width
                // the outline will be drawn later
                if( lineStyle > LINE_STYLE::FIRST_TYPE )
                    addFILLED_CIRCLE_2D( aContainer, center3DU, TO_3DU( aShape->GetRadius() ), *aOwner );
                else
                    addFILLED_CIRCLE_2D( aContainer, center3DU, outerR3DU, *aOwner );
            }
            else
                addRING_2D( aContainer, center3DU, innerR3DU, outerR3DU, *aOwner );
 
            break;
        }
 
        case SHAPE_T::RECTANGLE:
            if( isSolidFill )
            {
                SHAPE_POLY_SET polyList;
 
                // For a filled rect with a line style not a simple line, ignore line width
                // the outline will be drawn later
                bool ignoreLineWidth = lineStyle > LINE_STYLE::FIRST_TYPE;
 
                aShape->TransformShapeToPolygon( polyList, UNDEFINED_LAYER, 0, aShape->GetMaxError(),
                                                 ERROR_INSIDE, ignoreLineWidth );
 
                polyList.Simplify();
 
                if( margin != 0 )
                {
                    polyList.Inflate( margin, CORNER_STRATEGY::ROUND_ALL_CORNERS, aShape->GetMaxError() );
                }
 
                ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner );
            }
            else
            {
                if( aShape->GetCornerRadius() > 0 )
                {
                    ROUNDRECT rr( SHAPE_RECT( aShape->GetPosition(),
                                              aShape->GetRectangleWidth(),
                                              aShape->GetRectangleHeight() ),
                                  aShape->GetCornerRadius() );
                    SHAPE_POLY_SET poly;
                    rr.TransformToPolygon( poly, aShape->GetMaxError() );
                    SHAPE_LINE_CHAIN& r_outline = poly.Outline( 0 );
                    r_outline.SetClosed( true );
 
                    for( int ii = 0; ii < r_outline.PointCount(); ii++ )
                    {
                        addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( r_outline.CPoint( ii ) ),
                                             TO_SFVEC2F( r_outline.CPoint( ii+1 ) ),
                                             linewidth3DU, *aOwner );
                    }
 
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( r_outline.CLastPoint() ),
                                      TO_SFVEC2F( r_outline.CPoint( 0 ) ), linewidth3DU, *aOwner );
                }
                else
                {
                    std::vector<VECTOR2I> pts = aShape->GetRectCorners();
 
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[0] ), TO_SFVEC2F( pts[1] ),
                                         linewidth3DU, *aOwner );
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[1] ), TO_SFVEC2F( pts[2] ),
                                         linewidth3DU, *aOwner );
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[2] ), TO_SFVEC2F( pts[3] ),
                                         linewidth3DU, *aOwner );
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[3] ), TO_SFVEC2F( pts[0] ),
                                         linewidth3DU, *aOwner );
                }
            }
            break;
 
        case SHAPE_T::ARC:
        {
            unsigned int segCount = GetCircleSegmentCount( aShape->GetBoundingBox().GetSizeMax() );
 
            EDA_ANGLE origStartAngle;
            EDA_ANGLE endAngle;
            aShape->CalcArcAngles( origStartAngle, endAngle );
 
            EDA_ANGLE startAngle = origStartAngle;
            EDA_ANGLE arcAngle = endAngle - startAngle;
 
            if( aShape->ShortenArcForEndings( startAngle, arcAngle, aShape->GetRadius(), linewidth ) )
            {
                // Rotate the original start point by the angular offset from shortening.
                VECTOR2I arcStart = aShape->GetStart();
                RotatePoint( arcStart, aShape->GetCenter(), origStartAngle - startAngle );
 
                createArcSegments( aShape->GetCenter(), arcStart, arcAngle, segCount, linewidth, aContainer,
                                   *aOwner );
            }
 
            break;
        }
 
        case SHAPE_T::SEGMENT:
        {
            VECTOR2I segStart = aShape->GetStart();
            VECTOR2I segEnd = aShape->GetEnd();
 
            if( EDA_SHAPE::ShortenSegmentForEndings( segStart, segEnd, aShape->GetStartEnding(),
                                                     aShape->GetEndEnding(), linewidth ) )
            {
                addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( segStart ), TO_SFVEC2F( segEnd ), linewidth3DU,
                                     *aOwner );
            }
 
            break;
        }
 
        case SHAPE_T::BEZIER:
        {
            std::vector<VECTOR2D> pts = aShape->ShortenedBezierPolyline( linewidth );
 
            for( size_t i = 0; i + 1 < pts.size(); i++ )
            {
                addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( VECTOR2I( pts[i] ) ), TO_SFVEC2F( VECTOR2I( pts[i + 1] ) ),
                                     linewidth3DU, *aOwner );
            }
 
            break;
        }
 
        case SHAPE_T::POLY:
        {
            if( isSolidFill )
            {
                SHAPE_POLY_SET polyList;
 
                // For a filled poly with a line style not a simple line, ignore line width
                // the outline will be drawn later
                bool ignoreLineWidth = lineStyle > LINE_STYLE::FIRST_TYPE;
 
                aShape->TransformShapeToPolygon( polyList, UNDEFINED_LAYER, 0, aShape->GetMaxError(),
                                                 ERROR_INSIDE, ignoreLineWidth );
 
                // Some polygons can be a bit complex (especially when coming from a
                // picture of a text converted to a polygon
                // So call Simplify before calling ConvertPolygonToTriangles, just in case.
                polyList.Simplify();
 
                if( polyList.IsEmpty() ) // Just for caution
                    break;
 
                if( margin != 0 )
                {
                    CORNER_STRATEGY cornerStr = margin >= 0 ? CORNER_STRATEGY::ROUND_ALL_CORNERS
                                                            : CORNER_STRATEGY::ALLOW_ACUTE_CORNERS;
 
                    polyList.Inflate( margin, cornerStr, aShape->GetMaxError() );
                }
 
                ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner );
            }
            else
            {
                const SHAPE_POLY_SET& polyShape = aShape->GetPolyShape();
 
                for( int outlineIdx = 0; outlineIdx < polyShape.OutlineCount(); ++outlineIdx )
                {
                    const SHAPE_LINE_CHAIN& outline = polyShape.COutline( outlineIdx );
 
                    if( outline.PointCount() < 2 )
                        continue;
 
                    std::vector<VECTOR2I> pts;
 
                    if( aShape->GetShortenedBodyPolyPoints( outline, outlineIdx, pts, linewidth ) )
                    {
                        for( size_t i = 0; i + 1 < pts.size(); i++ )
                        {
                            addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[i] ), TO_SFVEC2F( pts[i + 1] ),
                                                 linewidth3DU, *aOwner );
                        }
 
                        if( outline.IsClosed() )
                        {
                            addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts.back() ), TO_SFVEC2F( pts.front() ),
                                                 linewidth3DU, *aOwner );
                        }
                    }
                }
            }
            break;
        }
 
        case SHAPE_T::ELLIPSE:
            if( isSolidFill )
            {
                SHAPE_POLY_SET polyList;
 
                aShape->TransformShapeToPolygon( polyList, UNDEFINED_LAYER, 0, aShape->GetMaxError(), ERROR_INSIDE );
 
                polyList.Simplify();
 
                if( polyList.IsEmpty() )
                    break;
 
                if( margin != 0 )
                {
                    CORNER_STRATEGY cornerStr = margin > 0 ? CORNER_STRATEGY::ROUND_ALL_CORNERS
                                                           : CORNER_STRATEGY::ALLOW_ACUTE_CORNERS;
                    polyList.Inflate( margin, cornerStr, aShape->GetMaxError() );
                }
 
                ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner );
            }
            else
            {
                // Hatched fill: draw only the elliptical outline so the hatch polygons
                // added below remain visible.
                std::vector<SHAPE*> shapes = aShape->MakeEffectiveShapes( true );
 
                for( SHAPE* shape : shapes )
                {
                    if( shape->Type() == SH_SEGMENT )
                    {
                        const SEG& seg = static_cast<const SHAPE_SEGMENT*>( shape )->GetSeg();
                        addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( seg.A ), TO_SFVEC2F( seg.B ), linewidth3DU,
                                             *aOwner );
                    }
                }
 
                for( SHAPE* shape : shapes )
                    delete shape;
            }
 
            break;
 
        case SHAPE_T::ELLIPSE_ARC:
        {
            const VECTOR2D        center( aShape->GetEllipseCenter() );
            const int             majorR = aShape->GetEllipseMajorRadius();
            const int             minorR = aShape->GetEllipseMinorRadius();
            const EDA_ANGLE&      rot = aShape->GetEllipseRotation();
            const EDA_ANGLE&      start = aShape->GetEllipseStartAngle();
            const EDA_ANGLE&      end = aShape->GetEllipseEndAngle();
            SHAPE_ELLIPSE         ellipse( center, majorR, minorR, rot, start, end );
            SHAPE_LINE_CHAIN      chain = ellipse.ConvertToPolyline( aShape->GetMaxError() );
            std::vector<VECTOR2I> pts;
 
            if( aShape->GetShortenedBodyPolyPoints( chain, 0, pts, linewidth ) )
            {
                for( size_t i = 0; i + 1 < pts.size(); i++ )
                {
                    addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[i] ), TO_SFVEC2F( pts[i + 1] ), linewidth3DU,
                                         *aOwner );
                }
            }
 
            break;
        }
 
        default:
            wxFAIL_MSG( wxT( "BOARD_ADAPTER::addShape no implementation for " ) + aShape->SHAPE_T_asString() );
            break;
        }
    }
 
    if( lineStyle > LINE_STYLE::FIRST_TYPE )
    {
        std::vector<SHAPE*> shapes = aShape->MakeEffectiveShapesForStroking( linewidth );
        SFVEC2F             a3DU;
        SFVEC2F             b3DU;
 
        const PCB_PLOT_PARAMS&     plotParams = aShape->GetBoard()->GetPlotOptions();
        KIGFX::PCB_RENDER_SETTINGS renderSettings;
 
        renderSettings.SetDashLengthRatio( plotParams.GetDashedLineDashRatio() );
        renderSettings.SetGapLengthRatio( plotParams.GetDashedLineGapRatio() );
 
        for( SHAPE* shape : shapes )
        {
            STROKE_PARAMS::Stroke( shape, lineStyle, aShape->GetWidth(), &renderSettings,
                    [&]( const VECTOR2I& a, const VECTOR2I& b )
                    {
                        addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( a ), TO_SFVEC2F( b ), linewidth3DU, *aOwner );
                    } );
        }
 
        for( SHAPE* shape : shapes )
            delete shape;
    }
 
    // Render line endings.
    if( aShape->GetStartEnding().GetStyle() != LINE_ENDING_STYLE::NONE
        || aShape->GetEndEnding().GetStyle() != LINE_ENDING_STYLE::NONE )
    {
        EDA_ANGLE startTangent, endTangent;
        aShape->GetEndingTangents( startTangent, endTangent, aShape->GetWidth() );
 
        VECTOR2I startPt, endPt;
 
        auto addEnding =
                [&]( const LINE_ENDING& aEnding, const VECTOR2I& aPoint, const EDA_ANGLE& aTangent )
                {
                    if( aEnding.GetStyle() == LINE_ENDING_STYLE::NONE )
                        return;
 
                    std::vector<VECTOR2I> pts;
                    aEnding.GetShapes( aPoint, aTangent, linewidth, pts );
 
                    if( pts.empty() )
                        return;
 
                    if( aEnding.GetStyle() == LINE_ENDING_STYLE::ARROW_OPEN )
                    {
                        // Open V-shape: draw as thick line segments, not a filled polygon.
                        int   strokeW = aEnding.GetStrokeWidth() > 0 ? aEnding.GetStrokeWidth() : linewidth;
                        float stroke3DU = TO_3DU( strokeW );
 
                        for( size_t ii = 0; ii + 1 < pts.size(); ii++ )
                        {
                            addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[ii] ), TO_SFVEC2F( pts[ii + 1] ),
                                                 stroke3DU, *aOwner );
                        }
                    }
                    else
                    {
                        if( aEnding.GetStrokeWidth() > 0 )
                        {
                            float stroke3DU = TO_3DU( aEnding.GetStrokeWidth() );
 
                            for( size_t ii = 0; ii < pts.size(); ii++ )
                            {
                                size_t next = ( ii + 1 ) % pts.size();
 
                                addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( pts[ii] ), TO_SFVEC2F( pts[next] ),
                                                     stroke3DU, *aOwner );
                            }
                        }
 
                        SHAPE_POLY_SET polySet;
                        polySet.NewOutline();
 
                        for( const VECTOR2I& pt : pts )
                            polySet.Append( pt );
 
                        ConvertPolygonToTriangles( polySet, *aContainer, m_biuTo3Dunits, *aOwner );
                    }
                };
 
        if( aShape->GetLineEndingEndpoints( startPt, endPt ) )
        {
            addEnding( aShape->GetStartEnding(), startPt, startTangent );
            addEnding( aShape->GetEndEnding(), endPt, endTangent );
        }
    }
 
    if( isHatchedFill )
        ConvertPolygonToTriangles( aShape->GetHatching(), *aContainer, m_biuTo3Dunits, *aOwner );
}
 
 
void BOARD_ADAPTER::addShape( const PCB_TEXTBOX* aTextBox, CONTAINER_2D_BASE* aContainer,
                              const BOARD_ITEM* aOwner )
{
    addText( aTextBox, aContainer, aOwner );
 
    if( !aTextBox->IsBorderEnabled() )
        return;
 
    // we use the box polygonal shape to honor the text box rotation and box line style
    PCB_SHAPE tb_box = aTextBox->GetPolygonalBoxShape();
    addShape( &tb_box, aContainer, aOwner, UNDEFINED_LAYER );
}
 
 
void BOARD_ADAPTER::addTable( const PCB_TABLE* aTable, CONTAINER_2D_BASE* aContainer,
                              const BOARD_ITEM* aOwner )
{
    aTable->DrawBorders(
            [&]( const VECTOR2I& ptA, const VECTOR2I& ptB, const STROKE_PARAMS& stroke )
            {
                addROUND_SEGMENT_2D( aContainer, TO_SFVEC2F( ptA ), TO_SFVEC2F( ptB ),
                                     TO_3DU( stroke.GetWidth() ), *aOwner );
            } );
 
    for( PCB_TABLECELL* cell : aTable->GetCells() )
    {
        if( cell->GetColSpan() > 0 && cell->GetRowSpan() > 0 )
            addText( cell, aContainer, aOwner );
    }
}
 
 
void BOARD_ADAPTER::addSolidAreasShapes( const ZONE* aZone, CONTAINER_2D_BASE* aContainer,
                                         PCB_LAYER_ID aLayerId )
{
    // This convert the poly in outline and holes
    ConvertPolygonToTriangles( *aZone->GetFilledPolysList( aLayerId ), *aContainer, m_biuTo3Dunits, *aZone );
}
 
 
void BOARD_ADAPTER::buildPadOutlineAsSegments( const PAD* aPad, PCB_LAYER_ID aLayer,
                                               CONTAINER_2D_BASE* aContainer, int aWidth )
{
    if( aPad->GetShape( aLayer ) == PAD_SHAPE::CIRCLE )    // Draw a ring
    {
        const SFVEC2F center3DU = TO_SFVEC2F( aPad->ShapePos( aLayer ) );
        const int     radius = aPad->GetSize( aLayer ).x / 2;
        const float   inner_radius3DU = TO_3DU( radius - aWidth / 2.0 );
        const float   outer_radius3DU = TO_3DU( radius + aWidth / 2.0 );
 
        addRING_2D( aContainer, center3DU, inner_radius3DU, outer_radius3DU, *aPad );
    }
    else
    {
        // For other shapes, add outlines as thick segments in polygon buffer
        const std::shared_ptr<SHAPE_POLY_SET>& corners = aPad->GetEffectivePolygon( aLayer, ERROR_INSIDE );
        const SHAPE_LINE_CHAIN&                path = corners->COutline( 0 );
 
        for( int j = 0; j < path.PointCount(); j++ )
        {
            SFVEC2F start3DU = TO_SFVEC2F( path.CPoint( j ) );
            SFVEC2F end3DU = TO_SFVEC2F( path.CPoint( j + 1 ) );
 
            addROUND_SEGMENT_2D( aContainer, start3DU, end3DU, TO_3DU( aWidth ), *aPad );
        }
    }
}