RU/Resource:Editor/EDF: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Blanked the page)
Line 1: Line 1:
{{RU/Resource page}}
__NOTOC__
EDF означает ''Editor Definition File'' (файл-описание редактора; формат объявлений редактора). EDF'ы являются XML-файлами с расширением .edf, которые описывают специфические элементы, используемые ресурсом: новые типы элементов, которых самих по себе в MTA нет. Образцами служат <spawnpoint> (спавн), <flag> (флаг), <checkpoint> (чекпоинт) и т.д. Они также используются для того, чтобы устанавливать настройки, используемые модами (gamemode), эти настройки находятся под тегом <settings> внутри ''meta.xml'' ресурса.


==Вступление==
Некоторые ресурсы используют специфические элементы карты. Например, мод захвата флага (CTF) скорее всего будет использовать элементы <flag>, которые будут содержать позиции флагов и их принадлежность командам. Когда загружается карта, мод ищет любые элементы <flag> и соответствующе расставляет флаги - например, через создание объекта флага и его коллизии.
Проблема с этими специфическими элементами в том, что в отличие от встроенных в MTA элементов, редактор карт не понимает, что они из себя представляют. Как должен быть визуально представлен собой элемент <flag>? Какие у него есть характеристики? Без передачи редактору этой информации, вы не сможете использовать его для создания таких специфических элементов, и вам придется прибегнуть к ручному редактированию .map-файла через текстовый редактор. К счастью, это необязательно: любой ресурс может содержать editor definition file, который опишет специфические элементы карты, используемые ресурсом.
==Использование definition files в редакторе==
Как и описано в [[RU/Resource:Editor|главной инструкции по редактору]], чтобы иметь возможность создавать специфические элементы ресурса на вашей карте, вам придется его добавить в окне ''Definitions''. Нажмите кнопку ''Definitions'' в главном меню и дважды щелкните по ресурсу из левого списка. Затем закройте окно и крутаните колесиком мыши в панели элементов, пока не появится желаемый ресурс. С этого момента вы можете создавать и управлять специфическими элементами этого ресурса, как и любым другим элементом.
==Построение EDF-файлов==
EDF-файлы - просто XML-файлы с расширением .edf. Начнем с образца: EDF'а мода Capture the Orb.
<syntaxhighlight lang="xml">
<def name="Capture the Orb">
    <element name="orb" friendlyname="Orb spawnpoint" instructions="Place your orb in a position that can be collected.">
        <data name="position" type="coord3d" default="0,0,0" />
        <marker size="0.5" type="corona" color="#ffff00ff" />
    </element>
    <element name="objective" friendlyname="Objective point" instructions="Place your objective point in a position that can be reached.">
        <data name="position" type="coord3d" default="0,0,0" />
        <marker size="3" type="cylinder" color="#9370dbaa" />
    </element>
    <element name="spawnpoint" friendlyname="Spawnpoint">
        <object editorOnly="true" model="3092" posZ="1" />
        <data name="position" type="coord3d" default="0,0,0" />
        <data name="rotation" type="coord3d" default="0,0,0" />
        <data name="skin" type="skinID" default="0" />
    </element>
</def>
</syntaxhighlight>
Как вы уже убедились, синтаксис очень легок для понимания. Root element (корневой элемент), &lt;def&gt;, содержит несколько &lt;element&gt;. Каждый из этих &lt;element&gt; описывает специфический элемент и задает его имя, визуальное представление и доступные ему настройки.
===Визуальное представление===
Каждый child node (дочерний узел) &lt;element&gt;, не являющийся &lt;data&gt;, отвечает за визуальное представление. Объектов, маркеров, пикапов и т.д. могут быть один или несколько. Для каждого элемента вы можете опционально задать позицию (posX, posY, posZ) и угол вращения (rotX, rotY, rotZ): они ''родственны'' с позицией и вращенем каждого отдельно взятого элемента. На примере Capture the Orb выше, если бы вы захотели создать spawnpoint на (30, 14, 3), редактор бы отобразил объект модели 3092 на координатах (30, 14, 4), потому что posZ объекта, равная 1, была бы сложена с координатой spawnpoint по оси z, равной 3.
===Настройки===
Настройки специфического элемента описаны в &lt;data&gt;. Имена некоторых настроек, такие как ''position'' и ''rotation'', особенные: они могут быть изменены при перемещении и вращении элемента прямо в редакторе. Другие настройки могут быть изменены в окне Properties.
===Визуальное представление, зависимое от настроек===
Специфический элемент можно сделать зависимым от одной или более настроек другого элемента. Например, элемент &lt;checkpoint&gt; race мода, содержащий &lt;marker&gt;: checkpoint имеет несколько атрибутов, таких как color и size, которые должны быть отражены и в marker. Чтобы это сделать, укажите какой-либо из-них в виде ''!propertyname!'' в качестве как одного или более атрибутов зависимого элемента. Например:
<syntaxhighlight lang="xml">
<def name="Race">
<element name="checkpoint" friendlyname="Race checkpoint">
<data name="position" type="coord3d" required="true" default="0,0,0" />
<data name="type" type="selection:checkpoint,ring" required="true" default="checkpoint" />
<data name="size" type="number" required="true" default="2.25"/>
<data name="color" type="color" required="false" default="#ff0000ff" />
...
<marker type="!type!" size="!size!" color="!color!" />
</element>
</def>
</syntaxhighlight>
Теперь, когда бы настройки checkpoint "type", "size" или "color" не менялись, новое значение будет также скопировано в его marker, в связи с чем их внешний вид будет меняться вместе.
===Интеграция в ресурсы===
Когда вы написали свой EDF, сохраните его как .edf-файл в папке своего ресурса и добавьте атрибут "edf:definition" в тег &lt;info&gt; meta.xml, как здесь:
<syntaxhighlight lang="xml">
<meta>
    <info author="erorr404" type="gamemode" ... edf:definition="cto.edf" />
    ...
