utilitaires pour creer une application

Files
file	src/gKit/text.h
file	src/gKit/widgets.h
file	src/gKit/window.h

Classes
struct	Text
struct	Widgets

Typedefs
typedef SDL_Window *	Window
typedef SDL_GLContext	Context

Functions
Text	create_text ()
	cree une console. a detruire avec release_text( ).
void	release_text (Text &text)
	detruit une console.
void	clear (Text &text)
	efface le contenu de la console.
void	print_background (Text &text, const int x, const int y, const int background, const char c)
	affiche un caractere c sur un fond background.
void	print_background (Text &text, const int x, const int y, const char *message)
	affiche un caractere c sur un fond par defaut.
void	print (Text &text, const int x, const int y, const char *message)
	affiche un texte a la position x, y.
void	printf_background (Text &text, const int x, const int y, const char *format,...)
	affiche un texte a la position x, y sur un fond par defaut.
void	printf (Text &text, const int x, const int y, const char *format,...)
	affiche un texte a la position x, y. meme utilisation que printf().
void	default_color (Text &text, const Color &color)
	choisit une couleur par defaut pour le texte.
void	draw (const Text &text, const int width, const int height)
	dessine la console.
Widgets	create_widgets ()
	cree une interface graphique. a detruire avec release_widgets( ).
void	release_widgets (Widgets &widgets)
	detruit l'interface graphique.
void	begin (Widgets &widgets)
	debut de la description des elements de l'interface graphique.
void	begin_line (Widgets &widgets)
	place les prochains elements sur une nouvelle ligne.
void	label (Widgets &widgets, const char *format,...)
	cree un texte. meme fonctionnement que printf().
bool	button (Widgets &widgets, const char *text, int &status)
bool	select (Widgets &widgets, const char *text, const int option, int &status)
void	text_area (Widgets &w, const int height, const char *text, int &begin_line)
bool	edit (Widgets &widgets, const int text_size, char *text)
bool	value (Widgets &widgets, const char *label, int &value, const int value_min, const int value_max, const int value_step)
	valeur editable par increment.
bool	value (Widgets &widgets, const char *label, float &value, const float value_min, const float value_max, const float value_step)
	valeur editable par increment.
void	end_line (Widgets &widgets)
	termine la description des elements de la ligne.
void	end (Widgets &widgets)
	termine la description des elements de l'interface graphique.
void	default_color (Widgets &widgets, const Color &color)
	choisit une couleur par defaut pour le texte.
void	draw (Widgets &widgets, const int width, const int height)
	affiche les elements decrits entre begin() et end().
void	window_msaa (const int samples)
	option mssa. utiliser avant la creation de la fenetre avec create_window().
void	window_srgb (const bool flag)
	option srgb. utiliser avant la creation de la fenetre avec create_window().
void	window_resize (const bool flag)
	option resize. permet de creer une fenetre de taille fixe, ou pas.
Window	create_window (const int width, const int height, const int major=3, const int minor=2)
	creation d'une fenetre pour l'application.
void	release_window (Window w)
	destruction de la fenetre.
Context	create_context (Window window)
	cree et configure un contexte opengl.
void	release_context (Context context)
	detruit le contexte openGL.
int	window_width ()
	renvoie la largeur de la fenetre de l'application.
int	window_height ()
	renvoie la hauteur de la fenetre de l'application.
bool	window_resize ()
	renvoie vrai si la fenetre peut etre redimensionnee.
int	window_msaa ()
	renvoie le nombre de samples MSAA.
bool	window_srgb ()
	renvoie le mode srgb de la fenetre de l'application.
int	key_state (const SDL_Keycode key)
	renvoie l'etat d'une touche du clavier. cf la doc SDL2 pour les codes.
void	clear_key_state (const SDL_Keycode key)
	desactive une touche du clavier.
SDL_KeyboardEvent	key_event ()
	renvoie le dernier evenement. touche speciales.
void	clear_key_event ()
	desactive l'evenement.
SDL_MouseButtonEvent	button_event ()
	renvoie le dernier evenement. etat des boutons de la souris.
void	clear_button_event ()
	desactive l'evenement.
SDL_MouseWheelEvent	wheel_event ()
	renvoie le dernier evenement. etat de la molette de la souris / glisser sur le pad.
void	clear_wheel_event ()
	desactive l'evenement.
SDL_TextInputEvent	text_event ()
	renvoie le dernier evenement. saisie de texte.
void	clear_text_event ()
	desactive l'evenement.
float	global_time ()
	renvoie le temps ecoule depuis le lancement de l'application, en millisecondes.
float	delta_time ()
	renvoie le temps ecoule depuis la derniere frame, en millisecondes.
int	run (Window window, int(*draw)(void))
	fonction principale. gestion des evenements et appel de la fonction draw de l'application.
int	last_event_count ()
int	events (Window window)
	fonction interne de gestion d'evenements.
