1vga_flip(3)                   Svgalib User Manual                  vga_flip(3)
2
3
4

NAME

6       vga_flip - toggle between text and graphics mode
7

SYNOPSIS

9       #include <vga.h>
10
11       int vga_flip(void);
12
13

DESCRIPTION

15       switches  between  graphics and text mode without destroying the screen
16       contents. This makes it possible for your application to use both  text
17       and graphics output.
18
19       However,  This is an old vgalib function. You should really only use it
20       for debugging as it runs extremely unstable because  svgalib  now  does
21       its  own  virtual  console management. If you want to perform a similar
22       action, save the current screen  contents  with  ordinary  memory  copy
23       operation  to  the frame buffer or gl_getbox(3), set vga_setmode(TEXT),
24       then call vga_setmode(3) to return to graphics  operation  and  restore
25       the screen contents with memory or gl_putbox(3).
26
27       One  could  also  use  vga_drawscansegment(3) and vga_getscansegment(3)
28       calls.
29
30       However, avoid any calls to vga_flip() in your applications.
31
32       The function always returns 0, a fact on which you shouldn't rely.
33
34       It might be useful if you are debugging one of  your  svgalib  applica‐
35       tions  though.   If your program reaches a breakpoint while in graphics
36       mode, you can switch to text mode with the gdb command
37
38       print vga_flip()
39
40       and later restore the graphics screen contents with the  same  command.
41       It is useful to define the following alias in gdb:
42
43       define flip <Return> print vga_flip() <Return> end <Return>
44
45

SEE ALSO

47       svgalib(7),    vgagl(7),    libvga.config(5),   vga_init(3),   vga_set‐
48       flipchar(3),        vga_drawscanline(3),        vga_drawscansegment(3),
49       vga_getscansegment(3), gl_getbox(3), gl_putbox(3)
50

AUTHOR

52       This  manual  page  was  edited by Michael Weller <eowmob@exp-math.uni-
53       essen.de>. The exact source of the referenced function as  well  as  of
54       the original documentation is unknown.
55
56       It is very likely that both are at least to some extent are due to Harm
57       Hanemaayer <H.Hanemaayer@inter.nl.net>.
58
59       Occasionally this might be wrong. I hereby asked to be excused  by  the
60       original author and will happily accept any additions or corrections to
61       this first version of the svgalib manual.
62
63
64
65Svgalib (>= 1.2.11)              27 July 1997                      vga_flip(3)