4 // Copyright (C) 2006 Matthias Braun <matze@braunis.de>
6 // This program is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU General Public License
8 // as published by the Free Software Foundation; either version 2
9 // of the License, or (at your option) any later version.
11 // This program is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
16 // You should have received a copy of the GNU General Public License
17 // along with this program; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19 #ifndef SUPERTUX_DRAWINGCONTEXT_H
20 #define SUPERTUX_DRAWINGCONTEXT_H
28 #include <SDL_video.h>
31 #include "obstack/obstack.h"
32 #include "math/vector.hpp"
33 #include "math/rect.hpp"
34 #include "drawing_request.hpp"
40 struct DrawingRequest;
45 * This class provides functions for drawing things on screen. It also
46 * maintains a stack of transforms that are applied to graphics.
56 /// Adds a drawing request for a surface into the request list.
57 void draw_surface(const Surface* surface, const Vector& position,
59 /// Adds a drawing request for a surface into the request list.
60 void draw_surface(const Surface* surface, const Vector& position,
61 float angle, const Color& color, const Blend& blend,
63 /// Adds a drawing request for part of a surface.
64 void draw_surface_part(const Surface* surface, const Vector& source,
65 const Vector& size, const Vector& dest, int layer);
67 void draw_text(const Font* font, const std::string& text,
68 const Vector& position, FontAlignment alignment, int layer);
70 /// Draws text on screen center (feed Vector.x with a 0).
71 /// This is the same as draw_text() with a SCREEN_WIDTH/2 position and
72 /// alignment set to LEFT_ALLIGN
73 void draw_center_text(const Font* font, const std::string& text,
74 const Vector& position, int layer);
75 /// Draws a color gradient onto the whole screen */
76 void draw_gradient(const Color& from, const Color& to, int layer);
77 /// Fills a rectangle.
78 void draw_filled_rect(const Vector& topleft, const Vector& size,
79 const Color& color, int layer);
80 void draw_filled_rect(const Rect& rect, const Color& color, int layer);
81 void draw_filled_rect(const Rect& rect, const Color& color, float radius, int layer);
83 /// Processes all pending drawing requests and flushes the list.
86 const Vector& get_translation() const
87 { return transform.translation; }
89 void set_translation(const Vector& newtranslation)
90 { transform.translation = newtranslation; }
92 void push_transform();
95 /// Apply that effect in the next draws (effects are listed on surface.h).
96 void set_drawing_effect(DrawingEffect effect);
97 /// return currently applied drawing effect
98 DrawingEffect get_drawing_effect() const;
99 /// apply that alpha in the next draws (1.0 means fully opaque) */
100 void set_alpha(float alpha);
101 /// return currently set alpha
102 float get_alpha() const;
104 /// on next update, set color to lightmap's color at position
105 void get_light(const Vector& position, Color* color );
107 typedef ::Target Target;
108 static const Target NORMAL = ::NORMAL;
109 static const Target LIGHTMAP = ::LIGHTMAP;
112 void set_target(Target target);
114 void set_ambient_color( Color new_color );
117 * requests that a screenshot be taken after the next frame has been rendered
119 void take_screenshot();
126 DrawingEffect drawing_effect;
130 : drawing_effect(NO_EFFECT), alpha(1.0f)
133 Vector apply(const Vector& v) const
135 return v - translation;
142 /// the transform stack
143 std::vector<Transform> transformstack;
144 /// the currently active transform
147 std::vector<Blend> blend_stack;
150 typedef std::vector<DrawingRequest*> DrawingRequests;
152 void handle_drawing_requests(DrawingRequests& requests);
154 DrawingRequests drawing_requests;
155 DrawingRequests lightmap_requests;
157 DrawingRequests* requests;
161 std::vector<Target> target_stack;
163 /* obstack holding the memory of the drawing requests */
166 bool screenshot_requested; /**< true if a screenshot should be taken after the next frame has been rendered */