const char *	smart_path (const char *filename)
	renvoie le chemin(path) vers le fichier 'filename' apres l'avoir cherche dans un repertoire standard...
const char *	drop_event ()
	drag/drop, renvoie le dernier fichier.
void	clear_drop_event ()
	desactive drag/drop.
const std::vector< std::string > &	drop_events ()
	drag/drop. recupere tous les fichiers.
void	clear_drop_events ()
	desactive drag/drop.

Detailed Description

Typedef Documentation

Window

typedef SDL_Window* Window

Definition at line 17 of file window.h.

Context

typedef SDL_GLContext Context

Definition at line 30 of file window.h.

Function Documentation

create_text()

Text create_text

(

)

cree une console. a detruire avec release_text( ).

Definition at line 14 of file text.cpp.

{
    Text text;
 
    // charge la fonte
    Image font= read_image( smart_path("data/font.png") );
 
    // modifie la transparence du caractere de fond
    for(unsigned int y= 0; y < 16; y++)
    for(unsigned int x= 0; x < 8; x++)
    {
        unsigned int starty= 16 *7;
        unsigned int startx= 8 *2;
        Color color= font(startx + x, starty + y);
        color.a= 0.6f;
        font(startx + x, starty + y)= color;
    }
 
    // cree le curseur
    for(unsigned int y= 0; y < 16; y++)
    for(unsigned int x= 0; x < 8; x++)
    {
        unsigned int starty= 16 *7;
        unsigned int startx= 8 *1;
        Color color= (x > 1) ? Color(1, 1, 1, 0.6f) : Color(1, 1, 1, 1);
        font(startx + x, starty + y)= color;
    }
 
    text.font= make_texture(0, font);
    //~ release_image(font);
 
    text.color= White();
 
    // shader
    text.program= read_program( smart_path("data/shaders/text.glsl") );
    program_print_errors(text.program);
 
    // associe l'uniform buffer a l'entree 0 / binding 0
    GLint index= glGetUniformBlockIndex(text.program, "textData");
    glUniformBlockBinding(text.program, index, 0);
 
    clear(text);
    glGenVertexArrays(1, &text.vao);
    glGenBuffers(1, &text.ubo);
    glBindBuffer(GL_UNIFORM_BUFFER, text.ubo);
    glBufferData(GL_UNIFORM_BUFFER, sizeof(text.buffer), text.buffer, GL_DYNAMIC_DRAW);
 
    return text;
}

release_text()

void release_text

(

Text &

text

)

detruit une console.

Definition at line 64 of file text.cpp.

{
    release_program(text.program);
    glDeleteVertexArrays(1, &text.vao);
    glDeleteBuffers(1, &text.ubo);
    glDeleteTextures(1, &text.font);
}

clear()

void clear

(

Text &

text

)

efface le contenu de la console.

Definition at line 72 of file text.cpp.

{
    for(int y= 0; y < 24; y++)
    for(int x= 0; x < 128; x++)
        text.buffer[y][x]= ' ';
}

print_background() [1/2]

void print_background	(	Text &	text,
		const int	x,
		const int	y,
		const int	background,
		const char	c )

affiche un caractere c sur un fond background.

Definition at line 106 of file text.cpp.

{
    int x= px;
    int y= 23 - py;     // premiere ligne en haut...
    if(x < 0 || y < 0) return;
    if(x >= 128 || y >= 24) return;
    //~ if(!isprint(c)) return;
 
    text.buffer[y][x]= (int) c | (background << 8);
}

print_background() [2/2]

void print_background	(	Text &	text,
		const int	x,
		const int	y,
		const char *	message )

affiche un caractere c sur un fond par defaut.

Definition at line 117 of file text.cpp.

{
    print(text, px, py, 2, message);
}

print()

void print	(	Text &	text,
		const int	x,
		const int	y,
		const char *	message )

affiche un texte a la position x, y.

Definition at line 122 of file text.cpp.

{
    print(text, px, py, 0, message);
}

printf_background()

void printf_background	(	Text &	text,
		const int	x,
		const int	y,
		const char *	format,
			... )

affiche un texte a la position x, y sur un fond par defaut.

Definition at line 127 of file text.cpp.

{
    char tmp[24*128+1] = { 0 };
 
    va_list args;
    va_start(args, format);
    vsnprintf(tmp, sizeof(tmp), format, args);
    va_end(args);
 
    tmp[24*128]= 0;
    print(text, px, py, 2, tmp);
}

printf()

void printf	(	Text &	text,
		const int	x,
		const int	y,
		const char *	format,
			... )

affiche un texte a la position x, y. meme utilisation que printf().

Definition at line 140 of file text.cpp.

{
    char tmp[24*128+1] = { 0 };
 
    va_list args;
    va_start(args, format);
    vsnprintf(tmp, sizeof(tmp), format, args);
    va_end(args);
 
    tmp[24*128]= 0;
    print(text, px, py, 0, tmp);
}

default_color() [1/2]

