NAME

       vga_flip - toggle between text and graphics mode

SYNOPSIS

       #include <vga.h>

       int vga_flip(void);

DESCRIPTION

       switches between graphics and text mode without destroying the screen contents. This makes
       it possible for your application to use both text and graphics output.

       However, This is an old vgalib function. You should really only use it for debugging as it
       runs  extremely  unstable  because svgalib now does its own virtual console management. If
       you want to perform a similar action, save  the  current  screen  contents  with  ordinary
       memory  copy  operation  to  the frame buffer or gl_getbox(3), set vga_setmode(TEXT), then
       call vga_setmode(3) to return to graphics operation and restore the screen  contents  with
       memory or gl_putbox(3).

       One could also use vga_drawscansegment(3) and vga_getscansegment(3) calls.

       However, avoid any calls to vga_flip() in your applications.

       The function always returns 0, a fact on which you shouldn't rely.

       It  might be useful if you are debugging one of your svgalib applications though.  If your
       program reaches a breakpoint while in graphics mode, you can switch to text mode with  the
       gdb command

       print vga_flip()

       and  later  restore  the  graphics screen contents with the same command.  It is useful to
       define the following alias in gdb:

       define flip <Return> print vga_flip() <Return> end <Return>

SEE ALSO

       svgalib(7),     vgagl(7),     libvga.config(5),      vga_init(3),      vga_setflipchar(3),
       vga_drawscanline(3),    vga_drawscansegment(3),    vga_getscansegment(3),    gl_getbox(3),
       gl_putbox(3)

AUTHOR

       This manual page was edited by Michael Weller  <eowmob@exp-math.uni-essen.de>.  The  exact
       source of the referenced function as well as of the original documentation is unknown.

       It  is  very  likely  that  both  are  at  least to some extent are due to Harm Hanemaayer
       <H.Hanemaayer@inter.nl.net>.

       Occasionally this might be wrong. I hereby asked to be excused by the original author  and
       will  happily  accept  any  additions  or corrections to this first version of the svgalib
       manual.