Scripts natifs C++

De quoi s’agit-il ?

La version d’origine de Joban Client Mod (JCM) permet aux packs de ressources d’écrire des scripts d’affichage dynamique en JavaScript. La branche Yanyang y ajoute les scripts natifs C++ : le script est compilé en bibliothèque partagée native (.dll / .so / .dylib), que le mod charge en jeu et pilote frame par frame.

Scripts C++ et scripts JS peuvent être mélangés au sein d’une même entrée de déclaration et rendus simultanément. Le mod détermine automatiquement la langue d’après les caractéristiques du fichier — .js est du JavaScript, tout le reste est analysé comme un module C++. Chaque côté capture ses instructions de dessin et les rejoue indépendamment, sans interférence.

Le parcours d’une frame

Un script PIDS en quinze lignes

#include <mtr/script.hpp>

struct ArrivalState {};

struct ArrivalDisplay : mtr::PidsScript<ArrivalState> {
    static constexpr auto ID = "example:arrivals";

    void render(mtr::PidsContext& ctx, ArrivalState&, const mtr::Pids& pids) override {
        for (int row = 0; row < pids.rows(); row++) {
            if (pids.is_row_hidden(row)) continue;
            std::string text = pids.get_custom_message(row).str();
            if (text.empty() && row < pids.arrivals().size())
                text = pids.arrivals().at(row).destination().str();
            if (!text.empty())
                mtr::Text::create().text(text.c_str())
                    .pos(2, row * 10.0 + 2).size(pids.width() - 4, 9).draw(ctx);
        }
    }
};

MTR_REGISTER_PIDS_SCRIPT(ArrivalDisplay)

Pas de JNI, pas de réflexion, pas de boxing appel par appel — pids.rows() ou arrivals().at(i).destination() sont de simples lectures mémoire sur l’instantané compact.

Quand choisir C++

Compatibilité

Sommaire de la documentation