Image.hpp

//
// SFML - Simple and Fast Multimedia Library
// Copyright (C) 2007-2009 Laurent Gomila (laurent.gom@gmail.com)
//
// This software is provided 'as-is', without any express or implied warranty.
// In no event will the authors be held liable for any damages arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it freely,
// subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented;
//    you must not claim that you wrote the original software.
//    If you use this software in a product, an acknowledgment
//    in the product documentation would be appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such,
//    and must not be misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source distribution.
//
 
#ifndef SFML_IMAGE_HPP
#define SFML_IMAGE_HPP

// Headers
#include <SFML/System/Resource.hpp>
#include <SFML/Graphics/Color.hpp>
#include <SFML/Graphics/Rect.hpp>
#include <string>
#include <vector>
 
 
namespace sf
{
class RenderWindow;

class SFML_API Image : public Resource<Image>
{
public :

    Image();

    Image(const Image& Copy);

    Image(unsigned int Width, unsigned int Height, const Color& Col = Color(0, 0, 0, 255));

    Image(unsigned int Width, unsigned int Height, const Uint8* Data);

    ~Image();

    bool LoadFromFile(const std::string& Filename);

    bool LoadFromMemory(const char* Data, std::size_t SizeInBytes);

    bool LoadFromPixels(unsigned int Width, unsigned int Height, const Uint8* Data);

    bool SaveToFile(const std::string& Filename) const;

    bool Create(unsigned int Width, unsigned int Height, Color Col = Color(0, 0, 0, 255));

    void CreateMaskFromColor(Color ColorKey, Uint8 Alpha = 0);

    void Copy(const Image& Source, unsigned int DestX, unsigned int DestY, const IntRect& SourceRect = IntRect(0, 0, 0, 0), bool ApplyAlpha = false);

    bool CopyScreen(RenderWindow& Window, const IntRect& SourceRect = IntRect(0, 0, 0, 0));

    void SetPixel(unsigned int X, unsigned int Y, const Color& Col);

    const Color& GetPixel(unsigned int X, unsigned int Y) const;

    const Uint8* GetPixelsPtr() const;

    void Bind() const;

    void SetSmooth(bool Smooth);

    unsigned int GetWidth() const;

    unsigned int GetHeight() const;

    bool IsSmooth() const;

    FloatRect GetTexCoords(const IntRect& Rect) const;

    static unsigned int GetValidTextureSize(unsigned int Size);

    Image& operator =(const Image& Other);
 
private :

    bool CreateTexture();

    void EnsureTextureUpdate() const;

    void EnsureArrayUpdate() const;

    void Reset();

    void DestroyTexture();

    // Member data
    unsigned int               myWidth;             
    unsigned int               myHeight;            
    unsigned int               myTextureWidth;      
    unsigned int               myTextureHeight;     
    unsigned int               myTexture;           
    bool                       myIsSmooth;          
    mutable std::vector<Color> myPixels;            
    mutable bool               myNeedTextureUpdate; 
    mutable bool               myNeedArrayUpdate;   
};
 
} // namespace sf
 
 
#endif // SFML_IMAGE_HPP