colobot-data/help/cbot/R/radar.txt

61 lines
4.5 KiB
Plaintext
Raw Normal View History

\b;Инструкция \c;radar\n;
С помощью инструкции \c;radar()\n; вы можете следить за такими объектами как \l;враги\u object\mother;, боты, здания или природные ископаемые.
\b;Основное использование
В скобках напишите \l;название объекта\u cbot\category;, который вы ищете. Поместите результат в переменную \l;типа\u cbot\type; \c;объекта\n;. Вот пример поиска ближайшего муравья:
\c;
\s;// В начале программы:
\s;object item; // объявление переменной
\s;
\s;// Поиск ближайшего муравья
\s;item = radar(AlienAnt);
\n;
\b;Для специалистов
Синтаксис:
\s;\c;radar ( категория, угол, фокус, мин, макс, путь );\n;
Обнаруживает объект в соответствии с несколькими параметрами.
\image radar1 8 8;
Как видно выше, пурпурная зона соответствует зоне, где будут обнаружены объекты.
\t;категория: \c;\l;int\u cbot\int;\n;
\l;Категория\u cbot\category; объекта, который нужно обнаружить. Например когда вы ищете муравья, напишите \c;radar (AlienAnt)\n;.
\t;угол: \c;\l;float\u cbot\float;\n; (значение по умолчанию\c;0\n;)
Направление, в котором смотрит радар, в градусах.
\c; 0\n; -> радар смотрит прямо вперед
\c;-90\n; -> радар смотрит на четверть круга вправо
\c; 90\n; -> радар смотрит на четверть круга влево
\t;фокус: \c;\l;float\u cbot\float;\n; (значение по умолчанию\c;360\n;)
Угол раскрытия радара в градусах.
\t;мин: \c;\l;float\u cbot\float;\n; (значение по умолчанию \c;0\n;)
Минимальное расстояние обнаружения в метрах. Объекты, которые находятся на расстояниях меньших, чем минимальное расстояние, обнаружены не будут.
\t;макс: \c;\l;float\u cbot\float;\n; (Значение по умолчанию\c;1000\n;)
Максимальное расстояние обнаружения в метрах. Объекты, которые находятся на расстояниях, больше максимального расстояния, обнаружены не будут.
\t;путь: \c;\l;float\u cbot\float;\n; (значение по умолчанию\c;1\n;)
Определяет каким образом будут обнаруживаться объекты. Если его значение \c;1\n;, то будет возвращен ближайший объект в указанной зоне. Если значение \c;-1\n;, то будет возвращен самый дальний объект в зоне обнаружения.
\t;Возвращаемое значение: \c;\l;object\u cbot\object;\n;
Возвращает первый найденный объект, который соответствует указанной категории в указанной зоне. Если объект найден не был, то возвращается значение \c;\l;null\u cbot\null;\n;.
\t;Замечание
Вы не должны указывать все параметры. Вот два примера эквивалентных инструкций:
\c;
\s; radar(Titanium, 0, 360, 0, 1000);
\s; radar(Titanium); // эквивалентна предыдущей
\s; radar(Titanium, 0, 90, 0, 1000);
\s; radar(Titanium, 0, 90); // эквивалентна предыдущей
\n;
Когда не определен один или более параметров, то используются указанные выше значения по умолчанию; обязателен только первый параметр.
Обычно указывается только первый параметр: например \c;radar (AlienAnt)\n; обнаружит ближайшего муравья, где бы он ни был.
\t;Смотри также
\l;Программирование\u cbot;, \l;типы\u cbot\type; и \l;категории\u cbot\category;.