1
2
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
'\" t
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
.nf
..
.de Ve
.ft R
.fi
..
.TH "icetDrawFrame" "3" "August 9, 2010" "\fBIceT \fPReference" "\fBIceT \fPReference"
.SH NAME
\fBicetDrawFrame \-\- renders and composites a frame\fP
.PP
.SH Synopsis
.PP
#include <IceT.h>
.PP
.TS H
l l l .
\fBIceTImage\fP \fBicetDrawFrame\fP(
const IceTDouble * \fIprojection_matrix\fP,
const IceTDouble * \fImodelview_matrix\fP,
const IceTFloat * \fIbackground_color\fP );
.TE
.PP
.SH Description
.PP
Initiates a frame draw using the given transformation matrices (modelview
and projection). If you are using \fbOpenGL \fP,you should probably use the
\fBicetGLDrawFrame\fP
function and associated
\fBicetGLDrawCallback\fP\&.
.PP
Before \fBIceT \fPmay render an image, the tiled display needs to be defined
(using \fBicetAddTile\fP),
the drawing function needs to be set (using
\fBicetDrawCallback\fP),
and composite strategy must be set (using
\fBicetStrategy\fP).
The single image sub\-strategy may also optionally
be set (using \fBicetSingleImageStrategy\fP).
.PP
All processes in the current \fBIceT \fPcontext must call
\fBicetDrawFrame\fP
for it to complete.
.PP
During compositing, \fBIceT \fPuses the given \fIprojection_matrix\fP
and
\fImodelview_matrix\fP,
as well as the bounds given in the last call to
\fBicetBoundingBox\fP
or \fBicetBoundingVertices\fP,
to determine
onto which pixels the local geometry projects. If the given matrices are
not the same used in the rendering or the given bounds do not contain the
geometry, \fBIceT \fPmay clip the geometry in surprising ways. Furthermore,
\fBIceT \fPwill modify the \fIprojection_matrix\fP
for the drawing callback
to change the projection onto (or in between) tiles. Thus, you should
pass the desired \fIprojection_matrix\fP
to \fBicetDrawFrame\fP
and
then use the version passed to the drawing callback.
.PP
.SH Return Value
.PP
On each .igdisplay processdisplay
process (as defined by
\fBicetAddTile\fP,
\fBicetDrawFrame\fP
returns an image of the fully
composited image. The contents of the image are undefined for any
non\-display process.
.PP
If the \fBICET_COMPOSITE_ONE_BUFFER\fP
option is on and both a color
and depth buffer is specified with \fBicetSetColorFormat\fPand
\fBicetSetDepthFormat\fP,then the returned image might be missing the depth
buffer. The rational behind this option is that often both the color and
depth buffer is necessary in order to composite the color buffer, but the
composited depth buffer is not needed. In this case, the compositing
might save some time by not transferring depth information at the latter
stage of compositing.
.PP
The returned image uses memory buffers that will be reclaimed the next
time \fBIceT \fPrenders a frame. Do not use this image after the next call to
\fBicetDrawFrame\fP
(unless you have changed the \fBIceT \fPcontext).
.PP
.SH Errors
.PP
.TP
\fBICET_INVALID_OPERATION\fP
Raised if the \fBicetGLInitialize\fP
has not been called or if the
drawing callback has not been set. Also can be raised if
\fBicetDrawFrame\fP
is called recursively, probably from within the
drawing callback.
.TP
\fBICET_OUT_OF_MEMORY\fP
Not enough memory left to hold intermittent frame buffers and other
temporary data.
.PP
\fBicetDrawFrame\fP
may also indirectly raise an error if there is an
issue with the strategy or callback.
.PP
.SH Warnings
.PP
None.
.PP
.SH Bugs
.PP
If compositing with color blending on, the image returned may have a
black background instead of the \fIbackground_color\fP
requested. This
can be corrected by blending the returned image over the desired
background. This will be done for you if the
\fBICET_CORRECT_COLORED_BACKGROUND\fP
is on.
.PP
.SH Copyright
Copyright (C)2003 Sandia Corporation
.PP
Under the terms of Contract DE\-AC04\-94AL85000 with Sandia Corporation, the
U.S. Government retains certain rights in this software.
.PP
This source code is released under the New BSD License.
.PP
.SH See Also
.PP
\fIicetAddTile\fP(3),
\fIicetBoundingBox\fP(3),
\fIicetBoundingVertices\fP(3),
\fIicetDrawCallback\fP(3),
\fIicetGLDrawFrame\fP(3),
\fIicetSingleImageStrategy\fP(3),
\fIicetStrategy\fP(3)
.PP
.\" NOTE: This file is generated, DO NOT EDIT.
|
