Materials Struct Reference

#include <materials.h>

Public Member Functions
void	clear ()
int	insert (const Material &material, const char *name)
	ajoute une matiere.
int	insert_texture (const char *filename)
	ajoute une texture / nom du fichier.
int	find (const char *name)
	recherche une matiere avec son nom. renvoie son indice dans materials, ou -1.
int	count () const
	nombre de matieres.
const char *	name (const int id) const
	renvoie le nom de la ieme matiere.
const char *	name (const int id)
	renvoie le nom de la ieme matiere.
const Material &	material (const int id) const
	renvoie la ieme matiere.
Material &	material (const int id)
	renvoie la ieme matiere.
const Material &	operator() (const int id) const
	renvoie la ieme matiere.
Material &	operator() (const int id)
	renvoie la ieme matiere.
const Material &	material (const char *name)
	renvoie la matiere 'name', si elle existe. ou la matiere par defaut.
const Material &	default_material ()
	renvoie une matiere par defaut.
int	default_material_index ()
	indice de la matiere par defaut dans le tableau materials.
int	filename_count () const
	renvoie le nombre de noms de fichiers de textures.
const char *	filename (const int id) const
	renvoie le nom de fichier d'une texture.
int	find_texture (const char *filename)
	renvoie l'indice d'une texture, si elle existe.

Public Attributes
std::vector< std::string >	names
	noms des matieres.
std::vector< Material >	materials
	description des matieres.
std::vector< std::string >	texture_filenames
	noms des textures a charger.
int	default_material_id
	indice de la matiere par defaut dans materials.

Detailed Description

ensemble de matieres d'un Mesh. + ensemble de textures referencees par les descriptions de matieres.

names[id] est le nom de la matiere materials[id], utiliser name() et material() pour recuperer la description d'une matiere d'indice id.

les textures sont indexees separemment. chaque matiere reference une ou plusieurs textures, par exemple diffuse_texture et specular_texture. ces indices correspondent aux noms de fichiers (uniques) des images a charger : filename() renvoie le nom du fichier. filename( material.diffuse_texture ) renvoie le nom de l'image a charger qui correspond a la texture diffuse de la matiere.

pourquoi cette indexation supplementaire ? pour eviter de charger plusieurs fois une image / creer plusieurs fois une texture.

Definition at line 45 of file materials.h.

Constructor & Destructor Documentation

Materials()

Materials::Materials ( )

inline

Definition at line 52 of file materials.h.

: names(), materials(), texture_filenames(), default_material_id(-1) {}

Member Function Documentation

clear()

void Materials::clear ( )

inline

Definition at line 54 of file materials.h.

    {
        names.clear();
        materials.clear();
        texture_filenames.clear();
        default_material_id= -1;
    }

insert()

int Materials::insert ( const Material &  material, const char *  name  )

inline

ajoute une matiere.

Definition at line 63 of file materials.h.

    {
        int id= find(name);
        if(id == -1)
        {
            id= int(materials.size());
            names.push_back(name);
            materials.push_back(material);
        }
        assert(materials.size() == names.size());
        return id;
    }

insert_texture()

int Materials::insert_texture ( const char *  filename )

inline

ajoute une texture / nom du fichier.

Definition at line 77 of file materials.h.

    {
        int id= find_texture(filename);
        if(id == -1)
        {
            id= int(texture_filenames.size());
            texture_filenames.push_back(filename);
        }
        return id;
    }

find()

int Materials::find ( const char *  name )

inline

recherche une matiere avec son nom. renvoie son indice dans materials, ou -1.

Definition at line 89 of file materials.h.

    {
        if(name == nullptr || name[0] == 0)
            return -1;
        
        for(int i= 0; i < int(names.size()); i++)
        {
            if(names[i] == name)
                return i;
        }
        return -1;
    }

count()

int Materials::count ( ) const

inline

nombre de matieres.

Definition at line 103 of file materials.h.

{ return int(materials.size()); }

name() [1/2]

const char * Materials::name ( const int  id ) const

inline

renvoie le nom de la ieme matiere.

Definition at line 106 of file materials.h.

{ assert(id != -1); assert(id < int(materials.size())); return names[id].c_str(); }

name() [2/2]

const char * Materials::name ( const int  id )

inline

renvoie le nom de la ieme matiere.

Definition at line 108 of file materials.h.

{ assert(id != -1); assert(id < int(materials.size())); return names[id].c_str(); }

material() [1/3]

const Material & Materials::material ( const int  id ) const

inline

renvoie la ieme matiere.

Definition at line 111 of file materials.h.

{ assert(id != -1); assert(id < int(materials.size())); return materials[id]; }

material() [2/3]

Material & Materials::material ( const int  id )

inline

renvoie la ieme matiere.

Definition at line 113 of file materials.h.

{ assert(id != -1); assert(id < int(materials.size())); return materials[id]; }

operator()() [1/2]

const Material & Materials::operator() ( const int  id ) const

inline

renvoie la ieme matiere.

Definition at line 116 of file materials.h.

{ return material(id); }

operator()() [2/2]

Material & Materials::operator() ( const int  id )

inline

renvoie la ieme matiere.

Definition at line 118 of file materials.h.

{ return material(id); }

material() [3/3]

const Material & Materials::material ( const char *  name )

inline

renvoie la matiere 'name', si elle existe. ou la matiere par defaut.

Definition at line 121 of file materials.h.

    {
        int id= find(name);
        if(id != -1)
            // renvoie la matiere
            return materials[id];
        else
            // ou renvoie la matiere par defaut...
            return default_material();
    }

default_material()

const Material & Materials::default_material ( )

inline

renvoie une matiere par defaut.

Definition at line 133 of file materials.h.

    {
        return material(default_material_index());
    }

default_material_index()

int Materials::default_material_index ( )

inline

indice de la matiere par defaut dans le tableau materials.

Definition at line 139 of file materials.h.

    {
        if(default_material_id == -1)
            default_material_id= insert(Material(Color(0.8)), "default");
        
        return default_material_id;
    }

filename_count()

int Materials::filename_count ( ) const

inline

renvoie le nombre de noms de fichiers de textures.

Definition at line 148 of file materials.h.

{ return int(texture_filenames.size()); }

filename()

const char * Materials::filename ( const int  id ) const

inline

renvoie le nom de fichier d'une texture.

Definition at line 150 of file materials.h.

{ if(id < 0) return nullptr; assert(id < int(texture_filenames.size())); return texture_filenames[id].c_str(); }

find_texture()

int Materials::find_texture ( const char *  filename )

inline

renvoie l'indice d'une texture, si elle existe.

Definition at line 153 of file materials.h.

    {
        if(filename == nullptr || filename[0] == 0)
            return -1;
        
        for(int i= 0; i < int(texture_filenames.size()); i++)
        {
            if(texture_filenames[i] == filename)
                return i;
        }
        return -1;
    }

Member Data Documentation

names

std::vector<std::string> Materials::names

noms des matieres.

Definition at line 47 of file materials.h.

materials

std::vector<Material> Materials::materials

description des matieres.

Definition at line 48 of file materials.h.

texture_filenames

std::vector<std::string> Materials::texture_filenames

noms des textures a charger.

Definition at line 49 of file materials.h.

default_material_id

int Materials::default_material_id

indice de la matiere par defaut dans materials.

Definition at line 50 of file materials.h.

---

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

• src/materials.h