異步加載并解析給定的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。