Image Class Reference

representation d'une image. More...

#include <image.h>

Public Member Functions
	Image (const int w, const int h, const Color &color=Black())
Color &	operator() (const int x, const int y)
Color	operator() (const int x, const int y) const
	renvoie la couleur d'un pixel de l'image (image non modifiable). More...
Color &	operator() (const unsigned offset)
Color	operator() (const unsigned offset) const
Color	sample (const float x, const float y) const
	renvoie la couleur interpolee a la position (x, y) [0 .. width]x[0 .. height]. More...
Color	texture (const float x, const float y) const
	renvoie la couleur interpolee aux coordonnees normalisees (x, y) [0 .. 1]x[0 .. 1]. More...
const void *	data () const
	renvoie un pointeur sur le stockage des couleurs des pixels. More...
void *	data ()
	renvoie un pointeur sur le stockage des couleurs des pixels. More...
int	width () const
	renvoie la largeur de l'image. More...
int	height () const
	renvoie la hauteur de l'image. More...
unsigned	size () const
	renvoie le nombre de pixels de l'image. More...
unsigned	offset (const int x, const int y) const
	renvoie l'indice du pixel. More...
bool	operator== (const Image &im) const
	comparaison avec la sentinelle. More...

Static Public Member Functions
static Image &	error ()

Protected Attributes
std::vector< Color >	m_pixels
int	m_width
int	m_height

Detailed Description

representation d'une image.

Definition at line 20 of file image.h.

Member Function Documentation

operator()() [1/2]

Color& Image::operator() ( const int  x, const int  y  )

inline

renvoie une reference sur la couleur d'un pixel de l'image. permet de modifier et/ou de connaitre la couleur d'un pixel :

Image image(512, 512);
 
image(10, 10)= make_red();      // le pixel (10, 10) devient rouge
image(0, 0)= image(10, 10);     // le pixel (0, 0) recupere la couleur du pixel (10, 10)

Definition at line 40 of file image.h.

    {
        return m_pixels[offset(x, y)];
    }

operator()() [2/2]

Color Image::operator() ( const int  x, const int  y  ) const

inline

renvoie la couleur d'un pixel de l'image (image non modifiable).

Definition at line 46 of file image.h.

    {
        return m_pixels[offset(x, y)];
    }

sample()

Color Image::sample ( const float  x, const float  y  ) const

inline

renvoie la couleur interpolee a la position (x, y) [0 .. width]x[0 .. height].

Definition at line 64 of file image.h.

    {
        // interpolation bilineaire 
        float u= x - std::floor(x);
        float v= y - std::floor(y);
        int ix= x;
        int iy= y;
        return (*this)(ix, iy)    * ((1 - u) * (1 - v))
            + (*this)(ix+1, iy)   * (u       * (1 - v))
            + (*this)(ix, iy+1)   * ((1 - u) * v)
            + (*this)(ix+1, iy+1) * (u       * v);
    }

texture()

Color Image::texture ( const float  x, const float  y  ) const

inline

renvoie la couleur interpolee aux coordonnees normalisees (x, y) [0 .. 1]x[0 .. 1].

Definition at line 78 of file image.h.

    {
        return sample(x * m_width, y * m_height);
    }

data() [1/2]

const void* Image::data ( ) const

inline

renvoie un pointeur sur le stockage des couleurs des pixels.

Definition at line 84 of file image.h.

    {
        assert(!m_pixels.empty());
        return &m_pixels.front();
    }

data() [2/2]

void* Image::data ( )

inline

renvoie un pointeur sur le stockage des couleurs des pixels.

Definition at line 91 of file image.h.

    {
        assert(!m_pixels.empty());
        return &m_pixels.front();
    }

width()

int Image::width ( ) const

inline

renvoie la largeur de l'image.

Definition at line 98 of file image.h.

{ return m_width; }

height()

int Image::height ( ) const

inline

renvoie la hauteur de l'image.

Definition at line 100 of file image.h.

{ return m_height; }

size()

unsigned Image::size ( ) const

inline

renvoie le nombre de pixels de l'image.

Definition at line 102 of file image.h.

{ return m_width * m_height; }

offset()

unsigned Image::offset ( const int  x, const int  y  ) const

inline

renvoie l'indice du pixel.

Definition at line 105 of file image.h.

    {
        int px= x;
        if(px < 0) px= 0;
        if(px > m_width-1) px= m_width-1;
        int py= y;
        if(py < 0) py= 0;
        if(py > m_height-1) py= m_height-1;
        
        assert(py * m_width + px < int(m_pixels.size()));
        return py * m_width + px;
    }

error()

static Image& Image::error ( )

inlinestatic

sentinelle pour la gestion d'erreur lors du chargement d'un fichier. exemple :

Image image= read_image("debug.png");
if(image == Image::error())
    return "erreur de chargement";

Definition at line 126 of file image.h.

    {
        static Image image;
        return image;
    }

operator==()

bool Image::operator== ( const Image &  im ) const

inline

comparaison avec la sentinelle.

if(image == Image::error()) { ... } 

Definition at line 133 of file image.h.

    {
        // renvoie vrai si im ou l'objet est la sentinelle
        return (this == &im);
    }

---

The documentation for this class was generated from the following file:

• src/gKit/image.h