File: transline_ident.h

package info (click to toggle)
kicad 9.0.3%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 770,320 kB
  • sloc: cpp: 961,692; ansic: 121,001; xml: 66,428; python: 18,387; sh: 1,010; awk: 301; asm: 292; makefile: 227; javascript: 167; perl: 10
file content (143 lines) | stat: -rw-r--r-- 4,829 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2011-2014 Jean-Pierre Charras
 * 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/>.
 */

/**
 * @file transline_ident.h
 */

#ifndef TRANSLINE_IDENT_H
#define TRANSLINE_IDENT_H

#include <vector>

#include "transline/transline.h"

// Forward declare the bitmaps enum from bitmaps/bitmap_list.h
enum class BITMAPS : unsigned int;

// An enum to handle muwave shapes:
enum TRANSLINE_TYPE_ID {
    START_OF_LIST_TYPE = 0,
    DEFAULT_TYPE = START_OF_LIST_TYPE,
    MICROSTRIP_TYPE = DEFAULT_TYPE,
    CPW_TYPE,
    GROUNDED_CPW_TYPE,
    RECTWAVEGUIDE_TYPE,
    COAX_TYPE,
    C_MICROSTRIP_TYPE,
    STRIPLINE_TYPE,
    TWISTEDPAIR_TYPE,
    END_OF_LIST_TYPE
};

// A Class to handle parameters
enum PRM_TYPE {
    PRM_TYPE_SUBS,
    PRM_TYPE_PHYS,
    PRM_TYPE_ELEC,
    PRM_TYPE_FREQUENCY
};


/**
 * A class to handle one parameter of transline.
 */
class TRANSLINE_PRM
{
public:
    /**
     * @param aKeywordCfg is the keyword used in config to identify the parameter
     *                    only ASCII7 keyword is valid.
     * @param aDlgLabel is a I18n string used to identify the parameter in dialog.
     *                  usually aDlgLabel is same as aKeywordCfg, but translatable.
     */
    TRANSLINE_PRM( PRM_TYPE aType, PRMS_ID aId, const char* aKeywordCfg = "", const wxString& aDlgLabel = wxEmptyString,
                   const wxString& aToolTip = wxEmptyString, double aValue = 0.0, bool aConvUnit = false,
                   int aDefaultUnit = 0 );

    double ToUserUnit();
    double FromUserUnit();

    PRM_TYPE    m_Type;            // Type of parameter: substr, physical, elect
    PRMS_ID     m_Id;              // Id of parameter ( link to transline functions )
    std::string m_KeyWord;         // keyword for this parameter in json config file in ASCII7 only
    wxString    m_DlgLabel;        // name for this parameter in dialog (usually translated
    wxString    m_ToolTip;         // Tool tip for this parameter in dialog
    double      m_Value;           // Value for this parameter in dialog
    double      m_DefaultValue;    // Default value for this parameter from CTOR build
    int         m_DefaultUnit;     // Default unit selection for this parameter
    double      m_NormalizedValue; // actual value for this parameter
    bool        m_ConvUnit;        // true if an unit selector must be used
    void*       m_ValueCtrl;       // The text ctrl containing the value in dialog
    void*       m_UnitCtrl;        // The UNIT_SELECTOR containing the unit in dialog
    int         m_UnitSelection;   // last selection for units
};


/**
 * A class to handle a list of parameters of a given transline.
 *
 * @note The first string of TRANSLINE_PRM (m_KeyWord) is a keyword in config file.
 *       It can contain only ASCII7 chars.  The second string of TRANSLINE_PRM is a
 *       string translated for dialog so mark it for translation.  Do not mark translatable
 *       m_DlgLabel that obviously cannot be translated, like "H" or "H_t".
 */
class TRANSLINE_IDENT
{
public:
    TRANSLINE_IDENT( enum TRANSLINE_TYPE_ID aType );
    ~TRANSLINE_IDENT();

    // Add a new param in list
    void AddPrm( TRANSLINE_PRM* aParam )
    {
        m_prms_List.push_back( aParam );
    }

    TRANSLINE_PRM* GetPrm( unsigned aIdx ) const
    {
        if( aIdx < m_prms_List.size() )
            return m_prms_List[aIdx];
        else
            return nullptr;
    }

    unsigned GetPrmsCount() const
    {
        return m_prms_List.size();
    }

    void ReadConfig();
    void WriteConfig();

public:
    enum TRANSLINE_TYPE_ID m_Type;              // The type of transline handled
    BITMAPS                m_BitmapName;        // The name of the bitmap to display in dialogs
    TRANSLINE*             m_TLine;             // The TRANSLINE itself
    wxArrayString          m_Messages;          // messages for results

    // true if selection of parameters must be enabled in dialog menu.
    bool m_HasPrmSelection;

private:
    std::vector<TRANSLINE_PRM*> m_prms_List;
};

#endif      //  TRANSLINE_IDENT_H