Differences

This shows you the differences between two versions of the page.

--- 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] (current)
vzh Updated using po4a
@@ Line 1: / Line 1: @@
+//Эта страница доступна также на следующих языках://
+[[file_format_spec|English]]
 ====== Формат файлов gEDA/gaf ======
 Автор: Ales V. Hvezda, ahvezda@geda.seul.org
@@ Line 7: / Line 10: @@
 декабря 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#Символ|символов]] для них. Файлы
-именами, заканчивающимися на //''.sch''// и //''.sym''//, являются соответственно файлами
+с именами, заканчивающимися на //''.sch''// и //''.sym''//, являются
-схем и символов. Пока в gEDA/gaf нет других типов файлов, настоящий документ
+соответственно файлами схем и символов. Пока в gEDA/gaf нет других типов
-будет относиться только к формату файлов схем/символов.
+файлов, настоящий документ будет относиться только к формату файлов
+схем/символов.\\
 Настоящий документ находится в обращении с версии gEDA/gaf 20040111. Он
-охватывает версии формата 1 и 2.
+охватывает версии формата 1 и 2.\\
 Обратите внимание, что данный формат и любые другие форматы файлов,
 относящиеся к gEDA, находятся под лицензией General Public License (GPL)
 версии 2.0. Авторские права на формат файлов схем/символов gEDA/gaf
 принадлежат Ales Hvezda (Copyright (C) 1998-2004 Ales Hvezda).
 ===== Система координат =====
-Все координаты задаются в милах (1/1000 дюйма). Это произвольное решение.
+Все координаты задаются в милах (1/1000 дюйма). Это произвольное решение.  Запомните, что в схемах и символах нет понятия физических длин/размеров (только при разработке принципиальных схем).
-Запомните, что в схемах и символах нет понятия физических длин/размеров
-(только при разработке принципиальных схем).
   * Начало координат находится в левом нижнем углу.
   * Размеры координатного пространства неограничены, но рекомендуется размещать объекты в пределах (120.0, 90.0) (x, y, дюймов).
@@ Line 41: / Line 37: @@
 Значение по оси 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 состоит из следующих частей:
   * Версия (v) как первый элемент в файле. Это обязательно.
-  * Любое количество объектов с правильными данными. Объекты указываются с помощью "типа объекта".
+  * Любое количество объектов с правильными данными. Объекты указываются с помощью «типа объекта».
   * Большинство объектов описываются одной строкой, но текстовые --- двумя и более.
   * Не должно быть пустых строк в конце файла (они игнорируются программами).
@@ Line 69: / Line 63: @@
 первом столбце. Идентификатор типа объекта является регистрозависимым.
