Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
vga_flip(3)		       Svgalib User Manual		     vga_flip(3)

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 con-
     tents. 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_set-
     mode(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_get-
     box(3), gl_putbox(3)

AUTHOR
     This  manual  page  was  edited  by Michael Weller <eowmob@exp-math.uni-es-
     sen.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 orig-
     inal author and will happily accept any additions or  corrections	to  this
     first version of the svgalib manual.

Svgalib (>= 1.2.11)		  27 July 1997			     vga_flip(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vga_flip&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help