KiCad PCB EDA Suite
pin_type.h File Reference
#include <wx/arrstr.h>
#include <bitmaps.h>
#include <vector>

Go to the source code of this file.

Macros

#define ELECTRICAL_PINTYPES_TOTAL   ( static_cast<int>( ELECTRICAL_PINTYPE::PT_LAST_OPTION ) + 1 )
 
#define GRAPHIC_PINSHAPES_TOTAL   ( static_cast<int>( GRAPHIC_PINSHAPE::LAST_OPTION ) + 1 )
 

Enumerations

enum  ELECTRICAL_PINTYPE {
  ELECTRICAL_PINTYPE::PT_INPUT, ELECTRICAL_PINTYPE::PT_OUTPUT, ELECTRICAL_PINTYPE::PT_BIDI, ELECTRICAL_PINTYPE::PT_TRISTATE,
  ELECTRICAL_PINTYPE::PT_PASSIVE, ELECTRICAL_PINTYPE::PT_UNSPECIFIED, ELECTRICAL_PINTYPE::PT_POWER_IN, ELECTRICAL_PINTYPE::PT_POWER_OUT,
  ELECTRICAL_PINTYPE::PT_OPENCOLLECTOR, ELECTRICAL_PINTYPE::PT_OPENEMITTER, ELECTRICAL_PINTYPE::PT_NC, ELECTRICAL_PINTYPE::PT_LAST_OPTION = PT_NC
}
 The component library pin object electrical types used in ERC tests. More...
 
enum  GRAPHIC_PINSHAPE {
  GRAPHIC_PINSHAPE::LINE, GRAPHIC_PINSHAPE::INVERTED, GRAPHIC_PINSHAPE::CLOCK, GRAPHIC_PINSHAPE::INVERTED_CLOCK,
  GRAPHIC_PINSHAPE::INPUT_LOW, GRAPHIC_PINSHAPE::CLOCK_LOW, GRAPHIC_PINSHAPE::OUTPUT_LOW, GRAPHIC_PINSHAPE::FALLING_EDGE_CLOCK,
  GRAPHIC_PINSHAPE::NONLOGIC, GRAPHIC_PINSHAPE::LAST_OPTION = NONLOGIC
}
 

Functions

wxString PinShapeGetText (GRAPHIC_PINSHAPE shape)
 
BITMAP_DEF PinShapeGetBitmap (GRAPHIC_PINSHAPE shape)
 
wxString ElectricalPinTypeGetText (ELECTRICAL_PINTYPE)
 
BITMAP_DEF ElectricalPinTypeGetBitmap (ELECTRICAL_PINTYPE)
 
wxString PinOrientationName (unsigned aPinOrientationCode)
 
int PinOrientationCode (int index)
 
int PinOrientationIndex (int code)
 
const wxArrayString & PinTypeNames ()
 
const std::vector< BITMAP_DEF > & PinTypeIcons ()
 
const wxArrayString & PinShapeNames ()
 
const std::vector< BITMAP_DEF > & PinShapeIcons ()
 
const wxArrayString & PinOrientationNames ()
 
const std::vector< BITMAP_DEF > & PinOrientationIcons ()
 

Macro Definition Documentation

◆ ELECTRICAL_PINTYPES_TOTAL

#define ELECTRICAL_PINTYPES_TOTAL   ( static_cast<int>( ELECTRICAL_PINTYPE::PT_LAST_OPTION ) + 1 )

Definition at line 51 of file pin_type.h.

◆ GRAPHIC_PINSHAPES_TOTAL

#define GRAPHIC_PINSHAPES_TOTAL   ( static_cast<int>( GRAPHIC_PINSHAPE::LAST_OPTION ) + 1 )

Definition at line 68 of file pin_type.h.

Enumeration Type Documentation

◆ ELECTRICAL_PINTYPE

enum ELECTRICAL_PINTYPE
strong

The component library pin object electrical types used in ERC tests.

Enumerator
PT_INPUT 

usual pin input: must be connected

PT_OUTPUT 

usual output

PT_BIDI 

input or output (like port for a microprocessor)

PT_TRISTATE 

tris state bus pin

PT_PASSIVE 

pin for passive components: must be connected, and can be connected to any pin

PT_UNSPECIFIED 

unknown electrical properties: creates always a warning when connected

PT_POWER_IN 

power input (GND, VCC for ICs). Must be connected to a power output.

PT_POWER_OUT 

output of a regulator: intended to be connected to power input pins

PT_OPENCOLLECTOR 

pin type open collector

PT_OPENEMITTER 

pin type open emitter

PT_NC 

not connected (must be left open)

PT_LAST_OPTION 

sentinel value, set to last usable enum option

Definition at line 34 of file pin_type.h.

