src/images/SkImageDecoder_ktx.cpp - platform/external/skia - Gitiles

 /*
  * Copyright 2014 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */

 #include "SkColorPriv.h"
 #include "SkImageDecoder.h"
 #include "SkImageGenerator.h"
 #include "SkPixelRef.h"
 #include "SkScaledBitmapSampler.h"
 #include "SkStream.h"
 #include "SkStreamPriv.h"
 #include "SkTypes.h"

 #include "ktx.h"
 #include "etc1.h"

 /////////////////////////////////////////////////////////////////////////////////////////


 /////////////////////////////////////////////////////////////////////////////////////////

 // KTX Image decoder
 // ---
 // KTX is a general texture data storage file format ratified by the Khronos Group. As an
 // overview, a KTX file contains all of the appropriate values needed to fully specify a
 // texture in an OpenGL application, including the use of compressed data.
 //
 // This decoder is meant to be used with an SkDiscardablePixelRef so that GPU backends
 // can sniff the data before creating a texture. If they encounter a compressed format
 // that they understand, they can then upload the data directly to the GPU. Otherwise,
 // they will decode the data into a format that Skia supports.

 class SkKTXImageDecoder : public SkImageDecoder {
 public:
     SkKTXImageDecoder() { }

     Format getFormat() const override {
         return kKTX_Format;
     }

 protected:
     Result onDecode(SkStream* stream, SkBitmap* bm, Mode) override;

 private:
     typedef SkImageDecoder INHERITED;
 };

 SkImageDecoder::Result SkKTXImageDecoder::onDecode(SkStream* stream, SkBitmap* bm, Mode mode) {
     // TODO: Implement SkStream::copyToData() that's cheap for memory and file streams
     SkAutoDataUnref data(SkCopyStreamToData(stream));
     if (nullptr == data) {
         return kFailure;
     }

     SkKTXFile ktxFile(data);
     if (!ktxFile.valid()) {
         return kFailure;
     }

     const unsigned short width = ktxFile.width();
     const unsigned short height = ktxFile.height();

     // Set a flag if our source is premultiplied alpha
     const SkString premulKey("KTXPremultipliedAlpha");
     const bool bSrcIsPremul = ktxFile.getValueForKey(premulKey) == SkString("True");

     // Setup the sampler...
     SkScaledBitmapSampler sampler(width, height, this->getSampleSize());

     // Determine the alpha of the bitmap...
     SkAlphaType alphaType = kOpaque_SkAlphaType;
     if (ktxFile.isRGBA8()) {
         if (this->getRequireUnpremultipliedColors()) {
             alphaType = kUnpremul_SkAlphaType;
             // If the client wants unpremul colors and we only have
             // premul, then we cannot honor their wish.
             if (bSrcIsPremul) {
                 return kFailure;
             }
         } else {
             alphaType = kPremul_SkAlphaType;
         }
     }

     // Search through the compressed formats to see if the KTX file is holding
     // compressed data
     bool ktxIsCompressed = false;
     SkTextureCompressor::Format ktxCompressedFormat;
     for (int i = 0; i < SkTextureCompressor::kFormatCnt; ++i) {
         SkTextureCompressor::Format fmt = static_cast<SkTextureCompressor::Format>(i);
         if (ktxFile.isCompressedFormat(fmt)) {
             ktxIsCompressed = true;
             ktxCompressedFormat = fmt;
             break;
         }
     }

     // If the compressed format is a grayscale image, then setup the bitmap properly...
     bool isCompressedAlpha = ktxIsCompressed &&
         ((SkTextureCompressor::kLATC_Format == ktxCompressedFormat) ||
          (SkTextureCompressor::kR11_EAC_Format == ktxCompressedFormat));

     // Set the image dimensions and underlying pixel type.
     if (isCompressedAlpha) {
         const int w = sampler.scaledWidth();
         const int h = sampler.scaledHeight();
         bm->setInfo(SkImageInfo::MakeA8(w, h));
     } else {
         const int w = sampler.scaledWidth();
         const int h = sampler.scaledHeight();
         bm->setInfo(SkImageInfo::MakeN32(w, h, alphaType));
     }

     if (SkImageDecoder::kDecodeBounds_Mode == mode) {
         return kSuccess;
     }

     // If we've made it this far, then we know how to grok the data.
     if (!this->allocPixelRef(bm, nullptr)) {
         return kFailure;
     }

     // Lock the pixels, since we're about to write to them...
     SkAutoLockPixels alp(*bm);

     if (isCompressedAlpha) {
         if (!sampler.begin(bm, SkScaledBitmapSampler::kGray, *this)) {
             return kFailure;
         }

         // Alpha data is only a single byte per pixel.
         int nPixels = width * height;
         SkAutoMalloc outRGBData(nPixels);
         uint8_t *outRGBDataPtr = reinterpret_cast<uint8_t *>(outRGBData.get());

         // Decode the compressed format
         const uint8_t *buf = reinterpret_cast<const uint8_t *>(ktxFile.pixelData());
         if (!SkTextureCompressor::DecompressBufferFromFormat(
                 outRGBDataPtr, width, buf, width, height, ktxCompressedFormat)) {
             return kFailure;
         }

         // Set each of the pixels...
         const int srcRowBytes = width;
         const int dstHeight = sampler.scaledHeight();
         const uint8_t *srcRow = reinterpret_cast<uint8_t *>(outRGBDataPtr);
         srcRow += sampler.srcY0() * srcRowBytes;
         for (int y = 0; y < dstHeight; ++y) {
             sampler.next(srcRow);
             srcRow += sampler.srcDY() * srcRowBytes;
         }

         return kSuccess;

     } else if (ktxFile.isCompressedFormat(SkTextureCompressor::kETC1_Format)) {
         if (!sampler.begin(bm, SkScaledBitmapSampler::kRGB, *this)) {
             return kFailure;
         }

         // ETC1 Data is encoded as RGB pixels, so we should extract it as such
         int nPixels = width * height;
         SkAutoMalloc outRGBData(nPixels * 3);
         uint8_t *outRGBDataPtr = reinterpret_cast<uint8_t *>(outRGBData.get());

         // Decode ETC1
         const uint8_t *buf = reinterpret_cast<const uint8_t *>(ktxFile.pixelData());
         if (!SkTextureCompressor::DecompressBufferFromFormat(
                 outRGBDataPtr, width*3, buf, width, height, SkTextureCompressor::kETC1_Format)) {
             return kFailure;
         }

         // Set each of the pixels...
         const int srcRowBytes = width * 3;
         const int dstHeight = sampler.scaledHeight();
         const uint8_t *srcRow = reinterpret_cast<uint8_t *>(outRGBDataPtr);
         srcRow += sampler.srcY0() * srcRowBytes;
         for (int y = 0; y < dstHeight; ++y) {
             sampler.next(srcRow);
             srcRow += sampler.srcDY() * srcRowBytes;
         }

         return kSuccess;

     } else if (ktxFile.isRGB8()) {

         // Uncompressed RGB data (without alpha)
         if (!sampler.begin(bm, SkScaledBitmapSampler::kRGB, *this)) {
             return kFailure;
         }

         // Just need to read RGB pixels
         const int srcRowBytes = width * 3;
         const int dstHeight = sampler.scaledHeight();
         const uint8_t *srcRow = reinterpret_cast<const uint8_t *>(ktxFile.pixelData());
         srcRow += sampler.srcY0() * srcRowBytes;
         for (int y = 0; y < dstHeight; ++y) {
             sampler.next(srcRow);
             srcRow += sampler.srcDY() * srcRowBytes;
         }

         return kSuccess;

     } else if (ktxFile.isRGBA8()) {

         // Uncompressed RGBA data

         // If we know that the image contains premultiplied alpha, then
         // we need to turn off the premultiplier
         SkScaledBitmapSampler::Options opts (*this);
         if (bSrcIsPremul) {
             SkASSERT(bm->alphaType() == kPremul_SkAlphaType);
             SkASSERT(!this->getRequireUnpremultipliedColors());

             opts.fPremultiplyAlpha = false;
         }

         if (!sampler.begin(bm, SkScaledBitmapSampler::kRGBA, opts)) {
             return kFailure;
         }

         // Just need to read RGBA pixels
         const int srcRowBytes = width * 4;
         const int dstHeight = sampler.scaledHeight();
         const uint8_t *srcRow = reinterpret_cast<const uint8_t *>(ktxFile.pixelData());
         srcRow += sampler.srcY0() * srcRowBytes;
         for (int y = 0; y < dstHeight; ++y) {
             sampler.next(srcRow);
             srcRow += sampler.srcDY() * srcRowBytes;
         }

         return kSuccess;
     }

     return kFailure;
 }

 ///////////////////////////////////////////////////////////////////////////////

 // KTX Image Encoder
 //
 // This encoder takes a best guess at how to encode the bitmap passed to it. If
 // there is an installed discardable pixel ref with existing PKM data, then we
 // will repurpose the existing ETC1 data into a KTX file. If the data contains
 // KTX data, then we simply return a copy of the same data. For all other files,
 // the underlying KTX library tries to do its best to encode the appropriate
 // data specified by the bitmap based on the config. (i.e. kAlpha8_Config will
 // be represented as a full resolution 8-bit image dump with the appropriate
 // OpenGL defines in the header).

 class SkKTXImageEncoder : public SkImageEncoder {
 protected:
     bool onEncode(SkWStream* stream, const SkBitmap& bm, int quality) override;

 private:
     virtual bool encodePKM(SkWStream* stream, const SkData *data);
     typedef SkImageEncoder INHERITED;
 };

 bool SkKTXImageEncoder::onEncode(SkWStream* stream, const SkBitmap& bitmap, int) {
     if (!bitmap.pixelRef()) {
         return false;
     }
     SkAutoDataUnref data(bitmap.pixelRef()->refEncodedData());

     // Is this even encoded data?
     if (data) {
         const uint8_t *bytes = data->bytes();
         if (etc1_pkm_is_valid(bytes)) {
             return this->encodePKM(stream, data);
         }

         // Is it a KTX file??
         if (SkKTXFile::is_ktx(bytes)) {
             return stream->write(bytes, data->size());
         }

         // If it's neither a KTX nor a PKM, then we need to
         // get at the actual pixels, so fall through and decompress...
     }

     return SkKTXFile::WriteBitmapToKTX(stream, bitmap);
 }

 bool SkKTXImageEncoder::encodePKM(SkWStream* stream, const SkData *data) {
     const uint8_t* bytes = data->bytes();
     SkASSERT(etc1_pkm_is_valid(bytes));

     etc1_uint32 width = etc1_pkm_get_width(bytes);
     etc1_uint32 height = etc1_pkm_get_height(bytes);

     // ETC1 Data is stored as compressed 4x4 pixel blocks, so we must make sure
     // that our dimensions are valid.
     if (width == 0 || (width & 3) != 0 || height == 0 || (height & 3) != 0) {
         return false;
     }

     // Advance pointer to etc1 data.
     bytes += ETC_PKM_HEADER_SIZE;

     return SkKTXFile::WriteETC1ToKTX(stream, bytes, width, height);
 }

 /////////////////////////////////////////////////////////////////////////////////////////
 DEFINE_DECODER_CREATOR(KTXImageDecoder);
 DEFINE_ENCODER_CREATOR(KTXImageEncoder);
 /////////////////////////////////////////////////////////////////////////////////////////

 static SkImageDecoder* sk_libktx_dfactory(SkStreamRewindable* stream) {
     if (SkKTXFile::is_ktx(stream)) {
         return new SkKTXImageDecoder;
     }
     return nullptr;
 }

 static SkImageDecoder::Format get_format_ktx(SkStreamRewindable* stream) {
     if (SkKTXFile::is_ktx(stream)) {
         return SkImageDecoder::kKTX_Format;
     }
     return SkImageDecoder::kUnknown_Format;
 }

 SkImageEncoder* sk_libktx_efactory(SkImageEncoder::Type t) {
     return (SkImageEncoder::kKTX_Type == t) ? new SkKTXImageEncoder : nullptr;
 }

 static SkImageDecoder_DecodeReg gReg(sk_libktx_dfactory);
 static SkImageDecoder_FormatReg gFormatReg(get_format_ktx);
 static SkImageEncoder_EncodeReg gEReg(sk_libktx_efactory);
	/*
	* Copyright 2014 Google Inc.
	*
	* Use of this source code is governed by a BSD-style license that can be
	* found in the LICENSE file.
	*/

	#include "SkColorPriv.h"
	#include "SkImageDecoder.h"
	#include "SkImageGenerator.h"
	#include "SkPixelRef.h"
	#include "SkScaledBitmapSampler.h"
	#include "SkStream.h"
	#include "SkStreamPriv.h"
	#include "SkTypes.h"

	#include "ktx.h"
	#include "etc1.h"

	/////////////////////////////////////////////////////////////////////////////////////////


	/////////////////////////////////////////////////////////////////////////////////////////

	// KTX Image decoder
	// ---
	// KTX is a general texture data storage file format ratified by the Khronos Group. As an
	// overview, a KTX file contains all of the appropriate values needed to fully specify a
	// texture in an OpenGL application, including the use of compressed data.
	//
	// This decoder is meant to be used with an SkDiscardablePixelRef so that GPU backends
	// can sniff the data before creating a texture. If they encounter a compressed format
	// that they understand, they can then upload the data directly to the GPU. Otherwise,
	// they will decode the data into a format that Skia supports.

	class SkKTXImageDecoder : public SkImageDecoder {
	public:
	SkKTXImageDecoder() { }

	Format getFormat() const override {
	return kKTX_Format;
	}

	protected:
	Result onDecode(SkStream* stream, SkBitmap* bm, Mode) override;

	private:
	typedef SkImageDecoder INHERITED;
	};

	SkImageDecoder::Result SkKTXImageDecoder::onDecode(SkStream* stream, SkBitmap* bm, Mode mode) {
	// TODO: Implement SkStream::copyToData() that's cheap for memory and file streams
	SkAutoDataUnref data(SkCopyStreamToData(stream));
	if (nullptr == data) {
	return kFailure;
	}

	SkKTXFile ktxFile(data);
	if (!ktxFile.valid()) {
	return kFailure;
	}

	const unsigned short width = ktxFile.width();
	const unsigned short height = ktxFile.height();

	// Set a flag if our source is premultiplied alpha
	const SkString premulKey("KTXPremultipliedAlpha");
	const bool bSrcIsPremul = ktxFile.getValueForKey(premulKey) == SkString("True");

	// Setup the sampler...
	SkScaledBitmapSampler sampler(width, height, this->getSampleSize());

	// Determine the alpha of the bitmap...
	SkAlphaType alphaType = kOpaque_SkAlphaType;
	if (ktxFile.isRGBA8()) {
	if (this->getRequireUnpremultipliedColors()) {
	alphaType = kUnpremul_SkAlphaType;
	// If the client wants unpremul colors and we only have
	// premul, then we cannot honor their wish.
	if (bSrcIsPremul) {
	return kFailure;
	}
	} else {
	alphaType = kPremul_SkAlphaType;
	}
	}

	// Search through the compressed formats to see if the KTX file is holding
	// compressed data
	bool ktxIsCompressed = false;
	SkTextureCompressor::Format ktxCompressedFormat;
	for (int i = 0; i < SkTextureCompressor::kFormatCnt; ++i) {
	SkTextureCompressor::Format fmt = static_cast<SkTextureCompressor::Format>(i);
	if (ktxFile.isCompressedFormat(fmt)) {
	ktxIsCompressed = true;
	ktxCompressedFormat = fmt;
	break;
	}
	}

	// If the compressed format is a grayscale image, then setup the bitmap properly...
	bool isCompressedAlpha = ktxIsCompressed &&
	((SkTextureCompressor::kLATC_Format == ktxCompressedFormat) \|\|
	(SkTextureCompressor::kR11_EAC_Format == ktxCompressedFormat));

	// Set the image dimensions and underlying pixel type.
	if (isCompressedAlpha) {
	const int w = sampler.scaledWidth();
	const int h = sampler.scaledHeight();
	bm->setInfo(SkImageInfo::MakeA8(w, h));
	} else {
	const int w = sampler.scaledWidth();
	const int h = sampler.scaledHeight();
	bm->setInfo(SkImageInfo::MakeN32(w, h, alphaType));
	}

	if (SkImageDecoder::kDecodeBounds_Mode == mode) {
	return kSuccess;
	}

	// If we've made it this far, then we know how to grok the data.
	if (!this->allocPixelRef(bm, nullptr)) {
	return kFailure;
	}

	// Lock the pixels, since we're about to write to them...
	SkAutoLockPixels alp(*bm);

	if (isCompressedAlpha) {
	if (!sampler.begin(bm, SkScaledBitmapSampler::kGray, *this)) {
	return kFailure;
	}

	// Alpha data is only a single byte per pixel.
	int nPixels = width * height;
	SkAutoMalloc outRGBData(nPixels);
	uint8_t outRGBDataPtr = reinterpret_cast<uint8_t >(outRGBData.get());

	// Decode the compressed format
	const uint8_t buf = reinterpret_cast<const uint8_t >(ktxFile.pixelData());
	if (!SkTextureCompressor::DecompressBufferFromFormat(
	outRGBDataPtr, width, buf, width, height, ktxCompressedFormat)) {
	return kFailure;
	}

	// Set each of the pixels...
	const int srcRowBytes = width;
	const int dstHeight = sampler.scaledHeight();
	const uint8_t srcRow = reinterpret_cast<uint8_t >(outRGBDataPtr);
	srcRow += sampler.srcY0() * srcRowBytes;
	for (int y = 0; y < dstHeight; ++y) {
	sampler.next(srcRow);
	srcRow += sampler.srcDY() * srcRowBytes;
	}

	return kSuccess;

	} else if (ktxFile.isCompressedFormat(SkTextureCompressor::kETC1_Format)) {
	if (!sampler.begin(bm, SkScaledBitmapSampler::kRGB, *this)) {
	return kFailure;
	}

	// ETC1 Data is encoded as RGB pixels, so we should extract it as such
	int nPixels = width * height;
	SkAutoMalloc outRGBData(nPixels * 3);
	uint8_t outRGBDataPtr = reinterpret_cast<uint8_t >(outRGBData.get());

	// Decode ETC1
	const uint8_t buf = reinterpret_cast<const uint8_t >(ktxFile.pixelData());
	if (!SkTextureCompressor::DecompressBufferFromFormat(
	outRGBDataPtr, width*3, buf, width, height, SkTextureCompressor::kETC1_Format)) {
	return kFailure;
	}

	// Set each of the pixels...
	const int srcRowBytes = width * 3;
	const int dstHeight = sampler.scaledHeight();
	const uint8_t srcRow = reinterpret_cast<uint8_t >(outRGBDataPtr);
	srcRow += sampler.srcY0() * srcRowBytes;
	for (int y = 0; y < dstHeight; ++y) {
	sampler.next(srcRow);
	srcRow += sampler.srcDY() * srcRowBytes;
	}

	return kSuccess;

	} else if (ktxFile.isRGB8()) {

	// Uncompressed RGB data (without alpha)
	if (!sampler.begin(bm, SkScaledBitmapSampler::kRGB, *this)) {
	return kFailure;
	}

	// Just need to read RGB pixels
	const int srcRowBytes = width * 3;
	const int dstHeight = sampler.scaledHeight();
	const uint8_t srcRow = reinterpret_cast<const uint8_t >(ktxFile.pixelData());
	srcRow += sampler.srcY0() * srcRowBytes;
	for (int y = 0; y < dstHeight; ++y) {
	sampler.next(srcRow);
	srcRow += sampler.srcDY() * srcRowBytes;
	}

	return kSuccess;

	} else if (ktxFile.isRGBA8()) {

	// Uncompressed RGBA data

	// If we know that the image contains premultiplied alpha, then
	// we need to turn off the premultiplier
	SkScaledBitmapSampler::Options opts (*this);
	if (bSrcIsPremul) {
	SkASSERT(bm->alphaType() == kPremul_SkAlphaType);
	SkASSERT(!this->getRequireUnpremultipliedColors());

	opts.fPremultiplyAlpha = false;
	}

	if (!sampler.begin(bm, SkScaledBitmapSampler::kRGBA, opts)) {
	return kFailure;
	}

	// Just need to read RGBA pixels
	const int srcRowBytes = width * 4;
	const int dstHeight = sampler.scaledHeight();
	const uint8_t srcRow = reinterpret_cast<const uint8_t >(ktxFile.pixelData());
	srcRow += sampler.srcY0() * srcRowBytes;
	for (int y = 0; y < dstHeight; ++y) {
	sampler.next(srcRow);
	srcRow += sampler.srcDY() * srcRowBytes;
	}

	return kSuccess;
	}

	return kFailure;
	}

	///////////////////////////////////////////////////////////////////////////////

	// KTX Image Encoder
	//
	// This encoder takes a best guess at how to encode the bitmap passed to it. If
	// there is an installed discardable pixel ref with existing PKM data, then we
	// will repurpose the existing ETC1 data into a KTX file. If the data contains
	// KTX data, then we simply return a copy of the same data. For all other files,
	// the underlying KTX library tries to do its best to encode the appropriate
	// data specified by the bitmap based on the config. (i.e. kAlpha8_Config will
	// be represented as a full resolution 8-bit image dump with the appropriate
	// OpenGL defines in the header).

	class SkKTXImageEncoder : public SkImageEncoder {
	protected:
	bool onEncode(SkWStream* stream, const SkBitmap& bm, int quality) override;

	private:
	virtual bool encodePKM(SkWStream* stream, const SkData *data);
	typedef SkImageEncoder INHERITED;
	};

	bool SkKTXImageEncoder::onEncode(SkWStream* stream, const SkBitmap& bitmap, int) {
	if (!bitmap.pixelRef()) {
	return false;
	}
	SkAutoDataUnref data(bitmap.pixelRef()->refEncodedData());

	// Is this even encoded data?
	if (data) {
	const uint8_t *bytes = data->bytes();
	if (etc1_pkm_is_valid(bytes)) {
	return this->encodePKM(stream, data);
	}

	// Is it a KTX file??
	if (SkKTXFile::is_ktx(bytes)) {
	return stream->write(bytes, data->size());
	}

	// If it's neither a KTX nor a PKM, then we need to
	// get at the actual pixels, so fall through and decompress...
	}

	return SkKTXFile::WriteBitmapToKTX(stream, bitmap);
	}

	bool SkKTXImageEncoder::encodePKM(SkWStream* stream, const SkData *data) {
	const uint8_t* bytes = data->bytes();
	SkASSERT(etc1_pkm_is_valid(bytes));

	etc1_uint32 width = etc1_pkm_get_width(bytes);
	etc1_uint32 height = etc1_pkm_get_height(bytes);

	// ETC1 Data is stored as compressed 4x4 pixel blocks, so we must make sure
	// that our dimensions are valid.
	if (width == 0 \|\| (width & 3) != 0 \|\| height == 0 \|\| (height & 3) != 0) {
	return false;
	}

	// Advance pointer to etc1 data.
	bytes += ETC_PKM_HEADER_SIZE;

	return SkKTXFile::WriteETC1ToKTX(stream, bytes, width, height);
	}

	/////////////////////////////////////////////////////////////////////////////////////////
	DEFINE_DECODER_CREATOR(KTXImageDecoder);
	DEFINE_ENCODER_CREATOR(KTXImageEncoder);
	/////////////////////////////////////////////////////////////////////////////////////////

	static SkImageDecoder* sk_libktx_dfactory(SkStreamRewindable* stream) {
	if (SkKTXFile::is_ktx(stream)) {
	return new SkKTXImageDecoder;
	}
	return nullptr;
	}

	static SkImageDecoder::Format get_format_ktx(SkStreamRewindable* stream) {
	if (SkKTXFile::is_ktx(stream)) {
	return SkImageDecoder::kKTX_Format;
	}
	return SkImageDecoder::kUnknown_Format;
	}

	SkImageEncoder* sk_libktx_efactory(SkImageEncoder::Type t) {
	return (SkImageEncoder::kKTX_Type == t) ? new SkKTXImageEncoder : nullptr;
	}

	static SkImageDecoder_DecodeReg gReg(sk_libktx_dfactory);
	static SkImageDecoder_FormatReg gFormatReg(get_format_ktx);
	static SkImageEncoder_EncodeReg gEReg(sk_libktx_efactory);