NAME
====
  vg_bitmap_zoom() - zoom a bitmap


SYNOPSIS
========
  bitmap * vg_bitmap_zoom(const bitmap * sbmp, double xmul, double ymul)


DESCRIPTION
===========
  The passed bitmap sbmp (or window if NULL) is zoomed
  with a factor of xmul into x-direction
  and a factor of ymul into y-direction.
  The original size for xmul and ymul is 1.0.
  E.g. using 2.0 for xmul will zoom it twice as big into x-direction.

  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_zoom().
  This is another behaviour than vg_sprite_zoom() shows, which zoomes
  the passed sprite itself.


RETURN VALUE
============
  If it succeeds, a static zoomed 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_mirror()
  vg_bitmap_overlap()
  vg_bitmap_free()