206 lines
6.0 KiB
C
206 lines
6.0 KiB
C
/* -*- tab-width: 4; -*- */
|
|
/* vi: set sw=2 ts=4 expandtab: */
|
|
|
|
/* $Id: 3dd768b381113d67ca7e4bde10e6252900bff845 $ */
|
|
|
|
/*
|
|
* Copyright (c) 2010-2018 The Khronos Group Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
|
|
/*
|
|
* Author: Mark Callow from original code by Georg Kolling
|
|
*/
|
|
|
|
#ifndef KTXINT_H
|
|
#define KTXINT_H
|
|
|
|
/* Define this to include the ETC unpack software in the library. */
|
|
#ifndef SUPPORT_SOFTWARE_ETC_UNPACK
|
|
/* Include for all GL versions because have seen OpenGL ES 3
|
|
* implementaions that do not support ETC1 (ARM Mali emulator v1.0)!
|
|
*/
|
|
#define SUPPORT_SOFTWARE_ETC_UNPACK 1
|
|
#endif
|
|
|
|
#ifndef MAX
|
|
#define MAX(x, y) (((x) > (y)) ? (x) : (y))
|
|
#endif
|
|
|
|
#define KTX2_IDENTIFIER_REF { 0xAB, 0x4B, 0x54, 0x58, 0x20, 0x32, 0x30, 0xBB, 0x0D, 0x0A, 0x1A, 0x0A }
|
|
#define KTX2_HEADER_SIZE (64)
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @internal
|
|
* @brief used to pass GL context capabilites to subroutines.
|
|
*/
|
|
#define _KTX_NO_R16_FORMATS 0x0
|
|
#define _KTX_R16_FORMATS_NORM 0x1
|
|
#define _KTX_R16_FORMATS_SNORM 0x2
|
|
#define _KTX_ALL_R16_FORMATS (_KTX_R16_FORMATS_NORM | _KTX_R16_FORMATS_SNORM)
|
|
extern GLint _ktxR16Formats;
|
|
extern GLboolean _ktxSupportsSRGB;
|
|
|
|
/**
|
|
* @internal
|
|
* @~English
|
|
* @brief KTX file header
|
|
*
|
|
* See the KTX specification for descriptions
|
|
*/
|
|
typedef struct KTX_header {
|
|
ktx_uint8_t identifier[12];
|
|
ktx_uint32_t endianness;
|
|
ktx_uint32_t glType;
|
|
ktx_uint32_t glTypeSize;
|
|
ktx_uint32_t glFormat;
|
|
ktx_uint32_t glInternalformat;
|
|
ktx_uint32_t glBaseInternalformat;
|
|
ktx_uint32_t pixelWidth;
|
|
ktx_uint32_t pixelHeight;
|
|
ktx_uint32_t pixelDepth;
|
|
ktx_uint32_t numberOfArrayElements;
|
|
ktx_uint32_t numberOfFaces;
|
|
ktx_uint32_t numberOfMipmapLevels;
|
|
ktx_uint32_t bytesOfKeyValueData;
|
|
} KTX_header;
|
|
|
|
/* This will cause compilation to fail if the struct size doesn't match */
|
|
typedef int KTX_header_SIZE_ASSERT [sizeof(KTX_header) == KTX_HEADER_SIZE];
|
|
|
|
/**
|
|
* @internal
|
|
* @~English
|
|
* @brief Structure for supplemental information about the texture.
|
|
*
|
|
* _ktxCheckHeader returns supplemental information about the texture in this
|
|
* structure that is derived during checking of the file header.
|
|
*/
|
|
typedef struct KTX_supplemental_info
|
|
{
|
|
ktx_uint8_t compressed;
|
|
ktx_uint8_t generateMipmaps;
|
|
ktx_uint16_t textureDimension;
|
|
} KTX_supplemental_info;
|
|
/**
|
|
* @internal
|
|
* @var ktx_uint8_t KTX_supplemental_info::compressed
|
|
* @~English
|
|
* @brief KTX_TRUE, if this a compressed texture, KTX_FALSE otherwise?
|
|
*/
|
|
/**
|
|
* @internal
|
|
* @var ktx_uint8_t KTX_supplemental_info::generateMipmaps
|
|
* @~English
|
|
* @brief KTX_TRUE, if mipmap generation is required, KTX_FALSE otherwise.
|
|
*/
|
|
/**
|
|
* @internal
|
|
* @var ktx_uint16_t KTX_supplemental_info::textureDimension
|
|
* @~English
|
|
* @brief The number of dimensions, 1, 2 or 3, of data in the texture image.
|
|
*/
|
|
|
|
/*
|
|
* @internal
|
|
* CheckHeader
|
|
*
|
|
* Reads the KTX file header and performs some sanity checking on the values
|
|
*/
|
|
KTX_error_code _ktxCheckHeader(KTX_header* pHeader,
|
|
KTX_supplemental_info* pSuppInfo);
|
|
|
|
/*
|
|
* SwapEndian16: Swaps endianness in an array of 16-bit values
|
|
*/
|
|
void _ktxSwapEndian16(ktx_uint16_t* pData16, int count);
|
|
|
|
/*
|
|
* SwapEndian32: Swaps endianness in an array of 32-bit values
|
|
*/
|
|
void _ktxSwapEndian32(ktx_uint32_t* pData32, int count);
|
|
|
|
/*
|
|
* UnpackETC: uncompresses an ETC compressed texture image
|
|
*/
|
|
KTX_error_code _ktxUnpackETC(const GLubyte* srcETC, const GLenum srcFormat,
|
|
ktx_uint32_t active_width, ktx_uint32_t active_height,
|
|
GLubyte** dstImage,
|
|
GLenum* format, GLenum* internalFormat, GLenum* type,
|
|
GLint R16Formats, GLboolean supportsSRGB);
|
|
|
|
/*
|
|
* Pad nbytes to next multiple of n
|
|
*/
|
|
/* Equivalent to n * ceil(nbytes / n) */
|
|
#define _KTX_PADN(n, nbytes) (nbytes + (n-1) & ~(ktx_uint32_t)(n-1))
|
|
/*
|
|
* Calculate bytes of of padding needed to reach next multiple of n.
|
|
*/
|
|
/* Equivalent to (n * ceil(nbytes / n)) - nbytes */
|
|
#define _KTX_PADN_LEN(n, nbytes) ((n-1) - (nbytes + (n-1) & (n-1)))
|
|
|
|
/*
|
|
* Pad nbytes to next multiple of 4
|
|
*/
|
|
#define _KTX_PAD4(nbytes) _KTX_PADN(4, nbytes)
|
|
/*
|
|
* Calculate bytes of of padding needed to reach next multiple of 4.
|
|
*/
|
|
#define _KTX_PAD4_LEN(nbytes) _KTX_PADN_LEN(4, nbytes)
|
|
|
|
/*
|
|
* Pad nbytes to KTX_GL_UNPACK_ALIGNMENT
|
|
*/
|
|
#define _KTX_PAD_UNPACK_ALIGN(nbytes) \
|
|
_KTX_PADN(KTX_GL_UNPACK_ALIGNMENT, nbytes)
|
|
/*
|
|
* Calculate bytes of of padding needed to reach KTX_GL_UNPACK_ALIGNMENT.
|
|
*/
|
|
#define _KTX_PAD_UNPACK_ALIGN_LEN(nbytes) \
|
|
_KTX_PADN_LEN(KTX_GL_UNPACK_ALIGNMENT, nbytes)
|
|
|
|
/*
|
|
======================================
|
|
Internal ktxTexture functions
|
|
======================================
|
|
*/
|
|
|
|
KTX_error_code
|
|
ktxTexture_iterateLoadedImages(ktxTexture* This, PFNKTXITERCB iterCb,
|
|
void* userdata);
|
|
KTX_error_code
|
|
ktxTexture_iterateSourceImages(ktxTexture* This, PFNKTXITERCB iterCb,
|
|
void* userdata);
|
|
|
|
ktx_uint32_t ktxTexture_glTypeSize(ktxTexture* This);
|
|
ktx_size_t ktxTexture_imageSize(ktxTexture* This, ktx_uint32_t level);
|
|
ktx_bool_t ktxTexture_isActiveStream(ktxTexture* This);
|
|
ktx_size_t ktxTexture_levelSize(ktxTexture* This, ktx_uint32_t level);
|
|
ktx_size_t ktxTexture_faceLodSize(ktxTexture* This, ktx_uint32_t level);
|
|
void ktxTexture_rowInfo(ktxTexture* This, ktx_uint32_t level,
|
|
ktx_uint32_t* numRows, ktx_uint32_t* rowBytes,
|
|
ktx_uint32_t* rowPadding);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* KTXINT_H */
|