NAME
====
  vg_bitmap_createfromtext() - create a bitmap containing text


SYNOPSIS
========
  bitmap * vg_bitmap_createfromtext(int fc, int bc, int pxl, int align, const char * text, const char * font)


DESCRIPTION
===========
  Creates a bitmap from a text, given as argument.
  Newlines and Two-character-newlines ("\" + "n") break the line,
  e.g. a text "This is line 1\nthis is line 2" creates a bitmap with two lines.

  fc is the color-index for the text color.
  bc is the color-index for the background color.
  pxl indicates the pixels between text lines.
  With align the text lines are left adjusted (value=0),
    right adjusted (value=2) or centered (value=1).
  text is the text itself.
  font is the name of a font-file (refer to Understanding fonts and text)
    or NULL=default font: 8x8.font


RETURN VALUE
============
  If it succeeds, it returns a pointer to the created 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_createfromfile()
  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()