GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  VGA_FLIP (3)

NAME

vga_flip - toggle between text and graphics mode

CONTENTS

Synopsis
Description
See Also
Author

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.

Search for    or go to Top of page |  Section 3 |  Main Index


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

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.