component_class_settings.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 <http://www.gnu.org/licenses/>.
 */
 
#ifndef PROJECT_COMPONENT_CLASS_SETTINGS_H
#define PROJECT_COMPONENT_CLASS_SETTINGS_H
 
#include <vector>
#include <unordered_map>
 
#include <settings/nested_settings.h>
 
 
class KICOMMON_API COMPONENT_CLASS_ASSIGNMENT_DATA
{
public:
    enum class CONDITION_TYPE
    {
        REFERENCE,
        FOOTPRINT,
        SIDE,
        ROTATION,
        FOOTPRINT_FIELD,
        CUSTOM,
        SHEET_NAME
    };

    enum class CONDITIONS_OPERATOR
    {
        ALL,
        ANY
    };

    void SetCondition( const CONDITION_TYPE aCondition, const wxString& aPrimaryData,
                       const wxString& aSecondaryData )
    {
        m_conditions[aCondition] = { aPrimaryData, aSecondaryData };
    }

    const std::unordered_map<CONDITION_TYPE, std::pair<wxString, wxString>>& GetConditions() const
    {
        return m_conditions;
    }

    void SetComponentClass( const wxString& aComponentClass )
    {
        m_componentClass = aComponentClass;
    }

    const wxString& GetComponentClass() const { return m_componentClass; }

    void SetConditionsOperation( const CONDITIONS_OPERATOR aOperator )
    {
        m_conditionsOperator = aOperator;
    }

    CONDITIONS_OPERATOR GetConditionsOperator() const { return m_conditionsOperator; }

    static wxString GetConditionName( const CONDITION_TYPE aCondition );

    static CONDITION_TYPE GetConditionType( const wxString& aCondition );

    wxString GetAssignmentInDRCLanguage() const;
 
protected:
    wxString m_componentClass;

    std::unordered_map<CONDITION_TYPE, std::pair<wxString, wxString>> m_conditions;

    CONDITIONS_OPERATOR m_conditionsOperator{ CONDITIONS_OPERATOR::ALL };
};
 

class KICOMMON_API COMPONENT_CLASS_SETTINGS : public NESTED_SETTINGS
{
public:
    COMPONENT_CLASS_SETTINGS( JSON_SETTINGS* aParent, const std::string& aPath );
 
    virtual ~COMPONENT_CLASS_SETTINGS();

    void SetEnableSheetComponentClasses( bool aEnabled )
    {
        m_enableSheetComponentClasses = aEnabled;
    }

    bool GetEnableSheetComponentClasses() const { return m_enableSheetComponentClasses; }

    void ClearComponentClassAssignments() { m_componentClassAssignments.clear(); }

    const std::vector<COMPONENT_CLASS_ASSIGNMENT_DATA>& GetComponentClassAssignments() const
    {
        return m_componentClassAssignments;
    }
 
    // Adds a dynamic component class assignment
    void AddComponentClassAssignment( const COMPONENT_CLASS_ASSIGNMENT_DATA& aAssignment )
    {
        m_componentClassAssignments.push_back( aAssignment );
    }
 
    bool operator==( const COMPONENT_CLASS_SETTINGS& aOther ) const;
 
    bool operator!=( const COMPONENT_CLASS_SETTINGS& aOther ) const
    {
        return !operator==( aOther );
    }
 
private:
    bool m_enableSheetComponentClasses;

    std::vector<COMPONENT_CLASS_ASSIGNMENT_DATA> m_componentClassAssignments;

    static nlohmann::json saveAssignment( const COMPONENT_CLASS_ASSIGNMENT_DATA& aAssignment );

    static COMPONENT_CLASS_ASSIGNMENT_DATA loadAssignment( const nlohmann::json& aJson );
};
 
#endif // PROJECT_COMPONENT_CLASS_SETTINGS_H