Added new hook-methods, added more information to the example_plugin

- Split up the WUPS includes into multiple seperate files, renamed some structs
- Added the hooks functions. (INITIALIZE_PLUGIN, DEINITIALIZE_PLUGIN, ON_VYSNC, ON_APP_STATUS_CHANGED, ON_APPLICATION_ENDING). INITIALZE is now "ON_APPLICATION_START". See the example for more information.
- Updated all plugins to fit the new hook. Some profit of the new hooks and are simpler now. (For example SwipSwapMe doesn't need to check if it's the first boot)
- arguments of the ON_APPLICATION_START have changed. It's not a pointer anymore and now has the boolean fields sd_mounted/usb_mounted which indicate if the device was mounted and it available via sd:/ or usb:/
- Some minor cleanups and formatting.

plugins/example_plugin/src/main.cpp

@@ -6,21 +6,120 @@
 #include "dynamic_libs/fs_functions.h"
 #include "utils/logger.h"
 
+/**
+    Mandatory plugin information.
+    If not set correctly, the loader will refuse to use the plugin.
+**/
 WUPS_PLUGIN_NAME("Example plugin");
 WUPS_PLUGIN_DESCRIPTION("This is just an example plugin and will log the FSOpenFile function.");
 WUPS_PLUGIN_VERSION("v1.0");
 WUPS_PLUGIN_AUTHOR("Maschell");
 WUPS_PLUGIN_LICENSE("BSD");
 
-INITIALIZE(args){
+/**
+    All of this defines can be used in ANY file.
+    It's possible to split it up into multiple files.
+
+**/
+
+/**
+    Get's called ONCE when the loader exits, but BEFORE the ON_APPLICATION_START gets called or functions are overridden.
+**/
+INITIALIZE_PLUGIN(){
+    // Initializes overlay and fs features in the background.
+	InitOSFunctionPointers();
+	InitSocketFunctionPointers();
+
+	log_init();
+	DEBUG_FUNCTION_LINE("INITIALIZE_PLUGIN of example_plugin!\n");
+}
+
+/**
+    Gets called when the plugin loader is re-entered => when the plugin is unloaded. 
+	The overridden functions are restored before this is getting called.
+**/
+DEINITIALIZE_PLUGIN(){
+	InitOSFunctionPointers();
+	InitSocketFunctionPointers();
+
+	log_init();
+    DEBUG_FUNCTION_LINE("DEINITIALIZE_PLUGIN of example_plugin!\n");
+}
+
+/**
+    Gets called when an application starts.
+	This is called BEFORE the functions are overridden.
+	Make sure to initialize all functions you're using in the overridden functions!
+**/
+ON_APPLICATION_START(){
    InitOSFunctionPointers();
    InitSocketFunctionPointers();
    
    log_init();
 
-   log_print("Init of example_plugin!\n");
+   DEBUG_FUNCTION_LINE("ON_APPLICATION_START of example_plugin!\n");
 } 
 
+/**
+    Gets called when an application ends. A good place for freeing memory.
+**/
+ON_APPLICATION_ENDING(){
+    DEBUG_FUNCTION_LINE("ON_APPLICATION_ENDING of example_plugin!\n");
+}
+
+/**
+    Gets called on each frame.
+**/
+ON_VYSNC(){
+    DEBUG_FUNCTION_LINE("ON_VYSNC of example_plugin!\n");
+}
+
+/**
+Gets called whenever the application status changes.
+
+Possible values of "status":
+    WUPS_APP_STATUS_FOREGROUND,         App is now running in foreground
+    WUPS_APP_STATUS_BACKGROUND          App is now running in background
+    WUPS_APP_STATUS_CLOSED              App is going to be closed
+**/
+ON_APP_STATUS_CHANGED(status){
+	if(status == WUPS_APP_STATUS_FOREGROUND){
+		DEBUG_FUNCTION_LINE("ON_APP_STATUS_CHANGED of example_plugin! App is now in foreground\n");
+	} else if(status == WUPS_APP_STATUS_BACKGROUND){
+		DEBUG_FUNCTION_LINE("ON_APP_STATUS_CHANGED of example_plugin! App is now in background\n");
+	} else if(status == WUPS_APP_STATUS_CLOSED){
+		DEBUG_FUNCTION_LINE("ON_APP_STATUS_CHANGED of example_plugin! App is now going to be closed\n");
+	}
+}
+
+/**
+    This defines a function replacement.
+    It allows to replace the system function with an own function. 
+    So whenever a game / application calles an overridden function, your function gets called instead.
+    
+    Currently it's only possible to override functions that are loaded from .rpl files of OSv10 (00050010-1000400A).
+    
+    Signature of this macro:
+    DECL_FUNCTION(  RETURN_TYPE, ARBITRARY_NAME_OF_FUNCTION , ARGS_SEPERATED_BY_COMMA){
+        //Your code goes here.
+    }
+    
+    Within this macro, two more function get declare you can use.
+    my_ARBITRARY_NAME_OF_FUNCTION and real_FSOpenFile
+    
+    RETURN_TYPE my_ARBITRARY_NAME_OF_FUNCTION(ARGS_SEPERATED_BY_COMMA):
+        is just name of the function that gets declared in this macro. 
+        It has the same effect as calling the overridden function directly.
+    
+    RETURN_TYPE real_ARBITRARY_NAME_OF_FUNCTION(ARGS_SEPERATED_BY_COMMA):
+        is the name of the function, that leads to function that was overridden.
+        Use this to call the original function that will be overridden.
+        CAUTION: Other plugins may already have manipulated the the return value or arguments.
+        
+    
+    Use this macro for each function you want to override
+
+**/
 DECL_FUNCTION(int, FSOpenFile, FSClient *pClient, FSCmdBlock *pCmd, const char *path, const char *mode, int *handle, int error) {
     int result = real_FSOpenFile(pClient, pCmd, path, mode, handle, error);
     
@@ -28,4 +127,12 @@ DECL_FUNCTION(int, FSOpenFile, FSClient *pClient, FSCmdBlock *pCmd, const char *
     return result;
 }
 
-WUPS_MUST_REPLACE(FSOpenFile,WUPS_LOADER_LIBRARY_COREINIT, FSOpenFile);
+/**
+This tells the loader which functions from which library (.rpl) should be replaced with which function from this file.
+The list of possible libraries can be found in the wiki. (In general it's WUPS_LOADER_LIBRARY_ + the name of the RPL in caps lock)
+
+WUPS_MUST_REPLACE(FUNCTION_NAME_IN_THIS_FILE,   NAME_OF_LIB_WHICH_CONTAINS_THIS_FUNCTION,   NAME_OF_FUNCTION_TO_OVERRIDE)
+
+Define this for each function you want to override.
+**/
+WUPS_MUST_REPLACE(FSOpenFile,                   WUPS_LOADER_LIBRARY_COREINIT,               FSOpenFile);