-Файлы схем и символов имеют общий формат. [[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|
-  * Тип обозначается буквой "v" в нижнем регистре (как в слове Victor).
+  * Тип обозначается буквой «v» в нижнем регистре (как в слове Victor).
   * Данный объект должен находиться в каждом файле, используемом или создаваемом программными средствами gEDA/gaf.
   * Формат первого поля версии --- ГГГГММДД.
   * Номер версии не является произвольным временным штампом. Не выдумывайте номер версии, а в противном случае не ожидайте, что программы будут работать правильно.
-  * "Версия gEDA/gaf, в которой был сохранён данный файл" использовалась во всех версиях gEDA/gaf до 20030921 как версия формата файла. Это поле не должно больше использоваться для определения формата файла. Сейчас оно используется только для информационных целей.
+  * «Версия gEDA/gaf, в которой был сохранён данный файл» использовалась во всех версиях gEDA/gaf до 20030921 как версия формата файла. Это поле не должно больше использоваться для определения формата файла. Сейчас оно используется только для информационных целей.
   * Начиная с gEDA/gaf версии 20031004 и позже, поле ''fileformat_version'' используется для определения версии формата файла. Весь код формата файла должен отталкиваться от этого поля.
   * ''fileformat_version'' возрастает при изменении формата файла.
@@ Line 111: / Line 113: @@
 Пример:
 <code>v 20040111 1</code>
 ==== Линия ====
@@ Line 146: / Line 147: @@
 Пример:
 <code>L 23000 69000 28000 69000 3 40 0 1 -1 75</code>
 Сегмент линии от (23000, 69000) до (28000, 69000) с цветовым индексом 3,
 толщиной 40 милов, без стиля концов, пунктир, интервал между точками 75
 милов.
 ==== Изображение ====
@@ Line 191: / Line 190: @@
 Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения
-милов, высота 2175 милов.
+милов, высота 2175 милов.\\
-Поворот изображения 0 градусов и оно ни отражённое, ни внедрённое.
+Поворот изображения 0 градусов и оно ни отражённое, ни внедрённое.\\
 Путь доступа и имя файла изображения отображается во второй строке.
@@ Line 204: / Line 202: @@
 Объект изображения с левым нижним углом в (16900, 35800). Ширина изображения
-милов, высота 2175 милов.
+милов, высота 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,
-), цветовой индекс 3, толщина линий 60 милов, без стиля концов, штриховые
+), цветовой индекс 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>
-Окружность с центром в (38000, 67000) и радиусом 900 милов, цветовой индекс 3,
+Окружность с центром в (38000, 67000) и радиусом 900 милов, цветовой индекс
-толщина линии 0 милов (наименьший размер), без стиля концов, штриховая линия,
+, толщина линии 0 милов (наименьший размер), без стиля концов, штриховая
-длина штриха 75 милов, интервал между штрихами 50 милов, заполнение сеткой,
+линия, длина штриха 75 милов, интервал между штрихами 50 милов, заполнение
-линии сетки толщиной 10 милов, первая линия сетки под углом 20 градусов с
+сеткой, линии сетки толщиной 10 милов, первая линия сетки под углом 20
-интервалом в 30 милов, вторая линия сетки под углом 90 градусов с интервалом в
+градусов с интервалом в 30 милов, вторая линия сетки под углом 90 градусов с
-милов.
+интервалом в 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>
+Дуга с центром в (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 2\\
 string line 3\\
-…\\
+...\\
 string line N''**
@@ Line 413: / Line 405: @@
   * Параметр выравнивания/привязки ''alignment'' управляет относительным положением точки привязки.
   * Параметр ''alignment'' может принимать значения от 0 до 8. \\ На следующем рисунке показано действие значений параметра ''alignment''.
- {{:geda:fileformat_textgraphic.jpg}}
+{{:geda:fileformat_textgraphic.jpg}}
   * Исходное значение параметра ''num_lines'' всегда равно 1. \\ Поле ''num_lines'' было добавлено начиная с версии 1 формата файла. Предыдущие версии (0 и ранее) поддерживали только однострочные текстовые объекты.
-  * Горизонтальная черта над текстовыми строками задаётся ограничивающими текст с двух сторон маркерами надчёркивания вида **"\_"**. Символ обратной косой черты записывается в виде **"\\"**.
+  * Горизонтальная черта над текстовыми строками задаётся ограничивающими текст с двух сторон маркерами надчёркивания вида **«\_»**. Символ обратной косой черты записывается в виде **«\\»**.
 Пример 1:
@@ Line 422: / Line 415: @@
 Текстовый объект с точкой привязки в (16900, 35800), цветовой индекс 3,
-размером 10 пунктов, видимый, флаги атрибута не действуют (объект не является
+размером 10 пунктов, видимый, флаги атрибута не действуют (объект не
-атрибутом), точка привязки в левом нижнем углу, без поворота, строка:
+является атрибутом), точка привязки в левом нижнем углу, без поворота,
-Text string!
+строка: Text string!
 Пример 2:
@@ Line 434: / Line 427: @@
 Text string line 5</code>
-Данный текстовый объект подобен указанному в примере выше, но здесь пять строк
+Данный текстовый объект подобен указанному в примере выше, но здесь пять
-текста.
+строк текста.
 Пример 3:
@@ Line 441: / Line 434: @@
 pinlabel=R/\_W\_</code>
-Текстовый объект с точкой привязки (10000, 20000), цветовой индекс 3, размером
+Текстовый объект с точкой привязки (10000, 20000), цветовой индекс 3,
-пунктов, видимый, видимо только значение атрибута, точка привязки находится
+размером 10 пунктов, видимый, видимо только значение атрибута, точка
-в верхнем правом углу, текст повёрнут на 90 градусов, строка: "R/W", над
+привязки находится в верхнем правом углу, текст повёрнут на 90 градусов,
-буквой "W" горизонтальная черта.
+строка: «R/W», над буквой «W» горизонтальная черта.
 ==== Соединение ====
@@ Line 466: / Line 458: @@
 <code>N 12700 29400 32900 29400 4</code>
-Сегмент соединения от (12700, 29400) до (32900, 29400) с цветовым индексом 4.
+Сегмент соединения от (12700, 29400) до (32900, 29400) с цветовым индексом
+.
 ==== Шина ====
@@ Line 493: / Line 485: @@
 Сегмент шины от (27300, 37400) до (27300, 35300) с цветовым индексом 3 и без
 подключения соединений к данному сегменту.
 ==== Вывод ====
@@ Line 523: / Line 514: @@
 Вывод от (0, 200) до (200, 200) с цветовым индексом 1, обычный вывод, для
 соединения используется первая точка.
 ==== Компонент ====
@@ Line 549: / Line 539: @@
 <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)
