dfhack/library/include/modules/Gui.h

/*
https://github.com/peterix/dfhack
Copyright (c) 2009-2011 Petr Mrázek (peterix@gmail.com)

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any
damages arising from the use of this software.

Permission is granted to anyone to use this software for any
purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must
not claim that you wrote the original software. If you use this
software in a product, an acknowledgment in the product documentation
would be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and
must not be misrepresented as being the original software.

3. This notice may not be removed or altered from any source
distribution.
*/

#pragma once
#ifndef CL_MOD_GUI
#define CL_MOD_GUI

#include "Export.h"
#include "Module.h"
#include "Virtual.h"
#include "BitArray.h"
#include <string>

/**
 * \defgroup grp_gui query DF's GUI state
 * @ingroup grp_modules
 */

namespace DFHack
{
    class DFContextShared;
    /**
     * A GUI screen
     * \ingroup grp_gui
     */
    struct t_viewscreen : public t_virtual
    {
        t_viewscreen * child;
        t_viewscreen * parent;
        char unk1; // varies
        char unk2; // state?
    };
    /**
     * Interface - wrapper for the GUI
     * \ingroup grp_gui
     */
    struct t_interface
    {
        int fps;
        t_viewscreen view;
        unsigned int flags; // ?
        // more crud this way ...
    };
    enum graphics_flag
    {
        GRAPHICS_ENABLED = 0,
        GRAPHICS_BLACKSPACE = 1,
        GRAPHICS_PARTIAL_PRINT = 2,
        GRAPHICS_TEXT = 11,
        GRAPHICS_FIXED_SIZE = 13
    };
    enum media_flag
    {
        MEDIA_NO_SOUND,
        MEDIA_NO_INTRO,
        MEDIA_COMPRESS_WORLDS,
    };
    /**
     * The init structure - basically DF settings
     * \ingroup grp_gui
     */
    struct t_init
    {
        struct
        {
            BitArray <graphics_flag> flags;
            enum
            {
                WINDOWED_YES,
                WINDOWED_NO,
                WINDOWED_PROMPT
            } windowed;
            // screen size in tiles
            int grid_x;
            int grid_y;
            // in pixels ?
            int fullscreen_x;
            int fullscreen_y;
            int window_x;
            int window_y;
            char partial_print;
        } graphics;
        struct
        {
            BitArray <media_flag> flags;
            int32_t volume;
        } media;
        // much more stuff follows
    };
    #define NUM_HOTKEYS 16
    /**
     * The hotkey structure
     * \ingroup grp_gui
     */
    struct t_hotkey
    {
        std::string name;
        int16_t mode;
        int32_t x;
        int32_t y;
        int32_t z;
    };
    typedef t_hotkey hotkey_array[NUM_HOTKEYS];

    /**
     * One tile of the screen. Possibly outdated.
     * \ingroup grp_gui
     */
    struct t_screen
    {
        uint8_t symbol;
        uint8_t foreground;
        uint8_t background;
        uint8_t bright;
        uint8_t gtile;
        uint8_t grayscale;
    };

    /**
     * The Gui module
     * \ingroup grp_modules
     * \ingroup grp_gui
     */
    class DFHACK_EXPORT Gui: public Module
    {
        public:

        Gui();
        ~Gui();
        bool Start();
        bool Finish();
        /*
         * Cursor and window coords
         */
        bool getViewCoords (int32_t &x, int32_t &y, int32_t &z);
        bool setViewCoords (const int32_t x, const int32_t y, const int32_t z);
        
        bool getCursorCoords (int32_t &x, int32_t &y, int32_t &z);
        bool setCursorCoords (const int32_t x, const int32_t y, const int32_t z);

        bool getDesignationCoords (int32_t &x, int32_t &y, int32_t &z);
        bool setDesignationCoords (const int32_t x, const int32_t y, const int32_t z);

        bool getMousePos (int32_t & x, int32_t & y);
        /*
         * Gui screens
         */
        /// handle to the interface object
        t_interface * df_interface;
        /// Get the current top-level view-screen
        t_viewscreen * GetCurrentScreen();
        /// The DF menu state (designation menu ect)
        uint32_t * df_menu_state;

        /*
         * Hotkeys (DF's zoom locations)
         */
        hotkey_array * hotkeys;

        /*
         * Game settings
         */
        t_init * init;
        
        /*
         * Window size in tiles
         */
        bool getWindowSize(int32_t & width, int32_t & height);
        
        /*
         * Screen tiles
         */
        bool getScreenTiles(int32_t width, int32_t height, t_screen screen[]);

        private:
        struct Private;
        Private *d;
    };
}
#endif