GoodArea

GoodArea

Описание
Данная библиотека позволяет удобно работать с динамическими зонами streamer-а в стиле zcmd.

Функции
Добавление/изменение функции, возвращает 1 - при успешном выполнении, 0 - фиаско.

PHP код:

---

SetAreaFunction(STREAMER_TAG_AREA area, const function[]) 


---

Удаление/открепление функции от динамической зоны.
Возвращает 1 - если был откреплен, 0 - если динамическая зона не была связана с функцией.

PHP код:

---

RemoveAreaFunction(GOOD_AREA_TAG area) 


---

Создание групп дин. зон, все добавленные дин. зоны в группу будут вызывать эту функцию.
Возвращает id группы, а при неудачном выполнение функции возвращает -1.

PHP код:

---

CreateGroupGoodAreas(const function[]) 


---

Добавление дин. зоны к группе.
Аргументы: id группы, дин. зона, а третий это что-то вроде id, чтобы в функции с кучей дин. зон было удобнее работать.

PHP код:

---

AddGroupGoodAreas(ga_groupid, STREAMER_TAG_AREA area, areaindex) 


---

Получает id и index(опционально) GA(Good Area) группы игрока, если игрок находится в динамической зоне связанной с GA группой.
Возвращает: 1 - если игрок находится в динамической зоной связанной с GA, 0 - если нет.

PHP код:

---

GetPlayerGroupGoodAreaID(playerid, &areaid, &areaindex = 0) 


---

Удаляет группу GA.
Возвращает: 1 - успех, 0 - фиаско.

PHP код:

---

DeleteGroupGoodAreas(ga_groupid) 


---

Константы
Данная константа позволяет вам изменять максимальное возможное количество доступных наименований функций.

PHP код:

---

#define MAX_GOOD_AREAS 5000 


---

А эта константа позволяет менять tag в зависимости от версии streamer-а, по стандарту она выглядит так:

PHP код:

---

#define GOOD_AREA_TAG STREAMER_TAG_AREA: 


---

Типы вызовов функции:

• GA_RESPONSE_ENTER - Когда игрок вошел в дин. зону
• GA_RESPONSE_LEAVE - Когда игрок вышел из дин. зоны
• GA_RESPONSE_PRESS_KEY - Когда игрок нажал кнопку в дин. зоне

Пример кода
Обычный:

PHP код:

---

public OnGameModeInit()
{
    new STREAMER_TYPE_AREA area = CreateDynamicSphere(310.4742, 2055.8142, 17.6, 2.0);
    SetAreaFunction(area, GoodArea:test);
}

// - Первый вариант

AreaResponse:test(playerid, response, key)
{
    switch(response)
    {
        case GA_RESPONSE_ENTER:
        {
            SendClientMessage(playerid, -1, "Вы вошли зону");
        }
        case GA_RESPONSE_LEAVE:
        {
            SendClientMessage(playerid, -1, "Вы вышли из зоны");
        }
        case GA_RESPONSE_PRESS_KEY:
        {
            if(key & KEY_WALK) SendClientMessage(playerid, -1, "Вы нажали на ALT в зоне");
            else if(key == KEY_JUMP) SendClientMessage(playerid, -1, "Вы нажали на прыжок в зоне");
            else SendClientMessage(playerid, -1, "Вы нажали на кнопку в зоне");
        }
    }
    return 1;
}

// - Второй вариант

goodarea test(playerid, response, key)
{
    switch(response)
    {
        case GA_RESPONSE_ENTER:
        {
            SendClientMessage(playerid, -1, "Вы вошли зону");
        }
        case GA_RESPONSE_LEAVE:
        {
            SendClientMessage(playerid, -1, "Вы вышли из зоны");
        }
        case GA_RESPONSE_PRESS_KEY:
        {
            if(key & KEY_WALK) SendClientMessage(playerid, -1, "Вы нажали на ALT в зоне");
            else if(key == KEY_JUMP) SendClientMessage(playerid, -1, "Вы нажали на прыжок в зоне");
            else SendClientMessage(playerid, -1, "Вы нажали на кнопку в зоне");
        }
    }
    return 1;
} 


---

Группы:

PHP код:

---

