OpenGL头文件中平台特定的宏

Platform specific macros in OpenGL headers

本文关键字:平台 文件 OpenGL      更新时间:2023-10-16

我正在解析gl.h,我注意到一种非常不寻常的(至少对我来说)声明openGL函数的方式。下面是一个例子:

GLAPI void APIENTRY glEvalCoord1d( GLdouble u );
GLAPI void APIENTRY glEvalCoord1f( GLfloat u );
GLAPI void APIENTRY glEvalCoord1dv( const GLdouble *u );

显然,这些是返回类型为void的常规函数,但我的问题是关于GLAPI和APIENTRY宏的影响。这两个是特定于平台的,在头文件的开头声明:

/* GLAPI, part 1 (use WINGDIAPI, if defined) */
#if defined(__WIN32__) && defined(WINGDIAPI)
#  define GLAPI WINGDIAPI
#endif
/* GLAPI, part 2 */
#if !defined(GLAPI)
#  if defined(_MSC_VER)                        /* Microsoft Visual C++ */
#    define GLAPI __declspec(dllimport)
#  elif defined(__LCC__) && defined(__WIN32__) /* LCC-Win32 */
#    define GLAPI __stdcall
#  else                                        /* Others (e.g. MinGW, Cygwin, non-win32) */
#    define GLAPI extern
#  endif
#endif
/* APIENTRY */
#if !defined(APIENTRY)
#  if defined(__WIN32__)
#    define APIENTRY __stdcall
#  else
#    define APIENTRY
#  endif
#endif

我想做一个代码解析器,遍历头并列出它们的内容,所以我的问题是如何处理这些宏以及如何利用它们。

我对c++相当陌生,所以那些不规则的函数声明对我来说不熟悉。我发现__declspec(dllimport)和__stdcall基本上是MS的东西来处理win32 api和dll,我知道"extern"是什么意思,但对于APIENTRY的win32版本是我得到的__stdcall,但是"else"似乎没有定义APIENTRY到任何东西,这是否意味着它只是用什么代替APIENTRY ?

两者的区别是什么?

void glEvalCoord1d( GLdouble u );
__stdcall void __stdcall glEvalCoord1d( GLdouble u );

您可以使用预处理器完成此任务,如下所示:

gcc --nostdinc -E -DGLAPI="" -DAPIENTRY="" yourHeader.h > cleanedFile.h