从零开始学习OpenGL ES之一补遗 – 代号

（注：本文是改写的）

 

在写第四部分文章时，当我使用了 glLightfv() 和 glLightf() 两种版本时，我突然意识到我还从来没有解释过OpenGL的命名规则。这部分应该属于第一部分，随OpenGL数据类型一起介绍。

 

在OpenGL中，没有使用任何参数并在函数尾不具有数据类型代号的函数只有一个：

    GL_ENUM error = glGetError();

 

另外，只具有一个参数（GL_ENUM） 而且不具有函数尾数据类型代号的函数有：

  glEnable (GL_COLOR_ARRAY) ;

 

大部分OpenGL函数都是适用于不止一种数据类型。这在普通版OpenGL中尤为明显，大部分函数都有至少半打变种，允许你传递诸如 GLshort , GLbyte , GLint , GLfloat , GLDouble ,或 GLfixed值或参考。在 OpenGL ES中，函数调用的变种和数据类型少得多。然而，OpenGL ES仍然遵循同样的命名规则，所以最好还是要理解这些数据类型代号的含义。

 

函数名后的第一或者第二个字母代表了数据类型。下面是说明：

  
  
  
  

   
   
   
   


   
   
   
   
b     GLbyte 

   
   
   
   


   
   
   
   
s     GLshort 

   
   
   
   


   
   
   
   
i     GLint 

   
   
   
   


   
   
   
   
f     GLfloat 

   
   
   
   


   
   
   
   
ub    GLubyte 

   
   
   
   


   
   
   
   
us    GLushort 

   
   
   
   


   
   
   
   
ui    GLuint 

   
   
   
   


  
  
  
  

 

所以 glFoof()需要传递一个 glFloat， 而 glFoos()则需要一个 GLshort 。

注意： 在常规 OpenGL中，后缀中可能还包括数字。这些数字代表需要的数据类型的数量。例如，函数glVertex3f()使用三个 GLfloat 。由于此命名模式大部分用于直接模式，而OpenGL ES并不支持，所以在OpenGL ES中你不会常见到这种命名规则，然而有些函数还是遵循这种规则的，例如， glColor3f() 。保持后缀中的数字可以使这两类API最大限度地兼容。

 

再回头看看第四部分，有时函数提供更通用的功能，如glLightf() 。你可以调用此函数设置指定光的不同属性。例如，你可以设定点光源的截止角或者光源在3D空间的位置。点光源截止角需要一个值，但光源位置需要三个值。

 

对于这类函数，通过在函数尾加上一个 v 来表示。如果你想要传递常规数据类型给OpenGL，那么你不要使用此后缀，而是直接传递数据类型值。但是，如果你想要传递不止一个OpenGL原生数据 类型（ 即第一部分列表中的数据类型），那么你需要将这些值放入数组中并将数组开始的指针传递给OpenGL。当你像这样传递参考值给 OpenGL 时，你想要在函数后加上v 后缀。

 

所以，回到第四部分的例子，当我们设置点光源的截止角时，我们使用了没有 -v的版本：

  glLightf (GL_LIGHT0, GL_SPOT_CUTOFF, 45.0 ) ;

 

而当我们传递光源位置时，它需要三个GLfloat s值，所以我们使用有v的版本：

    const
 GLfloat light0Position[ ] 
 = {0.0 , 10.0 , 10.0 , 0.0 }
;

  glLightfv (GL_LIGHT0, GL_POSITION, light0Position) ;