Felisp
84436a5ae0
http://my.svgalib.org/svgalib/svgalib-1.9.25.tar.gz http://my.svgalib.org/svgalib/
73 lines
2.2 KiB
Groff
73 lines
2.2 KiB
Groff
.TH vga_flip 3 "27 July 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
|
.SH NAME
|
|
vga_flip \- toggle between text and graphics mode
|
|
.SH SYNOPSIS
|
|
|
|
.B "#include <vga.h>"
|
|
|
|
.BI "int vga_flip(void);"
|
|
|
|
.SH 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.
|
|
|
|
.BR 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
|
|
.BR gl_getbox (3),
|
|
set
|
|
.BR vga_setmode(TEXT) ,
|
|
then call
|
|
.BR vga_setmode (3)
|
|
to return to graphics operation and restore the screen contents with memory or
|
|
.BR gl_putbox (3).
|
|
|
|
One could also use
|
|
.BR vga_drawscansegment (3)
|
|
and
|
|
.BR vga_getscansegment (3)
|
|
calls.
|
|
|
|
.B 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
|
|
|
|
.B "print vga_flip()"
|
|
|
|
and later restore the graphics screen contents with the same command.
|
|
It is useful to define the following alias in gdb:
|
|
|
|
.B "define flip <Return> print vga_flip() <Return> end <Return>"
|
|
|
|
.SH SEE ALSO
|
|
|
|
.BR svgalib (7),
|
|
.BR vgagl (7),
|
|
.BR libvga.config (5),
|
|
.BR vga_init (3),
|
|
.BR vga_setflipchar (3),
|
|
.BR vga_drawscanline (3),
|
|
.BR vga_drawscansegment (3),
|
|
.BR vga_getscansegment (3),
|
|
.BR gl_getbox (3),
|
|
.BR gl_putbox (3)
|
|
.SH 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.
|