Rigs of Rods

This mainly involves giving scripts access to GUI elements.

Just what I had currently in mind (without thinking about the actual c++ implementation yet).

// an interface to interact with the menu
interface menuItem
{
    bool enabled;
    void destroy();

    menuItem@ get_opIndex(uint index);

    menuItem@ addMenuItem(const string &in caption, ?&in callbackObject, const string &in callbackFunctionName, any@ internalData);
    menuItem@ addMenuItem(uint index, const string &in caption, ?&in callbackObject, const string &in callbackFunctionName, any@ internalData);
}

// An interface for pop ups
interface popUp
{
    bool visible;
    void destroy();

    void addButton(const string &in caption, const vector2 &in relativePosition, ?&in callbackObject, const string &in callbackFunctionName, any@ internalData);
    void addText(const string &in caption, const vector2 &in relativePosition);

    //...
}

// An interface for the general gui element
interface gui
{
    menuItem@ get_terrainMenu();
    popUp@ addPopUp(const string &in title, const vector2 &in size, int position = (VCENTER | HCENTER));
}

// Some positions where a popup can be positioned
enum popUpPositions
{
    TOP     = 0x0001,
    BOTTOM  = 0x0002,
    VCENTER = 0x0004,
    LEFT    = 0x0010,
    RIGHT   = 0x0020,
    HCENTER = 0x0040,
}

Using the interfaces above, then this would be some example script that will create a menu, similar to this:

terrain
 |- menuItem 1
 |- subMenu
     |- subMenuItem 1
     |- subMenuItem 2

So the AngelScript script for that, would be:

// Create a class that will handle our 'on click' events
class menuHandler
{
    popUp@ alert;

    void on_click1(const string &in caption, any@ internalData)
    {
        game.message("You clicked on button 1", "tick.png", 30000, true);
    }

    void on_click2(const string &in caption, any@ internalData)
    {
        game.message("You clicked on button 1 inside sub-menu 1", "tick.png", 30000, true);
    }

    void on_click2(const string &in caption, any@ internalData)
    {
        game.message("You clicked on button 2 inside sub-menu 1", "tick.png", 30000, true);

        // Let's show a popup here
        alert = game.gui.addPopUp("this is a title for the pop up", vector2(200.0f, 200.0f), (VCENTER | HCENTER));
        alert.addText("This is some text", vector2(20.0f, 20.0f));
        alert.addButton("OK", vector2(20.0f, 150.0f), @this, "on_click_ok", null);
    }

    void on_click_ok(const string &in caption, any@ internalData)
    {
        // hide the popup again
        alert.destroy();
    }
}
menuHandler handler;

void main()
{
    // Get the terrain menu
    menuItem@ menu = game.gui.terrainMenu;

    // Add an item in the terrain menu
    menu.addMenuItem("menuItem 1", @handler, "on_click1", null);

    // Add a submenu to the terrain menu
    menuItem@ subMenu = menu.addMenuItem("submenu", null, "", null);
    subMenu.addMenuItem("subMenuItem 1", @handler, "on_click2", null);
    subMenu.addMenuItem("subMenuItem 2", @handler, "on_click3", null);
}

Again, this is just a suggestion, I'll probably have to look into mygui to see what is possible and what is not.
All other suggestions, improvements or ideas are welcome of course.