SDL2使用VS C++應用入門及入口點函數

 

自上篇文章所述在VS C++生成SDL2庫文件，編寫簡單Hello World程序驗證庫文件。

 

1、使用Visual Studio 2019 創建一個終端控制台程序。

點擊“文件—新建—項目”，選擇“控制台應用”，輸入源代碼：

 test.cpp:

#include <iostream>
#include <SDL.h>

/*
 * Lesson 0: Test to make sure SDL is setup properly  6  */
int main(int, char**) {  8     if (SDL_Init(SDL_INIT_VIDEO) != 0) {  9         std::cout << "SDL_Init Error: " << SDL_GetError() << std::endl; 10         return 1; 11  } 12     std::cout << "SDL_Init OK!!!" << std::endl; 13  SDL_Quit(); 14 
    return 0; 16 } 17 
/*
${SDL2_ROOT}\include 20 ${SDL2_ROOT}\VisualC\Win32\Debug 21 ${SDL2_ROOT}\VisualC\Win32\Release 22 SDL2.lib 23 SDL2main.lib 24 */

 

2、設置庫文件目錄、依賴項目錄、依賴項文件名。

點擊菜單“項目“--->"屬性”,在“配置”欄中的“所有配置”適合debug和release都相同的設置，不相同設置單獨選擇”debug”或”release”配置。上述代碼中的${SDL2_ROOT} 替換為你本機實際目錄。

• “配置”：“所有配置”--->“C/C++”--->“常規”--->“附加包含目錄” ：${SDL2_ROOT}\include
• “配置”：“所有配置”--->“”鏈接器“--->”輸入“--->”附加依賴項“： SDL2.lib、SDL2main.lib
• “配置”：”Debug”--->“”鏈接器“--->”常規”--->”附加庫目錄“： ${SDL2_ROOT}\VisualC\Win32\Debug
• “配置”：”Release”--->“”鏈接器“--->”常規”--->”附加庫目錄“： ${SDL2_ROOT}\VisualC\Win32\Release
• 拷貝對應debug/release版本的SDL2.dll到對應EXE輸出目錄。

執行程序輸出結果，如圖：

 　　　　

 

3、補充說明：SDL2入口點函數（入口點符號）。

　　　　 

　　Test.cpp::main() 中"main"已在頭文件SDL_main.h中定義為宏，跟蹤宏生效的依賴關系如下 ：

　　　　main ---> SDL_main.h::109 ---> SDL_main.h::40 SDL_MAIN_AVAILABLE ---> SDL_main.h::40 __WIN32__ ---> SDL_platform.h::153 __WINDOWS__ ---> SDL_platform.h::149 WINAPI_FAMILY_WINRT ---> SDL_platform.h:: 139 ---> (…) 

　　Test.cpp 中"main"最終只會有兩種結果，而此示例代碼經過預處理后進行編譯前函數名實際為：SDL_main 。

 

　　　　條件==true ---> SDL_main()

　　　　條件==false ---> main()

 

 　　Test.cpp::main()不是程序的入口點函數，這是因WINDOWS平台C++程序對真實第一個入口點函數有定義，微軟官方文檔說明鏈接如下：

https://docs.microsoft.com/zh-cn/cpp/build/reference/entry-entry-point-symbol?view=vs-2019

 

　　由此可見，可分三種情況有三類真正的程序第一個入口函數，再經過固定流程調用指定函數。通過調試本示例分析，得到調用Test.cpp::main() 的函數在SDL_windows_main.c文件，而SDL_windows_main.c::19 執行undef main。

 

 

 

 

 SDL_windows_main.c源代碼文件如下：

/* Pop up an out of memory message, returns to Windows */
static BOOL
OutOfMemory(void)
{
    SDL_ShowSimpleMessageBox(SDL_MESSAGEBOX_ERROR, "Fatal Error", "Out of memory - aborting", NULL);
    return FALSE;
}

#if defined(_MSC_VER)
/* The VC++ compiler needs main/wmain defined */
# define console_ansi_main main
# if UNICODE
#  define console_wmain wmain
# endif
#endif

/* Gets the arguments with GetCommandLine, converts them to argc and argv
   and calls SDL_main */
static int
main_getcmdline(void)
{
    LPWSTR *argvw;
    char **argv;
    int i, argc, result;

    argvw = CommandLineToArgvW(GetCommandLineW(), &argc);
    if (argvw == NULL) {
        return OutOfMemory();
    }

    /* Parse it into argv and argc */
    argv = (char **)SDL_calloc(argc + 1, sizeof(*argv));
    if (!argv) {
        return OutOfMemory();
    }
    for (i = 0; i < argc; ++i) {
        argv[i] = WIN_WStringToUTF8(argvw[i]);
        if (!argv[i]) {
            return OutOfMemory();
        }
    }
    argv[i] = NULL;
    LocalFree(argvw);

    SDL_SetMainReady();

    /* Run the application main() code */
    result = SDL_main(argc, argv);

    /* Free argv, to avoid memory leak */
    for (i = 0; i < argc; ++i) {
        SDL_free(argv[i]);
    }
    SDL_free(argv);

    return result;
}

/* This is where execution begins [console apps, ansi] */
int
console_ansi_main(int argc, char *argv[])
{
    return main_getcmdline();
}


#if UNICODE
/* This is where execution begins [console apps, unicode] */
int
console_wmain(int argc, wchar_t *wargv[], wchar_t *wenvp)
{
    return main_getcmdline();
}
#endif

/* This is where execution begins [windowed apps] */
int WINAPI
WinMain(HINSTANCE hInst, HINSTANCE hPrev, LPSTR szCmdLine, int sw)
{
    return main_getcmdline();
}

#endif /* __WIN32__ */

/* vi: set ts=4 sw=4 expandtab: */

 SDL_windows_main.c源代碼經過預處理后，如下：

static BOOL
OutOfMemory(void)
{
    SDL_ShowSimpleMessageBox(SDL_MESSAGEBOX_ERROR, "Fatal Error", "Out of memory - aborting", ((void *)0));
    return 0;
}

static int
main_getcmdline(void)
{
    LPWSTR *argvw;
    char **argv;
    int i, argc, result;
    argvw = CommandLineToArgvW(GetCommandLineW(), &argc);
    if (argvw == ((void *)0)) {
        return OutOfMemory();
    }
    argv = (char **)SDL_calloc(argc + 1, sizeof(*argv));
    if (!argv) {
        return OutOfMemory();
    }
    for (i = 0; i < argc; ++i) {
        argv[i] = SDL_iconv_string("UTF-8", "UTF-16LE", (char *)(argvw[i]), (SDL_wcslen(argvw[i])+1)*sizeof(WCHAR));
        if (!argv[i]) {
            return OutOfMemory();
        }
    }
    argv[i] = ((void *)0);
    LocalFree(argvw);
    SDL_SetMainReady();
    result = SDL_main(argc, argv);
    for (i = 0; i < argc; ++i) {
        SDL_free(argv[i]);
    }
    SDL_free(argv);
    return result;
}
int
main(int argc, char *argv[])
{
    return main_getcmdline();
}
int
wmain(int argc, wchar_t *wargv[], wchar_t *wenvp)
{
    return main_getcmdline();
}

int __stdcall
WinMain(HINSTANCE hInst, HINSTANCE hPrev, LPSTR szCmdLine, int sw)
{
    return main_getcmdline();
}

 

　　經過以上分析后，大家有進一步理解了，本示例代碼是在WINDOWS平台下創建為控制台程序，程序是怎樣從入口點函數調用到應用層的Test.cpp::main()函數？