2024-10-19 16:05:49 +02:00
|
|
|
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
|
|
|
|
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="_init_8c" xml:lang="en-US">
|
|
|
|
<title>src/graphics/init.c File Reference</title>
|
|
|
|
<indexterm><primary>src/graphics/init.c</primary></indexterm>
|
|
|
|
<para>
|
|
|
|
|
2024-10-24 09:12:19 +02:00
|
|
|
<para>initialization and graphic stack management </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
|
|
|
</para>
|
|
|
|
<programlisting linenumbering="unnumbered">#include "../../include/graphics.h"<?linebreak?>#include "../../include/parse.h"<?linebreak?>#include "../../include/util.h"<?linebreak?></programlisting><simplesect>
|
|
|
|
<title>Macros </title>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para><anchor xml:id="_init_8c_1ab946e2e7f7679350627acfded8e2658b"/>#define <emphasis role="strong">TEST</emphasis>   0</para>
|
2024-10-20 23:03:17 +02:00
|
|
|
|
|
|
|
<para>phantom documentation </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</simplesect>
|
|
|
|
<simplesect>
|
|
|
|
<title>Functions </title>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para>int <link linkend="_init_8c_1a5a4ed7438a755777b162fc37e84ba93a">graphics_init</link> (void *error_buffer)</para>
|
|
|
|
|
2024-10-20 23:03:17 +02:00
|
|
|
<para>Initializes a gl_area. </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</listitem>
|
|
|
|
<listitem><para>bool <link linkend="_init_8c_1aa4d80f7ee104aa414e7ed4b90e0eac88">graphics_shutdown</link> (const int id, void *error_buffer)</para>
|
|
|
|
|
|
|
|
<para>Shutdowns a gl_area. </para>
|
|
|
|
</listitem>
|
2024-10-22 23:58:04 +02:00
|
|
|
<listitem><para>void <link linkend="_init_8c_1a76f5c593f1d55ebbc838437d9240ad8a">graphics_model_setup</link> (const int graphics_stack_id)</para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
2024-10-20 01:05:12 +02:00
|
|
|
<para>graphics_model_setup </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</listitem>
|
2024-10-22 23:58:04 +02:00
|
|
|
<listitem><para>void <link linkend="_init_8c_1aa86924f99e2a17fcb4e33b22b8987a95">graphics_init_buffers</link> (const int graphics_stack_id)</para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
|
|
|
<para>Initializes the buffer of a gl_area Calls according to the user preferences. </para>
|
|
|
|
</listitem>
|
2024-10-22 23:58:04 +02:00
|
|
|
<listitem><para>bool <link linkend="_init_8c_1ac5ba153022c8589d2cd83442197e163e">graphics_init_shaders</link> (const int graphics_stack_id)</para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
|
|
|
<para>Initializes the shaders of a gl_area and link them to a program. </para>
|
|
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</simplesect>
|
|
|
|
<simplesect>
|
|
|
|
<title>Variables </title>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para>struct <link linkend="_structgraphics__stack__t">graphics_stack_t</link> * <link linkend="_init_8c_1ad2cd7fe4849c259e9dedcc6e7e795aaf">graphics_stack</link> = NULL</para>
|
|
|
|
|
2024-10-20 23:03:17 +02:00
|
|
|
<para>phantom documentation </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</listitem>
|
|
|
|
<listitem><para><anchor xml:id="_init_8c_1a86ecb95bf1c1a30d42b02f6811b83e4c"/>size_t <emphasis role="strong">graphics_stack_size</emphasis> = 0</para>
|
2024-10-20 23:03:17 +02:00
|
|
|
|
|
|
|
<para>phantom documentation </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</listitem>
|
|
|
|
<listitem><para><anchor xml:id="_init_8c_1a7e77f440f52c90c921a5bdc003c3b03b"/>int * <emphasis role="strong">free_stack_slot</emphasis> = NULL</para>
|
2024-10-20 23:03:17 +02:00
|
|
|
|
|
|
|
<para>phantom documentation </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</listitem>
|
|
|
|
<listitem><para><anchor xml:id="_init_8c_1a29d09eb6569a8bfc0439eac245102077"/>size_t <emphasis role="strong">free_stack_slot_size</emphasis> = 0</para>
|
2024-10-20 23:03:17 +02:00
|
|
|
|
|
|
|
<para>phantom documentation </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</simplesect>
|
|
|
|
<section>
|
|
|
|
<title>Detailed Description</title>
|
|
|
|
|
2024-10-24 09:12:19 +02:00
|
|
|
<para>initialization and graphic stack management </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
|
|
|
<para>This file is part of Gem-graph. </para>
|
|
|
|
</section>
|
|
|
|
<section>
|
|
|
|
<title>Function Documentation</title>
|
|
|
|
<anchor xml:id="_init_8c_1a5a4ed7438a755777b162fc37e84ba93a"/><section>
|
|
|
|
<title>graphics_init()</title>
|
|
|
|
<indexterm><primary>graphics_init</primary><secondary>init.c</secondary></indexterm>
|
|
|
|
<indexterm><primary>init.c</primary><secondary>graphics_init</secondary></indexterm>
|
|
|
|
<para><computeroutput>int graphics_init (void * error_buffer)</computeroutput></para><para>
|
|
|
|
|
2024-10-20 23:03:17 +02:00
|
|
|
<para>Initializes a gl_area. </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</para>
|
|
|
|
|
2024-10-22 23:58:04 +02:00
|
|
|
<para>param *error_buffer < DO NOT DOCUMENT (it's 'void')</para>
|
|
|
|
|
|
|
|
<para><formalpara><title>Returns</title>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
2024-10-20 23:03:17 +02:00
|
|
|
<para>true if initialized </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</formalpara>
|
|
|
|
</para>
|
|
|
|
</section>
|
2024-10-22 23:58:04 +02:00
|
|
|
<anchor xml:id="_init_8c_1aa86924f99e2a17fcb4e33b22b8987a95"/><section>
|
2024-10-19 16:05:49 +02:00
|
|
|
<title>graphics_init_buffers()</title>
|
|
|
|
<indexterm><primary>graphics_init_buffers</primary><secondary>init.c</secondary></indexterm>
|
|
|
|
<indexterm><primary>init.c</primary><secondary>graphics_init_buffers</secondary></indexterm>
|
2024-10-22 23:58:04 +02:00
|
|
|
<para><computeroutput>void graphics_init_buffers (const int graphics_stack_id)</computeroutput></para><para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
|
|
|
<para>Initializes the buffer of a gl_area Calls according to the user preferences. </para>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<formalpara>
|
|
|
|
<title>
|
|
|
|
Parameters</title>
|
|
|
|
<para>
|
|
|
|
<table frame="all">
|
|
|
|
<tgroup cols="2" align="left" colsep="1" rowsep="1">
|
|
|
|
<colspec colwidth="1*"/>
|
|
|
|
<colspec colwidth="4*"/>
|
|
|
|
<tbody>
|
|
|
|
<row>
|
2024-10-22 23:58:04 +02:00
|
|
|
<entry>graphics_stack_id</entry><entry></entry>
|
2024-10-19 16:05:49 +02:00
|
|
|
</row>
|
|
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
|
|
</table>
|
|
|
|
</para>
|
|
|
|
</formalpara>
|
2024-10-20 23:03:17 +02:00
|
|
|
gl_area, ptr to the gl_area widget </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</section>
|
2024-10-22 23:58:04 +02:00
|
|
|
<anchor xml:id="_init_8c_1ac5ba153022c8589d2cd83442197e163e"/><section>
|
2024-10-19 16:05:49 +02:00
|
|
|
<title>graphics_init_shaders()</title>
|
|
|
|
<indexterm><primary>graphics_init_shaders</primary><secondary>init.c</secondary></indexterm>
|
|
|
|
<indexterm><primary>init.c</primary><secondary>graphics_init_shaders</secondary></indexterm>
|
2024-10-22 23:58:04 +02:00
|
|
|
<para><computeroutput>bool graphics_init_shaders (const int graphics_stack_id)</computeroutput></para><para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
|
|
|
<para>Initializes the shaders of a gl_area and link them to a program. </para>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<formalpara>
|
|
|
|
<title>
|
|
|
|
Parameters</title>
|
|
|
|
<para>
|
|
|
|
<table frame="all">
|
|
|
|
<tgroup cols="2" align="left" colsep="1" rowsep="1">
|
|
|
|
<colspec colwidth="1*"/>
|
|
|
|
<colspec colwidth="4*"/>
|
|
|
|
<tbody>
|
|
|
|
<row>
|
2024-10-22 23:58:04 +02:00
|
|
|
<entry>graphics_stack_id</entry><entry></entry>
|
2024-10-19 16:05:49 +02:00
|
|
|
</row>
|
|
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
|
|
</table>
|
|
|
|
</para>
|
|
|
|
</formalpara>
|
2024-10-22 23:58:04 +02:00
|
|
|
<formalpara><title>Returns</title>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
2024-10-22 23:58:04 +02:00
|
|
|
<para>initialized </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</formalpara>
|
|
|
|
</para>
|
|
|
|
</section>
|
2024-10-22 23:58:04 +02:00
|
|
|
<anchor xml:id="_init_8c_1a76f5c593f1d55ebbc838437d9240ad8a"/><section>
|
2024-10-19 16:05:49 +02:00
|
|
|
<title>graphics_model_setup()</title>
|
|
|
|
<indexterm><primary>graphics_model_setup</primary><secondary>init.c</secondary></indexterm>
|
|
|
|
<indexterm><primary>init.c</primary><secondary>graphics_model_setup</secondary></indexterm>
|
2024-10-20 01:05:12 +02:00
|
|
|
<para><computeroutput>void graphics_model_setup (const int graphics_stack_id)</computeroutput></para><para>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
2024-10-20 01:05:12 +02:00
|
|
|
<para>graphics_model_setup </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</para>
|
|
|
|
|
2024-10-20 01:05:12 +02:00
|
|
|
<para>
|
|
|
|
<formalpara>
|
|
|
|
<title>
|
|
|
|
Parameters</title>
|
|
|
|
<para>
|
|
|
|
<table frame="all">
|
|
|
|
<tgroup cols="2" align="left" colsep="1" rowsep="1">
|
|
|
|
<colspec colwidth="1*"/>
|
|
|
|
<colspec colwidth="4*"/>
|
|
|
|
<tbody>
|
|
|
|
<row>
|
|
|
|
<entry>graphics_stack_id</entry><entry>
|
|
|
|
<para></para>
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
|
|
</table>
|
|
|
|
</para>
|
|
|
|
</formalpara>
|
|
|
|
</para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</section>
|
|
|
|
<anchor xml:id="_init_8c_1aa4d80f7ee104aa414e7ed4b90e0eac88"/><section>
|
|
|
|
<title>graphics_shutdown()</title>
|
|
|
|
<indexterm><primary>graphics_shutdown</primary><secondary>init.c</secondary></indexterm>
|
|
|
|
<indexterm><primary>init.c</primary><secondary>graphics_shutdown</secondary></indexterm>
|
|
|
|
<para><computeroutput>bool graphics_shutdown (const int id, void * error_buffer)</computeroutput></para><para>
|
|
|
|
|
|
|
|
<para>Shutdowns a gl_area. </para>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<formalpara>
|
|
|
|
<title>
|
|
|
|
Parameters</title>
|
|
|
|
<para>
|
|
|
|
<table frame="all">
|
|
|
|
<tgroup cols="2" align="left" colsep="1" rowsep="1">
|
|
|
|
<colspec colwidth="1*"/>
|
|
|
|
<colspec colwidth="4*"/>
|
|
|
|
<tbody>
|
|
|
|
<row>
|
2024-10-20 23:03:17 +02:00
|
|
|
<entry>id</entry><entry>
|
|
|
|
<para></para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
2024-10-20 23:03:17 +02:00
|
|
|
<row>
|
|
|
|
<entry>*error_buffer</entry><entry></entry>
|
|
|
|
</row>
|
2024-10-19 16:05:49 +02:00
|
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
|
|
</table>
|
|
|
|
</para>
|
|
|
|
</formalpara>
|
2024-10-22 23:58:04 +02:00
|
|
|
<formalpara><title>Returns</title>
|
2024-10-19 16:05:49 +02:00
|
|
|
|
2024-10-22 23:58:04 +02:00
|
|
|
<para>success </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</formalpara>
|
|
|
|
</para>
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
<section>
|
|
|
|
<title>Variable Documentation</title>
|
|
|
|
<anchor xml:id="_init_8c_1ad2cd7fe4849c259e9dedcc6e7e795aaf"/><section>
|
|
|
|
<title>graphics_stack</title>
|
|
|
|
<indexterm><primary>graphics_stack</primary><secondary>init.c</secondary></indexterm>
|
|
|
|
<indexterm><primary>init.c</primary><secondary>graphics_stack</secondary></indexterm>
|
|
|
|
<para><computeroutput>struct <link linkend="_structgraphics__stack__t">graphics_stack_t</link>* graphics_stack = NULL</computeroutput></para><para>
|
|
|
|
|
2024-10-20 23:03:17 +02:00
|
|
|
<para>phantom documentation </para>
|
2024-10-19 16:05:49 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>Dynamic array of ptrs to dynamically allocated gl_area_entry. </para>
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
</section>
|