GLES3.0中文API-glDrawRangeElements

最新推荐文章于 2024-07-01 21:29:59 发布

原创最新推荐文章于 2024-07-01 21:29:59 发布 · 1.5k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#openglES3.0

glDrawRangeElements 是 OpenGL ES 3.0 中的一个函数，用于从数组数据渲染基元。它限制了 glDrawElements 的使用，要求索引值在指定范围内。此函数接受模式、起始索引、结束索引、元素数量、类型等参数。请注意，某些模式只在 GL ES 版本3.2及以上可用，且如果相关条件不满足，可能会触发错误。该函数与启用的数组配合工作，如果未启用所需的通用顶点属性数组，将从当前的通用属性状态获取相应的元素。

名称

glDrawRangeElements — 从数组数据渲染基元

C规范

void glDrawRangeElements( GLenum mode,
GLuint start,
GLuint end,
GLsizei count,
GLenum type,
const void * indices);

参数

mode
指定要渲染的原语类型。接受符号常量GL_POINTS，GL_LINE_STRIP，GL_LINE_LOOP，GL_LINES，GL_LINE_STRIP_ADJACENCY，GL_LINES_ADJACENCY，GL_TRIANGLE_STRIP，GL_TRIANGLE_FAN，GL_TRIANGLES，GL_TRIANGACE_STRIP_ADIP_AD_ACE

start
指定索引中包含的最小数组索引。

end
指定索引中包含的最大数组索引。

count
指定要渲染的元素数。

type
指定索引中值的类型。必须是GL_UNSIGNED_BYTE，GL_UNSIGNED_SHORT或GL_UNSIGNED_INT中的一种。

indices
指定绑定到GL_ELEMENT_ARRAY_BUFFER的缓冲区中的字节偏移量（转换为指针类型），以开始从中读取索引。如果没有绑定缓冲区，则指定指向索引存储位置的指针。

描述

glDrawRangeElements是glDrawElements的受限形式。 mode，count和type与glDrawElements的相应参数匹配，并具有额外的约束，即数组count中的所有值必须位于start和end之间（包括首尾）。

实现表示建议的最大顶点和索引数据量，可通过使用参数GL_MAX_ELEMENTS_VERTICES和GL_MAX_ELEMENTS_INDICES调用glGet来查询。如果end-start + 1大于GL_MAX_ELEMENTS_VERTICES的值，或者如果count大于GL_MAX_ELEMENTS_INDICES的值，则该调用可能会降低性能。不要求引用[start，end]范围内的所有顶点。但是，该实现可能会部分处理未使用的顶点，从而降低了使用最佳索引集可以实现的性能。

调用glDrawRangeElements时，它将使用启用数组中的count个顺序元素，从一开始就构建一个几何图元序列。模式指定了构造什么样的图元，以及数组元素如何构造这些图元。如果启用了多个阵列，则使用每个阵列。

要启用和禁用通用顶点属性数组，请调用glEnableVertexAttribArray和glDisableVertexAttribArray。

如果未启用与顶点着色器所需的通用属性相对应的数组，则将从当前的通用属性状态获取相应的元素。

注意

GL_LINE_STRIP_ADJACENCY，GL_LINES_ADJACENCY，GL_TRIANGLE_STRIP_ADJACENCY，GL_TRIANGLES_ADJACENCY和GL_PATCHES仅在GL ES版本为3.2或更高版本时可用。

错误

索引超出[start，end]范围是错误的，但是实现可能不会检查这种情况。这样的索引导致依赖于实现的行为。

如果mode不被接受，则生成GL_INVALID_ENUM。

如果计数为负，则生成GL_INVALID_VALUE。

如果end <start，则生成GL_INVALID_VALUE。

如果将非零缓冲区对象名称绑定到已启用的数组或元素数组，并且当前已映射缓冲区对象的数据存储，则将生成GL_INVALID_OPERATION。

如果当前绑定的帧缓冲区未完成帧缓冲区（即glCheckFramebufferStatus的返回值不是GL_FRAMEBUFFER_COMPLETE），则会生成GL_INVALID_FRAMEBUFFER_OPERATION。

如果转换反馈处于活动状态且未暂停，则生成GL_INVALID_OPERATION。

如果几何着色器处于活动状态，并且模式与当前安装的程序对象中的几何着色器的输入基本类型不兼容，则生成GL_INVALID_OPERATION。

API支持版本

函数名	2.0	3.0	3.1	3.2
glDrawRangeElements	-	✔	✔	✔

另见

glCheckFramebufferStatus, glDisableVertexAttribArray, glDrawArrays, glDrawElements, glDrawArraysInstanced, glDrawElementsInstanced, glEnableVertexAttribArray,

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3/html/glDrawRangeElements.xhtml
Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2015 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.