void default_color	(	Text &	text,
		const Color &	color )

choisit une couleur par defaut pour le texte.

Definition at line 153 of file text.cpp.

{
    text.color= color;
}

draw() [1/2]

void draw	(	const Text &	text,
		const int	width,
		const int	height )

dessine la console.

Definition at line 158 of file text.cpp.

{
    glBindVertexArray(text.vao);
    glUseProgram(text.program);
    program_use_texture(text.program, "font", 0, text.font);
 
    program_uniform(text.program, "offset", height - 24*16);
    program_uniform(text.program, "default_color", text.color);
 
    // transfere le texte dans l'uniform buffer associe au binding 0, cf create_text()
    glBindBufferBase(GL_UNIFORM_BUFFER, 0, text.ubo);
    glBufferSubData(GL_UNIFORM_BUFFER, 0, sizeof(text.buffer), text.buffer);
 
    glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
    glEnable(GL_BLEND);
    glDisable(GL_DEPTH_TEST);
 
    glDrawArrays(GL_TRIANGLE_STRIP, 0, 4);
 
    glDisable(GL_BLEND);
    glEnable(GL_DEPTH_TEST);
}

create_widgets()

Widgets create_widgets

(

)

cree une interface graphique. a detruire avec release_widgets( ).

Definition at line 12 of file widgets.cpp.

{
    Widgets w;
    w.console= create_text();
    w.px= 0; w.py= 0;
    w.focus= 0; w.fx= 0; w.fy= 0;
    w.mb= 0; w.mx= 0; w.my= 0;
    w.wx= 0; w.wy= 0;
    return w;
}

release_widgets()

void release_widgets

(

Widgets &

widgets

)

detruit l'interface graphique.

Definition at line 23 of file widgets.cpp.

{
    release_text(w.console);
}

begin()

void begin

(

Widgets &

widgets

)

debut de la description des elements de l'interface graphique.

Definition at line 29 of file widgets.cpp.

{
    clear(w.console);
    w.px= 0;
    w.py= 0;
 
    SDL_MouseButtonEvent mouse= button_event();
    w.mb= 0;
    w.mx= mouse.x / 8;
    w.my= mouse.y / 16;
    if(mouse.state == SDL_PRESSED)
    {
        clear_button_event();
        w.mb= 1;
    }
    
    SDL_MouseWheelEvent wheel= wheel_event();
    w.wx= 0;
    w.wy= 0;
    if(wheel.x != 0 || wheel.y != 0)
    {
        clear_wheel_event();
        w.wx= wheel.x;
        w.wy= wheel.y;
    }
    
    SDL_KeyboardEvent key= key_event( );
    w.key= 0;
    w.mod= 0;
    if(key.type == SDL_KEYDOWN)
    {
        clear_key_event();
        w.key= key.keysym.sym;
        w.mod= key.keysym.mod;
        
        // filtre les touches speciales
        switch(w.key)
        {
            case SDLK_SPACE:
            case SDLK_BACKSPACE:
            case SDLK_DELETE:
            case SDLK_UP:
            case SDLK_DOWN:
            case SDLK_PAGEUP:
            case SDLK_PAGEDOWN:
            case SDLK_LEFT:
            case SDLK_RIGHT:
            case SDLK_RETURN:
                break;
            default:
                w.key= 0;
        }
    }
    
    SDL_TextInputEvent input= text_event();
    if(input.text[0] != 0)
    {
        w.key= input.text[0];
        clear_text_event();
    }
}

begin_line()

void begin_line

(

Widgets &

widgets

)

place les prochains elements sur une nouvelle ligne.

Definition at line 129 of file widgets.cpp.

{
    // place le prochain widget sur une nouvelle ligne
    w.px= 0;
    w.py= w.py +1;
}

label()

void label	(	Widgets &	widgets,
		const char *	format,
			... )

cree un texte. meme fonctionnement que printf().

Definition at line 142 of file widgets.cpp.

{
    char tmp[4096] = { 0 };
    
    va_list args;
    va_start(args, format);
    vsnprintf(tmp, sizeof(tmp), format, args);
    va_end(args);
    
    Rect r= place(w, tmp);
    print(w.console, r.x, r.y, tmp);
}

button()

bool button	(	Widgets &	widgets,
		const char *	text,
		int &	status )

cree un bouton. renvoie true si le bouton a change d'etat.

Parameters

text	legende du bouton,
status	etat du bouton, 1 selectionne, 0 non selectionne. doit etre initialise a 0 avant la premiere utilisation.

Definition at line 155 of file widgets.cpp.

{
    Rect r= place(w, (int) strlen(text) +2);
    
    bool change= false;
    if(w.mb > 0 && overlap(r, w.mx, w.my))
    {
        change= true;
        status= (status + 1) % 2;
    }
 
    char tmp[128];
    sprintf(tmp, "%c %s", (status != 0) ? 22 : 20, text);  // strlen(text) + 2
 
    print(w.console, r.x, r.y, tmp);
    return change;
}

