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

NAME

6       vga_bitblt - copy pixmap on screen using an accelerator
7

SYNOPSIS

9       #include <vga.h>
10
11       void vga_bitblt(int srcaddr, int destaddr, int w, int h, int pitch);
12
13

DESCRIPTION

15       Bitblit  (copy rectangular area in video memory), addresses are offsets
16       into video memory (up to 2M). The pitch is the  logical  width  of  the
17       screen. Height h is in Pixels, Width w is in BYTES!
18
19       This  is  an  old  style  function to access the accelerator of an SVGA
20       card. Before calling it you should check for availability of the  func‐
21       tion in the mode you use with vga_getmodeinfo(3).
22
23       For  new applications you might be better of trying to use vga_accel(3)
24       instead.
25
26       The old vga_bitblt(3), vga_blitwait(3), vga_fillblt(3),  vga_hlinelist‐
27       blt(3),  and  vga_imageblt(3) interface was originally designed for the
28       Cirrus chipsets. Then Mach32 added support  too  but  has  problems  to
29       resemble  the  unintuitive  Cirrus interface. Then these new ideas were
30       reinjected and vga_accel(3) was designed. Now Cirrus and Chips &  Tech‐
31       nologies  chipset  give limited vga_accel(3) support but no longer this
32       old style support.  Mach32 is left to use the unintuitive Cirrus inter‐
33       face.  At some future point the functions might be added for Mach32 too
34       (which should be rather simple), so new  applications  should  use  the
35       newer and probably more efficient interface.
36
37       It would be fatal if the accelerator would be used while the console is
38       switched away.  You should use  vga_lockvc(3)  and  vga_unlockvc(3)  to
39       avoid  this, although good implementations of the accelerator functions
40       (like Mach32) will already ensure that.
41
42       The testaccel(6) demo utilizes the old style accelerator functions.
43
44

SEE ALSO

46       svgalib(7),  vgagl(7),  libvga.config(5),  testaccel(6),  vga_accel(3),
47       vga_blitwait(3),  vga_fillblt(3), vga_hlinelistblt(3), vga_imageblt(3),
48       vga_getmodeinfo(3), vga_lockvc(3), vga_unlockvc(3)
49
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_bitblt(3)
Impressum