fab_sections.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * 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 3 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/>.
 */
 
#ifndef FAB_SECTIONS_H
#define FAB_SECTIONS_H
 
#include <bitset>
#include <initializer_list>
#include <optional>
#include <wx/string.h>
 
#include <jobs/job_export_pcb_fab.h>
 
namespace FAB
{

enum class SECTION
{
    PADSTACKS,          
    BOM_AVL,            
    PACKAGES,           
    COMPONENTS,         
    STACKUP,            
    PROFILE,            
    SOLDERMASK,         
    SOLDERPASTE,        
    SILKSCREEN,         
    DRILL_ROUT,         
    DOCUMENTATION,      
    OUTER_COPPER,       
    INNER_COPPER,       
    DIELECTRIC,         
    MISC_FAB,           
    LOGICAL_NET,        
    PHYSICAL_NET,       
    DFX,                
 
    COUNT
};

using MODE = JOB_EXPORT_PCB_FAB::DATA_SET;

enum class SECTION_RULE
{
    EXCLUDED,
    RULE_OPTIONAL,
    REQUIRED
};

class SECTION_SET : public std::bitset<static_cast<size_t>( SECTION::COUNT )>
{
public:
    using BASE = std::bitset<static_cast<size_t>( SECTION::COUNT )>;
 
    SECTION_SET() = default;
 
    // The inherited bitset operators return BASE and this converts the result back
    SECTION_SET( const BASE& aBits ) : BASE( aBits ) {}
 
    SECTION_SET( std::initializer_list<SECTION> aSections )
    {
        for( SECTION section : aSections )
            Set( section );
    }
 
    bool Contains( SECTION aSection ) const { return test( static_cast<size_t>( aSection ) ); }
 
    SECTION_SET& Set( SECTION aSection, bool aOn = true )
    {
        set( static_cast<size_t>( aSection ), aOn );
        return *this;
    }
};

char SectionKeyChar( SECTION aSection );

std::optional<SECTION> SectionFromKeyChar( char aKey );

SECTION_RULE SectionRule( MODE aMode, SECTION aSection );

SECTION_SET RequiredSections( MODE aMode );

SECTION_SET OptionalSections( MODE aMode );

SECTION_SET RecommendedOptionalSections( MODE aMode );

SECTION_SET UnsupportedSections();

SECTION_SET LegacySections();

bool NeedsCadData( const SECTION_SET& aSet );

wxString SectionKeyString( const SECTION_SET& aSet );

bool SectionSetFromKeyString( const wxString& aKey, SECTION_SET& aResult );

wxString ModeToken( MODE aMode );

std::optional<MODE> ModeFromToken( const wxString& aToken );
 
} // namespace FAB
 
#endif