select()

bool select	(	Widgets &	widgets,
		const char *	text,
		const int	option,
		int &	status )

cree un radio bouton. selectionne une seule option parmis une liste. renvoie true si le bouton a change d'etat.

Parameters

text	legende du bouton,
option	position du bouton dans le groupe,
status	option/bouton selectionne. doit etre initialise avec l'option par defaut avant la premiere utilisation.

Definition at line 173 of file widgets.cpp.

{
    Rect r= place(w, (int) strlen(text) +2);
    
    bool change= false;
    if(w.mb > 0 && overlap(r, w.mx, w.my))
    {
        change= true;
        status= option;
    }
 
    char tmp[128];
    sprintf(tmp, "%c %s", (status == option) ? 4 : 3, text);  // strlen(text) + 2
 
    print(w.console, r.x, r.y, tmp);
    return change;
}

text_area()

void text_area	(	Widgets &	w,
		const int	height,
		const char *	text,
		int &	begin_line )

cree une zone de texte scrollable.

Parameters

height	nombre de lignes.
text	contenu a afficher.
begin_line	premiere ligne du texte a afficher. doit etre initialise avant la premiere utilisation.

Definition at line 273 of file widgets.cpp.

{
    Rect r= place(w, 128, height);
    
    if(overlap(r, w.mx, w.my))
    {
        if(w.wy != 0)
            begin_line= begin_line - w.wy;
        if(w.key == SDLK_PAGEUP)
            begin_line= begin_line - height;
        if(w.key == SDLK_PAGEDOWN)
            begin_line= begin_line + height;
        if(w.key == SDLK_SPACE)
            begin_line= begin_line + height / 2;
        if(w.key == SDLK_UP)
            begin_line= begin_line - 1;
        if(w.key == SDLK_DOWN)
            begin_line= begin_line + 1;
    }
    
    // compter les lignes
    int n= 1;
    for(int i= 0; text[i] != 0; i++)
        if(text[i] == '\n')
            n++;
    // ligne de depart, pout que tout le texte reste affiche
    if(begin_line + height > n)
        begin_line= n - height;
    if(begin_line < 1)
        begin_line= 1;
    // retrouve le debut de la ligne
    int line= 1;
    int offset= 0;
    for(int i= 0; text[i] != 0; i++)
    {
        if(text[i] == '\n')
        {
            line++;
            if(line == begin_line)
                offset= i;
        }
    }
    // affiche le texte
    print(w.console, r.x, r.y, text + offset);
}

edit()

bool edit	(	Widgets &	widgets,
		const int	text_size,
		char *	text )

cree un champ texte editable. renvoie true si le contenu a change.

Parameters

text_size	taille du champ texte et de la chaine text, zero inclus. si text_size fait 10 caracteres, on ne pourra saisir que 9 caracteres.
text	contenu du champ, doit etre initialise avant la premiere utilisation.

char valeur[32]= "";
 
int draw( )
{
    begin(widgets);
    edit(widgets, sizeof(valeur), valeur);
    end(widgets);
    
    draw(widgets, window_width(), window_height());
}

Definition at line 319 of file widgets.cpp.

{
    assert(text_size > 1);
    int size= std::min((int) strlen(text), text_size -2);
    Rect r= place(w, text_size -1);
    
    // focus
    bool change= false;
    if(w.mb > 0)
    {
        if(overlap(r, w.mx, w.my))
        {
            w.focus= 1;
            w.fx= w.mx;
            w.fy= w.my;
            
            if(w.fx >= r.x + size)
                w.fx= r.x + size;
        }
        
        else
            change= (w.focus > 0);      // click en dehors de la zone editable
    }
    
    // edition
    bool focus= overlap(r, w.fx, w.fy);
    if(focus && w.key > 0)
    {
        int c= w.fx - r.x;
        assert(c < text_size -1);
        
        if(w.key == SDLK_BACKSPACE)
        {
            w.fx--;     // curseur a gauche
            for(int i= c -1; i >= 0 && i+1 < text_size; i++) text[i]= text[i+1];
        }
        else if(w.key == SDLK_DELETE)
        {
            // curseur ne bouge pas
            for(int i= c; i+1 < text_size; i++) text[i]= text[i+1];
        }
        else if(w.key == SDLK_LEFT)
        {
            w.fx--;     // curseur a gauche
        }
        else if(w.key == SDLK_RIGHT)
        {
            w.fx++;     // curseur a droite
        }
        else if(w.key == SDLK_RETURN)
        {
            w.focus= 0;
            change= true;
        }
        else
        {
            w.fx++;     // curseur a droite
            for(int i= text_size -1; i > c; i--) text[i]= text[i -1];
            text[c]= w.key;
 
            if(size < text_size - 2)
                size++;
            text[size+1]= 0;
        }
        
        // verifier que le curseur reste dans la zone editable
        if(w.fx < r.x)
            w.fx= r.x;
        if(w.fx >= r.x + size)
            w.fx= r.x + size;
    }
    
    int i= 0;
    char tmp[128];
    for(; text[i] != 0; i++) tmp[i]= text[i];   // copie les caracteres
    for(; i < text_size; i++) tmp[i]= ' ';      // complete avec des espaces
    tmp[text_size -1]= 0;                       // termine avec un 0
 
    print_background(w.console, r.x, r.y, tmp);
    if(focus)
        print_background(w.console, w.fx, w.fy, text[w.fx - r.x], 1);
    
    return change;
}

