| 12
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 
 | .\\" auto-generated by docbook2man-spec $Revision: 1.5 $
.TH "DISPLAY-TILE" "7ggi" "22 August 2001" "GGI" "LibGGI Reference"
.SH NAME
display-tile \- Divide display into tiles similar to a video wall
.SH SYNOPSIS
.sp
\fBdisplay-tile\fR \fB:\fR [ \fB [ -usedb ]  [ -nodb ] \fR ]  \fB \fIoffset-x\fB,
\fIoffset-y\fB,
\fIsize-x\fB,
\fIsize-y\fB,
\fIchild-target-spec\fB:\fR\fI...\fR
.SH "DESCRIPTION"
.PP
Emulates one big target, where one or more areas are mapped to different
child visuals. 
.SH "OPTIONS"
.PP
For each tile (i.e. child visual or mapped area), the following must be 
specified:
.TP
\fB\fIoffset-x\fB\fR
.TP
\fB\fIoffset-y\fB\fR
coordinates (within the parent visual) of the top-left corner of the child visual
.TP
\fB\fIsize-x\fB\fR
.TP
\fB\fIsize-y\fB\fR
width and height of the child visual
.TP
\fB\fIchild-target-spec\fB\fR
a target spec. Since target specs can (and often do) contain colons, it
needs to be enclosed in parentheses.
.PP
The following options apply to the whole \fBdisplay-tile\fR:
.TP
\fB-usedb\fR
Enables DirectBuffer emulation. This is the default mode. 
The contents of each mapped area is blitted from the DirectBuffer into
their respective child visuals at regular intervals or when the visual
is flushed. DirectBuffer emulation works regardless of whether the
child visuals support DirectBuffer or not.
.TP
\fB-nodb\fR
Disables DirectBuffer emulation. LibGGI primitives are passed to each
of the child visuals with the necessary clipping and translation. Thus,
if a child visual underlying a mapped area supports acceleration, then
the operation on that area will be accelerated.
.SH "FEATURES"
DirectBuffer support depends on the \fB-usedb\fR/\fB-nodb\fR
options.
Accelerated in no-DB mode if the underlying target is,
otherwise unaccelerated.
.sp
.RS
.B "Tip:"
\fBdisplay-tile\fR can be used to emulate DirectBuffer for
obstinate applications that cannot run without it, by specifying one
tile which maps the whole screen.
.RE
.sp
 |