/* Simple DirectMedia Layer Copyright (C) 1997-2022 Sam Lantinga This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution. */ #ifndef SDL_main_windows_h_ #define SDL_main_windows_h_ #if !defined(SDL_main_h_) #error "This header should not be included directly, but only via SDL_main.h!" #endif /* if someone wants to include SDL_main.h but doesn't want the main handing magic, (maybe to call SDL_RegisterApp()) they can #define SDL_MAIN_HANDLED first SDL_MAIN_NOIMPL is for SDL-internal usage (only affects implementation, not definition of SDL_MAIN_AVAILABLE etc in SDL_main.h) and if the user wants to have the SDL_main implementation (from this header) in another source file than their main() function, for example if SDL_main requires C++ and main() is implemented in plain C */ #if !defined(SDL_MAIN_HANDLED) && !defined(SDL_MAIN_NOIMPL) /* the implementations below must be able to use the implement real main(), nothing renamed (the user's main() will be renamed to SDL_main so it can be called from here) */ #ifdef main # undef main #endif /* main */ #if defined(__WIN32__) || defined(__GDK__) /* these defines/typedefs are needed for the WinMain() definition */ #ifndef WINAPI #define WINAPI __stdcall #endif #include #ifdef __cplusplus extern "C" { #endif typedef struct HINSTANCE__ * HINSTANCE; typedef char* LPSTR; #ifndef __GDK__ /* this is only needed for Win32 */ #if defined(_MSC_VER) /* The VC++ compiler needs main/wmain defined */ # define console_ansi_main main # if defined(UNICODE) && UNICODE # define console_wmain wmain # endif #endif #if defined( UNICODE ) && UNICODE /* This is where execution begins [console apps, unicode] */ int console_wmain(int argc, wchar_t *wargv[], wchar_t *wenvp) { return SDL_Win32RunApp(SDL_main, NULL); } #else /* ANSI */ /* This is where execution begins [console apps, ansi] */ int console_ansi_main(int argc, char *argv[]) { return SDL_Win32RunApp(SDL_main, NULL); } #endif /* UNICODE/ANSI */ #endif /* not __GDK__ */ /* This is where execution begins [windowed apps and GDK] */ int WINAPI WinMain(HINSTANCE hInst, HINSTANCE hPrev, LPSTR szCmdLine, int sw) { #ifdef __GDK__ return SDL_GDKRunApp(SDL_main, NULL); #else return SDL_Win32RunApp(SDL_main, NULL); #endif } #ifdef __cplusplus } /* extern "C" */ #endif #include /* end of __WIN32__ and __GDK__ impls */ #elif defined(__WINRT__) /* WinRT main based on SDL_winrt_main_NonXAML.cpp, placed in the public domain by David Ludwig 3/13/14 */ #include /* At least one file in any SDL/WinRT app appears to require compilation with C++/CX, otherwise a Windows Metadata file won't get created, and an APPX0702 build error can appear shortly after linking. The following set of preprocessor code forces this file to be compiled as C++/CX, which appears to cause Visual C++ 2012's build tools to create this .winmd file, and will help allow builds of SDL/WinRT apps to proceed without error. If other files in an app's project enable C++/CX compilation, then it might be possible for the .cpp file including SDL_main.h to be compiled without /ZW, for Visual C++'s build tools to create a winmd file, and for the app to build without APPX0702 errors. In this case, if SDL_WINRT_METADATA_FILE_AVAILABLE is defined as a C/C++ macro, then the #error (to force C++/CX compilation) will be disabled. Please note that /ZW can be specified on a file-by-file basis. To do this, right click on the file in Visual C++, click Properties, then change the setting through the dialog that comes up. */ #ifndef SDL_WINRT_METADATA_FILE_AVAILABLE #if !defined(__cplusplus) || !defined(__cplusplus_winrt) #error The C++ file that includes SDL_main.h must be compiled as C++ code with /ZW, otherwise build errors due to missing .winmd files can occur. #endif #endif /* Prevent MSVC++ from warning about threading models when defining our custom WinMain. The threading model will instead be set via a direct call to Windows::Foundation::Initialize (rather than via an attributed function). To note, this warning (C4447) does not seem to come up unless this file is compiled with C++/CX enabled (via the /ZW compiler flag). */ #ifdef _MSC_VER #pragma warning(disable : 4447) #endif /* Make sure the function to initialize the Windows Runtime gets linked in. */ #ifdef _MSC_VER #pragma comment(lib, "runtimeobject.lib") #endif int CALLBACK WinMain(HINSTANCE, HINSTANCE, LPSTR, int) { return SDL_WinRTRunApp(SDL_main, NULL); } /* end of WinRT impl */ #elif defined(__IOS__) || defined(__TVOS__) #include #ifdef __cplusplus extern "C" { #endif int main(int argc, char *argv[]) { return SDL_UIKitRunApp(argc, argv, SDL_main); } #ifdef __cplusplus } /* extern "C" */ #endif #include /* end of __IOS__ and __TVOS__ impls */ #elif defined(__3DS__) #include #ifdef __cplusplus extern "C" { #endif int main(int argc, char *argv[]) { return SDL_N3DSRunApp(argc, argv, SDL_main); } #ifdef __cplusplus } /* extern "C" */ #endif #include /* end of __3DS__ impl */ /* TODO: remaining platforms */ #endif /* __WIN32__ etc */ /* rename users main() function to SDL_main() so it can be called from the wrappers above */ #define main SDL_main #endif /* SDL_MAIN_HANDLED */ #endif /* SDL_main_windows_h_ */ /* vi: set ts=4 sw=4 expandtab: */