cinder::app::AppScreenSaver Class Reference

#include <AppScreenSaver.h>

Inherits cinder::app::App.

List of all members.

Classes

class  Settings

Public Member Functions

void launch (const char *title, int argc, char *const argv[])
virtual void prepareSettings (Settings *settings)
const SettingsgetSettings () const
virtual int getWindowWidth () const
 Returns the width of the App's window measured in pixels, or the screen when in full-screen mode.
void setWindowWidth (int windowWidth)
 Ignored for ScreenSavers.
virtual int getWindowHeight () const
 Returns the height of the App's window measured in pixels, or the screen when in full-screen mode.
void setWindowHeight (int windowHeight)
 Ignored for ScreenSavers.
void setWindowSize (int windowWidth, int windowHeight)
 Ignored for ScreenSavers.
virtual float getFrameRate () const
 Returns the maximum frame-rate the App will attempt to maintain measured in frames-per-second.
virtual void setFrameRate (float frameRate)
 Sets the maximum frame-rate the App will attempt to maintain \ a frameRate frames-per-second.
virtual bool isFullScreen () const
 Returns false if the ScreenSaver is running in preview mode, otherwise true.
virtual void setFullScreen (bool fullScreen)
 Ignored for ScreenSavers.
virtual void quit ()
 Ignored for ScreenSavers.
virtual std::string getAppPath ()
 Returns the path to the application on disk.
void privateSetImpl__ (void *impl)
void launch (::HWND hwnd)
virtual bool getsWindowsPaintEvents ()
class AppImplMswScreenSavergetImpl ()
virtual bool receivesEvents () const
virtual void setup ()
 Override to perform any application setup after the Renderer has been initialized.
virtual void shutdown ()
 Override to perform any application cleanup before exiting.
virtual void update ()
 Override to perform any once-per-loop computation.
virtual void draw ()
 Override to perform any rendering once-per-loop or in response to OS-prompted requests for refreshes.
virtual void mouseDown (MouseEvent event)
 Override to receive mouse-down events.
virtual void mouseUp (MouseEvent event)
 Override to receive mouse-up events.
virtual void mouseWheel (MouseEvent event)
 Override to receive mouse-wheel events.
virtual void mouseMove (MouseEvent event)
 Override to receive mouse-move events.
virtual void mouseDrag (MouseEvent event)
 Override to receive mouse-drag events.
virtual void keyDown (KeyEvent event)
 Override to receive key-down events.
virtual void keyUp (KeyEvent event)
 Override to receive key-up events.
virtual void resize (int width, int height)
 Override to receive window resize events.
virtual void fileDrop (FileDropEvent event)
 Override to receive file-drop events.
void addListener (Listener *listener)
 Adds a Listener to the App's event listeners. The app deletes listener upon its own destruction unless it is removed via removeListener.
void removeListener (Listener *listener)
 Removes a listener from the App's event listeners. Does not delete listener.
RenderergetRenderer () const
void setWindowSize (const Vec2i &size)
 Sets the size of the App's window. Ignored in full-screen mode.
Vec2f getWindowCenter () const
 Returns the center of the App's window or the screen in full-screen mode.
Vec2i getWindowSize () const
 Returns the size of the App's window or the screen in full-screen mode.
float getWindowAspectRatio () const
 Returns the aspect ratio of the App's window or the screen in full-screen mode.
Area getWindowBounds () const
 Returns the bounding area of the App's window or the screen in full-screen mode.
float getAverageFps () const
 Returns the average frame-rate attained by the App as measured in frames-per-second.
double getFpsSampleInterval () const
 Returns the sampling rate in seconds for measuring the average frame-per-second as returned by getAverageFps().
void setFpsSampleInterval (double sampleInterval)
 Sets the sampling rate in seconds for measuring the average frame-per-second as returned by getAverageFps().
double getElapsedSeconds () const
 Returns the number of seconds which have elapsed since application launch.
uint32_t getElapsedFrames () const
 Returns the number of animation frames which have elapsed since application launch.
std::string getResourcePath (const std::string &rsrcRelativePath)
std::string getOpenFilePath (const std::string &initialPath="", std::vector< std::string > extensions=std::vector< std::string >())
 Presents the user with a file-open dialog and returns the selected file path.
std::string getSaveFilePath (const std::string &initialPath="", std::vector< std::string > extensions=std::vector< std::string >())
 Presents the user with a file-save dialog and returns the selected file path.
std::ostream & console ()
 Returns a reference to an output console, which is an alias to std::cout on the mac, and a wrapper around OutputDebugString on MSW.
Surface copyWindowSurface ()
Surface copyWindowSurface (const Area &area)
void restoreWindowContext ()
 Restores the current rendering context to be the App's window or the screen in full-screen mode. Generally this is only necessary if the app has displayed a dialog box or some other external window.

Static Public Member Functions

