Описание класса game object. Часть V. - История изменений

Призрак: /* CWeapon */

2012-10-03T12:54:56Z

‎CWeapon

Призрак: /* CExplosive */

2012-10-03T12:54:06Z

‎CExplosive

K.D.: /* CLevelChanger (ЧН и ЗП) */

2011-12-19T17:35:46Z

‎CLevelChanger (ЧН и ЗП)

K.D. в 17:35, 19 декабря 2011

2011-12-19T17:35:07Z

K.D.: /* CInventoryBox */

2011-12-19T17:29:03Z

‎CInventoryBox

K.D. в 18:05, 18 декабря 2011

2011-12-18T18:05:26Z

K.D.: Новая страница: «{| border="0" cellpadding="3" align="right" width="250" cellspacing="1" style="background:#ccc;" |- ! style="background:#eaf1dd;" align="left"|Навигация ...»

2011-12-18T18:04:21Z

Новая страница: «{| border="0" cellpadding="3" align="right" width="250" cellspacing="1" style="background:#ccc;" |- ! style="background:#eaf1dd;" align="left"|Навигация ...»

Новая страница

{| border="0" cellpadding="3" align="right" width="250" cellspacing="1" style="background:#ccc;"
|-
! style="background:#eaf1dd;" align="left"|Навигация
|-
| style="background:#f9f9f9;" align="left"|
[[Описание класса game object. Часть I.]]<br/>
[[Описание класса game object. Часть II.]]<br/>
[[Описание класса game object. Часть III.]]<br/>
[[Описание класса game object. Часть IV.]]<br/>
[[Описание класса game object. Часть V.]]
|-
|}
__TOC__
='''CAI_PhraseDialogManager'''=
Эти методы можно применять только для сталкеров и торговцев.
<div class="NavFrame collapsed">
<div class="NavHead">'''function restore_default_start_dialog()''' </div>
<div class="NavContent"><cpp>void restore_default_start_dialog()</cpp>
устанавливает стартовый диалог неписю дефолтным. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_start_dialog(string)''' </div>
<div class="NavContent"><cpp>void set_start_dialog(string dialog_id)</cpp>
устанавливает диалог dialog_id неписю в качестве стартового диалога.<br /><br /></div></div>

='''CAI_Trader'''=
Эти методы можно применять только для торговцев.
<div class="NavFrame collapsed">
<div class="NavHead">'''function external_sound_start(string)''' </div>
<div class="NavContent"><cpp>void external_sound_start(string sound)</cpp>
вроде как включает для торговца звук sound, но останавливает анимацию головы. Используется в начальном туторе.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_start_dialog()''' </div>
<div class="NavContent"><cpp>void external_sound_stop()</cpp>
станавливает звук торговца. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_trader_global_anim(string)''' </div>
<div class="NavContent"><cpp>void set_trader_global_anim(string anim)</cpp>
устанавливает анимацию anim для тела торговца.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_trader_head_anim(string)''' </div>
<div class="NavContent"><cpp>void set_trader_head_anim(string anim)</cpp>
устанавливает анимацию anim для головы торговца.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_trader_sound(string, string)''' </div>
<div class="NavContent"><cpp>void set_trader_sound(string sound, string anim)</cpp>
устанавливает торговцу анимацию головы anim и включает в голове звук sound.<br /><br /></div></div>

='''CActor'''=
Эти методы можно применять только для актора.<br />Следующие методы не проверяют свой неявный аргумент, так что их можно применять хоть к бочкам. Объект в них берется с помощью actor()
<div class="NavFrame collapsed">
<div class="NavHead">'''function give_task(CGameTask*, number, boolean)''' </div>
<div class="NavContent"><cpp>void give_task(CGameTask* t, int dt, bool bCheckExisting)</cpp>
выдает актору задание. Аргументы:
*t - задание в виде объекта CGameTask. Можно взять методом CGameTask() и загрузить в него данные методом load().
*dt - время на завершение
*bCheckExisting - проверять ли на наличие. Если bCheckExisting == true, то задание, при его присутствии у актора не выдается, в противном случае инициализируется заново.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function get_task_state(string, number)''' </div>
<div class="NavContent"><cpp>task get_task_state(string task_id, int objective_num)</cpp>
возвращает состояние задания (поле task_state) для задания task_id и подзадания objective_num. Возвращает константу из класса-перечисления task.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_task_state(enum ETaskState, string, number)''' </div>
<div class="NavContent"><cpp>void set_task_state(enum ETaskState state, string task_id, int objective_num)</cpp>
устанавливает у подзадания таска одно из выбранных состояний. Аргументы:
*state - состояние (константа из класса-перечисления task)
*task_id - таск
*objective_num - номер подзадания <br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function hide_weapon()''' </div>
<div class="NavContent"><cpp>void hide_weapon()</cpp>
спрятать оружие актора. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function restore_weapon()''' </div>
<div class="NavContent"><cpp>void restore_weapon()</cpp>
достать оружие актора. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function eat(game_object*)''' </div>
<div class="NavContent"><cpp>void eat(game_object* item)</cpp>
заставляет актора съесть предмет item. Предмет должен наследовать от класса CEatableItem.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function give_talk_message(string, string, Frect, string)''' </div>
<div class="NavContent"><cpp>void give_talk_message(string text, string texture_name, Frect tex_rect, string templ_name)</cpp>
выводит сообщение в диалоговое окно. Пример - вывод списка доступных повторяющихся квестов в диалоге с торговцем. Аргументы:
*text - выводимый текст
*texture_name, tex_rect - параметры текстуры, где содержится выводимая картинка, можно получить через get_texture_info()
*templ_name - имя шаблона выводимой картинки. Регистрируется в talk.xml. Если не указано - движок считает, что это "iconed_answer_item"<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function give_game_news(string, string, Frect, number, number)''' </div>
<div class="NavContent"><cpp>bool give_game_news(string news, string texture_name, Frect tex_rect, int delay, int show_time)</cpp>
выводит сообщение в виде новости. Аргументы:
*news - выводимый текст
*texture_name, tex_rect - параметры текстуры, где содержится выводимая картинка, можно получить через get_texture_info()
*delay - задержка выдачи новости
*show_time - время показа новости<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_fastcall(const function<boolean>& , object)''' </div>
<div class="NavContent"><cpp>void set_fastcall(const function<boolean>& , object)</cpp>
установка быстрого обработчика.<br /><br /></div></div>
Следующие методы проверяют, к кому применются, вызывать их следует только для актора.

<div class="NavFrame collapsed">
<div class="NavHead">'''function run_talk_dialog(game_object*)''' </div>
<div class="NavContent"><cpp>void run_talk_dialog(game_object* pToWho)</cpp>
запускает диалог между актором и объектом pToWho. Тот объект должен наследовать от класса CInventoryOwner. Разговор можно начать только если собеседник находится на расстоянии не больше трёх метров от актора. Если точнее, то можно попытаться вызвать её и на больших расстояниях. Что-то при этом происходит: появляется мышь, отключается движение актора и он начинает смотреть на "собеседника" даже при том, что окна разговора нет. Такое ощущение, что просто безбожно глючит. Проверка допустимого расстояния перед началом остаётся таким образом на совести скриптёра. Расстояние в 3 метра никакими настройками не изменить, похоже вшито прямо в код движка. Другой момент. Данная функция только открывает диалог разговора. Если не делать ничего дополнительно, то непись "разговаривая" пойдёт себе дальше, и как только выйдет за три метра - разговор прервётся. В игре непись удерживается от убегания специальной скриптовой схемой, которая заставляет его стоять на месте, смотреть на актора, может ещё анимации проигрывать, точно не знаю. Параметр need_osoznanie_mode в секции персонажа позволяет избежать ограничения в 3 метра на возможность начать разговор. Однако при этом окно разговора показывается не полностью. Отсутствуют окна с иконками собеседников и окно чата. Есть только нижняя часть - окно выбора варианта ответа или диалога. Фактически, это превращает окно общения в своеобразное диалоговое окно для выбора одного из нескольких вариантов. Это используется в игре для предоставления Меченому выбора - присоединяться к О-Сознанию или нет. В принципе ничто не мешает использовать это как-то иначе.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_actor_direction(number)''' </div>
<div class="NavContent"><cpp>void set_actor_direction(float dir)</cpp>
устанавливает для актора направление взгляда, передаваемое углом вращения dir (в радианах).<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_actor_position(vector)''' </div>
<div class="NavContent"><cpp>void set_actor_position(vector pos)</cpp>
устанавливает для актора координаты, передаваемые вектором pos.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function switch_to_trade()''' </div>
<div class="NavContent"><cpp>void switch_to_trade()</cpp>
активировать окно торговли в диалоге. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function get_current_holder()''' </div>
<div class="NavContent"><cpp>holder* get_current_holder()</cpp>
возвращает машину или стационарное оружие, связанные в данный момент с актором. Аргументов не принимает.<br /><br /></div></div>
='''CInventoryBox'''=
Эти методы можно применять только для ящиков с инвентарем.
<div class="NavFrame collapsed">
<div class="NavHead">'''function is_inv_box_empty()''' </div>
<div class="NavContent"><cpp>bool is_inv_box_empty()</cpp>
проверяет, пустой ли ящик с инвентарем. Аргументов не принимает.<br /><br /></div></div>
='''CSpaceRestrictor'''=
Эти методы можно применять только для спейс рестрикторов и аномалий.
<div class="NavFrame collapsed">
<div class="NavHead">'''function inside(const vector&, number)''' </div>
<div class="NavContent"><cpp>bool inside(const vector& position, float epsilon) const</cpp>
возвращает true, если сфера с центром в position и радиусом epsilon персекается со спейс рестриктором. Аргументы:
*position - центр сферы, для которой проверяется пересечение со спейс-рестриктором (объект класса vector)
*epsilon - радиус сферы (float)<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function inside(const vector&)''' </div>
<div class="NavContent"><cpp>bool inside(const vector& position) const</cpp>
см. inside(const vector&, number), epsilon берется по умолчанию 0,001.<br /><br /></div></div>
='''CCustomZone'''=
Эти методы можно применять только для аномалий.
<div class="NavFrame collapsed">
<div class="NavHead">'''function disable_anomaly()''' </div>
<div class="NavContent"><cpp>void disable_anomaly()</cpp>
отключает аномалию. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function enable_anomaly()''' </div>
<div class="NavContent"><cpp>void enable_anomaly()</cpp>
активирует аномалию. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function get_anomaly_power()''' </div>
<div class="NavContent"><cpp>float get_anomaly_power()</cpp>
возвращает max_power для объекта аномалиию. Максимальное значение вроде 1. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_anomaly_power(number)''' </div>
<div class="NavContent"><cpp>void set_anomaly_power(float p)</cpp>
устанавливает max_power для объекта аномалии. Установить можно любое значение. Аргументов не принимает.<br /><br /></div></div>
='''CScriptZone'''=
Эти методы можно применять только для подходит только для скриптовых зон. Но в игре их вроде нет.
<div class="NavFrame collapsed">
<div class="NavHead">'''function active_zone_contact(number)''' </div>
<div class="NavContent"><cpp>void active_zone_contact(int id)</cpp>
возвращает true, если зона находится в контакте с объектом с индексом id.<br /><br /></div></div>
='''CProjector'''=
Эти методы можно применять только для прожекторов.
<div class="NavFrame collapsed">
<div class="NavHead">'''function get_current_direction()''' </div>
<div class="NavContent"><cpp>vector get_current_direction()</cpp>
возвращает текущее направление проектора. Аргументов не принимает.<br /><br /></div></div>
='''CHudItem'''=
Эти методы можно применять только для артефактов, гранат и оружия.
<div class="NavFrame collapsed">
<div class="NavHead">'''function animation_slot()''' </div>
<div class="NavContent"><cpp>int animation_slot() const</cpp>
возвращает номер слота анимации для данного объекта. Это не слот в инвентаре! Примеры:
*для пистолета - 1
*для автомата - 2
*для дробовика - 3
*для артефакта - 11
*для бинокля - 13.<br /><br /></div></div>
='''CExplosive'''=
Эти методы можно применять только для гранат и канистр.
<div class="NavFrame collapsed">
<div class="NavHead">'''function explode(number)''' </div>
<div class="NavContent"><cpp>void explode(int level_time)</cpp>
подрывает итем. Несмотря на наличие аргумента level_time, он вроде в функции не используется, так что управлять подрывом не выйдет.<br /><br /></div></div>
='''CAttachableItem'''=
Эти методы можно применять для всех инвентарных предметов.
<div class="NavFrame collapsed">
<div class="NavHead">'''function attachable_item_enabled()''' </div>
<div class="NavContent"><cpp>bool attachable_item_enabled() const</cpp>
возвращает, активен ли итем. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function enable_attachable_item(boolean)''' </div>
<div class="NavContent"><cpp>void enable_attachable_item(bool value)</cpp>
делает активным/неактивным итем. Parent итема должен наследовать от класса CAttachmentOwner. Всегда активны: аптечки, бинты, детекторы, патроны для активного оружия, активное оружие. Короче, все то, что в слотах или на горяих клавишах.<br /><br /></div></div>
='''CInventoryItem'''=
Эти методы можно применять для тех инвентарных предметов, у которых параметр class в конфиге не равен II_ATTCH.
<div class="NavFrame collapsed">
<div class="NavHead">'''function cost() const''' </div>
<div class="NavContent"><cpp>int cost() const</cpp>
возвращает стоимость вещи. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function condition() const''' </div>
<div class="NavContent"><cpp>int condition() const</cpp>
возвращает состояние вещи. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_condition(number)''' </div>
<div class="NavContent"><cpp>void set_condition(int val)</cpp>
устанавливает состояние вещи.<br /><br /></div></div>
='''CWeapon'''=
Эти методы можно применять только для оружия.
<div class="NavFrame collapsed">
<div class="NavHead">'''function get_ammo_total() const''' </div>
<div class="NavContent"><cpp>int get_ammo_total() const</cpp>
возвращает общее количество патронов для данного оружия в стволе и инвентаре, если ствол в инвентаре. Если не в инвентаре - просто количество патронов в обойме. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function get_ammo_in_magazine() const''' </div>
<div class="NavContent"><cpp>int get_ammo_in_magazine() const</cpp>
возвращает количество патронов в стволе. Аргументов не принимает.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function set_ammo_elapsed(number)''' </div>
<div class="NavContent"><cpp>void set_ammo_elapsed(int ammo_elapsed)</cpp>
заряжает магазин количеством патронов, равным ammo_elapsed. Размер магазина игнорируется.<br /><br /></div></div>

='''CWeaponMagazined'''=
Эти методы можно применять только для оружия - кроме ножа и гранат.
<div class="NavFrame collapsed">
<div class="NavHead">'''function set_queue_size(number)''' </div>
<div class="NavContent"><cpp>void set_queue_size(int queue_size)</cpp>
устанавливает размер очереди из оружия.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function unload_magazine()''' </div>
<div class="NavContent"><cpp>void unload_magazine()</cpp>
разряжает магазин оружия. Оружие должно быть в инвентаре/руках объекта CAI_Stalker. Патроны из ствола пропадают. Аргументов не принимает.<br /><br /></div></div>

='''Методы получения объектов "чистых" клиентских движковых классов'''=
Эти методы позволяют получить объект чистого движкового класса из объекта класса-обертки CScriptGameObject.
<div class="NavFrame collapsed">
<div class="NavHead">'''function get_car()''' </div>
<div class="NavContent"><cpp>CCar* get_car()</cpp>
возвращает объект машины.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function get_holder_class()''' </div>
<div class="NavContent"><cpp>holder* get_holder_class()</cpp>
возвращает машину или стационарное оружие, связанные в данный момент с актором.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function get_hanging_lamp()''' </div>
<div class="NavContent"><cpp>hanging_lamp* get_hanging_lamp()</cpp>
озвращает объект лампочки.<br /><br /></div></div>

<div class="NavFrame collapsed">
<div class="NavHead">'''function get_helicopter()''' </div>
<div class="NavContent"><cpp>CHelicopter* get_helicopter()</cpp>
возвращает объект вертолета.<br /><br /></div></div>
Следующие методы присутствуют начиная с ЧН.
<div class="NavFrame collapsed">
<div class="NavHead">'''function get_campfire()''' </div>
<div class="NavContent"><cpp>CZoneCampfire* get_campfire()</cpp>
возвращает объект костра.<br /><br /></div></div>
<div class="NavFrame collapsed">
<div class="NavHead">'''function get_artefact()''' </div>
<div class="NavContent"><cpp>CArtefact* get_artefact()</cpp>
возвращает объект артефакта.<br /><br /></div></div>
<div class="NavFrame collapsed">
<div class="NavHead">'''function get_physics_object()''' </div>
<div class="NavContent"><cpp>CPhysicObject* get_physics_object()</cpp>
возвращает объект физических предметов (ящики, коробки).<br /><br /></div></div>

----
Написано [[Участник:K.D.|K.D.]] 18:04, 18 декабря 2011 (UTC) по материалам malandrinus, материалам [http://www.amk-team.ru/forum/index.php?showtopic=7450 форума АМК] и собственным изысканиям.

[[Категория:Скрипты]]

@@ Строка 183: / Строка 183: @@
 устанавливает max_power для объекта аномалии. Установить можно любое значение. Аргументов не принимает.<br /><br /></div></div>
 ='''CLevelChanger (ЧН и ЗП)'''=
-Эти методы можно применять только для  аномалий.
+Эти методы можно применять только для переходов.
 <div class="NavFrame collapsed">
 <div class="NavHead">'''function is_level_changer_enabled()''' </div>
@@ Строка 198: / Строка 198: @@
 <div class="NavContent"><cpp>void set_level_changer_invitation(string invitation)</cpp>
 установить текст в окне запроса при переходе. Для ЗП не актуально.<br /><br /></div></div>
 ='''CScriptZone'''=
 Эти методы можно применять только для подходит только для скриптовых зон. Но в игре их вроде нет.

@@ Строка 287: / Строка 287: @@
 <div class="NavHead">'''function get_ammo_in_magazine() const''' </div>
 <div class="NavContent"><cpp>int get_ammo_in_magazine() const</cpp>
-возвращает количество патронов в стволе. Аргументов не принимает.<br /><br /></div></div>
+возвращает количество патронов в стволе или в пачке патрон. Аргументов не принимает.<br /><br /></div></div>
 <div class="NavFrame collapsed">
 <div class="NavHead">'''function set_ammo_elapsed(number)''' </div>
 <div class="NavContent"><cpp>void set_ammo_elapsed(int ammo_elapsed)</cpp>
 заряжает магазин количеством патронов, равным ammo_elapsed. Размер магазина игнорируется.<br /><br /></div></div>
 ='''CWeaponMagazined'''=

@@ Строка 227: / Строка 227: @@
 <div class="NavHead">'''function explode(number)''' </div>
 <div class="NavContent"><cpp>void explode(int level_time)</cpp>
-подрывает итем. Несмотря на наличие аргумента level_time, он вроде в функции не используется, так что управлять подрывом не выйдет.<br /><br /></div></div>
+подрывает итем. Несмотря на наличие аргумента level_time, он вроде в функции не используется, так что управлять подрывом не выйдет. UPDATE: данный аргумент вообще отсутствует у функции, поэтому функцию можно вызывать как explode()<br /><br /></div></div>
 ='''CAttachableItem'''=
 Эти методы можно применять для всех инвентарных предметов.

@@ Строка 182: / Строка 182: @@
 <div class="NavContent"><cpp>void set_anomaly_power(float p)</cpp>
 устанавливает max_power для объекта аномалии. Установить можно любое значение. Аргументов не принимает.<br /><br /></div></div>
 ='''CScriptZone'''=
 Эти методы можно применять только для подходит только для скриптовых зон. Но в игре их вроде нет.
@@ Строка 238: / Строка 254: @@
 <div class="NavContent"><cpp>void set_condition(int val)</cpp>
 устанавливает состояние вещи.<br /><br /></div></div>
 ='''CWeapon'''=
 Эти методы можно применять только для оружия.
@@ Строка 303: / Строка 340: @@
 ----
-Написано [[Участник:K.D.|K.D.]] 18:04, 18 декабря 2011 (UTC) по материалам malandrinus, материалам [http://www.amk-team.ru/forum/index.php?showtopic=7450 форума АМК] и собственным изысканиям.
+Написано [[Участник:K.D.|K.D.]] 17:35, 19 декабря 2011 (UTC) по материалам malandrinus, материалам [http://www.amk-team.ru/forum/index.php?showtopic=7450 форума АМК] и собственным изысканиям.
 [[Категория:Скрипты]]

@@ Строка 142: / Строка 142: @@
 <div class="NavContent"><cpp>bool is_inv_box_empty()</cpp>
 проверяет, пустой ли ящик с инвентарем. Аргументов не принимает.<br /><br /></div></div>
 ='''CSpaceRestrictor'''=
 Эти методы можно применять только для спейс рестрикторов и аномалий.

@@ Строка 52: / Строка 52: @@
 ='''CActor'''=
-Эти методы можно применять только для актора.<br />Следующие методы не проверяют свой неявный аргумент, так что их можно применять хоть к бочкам. Объект в них берется с помощью actor()
+Эти методы можно работают для актора.<br />Следующие методы не проверяют свой неявный аргумент, так что их можно применять хоть к бочкам. Объект в них берется с помощью actor()
 <div class="NavFrame collapsed">
 <div class="NavHead">'''function give_task(CGameTask*, number, boolean)''' </div>