value() [1/2]

bool value	(	Widgets &	widgets,
		const char *	label,
		int &	value,
		const int	value_min,
		const int	value_max,
		const int	value_step )

valeur editable par increment.

Definition at line 191 of file widgets.cpp.

{
    char tmp[128];
    sprintf(tmp, "%s: %4d", label, value);
    
    Rect r= place(w, (int) strlen(tmp));
 
    bool change= false;
    if(w.mb > 0 && overlap(r, w.mx, w.my))
        change= true;
    if(overlap(r, w.mx, w.my))
    {
        if(w.wy != 0)
            value= value + w.wy * value_step;
        if(w.key == SDLK_UP)
            value= value + value_step;
        if(w.key == SDLK_PAGEUP)
            value= value + value_step * 10;
        if(w.key == SDLK_DOWN)
            value= value - value_step;
        if(w.key == SDLK_PAGEDOWN)
            value= value - value_step * 10;
        
        if(value < value_min)
            value= value_min;
        if(value > value_max)
            value= value_max;
        
        sprintf(tmp, "%s: ", label);
        int l= (int) strlen(tmp);
        print(w.console, r.x, r.y, tmp);
        
        sprintf(tmp, "%4d", value);
        print_background(w.console, r.x + l, r.y, tmp);
    }
    else
        print(w.console, r.x, r.y, tmp);
    
    return change;
}

value() [2/2]

bool value	(	Widgets &	widgets,
		const char *	label,
		float &	value,
		const float	value_min,
		const float	value_max,
		const float	value_step )

valeur editable par increment.

Definition at line 232 of file widgets.cpp.

{
    char tmp[128];
    sprintf(tmp, "%s: %.6f", label, value);
    
    Rect r= place(w, (int) strlen(tmp));
 
    bool change= false;
    if(w.mb > 0 && overlap(r, w.mx, w.my))
        change= true;
    if(overlap(r, w.mx, w.my))
    {
        if(w.wy != 0)
            value= value + w.wy * value_step;
        if(w.key == SDLK_UP)
            value= value + value_step;
        if(w.key == SDLK_PAGEUP)
            value= value + value_step * 10;
        if(w.key == SDLK_DOWN)
            value= value - value_step;
        if(w.key == SDLK_PAGEDOWN)
            value= value - value_step * 10;
        
        if(value < value_min)
            value= value_min;
        if(value > value_max)
            value= value_max;
        
        sprintf(tmp, "%s: ", label);
        int l= (int) strlen(tmp);
        print(w.console, r.x, r.y, tmp);
        
        sprintf(tmp, "%.6f", value);
        print_background(w.console, r.x + l, r.y, tmp);
    }
    else
        print(w.console, r.x, r.y, tmp);
    
    return change;
}

end_line()

void end_line

(

Widgets &

widgets

)

termine la description des elements de la ligne.

Definition at line 136 of file widgets.cpp.

{
    return;
}

end()

void end

(

Widgets &

widgets

)

termine la description des elements de l'interface graphique.

Definition at line 404 of file widgets.cpp.

{
    return;
}

default_color() [2/2]

void default_color	(	Widgets &	widgets,
		const Color &	color )

choisit une couleur par defaut pour le texte.

Definition at line 409 of file widgets.cpp.

{
    default_color(w.console, color);
}

draw() [2/2]

void draw	(	Widgets &	widgets,
		const int	width,
		const int	height )

affiche les elements decrits entre begin() et end().

Definition at line 414 of file widgets.cpp.

{
    draw(w.console, width, height);
}

window_msaa() [1/2]

void window_msaa

(

const int

samples

)

option mssa. utiliser avant la creation de la fenetre avec create_window().

Definition at line 47 of file window.cpp.

{
    msaa= samples;
}

window_srgb() [1/2]

void window_srgb

(

const bool

flag

)

option srgb. utiliser avant la creation de la fenetre avec create_window().

Definition at line 57 of file window.cpp.

{
    srgb= flag;
}

window_resize() [1/2]

void window_resize

(

const bool

flag

)

option resize. permet de creer une fenetre de taille fixe, ou pas.

Definition at line 33 of file window.cpp.

{
    resize= flag;
}

create_window()

Window create_window	(	const int	width,
		const int	height,
		const int	major = 3,
		const int	minor = 2 )

creation d'une fenetre pour l'application.

Definition at line 270 of file window.cpp.

