Application termination (Tier2) - GameCreators Forum

Author

Message

george++

AGK Tool Maker

16

Years of Service

User Offline

Joined: 13th May 2007

Location: Thessaloniki, Hellas

Posted: 7th Jan 2015 19:43 Edited at: 7th Jan 2015 19:43

Link

Do you have any idea of how I can exit an application when the user presses a virtual button?
ie:

+ Code Snippet

if (agk::GetVirtualButtonPressed(btn_exit))
  ???;

Back to top

Profile PM Email

Fluorescent

FPSC Reloaded TGC Backer

18

Years of Service

User Offline

Joined: 1st Aug 2005

Location: Stockholm, Sweden

Posted: 7th Jan 2015 19:53

Link

In the bottom of your code create a label called QuitGame: or similar. Then in your button press, do a GoTo QuitGame.

That should work. And you can under your label to cleanup if you need to.

Back to top

Profile PM

george++

AGK Tool Maker

16

Years of Service

User Offline

Joined: 13th May 2007

Location: Thessaloniki, Hellas

Posted: 7th Jan 2015 22:13 Edited at: 7th Jan 2015 23:25

Link

Thanks Fluorescent for your advice but I cannot imagine how this can be implemented in C++

Back to top

Profile PM Email

Fluorescent

FPSC Reloaded TGC Backer

18

Years of Service

User Offline

Joined: 1st Aug 2005

Location: Stockholm, Sweden

Posted: 8th Jan 2015 09:04

Link

Oops! Sorry didn't see that you where using C++.

Back to top

Profile PM

Lucas Tiridath

AGK Developer

15

Years of Service

User Offline

Joined: 28th Sep 2008

Location: Kings Langley, UK

Posted: 8th Jan 2015 09:12

Link

The quick and hacky way of doing this is simply to call std::exit(0), which will terminate execution immediately. However it wont necessarily do any cleanup, and so is not good practice.

Personally in my own projects (and I will admit this is AppGameKit V1 - so I don't know if it still applies the same to AppGameKit V2), I prefer to change the definition of the app class so that Loop() returns a bool. You can then modify each template to use the return value of Loop to decide whether to exit or not. This has to be done slightly differently for each platform, but on Windows, it would simply mean assigning the result of Loop to bExitLoop in Core.cpp. I hope that helps.

Back to top

Profile PM Email Website

george++

AGK Tool Maker

16

Years of Service

User Offline

Joined: 13th May 2007

Location: Thessaloniki, Hellas

Posted: 8th Jan 2015 18:16

Link

Quote: "You can then modify each template"

I suppose you suggest me to modify the Core.cpp file from this:

+ Code Snippet

	while (!bExitLoop)
	{
		if (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE))
		{
			if (msg.message == WM_QUIT) bExitLoop = true;
			TranslateMessage(&msg);
			DispatchMessage(&msg);
		}
		else
		{
			// call gApp each frame
			try
			{
				if (!agk::IsCapturingImage()) gApp.Loop();
			}
			catch (...)
			{
				uString err = agk::GetLastError();
				err.Prepend("Uncaught exception: \n\n");
				MessageBox(NULL, err.GetStr(), "Error", 0);
				bExitLoop = true;
			}
		}
	}

to this:

+ Code Snippet

	while (!bExitLoop)
	{
		if (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE))
		{
			if (msg.message == WM_QUIT) bExitLoop = true;
			TranslateMessage(&msg);
			DispatchMessage(&msg);
		}
		else
		{
			// call gApp each frame
			try
			{
				if (!agk::IsCapturingImage()) 
if (!gApp.Loop())
  break;
			}
			catch (...)
			{
				uString err = agk::GetLastError();
				err.Prepend("Uncaught exception: \n\n");
				MessageBox(NULL, err.GetStr(), "Error", 0);
				bExitLoop = true;
			}
		}
	}

Oh I missed this point. Surely it helps! Thanks a lot

Back to top

Profile PM Email

Lucas Tiridath

