opengl api android,[互联网]android OpenGL ES G10 APi.pdf

[互联网]android OpenGL ES G10 APi

javax.microedition.khronos.opengles

接口 GL10

上级接口：GL

下级接口：GL11

公共接口 GL10 继承于 GL

GL10 接口包含了 Java (TM )程序语言为OpenGL 绑定的核心功能。

OES_byte_coordinates,OES_single_precision,OES_fixed_point,OES_read_form

at, 以及OES_compressed_paletted_texture 等扩展功能也是这个接口的一部分。

一个以 x 或 xv 为后缀的方法是属于 OES_fixed_point 扩展功能的，并且需要一个或

更多的修正的点为参数。这些修正的点可能是浮点点派生出来的值通过乘以 65536

后再取最接近整数得到。

为了使用方便起见，这个接口记录了 OpenGL ES 各版本包括 1.1 及其扩展版本的

方法。当运行一个 OpenGL ES 1.0 的应用程序时，被标为“ (仅1.1)”可以被忽略。

查看 GL 接口描述，了解如何获取该接口实例。

方法的详细描述：

glActiveTexture

public void glActiveTexture(inttexture)

功能：

选择服务端活动的纹理单元

详细：glActiveTexture 选择哪一个纹理在后面的纹理状态改变时有效，纹理单元的

数量是依据该纹理单元所被支持的具体实现。在 OpenGL ES 1.0 中至少一个，在

OpenGL ES 1.1 中至少两个。

注意：

常常会这样 GL_TEXTUREi = GL_TEXTURE0 + i

一个纹理单元由纹理可用状态、纹理矩阵堆、纹理环境以及当前渲染纹理组成。修

改其中任一成分均会改变当前活动纹理单元。

点阵是客户端 GL 资源，它通过 glClientActiveTexture 程序获取。

错误：

当 0<= i < GL_MAX_TEXTURE_UNITS 时，如果纹理不是一个 GL_TEXTUREi，

GL_INVALID_ENUM (错误枚举)会产生。

相关获取：

利用 glGetIntegerv 处理 GL_MAX_TEXTURE_UNITS。

参数：

texture——指定哪一个纹理单元为活动。必须是一个 GL_TEXTUREi，其中 0 <= i <

GL_MAX_TEXTURE_UNITS，初始值为 GL_TEXTURE0。

glAlphaFunc

public void glAlphaFunc(intfunc,floatref)

功能：

指定 Alpha 测试功能。

详细：

Alpha 测试依据结果舍弃片段，该结果由引入片段的 alpha 值与参照值常量进行比

较得到。glAlphaFunc 指定参照值与比较方法。只有当 alpha 测试有效时，比较才

有用。使 alpha 测试有效或无效可以利用 glEnable 和 glDisable 方法，它们都是以

GL_ALPHA_TEST 为参数的，alpha 测试初始为无效。

func 与 ref 指明像素被绘出的条件。引入的 alpha 值通过 func 指明的方法与 ref 指

明的参照值进行比较。如果该值通过比较并且通过随后的模型测试与深度缓冲区测

试，则将引入的片段绘出。如果该值未通过比较，则该像素区的帧缓冲区不会发生

任何变化。比较方法如下：

GL_NEVER：不会通过。

GL_LESS：如果引入的alpha 值比参照值小则通过。

GL_EQUAL：如果引入的alpha 值与参照值相等则通过。

GL_LEQUAL：如果引入的alpha 值小于或等于参照值则通过。

GL_GREATER：如果引入的alpha 值比参照值大则通过。

GL_NOTEQUAL：如果引入的alpha 值与参照值不相等则通过。

GL_GEQUAL：如果引入的alpha 值大于或等于参照值则通过。

GL_ALWAYS：总是通过。(初始设定)

对所有的像素写入操作进行 glAlphaFunc 操作，包括那些从点、线、多边形的扫描

转换得到的结果。glAlphaFunc 对 glClear 无影响。

错误：

当func 不是被允许的值会产生 GL_INVALID_ENUM (错误枚举)。

参数：

func——指明 alpha 比较方法，被允许的符合常量有GL_NEVER,

GL_LESS,GL_EQUAL, GL_LEQUAL, GL_GREATER, GL_NOTEQUAL,

GL_GEQUAL, 和 GL_ALWAYS 。初始值为GL_ALW