| // Copyright 2016 The SwiftShader Authors. All Rights Reserved. | 
 | // | 
 | // 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. | 
 |  | 
 | // Texture.h: Defines the abstract Texture class and its concrete derived | 
 | // classes Texture2D and TextureCubeMap. Implements GL texture objects and | 
 | // related functionality. [OpenGL ES 2.0.24] section 3.7 page 63. | 
 |  | 
 | #ifndef LIBGLESV2_TEXTURE_H_ | 
 | #define LIBGLESV2_TEXTURE_H_ | 
 |  | 
 | #include "Renderbuffer.h" | 
 | #include "common/Object.hpp" | 
 | #include "utilities.h" | 
 | #include "libEGL/Texture.hpp" | 
 | #include "common/debug.h" | 
 |  | 
 | #include <GLES2/gl2.h> | 
 |  | 
 | #include <vector> | 
 |  | 
 | namespace gl { class Surface; } | 
 |  | 
 | namespace es2 | 
 | { | 
 | class Sampler; | 
 |  | 
 | enum | 
 | { | 
 | 	IMPLEMENTATION_MAX_TEXTURE_LEVELS = sw::MIPMAP_LEVELS, | 
 | 	IMPLEMENTATION_MAX_TEXTURE_SIZE = 1 << (IMPLEMENTATION_MAX_TEXTURE_LEVELS - 1), | 
 | 	IMPLEMENTATION_MAX_3D_TEXTURE_SIZE = IMPLEMENTATION_MAX_TEXTURE_SIZE, | 
 | 	IMPLEMENTATION_MAX_CUBE_MAP_TEXTURE_SIZE = IMPLEMENTATION_MAX_TEXTURE_SIZE, | 
 | 	IMPLEMENTATION_MAX_ARRAY_TEXTURE_LAYERS = IMPLEMENTATION_MAX_TEXTURE_SIZE, | 
 | 	IMPLEMENTATION_MAX_RENDERBUFFER_SIZE = sw::OUTLINE_RESOLUTION, | 
 | }; | 
 |  | 
 | class ImageLevels | 
 | { | 
 | public: | 
 | 	inline const egl::Image* operator[](size_t index) const | 
 | 	{ | 
 | 		return (index < IMPLEMENTATION_MAX_TEXTURE_LEVELS) ? image[index] : nullptr; | 
 | 	} | 
 |  | 
 | 	inline egl::Image*& operator[](size_t index) | 
 | 	{ | 
 | 		if(index < IMPLEMENTATION_MAX_TEXTURE_LEVELS) | 
 | 		{ | 
 | 			return image[index]; | 
 | 		} | 
 |  | 
 | 		return getNullImage(); | 
 | 	} | 
 |  | 
 | 	inline void release() | 
 | 	{ | 
 | 		for(int i = 0; i < IMPLEMENTATION_MAX_TEXTURE_LEVELS; i++) | 
 | 		{ | 
 | 			if(image[i]) | 
 | 			{ | 
 | 				image[i]->release(); | 
 | 				image[i] = nullptr; | 
 | 			} | 
 | 		} | 
 | 	} | 
 |  | 
 | 	inline void unbind(const egl::Texture* texture) | 
 | 	{ | 
 | 		for(int i = 0; i < IMPLEMENTATION_MAX_TEXTURE_LEVELS; i++) | 
 | 		{ | 
 | 			if(image[i]) | 
 | 			{ | 
 | 				image[i]->unbind(texture); | 
 | 				image[i] = nullptr; | 
 | 			} | 
 | 		} | 
 | 	} | 
 |  | 
 | private: | 
 | 	egl::Image *image[IMPLEMENTATION_MAX_TEXTURE_LEVELS] = {}; | 
 |     static egl::Image*& getNullImage(); | 
 | }; | 
 |  | 
 | class Texture : public egl::Texture | 
 | { | 
 | public: | 
 | 	explicit Texture(GLuint name); | 
 |  | 
 | 	sw::Resource *getResource() const override; | 
 |  | 
 | 	virtual void addProxyRef(const Renderbuffer *proxy) = 0; | 
 | 	virtual void releaseProxy(const Renderbuffer *proxy) = 0; | 
 |  | 
 | 	virtual GLenum getTarget() const = 0; | 
 |  | 
 | 	bool setMinFilter(GLenum filter); | 
 | 	bool setMagFilter(GLenum filter); | 
 | 	bool setWrapS(GLenum wrap); | 
 | 	bool setWrapT(GLenum wrap); | 
 | 	bool setWrapR(GLenum wrap); | 
 | 	bool setMaxAnisotropy(GLfloat textureMaxAnisotropy); | 
 | 	bool setBaseLevel(GLint baseLevel); | 
 | 	bool setCompareFunc(GLenum compareFunc); | 
 | 	bool setCompareMode(GLenum compareMode); | 
 | 	void makeImmutable(GLsizei levels); | 
 | 	bool setMaxLevel(GLint maxLevel); | 
 | 	bool setMaxLOD(GLfloat maxLOD); | 
 | 	bool setMinLOD(GLfloat minLOD); | 
 | 	bool setSwizzleR(GLenum swizzleR); | 
 | 	bool setSwizzleG(GLenum swizzleG); | 
 | 	bool setSwizzleB(GLenum swizzleB); | 
 | 	bool setSwizzleA(GLenum swizzleA); | 
 |  | 
 | 	GLenum getMinFilter() const { return mMinFilter; } | 
 | 	GLenum getMagFilter() const { return mMagFilter; } | 
 | 	GLenum getWrapS() const { return mWrapS; } | 
 | 	GLenum getWrapT() const { return mWrapT; } | 
 | 	GLenum getWrapR() const { return mWrapR; } | 
 | 	GLfloat getMaxAnisotropy() const { return mMaxAnisotropy; } | 
 | 	GLint getBaseLevel() const { return mBaseLevel; } | 
 | 	GLenum getCompareFunc() const { return mCompareFunc; } | 
 | 	GLenum getCompareMode() const { return mCompareMode; } | 
 | 	GLboolean getImmutableFormat() const { return mImmutableFormat; } | 
 | 	GLsizei getImmutableLevels() const { return mImmutableLevels; } | 
 | 	GLint getMaxLevel() const { return mMaxLevel; } | 
 | 	GLfloat getMaxLOD() const { return mMaxLOD; } | 
 | 	GLfloat getMinLOD() const { return mMinLOD; } | 
 | 	GLenum getSwizzleR() const { return mSwizzleR; } | 
 | 	GLenum getSwizzleG() const { return mSwizzleG; } | 
 | 	GLenum getSwizzleB() const { return mSwizzleB; } | 
 | 	GLenum getSwizzleA() const { return mSwizzleA; } | 
 |  | 
 | 	virtual GLsizei getWidth(GLenum target, GLint level) const = 0; | 
 | 	virtual GLsizei getHeight(GLenum target, GLint level) const = 0; | 
 | 	virtual GLsizei getDepth(GLenum target, GLint level) const; | 
 | 	virtual GLint getFormat(GLenum target, GLint level) const = 0; | 
 | 	virtual int getTopLevel() const = 0; | 
 | 	virtual bool hasNonBaseLevels() const = 0; | 
 | 	virtual bool requiresSync() const = 0; | 
 |  | 
 | 	virtual bool isBaseLevelDefined() const = 0; | 
 | 	virtual bool isSamplerComplete(Sampler *sampler) const = 0; | 
 | 	virtual bool isCompressed(GLenum target, GLint level) const = 0; | 
 | 	virtual bool isDepth(GLenum target, GLint level) const = 0; | 
 |  | 
 | 	virtual Renderbuffer *getRenderbuffer(GLenum target, GLint level) = 0; | 
 | 	virtual egl::Image *getRenderTarget(GLenum target, unsigned int level) = 0; | 
 | 	egl::Image *createSharedImage(GLenum target, unsigned int level); | 
 | 	virtual bool isShared(GLenum target, unsigned int level) const = 0; | 
 |  | 
 | 	virtual void generateMipmaps() = 0; | 
 | 	virtual void copySubImage(GLenum target, GLint level, GLint xoffset, GLint yoffset, GLint zoffset, GLint x, GLint y, GLsizei width, GLsizei height, Renderbuffer *source) = 0; | 
 |  | 
 | protected: | 
 | 	~Texture() override; | 
 |  | 
 | 	void setImage(GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels, egl::Image *image); | 
 | 	void subImage(GLint xoffset, GLint yoffset, GLint zoffset, GLsizei width, GLsizei height, GLsizei depth, GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels, egl::Image *image); | 
 | 	void setCompressedImage(GLsizei imageSize, const void *pixels, egl::Image *image); | 
 | 	void subImageCompressed(GLint xoffset, GLint yoffset, GLint zoffset, GLsizei width, GLsizei height, GLsizei depth, GLenum format, GLsizei imageSize, const void *pixels, egl::Image *image); | 
 |  | 
 | 	bool copy(egl::Image *source, const sw::SliceRect &sourceRect, GLint xoffset, GLint yoffset, GLint zoffset, egl::Image *dest); | 
 |  | 
 | 	bool isMipmapFiltered(Sampler *sampler) const; | 
 |  | 
 | 	GLenum mMinFilter; | 
 | 	GLenum mMagFilter; | 
 | 	GLenum mWrapS; | 
 | 	GLenum mWrapT; | 
 | 	GLenum mWrapR; | 
 | 	GLfloat mMaxAnisotropy; | 
 | 	GLint mBaseLevel; | 
 | 	GLenum mCompareFunc; | 
 | 	GLenum mCompareMode; | 
 | 	GLboolean mImmutableFormat; | 
 | 	GLsizei mImmutableLevels; | 
 | 	GLint mMaxLevel; | 
 | 	GLfloat mMaxLOD; | 
 | 	GLfloat mMinLOD; | 
 | 	GLenum mSwizzleR; | 
 | 	GLenum mSwizzleG; | 
 | 	GLenum mSwizzleB; | 
 | 	GLenum mSwizzleA; | 
 |  | 
 | 	sw::Resource *resource; | 
 | }; | 
 |  | 
 | class Texture2D : public Texture | 
 | { | 
 | public: | 
 | 	explicit Texture2D(GLuint name); | 
 |  | 
 | 	void addProxyRef(const Renderbuffer *proxy) override; | 
 | 	void releaseProxy(const Renderbuffer *proxy) override; | 
 | 	void sweep() override; | 
 |  | 
 | 	GLenum getTarget() const override; | 
 |  | 
 | 	GLsizei getWidth(GLenum target, GLint level) const override; | 
 | 	GLsizei getHeight(GLenum target, GLint level) const override; | 
 | 	GLint getFormat(GLenum target, GLint level) const override; | 
 | 	int getTopLevel() const override; | 
 | 	bool hasNonBaseLevels() const override; | 
 | 	bool requiresSync() const override; | 
 |  | 
 | 	void setImage(GLint level, GLsizei width, GLsizei height, GLint internalformat, GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels); | 
 | 	void setCompressedImage(GLint level, GLenum format, GLsizei width, GLsizei height, GLsizei imageSize, const void *pixels); | 
 | 	void subImage(GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels); | 
 | 	void subImageCompressed(GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLsizei imageSize, const void *pixels); | 
 | 	void copyImage(GLint level, GLenum internalformat, GLint x, GLint y, GLsizei width, GLsizei height, Renderbuffer *source); | 
 | 	void copySubImage(GLenum target, GLint level, GLint xoffset, GLint yoffset, GLint zoffset, GLint x, GLint y, GLsizei width, GLsizei height, Renderbuffer *source) override; | 
 |  | 
 | 	void setSharedImage(egl::Image *image); | 
 |  | 
 | 	bool isBaseLevelDefined() const override; | 
 | 	bool isSamplerComplete(Sampler *sampler) const override; | 
 | 	bool isCompressed(GLenum target, GLint level) const override; | 
 | 	bool isDepth(GLenum target, GLint level) const override; | 
 |  | 
 | 	void bindTexImage(gl::Surface *surface); | 
 | 	void releaseTexImage() override; | 
 |  | 
 | 	void generateMipmaps() override; | 
 |  | 
 | 	Renderbuffer *getRenderbuffer(GLenum target, GLint level) override; | 
 | 	egl::Image *getRenderTarget(GLenum target, unsigned int level) override; | 
 | 	bool isShared(GLenum target, unsigned int level) const override; | 
 |  | 
 | 	egl::Image *getImage(unsigned int level); | 
 |  | 
 | protected: | 
 | 	~Texture2D() override; | 
 |  | 
 | 	bool isMipmapComplete() const; | 
 |  | 
 | 	ImageLevels image; | 
 |  | 
 | 	gl::Surface *mSurface; | 
 |  | 
 | 	// A specific internal reference count is kept for colorbuffer proxy references, | 
 | 	// because, as the renderbuffer acting as proxy will maintain a binding pointer | 
 | 	// back to this texture, there would be a circular reference if we used a binding | 
 | 	// pointer here. This reference count will cause the pointer to be set to null if | 
 | 	// the count drops to zero, but will not cause deletion of the Renderbuffer. | 
 | 	Renderbuffer *mColorbufferProxy; | 
 | 	unsigned int mProxyRefs; | 
 | }; | 
 |  | 
 | class Texture2DRect : public Texture2D | 
 | { | 
 | public: | 
 | 	explicit Texture2DRect(GLuint name); | 
 |  | 
 | 	GLenum getTarget() const override; | 
 |  | 
 | 	Renderbuffer *getRenderbuffer(GLenum target, GLint level) override; | 
 | }; | 
 |  | 
 | class TextureCubeMap : public Texture | 
 | { | 
 | public: | 
 | 	explicit TextureCubeMap(GLuint name); | 
 |  | 
 | 	void addProxyRef(const Renderbuffer *proxy) override; | 
 | 	void releaseProxy(const Renderbuffer *proxy) override; | 
 | 	void sweep() override; | 
 |  | 
 | 	GLenum getTarget() const override; | 
 |  | 
 | 	GLsizei getWidth(GLenum target, GLint level) const override; | 
 | 	GLsizei getHeight(GLenum target, GLint level) const override; | 
 | 	GLint getFormat(GLenum target, GLint level) const override; | 
 | 	int getTopLevel() const override; | 
 | 	bool hasNonBaseLevels() const override; | 
 | 	bool requiresSync() const override; | 
 |  | 
 | 	void setImage(GLenum target, GLint level, GLsizei width, GLsizei height, GLint internalformat, GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels); | 
 | 	void setCompressedImage(GLenum target, GLint level, GLenum format, GLsizei width, GLsizei height, GLsizei imageSize, const void *pixels); | 
 |  | 
 | 	void subImage(GLenum target, GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels); | 
 | 	void subImageCompressed(GLenum target, GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLsizei imageSize, const void *pixels); | 
 | 	void copyImage(GLenum target, GLint level, GLenum internalformat, GLint x, GLint y, GLsizei width, GLsizei height, Renderbuffer *source); | 
 | 	void copySubImage(GLenum target, GLint level, GLint xoffset, GLint yoffset, GLint zoffset, GLint x, GLint y, GLsizei width, GLsizei height, Renderbuffer *source) override; | 
 |  | 
 | 	bool isBaseLevelDefined() const override; | 
 | 	bool isSamplerComplete(Sampler *sampler) const override; | 
 | 	bool isCompressed(GLenum target, GLint level) const override; | 
 | 	bool isDepth(GLenum target, GLint level) const override; | 
 | 	void releaseTexImage() override; | 
 |  | 
 | 	void generateMipmaps() override; | 
 | 	void updateBorders(int level); | 
 |  | 
 | 	Renderbuffer *getRenderbuffer(GLenum target, GLint level) override; | 
 | 	egl::Image *getRenderTarget(GLenum target, unsigned int level) override; | 
 | 	bool isShared(GLenum target, unsigned int level) const override; | 
 |  | 
 | 	egl::Image *getImage(int face, unsigned int level); | 
 |  | 
 | 	bool isCubeComplete() const; | 
 |  | 
 | protected: | 
 | 	~TextureCubeMap() override; | 
 |  | 
 | private: | 
 | 	bool isMipmapCubeComplete() const; | 
 |  | 
 | 	// face is one of the GL_TEXTURE_CUBE_MAP_* enumerants. Returns nullptr on failure. | 
 | 	egl::Image *getImage(GLenum face, unsigned int level); | 
 |  | 
 | 	ImageLevels image[6]; | 
 |  | 
 | 	// A specific internal reference count is kept for colorbuffer proxy references, | 
 | 	// because, as the renderbuffer acting as proxy will maintain a binding pointer | 
 | 	// back to this texture, there would be a circular reference if we used a binding | 
 | 	// pointer here. This reference count will cause the pointer to be set to null if | 
 | 	// the count drops to zero, but will not cause deletion of the Renderbuffer. | 
 | 	Renderbuffer *mFaceProxies[6]; | 
 | 	unsigned int mFaceProxyRefs[6]; | 
 | }; | 
 |  | 
 | class Texture3D : public Texture | 
 | { | 
 | public: | 
 | 	explicit Texture3D(GLuint name); | 
 |  | 
 | 	void addProxyRef(const Renderbuffer *proxy) override; | 
 | 	void releaseProxy(const Renderbuffer *proxy) override; | 
 | 	void sweep() override; | 
 |  | 
 | 	GLenum getTarget() const override; | 
 |  | 
 | 	GLsizei getWidth(GLenum target, GLint level) const override; | 
 | 	GLsizei getHeight(GLenum target, GLint level) const override; | 
 | 	GLsizei getDepth(GLenum target, GLint level) const override; | 
 | 	GLint getFormat(GLenum target, GLint level) const override; | 
 | 	int getTopLevel() const override; | 
 | 	bool hasNonBaseLevels() const override; | 
 | 	bool requiresSync() const override; | 
 |  | 
 | 	void setImage(GLint level, GLsizei width, GLsizei height, GLsizei depth, GLint internalformat, GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels); | 
 | 	void setCompressedImage(GLint level, GLenum format, GLsizei width, GLsizei height, GLsizei depth, GLsizei imageSize, const void *pixels); | 
 | 	void subImage(GLint level, GLint xoffset, GLint yoffset, GLint zoffset, GLsizei width, GLsizei height, GLsizei depth, GLenum format, GLenum type, const gl::PixelStorageModes &unpackParameters, const void *pixels); | 
 | 	void subImageCompressed(GLint level, GLint xoffset, GLint yoffset, GLint zoffset, GLsizei width, GLsizei height, GLsizei depth, GLenum format, GLsizei imageSize, const void *pixels); | 
 | 	void copyImage(GLint level, GLenum internalformat, GLint x, GLint y, GLint z, GLsizei width, GLsizei height, GLsizei depth, Renderbuffer *source); | 
 | 	void copySubImage(GLenum target, GLint level, GLint xoffset, GLint yoffset, GLint zoffset, GLint x, GLint y, GLsizei width, GLsizei height, Renderbuffer *source) override; | 
 |  | 
 | 	void setSharedImage(egl::Image *image); | 
 |  | 
 | 	bool isBaseLevelDefined() const override; | 
 | 	bool isSamplerComplete(Sampler *sampler) const override; | 
 | 	bool isCompressed(GLenum target, GLint level) const override; | 
 | 	bool isDepth(GLenum target, GLint level) const override; | 
 | 	void releaseTexImage() override; | 
 |  | 
 | 	void generateMipmaps() override; | 
 |  | 
 | 	Renderbuffer *getRenderbuffer(GLenum target, GLint level) override; | 
 | 	egl::Image *getRenderTarget(GLenum target, unsigned int level) override; | 
 | 	bool isShared(GLenum target, unsigned int level) const override; | 
 |  | 
 | 	egl::Image *getImage(unsigned int level); | 
 |  | 
 | protected: | 
 | 	~Texture3D() override; | 
 |  | 
 | 	bool isMipmapComplete() const; | 
 |  | 
 | 	ImageLevels image; | 
 |  | 
 | 	gl::Surface *mSurface; | 
 |  | 
 | 	// A specific internal reference count is kept for colorbuffer proxy references, | 
 | 	// because, as the renderbuffer acting as proxy will maintain a binding pointer | 
 | 	// back to this texture, there would be a circular reference if we used a binding | 
 | 	// pointer here. This reference count will cause the pointer to be set to null if | 
 | 	// the count drops to zero, but will not cause deletion of the Renderbuffer. | 
 | 	Renderbuffer *mColorbufferProxy; | 
 | 	unsigned int mProxyRefs; | 
 | }; | 
 |  | 
 | class Texture2DArray : public Texture3D | 
 | { | 
 | public: | 
 | 	explicit Texture2DArray(GLuint name); | 
 |  | 
 | 	GLenum getTarget() const override; | 
 | 	void generateMipmaps() override; | 
 |  | 
 | protected: | 
 | 	~Texture2DArray() override; | 
 | }; | 
 |  | 
 | class TextureExternal : public Texture2D | 
 | { | 
 | public: | 
 | 	explicit TextureExternal(GLuint name); | 
 |  | 
 | 	GLenum getTarget() const override; | 
 |  | 
 | protected: | 
 | 	~TextureExternal() override; | 
 | }; | 
 | } | 
 |  | 
 | #endif   // LIBGLESV2_TEXTURE_H_ |