Delayed root hatching
[supertux.git] / src / video / drawing_context.cpp
index 7c83695..60faef5 100644 (file)
@@ -1,7 +1,7 @@
-//  $Id: drawing_context.cpp 2334 2005-04-04 16:26:14Z grumbel $
+//  $Id$
 //
-//  SuperTux -  A Jump'n Run
-//  Copyright (C) 2004 Matthias Braun <matze@braunis.de
+//  SuperTux
+//  Copyright (C) 2006 Matthias Braun <matze@braunis.de>
 //
 //  This program is free software; you can redistribute it and/or
 //  modify it under the terms of the GNU General Public License
 //  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 #include <config.h>
 
+#include <functional>
 #include <algorithm>
 #include <cassert>
 #include <iostream>
+#include <SDL_image.h>
+#include <GL/gl.h>
+#include <sstream>
+#include <iomanip>
+#include <physfs.h>
 
 #include "drawing_context.hpp"
 #include "surface.hpp"
 #include "font.hpp"
 #include "main.hpp"
 #include "gameconfig.hpp"
+#include "glutil.hpp"
+#include "texture.hpp"
+#include "texture_manager.hpp"
+#include "obstack/obstackpp.hpp"
+#define LIGHTMAP_DIV 5
 
-DrawingContext::DrawingContext(SDL_Surface* targetsurface)
+enum RequestType
 {
-  if(targetsurface) {
-    screen = targetsurface;
-  } else {
-    screen = SDL_GetVideoSurface();
+  SURFACE, SURFACE_PART, TEXT, GRADIENT, FILLRECT, LIGHTMAPREQUEST, GETLIGHT
+};
+
+struct SurfacePartRequest
+{
+  const Surface* surface;
+  Vector source, size;
+};
+
+struct TextRequest
+{
+  const Font* font;
+  std::string text;
+  FontAlignment alignment;
+};
+
+struct GradientRequest
+{
+  Color top, bottom;
+  Vector size;
+};
+
+struct FillRectRequest
+{
+  Color color;
+  Vector size;
+};
+
+struct DrawingRequest
+{
+  RequestType type;
+  Vector pos;
+
+  int layer;
+  DrawingEffect drawing_effect;
+  float alpha;
+  Blend blend;
+  float angle;
+  Color color;
+
+  void* request_data;
+
+  DrawingRequest()
+    : angle(0.0f),
+      color(1.0f, 1.0f, 1.0f, 1.0f)
+  {}
+
+  bool operator<(const DrawingRequest& other) const
+  {
+    return layer < other.layer;
   }
+};
+
+struct GetLightRequest
+{
+  Color* color_ptr;
+};
+
+static inline int next_po2(int val)
+{
+  int result = 1;
+  while(result < val)
+    result *= 2;
+
+  return result;
+}
+
+DrawingContext::DrawingContext()
+  : ambient_color(1.0f, 1.0f, 1.0f, 1.0f), target(NORMAL), screenshot_requested(false)
+{
+  screen = SDL_GetVideoSurface();
+
+  lightmap_width = screen->w / LIGHTMAP_DIV;
+  lightmap_height = screen->h / LIGHTMAP_DIV;
+  unsigned int width = next_po2(lightmap_width);
+  unsigned int height = next_po2(lightmap_height);
+
+  lightmap = new Texture(width, height, GL_RGB);
+
+  lightmap_uv_right = static_cast<float>(lightmap_width) / static_cast<float>(width);
+  lightmap_uv_bottom = static_cast<float>(lightmap_height) / static_cast<float>(height);
+  texture_manager->register_texture(lightmap);
+
+  requests = &drawing_requests;
+
+  obstack_init(&obst);
 }
 
 DrawingContext::~DrawingContext()
 {
+  obstack_free(&obst, NULL);
+
+  texture_manager->remove_texture(lightmap);
+  delete lightmap;
 }
 
 void
 DrawingContext::draw_surface(const Surface* surface, const Vector& position,
-    int layer)
+                             float angle, const Color& color, const Blend& blend,
+                             int layer)
 {
   assert(surface != 0);
-  
-  DrawingRequest request;
 
-  request.type = SURFACE;
-  request.pos = transform.apply(position);
+  DrawingRequest* request = new(obst) DrawingRequest();
+
+  request->type = SURFACE;
+  request->pos = transform.apply(position);
 
-  if(request.pos.x >= SCREEN_WIDTH || request.pos.y >= SCREEN_HEIGHT
-      || request.pos.x + surface->w < 0 || request.pos.y + surface->h < 0)
+  if(request->pos.x >= SCREEN_WIDTH || request->pos.y >= SCREEN_HEIGHT
+      || request->pos.x + surface->get_width() < 0
+      || request->pos.y + surface->get_height() < 0)
     return;
 
-  request.layer = layer;
-  request.drawing_effect = transform.drawing_effect;
-  request.zoom = transform.zoom;
-  request.alpha = transform.alpha;
-  request.request_data = const_cast<Surface*> (surface);  
+  request->layer = layer;
+  request->drawing_effect = transform.drawing_effect;
+  request->alpha = transform.alpha;
+  request->angle = angle;
+  request->color = color;
+  request->blend = blend;
 
-  drawingrequests.push_back(request);
+  request->request_data = const_cast<Surface*> (surface);
+
+  requests->push_back(request);
+}
+
+void
+DrawingContext::draw_surface(const Surface* surface, const Vector& position,
+    int layer)
+{
+  draw_surface(surface, position, 0.0f, Color(1.0f, 1.0f, 1.0f), Blend(), layer);
 }
 
 void
