GLES2.0中文API-glCompressedTexImage2D

本文深入解析OpenGL中的glCompressedTexImage2D函数,介绍如何使用压缩格式定义二维纹理图像,涵盖参数说明、使用限制及错误处理等内容,适用于游戏开发、图形渲染等场景。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

名称

glCompressedTexImage2D - 以压缩格式指定二维纹理图像

C规范

void glCompressedTexImage2D(    GLenum target,
     GLint level,
     GLenum internalformat,
     GLsizei width,
     GLsizei height,
     GLint border,
     GLsizei imageSize,
     const GLvoid * data);

参数

target

指定活动纹理单元的目标纹理。必须是GL_TEXTURE_2DGL_TEXTURE_CUBE_MAP_POSITIVE_XGL_TEXTURE_CUBE_MAP_NEGATIVE_XGL_TEXTURE_CUBE_MAP_POSITIVE_YGL_TEXTURE_CUBE_MAP_NEGATIVE_YGL_TEXTURE_CUBE_MAP_POSITIVE_ZGL_TEXTURE_CUBE_MAP_NEGATIVE_Z

level

指定详细级别。 0级是基本图像级别。级别n是第n个mipmap缩小图像。

internalformat

指定存储在地址数据中的压缩图像数据的格式。

width

指定纹理图像的宽度。所有实现都支持至少64个纹素宽的2D纹理图像和至少16个纹素宽的立方体映射纹理图像。

height

指定纹理图像的高度。所有实现都支持至少64个纹素高的2D纹理图像和至少16个纹素高的立方体映射纹理图像。

border

指定边框的宽度。必须为0

imageSize

指定从data指定的地址开始的图像数据的无符号字节数。

data

指定指向内存中压缩图像数据的指针。

描述

纹理将指定纹理图像的一部分映射到纹理处于活动状态的每个图形基元上。当前片段着色器或顶点着色器使用内置纹理查找功能时,纹理处于活动状态。

glCompressedTexImage2D使用来自客户端内存的压缩图像数据定义二维纹理图像或立方体贴图纹理图像。根据定义指定内部格式的扩展规范来解码纹理图像。 OpenGL ES没有定义特定的压缩纹理格式,但确实提供了一种机制来获取扩展提供的这种格式的符号常量。通过查询GL_NUM_COMPRESSED_TEXTURE_FORMATS的值可以获得支持的压缩纹理格式的数量。支持的特定压缩纹理格式列表可以通过查询GL_COMPRESSED_TEXTURE_FORMATS的值来获得。

注意

GL实现可以选择以其选择的任何内部分辨率存储纹理数组。

glCompressedTexImage2D指定使用glActiveTexture指定的纹理单元的二维或立方体贴图纹理。

错误

GL_INVALID_ENUMtarget不是GL_TEXTURE_2DGL_TEXTURE_CUBE_MAP_POSITIVE_XGL_TEXTURE_CUBE_MAP_NEGATIVE_XGL_TEXTURE_CUBE_MAP_POSITIVE_YGL_TEXTURE_CUBE_MAP_NEGATIVE_YGL_TEXTURE_CUBE_MAP_POSITIVE_ZGL_TEXTURE_CUBE_MAP_NEGATIVE_Z

GL_INVALID_ENUMinternalformat不是GL_COMPRESSED_TEXTURE_FORMATS中返回的受支持格式

GL_INVALID_VALUElevel小于0

GL_INVALID_VALUElevel大于log 2 max,其中max是当目标是GL_TEXTURE_2DGL_MAX_TEXTURE_SIZE的返回值,或者当目标不是GL_TEXTURE_2DGL_MAX_CUBE_MAP_TEXTURE_SIZE

GL_INVALID_VALUE:当targetGL_TEXTURE_2DGL_MAX_TEXTURE_SIZE的宽度或高度小于或大于GL_MAX_TEXTURE_SIZE

GL_INVALID_VALUEborder不为0

GL_INVALID_VALUEimageSize与指定的压缩图像数据的格式,尺寸和内容不一致

GL_INVALID_OPERATION:特定纹理压缩扩展中指定的特定压缩内部格式不支持参数组合

