EditorTab API

Разработчик:Tab API

Мод API для легкого добавления вкладок редактора.

Для использования подключите EditorUI::init и используйте alpha::editor tabs::addTab() после вызова оригинала для добавления вкладки. Вы должны пройти в ID, режиме редактирования, обратном вызове узла создания и обратном вызове значка создания. Есть два варианта обратного вызова, один fot whent вкладка вводится и выходит, и один для, когда вкладка перезагружается (ряд и графа изменения).

При добавлении вкладки она должна быть в определенном режиме, три ванильных - BUILD, EDIT и DELETE, но вы также можете назначить свою собственную, хотя вы несете ответственность за обработку любых кнопок для перехода в указанный режим.

Вы можете использовать любой узел в качестве возврата в обратном вызове узла создания. Этот API также предоставляет простой способ создания EditButtonBar (alpha::editor tabs::createEditButtonBar), который будет инициализирован с правильным размером и позиционированием.

Идентификаторы Tab должны быть уникальными

class $modify(MyEditorUI, EditorUI) {

    bool init(LevelEditorLayer* editorLayer) {
        if (!EditorUI::init(editorLayer)) return false;

        alpha::editor_tabs::addTab("rawr-tab"_spr, alpha::editor_tabs::BUILD, 
        [] { // Create the tab
            std::vector> nodes;
            auto label = CCLabelBMFont::create("Rawr", "bigFont.fnt");
            nodes.push_back(label);

            return alpha::editor_tabs::createEditButtonBar(nodes);
        }, 
        [] { // create the tab icon
            return CCSprite::createWithSpriteFrameName("spike_01_001.png");
        }, 
        [] (bool state, auto tab) { // do something when the tab is entered and exited
            log::info("rawr-tab state: {}", state);
        }, 
        [] (int rows, int cols, auto tab) { // do something when the tab is reloaded
            log::info("rawr tab rows: {}, cols: {}", rows, cols);
        });

        return true;
    }
};

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

// current mode (BUILD, EDIT, DELETE, or a custom string)
geode::Result getCurrentMode()

// current tab as the ID
geode::Result getCurrentTab()

// get all tabs
geode::Result> getAllTabs()

// get a tab's index by ID
geode::Result getTabIndex(geode::ZStringView tabID)

// get a tab's mode by ID
geode::Result getTabMode(geode::ZStringView tabID)

// get a tab's node by ID
geode::Result> nodeForTab(geode::ZStringView tabID)

// get a tab's toggler by ID
geode::Result> togglerForTab(geode::ZStringView tabID)

Вы также можете удалить вкладку, если это необходимо, с помощью идентификатора вкладки.

void removeTab(geode::ZStringView tabID)

Если вам нужно отключить изменение спрайтов режима (кнопки сборки, редактирования, удаления вкладок), например, если ваш мод имеет разные спрайты и это отменяет его, используйте следующее:

void changeModeSprites(bool enabled)

Если вам нужно прослушать изменение вкладки или изменение режима, используйте следующее. Обратите внимание, что они будут вызываться всякий раз, когда некоторые обновления редактора будут уволены. Не думайте, что они будут стрелять только один раз. Не добавляйте код, который будет добавляться к состоянию редактора без предварительной очистки, если вы используете его для чего-либо сложного. Идами, предоставляемыми в обратном вызове, являются идентификаторы режима и вкладки соответственно.

void addModeSwitchCallback(geode::Function&& callback)

void addTabSwitchCallback(geode::Function&& callback)