AGK Developer

15

Years of Service

User Offline

Joined: 28th Sep 2008

Location: Kings Langley, UK

Posted: 8th Jan 2015 19:11

Link

Great, looks like you've got the Windows one sorted out. Just bear in mind that the code will be different for the other platforms, if you're planning on porting to Android etc.

Anyhow glad it helped

. Let me know if you run into problems on any of the other platforms.

Back to top

Profile PM Email Website

Ancient Lady

Valued Member

20

Years of Service

User Offline

Joined: 17th Mar 2004

Location: Anchorage, Alaska, USA

Posted: 11th Jan 2015 00:54 Edited at: 11th Jan 2015 00:56

Link

This is the code I use to exit my Tier 2 WIP:

+ Code Snippet

void app::closeThisApp()
{
   // completely exit the app
#ifdef AGKWINDOWS
   PostQuitMessage(0);
#endif
#ifdef AGKIOS
   // forcing a quit in iOS is against recommended guidelines - use HOME button
   // the exit button is disabled on AGKIOS builds
   // but if you want to do so, this is the code
   agk::MasterReset();
   exit(0);
#endif
#ifdef IDE_ANDROID
   // similar to iOS, an exit button should not be done
   // but if you want to do so, this is the code
   agk::MasterReset();
   exit(0);
#endif
#ifdef IDE_MAC
   glfwCloseWindow();
#endif
}

You just work out something that checks somewhere in app::Loop for your exit button and then call the above function (which is defined in template.h like this):

#ifndef _H_APP
#define _H_APP

/////////////////////////////////////////
// CONSTANTS ////////////////////////////
/////////////////////////////////////////

#if defined(AGKWINDOWS) || defined(IDE_MAC)
#define DEVICE_WIDTH 960
#define DEVICE_HEIGHT 640
#define DEVICE_POS_X 32
#define DEVICE_POS_Y 32
#define FULLSCREEN false
#endif

// this is required by AGK for Mac and Windows
// but we will also use this ourselves
#define WINDOW_TITLE "<your app title here>"

// Link to AGK libraries
#include "agk.h"

/////////////////////////////////////////
// CLASS DEFINITION /////////////////////
/////////////////////////////////////////
class app
{
   public:
      // main vars
#ifdef IDE_MAC
      unsigned int m_DeviceWidth;
      unsigned int m_DeviceHeight;
#endif
   
   public:
#if defined(IDE_ANDROID) || defined(AGKIOS) || defined(IDE_MAC)
      // constructor
      app() {}

// destructor
      ~app() {}
#else
      // constructor
      app() {memset ( this, 0, sizeof(app));}
#endif
   
      // main app functions
      void Begin( void );
      void Loop( void );
      void End( void );

private:
      void closeThisApp();
};

extern app App;

#endif

// Allow us to use the LoadImage function name
#ifdef LoadImage
#undef LoadImage
#endif

+ Code Snippet

#ifndef _H_APP
#define _H_APP

/////////////////////////////////////////
// CONSTANTS ////////////////////////////
/////////////////////////////////////////

#if defined(AGKWINDOWS) || defined(IDE_MAC)
#define DEVICE_WIDTH 960
#define DEVICE_HEIGHT 640
#define DEVICE_POS_X 32
#define DEVICE_POS_Y 32
#define FULLSCREEN false
#endif

// this is required by AGK for Mac and Windows
// but we will also use this ourselves
#define WINDOW_TITLE "<your app title here>"

// Link to AGK libraries
#include "agk.h"

/////////////////////////////////////////
// CLASS DEFINITION /////////////////////
/////////////////////////////////////////
class app
{
   public:
      // main vars
#ifdef IDE_MAC
      unsigned int m_DeviceWidth;
      unsigned int m_DeviceHeight;
#endif
   
   public:
#if defined(IDE_ANDROID) || defined(AGKIOS) || defined(IDE_MAC)
      // constructor
      app() {}