{
    // init sdl
    if(SDL_Init(SDL_INIT_VIDEO | SDL_INIT_EVENTS) < 0)
    {
        printf("[error] SDL_Init() failed:\n%s\n", SDL_GetError());
        return nullptr;
    }
    
    // enregistre le destructeur de sdl
    atexit(SDL_Quit);
    
    // configuration openGL
#ifndef GK_OPENGLES
    printf("creating window(%d, %d) openGL %d.%d....\n", w, h, major, minor);
    
    SDL_GL_SetAttribute(SDL_GL_CONTEXT_MAJOR_VERSION, major);
    SDL_GL_SetAttribute(SDL_GL_CONTEXT_MINOR_VERSION, minor);
#ifndef GK_RELEASE
    SDL_GL_SetAttribute(SDL_GL_CONTEXT_FLAGS, SDL_GL_CONTEXT_DEBUG_FLAG);
#endif
    SDL_GL_SetAttribute(SDL_GL_CONTEXT_PROFILE_MASK, SDL_GL_CONTEXT_PROFILE_CORE);
    
    SDL_GL_SetAttribute(SDL_GL_DEPTH_SIZE, 24);
    SDL_GL_SetAttribute(SDL_GL_FRAMEBUFFER_SRGB_CAPABLE, srgb ? 1 : 0);
    SDL_GL_SetAttribute(SDL_GL_DOUBLEBUFFER, 1);
    
    if(msaa > 1)
    {
        SDL_GL_SetAttribute(SDL_GL_MULTISAMPLEBUFFERS, 1);
        SDL_GL_SetAttribute(SDL_GL_MULTISAMPLESAMPLES, msaa);
    }
    
#else
    printf("creating window(%d, %d) openGL ES 3.0...\n", w, h);
 
    SDL_GL_SetAttribute(SDL_GL_CONTEXT_MAJOR_VERSION, 3);
    SDL_GL_SetAttribute(SDL_GL_CONTEXT_MINOR_VERSION, 0);
    SDL_GL_SetAttribute(SDL_GL_CONTEXT_PROFILE_MASK, SDL_GL_CONTEXT_PROFILE_ES);
    SDL_GL_SetAttribute(SDL_GL_DOUBLEBUFFER, 1);
#endif
    
    // creer la fenetre
    unsigned flags= SDL_WINDOW_OPENGL;
    if(resize) flags|= SDL_WINDOW_RESIZABLE;
    
    Window window= SDL_CreateWindow("gKit", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, w, h, flags);
    if(window == nullptr)
    {
        printf("[error] SDL_CreateWindow() failed.\n");
        return nullptr;
    }
    
    // recupere l'etat du clavier
    int keys;
    const unsigned char *state= SDL_GetKeyboardState(&keys);
    key_states.assign(state, state + keys);
    
    SDL_SetWindowDisplayMode(window, nullptr);
    SDL_StartTextInput();
 
    // conserve les dimensions de la fenetre
    SDL_GetWindowSize(window, &width, &height);
    
    return window;
}

release_window()

void release_window

(

Window

w

)

destruction de la fenetre.

Definition at line 337 of file window.cpp.

{
    SDL_StopTextInput();
    SDL_DestroyWindow(window);
}

create_context()

Context create_context

(

Window

window

)

cree et configure un contexte opengl.

cree et configure un contexte opengl

cree et configure un contexte opengl.

Definition at line 367 of file window.cpp.

{
    if(window == nullptr)
        return nullptr;
    
    Context context= SDL_GL_CreateContext(window);
    if(context == nullptr)
    {
        printf("[error] creating openGL context.\n");
        return nullptr;
    }
    
    if(SDL_GL_SetSwapInterval(-1) != 0)
        printf("[warning] can't set adaptive vsync...\n");
    
    if(SDL_GL_GetSwapInterval() != -1)
    {
        printf("vsync ON\n");
        SDL_GL_SetSwapInterval(1);
    }
    else
        printf("adaptive vsync ON\n");
    
    {
        int n= 0;
        SDL_GL_GetAttribute(SDL_GL_MULTISAMPLESAMPLES, &n);
        if(n > 1)
            printf("MSAA %d samples\n", n);
        msaa= n;
    }
    
    {
        int bits= 0;
        SDL_GL_GetAttribute(SDL_GL_DEPTH_SIZE, &bits);
        if(bits > 0)
            printf("Zbuffer %d bits\n", bits);
    }
    
    {
        int flag= 0;
        SDL_GL_GetAttribute(SDL_GL_FRAMEBUFFER_SRGB_CAPABLE, &flag);
        if(flag)
            printf("sRGB framebuffer ON\n");
 
        srgb= flag;
    }
    
    //
    app_start= std::chrono::high_resolution_clock::now();
    
#ifndef NO_GLAD
    // initialise les extensions opengl
    gladLoadGLLoader( GLADloadproc(SDL_GL_GetProcAddress) );
    
    // purge les erreurs opengl generees par glew !
    while(glGetError() != GL_NO_ERROR) {;}
 
#ifndef GK_RELEASE
    // configure l'affichage des messages d'erreurs opengl, si l'extension est disponible
    // inclut dans openGL 4.3, mais pas dispo sur mac...
    if(GLAD_GL_ARB_debug_output)
    {
        printf("debug output enabled...\n");
        // selectionne tous les messages
        glDebugMessageControlARB(GL_DONT_CARE, GL_DONT_CARE, GL_DONT_CARE, 0, NULL, GL_TRUE);
        // desactive les messages du compilateur de shaders
        glDebugMessageControlARB(GL_DEBUG_SOURCE_SHADER_COMPILER, GL_DONT_CARE, GL_DONT_CARE, 0, NULL, GL_FALSE);
        
        glDebugMessageCallbackARB(debug_print, NULL);
        glEnable(GL_DEBUG_OUTPUT_SYNCHRONOUS_ARB);
    }
#endif
#endif
 
    if(srgb)
        glEnable(GL_FRAMEBUFFER_SRGB);
    
    return context;
}

