4 * PCB, interactive printed circuit board design
5 * Copyright (C) 1994,1995,1996 Thomas Nau
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 * Contact addresses for paper mail and Email:
22 * Thomas Nau, Schlehenweg 15, 88471 Baustetten, Germany
23 * Thomas.Nau@rz.uni-ulm.de
28 /* global source constants
37 #include "globalconst.h"
39 /* ---------------------------------------------------------------------------
40 * the layer-numbers of the two additional special layers
41 * 'component' and 'solder'. The offset of MAX_LAYER is not added
43 #define SOLDER_LAYER 0
44 #define COMPONENT_LAYER 1
46 /* ---------------------------------------------------------------------------
49 #define MARK_SIZE MIL_TO_COORD(50) /* relative marker size */
50 #define UNDO_WARNING_SIZE (1024*1024) /* warning limit of undo */
51 #define USERMEDIANAME "user defined" /* label of default media */
53 /* ---------------------------------------------------------------------------
57 #define M_PI 3.14159265358979323846
60 #define M_SQRT1_2 0.707106781 /* 1/sqrt(2) */
62 #define M180 (M_PI/180.0)
63 #define RAD_TO_DEG (180.0/M_PI)
64 #define TAN_22_5_DEGREE_2 0.207106781 /* 0.5*tan(22.5) */
65 #define COS_22_5_DEGREE 0.923879533 /* cos(22.5) */
66 #define TAN_30_DEGREE 0.577350269 /* tan(30) */
67 #define TAN_60_DEGREE 1.732050808 /* tan(60) */
68 #define LN_2_OVER_2 0.346573590
70 /* PCB/physical unit conversions */
71 #define COORD_TO_MIL(n) ((n) / 25400.0)
72 #define MIL_TO_COORD(n) ((n) * 25400.0)
73 #define COORD_TO_MM(n) ((n) / 1000000.0)
74 #define MM_TO_COORD(n) ((n) * 1000000.0)
75 #define COORD_TO_INCH(n) (COORD_TO_MIL(n) / 1000.0)
76 #define INCH_TO_COORD(n) (MIL_TO_COORD(n) * 1000.0)
78 /* These need to be carefully written to avoid overflows, and return
80 #define SCALE_TEXT(COORD,TEXTSCALE) ((Coord)((COORD) * ((double)(TEXTSCALE) / 100.0)))
81 #define UNSCALE_TEXT(COORD,TEXTSCALE) ((Coord)((COORD) * (100.0 / (double)(TEXTSCALE))))
83 /* ---------------------------------------------------------------------------
86 #define NO_MODE 0 /* no mode selected */
87 #define VIA_MODE 1 /* draw vias */
88 #define LINE_MODE 2 /* draw lines */
89 #define RECTANGLE_MODE 3 /* create rectangles */
90 #define POLYGON_MODE 4 /* draw filled polygons */
91 #define PASTEBUFFER_MODE 5 /* paste objects from buffer */
92 #define TEXT_MODE 6 /* create text objects */
93 #define ROTATE_MODE 102 /* rotate objects */
94 #define REMOVE_MODE 103 /* remove objects */
95 #define MOVE_MODE 104 /* move objects */
96 #define COPY_MODE 105 /* copy objects */
97 #define INSERTPOINT_MODE 106 /* insert point into line/polygon */
98 #define RUBBERBANDMOVE_MODE 107 /* move objects and attached lines */
99 #define THERMAL_MODE 108 /* toggle thermal layer flag */
100 #define ARC_MODE 109 /* draw arcs */
101 #define ARROW_MODE 110 /* selection with arrow mode */
102 #define PAN_MODE 0 /* same as no mode */
103 #define LOCK_MODE 111 /* lock/unlock objects */
104 #define POLYGONHOLE_MODE 112 /* cut holes in filled polygons */
106 /* ---------------------------------------------------------------------------
110 /* %start-doc pcbfile ~objectflags
112 @section Object Flags
114 Note that object flags can be given numerically (like @code{0x0147})
115 or symbolically (like @code{"found,showname,square"}. Some numeric
116 values are reused for different object types. The table below lists
117 the numeric value followed by the symbolic name.
121 If set, this object is a pin. This flag is for internal use only.
125 If set, this object has been found by @code{FindConnection()}.
127 For pins and vias, this flag means that the pin or via is a hole
128 without a copper annulus.
130 If set for a line, indicates that this line is a rat line instead of a
132 @item 0x0010 pininpoly
133 For pins and pads, this flag is used internally to indicate that the
134 pin or pad overlaps a polygon on some layer.
135 @item 0x0010 clearpoly
136 For polygons, this flag means that pins and vias will normally clear
137 these polygons (thus, thermals are required for electrical
138 connection). When clear, polygons will solidly connect to pins and
140 @item 0x0010 hidename
141 For elements, when set the name of the element is hidden.
142 @item 0x0020 showname
143 For elements, when set the names of pins are shown.
144 @item 0x0020 clearline
145 For lines and arcs, the line/arc will clear polygons instead of
147 @item 0x0020 fullpoly
148 For polygons, the full polygon is drawn (i.e. all parts instead of only the biggest one).
149 @item 0x0040 selected
150 Set when the object is selected.
151 @item 0x0080 onsolder
152 For elements and pads, indicates that they are on the solder side.
154 For lines and vias, indicates that these were created by the
157 For pins and pads, indicates a square (vs round) pin/pad.
158 @item 0x0200 rubberend
159 For lines, used internally for rubber band moves.
161 For pins, vias, and pads, set to indicate a warning.
162 @item 0x0400 usetherm
163 Obsolete, indicates that pins/vias should be drawn with thermal
166 Obsolete, old files used this to indicate lines drawn on silk.
168 Draw pins and vias as octagons.
170 Set for objects that fail DRC.
172 Set for locked objects.
174 For pads, indicates that the second point is closer to the edge. For
175 pins, indicates that the pin is closer to a horizontal edge and thus
176 pinout text should be vertical.
178 Marker used internally to avoid revisiting an object.
179 @item 0x10000 nopaste
180 For pads, set to prevent a solderpaste stencil opening for the
181 pad. Primarily used for pads used as fiducials.
185 #define NOFLAG 0x0000
186 #define PINFLAG 0x0001 /* is a pin */
187 #define VIAFLAG 0x0002 /* is a via */
188 #define FOUNDFLAG 0x0004 /* used by 'FindConnection()' */
189 #define HOLEFLAG 0x0008 /* pin or via is only a hole */
190 #define NOPASTEFLAG 0x0008 /* pad should not receive
191 solderpaste. This is to
193 #define RATFLAG 0x0010 /* indicates line is a rat line */
194 #define PININPOLYFLAG 0x0010 /* pin found inside poly - same as */
195 /* rat line since not used on lines */
196 #define CLEARPOLYFLAG 0x0010 /* pins/vias clear these polygons */
197 #define HIDENAMEFLAG 0x0010 /* hide the element name */
198 #define DISPLAYNAMEFLAG 0x0020 /* display the names of pins/pads */
200 #define CLEARLINEFLAG 0x0020 /* line doesn't touch polygons */
201 #define FULLPOLYFLAG 0x0020 /* full polygon is drawn (i.e. all parts instead of only the biggest one) */
202 #define SELECTEDFLAG 0x0040 /* object has been selected */
203 #define ONSOLDERFLAG 0x0080 /* element is on bottom side */
204 #define AUTOFLAG 0x0080 /* line/via created by auto-router */
205 #define SQUAREFLAG 0x0100 /* pin is square, not round */
206 #define RUBBERENDFLAG 0x0200 /* indicates one end already rubber */
207 /* banding same as warn flag */
208 /* since pins/pads won't use it */
209 #define WARNFLAG 0x0200 /* Warning for pin/via/pad */
210 #define USETHERMALFLAG 0x0400 /* draw pin, via with thermal fingers */
211 #define ONSILKFLAG 0x0400 /* old files use this to indicate silk */
212 #define OCTAGONFLAG 0x0800 /* draw pin/via as octagon instead of round */
213 #define DRCFLAG 0x1000 /* flag like FOUND flag for DRC checking */
214 #define LOCKFLAG 0x2000 /* object locked in place */
215 #define EDGE2FLAG 0x4000 /* Padr.Point2 is closer to outside edge */
216 /* also pinout text for pins is vertical */
217 #define VISITFLAG 0x8000 /* marker to avoid re-visiting an object */
218 /* ---------------------------------------------------------------------------
222 /* %start-doc pcbfile ~pcbflags
227 Pinout displays pin numbers instead of pin names.
229 Use local reference for moves, by setting the mark at the beginning of
232 When set, only polygons and their clearances are drawn, to see if
233 polygons have isolated regions.
235 Display DRC region on crosshair.
237 Do all move, mirror, rotate with rubberband connections.
239 Display descriptions of elements, instead of refdes.
241 Display names of elements, instead of refdes.
243 Auto-DRC flag. When set, PCB doesn't let you place copper that
246 Enable 'all-direction' lines.
248 Switch starting angle after each click.
250 Force unique names on board.
252 New lines/arc clear polygons.
254 Crosshair snaps to pins and pads.
256 Show the solder mask layer.
258 Draw with thin lines.
260 Move items orthogonally.
262 Draw autoroute paths real-time.
264 New polygons are full ones.
266 Names are locked, the mouse cannot select them.
268 Everything but names are locked, the mouse cannot select anything else.
270 New polygons are full polygons.
272 When set, element names are not drawn.
276 #define PCB_FLAGS 0x000fffff /* all used flags */
278 #define SHOWNUMBERFLAG 0x00000001
279 #define LOCALREFFLAG 0x00000002
280 #define CHECKPLANESFLAG 0x00000004
281 #define SHOWDRCFLAG 0x00000008
282 #define RUBBERBANDFLAG 0x00000010
283 #define DESCRIPTIONFLAG 0x00000020
284 #define NAMEONPCBFLAG 0x00000040
285 #define AUTODRCFLAG 0x00000080
286 #define ALLDIRECTIONFLAG 0x00000100
287 #define SWAPSTARTDIRFLAG 0x00000200
288 #define UNIQUENAMEFLAG 0x00000400
289 #define CLEARNEWFLAG 0x00000800
290 #define SNAPPINFLAG 0x00001000
291 #define SHOWMASKFLAG 0x00002000
292 #define THINDRAWFLAG 0x00004000
293 #define ORTHOMOVEFLAG 0x00008000
294 #define LIVEROUTEFLAG 0x00010000
295 #define THINDRAWPOLYFLAG 0x00020000
296 #define LOCKNAMESFLAG 0x00040000
297 #define ONLYNAMESFLAG 0x00080000
298 #define NEWFULLPOLYFLAG 0x00100000
299 #define HIDENAMESFLAG 0x00200000
301 /* ---------------------------------------------------------------------------
304 #define NO_TYPE 0x00000 /* no object */
305 #define VIA_TYPE 0x00001
306 #define ELEMENT_TYPE 0x00002
307 #define LINE_TYPE 0x00004
308 #define POLYGON_TYPE 0x00008
309 #define TEXT_TYPE 0x00010
310 #define RATLINE_TYPE 0x00020
312 #define PIN_TYPE 0x00100 /* objects that are part */
313 #define PAD_TYPE 0x00200 /* 'pin' of SMD element */
314 #define ELEMENTNAME_TYPE 0x00400 /* of others */
315 #define POLYGONPOINT_TYPE 0x00800
316 #define LINEPOINT_TYPE 0x01000
317 #define ELEMENTLINE_TYPE 0x02000
318 #define ARC_TYPE 0x04000
319 #define ELEMENTARC_TYPE 0x08000
321 #define LOCKED_TYPE 0x10000 /* used to tell search to include locked items. */
322 #define NET_TYPE 0x20000 /* used to select whole net. */
324 #define PIN_TYPES (VIA_TYPE | PIN_TYPE)
325 #define LOCK_TYPES (VIA_TYPE | LINE_TYPE | ARC_TYPE | POLYGON_TYPE | ELEMENT_TYPE \
326 | TEXT_TYPE | ELEMENTNAME_TYPE | LOCKED_TYPE)
328 #define ALL_TYPES (~0) /* all bits set */