KiCad PCB EDA Suite
Loading...
Searching...
No Matches
eda_item_flags.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2013-2015 Jean-Pierre Charras, jp.charras at wanadoo.fr
5 * Copyright (C) 2008-2015 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
6 * Copyright (C) 2008 Wayne Stambaugh <[email protected]>
7 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
8 *
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * as published by the Free Software Foundation; either version 2
12 * of the License, or (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program. If not, see <https://www.gnu.org/licenses/>.
21 */
22
23#ifndef EDA_ITEM_FLAGS_H
24#define EDA_ITEM_FLAGS_H
25
26#include <cstdint>
27
28// These define are used for the .m_flags member of the class EDA_ITEM
29//
30// NB: DO NOT ADD FLAGS ANYWHERE BUT AT THE END: THE FLAG-SET IS STORED AS AN INTEGER IN FILES.
31//
32#define IS_CHANGED (1UL << 0)
33#define IS_LINKED (1UL << 1)
34#define IN_EDIT (1UL << 2)
35#define IS_MOVING (1UL << 3)
36#define IS_NEW (1UL << 4)
37#define IS_BROKEN (1UL << 5)
38
39#define IS_DELETED (1UL << 7)
40
41#define STARTPOINT (1UL << 9)
42#define ENDPOINT (1UL << 10)
43#define SELECTED (1UL << 11)
44#define SELECTED_BY_DRAG (1UL << 12)
45#define STRUCT_DELETED (1UL << 13)
46#define CANDIDATE (1UL << 14)
47#define SKIP_STRUCT (1UL << 15)
48
49#define IS_PASTED (1UL << 17)
50#define IS_SHOWN_AS_BITMAP (1UL << 18)
51#define COURTYARD_CONFLICT (1UL << 19)
53#define MALFORMED_F_COURTYARD (1UL << 20)
54#define MALFORMED_B_COURTYARD (1UL << 21)
55#define MALFORMED_COURTYARDS ( MALFORMED_F_COURTYARD | MALFORMED_B_COURTYARD )
56
57#define ROUTER_TRANSIENT (1UL << 22)
58
59#define CONNECTIVITY_CANDIDATE (1UL << 23)
60
61#define HOLE_PROXY (1UL << 24)
62#define SHOW_ELEC_TYPE (1UL << 25)
63#define BRIGHTENED (1UL << 26)
64
65#define MCT_SKIP_STRUCT (1 << 27)
66
67#define UR_TRANSIENT (1UL << 28)
68
69#define IS_DANGLING (1UL << 29)
70#define ENTERED (1UL << 30)
71#define SELECTION_CANDIDATE (1UL << 31)
72
73// WARNING: if you add flags, you'll probably need to adjust the masks in GetEditFlags() and
74// ClearTempFlags().
75
76#define EDA_ITEM_ALL_FLAGS UINT32_MAX
77
78typedef std::uint32_t EDA_ITEM_FLAGS;
79
80// Helper function to convert flags to string descriptions
81#include <string>
82#include <vector>
83#include <sstream>
84
85inline std::string EDAItemFlagsToString( EDA_ITEM_FLAGS flags )
86{
87 struct FlagDesc
88 {
89 EDA_ITEM_FLAGS value;
90 const char* name;
91 };
92
93 static const FlagDesc flagDescs[] = { { IS_CHANGED, "IS_CHANGED" },
94 { IS_LINKED, "IS_LINKED" },
95 { IN_EDIT, "IN_EDIT" },
96 { IS_MOVING, "IS_MOVING" },
97 { IS_NEW, "IS_NEW" },
98 { IS_BROKEN, "IS_BROKEN" },
99 { IS_DELETED, "IS_DELETED" },
100 { STARTPOINT, "STARTPOINT" },
101 { ENDPOINT, "ENDPOINT" },
102 { SELECTED, "SELECTED" },
103 { SELECTED_BY_DRAG, "SELECTED_BY_DRAG" },
104 { STRUCT_DELETED, "STRUCT_DELETED" },
105 { CANDIDATE, "CANDIDATE" },
106 { SKIP_STRUCT, "SKIP_STRUCT" },
107 { IS_PASTED, "IS_PASTED" },
108 { IS_SHOWN_AS_BITMAP, "IS_SHOWN_AS_BITMAP" },
109 { COURTYARD_CONFLICT, "COURTYARD_CONFLICT" },
110 { MALFORMED_F_COURTYARD, "MALFORMED_F_COURTYARD" },
111 { MALFORMED_B_COURTYARD, "MALFORMED_B_COURTYARD" },
112 { ROUTER_TRANSIENT, "ROUTER_TRANSIENT" },
113 { CONNECTIVITY_CANDIDATE, "CONNECTIVITY_CANDIDATE" },
114 { HOLE_PROXY, "HOLE_PROXY" },
115 { SHOW_ELEC_TYPE, "SHOW_ELEC_TYPE" },
116 { BRIGHTENED, "BRIGHTENED" },
117 { UR_TRANSIENT, "UR_TRANSIENT" },
118 { IS_DANGLING, "IS_DANGLING" },
119 { ENTERED, "ENTERED" },
120 { SELECTION_CANDIDATE, "SELECTION_CANDIDATE" } };
121
122 std::vector<std::string> setFlags;
123 for( const auto& desc : flagDescs )
124 {
125 if( flags & desc.value )
126 setFlags.push_back( desc.name );
127 }
128
129 std::ostringstream oss;
130 for( size_t i = 0; i < setFlags.size(); ++i )
131 {
132 if( i > 0 )
133 oss << " | ";
134 oss << setFlags[i];
135 }
136 if( setFlags.empty() )
137 return "0";
138 return oss.str();
139}
140
141
142#endif
const char * name
#define IS_PASTED
Modifier on IS_NEW which indicates it came from clipboard.
#define IS_CHANGED
Item was edited, and modified.
#define BRIGHTENED
item is drawn with a bright contour
#define IS_SHOWN_AS_BITMAP
#define IS_NEW
New item, just created.
#define IS_LINKED
Used in calculation to mark linked items (temporary use)
#define SELECTED
Item was manually selected by the user.
#define SELECTED_BY_DRAG
Item was algorithmically selected as a dragged item.
#define SELECTION_CANDIDATE
indicates an item is a candidate for selection
std::string EDAItemFlagsToString(EDA_ITEM_FLAGS flags)
#define CONNECTIVITY_CANDIDATE
flag indicating that the structure is connected for connectivity
#define COURTYARD_CONFLICT
temporary set when moving footprints having courtyard overlapping
#define IS_DELETED
#define MALFORMED_F_COURTYARD
#define MALFORMED_B_COURTYARD
#define ROUTER_TRANSIENT
transient items that should NOT be cached
#define IS_BROKEN
Is a segment just broken by BreakSegment.
#define HOLE_PROXY
Indicates the BOARD_ITEM is a proxy for its hole.
#define ENTERED
indicates a group has been entered
#define STRUCT_DELETED
flag indication structures to be erased
#define ENDPOINT
ends. (Used to support dragging.)
#define IN_EDIT
Item currently edited.
#define SKIP_STRUCT
flag indicating that the structure should be ignored
std::uint32_t EDA_ITEM_FLAGS
#define CANDIDATE
flag indicating that the structure is connected
#define IS_MOVING
Item being moved.
#define UR_TRANSIENT
indicates the item is owned by the undo/redo stack
#define SHOW_ELEC_TYPE
Show pin electrical type.
#define IS_DANGLING
indicates a pin is dangling
#define STARTPOINT
When a line is selected, these flags indicate which.