如果数据的编码方式与定义内部压缩格式的扩展规范不一致,则会生成未定义的结果,包括异常的程序终止。

相关Gets

glGet 参数GL_NUM_COMPRESSED_TEXTURE_FORMATSGL_COMPRESSED_TEXTURE_FORMATS

glGet 参数GL_MAX_TEXTURE_SIZEGL_MAX_CUBE_MAP_TEXTURE_SIZE

另见

glActiveTextureglCompressedTexSubImage2DglCopyTexImage2DglCopyTexSubImage2DglTexImage2DglTexSubImage2DglTexParameter

版权

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glCompressedTexImage2D.xml

https://blog.youkuaiyun.com/flycatdeng

Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.

Android,OpenGL ES,图形学
### Android Studio 中配置支持 GLES 2.0 的硬件要求和设置方法 #### 硬件与软件需求 为了在 Android Studio 中成功运行基于 OpenGL ES (GLES) 2.0 的应用,开发者需要满足一定的硬件和软件条件。以下是具体的要求: - **操作系统**: Windows、macOS 或 Linux 均可作为开发平台[^1]。 - **处理器**: 推荐使用多核 CPU 并具备虚拟化技术的支持(Intel VT-x 或 AMD-V),以便更好地支持 AVD 虚拟设备中的 GPU 加速功能[^3]。 - **内存**: 至少 4GB RAM 是推荐的标准;如果计划同时运行多个模拟器实例,则建议更高的内存容量。 - **存储空间**: 安装 Android SDK 和 NDK 所需的空间取决于目标 API 版本以及所选组件的数量。 除了上述基本硬件规格外,还需要确认以下几点: - 已经安装最新版本的 Java Development Kit (JDK)。 - 下载并设置了完整的 Android SDK 包括 Google APIs 及其附加库。 #### 设置步骤详解 ##### 启用主机系统的硬件加速特性 对于大多数现代 PC 来说,默认情况下可能已经启用了必要的虚拟化选项。然而,在某些特定场景下仍需手动调整 BIOS/UEFI 设置来激活这些功能。例如 Intel 处理器用户应查找名为 “VT-d” 或者简单标记为 Virtualization Technology 的开关项将其打开。 ##### 创建兼容 GLES 2.0 的 AVD 当通过 Android Studio 构建新的虚拟装置时,请注意选择合适的系统映像(System Image),它决定了最终生成出来的仿真器能否正常加载 Open GL 图形渲染引擎。通常来说,带有“Google Play services”的 x86/x64 类型镜像是最佳候选对象之一因为它们往往集成了更先进的图形驱动程序从而提供更好的性能表现。 另外还需勾选启用 Host GPU 这一项参数以允许宿主机器上的物理显卡参与到图像处理过程中去进一步提升效率。 ```bash # 如果遇到错误提示类似于下面这样的日志信息, # 则可能是由于当前使用的 System Image 不完全适配或者存在其他潜在冲突所致。 E/AndroidRuntime(936): at android.opengl.GLSurfaceView$BaseConfigChooser.chooseConfig(GLSurfaceView.java:874) ``` 此时可以尝试更换不同架构的目标 ABI (armeabi-v7a vsr x86_64 etc.) 或者重新下载更新后的 system images 文件夹内的资源包直至问题得到解决为止[^2]。 ##### 编译链接阶段引入正确的依赖关系 最后一步就是在实际编码环节里正确声明对外部 native 层面接口调用的需求。这涉及到修改 build.gradle(project level & module level) 添加如下所示片段: ```gradle // Module-level Gradle file android { ... defaultConfig { ... externalNativeBuild { cmake { cppFlags "-frtti -fexceptions" arguments '-DANDROID_PLATFORM=android-21', '-DANDROID_TOOLCHAIN=clang', '-DANDROID_STL=c++_shared' } } } sourceSets.main{ jniLibs.srcDirs = ['libs'] } externalNativeBuild { cmake.path "CMakeLists.txt" } } ``` 以上脚本定义了 CMake 构造工具链的相关属性,并指定了 STL 库的形式采用共享模式(c++_shared),这对于许多高级别的跨平台框架而言都是不可或缺的部分。 --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值