VgaGames 3 - Miscellaneous man-pages

[.. upper level ..]

VG3_output_text()

Show a box containing text.
SYNTAX
int VG3_output_text(struct vg3_window *wstruct, int fcolor, int bcolor, const char *text)

FUNCTION PARAMETERS
wstruct Window-struct
fcolor Foreground color (from VGAG3_COLORS or VGAG3_COLOR_CUSTOM)
bcolor Background color (from VGAG3_COLORS or VGAG3_COLOR_CUSTOM)
text Text

RETURN VALUE
Returns integer: - 1: Got request for closing the window and exiting the game - 0: OK - -1: failure

ERRORS
On error VG3_errmsg() returns: EINVAL - error in argument ENOSYS - cannot create image ENOMEM - cannot get memory

DESCRIPTION
Show an text-box on top of the actual window. Navigate using the keys cursor-up, cursor-down or pagewise backspace resp. page-up and space resp. page-down. Exit the text-box with return or escape. The current background image will be dimmed out and used as background for the box. The background color bcolor may be VGAG3_COLOR_TRANSPARENT.

SEE ALSO
VG3_draw_text() VG3_draw_textline() VG3_text_simpledraw() VG3_text_with_images()