clanapp.h
1 /*
2 ** ClanLib SDK
3 ** Copyright (c) 1997-2016 The ClanLib Team
4 **
5 ** This software is provided 'as-is', without any express or implied
6 ** warranty. In no event will the authors be held liable for any damages
7 ** arising from the use of this software.
8 **
9 ** Permission is granted to anyone to use this software for any purpose,
10 ** including commercial applications, and to alter it and redistribute it
11 ** freely, subject to the following restrictions:
12 **
13 ** 1. The origin of this software must not be misrepresented; you must not
14 ** claim that you wrote the original software. If you use this software
15 ** in a product, an acknowledgment in the product documentation would be
16 ** appreciated but is not required.
17 ** 2. Altered source versions must be plainly marked as such, and must not be
18 ** misrepresented as being the original software.
19 ** 3. This notice may not be removed or altered from any source distribution.
20 **
21 ** Note: Some of the libraries ClanLib may link to may have additional
22 ** requirements or restrictions.
23 **
24 ** File Author(s):
25 **
26 ** Magnus Norddahl
27 */
28 
29 #pragma once
30 
31 #include <vector>
32 #include <string>
33 #include <memory>
34 
35 namespace clan
36 {
39 
44  {
45  public:
46  virtual ~Application() { }
47 
52  virtual bool update() { return true; }
53 
55  static void use_timeout_timing(int timeout_ms);
56 
58  static const std::vector<std::string> &main_args();
59  };
60 
62  {
63  public:
64  ApplicationInstancePrivate(bool catch_exceptions = true);
65  virtual std::unique_ptr<Application> create() = 0;
66  };
67 
83  template<typename ApplicationClass>
85  {
86  public:
88  ApplicationInstance(bool catch_exceptions = true) : ApplicationInstancePrivate(catch_exceptions)
89  {
90  }
91 
92  private:
93  std::unique_ptr<Application> create() override
94  {
95  return std::unique_ptr<Application>(new ApplicationClass());
96  }
97  };
98 
100 }
virtual ~Application()
Definition: clanapp.h:46
Definition: clanapp.h:35
Helper class to create cross platform applications.
Definition: clanapp.h:84
static const std::vector< std::string > & main_args()
Returns the command line arguments passed to the application.
Base class for the application object.
Definition: clanapp.h:43
ApplicationInstance(bool catch_exceptions=true)
Constructor.
Definition: clanapp.h:88
ApplicationInstancePrivate(bool catch_exceptions=true)
virtual bool update()
Main loop update handler.
Definition: clanapp.h:52
static void use_timeout_timing(int timeout_ms)
Set update handler to wait a certain amount of milliseconds between each update.
Definition: clanapp.h:61
virtual std::unique_ptr< Application > create()=0