exporter_step.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2022 Mark Roszko <[email protected]>
 * Copyright (C) 2016 Cirilo Bernardo <[email protected]>
 * 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, you may find one here:
 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 * or you may search the http://www.gnu.org website for the version 2 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
 */
 
#include "exporter_step.h"
#include <advanced_config.h>
#include <board.h>
#include <board_design_settings.h>
#include <convert_basic_shapes_to_polygon.h>
#include <footprint.h>
#include <pcb_textbox.h>
#include <pcb_table.h>
#include <pcb_tablecell.h>
#include <pcb_track.h>
#include <pcb_shape.h>
#include <pcb_barcode.h>
#include <pcb_painter.h>
#include <pad.h>
#include <zone.h>
#include <footprint_library_adapter.h>
#include "step_pcb_model.h"
#include <3d_rendering/3d_placeholder_utils.h>
 
#include <pgm_base.h>
#include <reporter.h>
#include <base_units.h>
#include <filename_resolver.h>
#include <trace_helpers.h>
#include <project_pcb.h>
#include <wildcards_and_files_ext.h>
 
#include <new>                        // std::bad_alloc
#include <Message.hxx>                // OpenCascade messenger
#include <Message_PrinterOStream.hxx> // OpenCascade output messenger
#include <Standard_Failure.hxx>       // In open cascade
 
#include <Standard_Version.hxx>
 
#include <wx/crt.h>
#include <wx/log.h>
#include <wx/tokenzr.h>
#include <core/profile.h>        // To use GetRunningMicroSecs or another profiling utility
 
#define OCC_VERSION_MIN 0x070500
 
#if OCC_VERSION_HEX < OCC_VERSION_MIN
#include <Message_Messenger.hxx>
#endif
 
 
class KICAD_PRINTER : public Message_Printer
{
public:
    KICAD_PRINTER( REPORTER* aReporter ) :
            m_reporter( aReporter )
    {}
 
protected:
#if OCC_VERSION_HEX < OCC_VERSION_MIN
    virtual void Send( const TCollection_ExtendedString& theString,
                       const Message_Gravity theGravity,
                       const bool theToPutEol ) const override
    {
        Send( TCollection_AsciiString( theString ), theGravity, theToPutEol );
    }
 
