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

v    Особенности навигационных команд (FLY). Возвращаемый  код FLRET

Прежде всего о навигационных командах семейства Fly to…, Move to…, Follow to… нужно сказать, что все семейство относится к разряду прерываемых команд, то есть все они помечены значком «@». Это означает, что выполнение данной команды может быть прервано скриптом или сигналом имеющим более высокий приоритет. Еще одна особенность этих команд, это нелимитированость времени выполнения (исключение команды имеющие параметр timeout), то есть пока корабль не прилетит в указанное место, скрипт запустивший эту команду, будет ожидать ее завершения.

Все навигационные команды из этого семейства, возвращают значение содержащее информацию о результате выполнения команды. Для этих целей используется специально зарезервированный в ScE список кодов возврата, доступных для выбора из списка «Выберете код возврата» в скриптовом редакторе. Это коды FLRET_<значение>. Эти коды могут являться аргументами для оператора “IF” “IF NOT” “SKIP” “SKIP NOT” и т.п. 

Также вам следует знать, что не каждой команде из этого семейства доступен весь список кодов FLRET, для некоторых из них доступны лишь несколько значений. Далее, в описании команд, для команд из этого семейства будут указываться доступные константы.

Здесь приведен полный список кодов FLRET:

v    Организация глобального поиска объектов. Флаги поиска (Find).

Под глобальным поиском подразумевается, сложный поиск определенного объекта в пределах игровой галактики или сектора. Для этого служат команды из семейства FIND, относящихся к группе «Работа с объектами». Аргументы команд выполняющих поиск в секторах немного отличаются от аргументов команд ищущих по всей галактике. В этой главе, будут описаны основные параметры команд поиска. Поиск строится с использованием специальных флагов (Find. <значение>) и большого набора параметров. Рассмотрим на примере команды find station выполняющей поиск станции внутри сектора:

<RetVar/IF> find station: sector=<Var/Sector> class or type=<Value1> race=<Var/Race> flags=<Var/Number1> refobj=<Value2> maxdist=<Var/Number2> maxnum=<Var/Number3> refpos=<Var/Array>

sector – необходимо указать сектор поиска, если этот параметр не указан, то поиск не будет произведен и функция вернет null. В командах галактического поиска, на месте этого параметра как правило указывается сектор, от которого следует начать искать.

class or type – Это параметр задается в том случае, если надо искать станцию определенного типа (например док) выбирать его следует из списков  «Типы объектов» или «Класс объекта» предлагаемого редактором , если этот аргумент поставить null – в поиск буду включены все станции любой расы. Это аргумент связан с аргументом «race» через логического “И”

race – тоже самое, что и предыдущий параметр, только указывается раса владельца объект. Если параметр null, то раса значения иметь не будет.

flag – данный параметр является константой и определяет флаг для поиска. Флаги производят более тонкую настройку для поиска и отфильтровку требуемого объекта или объектов. Вообще параметр имеет числовой формат (Var/Number), связано это с тем, что каждая константа Find, имеет числовое значение соответствующее ей.  Флаг поиска может использоваться как в одиночку, так и в виде наборов флагов дополняющих или исключающих друг друга, составленных через бинарный логический оператор добавляющего ИЛИ «|», простые логические операторы «AND» или «OR», здесь негодятся. Например: Find.Neutral|Find.Nearest – поиск ближайшей станции только среди нейтральных – аналогия логического «И». А если написать Find.Neutral|Find.Enemy – поиск среди нейтральных или враждебных – аналогия логического «ИЛИ».

Если введен особый флаг Find.Multiple, то функция ВСЕГДА возвращает массив, и далее с этим результатом можно работать только, как с массивом, даже если он состоит из 1 элемента.

refobj – вообще этот параметр введен для того, что использовать его с флагом Find.Nearest оказывает он два действия:

1.данный объект исключается из поиска, если потенциально он в него может попасть.

2. служит точкой отсчета. Если, например, стоит флаг Find.Nearest, поиск ближайшей станции будет осуществляться относительно этого refobj

maximum – максимальный размер массива, работает только с флагом Find.Multiple, в противном случае результатом будет 1 станция (или null, если ничего не нашлось), а данный аргумент на поиск не влияет.

maxdist – ограничивает радиус поиска относительно точки отсчета: refobj или refpos. А если точки отсчета нет, то за точку отсчета принимается центр сектора. Если null – ограничения нет.

refpos – точка отсчета, массив из 3 координат x,y,z. Если ввести refpos и refobj одновременно, поиск будет относительно refobj. А если дополнительно установить флаг Find.ForceUsePos, то точка отсчета refpos оказывается главнее, чем точка отсчета refobj, поиск будет вестись относительно refpos.

В командах поиска по галактике, присутствуют еще несколько параметров:

max.jumps – Содержит максимальное количество прыжков до секторов в которых будет производиться поиск, от сектора где находится refobj.

serial – Для выбора по номерам станций (альфа, бета, гама).

num – Указывается сколько объектов соответствующих условиям поиска выбрать, обязательно должен быть установлен флаг Find.Multiple.