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
 */
int main(int, char**) {
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        std::cout << "SDL_Init Error: " << SDL_GetError() << std::endl;
        return 1;
    }
    std::cout << "SDL_Init OK!!!" << std::endl;
    SDL_Quit();

    return 0;
}

/*
${SDL2_ROOT}include
${SDL2_ROOT}VisualCWin32Debug
${SDL2_ROOT}VisualCWin32Release
SDL2.lib
SDL2main.lib
*/

2、设置库文件目录、依赖项目录、依赖项文件名。

点击菜单“项目“--->"属性”,在“配置”栏中的“所有配置”适合debug和release都相同的设置，不相同设置单独选择”debug”或”release”配置。上述代码中的${SDL2_ROOT} 替换为你本机实际目录。

• “配置”：“所有配置”--->“C/C++”--->“常规”--->“附加包含目录” ：${SDL2_ROOT}include
• “配置”：“所有配置”--->“”链接器“--->”输入“--->”附加依赖项“： SDL2.lib、SDL2main.lib
• “配置”：”Debug”--->“”链接器“--->”常规”--->”附加库目录“： ${SDL2_ROOT}VisualCWin32Debug
• “配置”：”Release”--->“”链接器“--->”常规”--->”附加库目录“： ${SDL2_ROOT}VisualCWin32Release
• 拷贝对应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()函数？