//This file is part of Photon (http://photon.sourceforge.net) //Copyright (C) 2004-2005 James Turk // // Author: // James Turk (jpt2433@rit.edu) // // Version: // $Id: Application.hpp,v 1.16 2005/08/08 21:39:41 cozman Exp $ #ifndef PHOTON_APPLICATION_HPP #define PHOTON_APPLICATION_HPP #include #include #include #include #include "types.hpp" #include "util/VersionInfo.hpp" #include "State.hpp" #include "Task.hpp" #include "Kernel.hpp" #include "InputListener.hpp" #include "audio/AudioCore.hpp" #include "util/Singleton.hpp" #include namespace photon { // Class: Application // Photon main class, contains functions that control creation of the display, // setting the OpenGL view, input handling, timing, and management. // // Class is a and therefore should be accessed through // Application::getInstance(). (Application Singleton is created/destroyed // automatically) class Application : public util::Singleton { // Group: (Con/De)structors public: // Function: Application // Default constructor, initializes the internal state & dependencies. Application(const std::string& arg0); // Function: ~Application // Default destructor, shuts down dependencies. virtual ~Application(); // Group: Window public: // Function: createDisplay // This function attempts to create a display with the given parameters. // // Parameters: // width - desired width of display // height - desired height of display // redBits - desired bits per pixel for red value // greenBits - desired bits per pixel for green value // blueBits - desired bits per pixel for blue value // alphaBits - desired bits per pixel for alpha value // depthBits - desired bitdepth of depth buffer // stencilBits - desired bitdepth of stencil buffer // fullscreen - true: fullscreen, false: windowed // [title - title of application, optional] void createDisplay(uint width, uint height, uint redBits, uint greenBits, uint blueBits, uint alphaBits, uint depthBits, uint stencilBits, bool fullscreen, const std::string& title="Photon App"); // Function: createDisplay // This function attempts to create a display with the given parameters. // // Parameters: // width - desired width of display // height - desired height of display // bpp - desired bits per pixel (aka bitdepth) of display // depthBits - desired bitdepth of depth buffer // stencilBits - desired bitdepth of stencil buffer // fullscreen - true: fullscreen, false: windowed // [title - title of application, optional] void createDisplay(uint width, uint height, uint bpp, uint depthBits, uint stencilBits, bool fullscreen, const std::string& title="Photon App"); // Function: setTitle // Sets title of application that shows up in title bar. // // Parameters: // title - New title of application. void setTitle(const std::string& title); // Function: getDisplayWidth // Get the width of the display. // // Returns: // Width of display in pixels. uint getDisplayWidth(); // Function: getDisplayHeight // Get the height of the display. // // Returns: // Height of display in pixels. uint getDisplayHeight(); // Function: isActive // Checks if application is active, which on most systems simply means it // has focus. // // Returns: // True if application is active, false otherwise. bool isActive(); // Group: Ortho public: // Function: setOrthoView // Sets new ortho viewport within a rectangular portion of the screen. // All drawing is relative to the rectangle, x,y becomes 0,0 and anything // drawn outside rect is clipped. // // Parameters: // x - X coord for top left corner of new viewport. // y - Y coord for top left corner of new viewport. // viewWidth - Width of new viewport. // viewHeight - Height of new viewport. // orthoWidth - Width of ortho perspective. // orthoHeight - Height of ortho perspective. void setOrthoView(int x, int y, int viewWidth, int viewHeight, scalar orthoWidth, scalar orthoHeight); // Function: setOrthoView // Sets entire screen as current viewport with a given ortho perspective. // // Parameters: // width - Width of view. // height - Height of view. void setOrthoView(scalar width, scalar height); // Function: setOrthoView // Sets entire screen as current viewport with a 1:1 perspective. void setOrthoView(); // Group: Perspective public: // Function: setPerspectiveView // Creates a viewport with a given 3D perspective inside of a rectangular // portion of the screen. // // Parameters: // x - X coord for top left corner of new viewport. // y - Y coord for top left corner of new viewport. // width - Width of new viewport. // height - Height of new viewport. // fovy - The y axis field of view angle, in degrees. // zNear - Distance from viewer to near clipping plane. // zFar - Distance from viewer to far clipping plane. void setPerspectiveView(int x, int y, int width, int height, scalar fovy, scalar zNear, scalar zFar); // Function: setPerspectiveView // Sets entire screen as current viewport with a given 3D perspective. // // Parameters: // fovy - The y axis field of view angle, in degrees. // zNear - Distance from viewer to near clipping plane. // zFar - Distance from viewer to far clipping plane. void setPerspectiveView(scalar fovy, scalar zNear, scalar zFar); // Group: Viewport/Projection // These functions are called by the above Ortho/Perspective functions, very // rarely do they need to be called directly. public: // Function: setViewport // Set the current viewport rectangle within the screen. void setViewport(int x, int y, int width, int height); // Function: setOrthoProjection // Sets an orthographic projection matrix. // // Parameters: // width - Width of view. // height - Height of view. void setOrthoProjection(scalar width, scalar height); // Function: setPerspectiveProjection // Sets a perspective projection matrix. // // Parameters: // fovy - The y axis field of view angle, in degrees. // zNear - Distance from viewer to near clipping plane. // zFar - Distance from viewer to far clipping plane. void setPerspectiveProjection(scalar fovy, scalar zNear, scalar zFar); // Group: Input public: // Function: keyPressed // Check if a given key is currently pressed. // // Parameters: // key - of key to determine status of. // // Returns: // true: key is pressed, false: key isn't pressed bool keyPressed(KeyCode key); // Function: getPressedKeys // Obtain a list of all keys which are currently pressed. // // Returns: // std::vector of of any pressed keys. std::vector getPressedKeys(); // Function: mouseButtonPressed // Check if a given mouse button is currently pressed. // // Parameters: // button - to determine status of. // // Returns: // true: button is pressed, false: button isn't pressed bool mouseButtonPressed(MouseButton button); // Function: getMouseX // Gets current x location of mouse with respect to screen coordinates. // // Returns: // Mouse x-coordinate, with respect to screen coordinates. int getMouseX(); // Function: getMouseY // Gets current y location of mouse with respect to screen coordinates. // // Returns: // Mouse y-coordinate, with respect to screen coordinates. int getMouseY(); // Function: getMouseWheelPos // Gets current location of mouse wheel, treated as if wheel describes a // third axis of movement for the mouse. // // Returns: // Mouse wheel position, zero assumed to be starting position. int getMouseWheelPos(); // Group: Input Listeners public: // Function: addInputListener // Registers an to listen for any input events so that it // is notified when they occur. // // Parameters: // listener - Pointer to to add. static void addInputListener(InputListener *listener); // Function: removeInputListener // Removes an from the list of active listeners. // // Parameters: // listener - Pointer to to remove. static void removeInputListener(InputListener *listener); static void GLFWCALL keyCallback(int key, int action); //static void GLFWCALL charCallback(int character, int action); static void GLFWCALL mouseButtonCallback(int button, int action); static void GLFWCALL mouseMoveCallback(int x, int y); //static void GLFWCALL mouseWheelCallback(int pos); // Group: Timing public: // Function: getTime // Get time, in seconds, that application has been running. // // Returns: // Time, represented as a floating-point number in seconds, application has // been running. scalar getTime(); // Function: getElapsedTime // Finds the amount of time passed between frames, useful for time-based // movement. // // Returns: // Time between current frame and last frame. (1/()) double getElapsedTime(); // Function: getFramerate // Gets number of frames per second the application is currently processing // // Returns: // Current frames per second. double getFramerate(); // Group: State Management public: // Function: setCurrentState // Set the current Application . // // Template Parameters: // StateT - Class derived from to register. template void setCurrentState(); #ifdef PHOTON_USE_OPENAL // Group: AudioCore public: // Function: getAudioCore // Get the Application's , should only be called after // . // // Return: // Reference to the . audio::AudioCore& getAudioCore(); // Function: initAudioCore // Initialize the , should be done before attempting to access // it via . // // Arguments: // deviceName - Optional name for desired Audio device, will use default // device if none specified. void initAudioCore(const std::string& deviceName=""); #endif //PHOTON_USE_OPENAL // API Initialization private: util::VersionInfo initPhysFS(const std::string& arg0); util::VersionInfo initGLFW(); void initOpenGL(); // Task Classes private: // UpdateTask, does the updating work of Application, registered as a Task // so that user need not call something akin to Application::update() every // frame class UpdateTask : public Task { friend class Application; public: UpdateTask(); void update(); private: int mouseX_; int mouseY_; bool active_; bool timerPaused_; bool unpauseOnActive_; scalar lastPause_; scalar pausedTime_; scalar secPerFrame_; scalar lastUpdate_; }; // VideoTask, does the updating work of OpenGL class VideoTask : public Task { public: VideoTask(); void update(); }; // StateUpdate, calls State::update class StateUpdate : public Task { friend class Application; public: StateUpdate(); void update(); private: StatePtr state_; }; // StateRender, calls State::render class StateRender : public Task { friend class Application; public: StateRender(); void update(); private: StatePtr state_; }; // Data members private: // version number for photon util::VersionInfo photonVer_; // Application info uint displayWidth_; uint displayHeight_; uint viewportWidth_; uint viewportHeight_; // tasks shared_ptr updateTask_; shared_ptr stateUpdate_; shared_ptr stateRender_; // input system variables static std::vector listeners_; static std::vector pressedKeys_; // Cores #ifdef PHOTON_USE_OPENAL std::auto_ptr audioCore_; #endif //PHOTON_USE_OPENAL }; template void Application::setCurrentState() { stateRender_->state_ = stateUpdate_->state_ = StatePtr(new StateT); } } #endif //PHOTON_APPLICATION_HPP