</meta>
</syntaxhighlight>
==EDF ссылки==
===Вшитые элементы===
Эти элементы могут использоваться для ваших специфических элементов, вкупе с их настройками.
{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | &lt;blip&gt;
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|icon
| style="background-color: #EEE"|blipID
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}
{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | &lt;marker&gt;
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|markerType
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}
{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | &lt;object&gt;
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|objectID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}
{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | &lt;ped&gt;
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|skinID
|-
| style="background-color: #EEE"|rotZ
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}
{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | &lt;pickup&gt;
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|pickupType
|-
| style="background-color: #EEE"|amount
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|respawn
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}
{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | &lt;vehicle&gt;
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|vehicleID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|vehiclecolors
|-
| style="background-color: #EEE"|upgrades
| style="background-color: #EEE"|vehicleupgrades
|-
| style="background-color: #EEE"|plate
| style="background-color: #EEE"|plate
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}
{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | &lt;radararea&gt;
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|posX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|posY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}
===Вшитые названия настроек===
Настройки с данными именами особенно воспринимаются редактором и могут быть изменены не только через окно Properties.
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Тип
|-
! style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
! style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|}
===Типы настроек===
Это -  типы, которые могут быть выбранными в (&lt;data&gt;) ваших специфических элементов.
====Типы====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|boolean
| style="background-color: #EEE"|Простое двоичное (булевое) значение.
| style="background-color: #EEE"|"true" или "false"
|-
! style="background-color: #EEE"|natural
| style="background-color: #EEE"|Натуральное число (целое и неотрицательное).
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|integer
| style="background-color: #EEE"|Целое число.
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|number
| style="background-color: #EEE"|Рациональное число.
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|string
| style="background-color: #EEE"|Простая текстовая строка.
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|color
| style="background-color: #EEE"|цвет, с или без указания прозрачности (alpha).
| style="background-color: #EEE"|#RRGGBB или #RRGGBBAA
|}
====Координаты====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|camera
| style="background-color: #EEE"|Позиция и угол обзора камеры.
| style="background-color: #EEE"|posX,posY,posZ,lookatX,lookatY,lookatZ
|-
! style="background-color: #EEE"|coord3d
| style="background-color: #EEE"|3-компонентный вектор, зачастую используемый для позиции и вращения.
| style="background-color: #EEE"|x,y,z
|}
====Транспорт====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|plate
| style="background-color: #EEE"|Текст номерного знака для транспортного средства.
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|vehiclecolors
| style="background-color: #EEE"|цвета транспортного средства
| style="background-color: #EEE"|colorID1,colorID2,colorID3,colorID4
|-
! style="background-color: #EEE"|vehicleupgrades
| style="background-color: #EEE"|апгрейды (тюнинг) транспортного средства
| style="background-color: #EEE"|upgradeID1,upgradeID2,...
|}
====ID моделей====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|blipID
| style="background-color: #EEE"|ID картинки для метки
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|objectID
| style="background-color: #EEE"|ID модели для объекта
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|pickupType
| style="background-color: #EEE"|Броня, хп или оружие
| style="background-color: #EEE"|"armor", "health" или ID-номер оружия
|-
! style="background-color: #EEE"|skinID
| style="background-color: #EEE"|ID скина для педа
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|vehicleID
| style="background-color: #EEE"|ID модели для транспортного средства
| style="background-color: #EEE"|&nbsp;
|-
! style="background-color: #EEE"|weaponID
| style="background-color: #EEE"|Оружие, напр. M4
| style="background-color: #EEE"|ID-номер оружия, напр. 31
|}
====Колшейпы и маркеры====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|colshapeType
| style="background-color: #EEE"|коллизионные круг, куб, прямоугольник, сфера или труба
| style="background-color: #EEE"|Один из: "colcircle", "colcube", "colrectangle", "colsphere", "coltube"
|-
! style="background-color: #EEE"|markerType
| style="background-color: #EEE"|Стрелка, чекпоинт, кольцо, цилиндр или круглый маркер.
| style="background-color: #EEE"|Один из: "arrow", "checkpoint", "corona", "cylinder", "ring"
|-
|}
====Специальные====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|element:type
| style="background-color: #EEE"|Элемент определенного типа, например: element:flag
| style="background-color: #EEE"|ID элемента
|-
! style="background-color: #EEE"|selection:val1,val2,...
| style="background-color: #EEE"|Показывает выпадающий список, из которого можно выбрать одно из значений.
| style="background-color: #EEE"|Выборное значение
|}
[[en:Resource:Editor/EDF]]

Revision as of 16:08, 31 March 2016