This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
geda:file_format_spec.ru [2012/02/20 15:14] 127.0.0.1 external edit |
geda:file_format_spec.ru [2014/04/25 08:06] vzh Updated using po4a |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | //Эта страница доступна также на следующих языках:// | ||
+ | [[file_format_spec|English]] | ||
+ | |||
====== Формат файлов gEDA/gaf ====== | ====== Формат файлов gEDA/gaf ====== | ||
Автор: Ales V. Hvezda, ahvezda@geda.seul.org | Автор: Ales V. Hvezda, ahvezda@geda.seul.org | ||
Line 7: | Line 10: | ||
31 декабря 2003 г. | 31 декабря 2003 г. | ||
- | Перевод: Владимир Жбанов, 2009--2011 гг.. | + | ===== Обзор ===== |
- | + | Здесь представлена официальная документация формата файлов gEDA/gaf | |
- | + | (__g__schem __a__nd __f__riends). Основным форматом в gEDA/gaf является | |
- | =====Обзор===== | + | |
- | Здесь представлена официальная документация формата файлов | + | |
- | gEDA/gaf (__g__schem __a__nd __f__riends). Основным форматом в gEDA/gaf является | + | |
формат файлов [[geda:glossary.ru#Принципиальная схема|электрических | формат файлов [[geda:glossary.ru#Принципиальная схема|электрических | ||
- | принципиальных схем]] и [[geda:glossary.ru#Символ|символов]] для них. Файлы с | + | принципиальных схем]] и [[geda:glossary.ru#Символ|символов]] для них. Файлы |
- | именами, заканчивающимися на //''.sch''// и //''.sym''//, являются соответственно файлами | + | с именами, заканчивающимися на //''.sch''// и //''.sym''//, являются |
- | схем и символов. Пока в gEDA/gaf нет других типов файлов, настоящий документ | + | соответственно файлами схем и символов. Пока в gEDA/gaf нет других типов |
- | будет относиться только к формату файлов схем/символов. | + | файлов, настоящий документ будет относиться только к формату файлов |
+ | схем/символов.\\ | ||
Настоящий документ находится в обращении с версии gEDA/gaf 20040111. Он | Настоящий документ находится в обращении с версии gEDA/gaf 20040111. Он | ||
- | охватывает версии формата 1 и 2. | + | охватывает версии формата 1 и 2.\\ |
Обратите внимание, что данный формат и любые другие форматы файлов, | Обратите внимание, что данный формат и любые другие форматы файлов, | ||
относящиеся к gEDA, находятся под лицензией General Public License (GPL) | относящиеся к gEDA, находятся под лицензией General Public License (GPL) | ||
версии 2.0. Авторские права на формат файлов схем/символов gEDA/gaf | версии 2.0. Авторские права на формат файлов схем/символов gEDA/gaf | ||
принадлежат Ales Hvezda (Copyright (C) 1998-2004 Ales Hvezda). | принадлежат Ales Hvezda (Copyright (C) 1998-2004 Ales Hvezda). | ||
- | |||
===== Система координат ===== | ===== Система координат ===== | ||
- | Все координаты задаются в милах (1/1000 дюйма). Это произвольное решение. | + | Все координаты задаются в милах (1/1000 дюйма). Это произвольное решение. Запомните, что в схемах и символах нет понятия физических длин/размеров (только при разработке принципиальных схем). |
- | Запомните, что в схемах и символах нет понятия физических длин/размеров | + | |
- | (только при разработке принципиальных схем). | + | |
* Начало координат находится в левом нижнем углу. | * Начало координат находится в левом нижнем углу. | ||
* Размеры координатного пространства неограничены, но рекомендуется размещать объекты в пределах (120.0, 90.0) (x, y, дюймов). | * Размеры координатного пространства неограничены, но рекомендуется размещать объекты в пределах (120.0, 90.0) (x, y, дюймов). | ||
Line 41: | Line 37: | ||
Значение по оси X возрастает слева направо, по оси Y --- снизу вверх. | Значение по оси X возрастает слева направо, по оси Y --- снизу вверх. | ||
- | Координатная система располагается в "пейзажной" ориентации и соответствует | + | Координатная система располагается в «пейзажной» ориентации и соответствует |
листу, повёрнутому длинной стороной вниз. | листу, повёрнутому длинной стороной вниз. | ||
- | |||
===== Имена файлов ===== | ===== Имена файлов ===== | ||
- | Имена файлов символов заканчиваются на //''.sym''//. Для имён файлов символов в | + | Имена файлов символов заканчиваются на //''.sym''//. Для имён файлов |
- | gEDA/gaf используется только одно соглашение: если есть несколько экземпляров | + | символов в gEDA/gaf используется только одно соглашение: если есть несколько |
- | символов с одинаковыми именами (как, например, 7400), то к концу основы имени | + | экземпляров символов с одинаковыми именами (как, например, 7400), то к концу |
- | файла добавляется суффикс -1, -2, -3, … -N . Пример: //''7400-1.sym''//, //''7400-2.sym''//, | + | основы имени файла добавляется суффикс -1, -2, -3, … -N . Пример: |
- | //''7400-3.sym''//... | + | //''7400-1.sym''//, //''7400-2.sym''//, //''7400-3.sym''//... |
- | + | ||
- | Имена файлов схем заканчиваются на //''.sch''//. Раньше существовало соглашение об | + | |
- | именах файлов схем (о добавлении -1 .. -N к основе имени файла), но | + | |
- | сейчас оно устарело. Для схем их создатель может выбирать любые осмысленные | + | |
- | имена. | + | |
+ | Имена файлов схем заканчиваются на //''.sch''//. Раньше существовало | ||
+ | соглашение об именах файлов схем (о добавлении -1 .. -N к основе имени | ||
+ | файла), но сейчас оно устарело. Для схем их создатель может выбирать любые | ||
+ | осмысленные имена. | ||
===== Типы объектов ===== | ===== Типы объектов ===== | ||
Файл схемы/символа для gEDA/gaf состоит из следующих частей: | Файл схемы/символа для gEDA/gaf состоит из следующих частей: | ||
* Версия (v) как первый элемент в файле. Это обязательно. | * Версия (v) как первый элемент в файле. Это обязательно. | ||
- | * Любое количество объектов с правильными данными. Объекты указываются с помощью "типа объекта". | + | * Любое количество объектов с правильными данными. Объекты указываются с помощью «типа объекта». |
* Большинство объектов описываются одной строкой, но текстовые --- двумя и более. | * Большинство объектов описываются одной строкой, но текстовые --- двумя и более. | ||
* Не должно быть пустых строк в конце файла (они игнорируются программами). | * Не должно быть пустых строк в конце файла (они игнорируются программами). | ||
Line 69: | Line 63: | ||
первом столбце. Идентификатор типа объекта является регистрозависимым. | первом столбце. Идентификатор типа объекта является регистрозависимым. | ||
- | Файлы схем и символов имеют общий формат. [[geda:glossary.ru#Символ]] --- это | + | Файлы схем и символов имеют общий формат. [[geda:glossary.ru#Символ]] --- |
- | не что иное, как | + | это не что иное, как совокупность примитивных объектов (линий, |
- | совокупность примитивных объектов (линий, прямоугольников, окружностей, дуг, | + | прямоугольников, окружностей, дуг, текста и выводов). Схема представляет |
- | текста и выводов). Схема представляет собой набор символов (компонентов), | + | собой набор символов (компонентов), |
[[geda:glossary.ru#Соединение|соединений]] и [[geda:glossary.ru#шина|шин]]. | [[geda:glossary.ru#Соединение|соединений]] и [[geda:glossary.ru#шина|шин]]. | ||
- | Следующие разделы описывают особенности каждого из распознаваемых типов | + | В следующих разделах приводится подробное описание каждого из распознаваемых |
- | объектов. Каждый раздел содержит название объекта, описание того, в каком типе | + | типов объектов. Каждый раздел содержит название объекта, описание того, в |
- | файла (sch/sym) объект может присутствовать, формат данных, описание каждого | + | каком типе файла (sch/sym) объект может присутствовать, формат данных, |
- | отдельного поля, подробности и предостережения для данных полей и, наконец, | + | описание каждого отдельного поля, подробности и предостережения для данных |
- | пример с пояснением. | + | полей и, наконец, пример с пояснением. |
Информация об индексе цвета (который используется практически для всех | Информация об индексе цвета (который используется практически для всех | ||
объектов) находится в разделе [[#Цвета]]. | объектов) находится в разделе [[#Цвета]]. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
Line 95: | Line 97: | ||
| 2 |fileformat_version|int|Номер версии формата файла gEDA/gaf| | | 2 |fileformat_version|int|Номер версии формата файла gEDA/gaf| | ||
- | * Тип обозначается буквой "v" в нижнем регистре (как в слове Victor). | + | * Тип обозначается буквой «v» в нижнем регистре (как в слове Victor). |
* Данный объект должен находиться в каждом файле, используемом или создаваемом программными средствами gEDA/gaf. | * Данный объект должен находиться в каждом файле, используемом или создаваемом программными средствами gEDA/gaf. | ||
* Формат первого поля версии --- ГГГГММДД. | * Формат первого поля версии --- ГГГГММДД. | ||
* Номер версии не является произвольным временным штампом. Не выдумывайте номер версии, а в противном случае не ожидайте, что программы будут работать правильно. | * Номер версии не является произвольным временным штампом. Не выдумывайте номер версии, а в противном случае не ожидайте, что программы будут работать правильно. | ||
- | * "Версия gEDA/gaf, в которой был сохранён данный файл" использовалась во всех версиях gEDA/gaf до 20030921 как версия формата файла. Это поле не должно больше использоваться для определения формата файла. Сейчас оно используется только для информационных целей. | + | * «Версия gEDA/gaf, в которой был сохранён данный файл» использовалась во всех версиях gEDA/gaf до 20030921 как версия формата файла. Это поле не должно больше использоваться для определения формата файла. Сейчас оно используется только для информационных целей. |
* Начиная с gEDA/gaf версии 20031004 и позже, поле ''fileformat_version'' используется для определения версии формата файла. Весь код формата файла должен отталкиваться от этого поля. | * Начиная с gEDA/gaf версии 20031004 и позже, поле ''fileformat_version'' используется для определения версии формата файла. Весь код формата файла должен отталкиваться от этого поля. | ||
* ''fileformat_version'' возрастает при изменении формата файла. | * ''fileformat_version'' возрастает при изменении формата файла. | ||
Line 111: | Line 113: | ||
Пример: | Пример: | ||
<code>v 20040111 1</code> | <code>v 20040111 1</code> | ||
- | |||
==== Линия ==== | ==== Линия ==== | ||
Line 146: | Line 147: | ||
Пример: | Пример: | ||
<code>L 23000 69000 28000 69000 3 40 0 1 -1 75</code> | <code>L 23000 69000 28000 69000 3 40 0 1 -1 75</code> | ||
- | |||
Сегмент линии от (23000, 69000) до (28000, 69000) с цветовым индексом 3, | Сегмент линии от (23000, 69000) до (28000, 69000) с цветовым индексом 3, | ||
толщиной 40 милов, без стиля концов, пунктир, интервал между точками 75 | толщиной 40 милов, без стиля концов, пунктир, интервал между точками 75 | ||
милов. | милов. | ||
- | |||
==== Изображение ==== | ==== Изображение ==== | ||
Line 191: | Line 190: | ||
Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения | Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения | ||
- | 1400 милов, высота 2175 милов. | + | 1400 милов, высота 2175 милов.\\ |
- | Поворот изображения 0 градусов и оно ни отражённое, ни внедрённое. | + | Поворот изображения 0 градусов и оно ни отражённое, ни внедрённое.\\ |
Путь доступа и имя файла изображения отображается во второй строке. | Путь доступа и имя файла изображения отображается во второй строке. | ||
Line 204: | Line 202: | ||
Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения | Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения | ||
- | 1400 милов, высота 2175 милов. | + | 1400 милов, высота 2175 милов.\\ |
- | + | Поворот изображения 0 градусов, оно не отражённое, но внедрённое.\\ | |
- | Поворот изображения 0 градусов, оно не отражённое, но внедрённое. | + | |
Путь доступа и имя файла изображения отображается во второй строке. Так как | Путь доступа и имя файла изображения отображается во второй строке. Так как | ||
- | это изображение внедрённое, путь доступа и имя файла не используются. | + | это изображение внедрённое, путь доступа и имя файла не используются.\\ |
Закодированные данные изображения являются только примером (это не настоящие | Закодированные данные изображения являются только примером (это не настоящие | ||
данные). Последняя строка, содержащая один символ точки '.' указывает конец | данные). Последняя строка, содержащая один символ точки '.' указывает конец | ||
закодированных данных. | закодированных данных. | ||
- | |||
==== Прямоугольник ==== | ==== Прямоугольник ==== | ||
Допускается: в файлах схем и символов | Допускается: в файлах схем и символов | ||
- | **''type x y width height color width capstyle dashstyle dashlength dashspace filltype fillwidth angle1 pitch1 angle2 pitch2''** | + | **''type x y width height color width capstyle dashstyle dashlength |
+ | dashspace filltype fillwidth angle1 pitch1 angle2 pitch2''** | ||
^Поз.^Поле^Тип/единица^Описание^ | ^Поз.^Поле^Тип/единица^Описание^ | ||
Line 267: | Line 262: | ||
Прямоугольник с нижним левым углом в (33000, 67300) шириной и высотой (2000, | Прямоугольник с нижним левым углом в (33000, 67300) шириной и высотой (2000, | ||
- | 2000), цветовой индекс 3, толщина линий 60 милов, без стиля концов, штриховые | + | 2000), цветовой индекс 3, толщина линий 60 милов, без стиля концов, |
- | линии, длина штриха 75 милов, интервал между штрихами 50 милов, без | + | штриховые линии, длина штриха 75 милов, интервал между штрихами 50 милов, |
- | заполнения, остальные параметры не установлены. | + | без заполнения, остальные параметры не установлены. |
==== Окружность ==== | ==== Окружность ==== | ||
Допускается: в файлах схем и символов | Допускается: в файлах схем и символов | ||
- | **''type x y radius color width capstyle dashstyle dashlength dashspace filltype fillwidth angle1 pitch1 angle2 pitch2''** | + | **''type x y radius color width capstyle dashstyle dashlength dashspace |
+ | filltype fillwidth angle1 pitch1 angle2 pitch2''** | ||
^Поз.^Поле^Тип/единица^Описание^ | ^Поз.^Поле^Тип/единица^Описание^ | ||
Line 317: | Line 312: | ||
<code>V 38000 67000 900 3 0 0 2 75 50 2 10 20 30 90 50</code> | <code>V 38000 67000 900 3 0 0 2 75 50 2 10 20 30 90 50</code> | ||
- | Окружность с центром в (38000, 67000) и радиусом 900 милов, цветовой индекс 3, | + | Окружность с центром в (38000, 67000) и радиусом 900 милов, цветовой индекс |
- | толщина линии 0 милов (наименьший размер), без стиля концов, штриховая линия, | + | 3, толщина линии 0 милов (наименьший размер), без стиля концов, штриховая |
- | длина штриха 75 милов, интервал между штрихами 50 милов, заполнение сеткой, | + | линия, длина штриха 75 милов, интервал между штрихами 50 милов, заполнение |
- | линии сетки толщиной 10 милов, первая линия сетки под углом 20 градусов с | + | сеткой, линии сетки толщиной 10 милов, первая линия сетки под углом 20 |
- | интервалом в 30 милов, вторая линия сетки под углом 90 градусов с интервалом в | + | градусов с интервалом в 30 милов, вторая линия сетки под углом 90 градусов с |
- | 50 милов. | + | интервалом в 50 милов. |
==== Дуга ==== | ==== Дуга ==== | ||
Допускается: в файлах схем и символов | Допускается: в файлах схем и символов | ||
- | **''type x y radius startangle sweepangle color width capstyle dashstyle dashlength dashspace''** | + | **''type x y radius startangle sweepangle color width capstyle dashstyle |
+ | dashlength dashspace''** | ||
^Поз.^Поле^Тип/единица^Описание^ | ^Поз.^Поле^Тип/единица^Описание^ | ||
Line 361: | Line 356: | ||
Пример: | Пример: | ||
<code>A 30600 75000 2000 0 45 3 0 0 3 75 50</code> | <code>A 30600 75000 2000 0 45 3 0 0 3 75 50</code> | ||
- | + | Дуга с центром в (30600, 75000) и радиусом 2000 милов, начальный угол 0 градусов, угол разворота дуги 45 градусов, цветовой индекс 3, толщина линии 0 милов (наименьший размер), без стиля концов, штрих-пунктир, длина штриха 75 милов, интервал между штрихами 50 милов. | |
- | Дуга с центром в (30600, 75000) и радиусом 2000 милов, начальный угол 0 | + | |
- | градусов, угол разворота дуги 45 градусов, цветовой индекс 3, толщина линии 0 | + | |
- | милов (наименьший размер), без стиля концов, штрих-пунктир, длина штриха 75 | + | |
- | милов, интервал между штрихами 50 милов. | + | |
Line 371: | Line 362: | ||
В зависимости от контекста текстовые объекты могут играть разные роли. Вне | В зависимости от контекста текстовые объекты могут играть разные роли. Вне | ||
какого-либо окружения они представляют собой строки текста, содержащие | какого-либо окружения они представляют собой строки текста, содержащие | ||
- | какую-либо информацию. Заключённые в фигурные скобки, они интерпретируются как | + | какую-либо информацию. Заключённые в фигурные скобки, они интерпретируются |
- | атрибуты. См. раздел [[geda:file_format_spec.ru#Атрибуты]]. | + | как атрибуты. См. раздел [[geda:file_format_spec.ru#Атрибуты]]. |
Допускается: в файлах схем и символов | Допускается: в файлах схем и символов | ||
- | **''type x y color size visibility show_name_value angle alignment num_lines\\ | + | **''type x y color size visibility show_name_value angle alignment |
+ | num_lines\\ | ||
string line 1\\ | string line 1\\ | ||
string line 2\\ | string line 2\\ | ||
string line 3\\ | string line 3\\ | ||
- | …\\ | + | ...\\ |
string line N''** | string line N''** | ||
Line 413: | Line 405: | ||
* Параметр выравнивания/привязки ''alignment'' управляет относительным положением точки привязки. | * Параметр выравнивания/привязки ''alignment'' управляет относительным положением точки привязки. | ||
* Параметр ''alignment'' может принимать значения от 0 до 8. \\ На следующем рисунке показано действие значений параметра ''alignment''. | * Параметр ''alignment'' может принимать значения от 0 до 8. \\ На следующем рисунке показано действие значений параметра ''alignment''. | ||
- | {{:geda:fileformat_textgraphic.jpg}} | + | {{:geda:fileformat_textgraphic.jpg}} |
* Исходное значение параметра ''num_lines'' всегда равно 1. \\ Поле ''num_lines'' было добавлено начиная с версии 1 формата файла. Предыдущие версии (0 и ранее) поддерживали только однострочные текстовые объекты. | * Исходное значение параметра ''num_lines'' всегда равно 1. \\ Поле ''num_lines'' было добавлено начиная с версии 1 формата файла. Предыдущие версии (0 и ранее) поддерживали только однострочные текстовые объекты. | ||
- | * Горизонтальная черта над текстовыми строками задаётся ограничивающими текст с двух сторон маркерами надчёркивания вида **"\_"**. Символ обратной косой черты записывается в виде **"\\"**. | + | * Горизонтальная черта над текстовыми строками задаётся ограничивающими текст с двух сторон маркерами надчёркивания вида **«\_»**. Символ обратной косой черты записывается в виде **«\\»**. |
Пример 1: | Пример 1: | ||
Line 422: | Line 415: | ||
Текстовый объект с точкой привязки в (16900, 35800), цветовой индекс 3, | Текстовый объект с точкой привязки в (16900, 35800), цветовой индекс 3, | ||
- | размером 10 пунктов, видимый, флаги атрибута не действуют (объект не является | + | размером 10 пунктов, видимый, флаги атрибута не действуют (объект не |
- | атрибутом), точка привязки в левом нижнем углу, без поворота, строка: | + | является атрибутом), точка привязки в левом нижнем углу, без поворота, |
- | Text string! | + | строка: Text string! |
Пример 2: | Пример 2: | ||
Line 434: | Line 427: | ||
Text string line 5</code> | Text string line 5</code> | ||
- | Данный текстовый объект подобен указанному в примере выше, но здесь пять строк | + | Данный текстовый объект подобен указанному в примере выше, но здесь пять |
- | текста. | + | строк текста. |
Пример 3: | Пример 3: | ||
Line 441: | Line 434: | ||
pinlabel=R/\_W\_</code> | pinlabel=R/\_W\_</code> | ||
- | Текстовый объект с точкой привязки (10000, 20000), цветовой индекс 3, размером | + | Текстовый объект с точкой привязки (10000, 20000), цветовой индекс 3, |
- | 10 пунктов, видимый, видимо только значение атрибута, точка привязки находится | + | размером 10 пунктов, видимый, видимо только значение атрибута, точка |
- | в верхнем правом углу, текст повёрнут на 90 градусов, строка: "R/W", над | + | привязки находится в верхнем правом углу, текст повёрнут на 90 градусов, |
- | буквой "W" горизонтальная черта. | + | строка: «R/W», над буквой «W» горизонтальная черта. |
==== Соединение ==== | ==== Соединение ==== | ||
Line 466: | Line 458: | ||
<code>N 12700 29400 32900 29400 4</code> | <code>N 12700 29400 32900 29400 4</code> | ||
- | Сегмент соединения от (12700, 29400) до (32900, 29400) с цветовым индексом 4. | + | Сегмент соединения от (12700, 29400) до (32900, 29400) с цветовым индексом |
+ | 4. | ||
==== Шина ==== | ==== Шина ==== | ||
Line 493: | Line 485: | ||
Сегмент шины от (27300, 37400) до (27300, 35300) с цветовым индексом 3 и без | Сегмент шины от (27300, 37400) до (27300, 35300) с цветовым индексом 3 и без | ||
подключения соединений к данному сегменту. | подключения соединений к данному сегменту. | ||
- | |||
==== Вывод ==== | ==== Вывод ==== | ||
Line 523: | Line 514: | ||
Вывод от (0, 200) до (200, 200) с цветовым индексом 1, обычный вывод, для | Вывод от (0, 200) до (200, 200) с цветовым индексом 1, обычный вывод, для | ||
соединения используется первая точка. | соединения используется первая точка. | ||
- | |||
==== Компонент ==== | ==== Компонент ==== | ||
Line 549: | Line 539: | ||
<code>C 18600 19900 1 0 0 7400-1.sym</code> | <code>C 18600 19900 1 0 0 7400-1.sym</code> | ||
- | Компонент с точкой привязки в (18600,19900), выделяемый, | + | Компонент с точкой привязки в (18600,19900), выделяемый, без поворота, без |
- | без поворота, без отражения, имя файла компонента 7400-1.sym. | + | отражения, имя файла компонента 7400-1.sym. |
Line 558: | Line 548: | ||
Действителен: с версии 2 формата файла (выпуск 1.5.1) | Действителен: с версии 2 формата файла (выпуск 1.5.1) | ||
- | **''type color width capstyle dashstyle dashlength dashspace filltype fillwidth angle1 pitch1 angle2 pitch2 numlines\\ | + | **''type color width capstyle dashstyle dashlength dashspace filltype |
+ | fillwidth angle1 pitch1 angle2 pitch2 numlines\\ | ||
path data line 1\\ | path data line 1\\ | ||
path data line 2\\ | path data line 2\\ | ||
Line 586: | Line 577: | ||
* END SQUARE = 1 (квадратные концы) | * END SQUARE = 1 (квадратные концы) | ||
* END ROUND = 2 (круглые концы) | * END ROUND = 2 (круглые концы) | ||
+ | |||
* Параметр ''dashstyle'' перечислимого типа: | * Параметр ''dashstyle'' перечислимого типа: | ||
* TYPE SOLID = 0 (сплошная линия) | * TYPE SOLID = 0 (сплошная линия) | ||
Line 594: | Line 586: | ||
* Параметр ''dashlength'' не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1. | * Параметр ''dashlength'' не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1. | ||
* Параметр ''dashspace'' не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1. | * Параметр ''dashspace'' не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1. | ||
+ | |||
* Параметр ''filltype'' перечислимого типа: | * Параметр ''filltype'' перечислимого типа: | ||
* FILLING HOLLOW = 0 (без заполнения) | * FILLING HOLLOW = 0 (без заполнения) | ||
Line 622: | Line 615: | ||
исходную точку. Цветовой индекс 3, толщина линий 10 милов, без стиля концов, | исходную точку. Цветовой индекс 3, толщина линий 10 милов, без стиля концов, | ||
сплошная. Данные контура содержат 5 строк. | сплошная. Данные контура содержат 5 строк. | ||
- | |||
==== Шрифт ==== | ==== Шрифт ==== | ||
Line 646: | Line 638: | ||
===== Цвета ===== | ===== Цвета ===== | ||
В формате файлов символов и схем gEDA/gaf цвета определяются посредством | В формате файлов символов и схем gEDA/gaf цвета определяются посредством | ||
- | целочисленного индекса. Соответствие между числом и цветом основывается | + | целочисленного индекса. Соответствие между числом и цветом основывается на |
- | на типе объекта. Для каждого типа объекта обычно используется один или более | + | типе объекта. Для каждого типа объекта обычно используется один или более |
- | цветов. Здесь | + | цветов. Здесь приведена таблица соответствия цветовых индексов типам |
- | приведена таблица соответствия цветовых индексов типам объектов: | + | объектов: |
^Индекс^Тип объекта^Примечание^ | ^Индекс^Тип объекта^Примечание^ | ||
Line 659: | Line 651: | ||
|5|ATTRIBUTE_COLOR|Атрибут| | |5|ATTRIBUTE_COLOR|Атрибут| | ||
|6|LOGIC_BUBBLE_COLOR|Логическая инверсия| | |6|LOGIC_BUBBLE_COLOR|Логическая инверсия| | ||
- | |7|GRID_COLOR|Сетка| | + | |7|DOTS_GRID_COLOR|Сетка| |
|8|DETACHED_ATTRIBUTE_COLOR|Неприкреплённый атрибут| | |8|DETACHED_ATTRIBUTE_COLOR|Неприкреплённый атрибут| | ||
|9|TEXT_COLOR|Текст| | |9|TEXT_COLOR|Текст| | ||
Line 681: | Line 673: | ||
цветовой индекс, но допустимо (иногда) назначать цвет, отличный от присущего | цветовой индекс, но допустимо (иногда) назначать цвет, отличный от присущего | ||
данному типу объектов. | данному типу объектов. | ||
- | |||
===== Атрибуты ===== | ===== Атрибуты ===== | ||
Атрибуты заключаются в фигурные скобки {} и могут быть только текстовыми | Атрибуты заключаются в фигурные скобки {} и могут быть только текстовыми | ||
объектами. Атрибуты представляют собой текстовые элементы вида | объектами. Атрибуты представляют собой текстовые элементы вида | ||
- | ''имя_атрибута=значение''. Если текст не содержит пары ''имя_атрибута=значение'', он не | + | ''имя_атрибута=значение''. Если текст не содержит пары |
- | является атрибутом. Атрибуты прикрепляются к предшествующему объекту. Вот | + | ''имя_атрибута=значение'', он не является атрибутом. Атрибуты прикрепляются |
- | пример: | + | к предшествующему объекту. Вот пример: |
<code>P 988 500 1300 500 1 | <code>P 988 500 1300 500 1 | ||
{ | { | ||
Line 697: | Line 688: | ||
}</code> | }</code> | ||
- | Данный объект является выводом, имеющим атрибуты ''pinnumber=3'' и ''pinseq=3'' | + | Данный объект является выводом, имеющим атрибуты ''pinnumber=3'' и |
- | (''имя_атрибута=значение''). Внутри фигурных скобок {} может находиться несколько | + | ''pinseq=3'' (''имя_атрибута=значение''). Внутри фигурных скобок {} может |
- | текстовых объектов (T ... и текстовая строка обязательны). С версии 20021103 в | + | находиться несколько текстовых объектов (T ... и текстовая строка |
- | качестве атрибутов можно использовать только текстовые элементы. Прикрепление | + | обязательны). С версии 20021103 в качестве атрибутов можно использовать |
- | других типов объектов в качестве атрибутов не поддерживается. | + | только текстовые элементы. Прикрепление других типов объектов в качестве |
+ | атрибутов не поддерживается. | ||
- | Можно использовать также атрибуты "верхнего уровня". Эти атрибуты не | + | Можно использовать также атрибуты «верхнего уровня». Эти атрибуты не |
прикрепляются ни к какому объекту, а просто представляют собой текстовые | прикрепляются ни к какому объекту, а просто представляют собой текстовые | ||
объекты вида ''имя_атрибута=значение''. | объекты вида ''имя_атрибута=значение''. | ||
Line 710: | Line 702: | ||
информацию о странице схемы или о символе и нужно, чтобы генератор списка | информацию о странице схемы или о символе и нужно, чтобы генератор списка | ||
соединений имел доступ к данной информации. | соединений имел доступ к данной информации. | ||
- | |||
===== Внедрённые компоненты ===== | ===== Внедрённые компоненты ===== | ||
Внедрённые компоненты --- это компоненты, определение которых полностью | Внедрённые компоненты --- это компоненты, определение которых полностью | ||
содержится внутри файла схемы. Когда пользователи помещают компоненты на | содержится внутри файла схемы. Когда пользователи помещают компоненты на | ||
- | страницы схемы, есть возможность делать компоненты внедрёнными. Это отличается | + | страницы схемы, есть возможность делать компоненты внедрёнными. Это |
- | от простого сохранения всей информации символа непосредственно в схеме, | + | отличается от простого сохранения всей информации символа непосредственно в |
- | внедрённый компонент --- это просто несколько иной компонент. Внедрённые | + | схеме, внедрённый компонент --- это просто несколько иной |
- | компоненты указываются следующим образом: | + | компонент. Внедрённые компоненты указываются следующим образом: |
<code>C 18600 21500 1 0 0 EMBEDDED555-1.sym | <code>C 18600 21500 1 0 0 EMBEDDED555-1.sym | ||
[ | [ | ||
Line 728: | Line 719: | ||
В примере выше, //''555-1.sym''// --- это компонент. Тег EMBEDDED и [ ] --- | В примере выше, //''555-1.sym''// --- это компонент. Тег EMBEDDED и [ ] --- | ||
отличительные характеристики внедрённого компонента. Если требуется отменить | отличительные характеристики внедрённого компонента. Если требуется отменить | ||
- | внедрение компонента, символ //''имя_компонента.sym''// должен присутствовать в | + | внедрение компонента, символ //''имя_компонента.sym''// должен |
- | одной из используемых библиотек. | + | присутствовать в одной из используемых библиотек. |
+ | |||
+ | |||
+ | |||
Line 739: | Line 734: | ||
* Детали реализации; код **libgeda** взят из **librsvg**, библиотеки синтаксического анализа SVG. В результате большая часть синтаксиса контуров SVG читается правильно, однако синтаксис всегда внутренне нормализуется в абсолютные команды ''move'', ''line'', ''bezier curve'' и ''close-path'' (и сохраняется в таком виде). | * Детали реализации; код **libgeda** взят из **librsvg**, библиотеки синтаксического анализа SVG. В результате большая часть синтаксиса контуров SVG читается правильно, однако синтаксис всегда внутренне нормализуется в абсолютные команды ''move'', ''line'', ''bezier curve'' и ''close-path'' (и сохраняется в таком виде). | ||
* Координаты всего контура указываются в стандартной координатной системе **gschem**. | * Координаты всего контура указываются в стандартной координатной системе **gschem**. | ||
- | |||
* Команды для контуров, выводимые и гарантированно обрабатываемые в gEDA, перечислены в нижеследующей таблице.\\ (Текст взят из вышеуказанной спецификации SVG). | * Команды для контуров, выводимые и гарантированно обрабатываемые в gEDA, перечислены в нижеследующей таблице.\\ (Текст взят из вышеуказанной спецификации SVG). | ||
- | |||
* В приведённой ниже таблице используются следующие условные обозначения: | * В приведённой ниже таблице используются следующие условные обозначения: | ||
* (): группировка параметров | * (): группировка параметров | ||
Line 779: | Line 772: | ||
{{geda:path_example_and_gate-smaller.png|}} | {{geda:path_example_and_gate-smaller.png|}} | ||
- | |||
===== История изменений документа ===== | ===== История изменений документа ===== | ||
- | + | |30 ноября 2002 г. |Создан fileformats.tex из fileformats.html. | | |
- | |30 ноября 2002 г.|Создан fileformats.tex из fileformats.html.| | + | |1 декабря 2002 г. |Продолжена работа над данным документом. | |
- | |1 декабря 2002 г.|Продолжена работа над данным документом.| | + | |4 октября 2003 г. |Добавлена информация о новом флаге версии формата файла. | |
- | |4 октября 2003 г.|Добавлена информация о новом флаге версии формата файла.| | + | |19 октября 2003 г.|Добавлено поле ''num_lines'' для текстового объекта. | |
- | |19 октября 2003 г.|Добавлено поле ''num_lines'' для текстового объекта.| | + | |2 ноября 2008 г. |Добавлен объект контура, версия формата файла изменена на 2. | |
- | |2 ноября 2008 г.|Добавлен объект контура, версия формата файла изменена на 2| | + | |26 мая, 2011 г. |В таблицы параметров добавлены столбцы позиции. | |
- | |26 мая, 2011 г.|В таблицы параметров добавлены столбцы позиции| | + | |