kOS. Полное руководство на русском языке.

Всем доброго времени суток.


Данный гайд - практически полностью переведенная официальная английская инструкция по kOS. Теперь вы можете ознакомится с ней в полном русском варианте с моими комментариями для самых маленьких.

Руководство полностью переведено, разъяснено и дополнено мною (Finn163), и по сути является дословным переводом английского руководства с некоторыми комментариями. Надеюсь всем вам оно окажется полезным.

Всем приятного изучения замечательного языка kOS.

Русскоязычная инструкция по моду kOS.


Описание мода kOS

kOS - мод на скриптовый автопилот для Kerbal Space Program. Он позволит вам писать небольшие программы для автоматизации некоторых задач.

Установка.

Как и останльные моды, распаковать zip архив в папку с игрой.


Как использовать?

Добавьте модуль kOS в ангаре на свой корабль, он находится во вкладке "Контроль". После перехода на стартовый стол\взлетную полосу,
кликаем на модуль правой кнопкой мыши и выбираем функцию "Open Terminal". Это предоставит нам доступ к интерфейсу мода kOS, в нем вы как в командной строке, можете начать с ним работу.

Кербоскрипт.

Кербоскрипт - это язык програмирования планеты кербин, звучащий как Английский. Синтаксис языка "показательный"(имеется ввиду, что всё названо своими именами).
Язык достаточно прост, даже для начинающих програмистов, поэтому язык НЕ зависит от регистра и автоматически коректирует некоторые команды.

Типичные команды Кербоскрипта выглядят примерно так:

PRINT "Hello World”. \\ Напечатай "Привет мир"

Выражения.

Кербоскрипт использует систему оценки выражений, которая позволяет выполнять математические операции над переменными.
Некоторые переменные определены Вами. Другие определяется системой.

Базовых типов всего три:

1.Числа.

Вы можете использовать математические операции с числами, например вот так:

SET X TO 4 + 2.5. // сделай Х равным 4+2,5; Заметьте Несмотря на то, что все команды кончаются точками, нецелые числа так же используют точку как разделитель.
PRINT X. // Напечатай Х. Напечатается "6.5"

Система соответствует порядку операций, но в настоящее время реализация несовершенна. Например, умножение всегда будет выполняться до разделения, независимо от "физического" положения операторов. Это будет исправлено в будущих версиях.

2.Строчные данные (Strings). // по сути слова

Строчные данные - это текст, который к примеру надо написать на мониторе. Например:

PRINT "Hello World!”. // Напиши "Привет мир!".
Для объединения строк, вы можете использовать оператор "+". Это так же работает со смесями чисел и строк.

3.Directions(Направления)

Направление(Direction) существуют прежде всего для включения автоматического рулевого управления. Вы можете инициализировать направление с помощью вектора или вращения.

SET Direction TO V(0,1,0). // Установить направление - вектор
SET Direction TO R(0,90,0). // Установить направление поворотом в градусах

Также, вы можете использовать математические операции направлений. Следующий пример использует вращение "UP" (системная переменная, описывающая вектор непосредственно от небесного тела во влиянии которого вы находитесь).

SET Direction TO UP + R(0,-45,0). // Установить направление на 45 градусов западней от "UP" (верха).

Справочник по командам

- Математические функции.


- Полет.


- Файлы ввода/вывода (имеется ввиду работа с файлами в которых вы пишите программу из самой игры)



- Управление потоком (имеется ввиду поток информации поступающей в консоль от программы во время её работы)


- Команды вывода и т.п.


Справочник по структурам.

Структуры это элементы, которые могут содержать больше одной единицы информации. Структуры можно использовать с командой SET.. TO как и с обычными переменными. К их под элементам можно получить доступ через имя вложенного элемента.

- Atmosphere // атмосфера


- Body // Тело


- Direction // Направление


- Engine //Двигатель


- GeoCordinates // Геокоординаты


- List // Список


- Node // Узел


- Orbit // Орбита


- Time // Время


- Vector // Вектор


- Vessel // Корабль



Летная статистика.