    virtual void Send( const TCollection_AsciiString& theString,
                       const Message_Gravity theGravity,
                       const bool theToPutEol ) const override
#else
    virtual void send( const TCollection_AsciiString& theString,
                       const Message_Gravity theGravity ) const override
#endif
    {
        wxString msg( theString.ToCString() );
 
#if OCC_VERSION_HEX < OCC_VERSION_MIN
        if( theToPutEol )
            msg += wxT( "\n" );
#else
        msg += wxT( "\n" );
#endif
 
        m_reporter->Report( msg, getSeverity( theGravity ) );
    }
 
private:
    SEVERITY getSeverity( const Message_Gravity theGravity ) const
    {
        switch( theGravity )
        {
        case Message_Trace:   return RPT_SEVERITY_DEBUG;
        case Message_Info:    return RPT_SEVERITY_DEBUG;
        case Message_Warning: return RPT_SEVERITY_WARNING;
        case Message_Alarm:   return RPT_SEVERITY_WARNING;
        case Message_Fail:    return RPT_SEVERITY_ERROR;
 
        // There are no other values, but gcc doesn't appear to be able to work that out.
        default:              return RPT_SEVERITY_UNDEFINED;
        }
    }
 
private:
    REPORTER* m_reporter;
};
 
 
EXPORTER_STEP::EXPORTER_STEP( BOARD* aBoard, const EXPORTER_STEP_PARAMS& aParams,
                              REPORTER* aReporter ) :
        m_params( aParams ),
        m_reporter( aReporter ),
        m_board( aBoard ),
        m_pcbModel( nullptr )
{
    m_copperColor = COLOR4D( 0.7, 0.61, 0.0, 1.0 );
 
    if( m_params.m_ExportComponents )
        m_padColor = COLOR4D( 0.50, 0.50, 0.50, 1.0 );
    else
        m_padColor = m_copperColor;
 
    // TODO: make configurable
    m_platingThickness = pcbIUScale.mmToIU( 0.025 );
 
    // Init m_pcbBaseName to the board short filename (no path, no ext)
    // m_pcbName is used later to identify items in step file
    wxFileName fn( aBoard->GetFileName() );
    m_pcbBaseName = fn.GetName();
 
    m_resolver = std::make_unique<FILENAME_RESOLVER>();
    m_resolver->Set3DConfigDir( wxT( "" ) );
    // needed to add the project to the search stack
    m_resolver->SetProject( aBoard->GetProject() );
    m_resolver->SetProgramBase( &Pgm() );
}
 
 
EXPORTER_STEP::~EXPORTER_STEP()
{
}
 
 
bool EXPORTER_STEP::isLayerInBackdrillSpan( PCB_LAYER_ID aLayer, PCB_LAYER_ID aStartLayer,
                                            PCB_LAYER_ID aEndLayer ) const
{
    if( !IsCopperLayer( aLayer ) )
        return false;
 
    // Quick check for exact match
    if( aLayer == aStartLayer || aLayer == aEndLayer )
        return true;
 
    // Convert layers to a sortable index for comparison
    // F_Cu = -1, In1_Cu through In30_Cu = 0-29, B_Cu = MAX_CU_LAYERS (32)
    auto layerToIndex = []( PCB_LAYER_ID layer ) -> int
    {
        if( layer == F_Cu )
            return -1;
 
        if( layer == B_Cu )
            return MAX_CU_LAYERS;
 
        if( IsInnerCopperLayer( layer ) )
            return layer - In1_Cu;
 
        return -2; // Invalid copper layer
    };
 
    int startIdx = layerToIndex( aStartLayer );
    int endIdx = layerToIndex( aEndLayer );
    int layerIdx = layerToIndex( aLayer );
 
    if( layerIdx == -2 )
        return false;
 
    int minIdx = std::min( startIdx, endIdx );
    int maxIdx = std::max( startIdx, endIdx );
 
    return ( layerIdx >= minIdx && layerIdx <= maxIdx );
}
 
 
bool EXPORTER_STEP::netFilterMatches( const wxString& netname ) const
{
    if( m_params.m_NetFilter.IsEmpty() )
        return true;
 
    wxArrayString parts = wxSplit( m_params.m_NetFilter, ',' );
 
    for( wxString token : parts )
    {
        token.Trim( true ).Trim( false );
 
        if( token.IsEmpty() )
            continue;
 
        if( netname.Matches( token ) )
            return true;
    }
 
    return false;
}
 
 
bool EXPORTER_STEP::buildFootprint3DShapes( FOOTPRINT* aFootprint, const VECTOR2D& aOrigin,
                                            SHAPE_POLY_SET* aClipPolygon )
{
    bool              hasdata = false;
    std::vector<PAD*> padsMatchingNetFilter;
 
    // Dump the pad holes into the PCB
    for( PAD* pad : aFootprint->Pads() )
    {
        bool castellated = pad->GetProperty() == PAD_PROP::CASTELLATED;
        std::shared_ptr<SHAPE_SEGMENT> holeShape = pad->GetEffectiveHoleShape();
 
        SHAPE_POLY_SET holePoly;
        holeShape->TransformToPolygon( holePoly, pad->GetMaxError(), ERROR_INSIDE );
 
        // This helps with fusing
        holePoly.Deflate( m_platingThickness / 2, CORNER_STRATEGY::ROUND_ALL_CORNERS, pad->GetMaxError() );
 
        for( PCB_LAYER_ID pcblayer : pad->GetLayerSet() )
        {
            if( pad->IsOnLayer( pcblayer ) )
                m_poly_holes[pcblayer].Append( holePoly );
        }
 
        if( pad->HasHole() )
        {
            int platingThickness = pad->GetAttribute() == PAD_ATTRIB::PTH ? m_platingThickness : 0;
 
            if( m_pcbModel->AddHole( *holeShape, platingThickness, F_Cu, B_Cu, false, aOrigin, true, true ) )
                hasdata = true;
 
            // Use the drill shape directly. holePoly is shrunk to fit the copper barrel.
            if( m_layersToExport.Contains( F_SilkS ) || m_layersToExport.Contains( B_SilkS ) )
            {
                SHAPE_POLY_SET silkHole;
                holeShape->TransformToPolygon( silkHole, pad->GetMaxError(), ERROR_INSIDE );
 
                if( m_layersToExport.Contains( F_SilkS ) )
                    m_poly_holes[F_SilkS].Append( silkHole );
 
                if( m_layersToExport.Contains( B_SilkS ) )
                    m_poly_holes[B_SilkS].Append( silkHole );
            }
 
            // Handle backdrills - secondary and tertiary drills defined in the padstack
            const PADSTACK& padstack = pad->Padstack();
            const PADSTACK::DRILL_PROPS& secondaryDrill = padstack.SecondaryDrill();
            const PADSTACK::DRILL_PROPS& tertiaryDrill = padstack.TertiaryDrill();
 
            // Process secondary drill (typically bottom backdrill)
            if( secondaryDrill.size.x > 0 )
            {
                SHAPE_SEGMENT backdrillShape( pad->GetPosition(), pad->GetPosition(),
                                              secondaryDrill.size.x );
                m_pcbModel->AddBackdrill( backdrillShape, secondaryDrill.start,
                                          secondaryDrill.end, aOrigin );
 
                // Add backdrill holes to affected copper layers for 2D polygon subtraction
                SHAPE_POLY_SET backdrillPoly;
                backdrillShape.TransformToPolygon( backdrillPoly, pad->GetMaxError(), ERROR_INSIDE );
 
                for( PCB_LAYER_ID layer : pad->GetLayerSet() )
                {
                    if( isLayerInBackdrillSpan( layer, secondaryDrill.start, secondaryDrill.end ) )
                        m_poly_holes[layer].Append( backdrillPoly );
                }
 
                // Add knockouts for silkscreen and soldermask on the backdrill side
                if( isLayerInBackdrillSpan( F_Cu, secondaryDrill.start, secondaryDrill.end ) )
                {
                    m_poly_holes[F_SilkS].Append( backdrillPoly );
                    m_poly_holes[F_Mask].Append( backdrillPoly );
                }
                if( isLayerInBackdrillSpan( B_Cu, secondaryDrill.start, secondaryDrill.end ) )
                {
                    m_poly_holes[B_SilkS].Append( backdrillPoly );
                    m_poly_holes[B_Mask].Append( backdrillPoly );
                }
            }
 
            // Process tertiary drill (typically top backdrill)
            if( tertiaryDrill.size.x > 0 )
            {
                SHAPE_SEGMENT backdrillShape( pad->GetPosition(), pad->GetPosition(),
                                              tertiaryDrill.size.x );
                m_pcbModel->AddBackdrill( backdrillShape, tertiaryDrill.start,
                                          tertiaryDrill.end, aOrigin );
 
                // Add backdrill holes to affected copper layers for 2D polygon subtraction
                SHAPE_POLY_SET backdrillPoly;
                backdrillShape.TransformToPolygon( backdrillPoly, pad->GetMaxError(), ERROR_INSIDE );
 
                for( PCB_LAYER_ID layer : pad->GetLayerSet() )
                {
                    if( isLayerInBackdrillSpan( layer, tertiaryDrill.start, tertiaryDrill.end ) )
                        m_poly_holes[layer].Append( backdrillPoly );
                }
 
                // Add knockouts for silkscreen and soldermask on the backdrill side
                if( isLayerInBackdrillSpan( F_Cu, tertiaryDrill.start, tertiaryDrill.end ) )
                {
                    m_poly_holes[F_SilkS].Append( backdrillPoly );
                    m_poly_holes[F_Mask].Append( backdrillPoly );
                }
                if( isLayerInBackdrillSpan( B_Cu, tertiaryDrill.start, tertiaryDrill.end ) )
                {
                    m_poly_holes[B_SilkS].Append( backdrillPoly );
                    m_poly_holes[B_Mask].Append( backdrillPoly );
                }
            }
 
            // Process post-machining (counterbore/countersink) on front and back
            const PADSTACK::POST_MACHINING_PROPS& frontPM = padstack.FrontPostMachining();
            const PADSTACK::POST_MACHINING_PROPS& backPM = padstack.BackPostMachining();
 
            wxLogTrace( traceKiCad2Step, wxT( "PAD post-machining check: frontPM.mode.has_value=%d frontPM.size=%d frontPM.depth=%d frontPM.angle=%d" ),
                        frontPM.mode.has_value() ? 1 : 0, frontPM.size, frontPM.depth, frontPM.angle );
            wxLogTrace( traceKiCad2Step, wxT( "PAD post-machining check: backPM.mode.has_value=%d backPM.size=%d backPM.depth=%d backPM.angle=%d" ),
                        backPM.mode.has_value() ? 1 : 0, backPM.size, backPM.depth, backPM.angle );
 
            // For counterbore, depth must be > 0. For countersink, depth can be 0 (calculated from diameter/angle)
            bool frontPMValid = frontPM.mode.has_value() && frontPM.size > 0 &&
                                ( ( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE && frontPM.depth > 0 ) ||
                                  ( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK && frontPM.angle > 0 ) );
 
            if( frontPMValid )
            {
                wxLogTrace( traceKiCad2Step, wxT( "PAD front post-machining: mode=%d (COUNTERBORE=2, COUNTERSINK=3)" ),
                            static_cast<int>( *frontPM.mode ) );
 
                int pmAngle = ( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK ) ? frontPM.angle : 0;
 
                if( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE )
                {
                    m_pcbModel->AddCounterbore( pad->GetPosition(), frontPM.size,
                                                frontPM.depth, true, aOrigin );
                }
                else if( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK )
                {
                    m_pcbModel->AddCountersink( pad->GetPosition(), frontPM.size,
                                                frontPM.depth, frontPM.angle, true, aOrigin );
                }
 
                // Add knockouts to all copper layers the feature crosses
                auto knockouts = m_pcbModel->GetCopperLayerKnockouts( frontPM.size, frontPM.depth,
                                                                      pmAngle, true );
                for( const auto& [layer, diameter] : knockouts )
                {
                    SHAPE_POLY_SET pmPoly;
                    TransformCircleToPolygon( pmPoly, pad->GetPosition(), diameter / 2,
                                              pad->GetMaxError(), ERROR_INSIDE );
                    m_poly_holes[layer].Append( pmPoly );
                }
 
                // Add knockout for silkscreen and soldermask on front side (full diameter)
                SHAPE_POLY_SET pmPoly;
                TransformCircleToPolygon( pmPoly, pad->GetPosition(), frontPM.size / 2,
                                          pad->GetMaxError(), ERROR_INSIDE );
                m_poly_holes[F_SilkS].Append( pmPoly );
                m_poly_holes[F_Mask].Append( pmPoly );
            }
 
            // For counterbore, depth must be > 0. For countersink, depth can be 0 (calculated from diameter/angle)
            bool backPMValid = backPM.mode.has_value() && backPM.size > 0 &&
                               ( ( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE && backPM.depth > 0 ) ||
                                 ( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK && backPM.angle > 0 ) );
 
            if( backPMValid )
            {
                wxLogTrace( traceKiCad2Step, wxT( "PAD back post-machining: mode=%d (COUNTERBORE=2, COUNTERSINK=3)" ),
                            static_cast<int>( *backPM.mode ) );
 
                int pmAngle = ( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK ) ? backPM.angle : 0;
 
                if( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE )
                {
                    m_pcbModel->AddCounterbore( pad->GetPosition(), backPM.size,
                                                backPM.depth, false, aOrigin );
                }
                else if( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK )
                {
                    m_pcbModel->AddCountersink( pad->GetPosition(), backPM.size,
                                                backPM.depth, backPM.angle, false, aOrigin );
                }
 
                // Add knockouts to all copper layers the feature crosses
                auto knockouts = m_pcbModel->GetCopperLayerKnockouts( backPM.size, backPM.depth,
                                                                      pmAngle, false );
                for( const auto& [layer, diameter] : knockouts )
                {
                    SHAPE_POLY_SET pmPoly;
                    TransformCircleToPolygon( pmPoly, pad->GetPosition(), diameter / 2,
                                              pad->GetMaxError(), ERROR_INSIDE );
                    m_poly_holes[layer].Append( pmPoly );
                }
 
                // Add knockout for silkscreen and soldermask on back side (full diameter)
                SHAPE_POLY_SET pmPoly;
                TransformCircleToPolygon( pmPoly, pad->GetPosition(), backPM.size / 2,
                                          pad->GetMaxError(), ERROR_INSIDE );
                m_poly_holes[B_SilkS].Append( pmPoly );
                m_poly_holes[B_Mask].Append( pmPoly );
            }
        }
 
        if( !netFilterMatches( pad->GetNetname() ) )
            continue;
 
        if( m_params.m_ExportPads )
        {
            if( m_pcbModel->AddPadShape( pad, aOrigin, false, castellated ? aClipPolygon : nullptr) )
                hasdata = true;
 
            if( m_params.m_ExportSoldermask )
            {
                for( PCB_LAYER_ID pcblayer : pad->GetLayerSet() )
                {
                    if( pcblayer != F_Mask && pcblayer != B_Mask )
                        continue;
 
                    SHAPE_POLY_SET poly;
                    PCB_LAYER_ID cuLayer = ( pcblayer == F_Mask ) ? F_Cu : B_Cu;
                    pad->TransformShapeToPolygon( poly, cuLayer, pad->GetSolderMaskExpansion( cuLayer ),
                                                  pad->GetMaxError(), ERROR_INSIDE );
 
                    m_poly_shapes[pcblayer][wxEmptyString].Append( poly );
                }
            }
        }
 
        padsMatchingNetFilter.push_back( pad );
    }
 
    // Build 3D shapes of the footprint graphic items:
    for( PCB_LAYER_ID pcblayer : m_layersToExport )
    {
        if( IsCopperLayer( pcblayer ) && !m_params.m_ExportTracksVias )
            continue;
 
        SHAPE_POLY_SET buffer;
 
        aFootprint->TransformFPShapesToPolySet( buffer, pcblayer, 0, aFootprint->GetMaxError(), ERROR_INSIDE,
                                                true, /* include text */
                                                true, /* include shapes */
                                                false /* include private items */ );
 
        if( !IsCopperLayer( pcblayer ) )
        {
            m_poly_shapes[pcblayer][wxEmptyString].Append( buffer );
        }
        else
        {
            std::map<const SHAPE_POLY_SET::POLYGON*, PAD*> polyPadMap;
 
            // Only add polygons colliding with any matching pads
            for( const SHAPE_POLY_SET::POLYGON& poly : buffer.CPolygons() )
            {
                for( PAD* pad : padsMatchingNetFilter )
                {
                    if( !pad->IsOnLayer( pcblayer ) )
                        continue;
 
                    std::shared_ptr<SHAPE_POLY_SET> padPoly = pad->GetEffectivePolygon( pcblayer );
                    SHAPE_POLY_SET                  gfxPoly( poly );
 
                    if( padPoly->Collide( &gfxPoly ) )
                    {
                        polyPadMap[&poly] = pad;
                        m_poly_shapes[pcblayer][pad->GetNetname()].Append( gfxPoly );
                        break;
                    }
                }
            }
 
            if( m_params.m_NetFilter.empty() )
            {
                // Add polygons with no net
                for( const SHAPE_POLY_SET::POLYGON& poly : buffer.CPolygons() )
                {
                    auto it = polyPadMap.find( &poly );
 
                    if( it == polyPadMap.end() )
                        m_poly_shapes[pcblayer][wxEmptyString].Append( poly );
                }
            }
        }
    }
 
    if( ( !(aFootprint->GetAttributes() & (FP_THROUGH_HOLE|FP_SMD)) ) && !m_params.m_IncludeUnspecified )
    {
        return hasdata;
    }
 
    if( aFootprint->GetDNPForVariant( m_board ? m_board->GetCurrentVariant() : wxString() )
            && !m_params.m_IncludeDNP )
    {
        return hasdata;
    }
 
    // Prefetch the library for this footprint
    // In case we need to resolve relative footprint paths
    wxString libraryName = aFootprint->GetFPID().GetLibNickname();
    wxString footprintBasePath = wxEmptyString;
 
    double posX = aFootprint->GetPosition().x - aOrigin.x;
    double posY = (aFootprint->GetPosition().y) - aOrigin.y;
 
    if( m_board->GetProject() )
    {
        std::optional<LIBRARY_TABLE_ROW*> fpRow =
                            PROJECT_PCB::FootprintLibAdapter( m_board->GetProject() )->GetRow( libraryName );
        if( fpRow )
            footprintBasePath = LIBRARY_MANAGER::GetFullURI( *fpRow, true );
    }
 
    // Exit early if we don't want to include footprint models
    if( m_params.m_BoardOnly || !m_params.m_ExportComponents )
    {
        return hasdata;
    }
 
    bool componentFilter = !m_params.m_ComponentFilter.IsEmpty();
    std::vector<wxString> componentFilterPatterns;
 
    if( componentFilter )
    {
        wxStringTokenizer tokenizer( m_params.m_ComponentFilter, ", \t\r\n", wxTOKEN_STRTOK );
 
        while( tokenizer.HasMoreTokens() )
            componentFilterPatterns.push_back( tokenizer.GetNextToken() );
 
        bool found = false;
 
        for( const wxString& pattern : componentFilterPatterns )
        {
            if( aFootprint->GetReference().Matches( pattern ) )
            {
                found = true;
                break;
            }
        }
 
        if( !found )
            return hasdata;
    }
 
    VECTOR2D newpos( pcbIUScale.IUTomm( posX ), pcbIUScale.IUTomm( posY ) );
 
    for( const FP_3DMODEL& fp_model : aFootprint->Models() )
    {
        if( !fp_model.m_Show || fp_model.m_Filename.empty() )
            continue;
 
        std::vector<wxString>              searchedPaths;
        std::vector<const EMBEDDED_FILES*> embeddedFilesStack;
        embeddedFilesStack.push_back( aFootprint->GetEmbeddedFiles() );
        embeddedFilesStack.push_back( m_board->GetEmbeddedFiles() );
 
        wxString mainPath = m_resolver->ResolvePath( fp_model.m_Filename, footprintBasePath,
                                                     embeddedFilesStack );
 
        if( mainPath.empty() || !wxFileName::FileExists( mainPath ) )
        {
            // the error path will return an empty name sometimes, at least report back the original filename
            if( mainPath.empty() )
                mainPath = fp_model.m_Filename;
 
            m_reporter->Report( wxString::Format( _( "Could not add 3D model for %s.\n"
                                                     "File not found: %s\n" ),
                                                  aFootprint->GetReference(), mainPath ),
                                RPT_SEVERITY_WARNING );
            continue;
        }
 
        wxString baseName =
                fp_model.m_Filename.AfterLast( '/' ).AfterLast( '\\' ).BeforeLast( '.' );
 
        std::vector<wxString> altFilenames;
 
        // Add embedded files to alternative filenames
        if( fp_model.m_Filename.StartsWith( FILEEXT::KiCadUriPrefix + "://" ) )
        {
            for( const EMBEDDED_FILES* filesPtr : embeddedFilesStack )
            {
                const auto& map = filesPtr->EmbeddedFileMap();
 
                for( auto& [fname, file] : map )
                {
                    if( fname.BeforeLast( '.' ) == baseName )
                    {
                        wxFileName temp_file = filesPtr->GetTemporaryFileName( fname );
 
                        if( !temp_file.IsOk() )
                            continue;
 
                        wxString altPath = temp_file.GetFullPath();
 
                        if( mainPath == altPath )
                            continue;
 
                        altFilenames.emplace_back( altPath );
                    }
                }
            }
        }
 
        try
        {
            bool bottomSide = aFootprint->GetLayer() == B_Cu;
 
            // the rotation is stored in degrees but opencascade wants radians
            VECTOR3D modelRot = fp_model.m_Rotation;
            modelRot *= M_PI;
            modelRot /= 180.0;
 
            if( m_pcbModel->AddComponent(
                        baseName, mainPath, altFilenames, aFootprint->GetReference(), bottomSide,
                        newpos, aFootprint->GetOrientation().AsRadians(), fp_model.m_Offset,
                        modelRot, fp_model.m_Scale, m_params.m_SubstModels ) )
            {
                hasdata = true;
            }
        }
        catch( const Standard_Failure& e )
        {
            m_reporter->Report( wxString::Format( _( "Could not add 3D model for %s.\n"
                                                     "OpenCASCADE error: %s\n" ),
                                                  aFootprint->GetReference(),
                                                  e.GetMessageString() ),
                                RPT_SEVERITY_WARNING );
        }
 
    }
 
    if( aFootprint->HasExtrudedBody() && aFootprint->GetExtrudedBody()->m_show )
    {
        const EXTRUDED_3D_BODY* body = aFootprint->GetExtrudedBody();
        SHAPE_POLY_SET          outline;
 
        if( GetExtrusionOutline( aFootprint, outline ) && outline.OutlineCount() > 0 )
        {
            VECTOR2I fpPos = aFootprint->GetPosition();
            ApplyExtrusionTransform( outline, body, fpPos );
 
            bool   bottomSide = aFootprint->GetLayer() == B_Cu;
            double standoff = pcbIUScale.IUTomm( body->m_standoff ) + body->m_offset.z;
            double bodyThickness = pcbIUScale.IUTomm( body->m_height - body->m_standoff ) * body->m_scale.z;
            double height = standoff + bodyThickness;
 
            KIGFX::COLOR4D c = body->m_color;
 
            if( c == KIGFX::COLOR4D::UNSPECIFIED )
                c = EXTRUDED_3D_BODY::GetDefaultColor( body->m_material );
 
            uint32_t colorKey = EXTRUDED_3D_BODY::PackColorKey( c );
 
            try
            {
                if( m_pcbModel->AddExtrudedBody( outline, bottomSide, standoff, height, aOrigin, colorKey,
                                                 body->m_material, aFootprint->GetReference() ) )
                {
                    hasdata = true;
                }
            }
            catch( const Standard_Failure& e )
            {
                m_reporter->Report( wxString::Format( _( "Could not add extruded body for %s.\n"
                                                         "OpenCASCADE error: %s\n" ),
                                                      aFootprint->GetReference(), e.GetMessageString() ),
                                    RPT_SEVERITY_WARNING );
            }
 
            // Add metallic pin extrusions for through-hole pads
            if( standoff > 0.0 )
            {
                try
                {
                    m_pcbModel->AddExtrudedPins( aFootprint, bottomSide, standoff, aOrigin );
                }
                catch( const Standard_Failure& e )
                {
                    m_reporter->Report( wxString::Format( _( "Could not add extruded pins for %s.\n"
                                                             "OpenCASCADE error: %s\n" ),
                                                          aFootprint->GetReference(), e.GetMessageString() ),
                                        RPT_SEVERITY_WARNING );
                }
            }
        }
    }
 
    return hasdata;
}
 
 
bool EXPORTER_STEP::buildTrack3DShape( PCB_TRACK* aTrack, const VECTOR2D& aOrigin )
{
    bool skipCopper = !m_params.m_ExportTracksVias || !netFilterMatches( aTrack->GetNetname() );
 
    if( m_params.m_ExportSoldermask && aTrack->IsOnLayer( F_Mask ) )
    {
        aTrack->TransformShapeToPolygon( m_poly_shapes[F_Mask][wxEmptyString], F_Mask,
                                         aTrack->GetSolderMaskExpansion(), aTrack->GetMaxError(),
                                         ERROR_INSIDE );
    }
 
    if( m_params.m_ExportSoldermask && aTrack->IsOnLayer( B_Mask ) )
    {
        aTrack->TransformShapeToPolygon( m_poly_shapes[B_Mask][wxEmptyString], B_Mask,
                                         aTrack->GetSolderMaskExpansion(), aTrack->GetMaxError(),
                                         ERROR_INSIDE );
    }
 
    if( aTrack->Type() == PCB_VIA_T )
    {
        PCB_VIA* via = static_cast<PCB_VIA*>( aTrack );
 
        std::shared_ptr<SHAPE_SEGMENT> holeShape = via->GetEffectiveHoleShape();
        SHAPE_POLY_SET                 holePoly;
        holeShape->TransformToPolygon( holePoly, via->GetMaxError(), ERROR_INSIDE );
 
        // This helps with fusing
        holePoly.Deflate( m_platingThickness / 2, CORNER_STRATEGY::ROUND_ALL_CORNERS, via->GetMaxError() );
 
        LSET layers( via->GetLayerSet() & m_layersToExport );
 
        PCB_LAYER_ID top_layer, bot_layer;
        via->LayerPair( &top_layer, &bot_layer );
 
        if( !skipCopper )
        {
            for( PCB_LAYER_ID pcblayer : layers )
            {
                const std::shared_ptr<SHAPE>& shape = via->GetEffectiveShape( pcblayer );
 
                SHAPE_POLY_SET poly;
                shape->TransformToPolygon( poly, via->GetMaxError(), ERROR_INSIDE );
                m_poly_shapes[pcblayer][via->GetNetname()].Append( poly );
                m_poly_holes[pcblayer].Append( holePoly );
            }
 
            m_pcbModel->AddBarrel( *holeShape, top_layer, bot_layer, true, aOrigin, via->GetNetname() );
        }
 
        // Use the drill shape directly. holePoly is shrunk to fit the copper barrel.
        if( m_layersToExport.Contains( F_SilkS ) || m_layersToExport.Contains( B_SilkS ) )
        {
            SHAPE_POLY_SET silkHole;
            holeShape->TransformToPolygon( silkHole, via->GetMaxError(), ERROR_INSIDE );
 
            if( top_layer == F_Cu && m_layersToExport.Contains( F_SilkS ) )
                m_poly_holes[F_SilkS].Append( silkHole );
 
            if( bot_layer == B_Cu && m_layersToExport.Contains( B_SilkS ) )
                m_poly_holes[B_SilkS].Append( silkHole );
        }
 
        // Cut via holes in soldermask when the via is not tented.
        // This ensures the mask has a proper hole through the via drill, not just the annular ring opening.
        if( m_params.m_ExportSoldermask )
        {
            if( via->IsOnLayer( F_Mask ) )
                m_poly_holes[F_Mask].Append( holePoly );
 
            if( via->IsOnLayer( B_Mask ) )
                m_poly_holes[B_Mask].Append( holePoly );
        }
 
        m_pcbModel->AddHole( *holeShape, m_platingThickness, top_layer, bot_layer, true, aOrigin,
                             !m_params.m_FillAllVias, m_params.m_CutViasInBody );
 
        // Handle via backdrills - secondary and tertiary drills defined in the padstack
        const PADSTACK& padstack = via->Padstack();
        const PADSTACK::DRILL_PROPS& secondaryDrill = padstack.SecondaryDrill();
        const PADSTACK::DRILL_PROPS& tertiaryDrill = padstack.TertiaryDrill();
 
        // Process secondary drill (typically bottom backdrill)
        if( secondaryDrill.size.x > 0 )
        {
            SHAPE_SEGMENT backdrillShape( via->GetPosition(), via->GetPosition(),
                                          secondaryDrill.size.x );
            m_pcbModel->AddBackdrill( backdrillShape, secondaryDrill.start,
                                      secondaryDrill.end, aOrigin );
 
            // Add backdrill holes to affected copper layers for 2D polygon subtraction
            SHAPE_POLY_SET backdrillPoly;
            backdrillShape.TransformToPolygon( backdrillPoly, via->GetMaxError(), ERROR_INSIDE );
 
            for( PCB_LAYER_ID layer : via->GetLayerSet() )
            {
                if( isLayerInBackdrillSpan( layer, secondaryDrill.start, secondaryDrill.end ) )
                    m_poly_holes[layer].Append( backdrillPoly );
            }
 
            // Add knockouts for silkscreen and soldermask on the backdrill side
            if( isLayerInBackdrillSpan( F_Cu, secondaryDrill.start, secondaryDrill.end ) )
            {
                m_poly_holes[F_SilkS].Append( backdrillPoly );
                m_poly_holes[F_Mask].Append( backdrillPoly );
            }
            if( isLayerInBackdrillSpan( B_Cu, secondaryDrill.start, secondaryDrill.end ) )
            {
                m_poly_holes[B_SilkS].Append( backdrillPoly );
                m_poly_holes[B_Mask].Append( backdrillPoly );
            }
        }
 
        // Process tertiary drill (typically top backdrill)
        if( tertiaryDrill.size.x > 0 )
        {
            SHAPE_SEGMENT backdrillShape( via->GetPosition(), via->GetPosition(),
                                          tertiaryDrill.size.x );
            m_pcbModel->AddBackdrill( backdrillShape, tertiaryDrill.start,
                                      tertiaryDrill.end, aOrigin );
 
            // Add backdrill holes to affected copper layers for 2D polygon subtraction
            SHAPE_POLY_SET backdrillPoly;
            backdrillShape.TransformToPolygon( backdrillPoly, via->GetMaxError(), ERROR_INSIDE );
 
            for( PCB_LAYER_ID layer : via->GetLayerSet() )
            {
                if( isLayerInBackdrillSpan( layer, tertiaryDrill.start, tertiaryDrill.end ) )
                    m_poly_holes[layer].Append( backdrillPoly );
            }
 
            // Add knockouts for silkscreen and soldermask on the backdrill side
            if( isLayerInBackdrillSpan( F_Cu, tertiaryDrill.start, tertiaryDrill.end ) )
            {
                m_poly_holes[F_SilkS].Append( backdrillPoly );
                m_poly_holes[F_Mask].Append( backdrillPoly );
            }
            if( isLayerInBackdrillSpan( B_Cu, tertiaryDrill.start, tertiaryDrill.end ) )
            {
                m_poly_holes[B_SilkS].Append( backdrillPoly );
                m_poly_holes[B_Mask].Append( backdrillPoly );
            }
        }
 
        // Process post-machining (counterbore/countersink) on front and back
        const PADSTACK::POST_MACHINING_PROPS& frontPM = padstack.FrontPostMachining();
        const PADSTACK::POST_MACHINING_PROPS& backPM = padstack.BackPostMachining();
 
        wxLogTrace( traceKiCad2Step, wxT( "VIA post-machining check: frontPM.mode.has_value=%d frontPM.size=%d frontPM.depth=%d frontPM.angle=%d" ),
                    frontPM.mode.has_value() ? 1 : 0, frontPM.size, frontPM.depth, frontPM.angle );
        wxLogTrace( traceKiCad2Step, wxT( "VIA post-machining check: backPM.mode.has_value=%d backPM.size=%d backPM.depth=%d backPM.angle=%d" ),
                    backPM.mode.has_value() ? 1 : 0, backPM.size, backPM.depth, backPM.angle );
 
        // For counterbore, depth must be > 0. For countersink, depth can be 0 (calculated from diameter/angle)
        bool frontPMValid = frontPM.mode.has_value() && frontPM.size > 0 &&
                            ( ( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE && frontPM.depth > 0 ) ||
                              ( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK && frontPM.angle > 0 ) );
 
        if( frontPMValid )
        {
            wxLogTrace( traceKiCad2Step, wxT( "VIA front post-machining: mode=%d (COUNTERBORE=2, COUNTERSINK=3)" ),
                        static_cast<int>( *frontPM.mode ) );
 
            int pmAngle = ( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK ) ? frontPM.angle : 0;
 
            if( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE )
            {
                m_pcbModel->AddCounterbore( via->GetPosition(), frontPM.size,
                                            frontPM.depth, true, aOrigin );
            }
            else if( *frontPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK )
            {
                m_pcbModel->AddCountersink( via->GetPosition(), frontPM.size,
                                            frontPM.depth, frontPM.angle, true, aOrigin );
            }
 
            // Add knockouts to all copper layers the feature crosses
            auto knockouts = m_pcbModel->GetCopperLayerKnockouts( frontPM.size, frontPM.depth,
                                                                  pmAngle, true );
            for( const auto& [layer, diameter] : knockouts )
            {
                SHAPE_POLY_SET pmPoly;
                TransformCircleToPolygon( pmPoly, via->GetPosition(), diameter / 2,
                                          via->GetMaxError(), ERROR_INSIDE );
                m_poly_holes[layer].Append( pmPoly );
            }
 
            // Add knockout for silkscreen and soldermask on front side (full diameter)
            SHAPE_POLY_SET pmPoly;
            TransformCircleToPolygon( pmPoly, via->GetPosition(), frontPM.size / 2,
                                      via->GetMaxError(), ERROR_INSIDE );
            m_poly_holes[F_SilkS].Append( pmPoly );
            m_poly_holes[F_Mask].Append( pmPoly );
        }
 
        // For counterbore, depth must be > 0. For countersink, depth can be 0 (calculated from diameter/angle)
        bool backPMValid = backPM.mode.has_value() && backPM.size > 0 &&
                           ( ( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE && backPM.depth > 0 ) ||
                             ( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK && backPM.angle > 0 ) );
 
        if( backPMValid )
        {
            wxLogTrace( traceKiCad2Step, wxT( "VIA back post-machining: mode=%d (COUNTERBORE=2, COUNTERSINK=3)" ),
                        static_cast<int>( *backPM.mode ) );
 
            int pmAngle = ( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK ) ? backPM.angle : 0;
 
            if( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE )
            {
                m_pcbModel->AddCounterbore( via->GetPosition(), backPM.size,
                                            backPM.depth, false, aOrigin );
            }
            else if( *backPM.mode == PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK )
            {
                m_pcbModel->AddCountersink( via->GetPosition(), backPM.size,
                                            backPM.depth, backPM.angle, false, aOrigin );
            }
 
            // Add knockouts to all copper layers the feature crosses
            auto knockouts = m_pcbModel->GetCopperLayerKnockouts( backPM.size, backPM.depth,
                                                                  pmAngle, false );
            for( const auto& [layer, diameter] : knockouts )
            {
                SHAPE_POLY_SET pmPoly;
                TransformCircleToPolygon( pmPoly, via->GetPosition(), diameter / 2,
                                          via->GetMaxError(), ERROR_INSIDE );
                m_poly_holes[layer].Append( pmPoly );
            }
 
            // Add knockout for silkscreen and soldermask on back side (full diameter)
            SHAPE_POLY_SET pmPoly;
            TransformCircleToPolygon( pmPoly, via->GetPosition(), backPM.size / 2,
                                      via->GetMaxError(), ERROR_INSIDE );
            m_poly_holes[B_SilkS].Append( pmPoly );
            m_poly_holes[B_Mask].Append( pmPoly );
        }
 
        return true;
    }
 
    if( skipCopper )
        return true;
 
    PCB_LAYER_ID pcblayer = aTrack->GetLayer();
 
    if( !m_layersToExport.Contains( pcblayer ) )
        return false;
 
    aTrack->TransformShapeToPolygon( m_poly_shapes[pcblayer][aTrack->GetNetname()], pcblayer, 0,
                                     aTrack->GetMaxError(), ERROR_INSIDE );
 
    return true;
}
 
 
void EXPORTER_STEP::buildZones3DShape( VECTOR2D aOrigin, bool aSolderMaskOnly )
{
    for( ZONE* zone : m_board->Zones() )
    {
        LSET layers = zone->GetLayerSet();
 
        // Filter by net if a net filter is specified and zone is on copper layer(s)
        if( ( layers & LSET::AllCuMask() ).count() && !netFilterMatches( zone->GetNetname() ) )
        {
            continue;
        }
 
        for( PCB_LAYER_ID layer : layers )
        {
            bool isMaskLayer = ( layer == F_Mask || layer == B_Mask );
 
            // If we're only processing soldermask zones, skip non-mask layers
            if( aSolderMaskOnly && !isMaskLayer )
                continue;
 
            // If we're doing full zone export, skip mask layers if they'll be handled separately
            if( !aSolderMaskOnly && isMaskLayer && !m_params.m_ExportZones )
                continue;
 
            SHAPE_POLY_SET fill_shape;
            zone->TransformSolidAreasShapesToPolygon( layer, fill_shape );
            fill_shape.Unfracture();
 
            fill_shape.SimplifyOutlines( ADVANCED_CFG::GetCfg().m_TriangulateSimplificationLevel );
 
            m_poly_shapes[layer][zone->GetNetname()].Append( fill_shape );
        }
    }
}
 
 
bool EXPORTER_STEP::buildGraphic3DShape( BOARD_ITEM* aItem, const VECTOR2D& aOrigin )
{
    PCB_LAYER_ID pcblayer = aItem->GetLayer();
    int          maxError = aItem->GetMaxError();
 
    if( !m_layersToExport.Contains( pcblayer ) )
        return false;
 
    if( IsCopperLayer( pcblayer ) && !m_params.m_ExportTracksVias )
        return false;
 
    if( IsInnerCopperLayer( pcblayer ) && !m_params.m_ExportInnerCopper )
        return false;
 
    switch( aItem->Type() )
    {
    case PCB_SHAPE_T:
    {
        PCB_SHAPE* graphic = static_cast<PCB_SHAPE*>( aItem );
 
        if( IsCopperLayer( pcblayer ) && !netFilterMatches( graphic->GetNetname() ) )
            return true;
 
        LINE_STYLE lineStyle = graphic->GetLineStyle();
 
        if( lineStyle == LINE_STYLE::SOLID )
        {
            graphic->TransformShapeToPolySet( m_poly_shapes[pcblayer][graphic->GetNetname()], pcblayer, 0,
                                              maxError, ERROR_INSIDE );
        }
        else
        {
            std::vector<SHAPE*>        shapes = graphic->MakeEffectiveShapes( true );
            const PCB_PLOT_PARAMS&     plotParams = m_board->GetPlotOptions();
            KIGFX::PCB_RENDER_SETTINGS renderSettings;
 
            renderSettings.SetDashLengthRatio( plotParams.GetDashedLineDashRatio() );
            renderSettings.SetGapLengthRatio( plotParams.GetDashedLineGapRatio() );
 
            for( SHAPE* shape : shapes )
            {
                STROKE_PARAMS::Stroke( shape, lineStyle, graphic->GetWidth(), &renderSettings,
                        [&]( const VECTOR2I& a, const VECTOR2I& b )
                        {
                            SHAPE_SEGMENT seg( a, b, graphic->GetWidth() );
                            seg.TransformToPolygon( m_poly_shapes[pcblayer][graphic->GetNetname()],
                                                    maxError, ERROR_INSIDE );
                        } );
            }
 
            for( SHAPE* shape : shapes )
                delete shape;
        }
 
        if( graphic->IsHatchedFill() )
            m_poly_shapes[pcblayer][graphic->GetNetname()].Append( graphic->GetHatching() );
 
        if( m_params.m_ExportSoldermask && graphic->IsOnLayer( F_Mask ) )
        {
            graphic->TransformShapeToPolygon( m_poly_shapes[F_Mask][wxEmptyString], F_Mask,
                                              graphic->GetSolderMaskExpansion(), maxError, ERROR_INSIDE );
        }
 
        if( m_params.m_ExportSoldermask && graphic->IsOnLayer( B_Mask ) )
        {
            graphic->TransformShapeToPolygon( m_poly_shapes[B_Mask][wxEmptyString], B_Mask,
                                              graphic->GetSolderMaskExpansion(), maxError, ERROR_INSIDE );
        }
 
        break;
    }
 
    case PCB_TEXT_T:
    {
        PCB_TEXT* text = static_cast<PCB_TEXT*>( aItem );
 
        text->TransformTextToPolySet( m_poly_shapes[pcblayer][wxEmptyString], 0, maxError, ERROR_INSIDE );
        break;
    }
 
    case PCB_BARCODE_T:
    {
        PCB_BARCODE* barcode = static_cast<PCB_BARCODE*>( aItem );
 
        barcode->TransformShapeToPolySet( m_poly_shapes[pcblayer][wxEmptyString], pcblayer, 0, maxError,
                                          ERROR_INSIDE );
        break;
    }
 
    case PCB_TEXTBOX_T:
    {
        PCB_TEXTBOX* textbox = static_cast<PCB_TEXTBOX*>( aItem );
 
        // border
        if( textbox->IsBorderEnabled() )
        {
            textbox->PCB_SHAPE::TransformShapeToPolygon( m_poly_shapes[pcblayer][wxEmptyString], pcblayer, 0,
                                                         maxError, ERROR_INSIDE );
        }
 
        // text
        textbox->TransformTextToPolySet( m_poly_shapes[pcblayer][wxEmptyString], 0, maxError, ERROR_INSIDE );
        break;
    }
 
    case PCB_TABLE_T:
    {
        PCB_TABLE* table = static_cast<PCB_TABLE*>( aItem );
 
        for( PCB_TABLECELL* cell : table->GetCells() )
        {
            cell->TransformTextToPolySet( m_poly_shapes[pcblayer][wxEmptyString], 0, maxError, ERROR_INSIDE );
        }
 
        table->DrawBorders(
                [&]( const VECTOR2I& ptA, const VECTOR2I& ptB, const STROKE_PARAMS& stroke )
                {
                    SHAPE_SEGMENT seg( ptA, ptB, stroke.GetWidth() );
                    seg.TransformToPolygon( m_poly_shapes[pcblayer][wxEmptyString], maxError, ERROR_INSIDE );
                } );
 
        break;
    }
 
    default: wxFAIL_MSG( "buildGraphic3DShape: unhandled item type" );
    }
 
    return true;
}
 
 
void EXPORTER_STEP::initOutputVariant()
{
    // Specialize the STEP_PCB_MODEL generator for specific output format
    // it can have some minor actions for the generator
    switch( m_params.m_Format )
    {
    case EXPORTER_STEP_PARAMS::FORMAT::STEP:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_STEP );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::STEPZ:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_STEPZ );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::BREP:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_BREP );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::XAO:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_XAO );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::GLB:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_GLTF );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::PLY:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_PLY );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::STL:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_STL );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::U3D:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_U3D );
        break;
 
    case EXPORTER_STEP_PARAMS::FORMAT::PDF:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_PDF );
        break;
 
    default:
        m_pcbModel->SpecializeVariant( OUTPUT_FORMAT::FMT_OUT_UNKNOWN );
        break;
    }
}
 
 
bool EXPORTER_STEP::buildBoard3DShapes()
{
    if( m_pcbModel )
        return true;
 
    SHAPE_POLY_SET pcbOutlines; // stores the board main outlines
 
    if( !m_board->GetBoardPolygonOutlines( pcbOutlines,
                                           /* infer outline if necessary */ true,
                                           /* error handler */ nullptr,
                                           /* allows use arcs in outlines */ true ) )
    {
        wxLogWarning( _( "Board outline is malformed. Run DRC for a full analysis." ) );
    }
 
    SHAPE_POLY_SET pcbOutlinesNoArcs = pcbOutlines;
    pcbOutlinesNoArcs.ClearArcs();
 
    VECTOR2D origin;
 
    // Determine the coordinate system reference:
    // Precedence of reference point is Drill Origin > Grid Origin > User Offset
    if( m_params.m_UseDrillOrigin )
        origin = m_board->GetDesignSettings().GetAuxOrigin();
    else if( m_params.m_UseGridOrigin )
        origin = m_board->GetDesignSettings().GetGridOrigin();
    else
        origin = m_params.m_Origin;
 
    m_pcbModel = std::make_unique<STEP_PCB_MODEL>( m_pcbBaseName, m_reporter );
 
    initOutputVariant();
 
    m_pcbModel->SetCopperColor( m_copperColor.r, m_copperColor.g, m_copperColor.b );
    m_pcbModel->SetPadColor( m_padColor.r, m_padColor.g, m_padColor.b );
 
    m_pcbModel->SetStackup( m_board->GetStackupOrDefault() );
    m_pcbModel->SetEnabledLayers( m_layersToExport );
    m_pcbModel->SetFuseShapes( m_params.m_FuseShapes );
    m_pcbModel->SetNetFilter( m_params.m_NetFilter );
    m_pcbModel->SetExtraPadThickness( m_params.m_ExtraPadThickness );
 
    // Note: m_params.m_BoardOutlinesChainingEpsilon is used only to build the board outlines,
    // not to set OCC chaining epsilon (much smaller)
    //
    // Set the min distance between 2 points for OCC to see these 2 points as merged
    // OCC_MAX_DISTANCE_TO_MERGE_POINTS is acceptable for OCC, otherwise there are issues
    // to handle the shapes chaining on copper layers, because the Z dist is 0.035 mm and the
    // min dist must be much smaller (we use 0.001 mm giving good results)
    m_pcbModel->OCCSetMergeMaxDistance( OCC_MAX_DISTANCE_TO_MERGE_POINTS );
 
    // For copper layers, only pads and tracks are added, because adding everything on copper
    // generate unreasonable file sizes and take a unreasonable calculation time.
    for( FOOTPRINT* fp : m_board->Footprints() )
        buildFootprint3DShapes( fp, origin, &pcbOutlinesNoArcs );
 
    for( PCB_TRACK* track : m_board->Tracks() )
        buildTrack3DShape( track, origin );
 
    for( BOARD_ITEM* item : m_board->Drawings() )
        buildGraphic3DShape( item, origin );
 
    if( m_params.m_ExportZones )
        buildZones3DShape( origin );
 
    // Process zones on soldermask layers even when copper zone export is disabled.
    // This ensures mask openings defined by zones are properly exported.
    if( m_params.m_ExportSoldermask && !m_params.m_ExportZones )
        buildZones3DShape( origin, true );
 
    for( PCB_LAYER_ID pcblayer : m_layersToExport.Seq() )
    {
        SHAPE_POLY_SET holes = m_poly_holes[pcblayer];
        holes.Simplify();
 
        if( pcblayer == F_Mask || pcblayer == B_Mask )
        {
            // Mask layer is negative
            SHAPE_POLY_SET mask = pcbOutlinesNoArcs;
 
            for( auto& [netname, poly] : m_poly_shapes[pcblayer] )
            {
                poly.Simplify();
 
                poly.SimplifyOutlines( pcbIUScale.mmToIU( 0.003 ) );
                poly.Simplify();
 
                mask.BooleanSubtract( poly );
            }
 
            mask.BooleanSubtract( holes );
 
            m_pcbModel->AddPolygonShapes( &mask, pcblayer, origin, wxEmptyString );
        }
        else
        {
            for( auto& [netname, poly] : m_poly_shapes[pcblayer] )
            {
                poly.Simplify();
 
                poly.SimplifyOutlines( pcbIUScale.mmToIU( 0.003 ) );
                poly.Simplify();
 
                // Subtract holes
                poly.BooleanSubtract( holes );
 
                // Clip to board outline
                poly.BooleanIntersection( pcbOutlinesNoArcs );
 
                m_pcbModel->AddPolygonShapes( &poly, pcblayer, origin, netname );
            }
        }
    }
 
    m_reporter->Report( wxT( "Create PCB solid model.\n" ), RPT_SEVERITY_DEBUG );
 
    m_reporter->Report( wxString::Format( wxT( "Board outline: found %d initial points.\n" ),
                                          pcbOutlines.FullPointCount() ),
                        RPT_SEVERITY_DEBUG );
 
    if( !m_pcbModel->CreatePCB( pcbOutlines, origin, m_params.m_ExportBoardBody ) )
    {
        m_reporter->Report( _( "Could not create PCB solid model.\n" ), RPT_SEVERITY_ERROR );
        return false;
    }
 
    return true;
}
 
 
bool EXPORTER_STEP::Export()
{
    // Display the export time, for statistics
    int64_t stats_startExportTime = GetRunningMicroSecs();
 
    // setup opencascade message log
    struct SCOPED_PRINTER
    {
        Handle( Message_Printer ) m_handle;
 
        SCOPED_PRINTER( const Handle( Message_Printer ) & aHandle ) : m_handle( aHandle )
        {
            Message::DefaultMessenger()->AddPrinter( m_handle );
        };
 
        ~SCOPED_PRINTER() { Message::DefaultMessenger()->RemovePrinter( m_handle ); }
    };
 
    Message::DefaultMessenger()->RemovePrinters( STANDARD_TYPE( Message_PrinterOStream ) );
    SCOPED_PRINTER occtPrinter( new KICAD_PRINTER( m_reporter ) );
 
    m_reporter->Report( wxT( "Determining PCB data.\n" ), RPT_SEVERITY_DEBUG );
 
    if( m_params.m_OutputFile.IsEmpty() )
    {
        wxFileName fn = m_board->GetFileName();
        fn.SetName( fn.GetName() );
        fn.SetExt( m_params.GetDefaultExportExtension() );
 
        m_params.m_OutputFile = fn.GetFullName();
    }
 
    m_layersToExport = LSET::ExternalCuMask();
 
    if( m_params.m_ExportInnerCopper )
        m_layersToExport |= LSET::InternalCuMask();
 
    if( m_params.m_ExportSilkscreen )
    {
        m_layersToExport.set( F_SilkS );
        m_layersToExport.set( B_SilkS );
    }
 
    if( m_params.m_ExportSoldermask )
    {
        m_layersToExport.set( F_Mask );
        m_layersToExport.set( B_Mask );
    }
 
    m_layersToExport &= m_board->GetEnabledLayers();
 
    try
    {
        m_reporter->Report( wxString::Format( wxT( "Build %s data.\n" ), m_params.GetFormatName() ),
                            RPT_SEVERITY_DEBUG );
 
        if( !buildBoard3DShapes() )
        {
            m_reporter->Report( _( "\n"
                                   "** Error building STEP board model. Export aborted. **\n" ),
                                RPT_SEVERITY_ERROR );
            return false;
        }
 
        m_reporter->Report( wxString::Format( wxT( "Writing %s file.\n" ), m_params.GetFormatName() ),
                            RPT_SEVERITY_DEBUG );
 
        bool success = true;
        if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::STEP )
            success = m_pcbModel->WriteSTEP( m_outputFile, m_params.m_OptimizeStep, false );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::STEPZ )
            success = m_pcbModel->WriteSTEP( m_outputFile, m_params.m_OptimizeStep, true );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::BREP )
            success = m_pcbModel->WriteBREP( m_outputFile );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::XAO )
            success = m_pcbModel->WriteXAO( m_outputFile );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::GLB )
            success = m_pcbModel->WriteGLTF( m_outputFile );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::PLY )
            success = m_pcbModel->WritePLY( m_outputFile );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::STL )
            success = m_pcbModel->WriteSTL( m_outputFile );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::U3D )
            success = m_pcbModel->WriteU3D( m_outputFile );
        else if( m_params.m_Format == EXPORTER_STEP_PARAMS::FORMAT::PDF )
            success = m_pcbModel->WritePDF( m_outputFile );
 
        if( !success )
        {
            m_reporter->Report( wxString::Format( _( "\n"
                                                     "** Error writing %s file. **\n" ),
                                                  m_params.GetFormatName() ),
                                RPT_SEVERITY_ERROR );
            return false;
        }
        else
        {
            m_reporter->Report( wxString::Format( wxT( "%s file '%s' created.\n" ),
                                                  m_params.GetFormatName(),
                                                  m_outputFile ),
                                RPT_SEVERITY_ACTION );
        }
    }
    catch( const std::bad_alloc& )
    {
        m_reporter->Report( wxString::Format( _( "\n** Out of memory while exporting %s file. **\n"
                                                 "The board may have too many objects (e.g., vias, tracks, components) "
                                                 "to process with available system memory.\n"
                                                 "Try disabling 'Fuse Shapes' option, reducing board complexity, "
                                                 "or freeing up system memory.\n" ),
                                              m_params.GetFormatName() ),
                            RPT_SEVERITY_ERROR );
        return false;
    }
    catch( const Standard_Failure& e )
    {
        wxString errorMsg = e.GetMessageString();
        m_reporter->Report( wxString::Format( _( "\nOpenCASCADE error: %s\n" ), errorMsg ),
                            RPT_SEVERITY_ERROR );
 
        // Check if this might be memory-related based on common OCC error patterns
        if( errorMsg.Contains( "alloc" ) || errorMsg.Contains( "memory" ) ||
            errorMsg.IsEmpty() )
        {
            m_reporter->Report( _( "This error may indicate insufficient memory. Consider disabling "
                                   "'Fuse Shapes', reducing the number of vias/components, or freeing "
                                   "system memory.\n" ),
                                RPT_SEVERITY_INFO );
        }
 
        m_reporter->Report( wxString::Format( _( "** Error exporting %s file. Export aborted. **\n" ),
                                              m_params.GetFormatName() ),
                            RPT_SEVERITY_ERROR );
        return false;
    }
    #ifndef DEBUG
    catch( ... )
    {
        m_reporter->Report( wxString::Format( _( "\n** Unexpected error while exporting %s file. **\n"
                                                 "This may be caused by insufficient system memory, especially "
                                                 "when exporting boards with many vias or components with 'Fuse Shapes' enabled.\n"
                                                 "Try disabling 'Fuse Shapes', reducing board complexity, "
                                                 "or freeing up system memory.\n" ),
                                              m_params.GetFormatName() ),
                            RPT_SEVERITY_ERROR );
        return false;
    }
    #endif
 
    // Display calculation time in seconds
    double calculation_time = (double)( GetRunningMicroSecs() - stats_startExportTime) / 1e6;
    m_reporter->Report( wxString::Format( _( "\n"
                                             "Export time %.3f s\n" ),
                                          calculation_time ),
                        RPT_SEVERITY_INFO );
 
    return !m_reporter->HasMessageOfSeverity( RPT_SEVERITY_ERROR );
}