@@ -71,59 +179,58 @@ DrawingContext::draw_surface_part(const Surface* surface, const Vector& source,
 {
   assert(surface != 0);
 
-  DrawingRequest request;
+  DrawingRequest* request = new(obst) DrawingRequest();
+
+  request->type = SURFACE_PART;
+  request->pos = transform.apply(dest);
+  request->layer = layer;
+  request->drawing_effect = transform.drawing_effect;
+  request->alpha = transform.alpha;
 
-  request.type = SURFACE_PART;
-  request.pos = transform.apply(dest);
-  request.layer = layer;
-  request.drawing_effect = transform.drawing_effect;
-  request.alpha = transform.alpha;
-  
-  SurfacePartRequest* surfacepartrequest = new SurfacePartRequest();
+  SurfacePartRequest* surfacepartrequest = new(obst) SurfacePartRequest();
   surfacepartrequest->size = size;
   surfacepartrequest->source = source;
   surfacepartrequest->surface = surface;
 
   // clip on screen borders
-  if(request.pos.x < 0) {
-    surfacepartrequest->size.x += request.pos.x;
+  if(request->pos.x < 0) {
+    surfacepartrequest->size.x += request->pos.x;
     if(surfacepartrequest->size.x <= 0)
       return;
-    surfacepartrequest->source.x -= request.pos.x;
-    request.pos.x = 0;
+    surfacepartrequest->source.x -= request->pos.x;
+    request->pos.x = 0;
   }
-  if(request.pos.y < 0) {
-    surfacepartrequest->size.y += request.pos.y;
+  if(request->pos.y < 0) {
+    surfacepartrequest->size.y += request->pos.y;
     if(surfacepartrequest->size.y <= 0)
       return;
-    surfacepartrequest->source.y -= request.pos.y;
-    request.pos.y = 0;
+    surfacepartrequest->source.y -= request->pos.y;
+    request->pos.y = 0;
   }
-  request.request_data = surfacepartrequest;
+  request->request_data = surfacepartrequest;
 
-  drawingrequests.push_back(request);
+  requests->push_back(request);
 }
 
 void
 DrawingContext::draw_text(const Font* font, const std::string& text,
     const Vector& position, FontAlignment alignment, int layer)
 {
-  DrawingRequest request;
+  DrawingRequest* request = new(obst) DrawingRequest();
 
-  request.type = TEXT;
-  request.pos = transform.apply(position);
-  request.layer = layer;
-  request.drawing_effect = transform.drawing_effect;
-  request.zoom = transform.zoom;
-  request.alpha = transform.alpha;
+  request->type = TEXT;
+  request->pos = transform.apply(position);
+  request->layer = layer;
+  request->drawing_effect = transform.drawing_effect;
+  request->alpha = transform.alpha;
 
-  TextRequest* textrequest = new TextRequest;
+  TextRequest* textrequest = new(obst) TextRequest();
   textrequest->font = font;
   textrequest->text = text;
   textrequest->alignment = alignment;
-  request.request_data = textrequest;
+  request->request_data = textrequest;
 
-  drawingrequests.push_back(request);
+  requests->push_back(request);
 }
 
 void
@@ -131,124 +238,209 @@ DrawingContext::draw_center_text(const Font* font, const std::string& text,
     const Vector& position, int layer)
 {
   draw_text(font, text, Vector(position.x + SCREEN_WIDTH/2, position.y),
-      CENTER_ALLIGN, layer);
+      ALIGN_CENTER, layer);
 }
 
 void
-DrawingContext::draw_gradient(Color top, Color bottom, int layer)
+DrawingContext::draw_gradient(const Color& top, const Color& bottom, int layer)
 {
-  DrawingRequest request;
+  DrawingRequest* request = new(obst) DrawingRequest();
 
-  request.type = GRADIENT;
-  request.pos = Vector(0,0);
-  request.layer = layer;
+  request->type = GRADIENT;
+  request->pos = Vector(0,0);
+  request->layer = layer;
 
-  request.drawing_effect = transform.drawing_effect;
-  request.zoom = transform.zoom;
-  request.alpha = transform.alpha;
+  request->drawing_effect = transform.drawing_effect;
+  request->alpha = transform.alpha;
 
-  GradientRequest* gradientrequest = new GradientRequest;
+  GradientRequest* gradientrequest = new(obst) GradientRequest();
   gradientrequest->top = top;
   gradientrequest->bottom = bottom;
-  request.request_data = gradientrequest;
+  request->request_data = gradientrequest;
 
-  drawingrequests.push_back(request);
+  requests->push_back(request);
 }
 
 void
 DrawingContext::draw_filled_rect(const Vector& topleft, const Vector& size,
-        Color color, int layer)
+                                 const Color& color, int layer)
 {
-  DrawingRequest request;
+  DrawingRequest* request = new(obst) DrawingRequest();
 
-  request.type = FILLRECT;
-  request.pos = transform.apply(topleft);
-  request.layer = layer;
+  request->type = FILLRECT;
+  request->pos = transform.apply(topleft);
+  request->layer = layer;
 
-  request.drawing_effect = transform.drawing_effect;
-  request.zoom = transform.zoom;
-  request.alpha = transform.alpha;                    
+  request->drawing_effect = transform.drawing_effect;
+  request->alpha = transform.alpha;
 
-  FillRectRequest* fillrectrequest = new FillRectRequest;
+  FillRectRequest* fillrectrequest = new(obst) FillRectRequest();
   fillrectrequest->size = size;
   fillrectrequest->color = color;
-  fillrectrequest->color.alpha
-      = (int) ((float) fillrectrequest->color.alpha 
-              * ((float) transform.alpha / 255.0));
-  request.request_data = fillrectrequest;
+  fillrectrequest->color.alpha = color.alpha * transform.alpha;
+  request->request_data = fillrectrequest;
 
-  drawingrequests.push_back(request);
+  requests->push_back(request);
 }
 
 void
-DrawingContext::draw_surface_part(DrawingRequest& request)
+DrawingContext::draw_filled_rect(const Rect& rect, const Color& color,
+                                 int layer)
 {
-  SurfacePartRequest* surfacepartrequest
+  DrawingRequest* request = new(obst) DrawingRequest();
+
+  request->type = FILLRECT;
+  request->pos = transform.apply(rect.p1);
+  request->layer = layer;
+
+  request->drawing_effect = transform.drawing_effect;
+  request->alpha = transform.alpha;
+
+  FillRectRequest* fillrectrequest = new(obst) FillRectRequest;
+  fillrectrequest->size = Vector(rect.get_width(), rect.get_height());
+  fillrectrequest->color = color;
+  fillrectrequest->color.alpha = color.alpha * transform.alpha;
+  request->request_data = fillrectrequest;
+
+  requests->push_back(request);
+}
+
+void
+DrawingContext::get_light(const Vector& position, Color* color)
+{
+  if( ambient_color.red == 1.0f && ambient_color.green == 1.0f
+      && ambient_color.blue  == 1.0f ) {
+    *color = Color( 1.0f, 1.0f, 1.0f);
+    return;
+  }
+
+  DrawingRequest* request = new(obst) DrawingRequest();
+  request->type = GETLIGHT;
+  request->pos = transform.apply(position);
+
+  //There is no light offscreen.
+  if(request->pos.x >= SCREEN_WIDTH || request->pos.y >= SCREEN_HEIGHT
+      || request->pos.x < 0 || request->pos.y < 0){
+    *color = Color( 0, 0, 0);
+    return;
+  }
+
+  request->layer = LAYER_GUI; //make sure all get_light requests are handled last.
+  GetLightRequest* getlightrequest = new(obst) GetLightRequest();
+  getlightrequest->color_ptr = color;
+  request->request_data = getlightrequest;
+  lightmap_requests.push_back(request);
+}
+
+void
+DrawingContext::get_light(const DrawingRequest& request) const
+{
+  const GetLightRequest* getlightrequest 
+    = (GetLightRequest*) request.request_data;
+
+  float pixels[3];
+  for( int i = 0; i<3; i++)
+    pixels[i] = 0.0f; //set to black
+
+  float posX = request.pos.x * lightmap_width / SCREEN_WIDTH;
+  float posY = screen->h - request.pos.y * lightmap_height / SCREEN_HEIGHT;
+  glReadPixels((GLint) posX, (GLint) posY , 1, 1, GL_RGB, GL_FLOAT, pixels);
+    *(getlightrequest->color_ptr) = Color( pixels[0], pixels[1], pixels[2]);
+  //printf("get_light %f/%f =>%f/%f r%f g%f b%f\n", request.pos.x, request.pos.y, posX, posY, pixels[0], pixels[1], pixels[2]);
+}
+
+void
+DrawingContext::draw_surface_part(const DrawingRequest& request) const
+{
+  const SurfacePartRequest* surfacepartrequest
     = (SurfacePartRequest*) request.request_data;
 
-  surfacepartrequest->surface->impl->draw_part(
+  surfacepartrequest->surface->draw_part(
       surfacepartrequest->source.x, surfacepartrequest->source.y,
       request.pos.x, request.pos.y,
-      surfacepartrequest->size.x, surfacepartrequest->size.y, request.alpha,
-      request.drawing_effect);
-
-  delete surfacepartrequest;
+      surfacepartrequest->size.x, surfacepartrequest->size.y,
+      request.alpha, request.drawing_effect);
 }
 
 void
-DrawingContext::draw_gradient(DrawingRequest& request)
+DrawingContext::draw_gradient(const DrawingRequest& request) const
 {
-  GradientRequest* gradientrequest = (GradientRequest*) request.request_data;
+  const GradientRequest* gradientrequest 
+    = (GradientRequest*) request.request_data;
   const Color& top = gradientrequest->top;
   const Color& bottom = gradientrequest->bottom;
-  
+
+  glDisable(GL_TEXTURE_2D);
   glBegin(GL_QUADS);
-  glColor3ub(top.red, top.green, top.blue);
+  glColor4f(top.red, top.green, top.blue, top.alpha);
   glVertex2f(0, 0);
   glVertex2f(SCREEN_WIDTH, 0);
-  glColor3ub(bottom.red, bottom.green, bottom.blue);
+  glColor4f(bottom.red, bottom.green, bottom.blue, bottom.alpha);
   glVertex2f(SCREEN_WIDTH, SCREEN_HEIGHT);
   glVertex2f(0, SCREEN_HEIGHT);
   glEnd();
-
-  delete gradientrequest;
+  glEnable(GL_TEXTURE_2D);
 }
 
 void
-DrawingContext::draw_text(DrawingRequest& request)
+DrawingContext::draw_text(const DrawingRequest& request) const
 {
-  TextRequest* textrequest = (TextRequest*) request.request_data;
+  const TextRequest* textrequest = (TextRequest*) request.request_data;
 
   textrequest->font->draw(textrequest->text, request.pos,
       textrequest->alignment, request.drawing_effect, request.alpha);
-
-  delete textrequest;
 }
 
 void
-DrawingContext::draw_filled_rect(DrawingRequest& request)
+DrawingContext::draw_filled_rect(const DrawingRequest& request) const
 {
-  FillRectRequest* fillrectrequest = (FillRectRequest*) request.request_data;
+  const FillRectRequest* fillrectrequest
+    = (FillRectRequest*) request.request_data;
 
   float x = request.pos.x;
   float y = request.pos.y;
   float w = fillrectrequest->size.x;
   float h = fillrectrequest->size.y;
 
-  glEnable(GL_BLEND);
-  glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
-  glColor4ub(fillrectrequest->color.red, fillrectrequest->color.green,
-             fillrectrequest->color.blue, fillrectrequest->color.alpha);
-  
-  glBegin(GL_POLYGON);
+  glDisable(GL_TEXTURE_2D);
+  glColor4f(fillrectrequest->color.red, fillrectrequest->color.green,
+            fillrectrequest->color.blue, fillrectrequest->color.alpha);
+
+  glBegin(GL_QUADS);
   glVertex2f(x, y);
   glVertex2f(x+w, y);
   glVertex2f(x+w, y+h);
   glVertex2f(x, y+h);
   glEnd();
-  glDisable(GL_BLEND);
+  glEnable(GL_TEXTURE_2D);
+}
+
+void
+DrawingContext::draw_lightmap(const DrawingRequest& request) const
+{
+  const Texture* texture = reinterpret_cast<Texture*> (request.request_data);
+
+  // multiple the lightmap with the framebuffer
+  glBlendFunc(GL_DST_COLOR, GL_ZERO);
+
+  glBindTexture(GL_TEXTURE_2D, texture->get_handle());
+  glBegin(GL_QUADS);
+
+  glTexCoord2f(0, lightmap_uv_bottom);
+  glVertex2f(0, 0);
+
+  glTexCoord2f(lightmap_uv_right, lightmap_uv_bottom);
+  glVertex2f(SCREEN_WIDTH, 0);
+
+  glTexCoord2f(lightmap_uv_right, 0);
+  glVertex2f(SCREEN_WIDTH, SCREEN_HEIGHT);
+
+  glTexCoord2f(0, 0);
+  glVertex2f(0, SCREEN_HEIGHT);
+
+  glEnd();
 
-  delete fillrectrequest;
+  glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
 }
 
 void
@@ -256,45 +448,122 @@ DrawingContext::do_drawing()
 {
 #ifdef DEBUG
   assert(transformstack.empty());
+  assert(target_stack.empty());
 #endif
   transformstack.clear();
-    
-  std::stable_sort(drawingrequests.begin(), drawingrequests.end());
+  target_stack.clear();
+
+  //Use Lightmap if ambient color is not white.
+  bool use_lightmap = ( ambient_color.red != 1.0f   || ambient_color.green != 1.0f ||
+                        ambient_color.blue  != 1.0f );
+
+  // PART1: create lightmap
+  if(use_lightmap) {
+    glViewport(0, screen->h - lightmap_height, lightmap_width, lightmap_height);
+    glMatrixMode(GL_PROJECTION);
+    glLoadIdentity();
+    glOrtho(0, SCREEN_WIDTH, SCREEN_HEIGHT, 0, -1.0, 1.0);
+    glMatrixMode(GL_MODELVIEW);
+    glLoadIdentity();
+
+    glClearColor( ambient_color.red, ambient_color.green, ambient_color.blue, 1 );
+    glClear(GL_COLOR_BUFFER_BIT);
+    handle_drawing_requests(lightmap_requests);
+    lightmap_requests.clear();
+
+    glDisable(GL_BLEND);
+    glBindTexture(GL_TEXTURE_2D, lightmap->get_handle());
+    glCopyTexSubImage2D(GL_TEXTURE_2D, 0, 0, 0, 0, screen->h - lightmap_height, lightmap_width, lightmap_height);
+
+    glViewport(0, 0, screen->w, screen->h);
+    glMatrixMode(GL_PROJECTION);
+    glLoadIdentity();
+    glOrtho(0, SCREEN_WIDTH, SCREEN_HEIGHT, 0, -1.0, 1.0);
+    glMatrixMode(GL_MODELVIEW);
+    glLoadIdentity();
+    glEnable(GL_BLEND);
+
+    // add a lightmap drawing request into the queue
+    DrawingRequest* request = new(obst) DrawingRequest();
+    request->type = LIGHTMAPREQUEST;
+    request->layer = LAYER_HUD - 1;
+    request->request_data = lightmap;
+    requests->push_back(request);
+  }
+
+  //glClear(GL_COLOR_BUFFER_BIT);
+  handle_drawing_requests(drawing_requests);
+  drawing_requests.clear();
+  obstack_free(&obst, NULL);
+  obstack_init(&obst);
+  assert_gl("drawing");
+
+  // if a screenshot was requested, take one
+  if (screenshot_requested) {
+    do_take_screenshot();
+    screenshot_requested = false;
+  }
 
-  for(DrawingRequests::iterator i = drawingrequests.begin();
-      i != drawingrequests.end(); ++i) {
-    switch(i->type) {
+  SDL_GL_SwapBuffers();
+}
+
+class RequestPtrCompare
+  :  public std::binary_function<const DrawingRequest*,
+                                 const DrawingRequest*, 
+                                 bool>
+{
+public:
+  bool operator()(const DrawingRequest* r1, const DrawingRequest* r2) const
+  {
+    return *r1 < *r2;
+  }
+};
+
+void
+DrawingContext::handle_drawing_requests(DrawingRequests& requests) const
+{
+  std::stable_sort(requests.begin(), requests.end(), RequestPtrCompare());
+
+  DrawingRequests::const_iterator i;
+  for(i = requests.begin(); i != requests.end(); ++i) {
+    const DrawingRequest& request = **i;
+
+    switch(request.type) {
       case SURFACE:
       {
-        const Surface* surface = (const Surface*) i->request_data;
-
-        if(i->zoom != 1.0)
-          surface->impl->draw_stretched(i->pos.x * i->zoom, i->pos.y * i->zoom,
-                         (int)(surface->w * i->zoom), (int)(surface->h * i->zoom),
-                         i->alpha, i->drawing_effect);
-        else
-          surface->impl->draw(i->pos.x, i->pos.y, i->alpha, i->drawing_effect);
+        const Surface* surface = (const Surface*) request.request_data;
+        if (request.angle == 0.0f &&
+            request.color.red == 1.0f && request.color.green == 1.0f  &&
+            request.color.blue == 1.0f &&  request.color.alpha == 1.0f) {
+          surface->draw(request.pos.x, request.pos.y, request.alpha,
+              request.drawing_effect);
+        } else {
+          surface->draw(request.pos.x, request.pos.y,
+              request.alpha, request.angle, request.color,
+              request.blend, request.drawing_effect);
+        }
         break;
       }
       case SURFACE_PART:
-        draw_surface_part(*i);
+        draw_surface_part(request);
         break;
       case GRADIENT:
-        draw_gradient(*i);
+        draw_gradient(request);
         break;
       case TEXT:
-        draw_text(*i);
+        draw_text(request);
         break;
       case FILLRECT:
-        draw_filled_rect(*i);
+        draw_filled_rect(request);
+        break;
+      case LIGHTMAPREQUEST:
+        draw_lightmap(request);
+        break;
+      case GETLIGHT:
+        get_light(request);
         break;
     }
   }
-
-  drawingrequests.clear();
-
-  // update screen
-  SDL_GL_SwapBuffers();
 }
 
 void
@@ -313,31 +582,122 @@ DrawingContext::pop_transform()
 }
 
 void
-DrawingContext::set_drawing_effect(uint32_t effect)
+DrawingContext::set_drawing_effect(DrawingEffect effect)
 {
   transform.drawing_effect = effect;
 }
 
-uint32_t
+DrawingEffect
 DrawingContext::get_drawing_effect() const
 {
   return transform.drawing_effect;
 }
 
 void
-DrawingContext::set_zooming(float zoom)
+DrawingContext::set_alpha(float alpha)
+{
+  transform.alpha = alpha;
+}
+
+float
+DrawingContext::get_alpha() const
+{
+  return transform.alpha;
+}
+
+void
+DrawingContext::push_target()
 {
-  transform.zoom = zoom;
+  target_stack.push_back(target);
 }
 
 void
-DrawingContext::set_alpha(uint8_t alpha)
+DrawingContext::pop_target()
 {
-  transform.alpha = alpha;
+  set_target(target_stack.back());
+  target_stack.pop_back();
 }
 
-uint8_t
-DrawingContext::get_alpha() const
+void
+DrawingContext::set_target(Target target)
 {
-  return transform.alpha;
+  this->target = target;
+  if(target == LIGHTMAP) {
+    requests = &lightmap_requests;
+  } else {
+    assert(target == NORMAL);
+    requests = &drawing_requests;
+  }
 }
+
+void
+DrawingContext::set_ambient_color( Color new_color )
+{
+  ambient_color = new_color;
+}
+
+void 
+DrawingContext::do_take_screenshot()
+{
+  // [Christoph] TODO: Yes, this method also takes care of the actual disk I/O. Split it?
+
+  // create surface to hold screenshot
+  #if SDL_BYTEORDER == SDL_BIG_ENDIAN
+  SDL_Surface* shot_surf = SDL_CreateRGBSurface(SDL_SWSURFACE, SCREEN_WIDTH, SCREEN_HEIGHT, 24, 0x00FF0000, 0x0000FF00, 0x000000FF, 0);
+  #else
+  SDL_Surface* shot_surf = SDL_CreateRGBSurface(SDL_SWSURFACE, SCREEN_WIDTH, SCREEN_HEIGHT, 24, 0x000000FF, 0x0000FF00, 0x00FF0000, 0);
+  #endif
+  if (!shot_surf) {
+    log_warning << "Could not create RGB Surface to contain screenshot" << std::endl;
+    return;
+  }
+
+  // read pixels into array
+  char* pixels = new char[3 * SCREEN_WIDTH * SCREEN_HEIGHT];
+  if (!pixels) {
+    log_warning << "Could not allocate memory to store screenshot" << std::endl;
+    SDL_FreeSurface(shot_surf);
+    return;
+  }
+  glReadPixels(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT, GL_RGB, GL_UNSIGNED_BYTE, pixels);
+
+  // copy array line-by-line
+  for (int i = 0; i < SCREEN_HEIGHT; i++) {
+    char* src = pixels + (3 * SCREEN_WIDTH * (SCREEN_HEIGHT - i - 1));
+    char* dst = ((char*)shot_surf->pixels) + i * shot_surf->pitch;
+    memcpy(dst, src, 3 * SCREEN_WIDTH);
+  }
+
+  // free array
+  delete[](pixels);
+
+  // save screenshot
+  static const std::string writeDir = PHYSFS_getWriteDir();
+  static const std::string dirSep = PHYSFS_getDirSeparator();
+  static const std::string baseName = "screenshot";
+  static const std::string fileExt = ".bmp";
+  std::string fullFilename;
+  for (int num = 0; num < 1000; num++) {
+    std::ostringstream oss;
+    oss << baseName;
+    oss << std::setw(3) << std::setfill('0') << num;
+    oss << fileExt;
+    std::string fileName = oss.str();
+    fullFilename = writeDir + dirSep + fileName;
+    if (!PHYSFS_exists(fileName.c_str())) {
+      SDL_SaveBMP(shot_surf, fullFilename.c_str());
+      log_debug << "Wrote screenshot to \"" << fullFilename << "\"" << std::endl;
+      SDL_FreeSurface(shot_surf);
+      return;
+    }
+  }
+  log_warning << "Did not save screenshot, because all files up to \"" << fullFilename << "\" already existed" << std::endl;
+  SDL_FreeSurface(shot_surf);
+}
+
+void 
+DrawingContext::take_screenshot()
+{
+  screenshot_requested = true;
+}
+