65 lines
1.5 KiB
C++
65 lines
1.5 KiB
C++
#pragma once
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "ColorText.h"
|
|
#include "Export.h"
|
|
|
|
struct SDL_Surface;
|
|
|
|
typedef SDL_Surface* TexposHandle;
|
|
|
|
namespace DFHack {
|
|
|
|
/**
|
|
* The Textures module - loads and provides access to DFHack textures
|
|
* \ingroup grp_modules
|
|
* \ingroup grp_textures
|
|
*/
|
|
namespace Textures {
|
|
|
|
const uint32_t TILE_WIDTH_PX = 8;
|
|
const uint32_t TILE_HEIGHT_PX = 12;
|
|
|
|
/**
|
|
* Load texture and get handle.
|
|
* Keep it to obtain valid texpos.
|
|
*/
|
|
DFHACK_EXPORT TexposHandle loadTexture(SDL_Surface* surface);
|
|
|
|
/**
|
|
* Load tileset from image file.
|
|
* Return vector of handles to obtain valid texposes.
|
|
*/
|
|
DFHACK_EXPORT std::vector<TexposHandle> loadTileset(const std::string& file,
|
|
int tile_px_w = TILE_WIDTH_PX,
|
|
int tile_px_h = TILE_HEIGHT_PX);
|
|
|
|
/**
|
|
* Get texpos by handle.
|
|
* Always use this function, if you need to get valid texpos for your texure.
|
|
* Texpos can change on game textures reset, but handle will be the same.
|
|
*/
|
|
DFHACK_EXPORT long getTexposByHandle(TexposHandle handle);
|
|
|
|
/**
|
|
* Get texpos for static asset with index in tileset.
|
|
*/
|
|
DFHACK_EXPORT long getAsset(const std::string asset, size_t index = 0);
|
|
|
|
/**
|
|
* Call this on DFHack init just once to setup interposed handlers and
|
|
* init static assets.
|
|
*/
|
|
void init(DFHack::color_ostream& out);
|
|
|
|
/**
|
|
* Call this when DFHack is being unloaded.
|
|
*
|
|
*/
|
|
void cleanup();
|
|
|
|
} // namespace Textures
|
|
} // namespace DFHack
|