NAME
====
  vg_init_vgagames() - initialize VgaGames-library


SYNOPSIS
========
  int vg_init_vgagames(const char * argv0, int init_flag,const char * lkz)


DESCRIPTION
===========
  Before calling any VgaGames-library function this function must be called.

  argv0 is the pointer to argv[0] from function main(),
  the name and path of the game. It is used to determine the working directory
  of the game, from which all relative files are loaded (e.g. bitmaps).

  From this current working directory the VgaGames-properties file is loaded
  from "share/.vgag2.rc", if existing, where the saved values of window-size
  (X-window) and of sound-volume are set.

  init_flag is bitwise-or'd with zero or more of the following:
   - INITVGA_NOFILE: don't read the VgaGames-properties file
                     "share/.vgag2.rc"

  lkz is an optional language shortcut (2 characters, lowercase, e.g. "en"),
  which is used as default language, if no one is stored in "share/.vgag.rc".
  Refer to vg_get_textformat() for more infos.
  Usually lkz is NULL.


RETURN VALUE
============
  If it succeeds, it returns 0.
  If an error occurs, it returns -1, giving out an error message to stderr.


NOTE
====
  This function has to be called only once.
  There is no equivalent destroying function.


SEE ALSO
========
  Index