[Nitrito-devel] Projecte, canvis?

[Jeremies M. <elf...@gm...>]

Bona tarda! Durmieu!

Si veus al CVS, ja he pujat els canvis aquells que vam comentar.
Respecte lo de cargar del fitxer, voras que es algo bastant rudimentari,
pero bueno, per ara si això, per anar tirant sobra crec.Si et pareix be,
per ara aixina.

Despues mes coses, ja he modificat els Makefiles. A mi em funcionen de
meravella, a mes he donat, les ordres per a crear la documentació i
això. Si vols t'explique com es documenta a lo Javadoc per a que ho
interprete el doxygen:
	Tot comentari ha de començar en /**. Per exemple:
                /**
                 * COMENTARI
                 *
                 */
	Anem a vorer, sols comentaris que siguen importants, cabeçeres.
Funcionament de classes i funcions. Els de una linea no.

	Despues existeixes una serie de variables en les que el doxygen es
guia. En el cas de les capçaleres, la unica aixina que ens pot interesar
es: @author <- Totes les variables començen en '@'.

	I per a documentar funcions pues ens interesa: @param i @return.

Exemples:
(Capçalera)
/**
 * Nitrito 3D
 * Este fitxer fa: bla bla bla.
 * @author Juanito benganito.
 */

(Funcio) Sempre es posa dalt de lo que vols comentar.
/**
 * Esta funcio ordena un vector
 * @param v Vector que volem ordenar.
 * @param n Tamany del vector.
 * @return El vector ordenat.
 */

Vector OrdenaVector (Vector v, int n);

JAsta, es facil no? A mes de ser facil de documentar pues, el doxygen
mos elabora una fantastica documentacio de quines classes gasten quines
classes i etc. Per si es vol mirar. Bueno i si no vols documentar no
pasa res, ja ho faig jo, que no em costa res i aixina vaig fent coses :)

Mes coses: 
----------------------------------------------------------------------------
Respecte lo que vam parlar de cargar la configuració. En primer lloc, la
configuracio. Hi ha una classe no? La classe Options, cal crear una
classe nomes per a cridarla una vegada? Ja se que les classes
s'utilitzen a vegades per a agrupar dades igual que les estructures,
pero te sentit? Crec que una classe es com una estructura pero al fi i
al cap, es pot fer mes inteligent i mes segura, m'explique:

class Options{
    public: //Metodes que puc utilitzar desde fora (interfaç)
        void set_videmode(int w, int h) {
            if(w i h son correctes)
                width = w i heigth = h;
            else
                posa_valors_per_defecte.
        }
        int get_width() { return width; }
        int get_height(){ return height; }
    private: //No les puc tocar directament.
        int width, height;
};

Bueno, veus? Amb aço m'assegure de que no hi hagen modos impossibles, pq
el metode set_video_mode s'encarrega de ello.

A mes a mes, estaria be separar, el while principal del main a una
classe que es diga, engine o game o algo aixina no? Son idees. La idea
es modularitzaro de forma, que per a millorar algo, no tingues que tocar
la interfaç sino lo que fan els metodes. Bueno...això.

XD Bueno aço son coses que s'em van ocurrint, i bueno, ho proponc. Pensa
que dos persones poden mostrar el mateix problema desde diferents punts
de vista i aixo es lo bo i despues s'agafa la solucio mes "interesada".

Espere que hi haja discusio i puguem fer un codi, que despues siga facil
de mantindre i, perque no?, es puga reutilitzar en altres projectes. Com
el Nitrito 2-3 ? xDDD

Bueno Waka! Cambio I corto!!




-- 
Jeremies Pérez Morata <elf...@gm...>