scene.h

Go to the documentation of this file.

//            Copyright (C) 2004-2007 by The Allacrost Project
//                         All Rights Reserved
//
// This code is licensed under the GNU GPL version 2. It is free software 
// and you may modify it and/or redistribute it under the terms of this license.
// See http://www.gnu.org/copyleft/gpl.html for details.

/*!****************************************************************************
 * \file    scene.h
 * \author  Tyler Olsen, roots@allacrost.org
 * \brief   Header file for scene mode interface.
 *
 * This code handles the game event processing and frame drawing when the user
 * is in scene mode (when a full-screen art piece is drawn to the screen).
 * The user must wait a minimum amount of time, defined by the MIN_SCENE_UPDATES
 * constant, before the scene can be passed. This is to keep the user from
 * accidentally skipping over one of our beautiful artworks before they have
 * the chance to gawk at it in amazement. :)
 *****************************************************************************/

#ifndef __SCENE_HEADER__
#define __SCENE_HEADER__

#include "utils.h"
#include <string>
#include "defs.h"
#include "mode_manager.h"

namespace hoa_scene {

extern bool SCENE_DEBUG;

namespace private_scene {

const uint32 MIN_SCENE_UPDATES = 750;

} // namespace private_scene
 
/*!****************************************************************************
 * \brief Handles everything that needs to be done when full-screen artwork is displayed.
 *
 * This game mode displays a single full-screen art scene, which are used in
 * various places in the game. The scene can not be exited until the amount 
 * of milliseconds defined in MIN_SCENE_UPDATES has expired, to ensure that
 * the user does not accidentally skip the scene and can take the time to
 * appreciate the art.
 *****************************************************************************/
class SceneMode : public hoa_mode_manager::GameMode {
private:
  uint32 _scene_timer;

  //hoa_video::StillImage scene;
public:
  SceneMode();
  ~SceneMode();

  void Reset();
  void Update();
  void Draw();
}; // class SceneMode

} // namespace hoa_scene

#endif

---