stackup_predefined_prms.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2019 Jean-Pierre Charras, jp.charras at wanadoo.fr
 * Copyright (C) 2009-2021 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
 */
 
#ifndef STACKUP_PREDEFINED_PRMS_H
#define STACKUP_PREDEFINED_PRMS_H
 
 
#include <wx/string.h>
#include <wx/arrstr.h>
#include <wx/colour.h>
 
#include <layer_ids.h>
#include <i18n_utility.h> // For _HKI definition
#include <gal/color4d.h>
 
#include <board_stackup_manager/board_stackup.h>
 
// Keyword used in file to identify the dielectric layer type
#define KEY_CORE wxT( "core" )
#define KEY_PREPREG wxT( "prepreg" )
 
#define KEY_COPPER wxT( "copper" )
 
// key string used for not specified parameters
// Can be translated in dialogs, and is also a keyword outside dialogs
wxString inline NotSpecifiedPrm()
{
 return _HKI( "Not specified" );
}
 
bool IsPrmSpecified( const wxString& aPrmValue );
 
#define DEFAULT_SOLDERMASK_OPACITY 0.83
 
// A reasonable Epsilon R value for solder mask dielectric
#define DEFAULT_EPSILON_R_SOLDERMASK 3.3
 
// A default Epsilon R value for silkscreen dielectric
#define DEFAULT_EPSILON_R_SILKSCREEN 1.0
 
// A minor struct to handle color in gerber job file and dialog
class FAB_LAYER_COLOR
{
public:
 FAB_LAYER_COLOR()
 {}
 
 FAB_LAYER_COLOR( const wxString& aColorName, const wxColor& aColor ) :
  m_colorName( aColorName ),
 m_color( aColor )
 {}
 
 const wxString& GetName() const
 {
 return m_colorName;
 }
 
 KIGFX::COLOR4D GetColor( BOARD_STACKUP_ITEM_TYPE aItemType ) const
 {
 if( aItemType == BS_ITEM_TYPE_SOLDERMASK )
 return m_color.WithAlpha( DEFAULT_SOLDERMASK_OPACITY );
 else
 return m_color.WithAlpha( 1.0 );
 }
 
 const wxString GetColorAsString() const;
 
private:
 wxString m_colorName; // the name (in job file) of the color
 // User values are the HTML encoded "#rrggbbaa"
 // RGB hexa value.
 KIGFX::COLOR4D m_color;
};
 
 
wxArrayString GetStandardCopperFinishes( bool aTranslate );
 
const std::vector<FAB_LAYER_COLOR>& GetStandardColors( BOARD_STACKUP_ITEM_TYPE aType );
 
int GetColorUserDefinedListIdx( BOARD_STACKUP_ITEM_TYPE aType );
 
inline KIGFX::COLOR4D GetDefaultUserColor( BOARD_STACKUP_ITEM_TYPE aType )
{
 return GetStandardColors( aType )[GetColorUserDefinedListIdx( aType )].GetColor( aType );
}
 
inline KIGFX::COLOR4D GetStandardColor( BOARD_STACKUP_ITEM_TYPE aType, int aIdx )
{
 return GetStandardColors( aType )[ aIdx ].GetColor( aType );
}
 
inline const wxString& GetStandardColorName( BOARD_STACKUP_ITEM_TYPE aType, int aIdx )
{
 return GetStandardColors( aType )[ aIdx ].GetName();
}
 
inline bool IsCustomColorIdx( BOARD_STACKUP_ITEM_TYPE aType, int aIdx )
{
 return aIdx == GetColorUserDefinedListIdx( aType );
}
 
bool IsColorNameNormalized( const wxString& aName );
 
 
#endif // #ifndef STACKUP_PREDEFINED_PRMS_H