static void executeLaunch (AppScreenSaver *app, class Renderer *renderer, const char *title)
static void executeLaunch (AppScreenSaver *app, class Renderer *renderer, const char *title,::HWND hwnd)
static DataSourceRef loadResource (const std::string &macPath, int mswID, const std::string &mswType)
static DataSourcePathRef loadResource (const std::string &macPath)
static DataSourceBufferRef loadResource (int mswID, const std::string &mswType)
static Appget ()
 Returns a pointer to the active App.

Member Function Documentation

void cinder::app::AppScreenSaver::launch ( const char *  title,
int  argc,
char *const   argv[] 
)
virtual void cinder::app::AppScreenSaver::prepareSettings ( Settings settings  )  [virtual]
const Settings& cinder::app::AppScreenSaver::getSettings (  )  const [virtual]

Reimplemented from cinder::app::App.

int cinder::app::AppScreenSaver::getWindowWidth (  )  const [virtual]

Returns the width of the App's window measured in pixels, or the screen when in full-screen mode.

Implements cinder::app::App.

void cinder::app::AppScreenSaver::setWindowWidth ( int  windowWidth  )  [virtual]

Ignored for ScreenSavers.

Implements cinder::app::App.

int cinder::app::AppScreenSaver::getWindowHeight (  )  const [virtual]

Returns the height of the App's window measured in pixels, or the screen when in full-screen mode.

Implements cinder::app::App.

void cinder::app::AppScreenSaver::setWindowHeight ( int  windowHeight  )  [virtual]

Ignored for ScreenSavers.

Implements cinder::app::App.

void cinder::app::AppScreenSaver::setWindowSize ( int  windowWidth,
int  windowHeight 
) [virtual]

Ignored for ScreenSavers.

Implements cinder::app::App.

float cinder::app::AppScreenSaver::getFrameRate (  )  const [virtual]

Returns the maximum frame-rate the App will attempt to maintain measured in frames-per-second.

Implements cinder::app::App.

void cinder::app::AppScreenSaver::setFrameRate ( float  frameRate  )  [virtual]

Sets the maximum frame-rate the App will attempt to maintain \ a frameRate frames-per-second.

Implements cinder::app::App.

bool cinder::app::AppScreenSaver::isFullScreen (  )  const [virtual]

Returns false if the ScreenSaver is running in preview mode, otherwise true.

Implements cinder::app::App.

virtual void cinder::app::AppScreenSaver::setFullScreen ( bool  fullScreen  )  [virtual]

Ignored for ScreenSavers.

Implements cinder::app::App.

virtual void cinder::app::AppScreenSaver::quit (  )  [virtual]

Ignored for ScreenSavers.

Implements cinder::app::App.

std::string cinder::app::AppScreenSaver::getAppPath (  )  [virtual]

Returns the path to the application on disk.

Implements cinder::app::App.

static void cinder::app::AppScreenSaver::executeLaunch ( AppScreenSaver app,
class Renderer renderer,
const char *  title 
) [static]
void cinder::app::AppScreenSaver::executeLaunch ( AppScreenSaver app,
class Renderer renderer,
const char *  title,
::HWND  hwnd 
) [static]
void cinder::app::AppScreenSaver::privateSetImpl__ ( void *  impl  ) 
void cinder::app::AppScreenSaver::launch ( ::HWND  hwnd  ) 
virtual bool cinder::app::AppScreenSaver::getsWindowsPaintEvents (  )  [virtual]

Implements cinder::app::App.

class AppImplMswScreenSaver* cinder::app::AppScreenSaver::getImpl (  ) 
virtual bool cinder::app::AppScreenSaver::receivesEvents (  )  const [virtual]

Reimplemented from cinder::app::App.

virtual void cinder::app::App::setup (  )  [virtual, inherited]

Override to perform any application setup after the Renderer has been initialized.

virtual void cinder::app::App::shutdown (  )  [virtual, inherited]

Override to perform any application cleanup before exiting.

virtual void cinder::app::App::update (  )  [virtual, inherited]

Override to perform any once-per-loop computation.

virtual void cinder::app::App::draw (  )  [virtual, inherited]

Override to perform any rendering once-per-loop or in response to OS-prompted requests for refreshes.

virtual void cinder::app::App::mouseDown ( MouseEvent  event  )  [virtual, inherited]

Override to receive mouse-down events.

virtual void cinder::app::App::mouseUp ( MouseEvent  event  )  [virtual, inherited]

Override to receive mouse-up events.

virtual void cinder::app::App::mouseWheel ( MouseEvent  event  )  [virtual, inherited]

Override to receive mouse-wheel events.

virtual void cinder::app::App::mouseMove ( MouseEvent  event  )  [virtual, inherited]

Override to receive mouse-move events.

virtual void cinder::app::App::mouseDrag ( MouseEvent  event  )  [virtual, inherited]

Override to receive mouse-drag events.

