GLESFrameTexture2D.h

Go to the documentation of this file.

/*
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */
 
#ifndef META_OCEAN_RENDERING_GLES_FRAME_TEXTURE_2D_H
#define META_OCEAN_RENDERING_GLES_FRAME_TEXTURE_2D_H
 
#include "ocean/rendering/glescenegraph/GLESceneGraph.h"
#include "ocean/rendering/glescenegraph/GLESTexture2D.h"
 
#include "ocean/rendering/FrameTexture2D.h"
 
namespace Ocean
{
 
namespace Rendering
{
 
namespace GLESceneGraph
{
 
/**
 * This class wraps a GLESceneGraph frame texture object.
 * @ingroup renderinggles
 */
class OCEAN_RENDERING_GLES_EXPORT GLESFrameTexture2D final :
    virtual public GLESTexture2D,
    virtual public FrameTexture2D
{
    friend class GLESFactory;
 
    public:
 
        /**
         * Sets or updates the texture with a given frame.
         * @see FrameTexture2D::setTexture().
         */
        bool setTexture(Frame&& frame) override;
 
        /**
         * Sets or updates the texture with a given buffer.
         * @see FrameTexture2D::setTexture().
         */
        bool setTexture(CompressedFrame&& compressedFrame) override;
 
        /**
         * Returns the frame type of this 2D texture.
         * @see Texture2D::frameType()
         */
        FrameType frameType() const override;
 
        /**
         * Returns whether this texture contains at least one transparent pixel.
         * @see Texture2D::hasTransparentPixel();
         */
        bool hasTransparentPixel() const override;
 
        /**
         * Returns whether the texture internally holds valid data.
         * @see Texture::isValid().
         */
        bool isValid() const override;
 
    protected:
 
        /**
         * Creates a new GLESceneGraph texture 2D object.
         */
        GLESFrameTexture2D();
 
        /**
         * Destructs a GLESceneGraph texture 2D object.
         */
        ~GLESFrameTexture2D() override;
 
        /**
         * Update function called by the framebuffer.
         * @see DynamicObject::onDynamicUpdate().
         */
        void onDynamicUpdate(const ViewRef& view, const Timestamp timestamp) override;
 
        /**
         * Updates the texture based on a given compressed frame.
         * @param compressedFrame The compressed frame to be used to update the texture, must be valid
         * @return True, if succeeded
         */
        bool updateTexture(const CompressedFrame& compressedFrame);
 
        /**
         * Determines the OpenGL format for a given compressed texture format.
         * @param compressedFormat The texture format for which the OpenGL format will be determined, must be valid
         * @param internalFormat The resulting OpenGL texture format
         * @return True, if succeeded
         */
        static bool determineCompressedFormat(const CompressedFormat compressedFormat, GLenum& internalFormat);
 
        /**
         * Returns the image size for a compressed texture.
         * @param compressedFormat The texture format of the compressed texture, must be valid
         * @param width The width of the texture in pixel, with range [1, infinity)
         * @param height The height of the texture in pixel, with range [1, infinity)
         * @param size The resulting size of the compressed texture, in bytes
         * @return True, if succeeded
         */
        static bool compressedImageSize(const CompressedFormat compressedFormat, const unsigned int width, const unsigned int height, unsigned int& size);
 
    protected:
 
        /// The texture's frame, if any.
        Frame frame_;
 
        /// The texture's compressed frame, if any.
        CompressedFrame compressedFrame_;
 
        /// True, if the texture needs to be updated.
        bool updateNeeded_ = false;
};
 
}
 
}
 
}
 
#endif // META_OCEAN_RENDERING_GLES_FRAME_TEXTURE_2D_H