159 lines
4.8 KiB
C++
159 lines
4.8 KiB
C++
/*
|
|
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>
|
|
|
|
#include "DataDefs.h"
|
|
#include "df/init.h"
|
|
#include "df/ui.h"
|
|
|
|
namespace df {
|
|
struct viewscreen;
|
|
struct job;
|
|
struct unit;
|
|
struct item;
|
|
};
|
|
|
|
/**
|
|
* \defgroup grp_gui query DF's GUI state
|
|
* @ingroup grp_modules
|
|
*/
|
|
|
|
namespace DFHack
|
|
{
|
|
class Core;
|
|
|
|
// Full-screen item details view
|
|
DFHACK_EXPORT bool item_details_hotkey(Core *, df::viewscreen *top);
|
|
// 'u'nits or 'j'obs full-screen view
|
|
DFHACK_EXPORT bool unitjobs_hotkey(Core *, df::viewscreen *top);
|
|
|
|
// A job is selected in a workshop
|
|
DFHACK_EXPORT bool workshop_job_hotkey(Core *c, df::viewscreen *top);
|
|
// Building material selection mode
|
|
DFHACK_EXPORT bool build_selector_hotkey(Core *c, df::viewscreen *top);
|
|
// A unit is selected in the 'v' mode
|
|
DFHACK_EXPORT bool view_unit_hotkey(Core *c, df::viewscreen *top);
|
|
// Above + the inventory page is selected.
|
|
DFHACK_EXPORT bool unit_inventory_hotkey(Core *c, df::viewscreen *top);
|
|
|
|
// In workshop_job_hotkey, returns the job
|
|
DFHACK_EXPORT df::job *getSelectedWorkshopJob(Core *c, bool quiet = false);
|
|
|
|
// A job is selected in a workshop, or unitjobs
|
|
DFHACK_EXPORT bool any_job_hotkey(Core *c, df::viewscreen *top);
|
|
DFHACK_EXPORT df::job *getSelectedJob(Core *c, bool quiet = false);
|
|
|
|
// A unit is selected via 'v', 'k', unitjobs, or
|
|
// a full-screen item view of a cage or suchlike
|
|
DFHACK_EXPORT bool any_unit_hotkey(Core *c, df::viewscreen *top);
|
|
DFHACK_EXPORT df::unit *getSelectedUnit(Core *c, bool quiet = false);
|
|
|
|
// An item is selected via 'v'->inventory, 'k', 't', or
|
|
// a full-screen item view of a container. Note that in the
|
|
// last case, the highlighted contained item is returned, not
|
|
// the container itself.
|
|
DFHACK_EXPORT bool any_item_hotkey(Core *c, df::viewscreen *top);
|
|
DFHACK_EXPORT df::item *getSelectedItem(Core *c, bool quiet = false);
|
|
|
|
// Show a plain announcement, or a titan-style popup message
|
|
DFHACK_EXPORT void showAnnouncement(std::string message, int color = 7, bool bright = true);
|
|
DFHACK_EXPORT void showPopupAnnouncement(std::string message, int color = 7, bool bright = true);
|
|
|
|
class DFContextShared;
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
/// Get the current top-level view-screen
|
|
df::viewscreen * GetCurrentScreen();
|
|
/// The DF menu state (designation menu ect)
|
|
uint32_t * df_menu_state;
|
|
|
|
/*
|
|
* 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
|
|
|