1vga_flip(3) Svgalib User Manual vga_flip(3)
2
3
4
6 vga_flip - toggle between text and graphics mode
7
9 #include <vga.h>
10
11 int vga_flip(void);
12
13
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
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
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)