← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/plplot/intrepid

« back to all changes in this revision

Viewing changes to doc/docbook/src/plcalc_world.html

  • Committer: Bazaar Package Importer
  • Author(s): Rafael Laboissiere
  • Date: 2006-11-04 10:19:34 UTC
  • mfrom: (2.1.8 edgy)
  • Revision ID: james.westby@ubuntu.com-20061104101934-mlirvdg4gpwi6i5q
Tags: 5.6.1-10
* Orphaning the package
* debian/control: Changed the maintainer to the Debian QA Group

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/docbook/src/plcalc_world.html
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2
2
<HTML
3
3
><HEAD
4
4
><TITLE
7
7
    </TITLE
8
8
><META
9
9
NAME="GENERATOR"
10
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
 
10
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
11
11
REL="HOME"
12
12
TITLE="The PLplot Plotting Library"
13
13
HREF="index.html"><LINK
62
62
WIDTH="80%"
63
63
ALIGN="center"
64
64
VALIGN="bottom"
65
 
>Chapter 16. The Common API for PLplot</TD
 
65
>Chapter 17. The Common API for PLplot</TD
66
66
><TD
67
67
WIDTH="10%"
68
68
ALIGN="right"
95
95
><P
96
96
></P
97
97
><A
98
 
NAME="AEN3338"
 
98
NAME="AEN4041"
99
99
></A
100
100
><TABLE
101
101
CLASS="funcprototype"
115
115
    </P
116
116
><P
117
117
>Calculate world coordinates,
118
 
<VAR
 
118
<TT
119
119
CLASS="literal"
120
 
><VAR
 
120
><CODE
121
121
CLASS="parameter"
122
 
>wx</VAR
123
 
></VAR
 
122
>wx</CODE
 
123
></TT
124
124
> and
125
 
<VAR
 
125
<TT
126
126
CLASS="literal"
127
 
><VAR
 
127
><CODE
128
128
CLASS="parameter"
129
 
>wy</VAR
130
 
></VAR
 
129
>wy</CODE
 
130
></TT
131
131
>, and corresponding
132
 
<VAR
 
132
<TT
133
133
CLASS="literal"
134
 
><VAR
 
134
><CODE
135
135
CLASS="parameter"
136
 
>window</VAR
137
 
></VAR
 
136
>window</CODE
 
137
></TT
138
138
> index
139
139
from relative device coordinates,
140
 
<VAR
 
140
<TT
141
141
CLASS="literal"
142
 
><VAR
 
142
><CODE
143
143
CLASS="parameter"
144
 
>rx</VAR
145
 
></VAR
 
144
>rx</CODE
 
145
></TT
146
146
> and
147
 
<VAR
 
147
<TT
148
148
CLASS="literal"
149
 
><VAR
 
149
><CODE
150
150
CLASS="parameter"
151
 
>ry</VAR
152
 
></VAR
 
151
>ry</CODE
 
152
></TT
153
153
>.
154
154
    </P
155
155
><TABLE
158
158
><TD
159
159
><DL
160
160
><DT
161
 
><VAR
 
161
><CODE
162
162
CLASS="parameter"
163
 
>rx</VAR
 
