/* Copyright (C) 2009 - 2015 by Ignacio R. Morelle Part of the Battle for Wesnoth Project http://www.wesnoth.org/ This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. See the COPYING file for more details. */ /** @file */ #ifndef IMAGE_MODIFICATIONS_HPP_INCLUDED #define IMAGE_MODIFICATIONS_HPP_INCLUDED #include "sdl_utils.hpp" #include namespace image { class modification; /// A modified priority queue used to order image modifications. /// The priorities for this queue are to order modifications by priority(), /// then by the order they are added to the queue. class modification_queue { // Invariant for this class: // At the beginning and end of each member function call, there // are no empty vectors in priorities_. public: modification_queue() : priorities_() { } ~modification_queue() {} bool empty() const { return priorities_.empty(); } void push(modification * mod); void pop(); size_t size() const; modification * top() const; private: // data /// Map from a mod's priority() to the mods having that priority. typedef std::map, std::greater > map_type; /// Map from a mod's priority() to the mods having that priority. map_type priorities_; }; /// Base abstract class for an image-path modification class modification { public: /** Exception thrown by the operator() when an error occurs. */ struct texception : public tlua_jailbreak_exception { /** * Constructor. * * @pre message_stream.str()[message_stream.str().size() - 1] == '\n' * * @param message_stream Stream with the error message regarding * the failed operation. */ texception(const std::stringstream& message_stream); /** * Constructor. * * @pre message[message.size() - 1] == '\n' * * @param message String with the error message regarding * the failed operation. */ texception(const std::string& message); ~texception() throw() {} /** The error message regarding the failed operation. */ const std::string message; private: IMPLEMENT_LUA_JAILBREAK_EXCEPTION(texception) }; /// Decodes modifications from a modification string static modification_queue decode(const std::string&); virtual ~modification() {} ///Applies the image-path modification on the specified surface virtual surface operator()(const surface& src) const = 0; /// Specifies the priority of the modification virtual int priority() const { return 0; } }; /** * Recolor (RC/TC/PAL) modification. * It is used not only for color-range-based recoloring ("~RC(magenta>teal)") * but also for team-color-based color range selection and recoloring * ("~TC(3,magenta)") and palette switches ("~PAL(000000,005000 > FFFFFF,FF00FF)"). */ class rc_modification : public modification { public: /** * Default constructor. */ rc_modification() : rc_map_() {} /** * RC-map based constructor. * @param recolor_map The palette switch map. */ rc_modification(const std::map& recolor_map) : rc_map_(recolor_map) {} virtual surface operator()(const surface& src) const; // The rc modification has a higher priority virtual int priority() const { return 1; } bool no_op() const { return rc_map_.empty(); } const std::map& map() const { return rc_map_;} std::map& map() { return rc_map_;} private: std::map rc_map_; }; /** * Mirror (FL) modification. */ class fl_modification : public modification { public: /** * Constructor. * @param horiz Horizontal mirror flag. * @param vert Vertical mirror flag. */ fl_modification(bool horiz = false, bool vert = false) : horiz_(horiz) , vert_(vert) {} virtual surface operator()(const surface& src) const; void set_horiz(bool val) { horiz_ = val; } void set_vert(bool val) { vert_ = val; } bool get_horiz() const { return horiz_; } bool get_vert() const { return vert_; } /** Toggle horizontal mirror flag. * @return The new flag state after toggling. */ bool toggle_horiz() { return((horiz_ = !horiz_)); } /** Toggle vertical mirror flag. * @return The new flag state after toggling. */ bool toggle_vert() { return((vert_ = !vert_)); } bool no_op() const { return ((!horiz_) && (!vert_)); } private: bool horiz_; bool vert_; }; /** * Rotate (ROTATE) modification. */ class rotate_modification : public modification { public: /** * Constructor. * @pre @zoom >= @offset Otherwise the result will have empty pixels. * @pre @offset > 0 Otherwise the procedure will not return. * * @param degrees Amount of rotation (in degrees). * Positive values are clockwise; negative are counter-clockwise. * @param zoom The zoom level to calculate the rotation from. * Greater values result in better results and increased runtime. * This parameter will be ignored if @degrees is a multiple of 90. * @param offset Determines the step size of the scanning of the zoomed source. * Different offsets can produce better results, try them out. * Greater values result in decreased runtime. * This parameter will be ignored if @degrees is a multiple of 90. * If @offset is greater than @zoom the result will have empty pixels. */ rotate_modification(int degrees = 90, int zoom = 16, int offset = 8) : degrees_(degrees), zoom_(zoom), offset_(offset) {} virtual surface operator()(const surface& src) const; bool no_op() const { return degrees_ % 360 == 0; } private: int degrees_; int zoom_; int offset_; }; /** * Grayscale (GS) modification. */ class gs_modification : public modification { public: virtual surface operator()(const surface& src) const; }; /** * Crop (CROP) modification. */ class crop_modification : public modification { public: crop_modification(const SDL_Rect& slice) : slice_(slice) {} virtual surface operator()(const surface& src) const; const SDL_Rect& get_slice() const; private: SDL_Rect slice_; }; /** * Scale (BLIT) modification. */ class blit_modification : public modification { public: blit_modification(const surface& surf, int x, int y) : surf_(surf), x_(x), y_(y) {} virtual surface operator()(const surface& src) const; const surface& get_surface() const; int get_x() const; int get_y() const; private: surface surf_; int x_; int y_; }; /** * Mask (MASK) modification. */ class mask_modification : public modification { public: mask_modification(const surface& mask, int x, int y) : mask_(mask), x_(x), y_(y) {} virtual surface operator()(const surface& src) const; const surface& get_mask() const; int get_x() const; int get_y() const; private: surface mask_; int x_; int y_; }; /** * LIGHT (L) modification. */ class light_modification : public modification { public: light_modification(const surface& surf) : surf_(surf) {} virtual surface operator()(const surface& src) const; const surface& get_surface() const; private: surface surf_; }; /** * Scale (SCALE) modification. */ class scale_modification : public modification { public: scale_modification(int width, int height) : w_(width), h_(height) {} virtual surface operator()(const surface& src) const; int get_w() const; int get_h() const; private: int w_, h_; }; /** * Opacity (O) modification */ class o_modification : public modification { public: o_modification(float opacity) : opacity_(opacity) {} virtual surface operator()(const surface& src) const; float get_opacity() const; private: float opacity_; }; /** * Color-shift (CS, R, G, B) modification. */ class cs_modification : public modification { public: cs_modification(int r, int g, int b) : r_(r), g_(g), b_(b) {} virtual surface operator()(const surface& src) const; int get_r() const; int get_g() const; int get_b() const; private: int r_, g_, b_; }; /** * Color blending (BLEND) modification */ class blend_modification : public modification { public: blend_modification(int r, int g, int b, float a) : r_(r), g_(g), b_(b), a_(a) {} virtual surface operator()(const surface& src) const; int get_r() const; int get_g() const; int get_b() const; float get_a() const; private: int r_, g_, b_; float a_; }; /** * Gaussian-like blur (BL) modification. */ class bl_modification : public modification { public: bl_modification(int depth) : depth_(depth) {} virtual surface operator()(const surface& src) const; int get_depth() const; private: int depth_; }; /** * Overlay with ToD brightening (BRIGHTEN). */ struct brighten_modification : modification { virtual surface operator()(const surface &src) const; }; /** * Overlay with ToD darkening (DARKEN). */ struct darken_modification : modification { virtual surface operator()(const surface &src) const; }; /** * Fill background with a color (BG). */ struct background_modification : modification { background_modification(SDL_Color const &c): color_(c) {} virtual surface operator()(const surface &src) const; const SDL_Color& get_color() const; private: SDL_Color color_; }; } /* end namespace image */ #endif /* !defined(IMAGE_MODIFICATIONS_HPP_INCLUDED) */