TextureReader.h

Go to the documentation of this file.

#pragma once
 
#include <unordered_map>
#include <string>
#include <vector>
 
#include <tdme/tdme.h>
#include <tdme/engine/fileio/textures/fwd-tdme.h>
#include <tdme/engine/fwd-tdme.h>
#include <tdme/os/filesystem/fwd-tdme.h>
#include <tdme/os/filesystem/FileSystemException.h>
#include <tdme/os/threading/Mutex.h>
#include <tdme/utilities/ByteBuffer.h>
 
using std::string;
using std::unordered_map;
using std::vector;
 
using tdme::engine::Texture;
using tdme::os::filesystem::FileSystemException;
using tdme::os::threading::Mutex;
using tdme::utilities::ByteBuffer;
 
/**
 * Texture reader class
 * @author Andreas Drewke
 */
class tdme::engine::fileio::textures::TextureReader final
{
    friend class tdme::engine::Texture;
    friend class PNGTextureReader;
 
public:
    /**
     * @return texture extensions
     */
    static const vector<string>& getTextureExtensions();
 
    /**
     * Reads a texture
     * @param pathName path name
     * @param fileName file name
     * @param useCache use cache
     * @param powerOfTwo scale image to fit power of two dimensions
     * @param idPrefix id prefix
     * @return texture data instance or null
     */
    static Texture* read(const string& pathName, const string& fileName, bool useCache = true, bool powerOfTwo = true, const string& idPrefix = string());
 
    /**
     * Reads a texture with additional transparency texture
     * @param texturePathName texture path name
     * @param textureFileName texture file name
     * @param transparencyTexturePathName transparency texture path name
     * @param transparencyTextureFileName transparency texture file name
     * @param useCache use cache
     * @param powerOfTwo scale image to fit power of two dimensions
     * @param idPrefix id prefix
     * @return texture data instance or null
     */
    static Texture* read2(const string& texturePathName, const string& textureFileName, const string& transparencyTexturePathName, const string& transparencyTextureFileName, bool useCache = true, bool powerOfTwo = true, const string& idPrefix = string());
 
    /**
     * Rotate texture around center
     * @param texture texture
     * @param rotation rotation in degree
     * @param idSuffix id suffix for generated texture
     * @return rotation rotation
     */
    static Texture* rotate(Texture* texture, float rotation, const string& idSuffix = ":rotated");
 
    /**
     * Scale texture
     * @param texture texture
     * @param width width
     * @param height height
     * @param idSuffix id suffix for generated texture
     * @return texture
     */
    static Texture* scale(Texture* texture, int width, int height, const string& idSuffix = ":scaled");
 
    /**
     * Smooth texture
     * @param texture texture
     * @param idSuffix id suffix for generated texture
     * @param adjacentSampleWeight adjacent sample weight
     * @return texture
     */
    static Texture* smooth(Texture* texture, const string& idSuffix = ":smoothed", float adjacentSampleWeight = 0.05f);
 
private:
 
    /**
     * Remove texture from cache
     * @param texture texture
     */
    static void removeFromCache(Texture* texture);
 
    /**
     * Scales a texture line
     * @param pixelByteBuffer pixel byte buffer aka original texture
     * @param pixelByteBufferScaled pixel byte buffer scaled aka new texture, its offset should point to start of line you want to write
     * @param width orginal width
     * @param textureWidth new texture width
     * @param bytesPerPixel bytes per pixel
     * @param y y position in original image
     */
    static void scaleTextureLine(const ByteBuffer& pixelByteBuffer, ByteBuffer& pixelByteBufferScaled, int width, int textureWidth, int bytesPerPixel, int y);
 
    //
    STATIC_DLL_IMPEXT static vector<string> extensions;
 
    // maybe have a read write lock here for texture cache, but currently I have no multithreaded access to it
    STATIC_DLL_IMPEXT static unordered_map<string, Texture*> textureCache;
    STATIC_DLL_IMPEXT static Mutex textureCacheMutex;
};