mirror of
				https://github.com/libsdl-org/SDL.git
				synced 2025-11-04 09:44:35 +00:00 
			
		
		
		
	Updates SDL_SetEventFilter code snippet to SDL3
SDL_EventFilter points to a function that now returns a bool
This commit is contained in:
		@@ -242,7 +242,7 @@ not give you any processing time after the events are delivered.
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
e.g.
 | 
					e.g.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    int HandleAppEvents(void *userdata, SDL_Event *event)
 | 
					    bool HandleAppEvents(void *userdata, SDL_Event *event)
 | 
				
			||||||
    {
 | 
					    {
 | 
				
			||||||
        switch (event->type)
 | 
					        switch (event->type)
 | 
				
			||||||
        {
 | 
					        {
 | 
				
			||||||
@@ -250,12 +250,12 @@ e.g.
 | 
				
			|||||||
            /* Terminate the app.
 | 
					            /* Terminate the app.
 | 
				
			||||||
               Shut everything down before returning from this function.
 | 
					               Shut everything down before returning from this function.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_LOW_MEMORY:
 | 
					        case SDL_EVENT_LOW_MEMORY:
 | 
				
			||||||
            /* You will get this when your app is paused and iOS wants more memory.
 | 
					            /* You will get this when your app is paused and iOS wants more memory.
 | 
				
			||||||
               Release as much memory as possible.
 | 
					               Release as much memory as possible.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_WILL_ENTER_BACKGROUND:
 | 
					        case SDL_EVENT_WILL_ENTER_BACKGROUND:
 | 
				
			||||||
            /* Prepare your app to go into the background.  Stop loops, etc.
 | 
					            /* Prepare your app to go into the background.  Stop loops, etc.
 | 
				
			||||||
               This gets called when the user hits the home button, or gets a call.
 | 
					               This gets called when the user hits the home button, or gets a call.
 | 
				
			||||||
@@ -264,15 +264,15 @@ e.g.
 | 
				
			|||||||
               in addition, you should set the render target to NULL, if you're using
 | 
					               in addition, you should set the render target to NULL, if you're using
 | 
				
			||||||
               it, e.g. call SDL_SetRenderTarget(renderer, NULL).
 | 
					               it, e.g. call SDL_SetRenderTarget(renderer, NULL).
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_DID_ENTER_BACKGROUND:
 | 
					        case SDL_EVENT_DID_ENTER_BACKGROUND:
 | 
				
			||||||
            /* Your app is NOT active at this point. */
 | 
					            /* Your app is NOT active at this point. */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_WILL_ENTER_FOREGROUND:
 | 
					        case SDL_EVENT_WILL_ENTER_FOREGROUND:
 | 
				
			||||||
            /* This call happens when your app is coming back to the foreground.
 | 
					            /* This call happens when your app is coming back to the foreground.
 | 
				
			||||||
               Restore all your state here.
 | 
					               Restore all your state here.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_DID_ENTER_FOREGROUND:
 | 
					        case SDL_EVENT_DID_ENTER_FOREGROUND:
 | 
				
			||||||
            /* Restart your loops here.
 | 
					            /* Restart your loops here.
 | 
				
			||||||
               Your app is interactive and getting CPU again.
 | 
					               Your app is interactive and getting CPU again.
 | 
				
			||||||
@@ -283,10 +283,10 @@ e.g.
 | 
				
			|||||||
               event SDL_EVENT_RENDER_DEVICE_RESET and recreate your OpenGL context and
 | 
					               event SDL_EVENT_RENDER_DEVICE_RESET and recreate your OpenGL context and
 | 
				
			||||||
               restore your textures when you get it, or quit the app.
 | 
					               restore your textures when you get it, or quit the app.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        default:
 | 
					        default:
 | 
				
			||||||
            /* No special processing, add it to the event queue */
 | 
					            /* No special processing, add it to the event queue */
 | 
				
			||||||
            return 1;
 | 
					            return true;
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -65,7 +65,7 @@ not give you any processing time after the events are delivered.
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
e.g.
 | 
					e.g.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    int HandleAppEvents(void *userdata, SDL_Event *event)
 | 
					    bool HandleAppEvents(void *userdata, SDL_Event *event)
 | 
				
			||||||
    {
 | 
					    {
 | 
				
			||||||
        switch (event->type)
 | 
					        switch (event->type)
 | 
				
			||||||
        {
 | 
					        {
 | 
				
			||||||
@@ -73,37 +73,37 @@ e.g.
 | 
				
			|||||||
            /* Terminate the app.
 | 
					            /* Terminate the app.
 | 
				
			||||||
               Shut everything down before returning from this function.
 | 
					               Shut everything down before returning from this function.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_LOW_MEMORY:
 | 
					        case SDL_EVENT_LOW_MEMORY:
 | 
				
			||||||
            /* You will get this when your app is paused and iOS wants more memory.
 | 
					            /* You will get this when your app is paused and iOS wants more memory.
 | 
				
			||||||
               Release as much memory as possible.
 | 
					               Release as much memory as possible.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_WILL_ENTER_BACKGROUND:
 | 
					        case SDL_EVENT_WILL_ENTER_BACKGROUND:
 | 
				
			||||||
            /* Prepare your app to go into the background.  Stop loops, etc.
 | 
					            /* Prepare your app to go into the background.  Stop loops, etc.
 | 
				
			||||||
               This gets called when the user hits the home button, or gets a call.
 | 
					               This gets called when the user hits the home button, or gets a call.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_DID_ENTER_BACKGROUND:
 | 
					        case SDL_EVENT_DID_ENTER_BACKGROUND:
 | 
				
			||||||
            /* This will get called if the user accepted whatever sent your app to the background.
 | 
					            /* This will get called if the user accepted whatever sent your app to the background.
 | 
				
			||||||
               If the user got a phone call and canceled it, you'll instead get an SDL_EVENT_DID_ENTER_FOREGROUND event and restart your loops.
 | 
					               If the user got a phone call and canceled it, you'll instead get an SDL_EVENT_DID_ENTER_FOREGROUND event and restart your loops.
 | 
				
			||||||
               When you get this, you have 5 seconds to save all your state or the app will be terminated.
 | 
					               When you get this, you have 5 seconds to save all your state or the app will be terminated.
 | 
				
			||||||
               Your app is NOT active at this point.
 | 
					               Your app is NOT active at this point.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_WILL_ENTER_FOREGROUND:
 | 
					        case SDL_EVENT_WILL_ENTER_FOREGROUND:
 | 
				
			||||||
            /* This call happens when your app is coming back to the foreground.
 | 
					            /* This call happens when your app is coming back to the foreground.
 | 
				
			||||||
               Restore all your state here.
 | 
					               Restore all your state here.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        case SDL_EVENT_DID_ENTER_FOREGROUND:
 | 
					        case SDL_EVENT_DID_ENTER_FOREGROUND:
 | 
				
			||||||
            /* Restart your loops here.
 | 
					            /* Restart your loops here.
 | 
				
			||||||
               Your app is interactive and getting CPU again.
 | 
					               Your app is interactive and getting CPU again.
 | 
				
			||||||
            */
 | 
					            */
 | 
				
			||||||
            return 0;
 | 
					            return false;
 | 
				
			||||||
        default:
 | 
					        default:
 | 
				
			||||||
            /* No special processing, add it to the event queue */
 | 
					            /* No special processing, add it to the event queue */
 | 
				
			||||||
            return 1;
 | 
					            return true;
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user