异步加载并解析给定的KTX文件的URL,或者解析KTX文件的原始二进制数据。返回一个承诺,该承诺在加载后将解析为包含图像缓冲区、宽度、高度和格式的对象;如果URL未能加载或分析数据失败,则拒绝。使用xmlhttpRequest加载数据,这意味着为了向另一个来源发出请求,服务器必须启用跨来源资源共享(cors)头。
以下是KTX格式规范的一部分,但不受支持:
- Big-endian files
- Metadata
- 3D textures
- Texture Arrays
- Cubemaps
- Mipmaps
Parameters:
Example
// load a single URL asynchronously
bmgl.loadKTX('some/url').then(function(ktxData) {
var width = ktxData.width;
var height = ktxData.height;
var format = ktxData.internalFormat;
var arrayBufferView = ktxData.bufferView;
// use the data to create a texture
}).otherwise(function(error) {
// an error occurred
});
Throws
-
RuntimeError : 无效的KTX文件。
-
RuntimeError : 文件的结尾错误。
-
RuntimeError : glinternalformat不是有效的格式。
-
RuntimeError : 当纹理被压缩时,gltype必须为零。
-
RuntimeError : 压缩纹理的类型大小必须为1。
-
RuntimeError : 当纹理被压缩时,glformat必须为零。
-
RuntimeError : 不支持为压缩纹理生成mipmap。
-
RuntimeError : 基本内部格式必须与未压缩纹理的格式相同。
-
RuntimeError : 不支持3D纹理。
-
RuntimeError : 不支持纹理数组。
-
RuntimeError : 不支持cubemaps。