NAME
====
  vg_sprite_createfromfile() - load a sprite from file


SYNOPSIS
========
  sprite * vg_sprite_createfromfile(const char * filename)


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

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

  (see Understanding sprites to how to create a sprite-file).


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


SEE ALSO
========
  Index
  Understanding sprites
  vg_sprite_createnew()
  vg_sprite_add()
  vg_sprite_duplicate()
  vg_sprite_rotate()
  vg_sprite_zoom()
  vg_sprite_mirror()
  vg_sprite_getnext()
  vg_sprite_getcurrent()
  vg_sprite_reset()
  vg_sprite_free()