release_context()

void release_context

(

Context

context

)

detruit le contexte openGL.

Definition at line 447 of file window.cpp.

{
    SDL_GL_DeleteContext(context);
}

window_width()

int window_width

(

)

renvoie la largeur de la fenetre de l'application.

Definition at line 23 of file window.cpp.

{
    return width;
}

window_height()

int window_height

(

)

renvoie la hauteur de la fenetre de l'application.

Definition at line 27 of file window.cpp.

{
    return height;
}

window_resize() [2/2]

bool window_resize

(

)

renvoie vrai si la fenetre peut etre redimensionnee.

Definition at line 37 of file window.cpp.

{
    return resize;
}

window_msaa() [2/2]

int window_msaa

(

)

renvoie le nombre de samples MSAA.

Definition at line 43 of file window.cpp.

{
    return msaa;
}

window_srgb() [2/2]

bool window_srgb

(

)

renvoie le mode srgb de la fenetre de l'application.

Definition at line 53 of file window.cpp.

{
    return srgb;
}

key_state()

int key_state

(

const SDL_Keycode

key

)

renvoie l'etat d'une touche du clavier. cf la doc SDL2 pour les codes.

Definition at line 63 of file window.cpp.

{
    SDL_Scancode code= SDL_GetScancodeFromKey(key);
    assert((size_t) code < key_states.size());
    return (int)  key_states[code];
}

clear_key_state()

void clear_key_state

(

const SDL_Keycode

key

)

desactive une touche du clavier.

Definition at line 69 of file window.cpp.

{
    SDL_Scancode code= SDL_GetScancodeFromKey(key);
    assert((size_t) code < key_states.size());
    key_states[code]= 0;
}

key_event()

SDL_KeyboardEvent key_event

(

)

renvoie le dernier evenement. touche speciales.

Definition at line 77 of file window.cpp.

{
    return last_key;
}

clear_key_event()

void clear_key_event

(

)

desactive l'evenement.

Definition at line 81 of file window.cpp.

{
    last_key.type= 0;
    last_key.keysym.sym= 0;
}

button_event()

SDL_MouseButtonEvent button_event

(

)

renvoie le dernier evenement. etat des boutons de la souris.

Definition at line 119 of file window.cpp.

{
    return last_button;
}

clear_button_event()

void clear_button_event

(

)

desactive l'evenement.

Definition at line 123 of file window.cpp.

{
    last_button.state= 0;
}

wheel_event()

SDL_MouseWheelEvent wheel_event

(

)

renvoie le dernier evenement. etat de la molette de la souris / glisser sur le pad.

Definition at line 129 of file window.cpp.

{
    return last_wheel;
}

clear_wheel_event()

void clear_wheel_event

(

)

desactive l'evenement.

Definition at line 133 of file window.cpp.

{
    last_wheel.x= 0;
    last_wheel.y= 0;
}

text_event()

SDL_TextInputEvent text_event

(

)

renvoie le dernier evenement. saisie de texte.

Definition at line 88 of file window.cpp.

{
    return last_text;
}

clear_text_event()

void clear_text_event

(

)

desactive l'evenement.

Definition at line 92 of file window.cpp.

{
    last_text.text[0]= 0;
}

global_time()

float global_time

(

)

renvoie le temps ecoule depuis le lancement de l'application, en millisecondes.

Definition at line 145 of file window.cpp.

{
    std::chrono::high_resolution_clock::time_point now= std::chrono::high_resolution_clock::now();
    last_delta= float(std::chrono::duration_cast<std::chrono::microseconds>(now - last_time).count()) / float(1000);
    last_time= now;
    
    return float(std::chrono::duration_cast<std::chrono::microseconds>(now - app_start).count()) / float(1000);
}

delta_time()

float delta_time

(

)

renvoie le temps ecoule depuis la derniere frame, en millisecondes.

