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

36 lines
3.5 KiB
Plaintext
Raw Normal View History

\b;Инструкция \c;goto\n;
Инструкция \c;goto();\n; приказывает боту достигнуть означенной позиции.
\b;Основное использование
Самое распространенное использование состоит в том, чтобы переместить бот к обьекту, обнаруженному с помощью инструкции \c;\l;radar\u cbot\radar;();\n;. Если информация, добытая инструкцией \c;\l;radar\u cbot\radar;();\n; помещена в определенную переменную, напишите имя этой переменной, а за ним \c;.position\n;, чтобы получить местоположение обьекта. Ниже приведен пример программы, которая ищет \l;титановый куб\u object\titan;, идет в его местоположение и берет его:
\c;
\s; item = \l;radar\u cbot\radar;(Titanium);
\s; goto(item.position);
\s; \l;grab\u cbot\grab;();
\n;
\b;Для специалистов
Синтаксис:
\s;\c;goto ( position, altitude, goal, crash );\n;
Приказывает роботу двигаться к выбранной позиции, избегая все препятствия, если это возможно.
\t;pos: \c;\l;point\u cbot\point;\n;
Координаты позиции цели.
\t;altitude: \c;\l;float\u cbot\float;\n;
Высота полета для \l;летающих ботов\u object\botgj;. Высота имеет смысл только для \l;летающих ботов\u object\botgj;. От начальной высоты, бот забирается выше, пока не достигнет назначенной высоты. Когда он окажется близко к цели, он спускается и приземляется в назначенном месте. Если значение высоты не задано, по умолчанию принимается значение 10 метров. На очень коротких дистанциях, даже летающий бот останется на земле. Для всех ботов за исключением летающих, этот параметр игнорируется.
\t;goal: \c;\l;int\u cbot\int;\n; (по умолчанию \c;0\n;)
Этот параметр говорит боту, каким образом он должен достичь цели:
\c;0\n; остановка прямо в позиции цели
\c;1\n; подходит близко к позиции цели, не останавливаясь.
Если нет значение по умолчанию, \c;1\n; (точность) является значением по умолчанию.
\t;Возвратное значение: \c;\l;int\u cbot\int;\n;
Обычно в случае ошибки программа останавливается. Вы можете приказать программе не останавливаться, с помощью инструкции \c;\l;errmode\u cbot\errmode;(0)\n;. Тогда в случае ошибки инструкция \c;goto()\n; возвращает значение отличное от нуля.
\c;== 0 \n;Достиг позиции цели
\c;!= 0 \n;Невозможно достичь позиции цели
\t;См. также
\l;Программирование\u cbot;, \l;типы\u cbot\type; и \l;категории\u cbot\category;.