## Initialization Initialization — Library initialization functions |

## Synopsis

    #include <gtk/gtkgl.h>

    void        gtk_gl_init                     (int *argc,
                                                 char ***argv);
    gboolean    gtk_gl_init_check               (int *argc,
                                                 char ***argv);
    gboolean    gtk_gl_parse_args               (int *argc,
                                                 char ***argv);

## Description

## Details

### gtk_gl_init ()

    void        gtk_gl_init                     (int *argc,
                                                 char ***argv);

Call this function before using any other GtkGLExt functions in your applications. It will initialize everything needed to operate the library and parses some standard command line options. `argc` and `argv` are adjusted accordingly so your own code will never see those standard arguments.

### Note

This function will terminate your program if it was unable to initialize the library for some reason. If you want your program to fall back to a textual interface you want to call `gtk_gl_init_check()` instead.

`argc` : | Address of the `argc` parameter of your ``main()`` function. Changed if any arguments were handled.
`argv` : | Address of the `argv` parameter of ``main()``. Any parameters understood by `gtk_gl_init()` are stripped before return.

### gtk_gl_init_check ()

    gboolean    gtk_gl_init_check               (int *argc,
                                                 char ***argv);

This function does the same work as `gtk_gl_init()` with only a single change: It does not terminate the program if the library can't be initialized. Instead it returns `FALSE` on failure.

This way the application can fall back to some other means of communication with the user - for example a curses or command line interface.

`argc` : | Address of the `argc` parameter of your ``main()`` function. Changed if any arguments were handled.
`argv` : | Address of the `argv` parameter of ``main()``. Any parameters understood by `gtk_gl_init()` are stripped before return.
Returns : | `TRUE` if the GUI has been successfully initialized, `FALSE` otherwise.

### gtk_gl_parse_args ()

    gboolean    gtk_gl_parse_args               (int *argc,
                                                 char ***argv);

Parses command line arguments, and initializes global attributes of GtkGLExt.

Any arguments used by GtkGLExt are removed from the array and `argc` and `argv` are updated accordingly.

You shouldn't call this function explicitely if you are using `gtk_gl_init()`, or `gtk_gl_init_check()`.

`argc` : | the number of command line arguments.
`argv` : | the array of command line arguments.
Returns : | `TRUE` if initialization succeeded, otherwise `FALSE`.