?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
missing NULL terminator in set_config_x
[geda-gaf.git] / docs / wiki / geda-file_format_spec.ru.html
blob04a8c3cc060f2016d2f8548205f1b6aed2c5cad0
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html>
4 <head>
5 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
6 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
7 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
8
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
10 </head>
11 <body>
12
13 <p>
14 <em>Эта страница доступна также на следующих языках:</em>
15 <a href="geda-file_format_spec.html" class="wikilink1" title="geda-file_format_spec.html">English</a>
16 </p>
17
18 <h1 class="sectionedit1" id="формат_файлов_geda_gaf">Формат файлов gEDA/gaf</h1>
19 <div class="level1">
20
21 <p>
22 Автор: Ales V. Hvezda, ahvezda@geda.seul.org
23 </p>
24
25 <p>
26 Настоящий документ распространяется под лицензией
27 <a href="http://www.gnu.org/copyleft/fdl.html" class="urlextern" title="http://www.gnu.org/copyleft/fdl.html" rel="nofollow">GFDL</a>
28 </p>
29
30 <p>
31 31 декабря 2003 г.
32 </p>
33
34 </div>
35 <!-- EDIT1 SECTION "Формат файлов gEDA/gaf" [125-394] -->
36 <h2 class="sectionedit2" id="обзор">Обзор</h2>
37 <div class="level2">
38
39 <p>
40 Здесь представлена официальная документация формата файлов gEDA/gaf
41 (<em class="u">g</em>schem <em class="u">a</em>nd <em class="u">f</em>riends). Основным форматом в gEDA/gaf является
42 формат файлов <a href="geda-glossary.ru.html#принципиальная_схема" class="wikilink1" title="geda-glossary.ru.html">электрических
43 принципиальных схем</a> и <a href="geda-glossary.ru.html#символ" class="wikilink1" title="geda-glossary.ru.html">символов</a> для них. Файлы
44 с именами, заканчивающимися на <em><code>.sch</code></em> и <em><code>.sym</code></em>, являются
45 соответственно файлами схем и символов. Пока в gEDA/gaf нет других типов
46 файлов, настоящий документ будет относиться только к формату файлов
47 схем/символов.<br/>
48
49 Настоящий документ находится в обращении с версии gEDA/gaf 20040111. Он
50 охватывает версии формата 1 и 2.<br/>
51
52 Обратите внимание, что данный формат и любые другие форматы файлов,
53 относящиеся к gEDA, находятся под лицензией General Public License (<abbr title="GNU General Public License">GPL</abbr>)
54 версии 2.0. Авторские права на формат файлов схем/символов gEDA/gaf
55 принадлежат Ales Hvezda (Copyright (C) 1998-2004 Ales Hvezda).
56 </p>
57
58 </div>
59 <!-- EDIT2 SECTION "Обзор" [395-1848] -->
60 <h2 class="sectionedit3" id="система_координат">Система координат</h2>
61 <div class="level2">
62
63 <p>
64 Все координаты задаются в милах (1/1000 дюйма). Это произвольное решение. Запомните, что в схемах и символах нет понятия физических длин/размеров (только при разработке принципиальных схем).
65 </p>
66 <ul>
67 <li class="level1"><div class="li"> Начало координат находится в левом нижнем углу.</div>
68 </li>
69 <li class="level1"><div class="li"> Размеры координатного пространства неограничены, но рекомендуется размещать объекты в пределах (120.0, 90.0) (x, y, дюймов).</div>
70 </li>
71 <li class="level1"><div class="li"> В большинстве случаев желательно использовать положительные координаты x и y, отрицательные значения тоже работают, но их использование не рекомендуется.</div>
72 </li>
73 </ul>
74
75 <p>
76 Следующий рисунок показывает настройку координатной системы:
77 </p>
78 <div class="table sectionedit4"><table class="inline">
79 <tr class="row0">
80 <td class="col0"><a href="media/geda/coordinatespace.ru.png" class="media" target="_blank" title="geda:coordinatespace.ru.png"><img src="media/geda/coordinatespace.ru.png" class="mediaright" title=":geda:coordinatespace.ru.png " alt=":geda:coordinatespace.ru.png " /></a></td>
81 </tr>
82 </table></div>
83 <!-- EDIT4 TABLE [2954-3019] -->
84 <p>
85 Значение по оси X возрастает слева направо, по оси Y — снизу вверх.
86 Координатная система располагается в «пейзажной» ориентации и соответствует
87 листу, повёрнутому длинной стороной вниз.
88 </p>
89
90 </div>
91 <!-- EDIT3 SECTION "Система координат" [1849-3362] -->
92 <h2 class="sectionedit5" id="имена_файлов">Имена файлов</h2>
93 <div class="level2">
94
95 <p>
96 Имена файлов символов заканчиваются на <em><code>.sym</code></em>. Для имён файлов
97 символов в gEDA/gaf используется только одно соглашение: если есть несколько
98 экземпляров символов с одинаковыми именами (как, например, 7400), то к концу
99 основы имени файла добавляется суффикс -1, -2, -3, … -N . Пример:
100 <em><code>7400-1.sym</code></em>, <em><code>7400-2.sym</code></em>, <em><code>7400-3.sym</code></em>…
101 </p>
102
103 <p>
104 Имена файлов схем заканчиваются на <em><code>.sch</code></em>. Раньше существовало
105 соглашение об именах файлов схем (о добавлении -1 .. -N к основе имени
106 файла), но сейчас оно устарело. Для схем их создатель может выбирать любые
107 осмысленные имена.
108 </p>
109
110 </div>
111 <!-- EDIT5 SECTION "Имена файлов" [3363-4364] -->
112 <h2 class="sectionedit6" id="типы_объектов">Типы объектов</h2>
113 <div class="level2">
114
115 <p>
116 Файл схемы/символа для gEDA/gaf состоит из следующих частей:
117 </p>
118 <ul>
119 <li class="level1"><div class="li"> Версия (v) как первый элемент в файле. Это обязательно.</div>
120 </li>
121 <li class="level1"><div class="li"> Любое количество объектов с правильными данными. Объекты указываются с помощью «типа объекта».</div>
122 </li>
123 <li class="level1"><div class="li"> Большинство объектов описываются одной строкой, но текстовые — двумя и более.</div>
124 </li>
125 <li class="level1"><div class="li"> Не должно быть пустых строк в конце файла (они игнорируются программами).</div>
126 </li>
127 <li class="level1"><div class="li"> Для всех перечислимых типов в форматах файлов gEDA/gaf поле принимает числовое значение.</div>
128 </li>
129 </ul>
130
131 <p>
132 Идентификатор типа объекта обозначается одной буквой, он должен находиться в
133 первом столбце. Идентификатор типа объекта является регистрозависимым.
134 </p>
135
136 <p>
137 Файлы схем и символов имеют общий формат. <a href="geda-glossary.ru.html#символ" class="wikilink1" title="geda-glossary.ru.html">Символ</a> —
138 это не что иное, как совокупность примитивных объектов (линий,
139 прямоугольников, окружностей, дуг, текста и выводов). Схема представляет
140 собой набор символов (компонентов),
141 <a href="geda-glossary.ru.html#соединение" class="wikilink1" title="geda-glossary.ru.html">соединений</a> и <a href="geda-glossary.ru.html#шина" class="wikilink1" title="geda-glossary.ru.html">шин</a>.
142 </p>
143
144 <p>
145 В следующих разделах приводится подробное описание каждого из распознаваемых
146 типов объектов. Каждый раздел содержит название объекта, описание того, в
147 каком типе файла (sch/sym) объект может присутствовать, формат данных,
148 описание каждого отдельного поля, подробности и предостережения для данных
149 полей и, наконец, пример с пояснением.
150 </p>
151
152 <p>
153 Информация об индексе цвета (который используется практически для всех
154 объектов) находится в разделе <a href="#цвета" title=":geda:file_format_spec.ru.txt ↵" class="wikilink1">Цвета</a>.
155 </p>
156
157 </div>
158 <!-- EDIT6 SECTION "Типы объектов" [4365-6870] -->
159 <h3 class="sectionedit7" id="версия">Версия</h3>
160 <div class="level3">
161
162 <p>
163 Допускается: в файлах схем и символов
164 </p>
165
166 <p>
167 <strong><code>type version fileformat_version</code></strong>
168 </p>
169 <div class="table sectionedit8"><table class="inline">
170 <thead>
171 <tr class="row0">
172 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
173 </tr>
174 </thead>
175 <tr class="row1">
176 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">v</td>
177 </tr>
178 <tr class="row2">
179 <td class="col0 rightalign"> 1 </td><td class="col1">version</td><td class="col2">int</td><td class="col3">Версия gEDA/gaf, в которой был сохранён данный файл</td>
180 </tr>
181 <tr class="row3">
182 <td class="col0 rightalign"> 2 </td><td class="col1">fileformat_version</td><td class="col2">int</td><td class="col3">Номер версии формата файла gEDA/gaf</td>
183 </tr>
184 </table></div>
185 <!-- EDIT8 TABLE [7005-7276] --><ul>
186 <li class="level1"><div class="li"> Тип обозначается буквой «v» в нижнем регистре (как в слове Victor).</div>
187 </li>
188 <li class="level1"><div class="li"> Данный объект должен находиться в каждом файле, используемом или создаваемом программными средствами gEDA/gaf.</div>
189 </li>
190 <li class="level1"><div class="li"> Формат первого поля версии — ГГГГММДД.</div>
191 </li>
192 <li class="level1"><div class="li"> Номер версии не является произвольным временным штампом. Не выдумывайте номер версии, а в противном случае не ожидайте, что программы будут работать правильно.</div>
193 </li>
194 <li class="level1"><div class="li"> «Версия gEDA/gaf, в которой был сохранён данный файл» использовалась во всех версиях gEDA/gaf до 20030921 как версия формата файла. Это поле не должно больше использоваться для определения формата файла. Сейчас оно используется только для информационных целей.</div>
195 </li>
196 <li class="level1"><div class="li"> Начиная с gEDA/gaf версии 20031004 и позже, поле <code>fileformat_version</code> используется для определения версии формата файла. Весь код формата файла должен отталкиваться от этого поля.</div>
197 </li>
198 <li class="level1"><div class="li"> <code>fileformat_version</code> возрастает при изменении формата файла.</div>
199 </li>
200 <li class="level1"><div class="li"> Исходной точкой для <code>fileformat_version</code> было значение 1. Текущее значение — 2.</div>
201 </li>
202 <li class="level1"><div class="li"> <code>fileformat_version</code> — это просто целое, без младшего номера.</div>
203 </li>
204 <li class="level1"><div class="li"> Рабочие (нестабильные) версии: 19990601, 19990610, 19990705, 19990829, 19990919, 19991011, 20000220, 20000704, 20001006, 20001217, 20010304, 20010708, 20010722, 20020209, 20020414, 20020527, 20020825, 20021103, 20030223, 20030525, 20030901, 20040111, 20040710, 20041228, 20050313, 20050820, 20060123, 20060824, 20060906, 20061020, 20070216, 20070705, 20070708, 20070818, 20071229, 20080110, 20080127, 20080706, 20081220, 20081221, 20090328, 20090829, 20090830, 20110116, 20110619, 20111231</div>
205 </li>
206 <li class="level1"><div class="li"> Стабильные версии: 20070526, 20070626, 20070902, 20071231, 20080127, 20080929, 20081220, 20081231, 20091004, 20100214, 20110115</div>
207 </li>
208 <li class="level1"><div class="li"> CVS или тестовые версии (не должны использоваться): 20030921, 20031004, 20031019, 20031231, 20050814</div>
209 </li>
210 <li class="level1"><div class="li"> Имейте в виду, что каждая из вышеперечисленных версий могла иметь свою вариацию формата файла. Настоящий документ описывает только последнюю версию формата.</div>
211 </li>
212 </ul>
213
214 <p>
215 Пример:
216 </p>
217 <pre class="code">v 20040111 1</pre>
218
219 </div>
220 <!-- EDIT7 SECTION "Версия" [6871-10219] -->
221 <h3 class="sectionedit9" id="линия">Линия</h3>
222 <div class="level3">
223
224 <p>
225 Допускается: в файлах схем и символов
226 </p>
227
228 <p>
229 <strong><code>type x1 y1 x2 y2 color width capstyle dashstyle dashlength dashspace</code></strong>
230 </p>
231 <div class="table sectionedit10"><table class="inline">
232 <thead>
233 <tr class="row0">
234 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
235 </tr>
236 </thead>
237 <tr class="row1">
238 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">L</td>
239 </tr>
240 <tr class="row2">
241 <td class="col0 rightalign"> 1 </td><td class="col1">x1</td><td class="col2">int/милы</td><td class="col3">Координата X первой точки</td>
242 </tr>
243 <tr class="row3">
244 <td class="col0 rightalign"> 2 </td><td class="col1">y1</td><td class="col2">int/милы</td><td class="col3">Координата Y первой точки</td>
245 </tr>
246 <tr class="row4">
247 <td class="col0 rightalign"> 3 </td><td class="col1">x2</td><td class="col2">int/милы</td><td class="col3">Координата X второй точки</td>
248 </tr>
249 <tr class="row5">
250 <td class="col0 rightalign"> 4 </td><td class="col1">y2</td><td class="col2">int/милы</td><td class="col3">Координата Y второй точки</td>
251 </tr>
252 <tr class="row6">
253 <td class="col0 rightalign"> 5 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
254 </tr>
255 <tr class="row7">
256 <td class="col0 rightalign"> 6 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Толщина линии</td>
257 </tr>
258 <tr class="row8">
259 <td class="col0 rightalign"> 7 </td><td class="col1">capstyle</td><td class="col2">int</td><td class="col3">Стиль концов линии</td>
260 </tr>
261 <tr class="row9">
262 <td class="col0 rightalign"> 8 </td><td class="col1">dashstyle</td><td class="col2">int</td><td class="col3">Тип линии</td>
263 </tr>
264 <tr class="row10">
265 <td class="col0 rightalign"> 9 </td><td class="col1">dashlength</td><td class="col2">int/милы</td><td class="col3">Длина штриха</td>
266 </tr>
267 <tr class="row11">
268 <td class="col0 rightalign"> 10 </td><td class="col1">dashspace</td><td class="col2">int/милы</td><td class="col3">Интервал между штрихами</td>
269 </tr>
270 </table></div>
271 <!-- EDIT10 TABLE [10389-11079] --><ul>
272 <li class="level1 node"><div class="li"> Параметр <code>capstyle</code> перечислимого типа:</div>
273 <ul>
274 <li class="level2"><div class="li"> END NONE = 0 (без стиля)</div>
275 </li>
276 <li class="level2"><div class="li"> END SQUARE = 1 (квадратные концы)</div>
277 </li>
278 <li class="level2"><div class="li"> END ROUND = 2 (круглые концы)</div>
279 </li>
280 </ul>
281 </li>
282 <li class="level1 node"><div class="li"> Параметр <code>dashstyle</code> перечислимого типа:</div>
283 <ul>
284 <li class="level2"><div class="li"> TYPE SOLID = 0 (сплошная линия)</div>
285 </li>
286 <li class="level2"><div class="li"> TYPE DOTTED = 1 (пунктир)</div>
287 </li>
288 <li class="level2"><div class="li"> TYPE DASHED = 2 (штрих)</div>
289 </li>
290 <li class="level2"><div class="li"> TYPE CENTER = 3 (штрих-пунктир)</div>
291 </li>
292 <li class="level2"><div class="li"> TYPE PHANTOM = 4 (двойной штрих-пунктир)</div>
293 </li>
294 </ul>
295 </li>
296 <li class="level1"><div class="li"> Параметр <code>dashlength</code> не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1.</div>
297 </li>
298 <li class="level1"><div class="li"> Параметр <code>dashspace</code> не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1.</div>
299 </li>
300 </ul>
301
302 <p>
303 Пример:
304 </p>
305 <pre class="code">L 23000 69000 28000 69000 3 40 0 1 -1 75</pre>
306
307 <p>
308 Сегмент линии от (23000, 69000) до (28000, 69000) с цветовым индексом 3,
309 толщиной 40 милов, без стиля концов, пунктир, интервал между точками 75
310 милов.
311 </p>
312
313 </div>
314 <!-- EDIT9 SECTION "Линия" [10220-12360] -->
315 <h3 class="sectionedit11" id="изображение">Изображение</h3>
316 <div class="level3">
317
318 <p>
319 Допускается: в файлах схем и символов
320 </p>
321
322 <p>
323 <strong><code>type x1 y1 width height angle mirrored embedded<br/>
324
325 filename<br/>
326
327 [encoded picture data<br/>
328
329 encoded picture end]</code></strong>
330 </p>
331 <div class="table sectionedit12"><table class="inline">
332 <thead>
333 <tr class="row0">
334 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
335 </tr>
336 </thead>
337 <tr class="row1">
338 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">G</td>
339 </tr>
340 <tr class="row2">
341 <td class="col0 rightalign"> 1 </td><td class="col1">x</td><td class="col2">int/милы</td><td class="col3">Координата X левого нижнего угла</td>
342 </tr>
343 <tr class="row3">
344 <td class="col0 rightalign"> 2 </td><td class="col1">y</td><td class="col2">int/милы</td><td class="col3">Координата Y левого нижнего угла</td>
345 </tr>
346 <tr class="row4">
347 <td class="col0 rightalign"> 3 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Ширина изображения</td>
348 </tr>
349 <tr class="row5">
350 <td class="col0 rightalign"> 4 </td><td class="col1">height</td><td class="col2">int/милы</td><td class="col3">Высота изображения</td>
351 </tr>
352 <tr class="row6">
353 <td class="col0 rightalign"> 5 </td><td class="col1">angle</td><td class="col2">int/градусы</td><td class="col3">Угол поворота изображения</td>
354 </tr>
355 <tr class="row7">
356 <td class="col0 rightalign"> 6 </td><td class="col1">mirrored</td><td class="col2">char</td><td class="col3">Зеркально отражённое или нормальное изображение</td>
357 </tr>
358 <tr class="row8">
359 <td class="col0 rightalign"> 7 </td><td class="col1">embedded</td><td class="col2">char</td><td class="col3">Внедрённое или ссылка на файл изображения</td>
360 </tr>
361 <tr class="row9">
362 <td class="col0 rightalign"> 8 </td><td class="col1">filename</td><td class="col2">string</td><td class="col3">Путь доступа и имя файла для невнедрённого изображения</td>
363 </tr>
364 <tr class="row10">
365 <td class="col0 rightalign"> 9 </td><td class="col1">encoded picture data</td><td class="col2">string</td><td class="col3">Изображение, преобразованное в последовательную форму, перекодированное в base64</td>
366 </tr>
367 <tr class="row11">
368 <td class="col0 rightalign"> 10 </td><td class="col1">encoded picture end</td><td class="col2">string</td><td class="col3">Строка, содержащая только символ точки</td>
369 </tr>
370 </table></div>
371 <!-- EDIT12 TABLE [12579-13659] --><ul>
372 <li class="level1"><div class="li"> Данный объект является объектом изображения. Первая строка содержит все параметры изображения, вторая строка представляет собой путь доступа и имя файла изображения. Имя файла не используется, если изображение внедрено.</div>
373 </li>
374 <li class="level1"><div class="li"> Параметр угла поворота изображения <code>angle</code> может принимать только одно из следующих значений: 0, 90, 180, 270.</div>
375 </li>
376 <li class="level1 node"><div class="li"> Параметр <code>mirrored</code> перечислимого типа:</div>
377 <ul>
378 <li class="level2"><div class="li"> NOT MIRRORED = 0 (без отражения)</div>
379 </li>
380 <li class="level2"><div class="li"> MIRRORED = 1 (с отражением)</div>
381 </li>
382 </ul>
383 </li>
384 <li class="level1 node"><div class="li"> Параметр <code>embedded</code> перечислимого типа:</div>
385 <ul>
386 <li class="level2"><div class="li"> NOT EMBEDDED = 0 (не внедрённое)</div>
387 </li>
388 <li class="level2"><div class="li"> EMBEDDED = 1 (внедрённое — пока не поддерживается)</div>
389 </li>
390 </ul>
391 </li>
392 <li class="level1 node"><div class="li"> Поля <code>encoded picture data</code> и <code>encoded picture end</code> находятся в файле только в случае, если изображение внедрено в схему:</div>
393 <ul>
394 <li class="level2"><div class="li"> <code>encoded picture data</code>: Это многострочное поле. Изображение преобразуется в последовательную форму и затем кодируется в base64. Таким образом в закодированных данных используются только печатные символы. Поле содержит результат двух данных операций.</div>
395 </li>
396 <li class="level2"><div class="li"> <code>encoded picture end</code>: Строка, содержащая только один символ точки &#039;.&#039; отмечает конец закодированных данных изображения.</div>
397 </li>
398 </ul>
399 </li>
400 </ul>
401
402 <p>
403 Пример 1:
404 </p>
405 <pre class="code">G 16900 35800 1400 2175 0 0 0
406 ../bitmaps/logo.jpg</pre>
407
408 <p>
409 Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения
410 1400 милов, высота 2175 милов.<br/>
411
412 Поворот изображения 0 градусов и оно ни отражённое, ни внедрённое.<br/>
413
414 Путь доступа и имя файла изображения отображается во второй строке.
415 </p>
416
417 <p>
418 Пример 2:
419 </p>
420 <pre class="code">G 16900 35800 1400 2175 0 0 1
421 ../bitmaps/logo.jpg
422 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
423 BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
424 .</pre>
425
426 <p>
427 Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения
428 1400 милов, высота 2175 милов.<br/>
429
430 Поворот изображения 0 градусов, оно не отражённое, но внедрённое.<br/>
431
432 Путь доступа и имя файла изображения отображается во второй строке. Так как
433 это изображение внедрённое, путь доступа и имя файла не используются.<br/>
434
435 Закодированные данные изображения являются только примером (это не настоящие
436 данные). Последняя строка, содержащая один символ точки &#039;.&#039; указывает конец
437 закодированных данных.
438 </p>
439
440 </div>
441 <!-- EDIT11 SECTION "Изображение" [12361-17078] -->
442 <h3 class="sectionedit13" id="прямоугольник">Прямоугольник</h3>
443 <div class="level3">
444
445 <p>
446 Допускается: в файлах схем и символов
447 </p>
448
449 <p>
450 <strong><code>type x y width height color width capstyle dashstyle dashlength
451 dashspace filltype fillwidth angle1 pitch1 angle2 pitch2</code></strong>
452 </p>
453 <div class="table sectionedit14"><table class="inline">
454 <thead>
455 <tr class="row0">
456 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
457 </tr>
458 </thead>
459 <tr class="row1">
460 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">B</td>
461 </tr>
462 <tr class="row2">
463 <td class="col0 rightalign"> 1 </td><td class="col1">x</td><td class="col2">int/милы</td><td class="col3">Координата X левого нижнего угла</td>
464 </tr>
465 <tr class="row3">
466 <td class="col0 rightalign"> 2 </td><td class="col1">y</td><td class="col2">int/милы</td><td class="col3">Координата Y левого нижнего угла</td>
467 </tr>
468 <tr class="row4">
469 <td class="col0 rightalign"> 3 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Ширина прямоугольника (в направлении x)</td>
470 </tr>
471 <tr class="row5">
472 <td class="col0 rightalign"> 4 </td><td class="col1">height</td><td class="col2">int/милы</td><td class="col3">Высота прямоугольника (в направлении y)</td>
473 </tr>
474 <tr class="row6">
475 <td class="col0 rightalign"> 5 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
476 </tr>
477 <tr class="row7">
478 <td class="col0 rightalign"> 6 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Толщина линий</td>
479 </tr>
480 <tr class="row8">
481 <td class="col0 rightalign"> 7 </td><td class="col1">capstyle</td><td class="col2">int/милы</td><td class="col3">Стиль концов линий</td>
482 </tr>
483 <tr class="row9">
484 <td class="col0 rightalign"> 8 </td><td class="col1">dashstyle</td><td class="col2">int</td><td class="col3">Тип линий</td>
485 </tr>
486 <tr class="row10">
487 <td class="col0 rightalign"> 9 </td><td class="col1">dashlength</td><td class="col2">int/милы</td><td class="col3">Длина штриха</td>
488 </tr>
489 <tr class="row11">
490 <td class="col0 rightalign"> 10 </td><td class="col1">dashspace</td><td class="col2">int/милы</td><td class="col3">Интервал между штрихами</td>
491 </tr>
492 <tr class="row12">
493 <td class="col0 rightalign"> 11 </td><td class="col1">filltype</td><td class="col2">int</td><td class="col3">Тип заполнения</td>
494 </tr>
495 <tr class="row13">
496 <td class="col0 rightalign"> 12 </td><td class="col1">fillwidth</td><td class="col2">int/милы</td><td class="col3">Толщина линий заполнения</td>
497 </tr>
498 <tr class="row14">
499 <td class="col0 rightalign"> 13 </td><td class="col1">angle1</td><td class="col2">int/градусы</td><td class="col3">Первый угол заполнения</td>
500 </tr>
501 <tr class="row15">
502 <td class="col0 rightalign"> 14 </td><td class="col1">pitch1</td><td class="col2">int/милы</td><td class="col3">Первый шаг/интервал заполнения</td>
503 </tr>
504 <tr class="row16">
505 <td class="col0 rightalign"> 15 </td><td class="col1">angle2</td><td class="col2">int/градусы</td><td class="col3">Второй угол заполнения</td>
506 </tr>
507 <tr class="row17">
508 <td class="col0 rightalign"> 16 </td><td class="col1">pitch2</td><td class="col2">int/милы</td><td class="col3">Второй шаг/интервал заполнения</td>
509 </tr>
510 </table></div>
511 <!-- EDIT14 TABLE [17316-18549] --><ul>
512 <li class="level1 node"><div class="li"> Параметр <code>capstyle</code> перечислимого типа:</div>
513 <ul>
514 <li class="level2"><div class="li"> END NONE = 0 (без стиля)</div>
515 </li>
516 <li class="level2"><div class="li"> END SQUARE = 1 (квадратные концы)</div>
517 </li>
518 <li class="level2"><div class="li"> END ROUND = 2 (круглые концы)</div>
519 </li>
520 </ul>
521 </li>
522 <li class="level1 node"><div class="li"> Параметр <code>dashstyle</code> перечислимого типа:</div>
523 <ul>
524 <li class="level2"><div class="li"> TYPE SOLID = 0 (сплошная линия)</div>
525 </li>
526 <li class="level2"><div class="li"> TYPE DOTTED = 1 (пунктир)</div>
527 </li>
528 <li class="level2"><div class="li"> TYPE DASHED = 2 (штрих)</div>
529 </li>
530 <li class="level2"><div class="li"> TYPE CENTER = 3 (штрих-пунктир)</div>
531 </li>
532 <li class="level2"><div class="li"> TYPE PHANTOM = 4 (двойной штрих-пунктир)</div>
533 </li>
534 </ul>
535 </li>
536 <li class="level1"><div class="li"> Параметр <code>dashlength</code> не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1.</div>
537 </li>
538 <li class="level1"><div class="li"> Параметр <code>dashspace</code> не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1.</div>
539 </li>
540 <li class="level1 node"><div class="li"> Параметр <code>filltype</code> перечислимого типа:</div>
541 <ul>
542 <li class="level2"><div class="li"> FILLING HOLLOW = 0 (без заполнения)</div>
543 </li>
544 <li class="level2"><div class="li"> FILLING FILL = 1 (сплошное заполнение)</div>
545 </li>
546 <li class="level2"><div class="li"> FILLING MESH = 2 (сетка)</div>
547 </li>
548 <li class="level2"><div class="li"> FILLING HATCH = 3 (штриховка)</div>
549 </li>
550 <li class="level2"><div class="li"> FILLING VOID = 4 (не используется)</div>
551 </li>
552 </ul>
553 </li>
554 <li class="level1"><div class="li"> Если значение <code>filltype</code> равно 0 (FILLING HOLLOW), то все остальные параметры заполнения должны иметь значение -1.</div>
555 </li>
556 <li class="level1"><div class="li"> Тип заполнения FILLING FILL используется для заполнения сплошным цветом.</div>
557 </li>
558 <li class="level1"><div class="li"> Для типа заполнения FILLING MESH заполнением или штриховкой управляют две пары наклон/интервал.</div>
559 </li>
560 <li class="level1"><div class="li"> Для типа заполнения FILLING HATCH используется только первая пара наклон/интервал.</div>
561 </li>
562 </ul>
563
564 <p>
565 Пример:
566 </p>
567 <pre class="code">B 33000 67300 2000 2000 3 60 0 2 75 50 0 -1 -1 -1 -1 -1</pre>
568
569 <p>
570 Прямоугольник с нижним левым углом в (33000, 67300) шириной и высотой (2000,
571 2000), цветовой индекс 3, толщина линий 60 милов, без стиля концов,
572 штриховые линии, длина штриха 75 милов, интервал между штрихами 50 милов,
573 без заполнения, остальные параметры не установлены.
574 </p>
575
576 </div>
577 <!-- EDIT13 SECTION "Прямоугольник" [17079-21024] -->
578 <h3 class="sectionedit15" id="окружность">Окружность</h3>
579 <div class="level3">
580
581 <p>
582 Допускается: в файлах схем и символов
583 </p>
584
585 <p>
586 <strong><code>type x y radius color width capstyle dashstyle dashlength dashspace
587 filltype fillwidth angle1 pitch1 angle2 pitch2</code></strong>
588 </p>
589 <div class="table sectionedit16"><table class="inline">
590 <thead>
591 <tr class="row0">
592 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
593 </tr>
594 </thead>
595 <tr class="row1">
596 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">V</td>
597 </tr>
598 <tr class="row2">
599 <td class="col0 rightalign"> 1 </td><td class="col1">x</td><td class="col2">int/милы</td><td class="col3">Координата X центра</td>
600 </tr>
601 <tr class="row3">
602 <td class="col0 rightalign"> 2 </td><td class="col1">y</td><td class="col2">int/милы</td><td class="col3">Координата Y центра</td>
603 </tr>
604 <tr class="row4">
605 <td class="col0 rightalign"> 3 </td><td class="col1">radius</td><td class="col2">int/милы</td><td class="col3">Радиус окружности</td>
606 </tr>
607 <tr class="row5">
608 <td class="col0 rightalign"> 4 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
609 </tr>
610 <tr class="row6">
611 <td class="col0 rightalign"> 5 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Толщина линии окружности</td>
612 </tr>
613 <tr class="row7">
614 <td class="col0 rightalign"> 6 </td><td class="col1">capstyle</td><td class="col2">int/милы</td><td class="col3">0 (не используется)</td>
615 </tr>
616 <tr class="row8">
617 <td class="col0 rightalign"> 7 </td><td class="col1">dashstyle</td><td class="col2">int</td><td class="col3">Тип линии</td>
618 </tr>
619 <tr class="row9">
620 <td class="col0 rightalign"> 8 </td><td class="col1">dashlength</td><td class="col2">int/милы</td><td class="col3">Длина штриха</td>
621 </tr>
622 <tr class="row10">
623 <td class="col0 rightalign"> 9 </td><td class="col1">dashspace</td><td class="col2">int/милы</td><td class="col3">Интервал между штрихами</td>
624 </tr>
625 <tr class="row11">
626 <td class="col0 rightalign"> 10 </td><td class="col1">filltype</td><td class="col2">int</td><td class="col3">Тип заполнения</td>
627 </tr>
628 <tr class="row12">
629 <td class="col0 rightalign"> 11 </td><td class="col1">fillwidth</td><td class="col2">int/милы</td><td class="col3">Толщина линий заполнения</td>
630 </tr>
631 <tr class="row13">
632 <td class="col0 rightalign"> 12 </td><td class="col1">angle1</td><td class="col2">int/градусы</td><td class="col3">Первый угол заполнения</td>
633 </tr>
634 <tr class="row14">
635 <td class="col0 rightalign"> 13 </td><td class="col1">pitch1</td><td class="col2">int/милы</td><td class="col3">Первый шаг/интервал заполнения</td>
636 </tr>
637 <tr class="row15">
638 <td class="col0 rightalign"> 14 </td><td class="col1">angle2</td><td class="col2">int/градусы</td><td class="col3">Второй угол заполнения</td>
639 </tr>
640 <tr class="row16">
641 <td class="col0 rightalign"> 15 </td><td class="col1">pitch2</td><td class="col2">int/милы</td><td class="col3">Второй шаг/интервал заполнения</td>
642 </tr>
643 </table></div>
644 <!-- EDIT16 TABLE [21250-22318] --><ul>
645 <li class="level1 node"><div class="li"> Параметр <code>dashstyle</code> перечислимого типа:</div>
646 <ul>
647 <li class="level2"><div class="li"> TYPE SOLID = 0 (сплошная линия)</div>
648 </li>
649 <li class="level2"><div class="li"> TYPE DOTTED = 1 (пунктир)</div>
650 </li>
651 <li class="level2"><div class="li"> TYPE DASHED = 2 (штрих)</div>
652 </li>
653 <li class="level2"><div class="li"> TYPE CENTER = 3 (штрих-пунктир)</div>
654 </li>
655 <li class="level2"><div class="li"> TYPE PHANTOM = 4 (двойной штрих-пунктир)</div>
656 </li>
657 </ul>
658 </li>
659 <li class="level1"><div class="li"> Параметр <code>dashlength</code> не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1.</div>
660 </li>
661 <li class="level1"><div class="li"> Параметр <code>dashspace</code> не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1.</div>
662 </li>
663 <li class="level1 node"><div class="li"> Параметр <code>filltype</code> перечислимого типа:</div>
664 <ul>
665 <li class="level2"><div class="li"> FILLING HOLLOW = 0 (без заполнения)</div>
666 </li>
667 <li class="level2"><div class="li"> FILLING FILL = 1 (сплошное заполнение)</div>
668 </li>
669 <li class="level2"><div class="li"> FILLING MESH = 2 (сетка)</div>
670 </li>
671 <li class="level2"><div class="li"> FILLING HATCH = 3 (штриховка)</div>
672 </li>
673 <li class="level2"><div class="li"> FILLING VOID = 4 (не используется)</div>
674 </li>
675 </ul>
676 </li>
677 <li class="level1"><div class="li"> Если значение <code>filltype</code> равно 0 (FILLING HOLLOW), то все остальные параметры заполнения должны иметь значение -1.</div>
678 </li>
679 <li class="level1"><div class="li"> Тип заполнения FILLING FILL используется для заполнения сплошным цветом.</div>
680 </li>
681 <li class="level1"><div class="li"> Для типа заполнения FILLING MESH заполнением или штриховкой управляют две пары наклон/интервал.</div>
682 </li>
683 <li class="level1"><div class="li"> Для типа заполнения FILLING HATCH используется только первая пара наклон/интервал.</div>
684 </li>
685 </ul>
686
687 <p>
688 Пример:
689 </p>
690 <pre class="code">V 38000 67000 900 3 0 0 2 75 50 2 10 20 30 90 50</pre>
691
692 <p>
693 Окружность с центром в (38000, 67000) и радиусом 900 милов, цветовой индекс
694 3, толщина линии 0 милов (наименьший размер), без стиля концов, штриховая
695 линия, длина штриха 75 милов, интервал между штрихами 50 милов, заполнение
696 сеткой, линии сетки толщиной 10 милов, первая линия сетки под углом 20
697 градусов с интервалом в 30 милов, вторая линия сетки под углом 90 градусов с
698 интервалом в 50 милов.
699 </p>
700
701 </div>
702 <!-- EDIT15 SECTION "Окружность" [21025-24794] -->
703 <h3 class="sectionedit17" id="дуга">Дуга</h3>
704 <div class="level3">
705
706 <p>
707 Допускается: в файлах схем и символов
708 </p>
709
710 <p>
711 <strong><code>type x y radius startangle sweepangle color width capstyle dashstyle
712 dashlength dashspace</code></strong>
713 </p>
714 <div class="table sectionedit18"><table class="inline">
715 <thead>
716 <tr class="row0">
717 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
718 </tr>
719 </thead>
720 <tr class="row1">
721 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">A</td>
722 </tr>
723 <tr class="row2">
724 <td class="col0 rightalign"> 1 </td><td class="col1">x</td><td class="col2">int/милы</td><td class="col3">Координата X центра</td>
725 </tr>
726 <tr class="row3">
727 <td class="col0 rightalign"> 2 </td><td class="col1">y</td><td class="col2">int/милы</td><td class="col3">Координата Y центра</td>
728 </tr>
729 <tr class="row4">
730 <td class="col0 rightalign"> 3 </td><td class="col1">radius</td><td class="col2">int/милы</td><td class="col3">Радиус дуги</td>
731 </tr>
732 <tr class="row5">
733 <td class="col0 rightalign"> 4 </td><td class="col1">startangle</td><td class="col2">int/градусы</td><td class="col3">Начальный угол дуги</td>
734 </tr>
735 <tr class="row6">
736 <td class="col0 rightalign"> 5 </td><td class="col1">sweepangle</td><td class="col2">int/градусы</td><td class="col3">Угол разворота дуги</td>
737 </tr>
738 <tr class="row7">
739 <td class="col0 rightalign"> 6 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
740 </tr>
741 <tr class="row8">
742 <td class="col0 rightalign"> 7 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Толщина линии окружности</td>
743 </tr>
744 <tr class="row9">
745 <td class="col0 rightalign"> 8 </td><td class="col1">capstyle</td><td class="col2">int</td><td class="col3">Стиль концов линии</td>
746 </tr>
747 <tr class="row10">
748 <td class="col0 rightalign"> 9 </td><td class="col1">dashstyle</td><td class="col2">int</td><td class="col3">Тип линии</td>
749 </tr>
750 <tr class="row11">
751 <td class="col0 rightalign"> 10 </td><td class="col1">dashlength</td><td class="col2">int/милы</td><td class="col3">Длина штриха</td>
752 </tr>
753 <tr class="row12">
754 <td class="col0 rightalign"> 11 </td><td class="col1">dashspace</td><td class="col2">int/милы</td><td class="col3">Интервал между штрихами</td>
755 </tr>
756 </table></div>
757 <!-- EDIT18 TABLE [24983-25728] --><ul>
758 <li class="level1"><div class="li"> Угол <code>startangle</code> может быть отрицательным, но это не рекомендуется.</div>
759 </li>
760 <li class="level1"><div class="li"> Угол <code>sweepangle</code> может быть отрицательным, но это не рекомендуется.</div>
761 </li>
762 <li class="level1 node"><div class="li"> Параметр <code>capstyle</code> перечислимого типа:</div>
763 <ul>
764 <li class="level2"><div class="li"> END NONE = 0 (без стиля)</div>
765 </li>
766 <li class="level2"><div class="li"> END SQUARE = 1 (квадратные концы)</div>
767 </li>
768 <li class="level2"><div class="li"> END ROUND = 2 (круглые концы)</div>
769 </li>
770 </ul>
771 </li>
772 <li class="level1 node"><div class="li"> Параметр <code>dashstyle</code> перечислимого типа:</div>
773 <ul>
774 <li class="level2"><div class="li"> TYPE SOLID = 0 (сплошная линия)</div>
775 </li>
776 <li class="level2"><div class="li"> TYPE DOTTED = 1 (пунктир)</div>
777 </li>
778 <li class="level2"><div class="li"> TYPE DASHED = 2 (штрих)</div>
779 </li>
780 <li class="level2"><div class="li"> TYPE CENTER = 3 (штрих-пунктир)</div>
781 </li>
782 <li class="level2"><div class="li"> TYPE PHANTOM = 4 (двойной штрих-пунктир)</div>
783 </li>
784 </ul>
785 </li>
786 <li class="level1"><div class="li"> Параметр <code>dashlength</code> не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1.</div>
787 </li>
788 <li class="level1"><div class="li"> Параметр <code>dashspace</code> не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1.</div>
789 </li>
790 </ul>
791
792 <p>
793 Пример:
794 </p>
795 <pre class="code">A 30600 75000 2000 0 45 3 0 0 3 75 50</pre>
796
797 <p>
798 Дуга с центром в (30600, 75000) и радиусом 2000 милов, начальный угол 0 градусов, угол разворота дуги 45 градусов, цветовой индекс 3, толщина линии 0 милов (наименьший размер), без стиля концов, штрих-пунктир, длина штриха 75 милов, интервал между штрихами 50 милов.
799 </p>
800
801 </div>
802 <!-- EDIT17 SECTION "Дуга" [24795-27459] -->
803 <h3 class="sectionedit19" id="текст_и_атрибуты">Текст и атрибуты</h3>
804 <div class="level3">
805
806 <p>
807 В зависимости от контекста текстовые объекты могут играть разные роли. Вне
808 какого-либо окружения они представляют собой строки текста, содержащие
809 какую-либо информацию. Заключённые в фигурные скобки, они интерпретируются
810 как атрибуты. См. раздел <a href="geda-file_format_spec.ru.html#атрибуты" class="wikilink1" title="geda-file_format_spec.ru.html">Атрибуты</a>.
811 </p>
812
813 <p>
814 Допускается: в файлах схем и символов
815 </p>
816
817 <p>
818 <strong><code>type x y color size visibility show_name_value angle alignment
819 num_lines<br/>
820
821 string line 1<br/>
822
823 string line 2<br/>
824
825 string line 3<br/>
826
827 …<br/>
828
829 string line N</code></strong>
830 </p>
831 <div class="table sectionedit20"><table class="inline">
832 <thead>
833 <tr class="row0">
834 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
835 </tr>
836 </thead>
837 <tr class="row1">
838 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">T</td>
839 </tr>
840 <tr class="row2">
841 <td class="col0 rightalign"> 1 </td><td class="col1">x</td><td class="col2">int/милы</td><td class="col3">Координата X первой точки</td>
842 </tr>
843 <tr class="row3">
844 <td class="col0 rightalign"> 2 </td><td class="col1">y</td><td class="col2">int/милы</td><td class="col3">Координата Y первой точки</td>
845 </tr>
846 <tr class="row4">
847 <td class="col0 rightalign"> 3 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
848 </tr>
849 <tr class="row5">
850 <td class="col0 rightalign"> 4 </td><td class="col1">size</td><td class="col2">int/пункты</td><td class="col3">Размер текста</td>
851 </tr>
852 <tr class="row6">
853 <td class="col0 rightalign"> 5 </td><td class="col1">visibility</td><td class="col2">int</td><td class="col3">Видимость текста</td>
854 </tr>
855 <tr class="row7">
856 <td class="col0 rightalign"> 6 </td><td class="col1">show_name_value</td><td class="col2">int</td><td class="col3">Управление видимостью атрибута</td>
857 </tr>
858 <tr class="row8">
859 <td class="col0 rightalign"> 7 </td><td class="col1">angle</td><td class="col2">int/градусы</td><td class="col3">Угол поворота текста</td>
860 </tr>
861 <tr class="row9">
862 <td class="col0 rightalign"> 8 </td><td class="col1">alignment</td><td class="col2">int</td><td class="col3">Выравнивание/точка привязки текста</td>
863 </tr>
864 <tr class="row10">
865 <td class="col0 rightalign"> 9 </td><td class="col1">num_lines</td><td class="col2">int</td><td class="col3">Количество строк текста (начальное значение 1)</td>
866 </tr>
867 <tr class="row11">
868 <td class="col0 rightalign"> 10 </td><td class="col1">string line 1 … N</td><td class="col2">string</td><td class="col3">Собственно отдельные строки текста</td>
869 </tr>
870 </table></div>
871 <!-- EDIT20 TABLE [28224-29055] --><ul>
872 <li class="level1"><div class="li"> Данный объект является многострочным. Первая строка содержит все параметры текста, а последующие содержат собственно текст.</div>
873 </li>
874 <li class="level1"><div class="li"> Должно быть точно <code>num_lines</code> строк текста, следующих за строкой T … .</div>
875 </li>
876 <li class="level1"><div class="li"> Максимальная длина отдельных строк текста составляет 1024, но ограничений на количество строк нет.</div>
877 </li>
878 <li class="level1"><div class="li"> Минимальный размер составляет 2 пункта (пункт=1/72 дюйма).</div>
879 </li>
880 <li class="level1"><div class="li"> Максимального размера нет.</div>
881 </li>
882 <li class="level1"><div class="li"> Пара координат является точкой привязки текстового элемента.</div>
883 </li>
884 <li class="level1 node"><div class="li"> Параметр <code>visibility</code> перечислимого типа:</div>
885 <ul>
886 <li class="level2"><div class="li"> INVISIBLE = 0 (невидимый)</div>
887 </li>
888 <li class="level2"><div class="li"> VISIBLE = 1 (видимый)</div>
889 </li>
890 </ul>
891 </li>
892 <li class="level1 node"><div class="li"> Параметр <code>show_name_value</code> перечислимого типа:</div>
893 <ul>
894 <li class="level2"><div class="li"> SHOW NAME VALUE = 0 (показывать имя и значение атрибута)</div>
895 </li>
896 <li class="level2"><div class="li"> SHOW VALUE = 1 (показывать только значение атрибута)</div>
897 </li>
898 <li class="level2"><div class="li"> SHOW NAME = 2 (показывать только имя атрибута)</div>
899 </li>
900 </ul>
901 </li>
902 <li class="level1"><div class="li"> Параметр <code>show_name_value</code> действителен только в случае, если строка является атрибутом (чтобы строка считалась атрибутом, она должна иметь вид: <code>имя_атрибута=значение</code>).</div>
903 </li>
904 <li class="level1"><div class="li"> Параметр угла поворота текста <code>angle</code> может принимать только одно из следующих значений: 0, 90, 180, 270. При значении 270 всегда будет производиться вертикальный текст.</div>
905 </li>
906 <li class="level1"><div class="li"> Параметр выравнивания/привязки <code>alignment</code> управляет относительным положением точки привязки.</div>
907 </li>
908 <li class="level1"><div class="li"> Параметр <code>alignment</code> может принимать значения от 0 до 8. <br/>
909 На следующем рисунке показано действие значений параметра <code>alignment</code>.</div>
910 </li>
911 </ul>
912
913 <p>
914 <a href="media/geda/fileformat_textgraphic.jpg" class="media" target="_blank" title="geda:fileformat_textgraphic.jpg"><img src="media/geda/fileformat_textgraphic.jpg" class="media" alt="" /></a>
915 </p>
916 <ul>
917 <li class="level1"><div class="li"> Исходное значение параметра <code>num_lines</code> всегда равно 1. <br/>
918 Поле <code>num_lines</code> было добавлено начиная с версии 1 формата файла. Предыдущие версии (0 и ранее) поддерживали только однострочные текстовые объекты.</div>
919 </li>
920 <li class="level1"><div class="li"> Горизонтальная черта над текстовыми строками задаётся ограничивающими текст с двух сторон маркерами надчёркивания вида <strong>«\_»</strong>. Символ обратной косой черты записывается в виде <strong>«\\»</strong>.</div>
921 </li>
922 </ul>
923
924 <p>
925 Пример 1:
926 </p>
927 <pre class="code">T 16900 35800 3 10 1 0 0 0 1
928 Text string!</pre>
929
930 <p>
931 Текстовый объект с точкой привязки в (16900, 35800), цветовой индекс 3,
932 размером 10 пунктов, видимый, флаги атрибута не действуют (объект не
933 является атрибутом), точка привязки в левом нижнем углу, без поворота,
934 строка: Text string!
935 </p>
936
937 <p>
938 Пример 2:
939 </p>
940 <pre class="code">T 16900 35800 3 10 1 0 0 0 5
941 Text string line 1
942 Text string line 2
943 Text string line 3
944 Text string line 4
945 Text string line 5</pre>
946
947 <p>
948 Данный текстовый объект подобен указанному в примере выше, но здесь пять
949 строк текста.
950 </p>
951
952 <p>
953 Пример 3:
954 </p>
955 <pre class="code">T 10000 20000 3 10 1 1 8 90 1
956 pinlabel=R/\_W\_</pre>
957
958 <p>
959 Текстовый объект с точкой привязки (10000, 20000), цветовой индекс 3,
960 размером 10 пунктов, видимый, видимо только значение атрибута, точка
961 привязки находится в верхнем правом углу, текст повёрнут на 90 градусов,
962 строка: «R/W», над буквой «W» горизонтальная черта.
963 </p>
964
965 </div>
966 <!-- EDIT19 SECTION "Текст и атрибуты" [27460-33424] -->
967 <h3 class="sectionedit21" id="соединение">Соединение</h3>
968 <div class="level3">
969
970 <p>
971 Допускается: ТОЛЬКО в файлах схем
972 </p>
973
974 <p>
975 <strong><code>type x1 y1 x2 y2 color</code></strong>
976 </p>
977 <div class="table sectionedit22"><table class="inline">
978 <thead>
979 <tr class="row0">
980 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
981 </tr>
982 </thead>
983 <tr class="row1">
984 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">N</td>
985 </tr>
986 <tr class="row2">
987 <td class="col0 rightalign"> 1 </td><td class="col1">x1</td><td class="col2">int/милы</td><td class="col3">Координата X первой точки</td>
988 </tr>
989 <tr class="row3">
990 <td class="col0 rightalign"> 2 </td><td class="col1">y1</td><td class="col2">int/милы</td><td class="col3">Координата Y первой точки</td>
991 </tr>
992 <tr class="row4">
993 <td class="col0 rightalign"> 3 </td><td class="col1">x2</td><td class="col2">int/милы</td><td class="col3">Координата X второй точки</td>
994 </tr>
995 <tr class="row5">
996 <td class="col0 rightalign"> 4 </td><td class="col1">y2</td><td class="col2">int/милы</td><td class="col3">Координата Y второй точки</td>
997 </tr>
998 <tr class="row6">
999 <td class="col0 rightalign"> 5 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
1000 </tr>
1001 </table></div>
1002 <!-- EDIT22 TABLE [33551-33960] --><ul>
1003 <li class="level1"><div class="li"> Соединения могут использоваться только в файлах схем.</div>
1004 </li>
1005 <li class="level1"><div class="li"> Нельзя использовать соединения нулевой длины (они отбрасываются программами).</div>
1006 </li>
1007 </ul>
1008
1009 <p>
1010 Пример:
1011 </p>
1012 <pre class="code">N 12700 29400 32900 29400 4</pre>
1013
1014 <p>
1015 Сегмент соединения от (12700, 29400) до (32900, 29400) с цветовым индексом
1016 4.
1017 </p>
1018
1019 </div>
1020 <!-- EDIT21 SECTION "Соединение" [33425-34388] -->
1021 <h3 class="sectionedit23" id="шина">Шина</h3>
1022 <div class="level3">
1023
1024 <p>
1025 Допускается: ТОЛЬКО в файлах схем
1026 </p>
1027
1028 <p>
1029 <strong><code>type x1 y1 x2 y2 color ripperdir</code></strong>
1030 </p>
1031 <div class="table sectionedit24"><table class="inline">
1032 <thead>
1033 <tr class="row0">
1034 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
1035 </tr>
1036 </thead>
1037 <tr class="row1">
1038 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">U</td>
1039 </tr>
1040 <tr class="row2">
1041 <td class="col0 rightalign"> 1 </td><td class="col1">x1</td><td class="col2">int/милы</td><td class="col3">Координата X первой точки</td>
1042 </tr>
1043 <tr class="row3">
1044 <td class="col0 rightalign"> 2 </td><td class="col1">y1</td><td class="col2">int/милы</td><td class="col3">Координата Y первой точки</td>
1045 </tr>
1046 <tr class="row4">
1047 <td class="col0 rightalign"> 3 </td><td class="col1">x2</td><td class="col2">int/милы</td><td class="col3">Координата X второй точки</td>
1048 </tr>
1049 <tr class="row5">
1050 <td class="col0 rightalign"> 4 </td><td class="col1">y2</td><td class="col2">int/милы</td><td class="col3">Координата Y второй точки</td>
1051 </tr>
1052 <tr class="row6">
1053 <td class="col0 rightalign"> 5 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
1054 </tr>
1055 <tr class="row7">
1056 <td class="col0 rightalign"> 6 </td><td class="col1">ripperdir</td><td class="col2">int</td><td class="col3">Направление ответвлений от шины</td>
1057 </tr>
1058 </table></div>
1059 <!-- EDIT24 TABLE [34513-35004] --><ul>
1060 <li class="level1"><div class="li"> Значение параметра <code>ripperdir</code> для свежесозданной шины устанавливается в 0.</div>
1061 </li>
1062 <li class="level1"><div class="li"> При первом подключении соединения к шине параметр <code>ripperdir</code> принимает значение 1 или -1. Это значение определяет направление символа ответвления (ripper). Направление ответвления для объекта шины остаётся одним и тем же на всё время существования данного объекта.</div>
1063 </li>
1064 <li class="level1"><div class="li"> Шины могут использоваться только в файлах схем.</div>
1065 </li>
1066 <li class="level1"><div class="li"> Нельзя использовать шины нулевой длины (они отбрасываются программами).</div>
1067 </li>
1068 </ul>
1069
1070 <p>
1071 Пример:
1072 </p>
1073 <pre class="code">U 27300 37400 27300 35300 3 0</pre>
1074
1075 <p>
1076 Сегмент шины от (27300, 37400) до (27300, 35300) с цветовым индексом 3 и без
1077 подключения соединений к данному сегменту.
1078 </p>
1079
1080 </div>
1081 <!-- EDIT23 SECTION "Шина" [34389-36100] -->
1082 <h3 class="sectionedit25" id="вывод">Вывод</h3>
1083 <div class="level3">
1084
1085 <p>
1086 Допускается: ТОЛЬКО в файлах символов
1087 </p>
1088
1089 <p>
1090 <strong><code>type x1 y1 x2 y2 color pintype whichend</code></strong>
1091 </p>
1092 <div class="table sectionedit26"><table class="inline">
1093 <thead>
1094 <tr class="row0">
1095 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
1096 </tr>
1097 </thead>
1098 <tr class="row1">
1099 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">P</td>
1100 </tr>
1101 <tr class="row2">
1102 <td class="col0 rightalign"> 1 </td><td class="col1">x1</td><td class="col2">int/милы</td><td class="col3">Координата X первой точки</td>
1103 </tr>
1104 <tr class="row3">
1105 <td class="col0 rightalign"> 2 </td><td class="col1">y1</td><td class="col2">int/милы</td><td class="col3">Координата Y первой точки</td>
1106 </tr>
1107 <tr class="row4">
1108 <td class="col0 rightalign"> 3 </td><td class="col1">x2</td><td class="col2">int/милы</td><td class="col3">Координата X второй точки</td>
1109 </tr>
1110 <tr class="row5">
1111 <td class="col0 rightalign"> 4 </td><td class="col1">y2</td><td class="col2">int/милы</td><td class="col3">Координата Y второй точки</td>
1112 </tr>
1113 <tr class="row6">
1114 <td class="col0 rightalign"> 5 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
1115 </tr>
1116 <tr class="row7">
1117 <td class="col0 rightalign"> 6 </td><td class="col1">pintype</td><td class="col2">int</td><td class="col3">Тип вывода</td>
1118 </tr>
1119 <tr class="row8">
1120 <td class="col0 rightalign"> 7 </td><td class="col1">whichend</td><td class="col2">int</td><td class="col3">Указывает активный конец</td>
1121 </tr>
1122 </table></div>
1123 <!-- EDIT26 TABLE [36242-36759] --><ul>
1124 <li class="level1 node"><div class="li"> Параметр <code>pintype</code> перечислимого типа:</div>
1125 <ul>
1126 <li class="level2"><div class="li"> NORMAL PIN = 0</div>
1127 </li>
1128 <li class="level2"><div class="li"> BUS PIN = 1 (не используется)</div>
1129 </li>
1130 </ul>
1131 </li>
1132 <li class="level1"><div class="li"> <code>whichend</code> определяет какой конец вывода является точкой соединения. Другие выводы или соединения могут подключаться только к данной точке.</div>
1133 </li>
1134 <li class="level1"><div class="li"> Значение 0 параметра <code>whichend</code> определяет для соединения первую точку вывода, значение 1 — вторую.</div>
1135 </li>
1136 <li class="level1"><div class="li"> Выводы могут использоваться только в файлах символов.</div>
1137 </li>
1138 <li class="level1"><div class="li"> Допускается использовать выводы нулевой длины.</div>
1139 </li>
1140 </ul>
1141
1142 <p>
1143 Пример:
1144 </p>
1145 <pre class="code">P 0 200 200 200 1 0 0</pre>
1146
1147 <p>
1148 Вывод от (0, 200) до (200, 200) с цветовым индексом 1, обычный вывод, для
1149 соединения используется первая точка.
1150 </p>
1151
1152 </div>
1153 <!-- EDIT25 SECTION "Вывод" [36101-37770] -->
1154 <h3 class="sectionedit27" id="компонент">Компонент</h3>
1155 <div class="level3">
1156
1157 <p>
1158 Допускается: ТОЛЬКО в файлах схем
1159 </p>
1160
1161 <p>
1162 <strong><code>type x y selectable angle mirror basename</code></strong>
1163 </p>
1164 <div class="table sectionedit28"><table class="inline">
1165 <thead>
1166 <tr class="row0">
1167 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
1168 </tr>
1169 </thead>
1170 <tr class="row1">
1171 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">C</td>
1172 </tr>
1173 <tr class="row2">
1174 <td class="col0 rightalign"> 1 </td><td class="col1">x</td><td class="col2">int/милы</td><td class="col3">Координата X точки привязки</td>
1175 </tr>
1176 <tr class="row3">
1177 <td class="col0 rightalign"> 2 </td><td class="col1">y</td><td class="col2">int/милы</td><td class="col3">Координата Y точки привязки</td>
1178 </tr>
1179 <tr class="row4">
1180 <td class="col0 rightalign"> 3 </td><td class="col1">selectable</td><td class="col2">int</td><td class="col3">Флаг выделения</td>
1181 </tr>
1182 <tr class="row5">
1183 <td class="col0 rightalign"> 4 </td><td class="col1">angle</td><td class="col2">int/градусы</td><td class="col3">Угол поворота компонента</td>
1184 </tr>
1185 <tr class="row6">
1186 <td class="col0 rightalign"> 5 </td><td class="col1">mirror</td><td class="col2">int</td><td class="col3">Отражение относительно оси Y</td>
1187 </tr>
1188 <tr class="row7">
1189 <td class="col0 rightalign"> 6 </td><td class="col1">basename</td><td class="col2">string</td><td class="col3">Имя файла компонента</td>
1190 </tr>
1191 </table></div>
1192 <!-- EDIT28 TABLE [37914-38405] --><ul>
1193 <li class="level1"><div class="li"> Параметр <code>selectable</code> принимает значение 1 для выделяемых, и 0 для невыделяемых компонентов.</div>
1194 </li>
1195 <li class="level1"><div class="li"> Параметр угла поворота компонента <code>angle</code> может принимать только одно из следующих значений: 0, 90, 180, 270.</div>
1196 </li>
1197 <li class="level1"><div class="li"> Параметр угла поворота <code>angle</code> может принимать только положительные значения.</div>
1198 </li>
1199 <li class="level1"><div class="li"> Значение флага <code>mirror</code> равно 0, если компонент не отражён (относительно оси Y).</div>
1200 </li>
1201 <li class="level1"><div class="li"> Значение флага <code>mirror</code> равно 1, если компонент зеркально отражён (относительно оси Y).</div>
1202 </li>
1203 <li class="level1"><div class="li"> <code>basename</code> определяет имя файла компонента. Это имя относительное, то есть не содержит полного пути доступа к данному файлу.</div>
1204 </li>
1205 </ul>
1206
1207 <p>
1208 Пример:
1209 </p>
1210 <pre class="code">C 18600 19900 1 0 0 7400-1.sym</pre>
1211
1212 <p>
1213 Компонент с точкой привязки в (18600,19900), выделяемый, без поворота, без
1214 отражения, имя файла компонента 7400-1.sym.
1215 </p>
1216
1217 </div>
1218 <!-- EDIT27 SECTION "Компонент" [37771-39684] -->
1219 <h3 class="sectionedit29" id="контур">Контур</h3>
1220 <div class="level3">
1221
1222 <p>
1223 Допускается: в файлах схем и символов
1224 </p>
1225
1226 <p>
1227 Действителен: с версии 2 формата файла (выпуск 1.5.1)
1228 </p>
1229
1230 <p>
1231 <strong><code>type color width capstyle dashstyle dashlength dashspace filltype
1232 fillwidth angle1 pitch1 angle2 pitch2 numlines<br/>
1233
1234 path data line 1<br/>
1235
1236 path data line 2<br/>
1237
1238 path data line 3<br/>
1239
1240 …<br/>
1241
1242 path data line N</code></strong>
1243 </p>
1244 <div class="table sectionedit30"><table class="inline">
1245 <thead>
1246 <tr class="row0">
1247 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
1248 </tr>
1249 </thead>
1250 <tr class="row1">
1251 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">H</td>
1252 </tr>
1253 <tr class="row2">
1254 <td class="col0 rightalign"> 1 </td><td class="col1">color</td><td class="col2">int</td><td class="col3">Цветовой индекс</td>
1255 </tr>
1256 <tr class="row3">
1257 <td class="col0 rightalign"> 2 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Толщина линий</td>
1258 </tr>
1259 <tr class="row4">
1260 <td class="col0 rightalign"> 3 </td><td class="col1">capstyle</td><td class="col2">int</td><td class="col3">Стиль концов линий</td>
1261 </tr>
1262 <tr class="row5">
1263 <td class="col0 rightalign"> 4 </td><td class="col1">dashstyle</td><td class="col2">int</td><td class="col3">Тип линий</td>
1264 </tr>
1265 <tr class="row6">
1266 <td class="col0 rightalign"> 5 </td><td class="col1">dashlength</td><td class="col2">int/милы</td><td class="col3">Длина штриха</td>
1267 </tr>
1268 <tr class="row7">
1269 <td class="col0 rightalign"> 6 </td><td class="col1">dashspace</td><td class="col2">int/милы</td><td class="col3">Интервал между штрихами</td>
1270 </tr>
1271 <tr class="row8">
1272 <td class="col0 rightalign"> 7 </td><td class="col1">filltype</td><td class="col2">int</td><td class="col3">Тип заполнения</td>
1273 </tr>
1274 <tr class="row9">
1275 <td class="col0 rightalign"> 8 </td><td class="col1">fillwidth</td><td class="col2">int/милы</td><td class="col3">Толщина линий заполнения</td>
1276 </tr>
1277 <tr class="row10">
1278 <td class="col0 rightalign"> 9 </td><td class="col1">angle1</td><td class="col2">int/градусы</td><td class="col3">Первый угол заполнения</td>
1279 </tr>
1280 <tr class="row11">
1281 <td class="col0 rightalign"> 10 </td><td class="col1">pitch1</td><td class="col2">int/милы</td><td class="col3">Первый шаг/интервал заполнения</td>
1282 </tr>
1283 <tr class="row12">
1284 <td class="col0 rightalign"> 11 </td><td class="col1">angle2</td><td class="col2">int/градусы</td><td class="col3">Второй угол заполнения</td>
1285 </tr>
1286 <tr class="row13">
1287 <td class="col0 rightalign"> 12 </td><td class="col1">pitch2</td><td class="col2">int/милы</td><td class="col3">Второй шаг/интервал заполнения</td>
1288 </tr>
1289 <tr class="row14">
1290 <td class="col0 rightalign"> 13 </td><td class="col1">num_lines</td><td class="col2">int</td><td class="col3">Количество строк данных контура (начальное значение 1)</td>
1291 </tr>
1292 <tr class="row15">
1293 <td class="col0 rightalign"> 14 </td><td class="col1">path data line 1 … N</td><td class="col2">path data</td><td class="col3">Отдельные строки данных контура</td>
1294 </tr>
1295 </table></div>
1296 <!-- EDIT30 TABLE [40074-41156] --><ul>
1297 <li class="level1 node"><div class="li"> Параметр <code>capstyle</code> перечислимого типа:</div>
1298 <ul>
1299 <li class="level2"><div class="li"> END NONE = 0 (без стиля)</div>
1300 </li>
1301 <li class="level2"><div class="li"> END SQUARE = 1 (квадратные концы)</div>
1302 </li>
1303 <li class="level2"><div class="li"> END ROUND = 2 (круглые концы)</div>
1304 </li>
1305 </ul>
1306 </li>
1307 </ul>
1308 <ul>
1309 <li class="level1 node"><div class="li"> Параметр <code>dashstyle</code> перечислимого типа:</div>
1310 <ul>
1311 <li class="level2"><div class="li"> TYPE SOLID = 0 (сплошная линия)</div>
1312 </li>
1313 <li class="level2"><div class="li"> TYPE DOTTED = 1 (пунктир)</div>
1314 </li>
1315 <li class="level2"><div class="li"> TYPE DASHED = 2 (штрих)</div>
1316 </li>
1317 <li class="level2"><div class="li"> TYPE CENTER = 3 (штрих-пунктир)</div>
1318 </li>
1319 <li class="level2"><div class="li"> TYPE PHANTOM = 4 (двойной штрих-пунктир)</div>
1320 </li>
1321 </ul>
1322 </li>
1323 <li class="level1"><div class="li"> Параметр <code>dashlength</code> не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1.</div>
1324 </li>
1325 <li class="level1"><div class="li"> Параметр <code>dashspace</code> не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1.</div>
1326 </li>
1327 </ul>
1328 <ul>
1329 <li class="level1 node"><div class="li"> Параметр <code>filltype</code> перечислимого типа:</div>
1330 <ul>
1331 <li class="level2"><div class="li"> FILLING HOLLOW = 0 (без заполнения)</div>
1332 </li>
1333 <li class="level2"><div class="li"> FILLING FILL = 1 (сплошное заполнение)</div>
1334 </li>
1335 <li class="level2"><div class="li"> FILLING MESH = 2 (сетка)</div>
1336 </li>
1337 <li class="level2"><div class="li"> FILLING HATCH = 3 (штриховка)</div>
1338 </li>
1339 <li class="level2"><div class="li"> FILLING VOID = 4 (не используется)</div>
1340 </li>
1341 </ul>
1342 </li>
1343 <li class="level1"><div class="li"> Если значение <code>filltype</code> равно 0 (FILLING HOLLOW), то все остальные параметры заполнения должны иметь значение -1.</div>
1344 </li>
1345 <li class="level1"><div class="li"> Тип заполнения FILLING FILL используется для заполнения сплошным цветом.</div>
1346 </li>
1347 <li class="level1"><div class="li"> Для типа заполнения FILLING MESH заполнением или штриховкой управляют две пары наклон/интервал.</div>
1348 </li>
1349 <li class="level1"><div class="li"> Для типа заполнения FILLING HATCH используется только первая пара наклон/интервал.</div>
1350 </li>
1351 </ul>
1352 <ul>
1353 <li class="level1"><div class="li"> Формат данных контура умышленно выбран подобным формату <a href="http://www.w3.org/TR/SVG/paths.html" class="urlextern" title="http://www.w3.org/TR/SVG/paths.html" rel="nofollow">контуров в стандарте W3C SVG</a>.</div>
1354 </li>
1355 <li class="level1"><div class="li"> Выпущенное в gEDA подмножество синтаксиса контуров SVG документировано ниже в разделе <a href="#данные_контура" title=":geda:file_format_spec.ru.txt ↵" class="wikilink1">Данные контура</a>.</div>
1356 </li>
1357 <li class="level1"><div class="li"> Детали реализации; код <strong>libgeda</strong> взят из <strong>librsvg</strong>, библиотеки синтаксического анализа SVG. В результате большая часть синтаксиса контуров SVG читается правильно, однако синтаксис всегда внутренне нормализуется в абсолютные команды <code>move</code>, <code>line</code>, <code>bezier curve</code> и <code>close-path</code> (и сохраняется в таком виде).</div>
1358 </li>
1359 <li class="level1"><div class="li"> Координаты всего контура указываются в стандартной координатной системе <strong>gschem</strong>.</div>
1360 </li>
1361 </ul>
1362
1363 <p>
1364 Пример:
1365 </p>
1366 <pre class="code">H 3 10 0 0 -1 -1 0 -1 -1 -1 -1 -1 5
1367 M 410,240
1368 L 501,200
1369 L 455,295
1370 L 435,265
1371 z</pre>
1372
1373 <p>
1374 Контур, начинающийся в (410,240), с линиями, начинающимися оттуда и
1375 соединяющими точки (501,200), (455,295), (435,265), замыкающийся обратно в
1376 исходную точку. Цветовой индекс 3, толщина линий 10 милов, без стиля концов,
1377 сплошная. Данные контура содержат 5 строк.
1378 </p>
1379
1380 </div>
1381 <!-- EDIT29 SECTION "Контур" [39685-44697] -->
1382 <h3 class="sectionedit31" id="шрифт">Шрифт</h3>
1383 <div class="level3">
1384
1385 <p>
1386 Допускается: ТОЛЬКО в специальных файлах шрифтов
1387 </p>
1388
1389 <p>
1390 <strong><code>type character width flag</code></strong>
1391 </p>
1392 <div class="table sectionedit32"><table class="inline">
1393 <thead>
1394 <tr class="row0">
1395 <th class="col0">Поз.</th><th class="col1">Поле</th><th class="col2">Тип/единица</th><th class="col3">Описание</th>
1396 </tr>
1397 </thead>
1398 <tr class="row1">
1399 <td class="col0 rightalign"> # </td><td class="col1">type</td><td class="col2">char</td><td class="col3">F</td>
1400 </tr>
1401 <tr class="row2">
1402 <td class="col0 rightalign"> 1 </td><td class="col1">character</td><td class="col2">char</td><td class="col3">Определяемый символ</td>
1403 </tr>
1404 <tr class="row3">
1405 <td class="col0 rightalign"> 2 </td><td class="col1">width</td><td class="col2">int/милы</td><td class="col3">Ширина символа (в милах)</td>
1406 </tr>
1407 <tr class="row4">
1408 <td class="col0 rightalign"> 3 </td><td class="col1">flag</td><td class="col2">int</td><td class="col3">Специальный флаг пробела</td>
1409 </tr>
1410 </table></div>
1411 <!-- EDIT32 TABLE [44846-45119] --><ul>
1412 <li class="level1"><div class="li"> Это специальный объект, который должен использоваться ТОЛЬКО в файлах определения шрифтов.</div>
1413 </li>
1414 <li class="level1"><div class="li"> Если определяемый символ шрифта является символом пробела (с кодом 32), то значение флага <code>flag</code> должно быть 1, иначе 0.</div>
1415 </li>
1416 </ul>
1417
1418 <p>
1419 Пример:
1420 </p>
1421 <pre class="code">F 11 1</pre>
1422
1423 <p>
1424 Выше приведено определение символа пробела в шрифте.
1425 </p>
1426
1427 </div>
1428 <!-- EDIT31 SECTION "Шрифт" [44698-45643] -->
1429 <h2 class="sectionedit33" id="цвета">Цвета</h2>
1430 <div class="level2">
1431
1432 <p>
1433 В формате файлов символов и схем gEDA/gaf цвета определяются посредством
1434 целочисленного индекса. Соответствие между числом и цветом основывается на
1435 типе объекта. Для каждого типа объекта обычно используется один или более
1436 цветов. Здесь приведена таблица соответствия цветовых индексов типам
1437 объектов:
1438 </p>
1439 <div class="table sectionedit34"><table class="inline">
1440 <thead>
1441 <tr class="row0">
1442 <th class="col0">Индекс</th><th class="col1">Тип объекта</th><th class="col2">Примечание</th>
1443 </tr>
1444 </thead>
1445 <tr class="row1">
1446 <td class="col0">0</td><td class="col1">BACKGROUND_COLOR</td><td class="col2">Фон</td>
1447 </tr>
1448 <tr class="row2">
1449 <td class="col0">1</td><td class="col1">PIN_COLOR</td><td class="col2">Вывод</td>
1450 </tr>
1451 <tr class="row3">
1452 <td class="col0">2</td><td class="col1">NET_ENDPOINT_COLOR</td><td class="col2">Конечная точка соединения</td>
1453 </tr>
1454 <tr class="row4">
1455 <td class="col0">3</td><td class="col1">GRAPHIC_COLOR</td><td class="col2">Графический объект</td>
1456 </tr>
1457 <tr class="row5">
1458 <td class="col0">4</td><td class="col1">NET_COLOR</td><td class="col2">Соединение</td>
1459 </tr>
1460 <tr class="row6">
1461 <td class="col0">5</td><td class="col1">ATTRIBUTE_COLOR</td><td class="col2">Атрибут</td>
1462 </tr>
1463 <tr class="row7">
1464 <td class="col0">6</td><td class="col1">LOGIC_BUBBLE_COLOR</td><td class="col2">Логическая инверсия</td>
1465 </tr>
1466 <tr class="row8">
1467 <td class="col0">7</td><td class="col1">DOTS_GRID_COLOR</td><td class="col2">Сетка</td>
1468 </tr>
1469 <tr class="row9">
1470 <td class="col0">8</td><td class="col1">DETACHED_ATTRIBUTE_COLOR</td><td class="col2">Неприкреплённый атрибут</td>
1471 </tr>
1472 <tr class="row10">
1473 <td class="col0">9</td><td class="col1">TEXT_COLOR</td><td class="col2">Текст</td>
1474 </tr>
1475 <tr class="row11">
1476 <td class="col0">10</td><td class="col1">BUS_COLOR</td><td class="col2">Шина</td>
1477 </tr>
1478 <tr class="row12">
1479 <td class="col0">11</td><td class="col1">SELECT_COLOR</td><td class="col2">Выделение</td>
1480 </tr>
1481 <tr class="row13">
1482 <td class="col0">12</td><td class="col1">BOUNDINGBOX_COLOR</td><td class="col2">Контур объекта</td>
1483 </tr>
1484 <tr class="row14">
1485 <td class="col0">13</td><td class="col1">ZOOM_BOX_COLOR</td><td class="col2">Контур области масштабирования</td>
1486 </tr>
1487 <tr class="row15">
1488 <td class="col0">14</td><td class="col1">STROKE_COLOR</td><td class="col2">Жесты</td>
1489 </tr>
1490 <tr class="row16">
1491 <td class="col0">15</td><td class="col1">LOCK_COLOR</td><td class="col2">Заблокированный объект</td>
1492 </tr>
1493 <tr class="row17">
1494 <td class="col0">16</td><td class="col1">OUTPUT_BACKGROUND_COLOR</td><td class="col2">Выходной фон</td>
1495 </tr>
1496 <tr class="row18">
1497 <td class="col0">17</td><td class="col1">FREESTYLE1_COLOR</td><td class="col2">Свободный стиль 1</td>
1498 </tr>
1499 <tr class="row19">
1500 <td class="col0">18</td><td class="col1">FREESTYLE2_COLOR</td><td class="col2">Свободный стиль 2</td>
1501 </tr>
1502 <tr class="row20">
1503 <td class="col0">19</td><td class="col1">FREESTYLE3_COLOR</td><td class="col2">Свободный стиль 3</td>
1504 </tr>
1505 <tr class="row21">
1506 <td class="col0">20</td><td class="col1">FREESTYLE4_COLOR</td><td class="col2">Свободный стиль 4</td>
1507 </tr>
1508 <tr class="row22">
1509 <td class="col0">21</td><td class="col1">JUNCTION_COLOR</td><td class="col2">Точка соединения</td>
1510 </tr>
1511 <tr class="row23">
1512 <td class="col0">22</td><td class="col1">MESH_GRID_MAJOR_COLOR</td><td class="col2">Главная штриховка сетки</td>
1513 </tr>
1514 <tr class="row24">
1515 <td class="col0">23</td><td class="col1">MESH_GRID_MINOR_COLOR</td><td class="col2">Второстепенная штриховка сетки</td>
1516 </tr>
1517 </table></div>
1518 <!-- EDIT34 TABLE [46219-47477] -->
1519 <p>
1520 Фактический цвет, связанный с цветовым индексом, определяется на основе
1521 используемых инструментов. Объектам обычно назначается соответствующий им
1522 цветовой индекс, но допустимо (иногда) назначать цвет, отличный от присущего
1523 данному типу объектов.
1524 </p>
1525
1526 </div>
1527 <!-- EDIT33 SECTION "Цвета" [45644-47934] -->
1528 <h2 class="sectionedit35" id="атрибуты">Атрибуты</h2>
1529 <div class="level2">
1530
1531 <p>
1532 Атрибуты заключаются в фигурные скобки {} и могут быть только текстовыми
1533 объектами. Атрибуты представляют собой текстовые элементы вида
1534 <code>имя_атрибута=значение</code>. Если текст не содержит пары
1535 <code>имя_атрибута=значение</code>, он не является атрибутом. Атрибуты прикрепляются
1536 к предшествующему объекту. Вот пример:
1537 </p>
1538 <pre class="code">P 988 500 1300 500 1
1539 {
1540 T 1000 570 5 8 1 1 0
1541 pinseq=3
1542 T 1000 550 5 8 1 1 0
1543 pinnumber=3
1544 }</pre>
1545
1546 <p>
1547 Данный объект является выводом, имеющим атрибуты <code>pinnumber=3</code> и
1548 <code>pinseq=3</code> (<code>имя_атрибута=значение</code>). Внутри фигурных скобок {} может
1549 находиться несколько текстовых объектов (T … и текстовая строка
1550 обязательны). С версии 20021103 в качестве атрибутов можно использовать
1551 только текстовые элементы. Прикрепление других типов объектов в качестве
1552 атрибутов не поддерживается.
1553 </p>
1554
1555 <p>
1556 Можно использовать также атрибуты «верхнего уровня». Эти атрибуты не
1557 прикрепляются ни к какому объекту, а просто представляют собой текстовые
1558 объекты вида <code>имя_атрибута=значение</code>.
1559 </p>
1560
1561 <p>
1562 Данные атрибуты полезны в случаях, когда необходимо передать некоторую
1563 информацию о странице схемы или о символе и нужно, чтобы генератор списка
1564 соединений имел доступ к данной информации.
1565 </p>
1566
1567 </div>
1568 <!-- EDIT35 SECTION "Атрибуты" [47935-49967] -->
1569 <h2 class="sectionedit36" id="внедрённые_компоненты">Внедрённые компоненты</h2>
1570 <div class="level2">
1571
1572 <p>
1573 Внедрённые компоненты — это компоненты, определение которых полностью
1574 содержится внутри файла схемы. Когда пользователи помещают компоненты на
1575 страницы схемы, есть возможность делать компоненты внедрёнными. Это
1576 отличается от простого сохранения всей информации символа непосредственно в
1577 схеме, внедрённый компонент — это просто несколько иной
1578 компонент. Внедрённые компоненты указываются следующим образом:
1579 </p>
1580 <pre class="code">C 18600 21500 1 0 0 EMBEDDED555-1.sym
1581 [
1582 ...
1583 ... Embedded primitive objects
1584 ...
1585 ]</pre>
1586
1587 <p>
1588 В примере выше, <em><code>555-1.sym</code></em> — это компонент. Тег EMBEDDED и [ ] —
1589 отличительные характеристики внедрённого компонента. Если требуется отменить
1590 внедрение компонента, символ <em><code>имя_компонента.sym</code></em> должен
1591 присутствовать в одной из используемых библиотек.
1592 </p>
1593
1594 </div>
1595 <!-- EDIT36 SECTION "Внедрённые компоненты" [49968-51333] -->
1596 <h2 class="sectionedit37" id="данные_контура">Данные контура</h2>
1597 <div class="level2">
1598
1599 <p>
1600 Формат данных контуров gEDA/gaf умышленно определён таким образом, чтобы он
1601 соответствовал подмножеству <a href="http://www.w3.org/TR/SVG/paths.html" class="urlextern" title="http://www.w3.org/TR/SVG/paths.html" rel="nofollow">таковых в
1602 стандарте W3C SVG</a>.
1603 </p>
1604 <ul>
1605 <li class="level1"><div class="li"> Детали реализации; код <strong>libgeda</strong> взят из <strong>librsvg</strong>, библиотеки синтаксического анализа SVG. В результате большая часть синтаксиса контуров SVG читается правильно, однако синтаксис всегда внутренне нормализуется в абсолютные команды <code>move</code>, <code>line</code>, <code>bezier curve</code> и <code>close-path</code> (и сохраняется в таком виде).</div>
1606 </li>
1607 <li class="level1"><div class="li"> Координаты всего контура указываются в стандартной координатной системе <strong>gschem</strong>.</div>
1608 </li>
1609 <li class="level1"><div class="li"> Команды для контуров, выводимые и гарантированно обрабатываемые в gEDA, перечислены в нижеследующей таблице.<br/>
1610 (Текст взят из вышеуказанной спецификации SVG).</div>
1611 </li>
1612 <li class="level1 node"><div class="li"> В приведённой ниже таблице используются следующие условные обозначения:</div>
1613 <ul>
1614 <li class="level2"><div class="li"> (): группировка параметров</div>
1615 </li>
1616 <li class="level2"><div class="li"> +: требуется 1 заданный параметр или более</div>
1617 </li>
1618 </ul>
1619 </li>
1620 </ul>
1621 <div class="table sectionedit38"><table class="inline">
1622 <thead>
1623 <tr class="row0">
1624 <th class="col0">Команда</th><th class="col1">Название</th><th class="col2">Параметры</th><th class="col3">Описание</th>
1625 </tr>
1626 </thead>
1627 <tr class="row1">
1628 <td class="col0">M (абсолютная)</td><td class="col1">moveto</td><td class="col2">(x,y)+</td><td class="col3">Начало нового подконтура в заданной координате <code>(x,y)</code>. <code>M</code> (в верхнем регистре) указывает, что далее следуют абсолютные координаты; <code>m</code> (в нижнем регистре) указывает, что далее следуют относительные координаты. Если команда <code>moveto</code> в относительных координатах (<code>m</code>) является первым элементом контура, её координаты рассматриваются как абсолютные. Если после <code>moveto</code> указано несколько пар координат, последующие пары рассматриваются как неявные команды <code>lineto</code>.</td>
1629 </tr>
1630 <tr class="row2">
1631 <td class="col0">L (абсолютная)</td><td class="col1">lineto</td><td class="col2">(x,y)+</td><td class="col3">Вычерчивается линия из текущей точки в точку, заданную координатами <code>(x,y)</code>, которая становится новой текущей. <code>L</code> (в верхнем регистре) указывает, что далее следуют абсолютные координаты; <code>l</code> (в нижнем регистре) указывает, что далее следуют относительные координаты. Для вычерчивания ломаной линии может указываться несколько пар координат. В конце команды новой текущей точкой станет последняя заданная пара координат.</td>
1632 </tr>
1633 <tr class="row3">
1634 <td class="col0">C (абсолютная)</td><td class="col1">curveto</td><td class="col2">(x1,y1 x2,y2 x,y)+</td><td class="col3">Вычерчивается кривая Безье с кубической интерполяцией из текущей точки в точку <code>(x,y)</code>, используя <code>(x1,y1)</code> как контрольную точку в начале кривой и <code>(x2,y2)</code> как контрольную точку в конце кривой. <code>C</code> (в верхнем регистре) указывает, что далее следуют абсолютные координаты; <code>c</code> (в нижнем регистре) указывает, что далее следуют относительные координаты. Для вычерчивания сложной кривой Безье может указываться несколько наборов координат. В конце команды новой текущей точкой станет последняя пара координат <code>(x,y)</code> сложной кривой.</td>
1635 </tr>
1636 <tr class="row4">
1637 <td class="col0">Z или z</td><td class="col1">closepath</td><td class="col2">(нет)</td><td class="col3">Закрывает текущий подконтур вычерчиванием прямой линии из текущей точки в исходную точку данного подконтура.</td>
1638 </tr>
1639 </table></div>
1640 <!-- EDIT38 TABLE [52887-55876] --><ul>
1641 <li class="level1"><div class="li"> В настоящее время вывод вышеуказанных команд в gEDA производится только в виде версий с абсолютными координатами.</div>
1642 </li>
1643 <li class="level1"><div class="li"> В настоящее время вывод команд <code>M</code>, <code>L</code>, <code>C</code> в gEDA производится перед каждым набором координат, даже в случаях, если они могли бы быть опущены в соответствии со спецификацией SVG.</div>
1644 </li>
1645 <li class="level1"><div class="li"> В выводе gEDA между координатами <code>x,y</code> помещаются запятые. В соответствии со спецификацией SVG они могут замещаться пробельными символами.</div>
1646 </li>
1647 <li class="level1"><div class="li"> В настоящее время gEDA не поддерживает более одного подконтура.</div>
1648 </li>
1649 <li class="level1"><div class="li"> В настоящее время gEDA выводит по одной строке данных контура на команду + набор координат.</div>
1650 </li>
1651 </ul>
1652
1653 <p>
1654 Для примера начертим внешний контур символа AND по американскому стандарту.
1655 Данные контура:
1656 </p>
1657 <pre class="code">M 100,100 L 500,100 C 700,100 800,275 800,400
1658 C 800,525 700,700 500,700 L 100,700 z</pre>
1659
1660 <p>
1661 И полная схема:
1662 </p>
1663 <pre class="code">v 20080706 1
1664 H 3 0 0 0 -1 -1 0 2 20 100 -1 -1 6
1665 M 100,100
1666 L 500,100
1667 C 700,100 800,275 800,400
1668 C 800,525 700,700 500,700
1669 L 100,700
1670 z</pre>
1671
1672 <p>
1673 Здесь показан итоговый контур (с начерченными для иллюстрации их положения
1674 контрольными точками):
1675 </p>
1676
1677 <p>
1678 <a href="media/geda/path_example_and_gate-smaller.png" class="media" target="_blank" title="geda:path_example_and_gate-smaller.png"><img src="media/geda/path_example_and_gate-smaller.png" class="media" title="" alt="" /></a>
1679 </p>
1680
1681 </div>
1682 <!-- EDIT37 SECTION "Данные контура" [51334-57616] -->
1683 <h2 class="sectionedit39" id="история_изменений_документа">История изменений документа</h2>
1684 <div class="level2">
1685 <div class="table sectionedit40"><table class="inline">
1686 <tr class="row0">
1687 <td class="col0">30 ноября 2002 г. </td><td class="col1 leftalign">Создан fileformats.tex из fileformats.html. </td>
1688 </tr>
1689 <tr class="row1">
1690 <td class="col0">1 декабря 2002 г. </td><td class="col1 leftalign">Продолжена работа над данным документом. </td>
1691 </tr>
1692 <tr class="row2">
1693 <td class="col0">4 октября 2003 г. </td><td class="col1 leftalign">Добавлена информация о новом флаге версии формата файла. </td>
1694 </tr>
1695 <tr class="row3">
1696 <td class="col0">19 октября 2003 г.</td><td class="col1 leftalign">Добавлено поле <code>num_lines</code> для текстового объекта. </td>
1697 </tr>
1698 <tr class="row4">
1699 <td class="col0 leftalign">2 ноября 2008 г. </td><td class="col1 leftalign">Добавлен объект контура, версия формата файла изменена на 2. </td>
1700 </tr>
1701 <tr class="row5">
1702 <td class="col0 leftalign">26 мая, 2011 г. </td><td class="col1 leftalign">В таблицы параметров добавлены столбцы позиции. </td>
1703 </tr>
1704 </table></div>
1705 <!-- EDIT40 TABLE [57682-58441] -->
1706 </div>
1707 <!-- EDIT39 SECTION "История изменений документа" [57617-] --></body>
1708 </html>
geda-gaf git mirror