virtual void cinder::app::App::keyDown ( KeyEvent  event  )  [virtual, inherited]

Override to receive key-down events.

virtual void cinder::app::App::keyUp ( KeyEvent  event  )  [virtual, inherited]

Override to receive key-up events.

virtual void cinder::app::App::resize ( int  width,
int  height 
) [virtual, inherited]

Override to receive window resize events.

virtual void cinder::app::App::fileDrop ( FileDropEvent  event  )  [virtual, inherited]

Override to receive file-drop events.

void cinder::app::App::addListener ( Listener listener  )  [inherited]

Adds a Listener to the App's event listeners. The app deletes listener upon its own destruction unless it is removed via removeListener.

void cinder::app::App::removeListener ( Listener listener  )  [inherited]

Removes a listener from the App's event listeners. Does not delete listener.

Renderer* cinder::app::App::getRenderer (  )  const [inherited]
void cinder::app::App::setWindowSize ( const Vec2i size  )  [inherited]

Sets the size of the App's window. Ignored in full-screen mode.

Vec2f cinder::app::App::getWindowCenter (  )  const [inherited]

Returns the center of the App's window or the screen in full-screen mode.

Equivalent to

 Vec2f( getWindowWidth() * 0.5, getWindowHeight() * 0.5 ) 
Vec2i cinder::app::App::getWindowSize (  )  const [inherited]

Returns the size of the App's window or the screen in full-screen mode.

float cinder::app::App::getWindowAspectRatio (  )  const [inherited]

Returns the aspect ratio of the App's window or the screen in full-screen mode.

Area cinder::app::App::getWindowBounds (  )  const [inherited]

Returns the bounding area of the App's window or the screen in full-screen mode.

Equivalent to

float cinder::app::App::getAverageFps (  )  const [inherited]

Returns the average frame-rate attained by the App as measured in frames-per-second.

double cinder::app::App::getFpsSampleInterval (  )  const [inherited]

Returns the sampling rate in seconds for measuring the average frame-per-second as returned by getAverageFps().

void cinder::app::App::setFpsSampleInterval ( double  sampleInterval  )  [inherited]

Sets the sampling rate in seconds for measuring the average frame-per-second as returned by getAverageFps().

double cinder::app::App::getElapsedSeconds (  )  const [inherited]

Returns the number of seconds which have elapsed since application launch.

Reimplemented in cinder::app::AppCocoaTouch.

uint32_t cinder::app::App::getElapsedFrames (  )  const [inherited]

Returns the number of animation frames which have elapsed since application launch.

DataSourceRef cinder::app::App::loadResource ( const std::string &  macPath,
int  mswID,
const std::string &  mswType 
) [static, inherited]
DataSourcePathRef cinder::app::App::loadResource ( const std::string &  macPath  )  [static, inherited]
DataSourceBufferRef cinder::app::App::loadResource ( int  mswID,
const std::string &  mswType 
) [static, inherited]
string cinder::app::App::getResourcePath ( const std::string &  rsrcRelativePath  )  [inherited]
string cinder::app::App::getOpenFilePath ( const std::string &  initialPath = "",
std::vector< std::string >  extensions = std::vector<std::string>() 
) [inherited]

Presents the user with a file-open dialog and returns the selected file path.

The dialog optionally begins at the path initialPath and can be limited to allow selection of files ending in the extensions enumerated in extensions. If the active app is in full-screen mode it will temporarily switch to windowed-mode to present the dialog.

Returns:
the selected file path or an empty string if the user cancelled.
string cinder::app::App::getSaveFilePath ( const std::string &  initialPath = "",
std::vector< std::string >  extensions = std::vector<std::string>() 
) [inherited]

Presents the user with a file-save dialog and returns the selected file path.

The dialog optionally begins at the path initialPath and can be limited to allow selection of files ending in the extensions enumerated in extensions. If the active app is in full-screen mode it will temporarily switch to windowed-mode to present the dialog.

Returns:
the selected file path or an empty string if the user cancelled.
std::ostream & cinder::app::App::console (  )  [inherited]

Returns a reference to an output console, which is an alias to std::cout on the mac, and a wrapper around OutputDebugString on MSW.

Surface cinder::app::App::copyWindowSurface (  )  [inherited]
Returns:
a copy of the window's contents as a Surface8u
Surface cinder::app::App::copyWindowSurface ( const Area area  )  [inherited]
Returns:
a copy of the Area area from the window's contents as a Surface8u
void cinder::app::App::restoreWindowContext (  )  [inherited]

Restores the current rendering context to be the App's window or the screen in full-screen mode. Generally this is only necessary if the app has displayed a dialog box or some other external window.

static App* cinder::app::App::get (  )  [static, inherited]

Returns a pointer to the active App.

Reimplemented in cinder::app::AppBasic, and cinder::app::AppCocoaTouch.


The documentation for this class was generated from the following files: