NAME
====
  vg_bitmap_createfromfile() - load a bitmap from file


SYNOPSIS
========
  bitmap * vg_bitmap_createfromfile(const char * filename)


DESCRIPTION
===========
  Creates a bitmap, loading it from a file.

  filename should use a relative path to the game-directory,
  e.g. your game resides under "mygame/":
    mygame/
    mygame/bitmaps/
    ...
  then loading "1.vga" under "bitmaps" should use this path:
    bitmaps/1.vga

  The file must be in a supported format
  (VgaGames-bitmap-format, windows bmp, ppm3 or ppm6 format).
  But for performing issues VgaGames-bitmap-format is strongly recommended.
  (See Understanding bitmaps: "Creating a bitmap-file").


RETURN VALUE
============
  If it succeeds, it returns a pointer to the loaded bitmap.
  If an error occurs, it returns NULL, giving out an error message to stderr.


SEE ALSO
========
  Index
  Understanding bitmaps
  vg_bitmap_createnew()
  vg_bitmap_createfromtext()
  vg_bitmap_duplicate()
  vg_bitmap_width()
  vg_bitmap_height()
  vg_bitmap_getpixel()
  vg_bitmap_clear()
  vg_bitmap_copyto()
  vg_bitmap_save()
  vg_bitmap_rotate()
  vg_bitmap_zoom()
  vg_bitmap_mirror()
  vg_bitmap_overlap()
  vg_bitmap_free()