163
>rx</CODE
164
164
>
165
 
          (<VAR
 
165
          (<TT
166
166
CLASS="literal"
167
 
>PLFLT</VAR
 
167
>PLFLT</TT
168
168
>, input)</DT
169
169
><DD
170
170
><P
173
173
          </P
174
174
></DD
175
175
><DT
176
 
><VAR
 
176
><CODE
177
177
CLASS="parameter"
178
 
>ry</VAR
 
178
>ry</CODE
179
179
>
180
 
          (<VAR
 
180
          (<TT
181
181
CLASS="literal"
182
 
>PLFLT</VAR
 
182
>PLFLT</TT
183
183
>, input)</DT
184
184
><DD
185
185
><P
188
188
          </P
189
189
></DD
190
190
><DT
191
 
><VAR
 
191
><CODE
192
192
CLASS="parameter"
193
 
>wx</VAR
 
193
>wx</CODE
194
194
>
195
 
          (<VAR
 
195
          (<TT
196
196
CLASS="literal"
197
 
>PLFLT *</VAR
 
197
>PLFLT *</TT
198
198
>, output)</DT
199
199
><DD
200
200
><P
201
201
>           Pointer to the returned world coordinate for x corresponding
202
202
            to the relative device coordinates
203
 
            <VAR
 
203
            <TT
204
204
CLASS="literal"
205
 
><VAR
 
205
><CODE
206
206
CLASS="parameter"
207
 
>rx</VAR
208
 
></VAR
 
207
>rx</CODE
 
208
></TT
209
209
> and
210
 
            <VAR
 
210
            <TT
211
211
CLASS="literal"
212
 
><VAR
 
212
><CODE
213
213
CLASS="parameter"
214
 
>ry</VAR
215
 
></VAR
 
214
>ry</CODE
 
215
></TT
216
216
>.
217
217
          </P
218
218
></DD
219
219
><DT
220
 
><VAR
 
220
><CODE
221
221
CLASS="parameter"
222
 
>wy</VAR
 
222
>wy</CODE
223
223
>
224
 
          (<VAR
 
224
          (<TT
225
225
CLASS="literal"
226
 
>PLFLT *</VAR
 
226
>PLFLT *</TT
227
227
>, output)</DT
228
228
><DD
229
229
><P
230
230
>           Pointer to the returned world coordinate for y corresponding
231
231
            to the relative device coordinates
232
 
            <VAR
 
232
            <TT
233
233
CLASS="literal"
234
 
><VAR
 
234
><CODE
235
235
CLASS="parameter"
236
 
>rx</VAR
237
 
></VAR
 
236
>rx</CODE
 
237
></TT
238
238
> and
239
 
            <VAR
 
239
            <TT
240
240
CLASS="literal"
241
 
><VAR
 
241
><CODE
242
242
CLASS="parameter"
243
 
>ry</VAR
244
 
></VAR
 
243
>ry</CODE
 
244
></TT
245
245
>.
246
246
          </P
247
247
></DD
248
248
><DT
249
 
><VAR
 
249
><CODE
250
250
CLASS="parameter"
251
 
>window</VAR
 
251
>window</CODE
252
252
>
253
 
          (<VAR
 
253
          (<TT
254
254
CLASS="literal"
255
 
>PLINT *</VAR
 
255
>PLINT *</TT
256
256
>, output)</DT
257
257
><DD
258
258
><P
270
270
            and device coordinates are stored for the window and the window
271
271
            index is incremented.  Thus, for a simple page layout with
272
272
            non-overlapping viewports and one window per viewport,
273
 
            <VAR
 
273
            <TT
274
274
CLASS="literal"
275
 
><VAR
 
275
><CODE
276
276
CLASS="parameter"
277
 
>window</VAR
278
 
></VAR
 
277
>window</CODE
 
278
></TT
279
279
> corresponds to
280
280
            the viewport index (in the order which the viewport/windows
281
281
            were created) of the only viewport/window corresponding to
282
 
            <VAR
 
282
            <TT
283
283
CLASS="literal"
284
 
><VAR
 
284
><CODE
285
285
CLASS="parameter"
286
 
>rx</VAR
287
 
></VAR
 
286
>rx</CODE
 
287
></TT
288
288
> and
289
 
            <VAR
 
289
            <TT
290
290
CLASS="literal"
291
 
><VAR
 
291
><CODE
292
292
CLASS="parameter"
293
 
>ry</VAR
294
 
></VAR
 
293
>ry</CODE
 
294
></TT
295
295
>.  However, for
296
296
            more complicated layouts with potentially overlapping viewports
297
297
            and possibly more than one window (set of world coordinates) per
298
 
            viewport, <VAR
 
298
            viewport, <TT
299
299
CLASS="literal"
300
 
><VAR
 
300
><CODE
301
301
CLASS="parameter"
302
 
>window</VAR
303
 
></VAR
 
302
>window</CODE
 
303
></TT
304
304
>
305
305
            and the corresponding output world coordinates
306
306
            corresponds to the last window created that fulfils the criterion
307
307
            that the relative device coordinates are inside it.  Finally, in
308
308
            all cases where the input relative device coordinates are not
309
309
            inside any viewport/window, then
310
 
            <VAR
 
310
            <TT
311
311
CLASS="literal"
312
 
><VAR
 
312
><CODE
313
313
CLASS="parameter"
314
 
>window</VAR
315
 
></VAR
 
314
>window</CODE
 
315
></TT
316
316
> is set to -1.
317
317
          </P
318
318
></DD