-**''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 2\\
@@ Line 586: / Line 577: @@
     * END SQUARE = 1 (квадратные концы)
     * END ROUND = 2 (круглые концы)
   * Параметр ''dashstyle'' перечислимого типа:
     * TYPE SOLID = 0 (сплошная линия)
@@ Line 594: / Line 586: @@
   * Параметр ''dashlength'' не используется для типов SOLID и DOTTED. В случае использования данных типов он должен принимать значение -1.
   * Параметр ''dashspace'' не используется для типа SOLID. В случае использования данного типа он должен принимать значение -1.
   * Параметр ''filltype'' перечислимого типа:
     * FILLING HOLLOW = 0 (без заполнения)
@@ Line 622: / Line 615: @@
 исходную точку. Цветовой индекс 3, толщина линий 10 милов, без стиля концов,
 сплошная. Данные контура содержат 5 строк.
 ==== Шрифт ====
@@ Line 646: / Line 638: @@
 ===== Цвета =====
 В формате файлов символов и схем gEDA/gaf цвета определяются посредством
-целочисленного индекса. Соответствие между числом и цветом основывается
+целочисленного индекса. Соответствие между числом и цветом основывается на
-на типе объекта. Для каждого типа объекта обычно используется один или более
+типе объекта. Для каждого типа объекта обычно используется один или более
-цветов. Здесь
+цветов. Здесь приведена таблица соответствия цветовых индексов типам
-приведена таблица соответствия цветовых индексов типам объектов:
+объектов:
 ^Индекс^Тип объекта^Примечание^
@@ Line 659: / Line 651: @@
 |5|ATTRIBUTE_COLOR|Атрибут|
 |6|LOGIC_BUBBLE_COLOR|Логическая инверсия|
-|7|GRID_COLOR|Сетка|
+|7|DOTS_GRID_COLOR|Сетка|
 |8|DETACHED_ATTRIBUTE_COLOR|Неприкреплённый атрибут|
 |9|TEXT_COLOR|Текст|
@@ Line 681: / Line 673: @@
 цветовой индекс, но допустимо (иногда) назначать цвет, отличный от присущего
 данному типу объектов.
 ===== Атрибуты =====
 Атрибуты заключаются в фигурные скобки {} и могут быть только текстовыми
 объектами. Атрибуты представляют собой текстовые элементы вида
-''имя_атрибута=значение''. Если текст не содержит пары ''имя_атрибута=значение'', он не
+''имя_атрибута=значение''. Если текст не содержит пары
-является атрибутом.  Атрибуты прикрепляются к предшествующему объекту. Вот
+''имя_атрибута=значение'', он не является атрибутом.  Атрибуты прикрепляются
-пример:
+к предшествующему объекту. Вот пример:
 <code>P 988 500 1300 500 1
 {
@@ Line 697: / Line 688: @@
 }</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
 [
@@ Line 728: / Line 719: @@
 В примере выше, //''555-1.sym''// --- это компонент. Тег EMBEDDED и [ ] ---
 отличительные характеристики внедрённого компонента. Если требуется отменить
-внедрение компонента, символ //''имя_компонента.sym''// должен присутствовать в
+внедрение компонента, символ //''имя_компонента.sym''// должен
-одной из используемых библиотек.
+присутствовать в одной из используемых библиотек.
@@ Line 739: / Line 734: @@
   * Детали реализации; код **libgeda** взят из **librsvg**, библиотеки синтаксического анализа SVG. В результате большая часть синтаксиса контуров SVG читается правильно, однако синтаксис всегда внутренне нормализуется в абсолютные команды ''move'', ''line'', ''bezier curve'' и ''close-path'' (и сохраняется в таком виде).
   * Координаты всего контура указываются в стандартной координатной системе **gschem**.
   * Команды для контуров, выводимые и гарантированно обрабатываемые в gEDA, перечислены в нижеследующей таблице.\\ (Текст взят из вышеуказанной спецификации SVG).
   * В приведённой ниже таблице используются следующие условные обозначения:
     * (): группировка параметров
@@ Line 779: / Line 772: @@
 {{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 г.|В таблицы параметров добавлены столбцы позиции|

gEDA Project Wiki

User Tools

Site Tools

Differences

Page Tools