Definition at line 154 of file window.cpp.

{
// pas super utile, a virer ?
    return last_delta;
}

run()

int run	(	Window	window,
		int(*	draw )() )

fonction principale. gestion des evenements et appel de la fonction draw de l'application.

boucle de gestion des evenements de l'application.

fonction principale. gestion des evenements et appel de la fonction draw de l'application.

Definition at line 164 of file window.cpp.

{
    // configure openGL
    glViewport(0, 0, width, height);
 
    // run
    while(events(window))
    {
        // dessiner
        if(draw() < 1)
            stop= 1;    // fermer l'application si draw() renvoie 0 ou -1...
        
        // presenter le resultat
        SDL_GL_SwapWindow(window);
    }
    
    return 0;
}

last_event_count()

int last_event_count

(

)

Definition at line 184 of file window.cpp.

{ 
    return event_count; 
}

events()

int events

(

Window

window

)

fonction interne de gestion d'evenements.

Definition at line 189 of file window.cpp.

{
    bool resize_event= false;
    
    // gestion des evenements
    SDL_Event event;
    while(SDL_PollEvent(&event))
    {
        switch(event.type)
        {
            case SDL_WINDOWEVENT:
                // redimensionner la fenetre...
                if(event.window.event == SDL_WINDOWEVENT_RESIZED)
                {
                    // traite l'evenement apres la boucle... 
                    resize_event= true;
                    
                    // conserve les proportions de la fenetre
                    width= event.window.data1;
                    height= event.window.data2;
                }
                break;
            
            case SDL_DROPFILE:
                //~ printf("drop file '%s'\n", event.drop.file);
                last_drops.push_back(std::string(event.drop.file));
                SDL_free(event.drop.file);
                break;
            
            case SDL_TEXTINPUT:
                // conserver le dernier caractere
                last_text= event.text;
                break;
            
            case SDL_KEYDOWN:
                // modifier l'etat du clavier
                if((size_t) event.key.keysym.scancode < key_states.size())
                {
                    key_states[event.key.keysym.scancode]= 1;
                    last_key= event.key;    // conserver le dernier evenement
                }
                
                // fermer l'application
                if(event.key.keysym.sym == SDLK_ESCAPE)
                    stop= 1;
                break;
            
            case SDL_KEYUP:
                // modifier l'etat du clavier
                if((size_t) event.key.keysym.scancode < key_states.size())
                {
                    key_states[event.key.keysym.scancode]= 0;
                    last_key= event.key;    // conserver le dernier evenement
                }
                break;
            
            case SDL_MOUSEBUTTONDOWN:
            case SDL_MOUSEBUTTONUP:
                last_button= event.button;
                break;
            
            case SDL_MOUSEWHEEL:
                last_wheel= event.wheel;
                break;
            
            case SDL_QUIT:
                stop= 1;            // fermer l'application
                break;
        }
    }
 
    if(resize_event)
    {
        glViewport(0, 0, width, height);
    }
    
    return 1 - stop;
}

smart_path()

const char * smart_path

(

const char *

filename

)

renvoie le chemin(path) vers le fichier 'filename' apres l'avoir cherche dans un repertoire standard...

Definition at line 456 of file window.cpp.

{
    if(exists(filename))
        return filename;
 
    if(path.empty())
    {
        // recupere la variable d'environnement, si elle existe
        const char *envbase= std::getenv("GKIT_BASE_PATH");
        if(envbase != nullptr)
        {
            path= std::string(envbase);
            if(!path.empty() && path[path.size() -1] != '/')
            {
                path.append("/");       // force un /, si necessaire
                printf("[base path] %s\n", path.c_str());
            }
        }
    }
    
    if(path.empty())
    {
        char *base= SDL_GetBasePath();
        printf("[base path] %s\n", base);
        path= base;
        SDL_free(base);
    }
    
    smartpath= path + filename;
    if(exists(smartpath.c_str()))
        return smartpath.c_str();
 
    smartpath= path + "../" + filename;
    if(exists(smartpath.c_str()))
        return smartpath.c_str();
    
    return filename; // echec, fichier pas trouve, renvoie quand meme le fichier original. 
    // (permet au moins d'afficher l'erreur fichier non trouve dans l'application)
}

drop_event()

const char * drop_event

(

)

drag/drop, renvoie le dernier fichier.

Definition at line 102 of file window.cpp.

{
    if(last_drops.empty())
        return nullptr;
    else
        return last_drops.back().c_str();
}

clear_drop_event()

void clear_drop_event

(

)

desactive drag/drop.

Definition at line 109 of file window.cpp.

{
    last_drops.clear();
}

drop_events()

const std::vector< std::string > & drop_events

(

)

drag/drop. recupere tous les fichiers.

Definition at line 98 of file window.cpp.

{
    return last_drops;
}

clear_drop_events()

void clear_drop_events

(

)

desactive drag/drop.

Definition at line 113 of file window.cpp.

{
    last_drops.clear();
}