source: trunk/SRC/Documentation/idldoc_html_output/Interpolation/quadrilateral2square.html @ 191

Last change on this file since 191 was 191, checked in by pinsard, 18 years ago

remove format=raw in all html files 2+ : correction for all_plots; suppression of css and correction of Source links in idldoc html output
File size: 8.8 KB
Line 
1
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5<!-- Generated by IDLdoc 2.0 -->
6
7<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
8  <head>
9    <title>quadrilateral2square.pro (SAXO Documentation)</title>
10
11   
12    <link rel="stylesheet" type="text/css" media="all" href="./../main_files.css" />
13    <link rel="stylesheet" type="text/css" media="print" href="./../main_files_print.css" />
14   
15
16    <script type="text/javascript">
17      function setTitle() {
18        parent.document.title="quadrilateral2square.pro (SAXO Documentation)";
19      }
20    </script>
21  </head>
22
23  <body onload="setTitle();">
24
25    <div id="navbar_title">
26  <h1>SAXO Documentation</h1>
27</div>
28
29
30<div id="main_navbar">
31
32  <table cellspacing="0">
33    <tr>
34     
35      <td><a href="./../overview.html" title="Overview of library">Overview</a></td>
36     
37
38     
39      <td >Directory</td>
40     
41
42     
43      <td><a href="./../idldoc-categories.html" title="Browse library by category">Categories</a></td>
44     
45
46     
47      <td><a href="./../idldoc-index.html" title="Index of files, routines, and parameters">Index</a></td>
48     
49
50     
51      <td><a href="./../search-page.html" title="Search library">Search</a></td>
52     
53
54      <td id="selected">File</td>
55
56     
57      <td><a href="../../../Interpolation//quadrilateral2square.pro" title="Source code of a file">Source</a></td>
58     
59
60     
61      <td><a href="./../idldoc-help.html" title="Help on IDLdoc">Help</a></td>
62     
63
64      <td >Etc</td>
65
66      <td id="flexible">Developer&nbsp;documentation</td>
67    </tr>
68  </table>
69
70</div>
71
72<div id="secondary_navbar">
73
74<a href="neighbor.html">&lt;&lt;prev file</a> | <a href="spl_fstdrv.html">next file &gt;&gt;</a>&nbsp;&nbsp;&nbsp;&nbsp;<a href="quadrilateral2square.html" target="_TOP">view single page</a> | <a href="./../index.html" target="_TOP">view frames</a>&nbsp;&nbsp;&nbsp;&nbsp;summary: fields | routine&nbsp;&nbsp;&nbsp;&nbsp;details: <a href="#routine_details">routine</a>
75
76</div>
77
78
79    <div id="container">
80
81      <h1 class="directory"><a href="directory-overview.html">Interpolation/</a></h1>
82      <h2 class="pro_file">quadrilateral2square.pro</h2>
83
84      <div id="file_attr">
85        <dl>
86        </dl>
87      </div>
88
89      <div id="file_comments">
90 warm (or map) an arbitrary quadrilateral onto a unit square
91 according to the 4-point correspondences:
92       (x0,y0) -> (0,0)
93       (x1,y1) -> (1,0)
94       (x2,y2) -> (1,1)
95       (x3,y3) -> (0,1)
96 This is the inverse function of square2quadrilateral.pro
97 The mapping is done using perspective transformation which preserve
98 lines in all orientations and permit quadrilateral to quadrilateral
99 mappings. see ref. bellow.
100</div>
101
102     
103
104     
105
106     
107
108     
109
110      <div id="routine_details">
111       
112
113        <div class="routine_details" id="_quadrilateral2square">
114
115          <h2><a class="top" href="#container">top</a>quadrilateral2square <span class="categories"> 
116 Picture, Grid
117</span></h2>
118       
119          <p class="header">
120            <span class="result">result = </span>quadrilateral2square(<span class="result"><a href="#_quadrilateral2square_param_x0in">x0in</a>, <a href="#_quadrilateral2square_param_y0in">y0in</a>, <a href="#_quadrilateral2square_param_x1in">x1in</a>, <a href="#_quadrilateral2square_param_y1in">y1in</a>, <a href="#_quadrilateral2square_param_x2in">x2in</a>, <a href="#_quadrilateral2square_param_y2in">y2in</a>, <a href="#_quadrilateral2square_param_x3in">x3in</a>, <a href="#_quadrilateral2square_param_y3in">y3in</a>, <a href="#_quadrilateral2square_param_xxin">xxin</a>, <a href="#_quadrilateral2square_param_yyin">yyin</a></span>, <a href="#_quadrilateral2square_keyword_PERF">PERF</a>=<span class="result">PERF</span>)</p>
121       
122          <div class="comments">
123</div>
124
125          <h3>Return value</h3><div class="preformat">
126
127 (2,n) array: the new coordinates (xout, yout) of the (xin,yin) point(s) after
128 mapping.
129 If xin is a scalar, then n is equal to the number of elements of x0.
130 If xin is an array , then n is equal to the number of elements of xin.
131</div>
132
133         
134            <h3>Parameters</h3>
135       
136           
137            <h4 id="_quadrilateral2square_param_x0in">x0in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
138              <span class="attr">in</span>
139             
140             
141              <span class="attr">required</span>
142             
143             
144             
145             
146            </h4>
147       
148          <div class="comments"></div>
149           
150            <h4 id="_quadrilateral2square_param_y0in">y0in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
151              <span class="attr">in</span>
152             
153             
154              <span class="attr">required</span>
155             
156             
157             
158             
159            </h4>
160       
161          <div class="comments"></div>
162           
163            <h4 id="_quadrilateral2square_param_x1in">x1in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
164              <span class="attr">in</span>
165             
166             
167              <span class="attr">required</span>
168             
169             
170             
171             
172            </h4>
173       
174          <div class="comments"></div>
175           
176            <h4 id="_quadrilateral2square_param_y1in">y1in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
177              <span class="attr">in</span>
178             
179             
180              <span class="attr">required</span>
181             
182             
183             
184             
185            </h4>
186       
187          <div class="comments"></div>
188           
189            <h4 id="_quadrilateral2square_param_x2in">x2in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
190              <span class="attr">in</span>
191             
192             
193              <span class="attr">required</span>
194             
195             
196             
197             
198            </h4>
199       
200          <div class="comments"></div>
201           
202            <h4 id="_quadrilateral2square_param_y2in">y2in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
203              <span class="attr">in</span>
204             
205             
206              <span class="attr">required</span>
207             
208             
209             
210             
211            </h4>
212       
213          <div class="comments"></div>
214           
215            <h4 id="_quadrilateral2square_param_x3in">x3in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
216              <span class="attr">in</span>
217             
218             
219              <span class="attr">required</span>
220             
221             
222             
223             
224            </h4>
225       
226          <div class="comments"></div>
227           
228            <h4 id="_quadrilateral2square_param_y3in">y3in&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
229              <span class="attr">in</span>
230             
231             
232              <span class="attr">required</span>
233             
234             
235             
236             
237            </h4>
238       
239          <div class="comments">
240 the coordinates of the quadrilateral
241 (see above for correspondence with the unit square). Can be
242 scalar or array. (x0,y0), (x1,y1), (x2,y2) and (x3,y3) are
243 given in the anticlockwise order.
244</div>
245           
246            <h4 id="_quadrilateral2square_param_xxin">xxin&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
247              <span class="attr">in</span>
248             
249             
250              <span class="attr">required</span>
251             
252             
253             
254             
255            </h4>
256       
257          <div class="comments">
258 the coordinates of the point(s) for which we want to do the mapping.
259 Can be scalar or array.
260</div>
261           
262            <h4 id="_quadrilateral2square_param_yyin">yyin&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
263              <span class="attr">in</span>
264             
265             
266              <span class="attr">required</span>
267             
268             
269             
270             
271            </h4>
272       
273          <div class="comments">
274 the coordinates of the point(s) for which we want to do the mapping.
275 Can be scalar or array.
276</div>
277           
278
279         
280
281         
282
283            <h3>Keywords</h3>
284           
285            <h4 id="_quadrilateral2square_keyword_PERF">PERF&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
286             
287             
288             
289             
290             
291             
292             
293             
294            </h4>
295       
296            <div class="comments">
297</div>
298           
299         
300
301          <h3>Examples</h3><div class="preformat">
302
303 IDL> splot,[0,5],[0,3],/nodata,xstyle=1,ystyle=1
304 IDL> tracegrille, findgen(11)*.1, findgen(11)*.1,color=indgen(12)*20
305 IDL> xin = (findgen(11)*.1)#replicate(1, 11)
306 IDL> yin = replicate(1, 11)#(findgen(11)*.1)
307 IDL> out = square2quadrilateral(2,1,3,0,5,1,2,3, xin, yin)
308 IDL> tracegrille, reform(out[0,*],11,11), reform(out[1,*],11,11),color=indgen(12)*20
309
310 IDL> inorg=quadrilateral2square(2,1,3,0,5,1,2,3,out[0,*],out[1,*])
311 IDL> tracegrille, reform(inorg[0,*],11,11), reform(inorg[1,*],11,11),color=indgen(12)*20
312</div>
313          <h3>Version history</h3>
314         
315          <h4>Version</h4><div class="preformat"> $Id: quadrilateral2square.pro 163 2006-08-29 12:59:46Z navarro $
316</div>
317          <h4>History</h4><div class="preformat">
318      Sebastien Masson (smasson@lodyc.jussieu.fr)
319      August 2003
320      Based on "Digital Image Warping" by G. Wolberg
321      IEEE Computer Society Press, Los Alamitos, California
322      Chapter 3, see p 52-56
323
324</div>
325         
326         
327          <h3>Known issues</h3>
328         
329         
330         
331          <h4>Restrictions</h4><div class="preformat">
332 I think degenerated quadrilateral (e.g. flat of twisted) is not work.
333 This has to be tested.
334</div>
335       
336         
337         
338         
339         
340         
341         
342         
343       
344          <h3>Statistics</h3>
345          <table class="statistics">
346            <tr><td>McCabe cyclic</td><td>           8</td></tr>
347            <tr><td>McCabe essential</td><td>           1</td></tr>
348            <tr><td>McCabe modular design</td><td>           1</td></tr>
349          </table>
350         
351       
352        </div>
353       
354      </div>
355
356     
357
358      <div id="tagline">Produced by IDLdoc 2.0.</div>
359
360    </div>
361
362  </body>
363</html>
Note: See TracBrowser for help on using the repository browser.