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

61 lines
4.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

\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;.