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 à charger : filename() renvoie le nom du fichier. filename( material.diffuse_texture ) renvoie le nom de l'image à charger qui correspond à la texture diffuse de la matiere.

pourquoi cette indexation supplementaire ? pour eviter de charger plusieurs fois une image / creer plusieurs fois une texture. il est aussi tres simple de creer un tableau avec les textures openGL indexe de la meme maniere.

Definition at line 44 of file materials.h.

Constructor & Destructor Documentation

Materials()

Materials::Materials ( )

inline

Definition at line 51 of file materials.h.

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

Member Function Documentation

clear()

void Materials::clear ( )

inline

Definition at line 53 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 62 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 76 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 88 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 102 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 105 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 107 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 110 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 112 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 115 of file materials.h.

{ return material(id); }

operator()() [2/2]

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

inline

renvoie la ieme matiere.

Definition at line 117 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 120 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 132 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 138 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 147 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 149 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 152 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 46 of file materials.h.

materials

std::vector<Material> Materials::materials

description des matieres.

Definition at line 47 of file materials.h.

texture_filenames

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

noms des textures a charger.

Definition at line 48 of file materials.h.

default_material_id

int Materials::default_material_id

indice de la matiere par defaut dans materials.

Definition at line 49 of file materials.h.

---

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

• src/gKit/materials.h