35 {
36  PT_INPUT,
37  PT_OUTPUT,
38  PT_BIDI,
39  PT_TRISTATE,
40  PT_PASSIVE,
42  PT_POWER_IN,
43  PT_POWER_OUT,
46  PT_NC,
47 
49 };
power input (GND, VCC for ICs). Must be connected to a power output.
pin for passive components: must be connected, and can be connected to any pin
unknown electrical properties: creates always a warning when connected
sentinel value, set to last usable enum option
usual pin input: must be connected
input or output (like port for a microprocessor)
not connected (must be left open)
output of a regulator: intended to be connected to power input pins

◆ GRAPHIC_PINSHAPE

enum GRAPHIC_PINSHAPE
strong
Enumerator
LINE 
INVERTED 
CLOCK 
INVERTED_CLOCK 
INPUT_LOW 
CLOCK_LOW 
OUTPUT_LOW 
FALLING_EDGE_CLOCK 
NONLOGIC 
LAST_OPTION 

this is the sentinel value, must be set to last enum value

Definition at line 53 of file pin_type.h.

Function Documentation

◆ ElectricalPinTypeGetBitmap()

BITMAP_DEF ElectricalPinTypeGetBitmap ( ELECTRICAL_PINTYPE  )

Definition at line 250 of file pin_type.cpp.

251 {
252  auto findIt = pinTypes.find( aType );
253 
254  wxCHECK_MSG( findIt != pinTypes.end(), nullptr, "Could not find pin type in lookup map" );
255 
256  return findIt->second.bitmap;
257 }
const std::map< ELECTRICAL_PINTYPE, struct pinTypeStruct > pinTypes
Definition: pin_type.cpp:52

References pinTypes.

Referenced by LIB_PIN::GetMenuImage(), InitTables(), and PinTypeComboBox::PinTypeComboBox().

◆ ElectricalPinTypeGetText()

wxString ElectricalPinTypeGetText ( ELECTRICAL_PINTYPE  )

Definition at line 240 of file pin_type.cpp.

241 {
242  auto findIt = pinTypes.find( aType );
243 
244  wxCHECK_MSG( findIt != pinTypes.end(), wxT( "???" ), "Could not find pin type in lookup map" );
245 
246  return findIt->second.name;
247 }
const std::map< ELECTRICAL_PINTYPE, struct pinTypeStruct > pinTypes
Definition: pin_type.cpp:52

References pinTypes.

Referenced by LIB_PIN::GetElectricalTypeName(), SCH_PIN::GetMsgPanelInfo(), LIB_PIN::GetMsgPanelInfo(), InitTables(), PinTypeComboBox::PinTypeComboBox(), and ERC_TESTER::TestPinToPin().

◆ PinOrientationCode()

int PinOrientationCode ( int  index)

Definition at line 141 of file pin_type.cpp.

142 {
143  if( index >= 0 && index < (int) PIN_ORIENTATION_CNT )
144  return pin_orientation_codes[ index ];
145 
146  return PIN_RIGHT;
147 }
#define PIN_ORIENTATION_CNT
Definition: pin_type.cpp:112
static const int pin_orientation_codes[]
Definition: pin_type.cpp:92

References PIN_ORIENTATION_CNT, pin_orientation_codes, and PIN_RIGHT.

Referenced by DIALOG_PIN_PROPERTIES::OnPropertiesChange(), PIN_TABLE_DATA_MODEL::SetValue(), and DIALOG_PIN_PROPERTIES::TransferDataFromWindow().

◆ PinOrientationIcons()

const std::vector<BITMAP_DEF>& PinOrientationIcons ( )

Definition at line 231 of file pin_type.cpp.

232 {
233  if( g_orientationIcons.empty() )
234  InitTables();
235 
236  return g_orientationIcons;
237 }
void InitTables()
Definition: pin_type.cpp:164
static std::vector< BITMAP_DEF > g_orientationIcons
Definition: pin_type.cpp:38

References g_orientationIcons, and InitTables().

Referenced by DIALOG_LIB_EDIT_PIN_TABLE::DIALOG_LIB_EDIT_PIN_TABLE(), and DIALOG_PIN_PROPERTIES::DIALOG_PIN_PROPERTIES().

◆ PinOrientationIndex()

int PinOrientationIndex ( int  code)

Definition at line 150 of file pin_type.cpp.

151 {
152  size_t i;
153 
154  for( i = 0; i < PIN_ORIENTATION_CNT; i++ )
155  {
156  if( pin_orientation_codes[i] == code )
157  return (int) i;
158  }
159 
160  return wxNOT_FOUND;
161 }
#define PIN_ORIENTATION_CNT
Definition: pin_type.cpp:112
static const int pin_orientation_codes[]
Definition: pin_type.cpp:92

References PIN_ORIENTATION_CNT, and pin_orientation_codes.

Referenced by SCH_PIN::GetMsgPanelInfo(), LIB_PIN::GetMsgPanelInfo(), PIN_TABLE_DATA_MODEL::GetValue(), and DIALOG_PIN_PROPERTIES::TransferDataToWindow().

◆ PinOrientationName()

wxString PinOrientationName ( unsigned  aPinOrientationCode)

