123 lines
4.6 KiB
C++
123 lines
4.6 KiB
C++
/* BSD 3-Clause License
|
|
*
|
|
* Copyright © 2008-2022, Jice and the libtcod contributors.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3. Neither the name of the copyright holder nor the names of its
|
|
* contributors may be used to endorse or promote products derived from
|
|
* this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
#ifndef _TCOD_IMAGE_H
|
|
#define _TCOD_IMAGE_H
|
|
|
|
#include "color.h"
|
|
#include "console_types.h"
|
|
#include "error.h"
|
|
#include "portability.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct TCOD_mipmap_ {
|
|
int width, height;
|
|
float fwidth, fheight;
|
|
TCOD_ColorRGB* __restrict buf;
|
|
bool dirty;
|
|
};
|
|
|
|
typedef struct TCOD_Image {
|
|
int nb_mipmaps;
|
|
struct TCOD_mipmap_* __restrict mipmaps;
|
|
TCOD_ColorRGB key_color;
|
|
bool has_key_color;
|
|
} TCOD_Image;
|
|
|
|
typedef TCOD_Image* TCOD_image_t;
|
|
|
|
TCODLIB_API TCOD_Image* TCOD_image_new(int width, int height);
|
|
/**
|
|
* Return a new image rendered from a console.
|
|
*
|
|
* This effectively returns a screenshot of the console.
|
|
*/
|
|
TCODLIB_API TCOD_Image* TCOD_image_from_console(const TCOD_Console* console);
|
|
/**
|
|
* Same as TCOD_image_from_console, but with an existing image.
|
|
*/
|
|
TCODLIB_API void TCOD_image_refresh_console(TCOD_Image* image, const TCOD_Console* console);
|
|
TCODLIB_API void TCOD_image_clear(TCOD_Image* image, TCOD_color_t color);
|
|
TCODLIB_API void TCOD_image_invert(TCOD_Image* image);
|
|
TCODLIB_API void TCOD_image_hflip(TCOD_Image* image);
|
|
TCODLIB_API void TCOD_image_rotate90(TCOD_Image* image, int numRotations);
|
|
TCODLIB_API void TCOD_image_vflip(TCOD_Image* image);
|
|
TCODLIB_API void TCOD_image_scale(TCOD_Image* image, int new_w, int new_h);
|
|
#ifndef NO_SDL
|
|
TCODLIB_API TCOD_Image* TCOD_image_load(const char* filename);
|
|
/**
|
|
Save an image to a PNG or BMP file.
|
|
|
|
Returns a negative error code on failure. Check TCOD_get_error for details.
|
|
\rst
|
|
.. versionchanged:: 1.16
|
|
Now returns TCOD_Error.
|
|
\endrst
|
|
*/
|
|
TCODLIB_API TCOD_Error TCOD_image_save(const TCOD_Image* image, const char* filename);
|
|
#endif // NO_SDL
|
|
TCODLIB_API void TCOD_image_get_size(const TCOD_Image* image, int* w, int* h);
|
|
TCODLIB_API TCOD_color_t TCOD_image_get_pixel(const TCOD_Image* image, int x, int y);
|
|
TCODLIB_API int TCOD_image_get_alpha(const TCOD_Image* image, int x, int y);
|
|
/**
|
|
* Return a mipmapped pixel of image.
|
|
*
|
|
* Mipmaps are updated when you call this, so it can't be called from multiple
|
|
* threads.
|
|
*/
|
|
TCODLIB_API TCOD_color_t TCOD_image_get_mipmap_pixel(TCOD_Image* image, float x0, float y0, float x1, float y1);
|
|
TCODLIB_API void TCOD_image_put_pixel(TCOD_Image* image, int x, int y, TCOD_color_t col);
|
|
TCODLIB_API void TCOD_image_blit(
|
|
TCOD_Image* image,
|
|
TCOD_console_t console,
|
|
float x,
|
|
float y,
|
|
TCOD_bkgnd_flag_t bkgnd_flag,
|
|
float scale_x,
|
|
float scale_y,
|
|
float angle);
|
|
TCODLIB_API void TCOD_image_blit_rect(
|
|
TCOD_Image* image, TCOD_console_t console, int x, int y, int w, int h, TCOD_bkgnd_flag_t bkgnd_flag);
|
|
TCODLIB_API void TCOD_image_blit_2x(
|
|
const TCOD_Image* __restrict image, TCOD_Console* __restrict dest, int dx, int dy, int sx, int sy, int w, int h);
|
|
TCODLIB_API void TCOD_image_delete(TCOD_Image* image);
|
|
TCODLIB_API void TCOD_image_set_key_color(TCOD_Image* image, TCOD_color_t key_color);
|
|
TCODLIB_API bool TCOD_image_is_pixel_transparent(const TCOD_Image* image, int x, int y);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
namespace tcod {} // namespace tcod
|
|
#endif // __cplusplus
|
|
#endif /* _TCOD_IMAGE_H */
|