public OnGameModeInit()
{
    new group1 = CreateGroupGoodAreas(GoodArea:test);
    new STREAMER_TAG_AREA:area = CreateDynamicSphere(310.4742, 2055.8142, 17.6, 2.0);
    CreateDynamicCP(310.4742, 2055.8142, 17.6, 2.0);
    AddGroupGoodAreas(group1, area, 1);
    area = CreateDynamicSphere(310.4742, 2050.0, 17.6, 2.0);
    CreateDynamicCP(310.4742, 2050.0, 17.6, 2.0);
    AddGroupGoodAreas(group1, area, 2);
    return 1;
}

// - Первый вариант

GAResponse:test(playerid, response, key, index)
{
    new string[144];
    switch(response)
    {
        case GA_RESPONSE_ENTER:
        {
            format(string, sizeof string, "Вы вошли зону с индексом %d", index);
            SendClientMessage(playerid, -1, string);
        }
        case GA_RESPONSE_LEAVE:
        {
            format(string, sizeof string, "Вы вышли из зоны с индексом %d", index);
            SendClientMessage(playerid, -1, string);
        }
        case GA_RESPONSE_PRESS_KEY:
        {
            if(key & KEY_WALK)
               {
                   format(string, sizeof string, "Вы нажали на ALT в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
            else if(key == KEY_JUMP)
            {
                   format(string, sizeof string, "Вы нажали на прыжок в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
            else
            {
                format(string, sizeof string, "Вы нажали на кнопку в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
        }
    }
    return 1;
}

// - Второй вариант

goodgarea test(playerid, response, key, index)
{
    new string[144];
    switch(response)
    {
        case GA_RESPONSE_ENTER:
        {
            format(string, sizeof string, "Вы вошли зону с индексом %d", index);
            SendClientMessage(playerid, -1, string);
        }
        case GA_RESPONSE_LEAVE:
        {
            format(string, sizeof string, "Вы вышли из зоны с индексом %d", index);
            SendClientMessage(playerid, -1, string);
        }
        case GA_RESPONSE_PRESS_KEY:
        {
            if(key & KEY_WALK)
               {
                   format(string, sizeof string, "Вы нажали на ALT в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
            else if(key == KEY_JUMP)
            {
                   format(string, sizeof string, "Вы нажали на прыжок в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
            else
            {
                format(string, sizeof string, "Вы нажали на кнопку в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
        }
    }
    return 1;
} 


---

Примечание
Подключать только после streamer-а.
Возможно не будет работать на старых версиях плагина.
Если вы используете E_STREAMER_EXTRA_ID, то лучше откажитесь от инклуда.
Это alpha версия, не бейте меня, пожалуйста.

Скачать
Тут можете скачать

Автор: knox

Советую обновиться до новой версии стримера, ибо там сейчас изменили принцип написания тэгов и твой текущий код будет выдавать ошибки :)
А так - хорошая задумка

Цитата:

---

Сообщение от DeimoS

Советую обновиться до новой версии стримера, ибо там сейчас изменили принцип написания тэгов и твой текущий код будет выдавать ошибки :)
А так - хорошая задумка

---

Спасибо, исправил это добавлением новой константы:

PHP код:

---

 #define GOOD_AREA_TAG STREAMER_TAG_AREA: 


---

Если у Вас tag такой, то можете её не использовать, а если не такой, то заменяйте на свой.
Например:

PHP код:

---

#define GOOD_AREA_TAG STREAMER_TAG_AREA
#include <GoodArea> 


---

Обновление 1.1

Описание
Были добавлены группы, то есть функцию может вызывать не одна дин. зона, а не сколько.

Функции
Чтобы создать группу необходимо использовать следующую функцию:

PHP код:

---

CreateGroupGoodAreas(function[]) 


---

Она возвращает id группы, который понадобится в следующей функции. А также возвращает -1 если не смогло создать группу.

PHP код:

---

AddGroupGoodAreas(ga_groupid, GOOD_AREA_TAG area, areaindex) 


---

Данная функция добавляет дин. зону в группу, первый аргумент это id группы, второй дин. зона, а третий это что-то вроде id, чтобы в функции с кучей дин. зон было удобнее работать.

Пример

PHP код:

---

public OnGameModeInit()
{
    new group1 = CreateGroupGoodAreas(GoodArea:test);
    new STREAMER_TAG_AREA:area = CreateDynamicSphere(310.4742, 2055.8142, 17.6, 2.0);
    CreateDynamicCP(310.4742, 2055.8142, 17.6, 2.0);
    AddGroupGoodAreas(group1, area, 1);
    area = CreateDynamicSphere(310.4742, 2050.0, 17.6, 2.0);
    CreateDynamicCP(310.4742, 2050.0, 17.6, 2.0);
    AddGroupGoodAreas(group1, area, 2);
    return 1;
}

GAResponse:test(playerid, response, key, index)
{
    new string[144];
    switch(response)
    {
        case GA_RESPONSE_ENTER:
        {
            format(string, sizeof string, "Вы вошли зону с индексом %d", index);
            SendClientMessage(playerid, -1, string);
        }
        case GA_RESPONSE_LEAVE:
        {
            format(string, sizeof string, "Вы вышли из зоны с индексом %d", index);
            SendClientMessage(playerid, -1, string);
        }
        case GA_RESPONSE_PRESS_KEY:
        {
            if(key & KEY_WALK)
               {
                   format(string, sizeof string, "Вы нажали на ALT в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
            else if(key == KEY_JUMP)
            {
                   format(string, sizeof string, "Вы нажали на прыжок в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
            else
            {
                format(string, sizeof string, "Вы нажали на кнопку в зоне с индексом %d", index);
                SendClientMessage(playerid, -1, string);
            }
        }
    }
    return 1;
} 


---

Цитата:

---

Сообщение от Seviel

PHP код:

---

CreateGroupGoodAreas(function[]) 


---

---

Последняя версия компилятора будет кричать, что нету "const".

Цитата:

---

Сообщение от NichWell

Последняя версия компилятора будет кричать, что нету "const".

---

Компилятор плохой мальчик, а инклуд хороший мальчик.

Обновил.

Обновление 1.2

Были добавлены функции:

PHP код:

---

RemoveAreaFunction(GOOD_AREA_TAG area);
GetPlayerGroupGoodAreaID(playerid, &areaid, &areaindex = 0);
DeleteGroupGoodAreas(ga_groupid); 


---

Подробнее о функциях описано выше.

Я бы советовал соблюсти общий стиль для имён функций. Например, название "GoodArea" перенести в префикс, а уже в самом названии отражать функционал. Будет гораздо более понятнее и удобнее.

Мне кажется, хватит и одного AreaResponse, а GAResponse и выглядит не очень, да и усложнение лишнее. И, раз уж всё-равно есть ограничение на количество зон (MAX_GOOD_AREAS), можно отказаться от использования E_STREAMER_EXTRA_ID и создать массив с необходимыми данными.

Цитата:

---

Сообщение от ziggi

Мне кажется, хватит и одного AreaResponse, а GAResponse и выглядит не очень, да и усложнение лишнее. И, раз уж всё-равно есть ограничение на количество зон (MAX_GOOD_AREAS), можно отказаться от использования E_STREAMER_EXTRA_ID и создать массив с необходимыми данными.

---

Группы это самое крутое. С помощью них можно сделать систему домов и не только.

Использую E_STREAMER_EXTRA_ID, дабы не было перебора всех динамических зон и/или переменной.

Хотя чтобы избавиться от использования E_STREAMER_EXTRA_ID, нужно немного изменить код в функциях GetGoodAreaIndex и GetGroupGoodAreaIndex

Обновление 1.2.1

Была добавлена проверка на подключен ли streamer
Были добавлены ещё один способ написания функций:

Индивидуальные:

PHP код:

---

goodarea test(playerid, response, key) 


---

Группы:

PHP код:

---

goodgarea test(playerid, response, key, index) 


---

За это благодарю @desulaid

Цитата:

---

Сообщение от Seviel

Группы это самое крутое. С помощью них можно сделать систему домов и не только.

Использую E_STREAMER_EXTRA_ID, дабы не было перебора всех динамических зон и/или переменной.

Хотя чтобы избавиться от использования E_STREAMER_EXTRA_ID, нужно немного изменить код в функциях GetGoodAreaIndex и GetGroupGoodAreaIndex

---

Я говорю про то, что можно использовать одну паблик функцию как для зон с группами, так и для зон без них.

AreaResponse:test(playerid, response, key, index)

И в index передавать -1, если группы нет. И если я не буду использовать группы, то я по-прежнему могу не объявлять index в качестве аргумента. То есть этот синтаксис сохранится:

AreaResponse:test(playerid, response, key)