Инструкция define

Описание инструкции define

Повторяющиеся фрагменты SDL можно описать с помощью инструкции define для дальнейшего многократного вызова в нужных местах.

Формат описания и вызова инструкции define

(define “name” [...])

name - имя инструкции, задается в двойных кавычках [...] - фрагмент SDL, который будет добавляться при вызове инструкции

Аргументы в инструкции define

Фрагмент SDL может содержать аргументы, значения которых обычно меняются от вызова к вызову.

Пример описания инструкции define без аргументов

(define "seismic_custom"
    {damage seismic {energy 10} {radius 8}}
)

Пример описания инструкции define с аргументами в виде порядкового номера

(define "seismic_custom"
    {damage seismic {energy %0} {radius %1}}
)

Пример описания инструкции define с именными аргументами

(define "seismic_custom"
    {damage seismic {energy %energy} {radius %radius}}
)

Вызов инструкции define

Вызов инструкции define происходит по ее имени. Имя заключается в двойные кавычки.

Формат вызова инструкции define

("name" [args])

Аргументы являются опциональными, поэтому в формуле формата они указаны в квадратных скобках.

Пример вызова инструкции define, которая не содержит аргументы

(“seismic_custom”)

Пример вызова Инструкции define с аргументами, которые заданы порядковым номером

("seismic_custom" args 10 8)

Пример вызова инструкции define с именными аргументами

(“seismic_custom” energy(10) radius(8))

При вызове Инструкции значения для именных агрументов могут отсутствовать.

Пример вызова инструкции define с пустым аргументом

(“seismic_custom” energy() radius(8))

Вложенные инструкции define

Инструкции define могут быть вложенными

Пример описания вложенной инструкции define

(define "set_default" ("content_%con"))

Инструкция set_default вызывает инструкцию content_%con

Пустые инструкции define

Пустые инструкции define используют в случае необходимости выключить одну или несколько вложенных инструкций. При этом часто при вызове инструкции в имени вложенной инструкции используется аргумент

Пример использования пустой инструкции define

(define "content_none")
(define "content_v" 
    {content data1}
)
(define "content_v_officer" 
    {content data2"}
)
(define "set_default" ("content_%con"))
...
("set_default" con(none))
("set_default" con(v) )
("set_default" con(v_officer))

Пустая инструкция content_none вызывается, когда content не нужен.

Инструкция content_%con является вложенной

Ее вызов происходит в инструкции "set_default"

В имени вложенной инструкции используется аргумент %con

При вызове инструкции "set_default" в качестве значения аргумента передают

нужное окончание: none, v или v_officer

От этого зависит, какая из инструкций "content_*" будет вызвана

Примеры

Альтернативное название инструкции define - макрос.

Пример основного макроса с базовым набором параметров

(define "set_generic"
  {charge %ch}
  ("score" sc(%sc))
  {tags "%tag %side"}
  ("cw_%cw")
  {cp %cp}
  {level %lvl}
  {cost 0}
  {fore 1}
)

Пример макроса со стандартным набором настроек

(define "set_default"
    ("content_%con" side(%side) n(%n))
    ("set_generic" ch(%ch) sc(%sc) tag(%tag) side(%side) cw(%cw) cp(%cp) lvl(%lvl))
    ("spawn_distance_%sd")
    ("territory_holder_%th")
)

Пример макроса верхнего уровня, который использует стандартные настройки

(define "set_v" 
    ("set_default" 
        con(v) 
        ch(0) 
        sc(%sc) 
        tag(%tag) 
        side(%side) 
        n(%n) 
        cw(%cw) 
        cp(%cp) 
        lvl(%lvl) 
        sd(default) 
        th(%th)
    )
)

Результатом вызова инструкции set_v будет итоговая настройка для юнита pz1b

{"pz1b" 
    ("set_v" 
        lvl(1) 
        tag(all tnk_light level_1) 
        side(ger) 
        n(2) 
        sc(10) 
        cw(s2) 
        cp(3) 
        th(tanks)
    )
}

Если у вас возникли сложности с пониманием терминологии и сути описания инструкции, то ознакомьтесь с информацией из статьи Общая информация о конфигурационных файлах