Definition at line 119 of file pin_type.cpp.

120 {
121  /* Note: The following name lists are sentence capitalized per the GNOME UI
122  * standards for list controls. Please do not change the capitalization
123  * of these strings unless the GNOME UI standards are changed.
124  */
125  const wxString pin_orientation_names[] =
126  {
127  _( "Right" ),
128  _( "Left" ),
129  _( "Up" ),
130  _( "Down" ),
131  wxT( "???" )
132  };
133 
134  if( aPinOrientationCode > PIN_ORIENTATION_CNT )
135  aPinOrientationCode = PIN_ORIENTATION_CNT;
136 
137  return pin_orientation_names[ aPinOrientationCode ];
138 }
#define PIN_ORIENTATION_CNT
Definition: pin_type.cpp:112
#define _(s)
Definition: 3d_actions.cpp:33

References _, and PIN_ORIENTATION_CNT.

Referenced by SCH_PIN::GetMsgPanelInfo(), LIB_PIN::GetMsgPanelInfo(), and InitTables().

◆ PinOrientationNames()

const wxArrayString& PinOrientationNames ( )

Definition at line 222 of file pin_type.cpp.

223 {
224  if( g_orientationNames.empty() )
225  InitTables();
226 
227  return g_orientationNames;
228 }
void InitTables()
Definition: pin_type.cpp:164
static wxArrayString g_orientationNames
Definition: pin_type.cpp:39

References g_orientationNames, and InitTables().

Referenced by DIALOG_LIB_EDIT_PIN_TABLE::DIALOG_LIB_EDIT_PIN_TABLE(), DIALOG_PIN_PROPERTIES::DIALOG_PIN_PROPERTIES(), PIN_TABLE_DATA_MODEL::GetValue(), and PIN_TABLE_DATA_MODEL::SetValue().

◆ PinShapeGetBitmap()

BITMAP_DEF PinShapeGetBitmap ( GRAPHIC_PINSHAPE  shape)

Definition at line 270 of file pin_type.cpp.

271 {
272  auto findIt = pinShapes.find( aShape );
273 
274  wxCHECK_MSG( findIt != pinShapes.end(), nullptr, "Could not find pinshape in lookup map" );
275 
276  return findIt->second.bitmap;
277 }
const std::map< GRAPHIC_PINSHAPE, struct pinShapeStruct > pinShapes
Definition: pin_type.cpp:78

References pinShapes.

Referenced by InitTables(), and PinShapeComboBox::PinShapeComboBox().

◆ PinShapeGetText()

wxString PinShapeGetText ( GRAPHIC_PINSHAPE  shape)

Definition at line 260 of file pin_type.cpp.

261 {
262  auto findIt = pinShapes.find( aShape );
263 
264  wxCHECK_MSG( findIt != pinShapes.end(), wxT( "?" ), "Could not find pinshape in lookup map" );
265 
266  return findIt->second.name;
267 }
const std::map< GRAPHIC_PINSHAPE, struct pinShapeStruct > pinShapes
Definition: pin_type.cpp:78

References pinShapes.

Referenced by SCH_PIN::GetMsgPanelInfo(), LIB_PIN::GetMsgPanelInfo(), LIB_PIN::GetSelectMenuText(), InitTables(), and PinShapeComboBox::PinShapeComboBox().

◆ PinShapeIcons()

const std::vector<BITMAP_DEF>& PinShapeIcons ( )

Definition at line 213 of file pin_type.cpp.

214 {
215  if( g_shapeIcons.empty() )
216  InitTables();
217 
218  return g_shapeIcons;
219 }
void InitTables()
Definition: pin_type.cpp:164
static std::vector< BITMAP_DEF > g_shapeIcons
Definition: pin_type.cpp:35

References g_shapeIcons, and InitTables().

Referenced by SCH_PIN_TABLE_DATA_MODEL::BuildAttrs(), DIALOG_LIB_EDIT_PIN_TABLE::DIALOG_LIB_EDIT_PIN_TABLE(), and DIALOG_PIN_PROPERTIES::DIALOG_PIN_PROPERTIES().

◆ PinShapeNames()

◆ PinTypeIcons()

const std::vector<BITMAP_DEF>& PinTypeIcons ( )

Definition at line 195 of file pin_type.cpp.

196 {
197  if( g_typeIcons.empty() )
198  InitTables();
199 
200  return g_typeIcons;
201 }
void InitTables()
Definition: pin_type.cpp:164
static std::vector< BITMAP_DEF > g_typeIcons
Definition: pin_type.cpp:32

References g_typeIcons, and InitTables().

Referenced by SCH_PIN_TABLE_DATA_MODEL::BuildAttrs(), DIALOG_LIB_EDIT_PIN_TABLE::DIALOG_LIB_EDIT_PIN_TABLE(), and DIALOG_PIN_PROPERTIES::DIALOG_PIN_PROPERTIES().

◆ PinTypeNames()