render.hpp

Go to the documentation of this file.

/*
   Copyright (C) 2009 - 2016 by Ignacio R. Morelle <[email protected]>
   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
 * Storyscreen parts rendering interface.
 * @todo Translate relevant parts to GUI2.
 */

#ifndef STORYSCREEN_RENDER_HPP_INCLUDED
#define STORYSCREEN_RENDER_HPP_INCLUDED

#include "key.hpp"
#include "storyscreen/part.hpp"
#include "events.hpp"
// #include "widgets/button.hpp"

class CVideo;
class display;

namespace gui { class button; }

namespace storyscreen {

/**
 * Storyscreen part user interface.
 * This works on the assumption, like the old one, that the screen
 * cannot be resized while we are at this. More specifically, it is
 * assumed that the screen dimensions remain constant between the
 * constructor call, and the destruction of the objects.
 */
class part_ui : public events::sdl_handler
{
public:
    /** Storyscreen result. */
    enum RESULT {
        NEXT,   /**< The user pressed the go-next button. */
        BACK,   /**< The user pressed the go-back button. */
        QUIT    /**< The user selected quit. */
    };

    /**
     * Constructor.
     * @param p A storyscreen::part with the required information and parameters.
     * @param disp Display.
     * @param next_button Next button. Shouldn't be destroyed before the part_ui object.
     */
    part_ui(part &p, CVideo& video, gui::button &next_button,
        gui::button &back_button, gui::button& play_button);

    /**
     * Render and display the storyscreen, process and return user input.
     */
    RESULT show();

    virtual void handle_event(const SDL_Event&);

    virtual void handle_window_event(const SDL_Event& event);

private:
    part& p_;
    CVideo& video_;
    CKey keys_;     // convenience

    gui::button& next_button_;
    gui::button& back_button_;
    gui::button& play_button_;

    bool dirty_;

    RESULT ret_;
    bool skip_, last_key_;

    double x_scale_factor_;
    double y_scale_factor_;

    // Keeps the area occupied on the screen by the base layer
    // (the background layer we align the images to)
    SDL_Rect base_rect_;

#ifdef SDL_GPU
    std::vector< sdl::timage > background_images_;
    std::vector< std::pair<int, int> > background_positions_;
#else
    surface background_;
#endif
    std::vector< floating_image::render_input > imgs_;
    bool has_background_;

    int text_x_, text_y_, buttons_x_, buttons_y_;

    /** Constructor implementation details. */
    void prepare_background();
    /** Constructor implementation details. */
    void prepare_geometry();
    /** Constructor implementation details. */
    void prepare_floating_images();

    void render_background();
    void render_title_box();
    void render_story_box();
    void render_story_box_borders(SDL_Rect&);

    /**
     * Returns true if the user did an action. Modifies #ret_, #skip_,
     * and #last_key_ accordingly.
     */
    bool handle_interface();

    /**
     * Renders all floating images in sequence.
     * @return 'true' if the user interrupted the operation; 'false' otherwise.
     */
    bool render_floating_images();

    void wait_for_input();
};

} // end namespace storyscreen

#endif /* !STORYSCREEN_RENDER_HPP_INCLUDED */