## Initialization

Initialization — Library initialization functions

## Synopsis

    #include <gdk/gdkgl.h>

    void        gdk_gl_init                     (int *argc,
                                                 char ***argv);
    gboolean    gdk_gl_init_check               (int *argc,
                                                 char ***argv);
    gboolean    gdk_gl_parse_args               (int *argc,
                                                 char ***argv);

## Description

## Details

### gdk_gl_init ()

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

Call this function before using any other GdkGLExt 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 gdk_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 gdk_gl_init() are stripped before return.

### gdk_gl_init_check ()

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

This function does the same work as gdk_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 gdk_gl_init() are stripped before return.
Returns : | `TRUE` if the GUI has been successfully initialized, `FALSE` otherwise.

### gdk_gl_parse_args ()

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

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

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

You shouldn't call this function explicitely if you are using gdk_gl_init(), or gdk_gl_init_check().

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