No replies to this topic

[MrCreppo]

Этот небольшой учебник по использованию БИСовских функций сделан в основном для опытных пользователей, которые знакомы со скриптами .sqf формата и вызовом БИСовских функций через скрипт, и служит примером использования определенных функций в своих миссиях, расширяя их функционал.

Итак сегодня будут рассмотрены функции:

1. taskCreate

2. taskSetCurrent

3. taskSetState

4. taskSetDestination

5. taskSetDescription

Напоминалка для тех кто уже знаком с функциями и для тех кто тут впервые:

Скрытый текст

Функция - .sqf скрипт который выполняет определенную функцию в игре по заданным параметрам.

Вызывается так:

[параметр1, параметр2...] call BIS_fnc_имяфункции;

Запомните - ВСЕ названия БИСовских функций начинаются на BIS_fnc_

 

Итак, начнем!

 

1. taskCreate

Скрытый текст

Данная функция создает задачу в дневнике, и выводит "красивое окошечко" на наш ГИП (Графический Интерфейс Пользователя).

Можно вызывать как и через .sqf скрипт, так и через редактор.

 

Имеет 6 параметров:

1. Объект, группа, сторона или массив. Это владелец задачи - для одиночных миссий целесообразно установить player.

2. Строка(текст) или массив. Это скриптовое имя задачи, то есть оно нужно только для вызова других функций связанных с этим именем (например taskSetState). Массив имеет вид

[имя_задачи, имя_родительской_задачи].

3. Массив или строка. Это описание задания. Строка - это информация из класса CfgTaskDescriptions (это нам не нужно). Нам нужен массив, который имеет вид ["описание", "заголовок", "текст_на_маркере_задания"].

4. Объект, массив или строка. Это назначение задачи (расположение). Массив - это координаты вида [x, y, z] где Z - высота. Объект - имя объекта вписываемое при его создании. Строка - тоже что и объект, но может работать с маркерами.

5. Логика(true/false) или строка. Это статус задачи (создано, назначено, выполнено...). Строка - это задание статуса текстом:

• "Succeeded" - Выполнено
• "Failed" - Провалено
• "Canceled" - Отменено
• "Created" - Создано
• "Assigned" - Назначено

Логика - при true статус задания устанавливается на "Назначено".

6. Номер. Это приоритет задачи. Более высокое число повлияет на автоматический выбор задания при выполнении/провале/отмене назначенного ранее задания.

 

Пример:

[player, "zadacha", ["Мое описание", "Мой заголовок задачи", "Сюда нужно идти"], "helicopter", true, 0] call BIS_fnc_taskCreate;

 

2. taskSetCurrent

Скрытый текст

Данная функция делает указанное задание назначенным.

Параметр один:

Строка - Это скриптовое имя задания, которое указывалось при создании его через функцию taskCreate.

 

Пример:

["zadacha"] call BIS_fnc_taskSetCurrent;

 

3. taskSetState

Скрытый текст

Данная функция устанавливает статус задачи (создано, назначено, выполнено...).

Имеет 3 параметра:

1. Строка. Это скриптовое имя задания, которое указывалось при создании его через функцию taskCreate.

2. Строка. Это статус задачи (создано, назначено, выполнено...). Строка - это задание статуса текстом:

• "Succeeded" - Выполнено
• "Failed" - Провалено
• "Canceled" - Отменено
• "Created" - Создано
• "Assigned" - Назначено

3. Логика(true/false). Этот параметр отвечает за "красивую табличку" на ГИП, котроая информирует нас о том что статус задания сменился. Тут все ясно: true - появится, false - не появится.

 

Пример:

["zadacha", "Assigned", true] call BIS_fnc_taskSetState;

 

4. taskSetDestination

Скрытый текст

Данная функция задает назначение задания.

Имеет 2 параметра:

1. Строка. Это скриптовое имя задания, которое указывалось при создании его через функцию taskCreate.

2. Объект или массив. Массив - это координаты вида [x, y, z] где Z - высота. Объект - имя объекта вписываемое при его создании.

 

Пример:

["zadacha", [1749, 4873, 17]] call BIS_fnc_taskSetDestination;

 

5. taskSetDescription

Скрытый текст

Данная функция устанавливает описание для задания, его заголовок и текст на маркере.

Имеет 2 параметра:

1. Строка. Это скриптовое имя задания, которое указывалось при создании его через функцию taskCreate.

2. Массив. Это описание задания. Массив имеет вид ["описание", "заголовок", "текст_на_маркере_задания"].

 

Пример:

["zadacha", ["Мое описание задачи", "Мой заголовок", "Идти сюда"]] call BIS_fnc_taskSetDescription;

 

Пока это все. Будут еще части. Спасибо за внимание.

 

Комментируйте - какие вопросы вас беспокоят, и может я найду функцию по этому вопросу и добавлю в следующую часть учебника.

Edited by MrCreppo, 04 July 2014 - 19:57.