NAME
====
  vg_bitmap_copyto() - copy a (part of a) bitmap into another one


SYNOPSIS
========
  void vg_bitmap_copyto(bitmap * dbmp, int xd, int yd, const bitmap * sbmp, int xs, int ys, int ws, int hs, int trans)


DESCRIPTION
===========
  Copies bitmap sbmp into bitmap dbmp.
  From sbmp only the part starting at (xs,ys)
  with width ws and height hs is copied.
  If ws or hs are 0, the rest of the length is copied.

  The destination coordinates in dbmp are (xd,yd),
  this means, the middle of sbmp is copied to (xd,yd).

  One of the bitmaps may refer to the window (sbmp=NULL resp. dbmp=NULL)
  for copying from or into the window.

  trans may be RGB_FULL for copying every pixel
  or RGB_TRANS for omitting the black pixels (color-index=RGB_BLACK) 
  (refer to Understanding colormap).

  E.g. "vg_bitmap_copyto(dbmp,2,3,sbmp,4,5,6,0,RGB_TRANS)"
       copies a rectangle of sbmp beginning at x-position 4 and y-position 5
       with a width of 6 and a height of 'height-of-bitmap minus 5'
       into dbmp at x-position 2 and y-position 3 omitting RGB_BLACK-pixels.


RETURN VALUE
============
  No value is returned.


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_save()
  vg_bitmap_rotate()
  vg_bitmap_zoom()
  vg_bitmap_mirror()
  vg_bitmap_overlap()
  vg_bitmap_free()