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 void draw_inverse_ellipse(const Vector& pos, const Vector& size, const Color& color, int layer);
85 /// Processes all pending drawing requests and flushes the list.
88 const Vector& get_translation() const
89 { return transform.translation; }
91 void set_translation(const Vector& newtranslation)
92 { transform.translation = newtranslation; }
94 void push_transform();
97 /// Apply that effect in the next draws (effects are listed on surface.h).
98 void set_drawing_effect(DrawingEffect effect);
99 /// return currently applied drawing effect
100 DrawingEffect get_drawing_effect() const;
101 /// apply that alpha in the next draws (1.0 means fully opaque) */
102 void set_alpha(float alpha);
103 /// return currently set alpha
104 float get_alpha() const;
106 /// on next update, set color to lightmap's color at position
107 void get_light(const Vector& position, Color* color );
109 typedef ::Target Target;
110 static const Target NORMAL = ::NORMAL;
111 static const Target LIGHTMAP = ::LIGHTMAP;
114 void set_target(Target target);
116 void set_ambient_color( Color new_color );
119 * requests that a screenshot be taken after the next frame has been rendered
121 void take_screenshot();
128 DrawingEffect drawing_effect;
132 : drawing_effect(NO_EFFECT), alpha(1.0f)
135 Vector apply(const Vector& v) const
137 return v - translation;
144 /// the transform stack
145 std::vector<Transform> transformstack;
146 /// the currently active transform
149 std::vector<Blend> blend_stack;
152 typedef std::vector<DrawingRequest*> DrawingRequests;
154 void handle_drawing_requests(DrawingRequests& requests);
156 DrawingRequests drawing_requests;
157 DrawingRequests lightmap_requests;
159 DrawingRequests* requests;
163 std::vector<Target> target_stack;
165 /* obstack holding the memory of the drawing requests */
168 bool screenshot_requested; /**< true if a screenshot should be taken after the next frame has been rendered */