Сповіщення
Очистити все
15.10.2023 17:06
Game_object – клас для доступу до онлайнових (клієнтських) об'єктів. Причому один клас є інтерфейсом для різних об'єктів. Розробники не придумали нічого кращого, як узяти та об'єднати в одному класі всі інтерфейси всіх клієнтських об'єктів: актора, сталкерів, монстрів, фізичних об'єктів, автомобілів та лампочок, взагалі всіх. Дивнішого і взагалі кажучи потворного об'єктно-орієнтованого дизайну я ще не бачив. По-перше, клас вийшов абсолютно неосяжним - три сотні методів! По-друге, виклик не підходящого методу для довільно взятого об'єкта призводить до абсолютно непередбачуваних результатів. У кращому випадку нічого не буде, а найчастіше - буде виліт, причому зазвичай без лога. Нарешті, опис цього класу в lua_help зовсім невиразне (як утім і всіх інших класів): типи значень, що повертаються, опущені, типи вхідних аргументів зазначені не завжди, а про призначення більшості методів можна тільки ворожити. Пропоную дещо більш виразний опис. Методи розсортовані за клієнтськими класами, до об'єктів яких можна застосувати метод. Також нагадую, що класи при наслідуванні також успадковують і всі методи батьківського класу.
ANY CLASS
Ці методи підходять до об'єктів будь-якого класу
function direction() const
vector direction ( ) const
повертає напрямок погляду (об'єкт класу vector). Аргументів не сприймає.
function position() const
vector position ( ) const
повертає координати об'єкта (об'єкт класу vector). Аргументів не сприймає.
function center() const
vector center ( )
повертає координати центру баунд сфери об'єкта (фізичної оболонки, грубо кажучи). Практично те саме, що й position. Зазвичай використовується для перевірки входження актора у сферу. Повертає об'єкт класу вектор. Аргументів не сприймає.
function game_vertex_id() const
int game_vertex_id ( ) const
повертає об'єкт game_vertex_id. Аргументів не сприймає.
function level_vertex_id() const
int level_vertex_id ( ) const
повертає об'єкт level_vertex_id. Аргументів не сприймає.
function level_vertex_light() const
float level_vertex_light ( const int level_vertex_id ) const
Лише ТЧ. завжди повертає 0. Щось пов'язане з аї-сіткою, але, мабуть, нині марне.
function id() const
int id ( ) const
повертає ID об'єкта. Аргументів не сприймає.
function name() const
string name ( ) const
повертає системне ім'я об'єкта (зазвичай виглядає як комбінація імені секції та id). Аргументів не сприймає.
function section() const
string section ( ) const
повертає ім'я розділу об'єкта. Аргументів не сприймає.
function spawn_ini() const
ini_file* spawn_ini ( ) const
повертає дескриптор ltx файлу (об'єкт класу ini_file), з якого вичитувалися налаштування спавна об'єкта.
function story_id() const
int story_id ( ) const
повертає об'єкт story_id (унікальний ідентифікатор). Аргументів не сприймає. Якщо об'єкт не має story_id, повертає -1.
function clsid() const
int clsid ( ) const
повертає clsid об'єкта, що є ідентифікатором класу. Значення, що повертається, є числовим еквівалентом рядкового ідентифікатора, заданого в конфізі об'єкта параметром class. Аргументів не сприймає.
function bone_position(string) const
vector bone_position ( string bone_name ) const
повертає координати кістки. Приймає один аргумент – ім'я кістки. Може бути застосований до будь-якого об'єкта, але модель об'єкта при цьому повинна мати тип MT_SKELETON_ANIM або MT_SKELETON_RIGID , коротше, мати ці кістки
function binded_object()
object_binder* binded_object ( )
повертає об'єкт lua-класу object_binder, прив'язаний до біндера функцією bind_object(). Аргументів не сприймає.
function bind_object(object_binder*)
void bind_object ( object_binder* game_object )
прив'язує об'єкт до біндеру. Аргументів не сприймає.
function hit(hit*)
void hit ( hit * tpLuaHit )
завдає хіт об'єкту. Як аргумент передається об'єкт класу hit. У цього об'єкта обов'язково повинні бути виставлені властивості draftsman , power , direction , type , impulse
function play_cycle(string, boolean)
void play_cycle ( string anim, bool mix_in )
програє анімацію об'єкта. Аргументи:
- anim - ім'я анімації
- mix_in – як я зрозумів, встановлює накладення анімації на поточну.
Сам об'єкт може бути будь-яким, але модель об'єкта повинна мати тип MT_SKELETON_ANIM (тобто підтримувати анімацію).
function play_cycle(string)
void play_cycle ( string anim )
аналогічно попередньої mix_in за замовчуванням береться true.
CObject
Оскільки всі ігрові об'єкти успадковують від класу CObject , такі методи можна застосовувати до будь-яких об'єктів.
function parent() const
game_object* parent ( ) const
повертає parent об'єкт. Для предмета у ящику поверне об'єкт ящика. Для інвентарних предметів поверне об'єкт власника інвентарю – актора, сталкера чи монстра. В інших випадках повернеться 0. До отриманого об'єкту можна застосовувати всі методи game_object, відповідні до класу об'єкта. Аргументів не сприймає.
Додано в ЗП:
function get_visual_name() const
string get_visual_name ( ) const
повертає візуал об'єкта як імені моделі. Аргументів не сприймає.
function set_visual_name(string)
void set_visual_name ( string visual_name )
встановлює візуал об'єкта. Як аргумент необхідно задавати повний шлях до моделі від папки meshes.
CUsableScriptObject
Оскільки всі ігрові об'єкти успадковують від класу CUsableScriptObject , такі методи можна застосовувати до будь-яких об'єктів.
function set_tip_text(string)
void set_tip_text ( string tip_text )
встановлює для об'єкта текст підказки, що передається, переданий аргументом tip_text.
function set_tip_text_default()
void set_tip_text_default ( )
встановлює для об'єкта дефолтний текст підказки, встановлений при спавне. Аргументів не сприймає.
function set_nonscript_usable(boolean)
void set_nonscript_usable ( bool nonscript_usable )
встановлює для об'єкта можливість взаємодії з актором.
CPhysicsShellHolder
Ці методи можна застосовувати для всіх об'єктів, крім аномалій, переходів, ящиків з інвентарем та прожекторів - всього того, що не має фізичної оболонки.
function get_physics_shell() const
physics_shell* get_physics_shell ( ) const
повертає фізичну оболонку об'єкта – об'єкт класу physics_shell. Аргументів не сприймає.
function set_const_force(const vector&, number, number)
void set_const_force ( const vector& dir, float value, int time_interval )
застосовує до фізичної оболонки об'єкта чинність на деякий час. Аргументи:
- dir - напрямок (об'єкт класу vector)
- value - значення сили (float)
- time_interval – тривалість дії сили (int).
function mass() const
float mass ( ) const
повертає масу об'єкта. При застосуванні до невідповідного об'єкта повертає -1. Маса, що повертається цим методом – не інвентарна, а, мабуть, маса для обчислення колізій. Для патронів зброї повертається 0. Аргументів не приймає.
CEntity
Ці методи можна застосовувати всім живих об'єктів (сталкери, монстри, актер), вертольотів і машин.
function alive() const
bool alive ( ) const
повертає, чи об'єкт живий (перевірка на health > 0.0). Для неживих об'єктів повертається false. Увага! health оновлюється з деяким періодом, тому за виклику alive() відразу після kill() видається true. Аргументів не сприймає.
function death_time() const
int death_time ( ) const
у ЗП немає. Повертає час смерті об'єкта до мсек з початку гри. Якщо об'єкт живий чи в принципі неживий, поверне 0. Аргументів не приймає.
function group() const
int group ( ) const
повертає групу, до якої належить об'єкт. Для неживих об'єктів повертає -1. Аргументів не сприймає.
function kill(game_object*)
void kill ( game_object * who )
вбити об'єкт. Аргумент – клієнтський об'єкт-вбивця. Якщо не вказати, двигун вважає, що об'єкт самогубився.
function max_health() const
float max_health ( ) const
повертає максимальний рівень здоров'я об'єкту. Для неживих об'єктів повертає -1. Аргументів не сприймає.
function squad() const
int squad ( ) const
повертає загін, якого належить об'єкт. Для неживих об'єктів повертає -1. Аргументів не сприймає.
function team() const
int team ( ) const
повертає команду, до якої належить об'єкт. Для неживих об'єктів повертає -1. Аргументів не сприймає.
CEntityAlive
Ці методи можна застосовувати лише для живих об'єктів – сталкери, монстри (крім ворон), актор. Властивості об'єктів класу:
float satiety; // ситість є, але чомусь не прописаний в lua_help float bleeding; // кровотеча. тільки ЗП float health; // здоров'я 0..1 float morale; // Мораль float power; // Сила float psy_health; // Пси-здоров'я float radiation; // Радіація
всі характеристики на запис працюють негаразд, як у читання. При записі значення має сенс зміни відповідної якості. Тобто. якщо записати 0.1 в health, це збільшить його на 0.1.
function get_bleeding() const
float get_bleeding ( ) const
У ЗП немає. Повертає поточний розмір кровотечі. Чим більше об'єкта поранень - тим більше кровотеча. Якщо об'єкт неживий, то повертає -1. Аргументів не сприймає.
function relation(game_object*)
ALife:: ERelationType relation ( game_object * who )
повертає тип відношення об'єкта, що обробляється, до об'єкта, що передається аргументом who. Об'єкт, який також повинен успадковувати від CEntityAlive. Для трупів чи неживих об'єктів повертає -1. Значення, що повертається - член переліку ALife::ERelationType. У Lua воно експортоване як констант класу game_object.
const friend = 0 const neutral = 1 const enemy = 2 const dummy = -1
Є ще дві неекспортовані константи:
eRelationTypeWorstEnemy = 0x3 eRelationTypeLast = 0x4
function who_hit_name()
string who_hit_name ( )
повертає ім'я об'єкта, останнього завдав хіт об'єкту, що обробляється. Аргументів не сприймає.
function who_hit_section_name()
string who_hit_section_name ( )
повертає ім'я секції об'єкта, останнього завдав хіт об'єкту, що обробляється. Аргументів не сприймає.
function fov() const
float fov ( ) const
повертає кут зору. Аргументів не сприймає.
function range() const
float range ( ) const
повертає максимальну ширину видимої області. Аргументів не сприймає.
15.10.2023 17:10
Частина 1: https://stalker-news.info/forum/rushij-x-ray-engine/opys-klasu-gameobject-chastyna-1/
Частина 2: https://stalker-news.info/forum/rushij-x-ray-engine/opys-klasu-gameobject-chastyna-2/
Частина 3: https://stalker-news.info/forum/rushij-x-ray-engine/opys-klasu-gameobject-chastyna-3/
Частина 4: https://stalker-news.info/forum/rushij-x-ray-engine/opys-klasu-gameobject-chastyna-4/
Частина 5: https://stalker-news.info/forum/rushij-x-ray-engine/opys-klasu-gameobject-chastyna-5/
