NAME
====
  vg_bitmap_mirror() - mirror a bitmap vertically or horizontally


SYNOPSIS
========
  bitmap * vg_bitmap_mirror(const bitmap * sbmp, int vh)


DESCRIPTION
===========
  The passed bitmap sbmp (or window if NULL) is mirrored
  either vertically, if vh is MIRROR_VT
  or horizontally, if vh is MIRROR_HT.

  Then a static bitmap is returned, leaving the passed bitmap untouched.
  If you want to use this returned static bitmap further, you have to copy it
  with vg_bitmap_duplicate(),
  because it will be overwritten at the next call to vg_bitmap_mirror().
  This is another behaviour than vg_sprite_mirror() shows, which mirrors
  the passed sprite itself.


RETURN VALUE
============
  If it succeeds, a static mirrored bitmap is returned.
  If an error occurs, NULL is returned, an error message is printed to stderr.


SEE ALSO
========
  Index
  Understanding bitmaps
  vg_bitmap_createnew()
  vg_bitmap_createfromfile()
  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_overlap()
  vg_bitmap_free()