155 lines
3.7 KiB
Groff
155 lines
3.7 KiB
Groff
|
.TH "src/graphics/init.c" 3 "Version 0.1.0" "Gem-graph" \" -*- nroff -*-
|
||
|
|
.ad l
|
||
|
|
.nh
|
||
|
|
.SH NAME
|
||
|
|
src/graphics/init.c \- graphics - initialization and graphic stack management
|
||
|
|
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.br
|
||
|
|
.PP
|
||
|
|
\fC#include '\&.\&./\&.\&./include/graphics\&.h'\fP
|
||
|
|
.br
|
||
|
|
\fC#include '\&.\&./\&.\&./include/parse\&.h'\fP
|
||
|
|
.br
|
||
|
|
\fC#include '\&.\&./\&.\&./include/util\&.h'\fP
|
||
|
|
.br
|
||
|
|
|
||
|
|
.SS "Macros"
|
||
|
|
|
||
|
|
.in +1c
|
||
|
|
.ti -1c
|
||
|
|
.RI "#define \fBTEST\fP 0"
|
||
|
|
.br
|
||
|
|
.in -1c
|
||
|
|
.SS "Functions"
|
||
|
|
|
||
|
|
.in +1c
|
||
|
|
.ti -1c
|
||
|
|
.RI "int \fBgraphics_init\fP (void *error_buffer)"
|
||
|
|
.br
|
||
|
|
.RI "Initializes graphical stack\&. "
|
||
|
|
.ti -1c
|
||
|
|
.RI "bool \fBgraphics_shutdown\fP (const int id, void *error_buffer)"
|
||
|
|
.br
|
||
|
|
.RI "Shutdowns a gl_area\&. "
|
||
|
|
.ti -1c
|
||
|
|
.RI "void \fBgraphics_model_setup\fP (const int stack_id)"
|
||
|
|
.br
|
||
|
|
.RI "TODO #pragma omp parallel schedule(static, 12) void \fBattribute\fP((optimize('no-unroll-loops'))) main_test_graphics (void) {}\&. "
|
||
|
|
.ti -1c
|
||
|
|
.RI "void \fBgraphics_init_buffers\fP (const int stack_id)"
|
||
|
|
.br
|
||
|
|
.RI "Initializes the buffer of a gl_area Calls according to the user preferences\&. "
|
||
|
|
.ti -1c
|
||
|
|
.RI "bool \fBgraphics_init_shaders\fP (const int stack_id)"
|
||
|
|
.br
|
||
|
|
.RI "Initializes the shaders of a gl_area and link them to a program\&. "
|
||
|
|
.in -1c
|
||
|
|
.SS "Variables"
|
||
|
|
|
||
|
|
.in +1c
|
||
|
|
.ti -1c
|
||
|
|
.RI "struct \fBgraphics_stack_t\fP * \fBgraphics_stack\fP = NULL"
|
||
|
|
.br
|
||
|
|
.RI "phantom documentation used to test the functioning of doxygen "
|
||
|
|
.ti -1c
|
||
|
|
.RI "size_t \fBgraphics_stack_size\fP = 0"
|
||
|
|
.br
|
||
|
|
.ti -1c
|
||
|
|
.RI "int * \fBfree_stack_slot\fP = NULL"
|
||
|
|
.br
|
||
|
|
.ti -1c
|
||
|
|
.RI "size_t \fBfree_stack_slot_size\fP = 0"
|
||
|
|
.br
|
||
|
|
.in -1c
|
||
|
|
.SH "Detailed Description"
|
||
|
|
.PP
|
||
|
|
graphics - initialization and graphic stack management
|
||
|
|
|
||
|
|
This file is part of Gem-graph\&.
|
||
|
|
.SH "Function Documentation"
|
||
|
|
.PP
|
||
|
|
.SS "int graphics_init (void * error_buffer)"
|
||
|
|
|
||
|
|
.PP
|
||
|
|
Initializes graphical stack\&. Initializes a gl_area\&.
|
||
|
|
.PP
|
||
|
|
\fBParameters\fP
|
||
|
|
.RS 4
|
||
|
|
\fIgl_area,ptr\fP to the gl_area widget
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBReturns\fP
|
||
|
|
.RS 4
|
||
|
|
id if initialized
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
|
||
|
|
.SS "void graphics_init_buffers (const int stack_id)"
|
||
|
|
|
||
|
|
.PP
|
||
|
|
Initializes the buffer of a gl_area Calls according to the user preferences\&.
|
||
|
|
.PP
|
||
|
|
\fBParameters\fP
|
||
|
|
.RS 4
|
||
|
|
\fIgl_area,ptr\fP to the gl_area widget
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBReturns\fP
|
||
|
|
.RS 4
|
||
|
|
void
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
|
||
|
|
.SS "bool graphics_init_shaders (const int stack_id)"
|
||
|
|
|
||
|
|
.PP
|
||
|
|
Initializes the shaders of a gl_area and link them to a program\&.
|
||
|
|
.PP
|
||
|
|
\fBParameters\fP
|
||
|
|
.RS 4
|
||
|
|
\fIgl_area,ptr\fP to the gl_area widget
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBReturns\fP
|
||
|
|
.RS 4
|
||
|
|
true if initialized
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
|
||
|
|
.SS "void graphics_model_setup (const int stack_id)"
|
||
|
|
|
||
|
|
.PP
|
||
|
|
TODO #pragma omp parallel schedule(static, 12) void \fBattribute\fP((optimize('no-unroll-loops'))) main_test_graphics (void) {}\&. assert : space dimensions (x,y,z) > 0 assert : arrows localization within space and sites assert : no more than one arrow per address notify : weights are replaced, NOT added (could be !)
|
||
|
|
.PP
|
||
|
|
Init space and arrows (= initial state) and allows ulterior creations, suppressions or modifications of the arrows[] array
|
||
|
|
.PP
|
||
|
|
draws the space() triggers graphics_set_arrows() that modifies the list () and draws arrows
|
||
|
|
.PP
|
||
|
|
Initialisation du générateur pseudo-aléatoire Attention, les vertex centraux de chaque unité d'espace (cube) peuvent être redondants (max 6)
|
||
|
|
.SS "bool graphics_shutdown (const int id, void * error_buffer)"
|
||
|
|
|
||
|
|
.PP
|
||
|
|
Shutdowns a gl_area\&. Draws the current buffer to a gl_area\&.
|
||
|
|
.PP
|
||
|
|
\fBParameters\fP
|
||
|
|
.RS 4
|
||
|
|
\fIgl_area,ptr\fP to the gl_area widget
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBReturns\fP
|
||
|
|
.RS 4
|
||
|
|
true if success
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
|
||
|
|
.SH "Variable Documentation"
|
||
|
|
.PP
|
||
|
|
.SS "struct \fBgraphics_stack_t\fP* graphics_stack = NULL"
|
||
|
|
|
||
|
|
.PP
|
||
|
|
phantom documentation used to test the functioning of doxygen Dynamic array of ptrs to dynamically allocated gl_area_entry\&.
|
||
|
|
.SH "Author"
|
||
|
|
.PP
|
||
|
|
Generated automatically by Doxygen for Gem-graph from the source code\&.
|