      // destructor
      ~app() {}
#else
      // constructor
      app() {memset ( this, 0, sizeof(app));}
#endif
   
      // main app functions
      void Begin( void );
      void Loop( void );
      void End( void );

   private:
      void closeThisApp();
};

extern app App;

#endif

// Allow us to use the LoadImage function name
#ifdef LoadImage
#undef LoadImage
#endif

The code above also shows how you can use the same header/code files for all AppGameKit supported platforms.

Cheers,
Ancient Lady

Back to top

Profile PM

george++

AGK Tool Maker

16

Years of Service

User Offline

Joined: 13th May 2007

Location: Thessaloniki, Hellas

Posted: 11th Jan 2015 07:14

Link

Excellent solution Ancient Lady! thanks

Back to top

Profile PM Email

Lucas Tiridath

AGK Developer

15

Years of Service

User Offline

Joined: 28th Sep 2008

Location: Kings Langley, UK

Posted: 11th Jan 2015 09:07

Link

That's a nice solution AL. Out of interest, is app::End() called if you do that? Also you can remove the ifdefs from the constructor and destructor as Paul has confirmed that the memset is no longer needed.

Back to top

Profile PM Email Website

Ancient Lady

Valued Member

20

Years of Service

User Offline

Joined: 17th Mar 2004

Location: Anchorage, Alaska, USA

Posted: 11th Jan 2015 20:47

Link

Lucas, I did see Paul's confirmation of that. I just haven't made the changes in my code, yet. The code I posted was pretty much what I used in V1.

I based the 'closeThisApp' code on what happens when app::End is called. At least that is what I remember doing with this over a year ago.

I will have to revisit this and see if there are any changes in V2 that I need to take into account.

Cheers,
Ancient Lady

Back to top

Profile PM

unlikely

12

Years of Service

User Offline

Joined: 5th Mar 2012

Location: Ohio, USA

Posted: 12th Jan 2015 16:48

Link

Hey guys, I am under the impression that a "quit function" is not recommended (or maybe allowed) on all platforms? Certainly for the desktop platforms, but not mobile?

Back to top

Profile PM

george++

AGK Tool Maker

16

Years of Service

User Offline

Joined: 13th May 2007

Location: Thessaloniki, Hellas

Posted: 12th Jan 2015 16:58

Link

Actually you don't need a "quit" function due to the design of the new OS.
Just press the 'home' button on your phone and the application will be removed from your memory resources when the OS will decide for this (Win 8.xx series) or when the user will remove the application from the task list (Android and Apple?)

Back to top

Profile PM Email

unlikely

12

Years of Service

User Offline

Joined: 5th Mar 2012

Location: Ohio, USA

Posted: 12th Jan 2015 17:00

Link

Oh okay, wasn't aware Windows did this as well. Have never coded for Metro.

And yes, that's my point for mobile. I believe Apple *might* even reject an app with a "quit" function.

Using AppGameKit v2 T1 + T2!
Systems: Primary: Mac OS X 10.10
Secondary: Windows 7

Back to top

Profile PM

JimHawkins

14

Years of Service

User Offline

Joined: 26th Jul 2009

Location: Hull - UK

Posted: 12th Jan 2015 18:17

Link

That is ONLY true for Memtro apps, which can't produce with AppGameKit anyway.

Onwards and sometimes upwards

Back to top

Profile PM Website

Ancient Lady

Valued Member

20

Years of Service

User Offline

Joined: 17th Mar 2004

Location: Anchorage, Alaska, USA

Posted: 13th Jan 2015 03:48

Link

Yes, both iOS and Android deprecate a 'Close' button.

I have my code set up so that I can enable/disable this button in a config file.

Personally, and because I don't want assume that things are cleaned up as in latest iOS, I like a way to explicitly close an application.

If Google or Apple don't like the button, easy to fix and resubmit.

Cheers,
Ancient Lady

Back to top

Profile PM

Sorry your browser is not supported!

AppGameKit Classic Chat / Application termination (Tier2)