Вы можете получить полезную статистику во время полета вашего корабля.

ALTITUDE // Абсолютная высота (над грунтом)
ALT:RADAR // Радарная высота (Та же что на счетчике сверху)
BODY // Текущее тело у которого ты под влиянием.
MISSIONTIME // Текущее время миссии.
VELOCITY // Текущая ОРБИТАЛЬНАЯ скорость
VERTICALSPEED // Вертикальная скорость
SURFACESPEED // Горизонтальная скорость
STATUS // Статус (посажен, разбился, летишь на орбите и т.п.): LANDED, SPLASHED, PRELAUNCH, FLYING, SUB_ORBITAL, ORBITING, ESCAPING, or DOCKED
INLIGHT // Возвращает единицу если никакие небесные тела не блокирует свет Кербола.(выдает 1 если ты не в тени).
INCOMMRANGE // Не понял точно, но скорее всего возвращает расстояние необходимое для вхождения в зону влияния
COMMRANGE // Непонятно
MASS // Масса
MAXTHRUST // Максимальная тяга всех активных двигателей
VESSELNAME // Название аппарата


Вектора

Это возвращает векторные значения. Может быть использовано с командой LOCK для осуществления управления аппаратом.

PROGRADE
RETROGRADE
UP // Направление от текущего небесного тела (как я понимаю есть и Down и Forward и т.д.)


Геометрические значения орбиты.

Возвращает необходимые значения

APOAPSIS // Высота апогея
ALT:APOAPSIS // Так же высота апогея
PERIAPSIS // Высота перегея
ALT:PERIAPSIS // Так же высота перегея
ETA:APOAPSIS // Время до апогея
ETA:PERIAPSIS // Время до перегея.


Маневровые узлы

NODE // Направление следующего маневрового узла(нода), может быть использовано для команды LOCK STEERING (Закрепление ориентации)
ETA:NODE // Время до следующего нода.
ENCOUNTER // Возвращает небесное тело которое встретишь.
NEXTNODE // Следующий нод.


Ресурсы

Типы ресурсов

LIQUIDFUEL
OXIDIZER
ELECTRICCHARGE
MONOPROPELLANT
INTAKEAIR
SOLIDFUEL //В принципе можно задать цикл, который пишет в консоль каждую секунду и указать например любой из этих ресурсов.


Конкретные значения ступеней

STAGE:LIQUIDFUEL // Жидкое топливо в данной ступени.
STAGE:OXIDIZER

Глобальные значения

PRINT . // Пишет всё жидкое топливо во всех баках. УСТАРЕЛО
PRINT SHIP:LIQUIDFUEL. // Пишет всё жидкое топливо во всех баках..
PRINT VESSEL("kerbRoller2"):LIQUIDFUEL. // Пишет всё жидкое топливо во всех баках аппарата с именем "kerbroller2".
PRINT TARGET:LIQUIDFUEL. // Пишет всё жидкое топливо во всех баках цели.


Контроль полёта

Эти значения могут быть использованы с командами SET, TOGGLED, или LOCKED. Некоторые значения, такие как THROTTLE(Дроссель) и STEERING(Управление ориентацией), явно требуют использования команды LOCK(закрепить).

Контроль с использованием команд ON и OFF


SAS // Для этих пяти, используй ON и OFF, например: SAS ON. RCS OFF.
GEAR
RCS
LIGHTS
BRAKES
LEGS
CHUTES // Не могут быть не развернуты(?)
PANELS


Элементы управления использующие команду TOGGLE

ABORT
AGX // Х - номер Экшен группы(может быть от 1 до 10). Используй toggle, например: TOGGLE AG1.(Переключить Экшн группу №1)


Контроль который должен использвать команду LOCK

THROTTLE // Закрепляй(LOCK) значение от 0 до 1(если надо половину то пиши так(LOCK THROTTLE TO 0.5.)).
STEERING // Закрепление направление.
WHEELTHROTTLE // Отдельные дроссельные заслонки для колес
WHEELSTEERING // Отдельная управляющая система для колёс


Система кОС

Возвращает значения версий