diff options
Diffstat (limited to 'vendor/x11iraf/cdl/doc/cdlref.ps')
-rw-r--r-- | vendor/x11iraf/cdl/doc/cdlref.ps | 19799 |
1 files changed, 19799 insertions, 0 deletions
diff --git a/vendor/x11iraf/cdl/doc/cdlref.ps b/vendor/x11iraf/cdl/doc/cdlref.ps new file mode 100644 index 00000000..f192e0b1 --- /dev/null +++ b/vendor/x11iraf/cdl/doc/cdlref.ps @@ -0,0 +1,19799 @@ +%!PS-Adobe-1.0 +%%Creator: devps (Pipeline Associates, Inc.) +%%CreationDate: Sat Aug 11 21:36:49 2001 +%%Pages: (atend) +%%DocumentFonts: (atend) + +/X{exch}def +/r{rmoveto}def +/m{moveto}def +/l{lineto}def +/rl{rlineto}def +/lc{yc X xc X l st}def +/mc{yc X xc X m}def +/el{gs /a X def a div 1 X scale cp np a xc 2 div 0 360 arc st gr}def +/ar{cp 7 2 roll np xc 5 1 roll atan 3 1 roll atan X arc st}def +/sp{yc X xc X 6 2 roll yc X xc X 6 2 roll yc X xc X 6 2 roll ct}def +/st{stroke}def +/gs{gsave}def +/gr{grestore}def +/cp{currentpoint}def +/np{newpath}def +/ct{curveto}def +/m0{0 0 moveto}def +/BP{/devps-save save def m0}def +/EP{ +clear devps-save restore +showpage}def +/res 10.000000 def +/V{res neg div 792 add +currentpoint pop X +m}def +/H{res div +currentpoint X pop +moveto}def +/h{res div 0 r}def +/v{res neg div 0 X r}def +/xc{res div}def +/yc{res neg div 792 add}def +/S{X H show}def +/psize 10 def +/height 1 def +/slant 0 def +/FF{findfont X dup 12 div setlinewidth /psize X def + [psize 0 psize height mul slant sin slant cos div mul psize height mul 0 0] + makefont setfont}def +/shade{gs + /dy X def + /dx X def + np m + setgray + 0 dy rl + dx 0 rl + 0 dy neg rl + dx neg 0 rl + closepath + fill +gr}def +1 setlinecap +/R{/Times-Roman FF}def +/B{/Times-Bold FF}def +/I{/Times-Italic FF}def +/C{/Courier FF}def +%% Troff special characters not on Symbol font +%% Copyright (C) 1986 by Pipeline Associates, Inc. +%% Version 1.1 +/altRTD 20 dict def +altRTD begin +/s{setcachedevice}def +/C{1000 1000 scale}def +/m{moveto}def +/c{curveto}def +/S{stroke}def +/l{lineto}def +/a{arcto}def +/p{pop}def +/sl{setlinewidth}def +end +/F_Troff 17 dict def F_Troff begin +systemdict /currentpacking known +{/SavePacking currentpacking def true setpacking}if +/PaintType 0 def +/FontType 3 def +/StrokeWidth 0 def +/UniqueID 8277003 def +/FontMatrix [.001000 0 0 .001000 0 0] def +/FontBBox [-12 -105 942 855 ] def +/Encoding 256 array def +/CD 256 1 add dict def +/FontInfo 3 dict def FontInfo begin +/UnderlinePosition -133 def /UnderlineThickness 20 def end +/FontName (Troff) def +0 1 256 1 sub{Encoding exch /.notdef put}for +CD /.notdef{500 0 setcharwidth{}}put +Encoding (1) 0 get /br put +%% bold vertical rule used by tbl +CD /br{ +C +0 0 -.5 -.5 1 1 s +np +.05 sl +0 -.1 m +0 .9 l +{S} +}put +Encoding (2) 0 get /ul put +%% underline used by tbl +CD /ul{ +C +.5 0 -.5 -.5 1 1 s +np +.05 sl +0 -.1 m +.5 -.1 l +{S} +}put +Encoding (3) 0 get /ru put +%% baseline rule +CD /ru{ +C +.5 0 -.5 -.5 1 1 s +np +.05 sl +m0 +.5 0 l +{S} +}put +Encoding (4) 0 get /vr put +%% vertical rule +CD /vr{ +C +0 0 -.5 -.5 1 1 s +np +.05 sl +m0 +0 1 l +{S} +}put +Encoding (5) 0 get /sq put +%% square +CD /sq{ +C +.5 0 -.5 -.5 1 1 s +np +.05 sl +0 .25 m +0 .5 rl +.5 0 rl +0 -.5 rl +-.5 0 rl +closepath +{S} +}put +Encoding (6) 0 get /bx put +%% solid box +CD /bx{ +C +.5 0 -.5 -.5 1 1 s +np +0 .25 m +0 .5 rl +.5 0 rl +0 -.5 rl +-.5 0 rl +closepath +{fill} +}put +Encoding (7) 0 get /rn put +%% radical extender +CD /rn{ +C +.5 0 -.5 -.5 1 1 s +np +.03 sl +-.03 .9 m +.5 0 rl +{S} +}put +Encoding (8) 0 get /GR put +%% gray mask +CD /GR{ +C +.5 0 setcharwidth +.5 setgray +np +0 -.1 m +0 1 rl +.5 0 rl +0 -1 rl +-.5 0 rl +closepath +{fill} +}put +Encoding 97 /a put +CD /a{1000 0 0 66 942 421 s 430 415 +m 578 406 678 349 662 319 c 655 306 614 287 583 +296 c 570 300 466 340 438 332 c 365 309 335 213 +270 209 c 0 310 m 108 310 l 108 114 l 0 +114 l 0 310 l 42 161 m 42 134 l 66 134 l 66 +161 l 42 161 l 47 155 m 47 140 l 62 140 l 62 +155 l 47 155 l 110 133 m 226 113 300 66 410 +80 c 497 91 550 69 634 76 c 645 76 663 92 669 +107 c 677 125 673 141 668 160 c 725 334 m 758 +332 734 253 701 250 c 501 325 m 475 316 476 309 +473 302 c 465 282 482 263 499 257 c 552 236 615 +253 689 253 c 701 253 713 236 713 218 c 712 194 +702 168 678 161 c 671 159 663 160 655 160 c 591 +158 516 156 479 168 c 461 173 453 191 453 210 c 453 +224 456 235 466 244 c 476 253 490 252 503 255 c 459 +84 m 447 96 435 106 435 123 c 435 136 440 145 447 +155 c 453 163 462 168 469 173 c 110 293 m 173 +318 300 421 435 415 c 609 407 852 416 885 411 c 898 +409 924 411 930 380 c 942 316 828 339 742 334 c 731 +334 730 335 725 335 c 701 336 685 336 660 336 c{S}}put +Encoding 98 /b put +CD /b{1000 0 -12 66 930 421 s 500 +415 m 352 406 252 349 268 319 c 275 306 316 287 +347 296 c 360 300 464 340 492 332 c 565 309 595 +213 660 209 c 930 310 m 822 310 l 822 114 l 930 +114 l 930 310 l 888 161 m 888 134 l 864 134 +l 864 161 l 888 161 l 883 155 m 883 140 l 868 +140 l 868 155 l 883 155 l 820 133 m 704 113 +630 66 520 80 c 433 91 380 69 296 76 c 285 76 +267 92 261 107 c 253 125 257 141 262 160 c 205 +334 m 172 332 196 253 229 250 c 429 325 m 455 +316 454 309 457 302 c 465 282 448 263 431 257 c 378 +236 315 253 241 253 c 229 253 217 236 217 218 c 218 +194 228 168 252 161 c 259 159 267 160 275 160 c 339 +158 414 156 451 168 c 469 173 477 191 477 210 c 477 +224 474 235 464 244 c 454 253 440 252 427 255 c 471 +84 m 483 96 495 106 495 123 c 495 136 490 145 483 +155 c 477 163 468 168 461 173 c 820 293 m 757 +318 630 421 495 415 c 321 407 78 416 45 411 c 32 +409 6 411 0 380 c -12 316 102 339 188 334 c 199 +334 200 335 205 335 c 229 336 245 336 270 336 c{S}}put +Encoding 99 /c put +CD /c{1000 0 184 0 827 627 s 185 315 +m 186 488 332 627 505 625 c 682 623 827 467 815 +290 c 804 124 666 0 500 0 c 327 0 184 142 185 +315 c{S}}put +Encoding 100 /d put +CD /d{590 0 134 158 477 500 s 300 +160 m 208 162 134 238 135 330 c 136 423 212 500 +305 500 c 397 500 473 427 475 335 c 477 239 396 +158 300 160 c{fill}}put +Encoding 101 /e put % Bell Symbol +CD /e{1010 0 -100 -210 1010 1010 s 100 sl 0 setlinecap +420 300 450 0 360 arc +420 650 m 420 575 l S +newpath 120 125 m 720 125 l 75 sl S +420 125 m 420 25 l S +220 400 m 220 175 120 175 100 a p p p p +220 400 m 220 550 420 550 80 a p p p p +620 400 m 620 175 720 175 100 a p p p p +620 400 m 620 550 420 550 80 a p p p p +295 550 m 545 550 l{S}}put +/BuildChar{altRTD /BuildChar get exec}def end +altRTD begin /BuildChar{altRTD begin +/char exch def /fontdict exch def save +/charname fontdict /Encoding get char get def +fontdict /StrokeWidth get sl +fontdict /CD get dup charname known +{charname}{/.notdef}ifelse get newpath exec +fontdict /PaintType get 0 eq{exec}{p S}ifelse +restore end}def end +systemdict /currentpacking known{F_Troff /SavePacking get setpacking}if +/Troff F_Troff definefont pop +/Y1{/Troff FF}def +%%EndProlog +%%Page: 1 1 +BP +/slant 0 def +/height 1.000000 def +10 R +10 R +1230 V +12 B +1419(A)S +1541(Reference)S +2088(Guide)S +2439(for)S +2628(the)S +2824(IRAF)S +3152(Client)S +3502(Display)S +3926(Library)S +4369(\(CDL\))S +1470 V +10 I +2662(Michael)S +3019(Fitzpatrick)S +1650 V +10 R +2645(NOAO/IRAF)S +3219(Group)S +1890 V +2765(February)S +3155(1997)S +2130 V +10 I +2619(Revised:)S +2992(August)S +3300(2001)S +2250 V +2479(Current)S +2826(Version:)S +3230(CDL)S +3455(V1.8)S +2850 V +2823(ABSTRACT)S +3090 V +11 R +1510(The)S +1713(Client)S +2016(Display)S +2391(Library)S +2752(\(CDL\))S +3077(is)S +3184(a)S +3265(host)S +3482(interface)S +3896(for)S +4056(C,)S +4192(Fortran)S +4549(or)S +4674(SPP)S +3210 V +1260(programs)S +1707(allowing)S +2125(them)S +2378(to)S +2497(display)S +2848(images)S +3192(or)S +3316(overlay)S +3677(graphics)S +4081(to)S +4200(display)S +4551(servers)S +3330 V +1260(such)S +1513(as)S +11 I +1656(XImtool)S +11 R +2010(,)S +11 I +2090(DS9)S +11 R +2279(,)S +2359(or)S +11 I +2502(SAOimage)S +3023(/)S +3106(SAOtng)S +11 R +3448(.)S +3562(High-level)S +4084(procedures)S +4616(allow)S +3450 V +1260(IRAF)S +1545(or)S +1670(FITS)S +1931(images)S +2276(to)S +2396(be)S +2533(displayed)S +2988(simply,)S +3351(other)S +3610(routines)S +3998(permit)S +4319(access)S +4631(to)S +4750(all)S +3570 V +1260(other)S +1537(server)S +1855(functions)S +2316(\(e.g.)S +2563(cursor)S +2888(and)S +3098(image)S +3418(readback,)S +3891(frame)S +4198(selection,)S +4669(etc\).)S +3690 V +1260(The)S +1470(library)S +1802(also)S +2019(features)S +2404(a)S +2492(number)S +2867(of)S +2997(functions)S +3445(for)S +3611(doing)S +3901(image)S +4208(overlay)S +4575(graph-)S +3810 V +1260(ics;)S +1451(supported)S +1922(graphics)S +2331(primitives)S +2816(include)S +3177(numerous)S +3648(point)S +3913(shapes,)S +4272(lines,)S +4547(circles,)S +3930 V +1260(ellipses,)S +1651(polygons,)S +2116(annular)S +2477(shapes,)S +2830(and)S +3021(text.)S +4410 V +10 R +900(August)S +1219(11,)S +1374(2001)S +7920 V +EP +%%Page: 1 2 +BP +/slant 0 def +/height 1.000000 def +10 R +10 R +840 V +13 B +2810(Contents)S +1200 V +10 R +900(1)S +10 B +1080(Introduction)S +10 R +1632(....................................................................................................................................)S +5032(1)S +1380 V +900(2)S +10 B +1080(Getting)S +1432(Started)S +10 R +1757(...............................................................................................................................)S +5032(1)S +1560 V +900(3)S +10 B +1080(Server)S +1392(Connections)S +10 R +1932(........................................................................................................................)S +5032(2)S +1680 V +1080(3.1)S +1440(Domain)S +1792(Sockets)S +2107(.................................................................................................................)S +5032(2)S +1800 V +1080(3.2)S +1440(Named)S +1758(FIFO)S +2005(Pipes)S +2232(............................................................................................................)S +5032(3)S +1920 V +1080(3.3)S +1440(Inet)S +1625(Sockets)S +1957(.......................................................................................................................)S +5032(3)S +2040 V +1080(3.4)S +1440(User-De\256ned)S +2007(Connections.................................................................................................)S +5032(3)S +2220 V +900(4)S +10 B +1080(Image)S +1376(Display)S +10 R +1707(.................................................................................................................................)S +5032(3)S +2340 V +1080(4.1)S +1440(Overview)S +1863(of)S +1976(the)S +2128(Display)S +2469(Process)S +2782(......................................................................................)S +5032(3)S +2460 V +1080(4.2)S +1440(Displaying)S +1909(IRAF)S +2167(Images)S +2457(...................................................................................................)S +5032(4)S +2580 V +1080(4.3)S +1440(Displaying)S +1909(FITS)S +2145(Images)S +2457(...................................................................................................)S +5032(5)S +2700 V +1080(4.4)S +1440(Displaying)S +1909(Raw)S +2122(Pixels)S +2382(......................................................................................................)S +5032(5)S +2820 V +1080(4.5)S +1440(Frame)S +1725(Selection)S +2107(.................................................................................................................)S +5032(5)S +2940 V +1080(4.6)S +1440(Clearing)S +1814(the)S +1966(Display)S +2282(..........................................................................................................)S +5032(5)S +3060 V +1080(4.7)S +1440(Frame)S +1725(Bu)S +1842 H + (f)show 10 -.5 mul h (f)show +10 R +1903(er)S +2010(Selection......................................................................................................)S +5032(6)S +3180 V +1188(4.7.1)S +1584(Automatic)S +2036(Selection)S +2432(....................................................................................................)S +5032(6)S +3300 V +1188(4.7.2)S +1584(The)S +1769(Frame)S +2054(Bu)S +2171 H + (f)show 10 -.5 mul h (f)show +10 R +2232(er)S +2339(Con\256guration)S +2925(File)S +3082(..........................................................................)S +5032(6)S +3420 V +1080(4.8)S +1440(Image)S +1719(WCS)S +1966(Description....................................................................................................)S +5032(7)S +3540 V +1188(4.8.1)S +1584(Image)S +1863(Mappings)S +2282(..........................................................................................................)S +5032(7)S +3660 V +1080(4.9)S +1440(Image)S +1719(Colormaps)S +2182(..............................................................................................................)S +5032(8)S +3780 V +1188(4.9.1)S +1584(Imtool)S +1881(Color)S +2139(Model)S +2407(.....................................................................................................)S +5032(9)S +3900 V +1080(4.10)S +1440(ZScale)S +1747(Intensity)S +2127(Mapping)S +2507(.................................................................................................)S +5032(9)S +4020 V +1080(4.11)S +1440(Image)S +1719(Hardcopy)S +2132(................................................................................................................)S +4982(10)S +4140 V +1080(4.12)S +1440(Image)S +1719(Cursor)S +2007(.....................................................................................................................)S +4982(10)S +4260 V +1188(4.12.1)S +1584(Cursor)S +1886(Sampling)S +2282(..........................................................................................................)S +4982(11)S +4380 V +1080(4.13)S +1440(Image)S +1719(Readout)S +2057(...................................................................................................................)S +4982(11)S +4500 V +1080(4.14)S +1440(Subraster)S +1847(I/O)S +1982(......................................................................................................................)S +4982(11)S +4680 V +900(5)S +10 B +1080(Graphics)S +1505(Overlay)S +10 R +1857(...........................................................................................................................)S +4982(11)S +4800 V +1080(5.1)S +1440(Marker)S +1763(Coordinates)S +2257(...........................................................................................................)S +4982(11)S +4920 V +1080(5.2)S +1440(Mapping)S +1831(a)S +1905(Previously)S +2363(Displayed)S +2798(Image)S +3057(...........................................................................)S +4982(11)S +5040 V +1080(5.3)S +1440(Marking)S +1814(a)S +1888(Coordinate)S +2362(File)S +2532(................................................................................................)S +4982(12)S +5160 V +1080(5.4)S +1440(Marker)S +1763(Colors)S +2032(....................................................................................................................)S +4982(12)S +5280 V +1080(5.5)S +1440(Marker)S +1763(Types.....................................................................................................................)S +4982(12)S +5400 V +1188(5.5.1)S +1584(Point)S +1807(.............................................................................................................................)S +4982(13)S +5520 V +1188(5.5.2)S +1584(Line)S +1782(..............................................................................................................................)S +4982(13)S +5640 V +1188(5.5.3)S +1584(Box)S +1757(...............................................................................................................................)S +4982(13)S +5760 V +1188(5.5.4)S +1584(Circle)S +1832(............................................................................................................................)S +4982(13)S +5880 V +1188(5.5.5)S +1584(Polyline)S +1932(........................................................................................................................)S +4982(14)S +6000 V +1188(5.5.6)S +1584(Polygon)S +1932(........................................................................................................................)S +4982(14)S +6120 V +1188(5.5.7)S +1584(Ellipse)S +1882(..........................................................................................................................)S +4982(14)S +6240 V +1188(5.5.8)S +1584(Circular)S +1941(Annuli)S +2232(............................................................................................................)S +4982(14)S +6360 V +1188(5.5.9)S +1584(Elliptical)S +1981(Annuli)S +2282(..........................................................................................................)S +4982(14)S +6480 V +1188(5.5.10)S +1584(Text)S +1782(..............................................................................................................................)S +4982(14)S +6600 V +1080(5.6)S +1440(Text)S +1653(Fonts)S +1882(..........................................................................................................................)S +4982(15)S +6720 V +1188(5.6.1)S +1584(In-line)S +1880(Font)S +2094(Changes)S +2457(...................................................................................................)S +4982(15)S +6840 V +1080(5.7)S +1440(Line)S +1653(Widths)S +1972(and)S +2146(Styles)S +2407(.....................................................................................................)S +4982(15)S +6960 V +1080(5.8)S +1440(Deleting)S +1814(Markers)S +2157(...............................................................................................................)S +4982(16)S +7080 V +1188(5.8.1)S +1584(Individual)S +2025(Markers.......................................................................................................)S +4982(16)S +7200 V +1188(5.8.2)S +1584(The)S +1769(Entire)S +2043(Overlay)S +2382(......................................................................................................)S +4982(16)S +7920 V +EP +%%Page: 2 3 +BP +/slant 0 def +/height 1.000000 def +10 R +10 R +480 V +11 R +2963(- 2 -)S +840 V +10 R +1080(5.9)S +1440(Redrawing)S +1908(the)S +2060(Overlay)S +2382(......................................................................................................)S +4982(16)S +1020 V +900(6)S +10 B +1080(ANSI)S +1349(C)S +1451(Function)S +1865(Prototypes)S +10 R +2332(........................................................................................................)S +4982(17)S +1200 V +900(7)S +10 B +1080(Fortran)S +1448(Language)S +1901(Binding)S +2272(Notes)S +10 R +2532(................................................................................................)S +4982(17)S +1380 V +900(8)S +10 B +1080(SPP)S +1288(Language)S +1741(Binding)S +2112(Notes)S +10 R +2357(.......................................................................................................)S +4982(18)S +1560 V +900(9)S +10 B +1080(IIS)S +1244(Protocol)S +1634(Description)S +10 R +2132(................................................................................................................)S +4982(18)S +1740 V +900(10)S +10 B +1080(VXIMTOOL)S +1677(Proxy/Display)S +2313(Server)S +2625(Usage)S +10 R +2882(..................................................................................)S +4982(19)S +1920 V +900(11)S +10 B +1080(C)S +1182(Interface)S +1599(Summary)S +10 R +2032(....................................................................................................................)S +4982(21)S +2100 V +900(12)S +10 B +1080(C)S +1182(Example)S +1590(Tasks)S +10 R +1857(...........................................................................................................................)S +4982(23)S +2220 V +1080(12.1)S +1440(Display)S +1781(Example)S +2157(...............................................................................................................)S +4982(23)S +2340 V +1080(12.2)S +1440(Interactive)S +1896(Graphics)S +2286(Overlay)S +2637(Example)S +3007(.............................................................................)S +4982(27)S +2460 V +1080(12.3)S +1440(Image)S +1719(Mosaic)S +2043(Example)S +2407(.....................................................................................................)S +4982(31)S +2640 V +900(13)S +10 B +1080(Fortran)S +1448(Interface)S +1865(Summary)S +10 R +2307(.........................................................................................................)S +4982(33)S +2820 V +900(14)S +10 B +1080(Fortran)S +1448(Example)S +1856(Tasks)S +10 R +2107(.................................................................................................................)S +4982(35)S +2940 V +1080(14.1)S +1440(Display)S +1781(Example)S +2157(...............................................................................................................)S +4982(35)S +3060 V +1080(14.2)S +1440(Interactive)S +1896(Graphics)S +2286(Overlay)S +2637(Example)S +3007(.............................................................................)S +4982(36)S +3240 V +900(15)S +10 B +1080(SPP)S +1288(Interface)S +1705(Summary)S +10 R +2132(................................................................................................................)S +4982(38)S +7920 V +EP +%%Page: 1 4 +BP +/slant 0 def +/height 1.000000 def +10 R +10 R +1230 V +12 B +1419(A)S +1541(Reference)S +2088(Guide)S +2439(for)S +2628(the)S +2824(IRAF)S +3152(Client)S +3502(Display)S +3926(Library)S +4369(\(CDL\))S +1470 V +10 I +2662(Michael)S +3019(Fitzpatrick)S +1650 V +10 R +2645(NOAO/IRAF)S +3219(Group)S +1890 V +2765(February)S +3155(1997)S +2130 V +10 I +2619(Revised:)S +2992(August)S +3300(2001)S +2250 V +2479(Current)S +2826(Version:)S +3230(CDL)S +3455(V1.8)S +2730 V +11 B +900(1.)S +1049(Introduction)S +2886 V +11 R +1175(For)S +1368(more)S +1633(than)S +1862(a)S +1950(decade)S +2292(IRAF)S +2583(has)S +2769(used)S +3010(a)S +11 I +3098(display)S +3456(server)S +11 R +3769(as)S +3900(the)S +4075(primary)S +4463(means)S +4784(for)S +4952(image)S +3006 V +900(display.)S +1320(IRAF)S +1612(client)S +1897(tasks)S +2158(connect)S +2539(to)S +2666(the)S +2840(server)S +3146(and)S +3344(send)S +3585(or)S +3716(read)S +3943(data)S +4165(using)S +4444(a)S +4532(modi\256cation)S +5129(of)S +3126 V +900(the)S +1081(IIS)S +1262(Model)S +1596(70)S +1753(protocol,)S +2194(originally)S +2669(through)S +3058(named)S +3397(\256fo)S +3597(pipes)S +3876(but)S +4064(more)S +4337(recently)S +4737(using)S +5024(unix)S +3246 V +900(domain)S +1268(or)S +1397(inet)S +1600(sockets.)S +2022(The)S +2230(advantage)S +2710(to)S +2833(this)S +3030(approach)S +3467(was)S +3674(that)S +3876(IRAF)S +4164(client)S +4445(tasks)S +4702(could)S +4983(make)S +3366 V +900(use)S +1083(of)S +1211(the)S +1383(image)S +1689(display)S +2045(functionality)S +2645(without)S +3020(duplicating)S +3553(the)S +3725(code)S +3969(needed)S +4316(for)S +4481(actually)S +4866(display-)S +3486 V +900(ing)S +1078(the)S +1249(image.)S +1615(The)S +1822(longtime)S +2251(disadvantage)S +2859(was)S +3065(that)S +3266(the)S +3436(IIS)S +3606(protocol)S +4008(used)S +4245(was)S +4451(arcane)S +4770(and)S +4964(undo-)S +3606 V +900(cumented)S +1375(and)S +1582(therefore)S +2024(largely)S +2377(unavailable)S +2931(to)S +3066(applications)S +3646(outside)S +4013(of)S +4153(the)S +4336(IRAF)S +4636(project.)S +5050(The)S +3726 V +900(Client)S +1213(Display)S +1598(Library)S +1969(\(CDL\))S +2304(provides)S +2725(a)S +2816(public)S +3134(C)S +3251(and)S +3451(Fortran)S +3816(interface)S +4239(for)S +4408(displaying)S +4909(images)S +3846 V +900(and)S +1091(overlay)S +1452(graphics)S +1856(that)S +2054(is)S +2161(independent)S +2730(of)S +2854(the)S +3021(underlying)S +3530(protocol)S +3929(used.)S +4002 V +1175(Unlike)S +1512(the)S +1684(interface)S +2103(used)S +2342(by)S +2490(IRAF)S +2779(applications,)S +3376(the)S +3548(CDL)S +3807(is)S +3920(meant)S +4227(to)S +4352(provide)S +4726(an)S +4868(easy-to-)S +4122 V +900(use,)S +1109(fully)S +1351(featured)S +1742(interface)S +2157(for)S +2318(applications)S +2883(that)S +3082(can)S +3267(be)S +3404(easily)S +3694(evolved)S +4075(for)S +4236(future)S +4531(display)S +4883(servers,)S +4242 V +900(communications)S +1675(schemes,)S +2122(or)S +2261(display)S +2627(functionality.)S +3298(Indeed,)S +3671(the)S +3853(CDL)S +4121(is)S +4244(independent)S +4829(of)S +4969(IRAF)S +4362 V +900(itself)S +1163(\(as)S +1333(are)S +1508(the)S +1685(display)S +2046(servers\))S +2434(so)S +2575(display)S +2936(tasks)S +3199(can)S +3393(be)S +3539(written)S +3893(for)S +4063(any)S +4264(discipline)S +4735(or)S +4868(applica-)S +4482 V +900(tion.)S +4638 V +1175(While)S +1478(this)S +1673(guide)S +1952(assumes)S +2353(programs)S +2802(are)S +2969(written)S +3315(in)S +3436(C,)S +3573(Fortran)S +3931(programmers)S +4550(should)S +4879(\256nd)S +5086(the)S +4758 V +900(translation)S +1408(straightforward)S +2127(by)S +2281(referring)S +2706(to)S +2836(the)S +3014(Fortran)S +3381(interface)S +3806(summary.)S +4320(The)S +4534(package)S +4935(source)S +4878 V +900(\256les)S +1117(include)S +1473(example)S +1877(tasks)S +2130(as)S +2254(does)S +2488(this)S +2681(guide;)S +2989(users)S +3247(with)S +3477(problems,)S +3948(questions,)S +4426(or)S +4551(bug)S +4750(reports)S +5088(are)S +4998 V +900(encouraged)S +1444(to)S +1571(contact)S +11 I +1928(iraf@noao.edu)S +11 R +2595(.)S +2697(A)S +2817(small)S +3097(code)S +3344(sample)S +3696(demonstrating)S +4365(the)S +4539(problem)S +4945(would)S +5118 V +900(be)S +1036(very)S +1263(helpful)S +1607(in)S +1726(\256nding)S +2072(a)S +2153(solution)S +2542(to)S +2661(any)S +2852(reported)S +3249(problems.)S +5478 V +11 B +900(2.)S +1049(Getting)S +1436(Started)S +5634 V +11 R +1175(All)S +1358(C)S +1474(programs)S +1930(must)S +2188(include)S +2554(the)S +2731(header)S +3064(\256le)S +11 B +3248("cdl.h")S +11 R +3646(in)S +3775(order)S +4048(to)S +4177(get)S +4354(package)S +4754(de\256nitions)S +5754 V +900(for)S +1084(constants)S +1550(such)S +1808(as)S +1956(colors)S +2281(and)S +2496(structure)S +2936(de\256nitions)S +3459(used.)S +3778(The)S +4005(Fortran)S +4385(interface)S +4822(does)S +5079(not)S +5874 V +11 I +900(require)S +11 R +1257(anything)S +1676(similar,)S +2045(however)S +2456(for)S +2618(fortran)S +2950(compilers)S +3418(which)S +3721(support)S +4086(an)S +11 C +4257(include)S +11 R +4754(directive)S +5172(a)S +5994 V +11 B +900(cdlftn.inc)S +11 R +1383(\256le)S +1562(may)S +1789(be)S +1930(used)S +2169(to)S +2293(de\256ne)S +2599(symbolic)S +3041(constants)S +3488(passed)S +3818(to)S +3942(procedures,)S +4487(this)S +4685(\256le)S +4864(must)S +5117(be)S +6114 V +900(included)S +1320(by)S +1472(each)S +1713(procedure)S +2191(using)S +2472(the)S +2648(CDL.)S +2971(Fortran)S +3336(programs)S +3792(not)S +3975(using)S +4257(this)S +4460(\256le)S +4644(must)S +4902(pass)S +5134(in)S +6234 V +900(the)S +1077(constants)S +1529(explicitly,)S +2016(needed)S +2368(values)S +2690(are)S +2864(found)S +3162(throughout)S +3687(this)S +3889(manual.)S +4315(C)S +4431(procedures)S +4952(which)S +6354 V +900(return)S +1199(an)S +1340(integer)S +1682(value)S +1957(will)S +2167(return)S +2466(a)S +2552(positive)S +2939(number)S +3312(to)S +3436(indicate)S +3821(an)S +3962(error)S +4211(has)S +4395(occurred)S +4815(and)S +5012(print)S +6474 V +900(an)S +1036(error)S +1280(message,)S +1712(otherwise)S +2171(zero)S +2391(is)S +2498(returned.)S +6630 V +1175(The)S +11 B +1381(cdl_open\(\))S +11 R +1912(procedure)S +2384(is)S +2494(used)S +2731(to)S +2853(establish)S +3274(a)S +3358(connection)S +3875(to)S +3997(the)S +4167(server)S +4469(and)S +4664(initialize)S +5086(the)S +6750 V +900(package,)S +1323(it)S +1423(returns)S +1765(a)S +1851(CDL)S +2108(structure)S +2528(pointer)S +2876(that)S +3078(is)S +3189(passed)S +3518(to)S +3641(other)S +3903(CDL)S +4160(procedures.)S +4737(For)S +4927(C)S +5038(pro-)S +6870 V +900(grams)S +1207(this)S +1406(means)S +1726(a)S +1814(separate)S +2211(pointer)S +2562(may)S +2791(be)S +2934(maintained)S +3462(for)S +3629(each)S +3868(server)S +4174(connection,)S +4723(the)S +4897(Fortran)S +6990 V +900(interface)S +1329(is)S +1451(limited)S +1812(to)S +1946(only)S +2190(one)S +2396(server)S +2710(connection)S +3239(per)S +3425(process)S +3800(since)S +4072(the)S +4253(pointer)S +4611(is)S +4732(maintained)S +7110 V +900(internally.)S +1428(The)S +1644(connection)S +2171(is)S +2291(terminated)S +2806(using)S +3091(the)S +11 B +3271(cdl_close\(\))S +11 R +3810(procedure.)S +4353(Between)S +4783(these)S +5055(two)S +7230 V +900(calls)S +1158(may)S +1404(be)S +1564(any)S +1779(combination)S +2385(of)S +2532(CDL)S +2808(procedure)S +3300(calls)S +3557(for)S +3740(doing)S +4047(image)S +4371(display)S +4745(or)S +4892(overlay)S +7920 V +EP +%%Page: 2 5 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2963(- 2 -)S +840 V +900(graphics.)S +996 V +1175(For)S +1376(example,)S +1823(the)S +2005(simplest)S +2421(possible)S +2830(program)S +3249(for)S +3424(displaying)S +3931(an)S +4083(IRAF)S +4383(image)S +4700(would)S +5024(look)S +1116 V +900(something)S +1392(like:)S +1296 V +11 C +1450(#include)S +2044("cdl.h")S +1536 V +1450(main)S +1780(\(int)S +2110(argc,)S +2506(char)S +2836(*argv[]\))S +1656 V +1450({)S +1776 V +1714(CDLPtr)S +2176(cdl)S +2440(=)S +2572(cdl_open)S +3166(\(\(char)S +3628(*\)0\);)S +1896 V +1714(cdl_displayIRAF)S +2770(\(cdl,)S +3166(argv[1],)S +3760(1,)S +3958(1,)S +4156(1,)S +4354(1\);)S +2016 V +1714(cdl_close)S +2374(\(cdl\);)S +2136 V +1450(})S +2352 V +11 R +900(This)S +1131(program)S +1537(displays)S +1933(band)S +2181(one)S +2374(of)S +2500(an)S +2638(image)S +2941(named)S +3268(on)S +3413(the)S +3582(command)S +4050(line)S +4250(to)S +4372(the)S +4542(server)S +4844(in)S +4966(frame)S +2472 V +900(one)S +1092(using)S +1365(the)S +1533(default)S +1871(512x512)S +2290(frame)S +2577(bu)S +2687 H + (f)show 11 -.5 mul h (f)show +11 R +2754(er,)S +2899(zscaling)S +3291(the)S +3458(pixels)S +3754(to)S +3873(8-bit)S +4114(values)S +4427(automatically.)S +5086(No)S +2592 V +900(error)S +1146(checking)S +1576(is)S +1685(performed)S +2175(to)S +2296(verify)S +2592(that)S +2792(a)S +2875(connection)S +3391(was)S +3596(established)S +4119(or)S +4245(that)S +4445(the)S +4614(argument)S +5063(is)S +5172(a)S +2712 V +900(valid)S +1163(IRAF)S +1457(image.)S +1829(Most)S +2099(programs)S +2555(will)S +2769(be)S +2914(more)S +3181(complex)S +3601(than)S +3832(this)S +4034(but)S +4217(it)S +4321(should)S +4657(be)S +4802(clear)S +5055(that)S +2832 V +900(image)S +1201(display)S +1552(from)S +1798(client)S +2075(applications)S +2639(is)S +2746(a)S +2827(now)S +3049(trivial)S +3345(operation.)S +3072 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +3252 V +11 C +1175(#include)S +1769("cdl.h")S +3492 V +1175(CDLPtr)S +1637(cdl_open)S +2231(\(char)S +2627(*imtdev\))S +3612 V +1175(void)S +1505(cdl_close)S +2165(\(CDLPtr)S +2693(cdl\))S +3972 V +11 B +900(3.)S +1049(Server)S +1391(Connections)S +4128 V +11 R +1175(The)S +11 B +1391(cdl_open\(\))S +11 R +1932(procedure)S +2414(takes)S +2685(a)S +2779(single)S +3088(argument)S +3548(specifying)S +4051(the)S +4232(type)S +4468(of)S +4606(connection)S +5134(to)S +4248 V +900(make)S +1175(to)S +1298(the)S +1469(server,)S +1800(this)S +1997(routine)S +2345(also)S +2559(initializes)S +3024(the)S +3195(CDL)S +3452(package.)S +3907(If)S +4016(this)S +4213(is)S +4324(a)S +4409(NULL)S +4738(pointer)S +5086(the)S +4368 V +900(CDL)S +1171(will)S +1395(attempt)S +1777(to)S +1915(\256rst)S +2139(connect)S +2531(on)S +2693(a)S +2793(unix)S +3041(domain)S +3423(socket,)S +3783(if)S +3902(that)S +4119(fails)S +4360(the)S +4546(standard)S +4969(IRAF)S +4488 V +900(/dev/imt1*)S +1411(\256fo)S +1597(pipes)S +1862(are)S +2027(tried.)S +2322(The)S +2525(syntax)S +2845(for)S +3005(the)S +11 I +3172(imtdev)S +11 R +3497(argument)S +3944(is)S +4051(as)S +4175(follows:)S +4668 V +11 C +2000(<domain>)S +2594(:)S +2726(<address>)S +4884 V +11 R +900(where)S +1204(<domain>)S +1696(is)S +1808(one)S +2004(of)S +2133(")S +11 B +2178(inet)S +11 R +2355(")S +2438(\(internet)S +2847(tcp/ip)S +3136(socket\),)S +3518(")S +11 B +3563(unix)S +11 R +3773(")S +3856(\(unix)S +4126(domain)S +4494(socket\))S +4848(or)S +4977(")S +11 B +5022(\256fo)S +11 R +5175(")S +5004 V +900(\(named)S +1264(pipe\).)S +1586(The)S +1792(form)S +2041(of)S +2168(the)S +2338(address)S +2702(depends)S +3097(upon)S +3353(the)S +3522(domain,)S +3915(as)S +4041(illustrated)S +4516(in)S +4637(the)S +4806(examples)S +5124 V +900(below.)S +1264(The)S +1469(address)S +1832(\256eld)S +2063(may)S +2288(contain)S +2647(up)S +2793(to)S +2915(two)S +3116("%d")S +3388(\256elds.)S +3724(If)S +3832(present,)S +4212(the)S +4382(user's)S +4679(UID)S +4909(will)S +5117(be)S +5244 V +900(substituted)S +1440(\(e.g.)S +1697("unix:/tmp/.IMT%d"\).)S +2749(The)S +2981(default)S +3347(connection)S +3890(if)S +4019(no)S +4191(imtdev)S +4559(is)S +4695(speci\256ed)S +5146(is)S +5364 V +900("unix:/tmp/.IMT%d",)S +1909(failing)S +2251(that)S +2471(a)S +2574(connection)S +3110(is)S +3239(attempted)S +3727(on)S +3892(the)S +4082(/dev/imt1[io])S +4719(named)S +5067(\256fo)S +5484 V +900(pipes.)S +5724 V +11 B +900(3.1.)S +1132(Domain)S +1538(Sockets)S +5880 V +11 R +1175(Domain)S +1576(sockets)S +1946(are)S +2125(sockets)S +2495(created)S +2856(on)S +3013(the)S +3194(local)S +3454(host.)S +3746(The)S +3963(connection)S +4491(is)S +4612(usually)S +4978(faster)S +6000 V +900(than)S +1130(an)S +1274(inet)S +1479(socket)S +1799(and)S +1997(comparable)S +2547(to)S +2673(a)S +2761(\256fo.)S +3015(If)S +3127(the)S +3301(socket)S +3621(name)S +3898(is)S +4012(speci\256ed)S +4442(with)S +4678(a)S +4766('%d')S +5024(\256eld)S +6120 V +900(the)S +1073(client)S +1356(can)S +1546(be)S +1688(assured)S +2055(of)S +2185(a)S +2272(unique)S +2610(socket)S +2929(name)S +3205(for)S +3371(each)S +3609(user)S +3831(allowing)S +4256(multiple)S +4664(clients)S +4991(to)S +5117(be)S +6240 V +900(run)S +1079(on)S +1222(the)S +1389(same)S +1647(host)S +1864(by)S +2007(di)S +2093 H + (f)show 11 -.5 mul h (f)show +11 R +2160(erent)S +2411(users.)S +6396 V +900(Example)S +11 Y1 +900(2)S +905(2222222)S +6696 V +11 C +1175(/*)S +1373(Connection)S +2099(to)S +2297(a)S +2429(local)S +2825(host)S +3155(using)S +3551(socket)S +4013(domain)S +4475(socket.)S +5003(*/)S +6816 V +1175(if)S +1373(\(\(cdl)S +1769(=)S +1901(cdl_open)S +2495(\("unix:/tmp/.IMT%d"\)\))S +3947(==)S +4145(NULL\))S +4541({)S +6936 V +1505(fprintf)S +2033(\(stderr,)S +2627("cannot)S +3155(open)S +3485(domain)S +3947(socket)S +4409(connection\\n"\);)S +7056 V +1505(exit)S +1835(\(1\);)S +7176 V +1175(})S +7920 V +EP +%%Page: 3 6 +BP +/slant 0 def +/height 1.000000 def +11 C +11 C +480 V +11 R +2963(- 3 -)S +840 V +11 B +900(3.2.)S +1132(Named)S +1500(FIFO)S +1796(Pipes)S +996 V +11 R +1175(This)S +1426(is)S +1555(the)S +1744(traditional)S +2251(approach,)S +2734(and)S +2947(the)S +3136(only)S +3387(one)S +3600(supported)S +4089(by)S +4255(SAOimage)S +4799(\(although)S +1116 V +900(recent)S +1208(versions)S +1616(contain)S +1981(support)S +2353(for)S +2522(sockets\).)S +2951(Any)S +3182(named)S +3516(\256fo)S +3711(pipe)S +3942(may)S +4173(be)S +4318(used,)S +4589(the)S +4765(syntax)S +5093(for)S +1236 V +900(the)S +11 I +1067(imtdev)S +11 R +1392(string)S +1676(in)S +1795(this)S +1988(case)S +2208(is)S +1416 V +11 B +1450(\256fo:)S +11 C +1639(<input_fifo>)S +11 B +2431(:)S +11 C +2467(<output_fifo>)S +1632 V +11 R +900(Example)S +11 Y1 +900(2)S +905(2222222)S +1812 V +11 C +1175(/*)S +1373(Connection)S +2099(to)S +2297(a)S +2429(local)S +2825(host)S +3155(using)S +3551(named)S +3947(fifo)S +4277(pipes.)S +4739(*/)S +1932 V +1175(if)S +1373(\(\(cdl)S +1769(=)S +1901(cdl_open)S +2495(\("fifo:/dev/imt1i:/dev/imt1o"\)\))S +4607(==)S +4805(NULL\))S +5201({)S +2052 V +1505(fprintf)S +2033(\(stderr,)S +2627("cannot)S +3155(open)S +3485(fifo)S +3815(pipe)S +4145(connection\\n"\);)S +2172 V +1505(exit)S +1835(\(1\);)S +2292 V +1175(})S +2532 V +11 B +900(3.3.)S +1132(Inet)S +1354(Sockets)S +2688 V +11 R +1175(Inet)S +1378(sockets)S +1734(are)S +1899(connections)S +2456(between)S +2854(hosts)S +3115(via)S +3283(a)S +3365(tcp/ip)S +3650(socket.)S +4025(This)S +4255(permits)S +4619(connecting)S +5134(to)S +2808 V +900(the)S +1067(server)S +1366(over)S +1593(a)S +1674(remote)S +2011(network)S +2403(connection)S +2917(anywhere)S +3374(on)S +3517(the)S +3684(Internet.)S +2964 V +900(Example)S +11 Y1 +900(2)S +905(2222222)S +3144 V +11 C +1175(/*)S +1373(Connection)S +2099(to)S +2297(a)S +2429(local)S +2825(host)S +3155(using)S +3551(socket)S +4013(5137.)S +4409(*/)S +3264 V +1175(if)S +1373(\(\(cdl)S +1769(=)S +1901(cdl_open)S +2495(\("inet:5137"\)\))S +3485(==)S +3683(NULL\))S +4079({)S +3384 V +1505(fprintf)S +2033(\(stderr,)S +2627("cannot)S +3155(open)S +3485(inet)S +3815(socket)S +4277(connection\\n"\);)S +3504 V +1505(exit)S +1835(\(1\);)S +3624 V +1175(})S +3864 V +1175(/*)S +1373(Connection)S +2099(to)S +2297(a)S +2429(remote)S +2891(internet)S +3485(host)S +3815(using)S +4211(socket)S +4673(5137.)S +5069(*/)S +3984 V +1175(if)S +1373(\(\(cdl)S +1769(=)S +1901(cdl_open)S +2495(\("inet:5137:foo.bar.edu"\)\))S +4277(==)S +4475(NULL\))S +4871({)S +4104 V +1505(fprintf)S +2033(\(stderr,)S +2627("cannot)S +3155(open)S +3485(inet)S +3815(socket)S +4277(connection\\n"\);)S +4224 V +1505(exit)S +1835(\(1\);)S +4344 V +1175(})S +4584 V +11 B +900(3.4.)S +1132(User-De\256ned)S +1780(Connections)S +4740 V +11 R +1175(Since)S +1465(IRAF)S +1762(V2.10.3)S +2163(client)S +2453(tasks)S +2719(have)S +2971(been)S +3223(able)S +3451(to)S +3583(use)S +3775(an)S +11 B +3924(IMTDEV)S +11 R +4422(unix)S +4665(environment)S +4860 V +900(variable)S +1286(to)S +1406(set)S +1562(the)S +1730(connection)S +2245(type,)S +2496(the)S +2663(syntax)S +2983(of)S +3107(this)S +3300(variable)S +3685(is)S +3792(the)S +3959(same)S +4217(as)S +4341(described)S +4793(above.)S +5148(If)S +4980 V +900(the)S +11 I +1069(cdl_open\(\))S +11 R +1578(procedure)S +2049(is)S +2158(called)S +2454(with)S +2685(a)S +2768(NULL)S +3095(pointer)S +3441(the)S +3610(IMTDEV)S +4071(environment)S +4661(variable)S +5048(will)S +5100 V +900(automatically)S +1544(be)S +1693(checked.)S +2157(To)S +2325(explicitly)S +2787(use)S +2979(this)S +3185(\(or)S +3358(any)S +3562(other\))S +3868(variable)S +4265(in)S +4396(the)S +4575(client)S +4864(task)S +5086(the)S +5220 V +11 I +900(cdl_open\(\))S +11 R +1407(procedure)S +1876(may)S +2098(be)S +2234(called)S +2528(as)S +2652(e.g.)S +5400 V +11 C +1175(if)S +1373(\(\(cdl)S +1769(=)S +1901(cdl_open)S +2495(\(getenv\("IMTDEV"\)\)\))S +3815(==)S +4013(NULL\))S +4409({)S +5520 V +1505(fprintf)S +2033(\(stderr,)S +2627("cannot)S +3155(open)S +3485(server)S +3947(connection\\n"\);)S +5640 V +1505(exit)S +1835(\(1\);)S +5760 V +1175(})S +6000 V +11 B +900(4.)S +1049(Image)S +1374(Display)S +6240 V +900(4.1.)S +1132(Overview)S +1615(of)S +1739(the)S +1918(Display)S +2307(Process)S +6396 V +11 R +1175(Basic)S +1492(image)S +1833(display)S +2224(is)S +2371(done)S +2658(most)S +2947(easily)S +3277(using)S +3590(the)S +3798(high-level)S +11 B +4317(cdl_displayIRAF\(\))S +11 R +5192(,)S +6516 V +11 B +900(cdl_displayFITS\(\))S +11 R +1807(and)S +11 B +2018(cdl_displayPix\(\))S +11 R +2831(procedures.)S +3424(These)S +3738(routines)S +4145(automatically)S +4796(de\256ne)S +5117(an)S +6636 V +900(image)S +1218(WCS)S +1507(and)S +1715(mapping,)S +2178(clear)S +2439(the)S +2623(frame,)S +2955(set)S +3127(the)S +3311(frame)S +3615(bu)S +3725 H + (f)show 11 -.5 mul h (f)show +11 R +3792(er)S +3926(con\256guration)S +4562(and)S +4770(center)S +5086(the)S +6756 V +900(image)S +1237(in)S +1392(the)S +1595(display.)S +2043(For)S +2265(most)S +2549(applications)S +3149(these)S +3443(are)S +3644(all)S +3823(that)S +4057(will)S +4298(be)S +4470(needed,)S +4876(but)S +5086(the)S +6876 V +11 B +900(cdl_writeSubRaster\(\))S +11 R +1940(procedure)S +2411(can)S +2597(also)S +2809(be)S +2947(used)S +3183(to)S +3304(display)S +3657(an)S +3795(image.)S +4159(For)S +4347(example,)S +4781(to)S +4902(display)S +6996 V +900(one)S +1109(image)S +1428(in)S +1565(a)S +1664(mosaic)S +2026(or)S +2168(other)S +2444(cases)S +2725(where)S +3042(the)S +3226(task)S +3453(needs)S +3752(low-level)S +4216(access)S +4544(to)S +4680(position)S +5086(the)S +7116 V +900(image)S +1201(or)S +1325(write)S +1583(raw)S +1779(pixel)S +2032(values.)S +7920 V +EP +%%Page: 4 7 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2963(- 4 -)S +840 V +1175(In)S +1322(these)S +1603(cases)S +1889(it)S +2007(is)S +2137(the)S +2328(responsibility)S +2985(of)S +3133(the)S +3324(client)S +3625(program)S +4053(to)S +4196(prepare)S +4579(the)S +4770(server)S +5093(for)S +960 V +900(display.)S +1312(The)S +1515(basic)S +1773(steps)S +2026(involved)S +2444(in)S +2563(displaying)S +3055(an)S +3191(image)S +3492(include)S +1200 V +11 B +1407(Operation)S +3773(CDL)S +4038(Procedure)S +1210 V +11 Y1 +1407(2)S +1413(222222222222222222222222222222222222222222222222222222222222)S +1330 V +11 R +1407(Selecting)S +1849(the)S +2016(frame)S +11 I +3773(cdl_setFrame\(\))S +1450 V +11 R +1407(Clear)S +1677(the)S +1844(frame)S +11 I +3773(cdl_clearFrame\(\))S +1570 V +11 R +1407(Select)S +1708(the)S +1875(frame)S +2162(bu)S +2272 H + (f)show 11 -.5 mul h (f)show +11 R +2339(er)S +2456(con\256guration)S +11 I +3773(cdl_selectFB\(\))S +1690 V +11 R +1407(Set)S +1581(the)S +1748(frame)S +2035(bu)S +2145 H + (f)show 11 -.5 mul h (f)show +11 R +2212(er)S +2329(con\256guration)S +11 I +3773(cdl_setFBCon\256g\(\))S +1810 V +11 R +1407(Scale)S +1677(the)S +1844(image)S +2145(pixels)S +2441(to)S +2560(201)S +2758(display)S +3109(values)S +11 I +3773(cdl_zscaleImage\(\))S +1930 V +11 R +1407(Compute)S +1844(the)S +2011(raster)S +2286(placement)S +2769(in)S +2888(the)S +3055(frame)S +3342(bu)S +3452 H + (f)show 11 -.5 mul h (f)show +11 R +3519(er)S +2050 V +1407(Construct)S +1868(a)S +11 I +1949(node!path)S +11 R +2427(image)S +2728(path)S +2170 V +1407(Set)S +1581(the)S +1748(image)S +2049(mapping)S +11 I +3773(cdl_setMapping\(\))S +2290 V +11 R +1407(De\256ne)S +1732(the)S +1899(image)S +2200(WCS)S +2410 V +1407(Set)S +1581(the)S +1748(image)S +2049(WCS)S +11 I +3773(cdl_setWCS\(\))S +2530 V +11 R +1407(Write)S +1689(the)S +1856(pixels)S +2152(to)S +2271(the)S +2438(display)S +11 I +3773(cdl_writeSubRaster\(\))S +2770 V +11 R +900(In)S +1044(cases)S +1328(like)S +1547(a)S +1649(mosaic)S +2014(display,)S +2414(obviously)S +2903(some)S +3189(steps)S +3463(\(e.g.)S +3712(clearing)S +4118(the)S +4306(frame,)S +4642(selecting)S +5086(the)S +2890 V +900(con\256guration,)S +1548(etc\))S +1745(will)S +1950(only)S +2179(need)S +2418(to)S +2537(be)S +2673(done)S +2919(once.)S +3219(XImtool)S +3625(V1.3)S +3875(and)S +4066(later)S +4293(version)S +4649(support)S +5012(mul-)S +3010 V +900(tiple)S +1147(WCSs)S +1480(in)S +1617(a)S +1716(single)S +2030(frame)S +2335(so)S +2484(each)S +2734(piece)S +3015(of)S +3157(the)S +3342(mosaic)S +3704(should)S +4050(de\256ne)S +4370(a)S +4470(mapping)S +4907(and)S +5117(an)S +3130 V +900(independent)S +1487(WCS.)S +1838(The)S +2058(last)S +2261(step)S +2488(in)S +2624(the)S +2808(display)S +3176(here)S +3413(should)S +3757(be)S +3910(a)S +4008(single)S +4321(WCS)S +4610(for)S +4787(the)S +4971(entire)S +3250 V +900(mosaic)S +1264(such)S +1518(as)S +1662(")S +11 I +1707(detector)S +2119(coordinates)S +11 R +2638(",)S +2764(without)S +3154(this)S +3367(the)S +3555(coordinates)S +4114(used)S +4369(by)S +4533(default)S +4891(will)S +5117(be)S +3370 V +900(based)S +1195(on)S +1351(the)S +1530(last)S +1728(WCS)S +2012(sent)S +2234(to)S +2365(the)S +2544(display.)S +2968(Servers)S +3341(which)S +3654(do)S +3809(not)S +3995(support)S +4370(mappings)S +4843(will)S +5060(just)S +3490 V +900(ignore)S +1227(the)S +1408(mapping)S +1840(information,)S +2434(but)S +2622(may)S +2858(still)S +3072(require)S +3428(a)S +3523(frame)S +3824(bu)S +3934 H + (f)show 11 -.5 mul h (f)show +11 R +4001(er)S +4132(WCS)S +4418(for)S +4593(other)S +4866(tasks)S +5134(to)S +3610 V +900(operate)S +1269(correctly.)S +1766(For)S +1967(simple)S +2309(displays)S +2718(of)S +2857(single)S +3168(images,)S +3555(the)S +3737(high-level)S +4230(routines)S +4632(handle)S +4972(all)S +5129(of)S +3730 V +900(these)S +1164(steps)S +1423(automatically,)S +2088(they)S +2316(are)S +2487(included)S +2904(here)S +3130(as)S +3260(checklist)S +3689(of)S +3819(what)S +4071(must)S +4326(be)S +4469(considered)S +4983(when)S +3850 V +900(using)S +1172(the)S +1339(CDL)S +1592(for)S +1752(low-level)S +2199(display.)S +4090 V +11 B +900(4.2.)S +1132(Displaying)S +1669(IRAF)S +1970(Images)S +4246 V +11 R +1175(The)S +11 B +1379(cdl_displayIRAF\(\))S +11 R +2288(procedure)S +2758(can)S +2943(be)S +3080(used)S +3315(to)S +3435(display)S +3787(an)S +3924(IRAF)S +4209(OIF)S +4420(format)S +4746(image)S +5049(\(i.e.)S +4366 V +900(images)S +1252(with)S +1489(a)S +11 I +1578(.imh)S +11 R +1812(extension\))S +2310(by)S +2461(simply)S +2803(passing)S +3174(in)S +3300(the)S +3474(image)S +3782(name.)S +4120(Pixel)S +4387(\256les)S +4611(for)S +4778(the)S +4952(image)S +4486 V +900(must)S +1150(be)S +1288(accessible)S +1766(from)S +2014(the)S +2183(local)S +2431(machine)S +2837(but)S +3013(can)S +3199(be)S +3337(in)S +3458(any)S +3651(directory,)S +4109(the)S +4278(HDR$)S +4600(syntax)S +4923(for)S +5086(the)S +4606 V +900(imdir)S +1174(is)S +1283(also)S +1495(recognized.)S +2070(Images)S +2421(may)S +2645(be)S +2783(three)S +3036(dimensional,)S +3637(the)S +11 I +3806(band)S +11 R +4060(argument)S +4508(is)S +4616(used)S +4851(to)S +4971(select)S +4726 V +900(the)S +1073(image)S +1380(band)S +1632(to)S +1757(be)S +1899(displayed.)S +2420(The)S +11 I +2629(frame)S +11 R +2924(and)S +11 I +3121(fbcon\256g)S +11 R +3514(arguments)S +4011(select)S +4300(the)S +4474(frame)S +4768(and)S +4966(frame)S +4846 V +900(bu)S +1010 H + (f)show 11 -.5 mul h (f)show +11 R +1077(er)S +1210(size)S +1429(respectively,)S +2035(the)S +2218(special)S +2571(symbolic)S +3024(value)S +11 B +3310(FB_AUTO)S +11 R +3872(may)S +4109(be)S +4260(used)S +4509(for)S +4684(the)S +11 I +4866(fbcon\256g)S +4966 V +11 R +900(argument)S +1358(to)S +1488(have)S +1738(the)S +1916(procedure)S +2396(automatically)S +3038(select)S +3331(the)S +3509(frame)S +3807(bu)S +3917 H + (f)show 11 -.5 mul h (f)show +11 R +3984(er)S +4112(most)S +4371(appropriate)S +4914(for)S +5086(the)S +5086 V +900(image)S +1208(size.)S +1479(If)S +1591(the)S +11 I +1765(zscale)S +11 R +2073(\257ag)S +2278(is)S +2392(greater)S +2734(than)S +2963(zero)S +3190(the)S +3364(image)S +3672(will)S +3884(automatically)S +4522(be)S +4664(converted)S +5134(to)S +5206 V +900(8-bit)S +1154(values)S +1480(using)S +1765(the)S +1945(zscale)S +2257(mapping)S +2688(algorithm.)S +3223(The)S +3439(function)S +3851(returns)S +4201(a)S +4295(positive)S +4690(value)S +4973(if)S +5086(the)S +5326 V +900(image)S +1201(cannot)S +1526(be)S +1662(accessed)S +2076(or)S +2200(displayed)S +2654(for)S +2814(any)S +3005(reason,)S +3351(an)S +3487(error)S +3731(message)S +4135(will)S +4340(be)S +4476(printed.)S +5482 V +1175(The)S +11 I +1393(cdl_isIRAF\(\))S +11 R +2013(procedure)S +2497(returns)S +2849(a)S +2946(positive)S +3344(value)S +3630(if)S +3746(the)S +3929(\256lename)S +4356(argument)S +4819(is)S +4942(recog-)S +5602 V +900(nized)S +1177(as)S +1308(an)S +1451(IRAF)S +1742(image,)S +2078(it)S +2180(does)S +2421(not)S +2602(check)S +2896(whether)S +3288(the)S +3462(pixel)S +3722(\256le)S +3903(can)S +4094(be)S +4236(successfully)S +4811(accessed.)S +5722 V +900(For)S +1086(simply)S +1420(reading)S +1781(the)S +1948(pixels)S +2244(from)S +2490(an)S +2626(IRAF)S +2910(image)S +3211(the)S +11 B +3378(cdl_readIRAF\(\))S +11 R +4161(procedure)S +4631(may)S +4854(be)S +4991(used.)S +5842 V +900(The)S +1114(function)S +1524(returns)S +1872(a)S +1964(zero)S +2195(value)S +2475(and)S +2676(sets)S +2884(the)S +3061(output)S +3386(pixel)S +3649(array,)S +3943(image)S +4254(dimensions)S +4799(and)S +5000(pixel)S +5962 V +900(size)S +1117(if)S +1231(successful,)S +1756(otherwise)S +2229(the)S +2410(function)S +2823(returns)S +3175(a)S +3271(positive)S +3668(value.)S +4014(Note)S +4275(that)S +4488(the)S +4670(output)S +5000(pixel)S +6082 V +900(values)S +1213(may)S +1435(need)S +1674(to)S +1793(be)S +1929(scaled)S +2235(before)S +2546(they)S +2768(can)S +2952(be)S +3088(displayed.)S +6322 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +6442 V +11 C +1175(int)S +1439(cdl_displayIRAF)S +2495(\(CDLPtr)S +3023(cdl,)S +3353(char)S +3683(*fname,)S +4211(int)S +4475(band,)S +6562 V +1439(int)S +1703(frame,)S +2165(int)S +2429(fbconfig,)S +3089(int)S +3353(zscale\))S +6682 V +1175(int)S +1439(cdl_isIRAF)S +2165(\(char)S +2561(*fname\))S +6802 V +1175(int)S +1439(cdl_readIRAF)S +2297(\(char)S +2693(*fname,)S +3221(int)S +3485(band,)S +3881(uchar)S +4277(**pix,)S +6922 V +1439(int)S +1703(*nx,)S +2033(int)S +2297(*ny,)S +2627(int)S +2891(*bitpix,)S +3485(char)S +3815(*title\))S +7920 V +EP +%%Page: 5 8 +BP +/slant 0 def +/height 1.000000 def +11 C +11 C +480 V +11 R +2963(- 5 -)S +840 V +11 B +900(4.3.)S +1132(Displaying)S +1669(FITS)S +1948(Images)S +996 V +11 R +1175(The)S +11 B +1385(cdl_displayFITS\(\))S +11 R +2278(procedure)S +2754(can)S +2945(be)S +3088(used)S +3329(to)S +3455(display)S +3813(a)S +11 I +3901(simple)S +11 R +4228(FITS)S +4495(image)S +4804(by)S +4955(name.)S +1116 V +900(A)S +1016("simple")S +1437(FITS)S +1701(\256le)S +1879(is)S +1990(assumed)S +2405(to)S +2528(be)S +2668(one)S +2863(containing)S +3364(a)S +3449(single)S +3749(image)S +4053(and)S +4247(having)S +4582(no)S +4728(extensions.)S +1236 V +900(Other)S +1183(types)S +1449(of)S +1574(FITS)S +1835(\256les)S +2053(may)S +2276(of)S +2401(course)S +2720(be)S +2857(displayed)S +3312(but)S +3487(the)S +3655(client)S +3933(will)S +4139(have)S +4379(to)S +4499(use)S +4680(other)S +4940(means)S +1356 V +900(to)S +1026(import)S +1360(the)S +1534(pixels.)S +1898(FITS)S +2164(image)S +2471(extensions)S +2974(may)S +3202(be)S +3344(supported)S +3816(in)S +3941(a)S +4028(future)S +4328(release)S +4669(of)S +4799(the)S +4972(CDL.)S +1476 V +900(The)S +11 I +1110(frame)S +11 R +1406(and)S +11 I +1605(fbcon\256g)S +11 R +2000(arguments)S +2498(select)S +2788(the)S +2963(frame)S +3258(and)S +3457(frame)S +3752(bu)S +3862 H + (f)show 11 -.5 mul h (f)show +11 R +3929(er)S +4054(size)S +4265(respectively,)S +4863(the)S +5038(spe-)S +1596 V +900(cial)S +1103(symbolic)S +1552(value)S +11 B +1834(FB_AUTO)S +11 R +2393(may)S +2627(be)S +2775(used)S +3021(for)S +3192(the)S +11 I +3370(fbcon\256g)S +11 R +3768(argument)S +4226(to)S +4356(have)S +4606(the)S +4784(procedure)S +1716 V +900(automatically)S +1540(select)S +1831(the)S +2007(frame)S +2303(bu)S +2413 H + (f)show 11 -.5 mul h (f)show +11 R +2480(er)S +2606(most)S +2863(appropriate)S +3403(for)S +3573(the)S +3750(image)S +4061(size.)S +4335(If)S +4450(the)S +11 I +4627(zscale)S +11 R +4938(\257ag)S +5146(is)S +1836 V +900(greater)S +1236(than)S +1459(zero)S +1680(the)S +1847(image)S +2148(will)S +2353(automatically)S +2984(be)S +3120(converted)S +3584(to)S +3703(8-bit)S +3944(values)S +4257(using)S +4529(the)S +4696(zscale)S +4995(map-)S +1956 V +900(ping)S +1154(algorithm.)S +1702(The)S +1931(function)S +2356(returns)S +2719(a)S +2826(positive)S +3234(value)S +3530(if)S +3656(the)S +3849(image)S +4176(cannot)S +4527(be)S +4689(accessed)S +5129(or)S +2076 V +900(displayed)S +1354(for)S +1514(any)S +1705(reason,)S +2051(an)S +2187(error)S +2431(message)S +2835(will)S +3040(be)S +3176(printed.)S +2232 V +1175(The)S +11 I +1378(cdl_isFITS\(\))S +11 R +1966(procedure)S +2435(returns)S +2772(a)S +2853(positive)S +3235(value)S +3505(if)S +3605(the)S +3773(\256lename)S +4185(argument)S +4633(is)S +4741(recognized)S +2352 V +900(as)S +1037(a)S +1131(simple)S +1470(FITS)S +1742(image.)S +2116(For)S +2314(simply)S +2660(reading)S +3033(the)S +3212(image)S +3525(pixels)S +3833(the)S +11 B +4012(cdl_readFITS\(\))S +11 R +4784(procedure)S +2472 V +900(may)S +1123(be)S +1260(used.)S +1556(The)S +1760(output)S +2076(pixel)S +2330(array,)S +2615(image)S +2917(dimensions)S +3453(and)S +3645(pixel)S +3899(size)S +4103(are)S +4269(returned)S +4668(if)S +4770(successful)S +2592 V +900(otherwise)S +1362(the)S +1532(function)S +1934(returns)S +2274(a)S +2358(positive)S +2743(value.)S +3077(Note)S +3326(that)S +3527(the)S +3697(returned)S +4097(pixel)S +4353(values)S +4669(may)S +4893(need)S +5134(to)S +2712 V +900(be)S +1036(scaled)S +1342(before)S +1653(they)S +1875(can)S +2059(be)S +2195(displayed.)S +2952 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +3072 V +11 C +1175(int)S +1439(cdl_displayFITS)S +2495(\(CDLPtr)S +3023(cdl,)S +3353(char)S +3683(*fname,)S +4211(int)S +4475(frame,)S +3192 V +1439(int)S +1703(fbconfig,)S +2363(int)S +2627(zscale\))S +3312 V +1175(int)S +1439(cdl_isFITS)S +2165(\(char)S +2561(*fname\))S +3432 V +1175(int)S +1439(cdl_readFITS)S +2297(\(char)S +2693(*fname,)S +3221(uchar)S +3617(**pix,)S +4079(int)S +4343(*nx,)S +4673(int)S +4937(*ny,)S +3552 V +1439(int)S +1703(*bitpix,)S +2297(char)S +2627(*title\))S +3792 V +11 B +900(4.4.)S +1132(Displaying)S +1669(Raw)S +1915(Pixels)S +3948 V +11 R +1175(The)S +11 B +1381(cdl_displayPix\(\))S +11 R +2177(procedure)S +2649(can)S +2837(be)S +2977(used)S +3215(to)S +3338(display)S +3693(an)S +3833(arbitrary)S +4246(array)S +4506(of)S +4634(pixels)S +4934(of)S +5062(any)S +4068 V +900(size.)S +1166(The)S +11 I +1371(nx)S +11 R +1509(and)S +11 I +1701(ny)S +11 R +1838(arguments)S +2329(are)S +2495(the)S +2663(raster)S +2939(dimensions,)S +3503(and)S +11 I +3695(bitpix)S +11 R +3980(is)S +4088(the)S +4256(pixel)S +4510(size)S +4714(and)S +4906(has)S +5086(the)S +4188 V +900(same)S +1178(meaning)S +1609(as)S +1753(the)S +1940(FITS)S +2220(BITPIX)S +2627(keyword.)S +3124(The)S +11 I +3347(frame)S +11 R +3656(and)S +11 I +3867(fbcon\256g)S +11 R +4274(arguments)S +4784(select)S +5086(the)S +4308 V +900(frame)S +1199(and)S +1402(frame)S +1701(bu)S +1811 H + (f)show 11 -.5 mul h (f)show +11 R +1878(er)S +2007(size)S +2222(respectively,)S +2824(the)S +3003(special)S +3352(symbolic)S +3800(value)S +11 B +4081(FB_AUTO)S +11 R +4639(may)S +4872(be)S +5019(used)S +4428 V +900(for)S +1082(the)S +11 I +1271(fbcon\256g)S +11 R +1680(argument)S +2149(to)S +2290(have)S +2551(the)S +2740(procedure)S +3231(automatically)S +3884(select)S +4188(the)S +4378(frame)S +4688(bu)S +4798 H + (f)show 11 -.5 mul h (f)show +11 R +4865(er)S +5005(most)S +4548 V +900(appropriate)S +1441(for)S +1611(the)S +1788(image)S +2099(size.)S +2372(If)S +2486(the)S +11 I +2662(zscale)S +11 R +2972(\257ag)S +3179(is)S +3295(greater)S +3639(than)S +3870(zero)S +4099(the)S +4275(image)S +4585(will)S +4799(automati-)S +4668 V +900(cally)S +1146(be)S +1282(converted)S +1746(to)S +1865(8-bit)S +2106(values)S +2419(using)S +2691(the)S +2858(zscale)S +3157(mapping)S +3575(algorithm.)S +4908 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +5028 V +11 C +1175(int)S +1439(cdl_displayPix)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(uchar)S +3683(*pix,)S +4079(int)S +4343(nx,)S +4607(int)S +4871(ny,)S +5148 V +1439(int)S +1703(bitpix,)S +2231(int)S +2495(frame,)S +2957(int)S +3221(fbconfig,)S +3881(int)S +4145(zscale\))S +5388 V +11 B +900(4.5.)S +1132(Frame)S +1474(Selection)S +5544 V +11 R +1175(Frame)S +1495(selection)S +1925(is)S +2039(normally)S +2476(done)S +2729(as)S +2860(an)S +3003(argument)S +3457(to)S +3583(one)S +3781(of)S +3913(the)S +4088(display)S +4447(procedures,)S +4995(how-)S +5664 V +900(ever)S +1127(frames)S +1464(may)S +1693(be)S +1836(explicitly)S +2292(selected)S +2684(using)S +2963(the)S +11 B +3136(cdl_setFrame\(\))S +11 R +3879(procedure.)S +4415(This)S +4650(allows)S +4976(client)S +5784 V +900(programs)S +1361(to)S +1494(essentially)S +2005("blink")S +2370(frames)S +2715(independently,)S +3413(as)S +3552(long)S +3796(as)S +3935(the)S +4117(server)S +4431(supports)S +4852(multiple)S +5904 V +900(frames.)S +1291(The)S +11 B +1494(cdl_getFrame\(\))S +11 R +2243(procedure)S +2712(may)S +2934(be)S +3070(used)S +3304(to)S +3423(get)S +3590(the)S +3757(current)S +4099(frame)S +4386(set)S +4541(in)S +4660(the)S +4827(server.)S +6144 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +6264 V +11 C +1175(void)S +1505(cdl_setFrame)S +2363(\(CDLPtr)S +2891(cdl,)S +3221(int)S +3485(frame\))S +6384 V +1175(void)S +1505(cdl_getFrame)S +2363(\(CDLPtr)S +2891(cdl,)S +3221(int)S +3485(*frame\))S +6624 V +11 B +900(4.6.)S +1132(Clearing)S +1574(the)S +1753(Display)S +6780 V +11 R +1175(The)S +1400(current)S +1764(display)S +2137(frame)S +2446(may)S +2690(be)S +2848(explicitly)S +3320(cleared)S +3690(using)S +3985(the)S +11 B +4175(cdl_clearFrame\(\))S +11 R +5038(pro-)S +6900 V +900(cedure.)S +1329(The)S +1577(frame)S +1909(is)S +2061(also)S +2316(cleared)S +2707(prior)S +2997(to)S +3160(displaying)S +3696(new)S +3955(images)S +4343(by)S +4530(the)S +4741(procedures)S +7020 V +11 B +900(cdl_displayPix\(\))S +11 R +1660(,)S +11 B +1721(cdl_displayFITS\(\))S +11 R +2574(,)S +2635(and)S +11 B +2826(cdl_displayIRAF\(\))S +11 R +3701(.)S +7260 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +7920 V +EP +%%Page: 6 9 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2963(- 6 -)S +840 V +11 C +1175(int)S +1439(cdl_clearFrame)S +2429(\(CDLPtr)S +2957(cdl\))S +1080 V +11 B +900(4.7.)S +1132(Frame)S +1474(Bu)S +1610 H + (f)show 11 -.5 mul h (f)show +11 B +1677(er)S +1806(Selection)S +1236 V +11 R +1175(The)S +1415(default)S +1789(frame)S +2113(bu)S +2223 H + (f)show 11 -.5 mul h (f)show +11 R +2290(er)S +2444(used)S +2715(is)S +2859(512x512,)S +3342(other)S +3637(sizes)S +3920(may)S +4179(be)S +4353(selected)S +4776(using)S +5086(the)S +1356 V +11 B +900(cdl_setFBCon\256g\(\))S +11 R +1796(procedure.)S +2340(To)S +2509(set)S +2678(the)S +2859(frame)S +3160(bu)S +3270 H + (f)show 11 -.5 mul h (f)show +11 R +3337(er)S +3467(size)S +3683(the)S +3863(client)S +4153(passes)S +4479(the)S +4659(frame)S +4959(bu)S +5069 H + (f)show 11 -.5 mul h (f)show +11 R +5136(er)S +1476 V +900(number)S +1284(as)S +1424(de\256ned)S +1796(in)S +1931(the)S +2114(frame)S +2417(bu)S +2527 H + (f)show 11 -.5 mul h (f)show +11 R +2594(er)S +2727(con\256guration)S +3362(\256le)S +3552(\(see)S +3776(below\))S +4130(while)S +4424(setting)S +4768(the)S +4952(image)S +1596 V +900(WCS.)S +1243(It)S +1353(is)S +1470(important)S +1941(to)S +2069(note)S +2300(that)S +2507(the)S +2683(frame)S +2979(bu)S +3089 H + (f)show 11 -.5 mul h (f)show +11 R +3156(er)S +3282(isn't)S +3520(actually)S +3909(changed)S +4315(in)S +4443(the)S +4619(server)S +4927(until)S +5172(a)S +1716 V +900(subsequent)S +11 B +1431(cdl_setWCS\(\))S +11 R +2120(call,)S +2349(either)S +2641(directly)S +3019(or)S +3154(through)S +3540(some)S +3816(other)S +4085(procedure)S +4565(which)S +4877(sets)S +5086(the)S +1836 V +900(WCS)S +1172(\(e.g.)S +1400(one)S +1591(of)S +1715(the)S +1882(display)S +2233(procedures\).)S +1992 V +1175(To)S +1384(get)S +1605(the)S +1827(size)S +2085(of)S +2264(the)S +2486(currently)S +2969(de\256ned)S +3380(frame)S +3722(bu)S +3832 H + (f)show 11 -.5 mul h (f)show +11 R +3899(er)S +4071(the)S +4293(user)S +4563(may)S +4840(call)S +5086(the)S +2112 V +11 B +900(cdl_getFBCon\256g\(\))S +11 R +1803(procedure.)S +2342(This)S +2580(returns)S +2926(not)S +3109(only)S +3347(the)S +3523(current)S +3873(con\256guration)S +4500(number,)S +4904(but)S +5086(the)S +2232 V +900(size)S +1121(as)S +1263(well.)S +1564(To)S +1737(get)S +1922(the)S +2107(size)S +2328(and)S +2537(any)S +2746(arbitrary)S +3173(con\256guration)S +3810(without)S +4199(actually)S +4598(setting)S +4944(it,)S +5086(the)S +2352 V +11 B +900(cdl_lookupFBSize\(\))S +11 R +1880(procedure)S +2371(may)S +2615(be)S +2773(used.)S +3090(Any)S +3333(con\256guration)S +3973(not)S +4168(actually)S +4569(de\256ned)S +4946(in)S +5086(the)S +2472 V +900(frame)S +1187(bu)S +1297 H + (f)show 11 -.5 mul h (f)show +11 R +1364(er)S +1481(con\256guration)S +2100(\256le)S +2274(is)S +2381(returned)S +2778(as)S +2902(the)S +3069(default)S +3406(512x512)S +3824(size.)S +2712 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +2832 V +11 C +1175(void)S +1505(cdl_setFBConfig)S +2561(\(CDLPtr)S +3089(cdl,)S +3419(int)S +3683(configno\))S +2952 V +1175(void)S +1505(cdl_getFBConfig)S +2561(\(CDLPtr)S +3089(cdl,)S +3419(int)S +3683(*configno,)S +4409(int)S +4673(*width,)S +3072 V +1439(int)S +1703(*height,)S +2297(int)S +2561(*nframes\))S +3192 V +1175(void)S +1505(cdl_lookupFBSize)S +2627(\(CDLPtr)S +3155(cdl,)S +3485(int)S +3749(configno,)S +4409(int)S +4673(*width,)S +3312 V +1439(int)S +1703(*height,)S +2297(int)S +2561(*nframes\))S +3552 V +11 B +900(4.7.1.)S +1215(Automatic)S +1741(Selection)S +3708 V +11 R +1175(The)S +11 B +1383(cdl_selectFB\(\))S +11 R +2084(procedure)S +2558(may)S +2785(be)S +2926(used)S +3165(to)S +3289(select)S +3577(the)S +3750(most)S +4004(appropriate)S +4541(frame)S +4834(bu)S +4944 H + (f)show 11 -.5 mul h (f)show +11 R +5011(er)S +5134(to)S +3828 V +900(use)S +1085(for)S +1251(a)S +1338(given)S +1621(image)S +1928(size.)S +2198(If)S +2309(possible)S +2709(a)S +2796(frame)S +3089(bu)S +3199 H + (f)show 11 -.5 mul h (f)show +11 R +3266(er)S +3389(the)S +3562(same)S +3825(size)S +4033(as)S +4162(the)S +4334(image)S +4640(will)S +4850(be)S +4991(used,)S +3948 V +900(otherwise)S +1364(one)S +1560(that)S +1763(is)S +1875(larger)S +2167(will)S +2377(be)S +2518(chosen.)S +2922(Rather)S +3253(than)S +3481(simply)S +3821(selecting)S +4250(the)S +4423(\256rst)S +4634(con\256guration)S +4068 V +900(larger)S +1192(than)S +1419(the)S +1590(image,)S +1923(the)S +2094(procedure)S +2567(searches)S +2973(the)S +3144(entire)S +3430(con\256guration)S +4053(\256le)S +4231(selecting)S +4658(the)S +4829(one)S +5024(with)S +4188 V +900(the)S +1067(least)S +1302(empty)S +1611(space)S +1887(in)S +2007(both)S +2237(dimensions.)S +2834(If)S +2940(the)S +11 I +3108(reset)S +11 R +3355(\257ag)S +3554(is)S +3662(non-zero)S +4084(this)S +4278(frame)S +4566(is)S +4674(set)S +4830(automat-)S +4308 V +900(ically)S +1184(by)S +1334(the)S +1508(procedure,)S +2012(otherwise)S +2478(the)S +2652(selected)S +3044(dimension)S +3543(is)S +3657(simply)S +3998(returned)S +4402(to)S +4527(the)S +4700(calling)S +5038(pro-)S +4428 V +900(gram.)S +1227(In)S +1359(either)S +1649(case)S +1877(the)S +2052(new)S +2275(frame)S +2570(bu)S +2680 H + (f)show 11 -.5 mul h (f)show +11 R +2747(er)S +2872(will)S +3085(not)S +3267(take)S +3490(e)S +3538 H + (f)show 11 -.5 mul h (f)show +11 R +3605(ect)S +3773(until)S +4017(a)S +4107(new)S +4331(WCS)S +4612(is)S +4728(de\256ned)S +5093(for)S +4548 V +900(the)S +1067(frame.)S +4788 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +4908 V +11 C +1175(void)S +1505(cdl_selectFB)S +2363(\(CDLPtr)S +2891(cdl,)S +3221(int)S +3485(nx,)S +3749(int)S +4013(ny,)S +4277(int)S +4541(*fb,)S +5028 V +1450(int)S +1714(*w,)S +1978(int)S +2242(*h,)S +2506(int)S +2770(*nf,)S +3100(int)S +3364(reset\))S +5268 V +11 B +900(4.7.2.)S +1215(The)S +1432(Frame)S +1774(Bu)S +1910 H + (f)show 11 -.5 mul h (f)show +11 B +1977(er)S +2106(Con\256guration)S +2801(File)S +5424 V +11 R +1175(The)S +1378(size)S +1581(of)S +1705(the)S +1872(frame)S +2160(bu)S +2270 H + (f)show 11 -.5 mul h (f)show +11 R +2337(er)S +2455(is)S +2563(not)S +2738(passed)S +3064(directly)S +3433(to)S +3553(the)S +3721(server)S +4021(since)S +4280(this)S +4474(is)S +4582(not)S +4757(part)S +4961(of)S +5086(the)S +5544 V +900(communications)S +1675(protocol)S +2089(used.)S +2399(Instead,)S +2790(the)S +2971(frame)S +3272(bu)S +3382 H + (f)show 11 -.5 mul h (f)show +11 R +3449(er)S +3580(number)S +3962(is)S +4083(sent)S +4307(as)S +4445(part)S +4662(of)S +4800(the)S +4981(WCS)S +5664 V +900(header)S +1247(packet.)S +1650(So)S +1824(that)S +2046(both)S +2299(the)S +2490(server)S +2813(and)S +3028(client)S +3330(can)S +3539(know)S +3841(that)S +4064(a)S +4170(particular)S +4647(frame)S +4959(bu)S +5069 H + (f)show 11 -.5 mul h (f)show +11 R +5136(er)S +5784 V +900(number)S +1277(corresponds)S +1848(to)S +1976(a)S +2066(speci\256c)S +2443(size,)S +2683(a)S +11 I +2773(frame)S +3071(bu)S +3181 H + (f)show 11 -.5 mul h (f)show +11 I +3237(er)S +3370(con\256guration)S +4005(\256le)S +11 R +4181(is)S +4297(used)S +4540(which)S +4849(both)S +5086(the)S +5904 V +900(client)S +1177(and)S +1368(server)S +1667(read.)S +6060 V +1175(The)S +1383(default)S +1725(con\256guration)S +2349(\256le)S +2528(is)S +2640(/usr/local/lib/imtoolrc,)S +3667(this)S +3865(can)S +4055(be)S +4197(overridden)S +4710(by)S +4859(de\256ning)S +6180 V +900(an)S +11 B +1038(IMTOOLRC)S +11 R +1697(environment)S +2287(variable)S +2674(naming)S +3039(the)S +3208(\256le)S +3384(to)S +3505(be)S +3643(used,)S +3907(or)S +4032(by)S +4176(creating)S +4562(a)S +4644(.imtoolrc)S +5079(\256le)S +6300 V +900(in)S +1022(your)S +1259(home)S +1539(directory.)S +2031(Since)S +2311(the)S +2481(server)S +2783(must)S +3034(also)S +3247(read)S +3470(the)S +3640(same)S +3901(\256le,)S +4106(this)S +4302(must)S +4553(be)S +4692(done)S +4942(before)S +6420 V +900(starting)S +1263(both)S +1492(the)S +1659(client)S +1936(and)S +2127(server)S +2426(applications.)S +6576 V +900(The)S +1103(format)S +1428(of)S +1552(the)S +1719(frame)S +2006(bu)S +2116 H + (f)show 11 -.5 mul h (f)show +11 R +2183(er)S +2300(con\256guration)S +2919(\256le)S +3093(is)S +6756 V +11 I +1175(con\256gno)S +1586(nframes)S +1973(width)S +2252(height)S +2560([extra)S +2861(\256elds])S +6936 V +11 R +900(e.g.)S +7116 V +1230(1)S +1351(2)S +1472(512)S +1703(512)S +7236 V +1230(2)S +1351(2)S +1472(800)S +1703(800)S +7920 V +EP +%%Page: 7 10 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2963(- 7 -)S +840 V +1230(3)S +1351(1)S +1439(1024)S +1692(1024)S +2242(#)S +2330(comment)S +960 V +1230(:)S +1327(:)S +1457(:)S +1620(:)S +1200 V +900(At)S +1050(most)S +1305(128)S +1510(frame)S +1804(bu)S +1914 H + (f)show 11 -.5 mul h (f)show +11 R +1981(er)S +2105(sizes)S +2358(may)S +2587(be)S +2730(de\256ned,)S +3121(each)S +3360(con\256guration)S +3986(may)S +4215(de\256ne)S +4523(up)S +4673(to)S +4799(4)S +4895(frames,)S +1320 V +900(con\256guration)S +1519(numbers)S +1930(need)S +2169(not)S +2343(be)S +2479(sequential)S +2957(but)S +3131(should)S +3458(be)S +3594(in)S +3713(ascending)S +4184(order.)S +1560 V +11 B +900(4.8.)S +1132(Image)S +1457(WCS)S +1741(Description)S +1716 V +11 R +1175(The)S +1380(image)S +1683(WCS)S +1957(is)S +2066(de\256ned)S +2424(using)S +2698(the)S +11 B +2868(cdl_setWCS\(\))S +11 R +3550(procedure.)S +4083(The)S +4289(WCS)S +4564(de\256nes)S +4911(a)S +4995(map-)S +1836 V +900(ping)S +1137(between)S +1542(any)S +1741(linear)S +2031(coordinate)S +2534(system)S +2881(and)S +3080(the)S +3254(image)S +3562(pixels,)S +3893(for)S +4060(our)S +4246(purposes)S +4676(we)S +4843(will)S +5055(dis-)S +1956 V +900(cuss)S +1126(how)S +1352(the)S +1523(WCS)S +1799(is)S +1910(used)S +2148(to)S +2271(map)S +2497(the)S +2668(frame)S +2959(bu)S +3069 H + (f)show 11 -.5 mul h (f)show +11 R +3136(er)S +3257(pixels)S +3557(to)S +3680(image)S +3985(coordinates.)S +4588(It)S +4692(is)S +4804(passed)S +5134(to)S +2076 V +900(the)S +1067(server)S +1366(in)S +1485(a)S +1566(string)S +1850(of)S +1974(the)S +2141(form:)S +2256 V +11 I +1428(name)S +11 R +1698(-)S +11 I +1767(title)S +11 R +1939(\\n)S +2376 V +1450(a)S +1531(b)S +1619(c)S +1700(d)S +1788(tx)S +1907(ty)S +2026(z1)S +2162(z2)S +2298(zt)S +2520 V +900(where:)S +2664 V +11 B +1362(X)S +11 R +1441(')S +1510(=)S +1605(a)S +1686(*)S +11 B +1774(X)S +11 R +1886(+)S +1981(c)S +2062(*)S +11 B +2150(Y)S +11 R +2262(+)S +2357(tx)S +2784 V +11 B +1362(Y)S +11 R +1441(')S +1510(=)S +1605(b)S +1693(*)S +11 B +1781(X)S +11 R +1893(+)S +1988(d)S +2076(*)S +11 B +2164(Y)S +11 R +2276(+)S +2371(ty)S +3024 V +900(The)S +1111(terms)S +11 I +1396(a,)S +1520(b,)S +1644(c)S +11 R +1692(,)S +1761(and)S +11 I +1960(d)S +11 R +2056(de\256ne)S +2366(a)S +2456(rotation)S +2840(of)S +2973(the)S +3149(WCS)S +3430(wrt)S +3618(the)S +3794(pixel)S +4056(\(i.e.)S +4269(frame)S +4565(bu)S +4675 H + (f)show 11 -.5 mul h (f)show +11 R +4742(er\))S +4904(coordi-)S +3144 V +900(nates,)S +1195(the)S +11 I +1371(tx)S +11 R +1492(and)S +11 I +1692(ty)S +11 R +1813(values)S +2135(are)S +2309(translation)S +2815(terms)S +3101(relative)S +3471(to)S +3599(the)S +3775(upper-left)S +4248(corner)S +4567(of)S +4699(the)S +4874(display.)S +3264 V +900(The)S +1134(remaining)S +1643(three)S +1925(values)S +2269(de\256ne)S +2601(the)S +2799(intensity)S +3243(mapping)S +3692(of)S +3847(the)S +4045(display)S +4427(pixels;)S +11 I +4785(z1)S +11 R +4947(is)S +5086(the)S +3384 V +900(minimum)S +1373(pixel)S +1636(value)S +1916(used)S +2160(in)S +2289(the)S +2466(transformation,)S +11 I +3183(z2)S +11 R +3324(is)S +3441(the)S +3618(maximum)S +4108(value,)S +4416(and)S +11 I +4617(zt)S +11 R +4733(de\256nes)S +5086(the)S +3504 V +900(type)S +1122(of)S +1246(transformation)S +1925(used)S +2159(\(0)S +2283(for)S +2443(none,)S +2717(1)S +2805(for)S +2965(linear,)S +3275(2)S +3363(for)S +3523(log10\).)S +3660 V +1175(The)S +1391(WCS)S +1676(may)S +1911(be)S +2060(set)S +2228(explicitly)S +2690(by)S +2846(the)S +3026(calling)S +3371(program)S +3788(or)S +3925(a)S +4019(default)S +4369(appropriate)S +4913(for)S +5086(the)S +3780 V +900(image)S +1209(will)S +1422(be)S +1566(set)S +1729(automatically)S +2368(by)S +2519(the)S +2694(high-level)S +3180(display)S +3539(procedures,)S +4086(otherwise)S +4552(a)S +4640(WCS)S +4919(for)S +5086(the)S +3900 V +900(frame)S +1200(bu)S +1310 H + (f)show 11 -.5 mul h (f)show +11 R +1377(er)S +1507(is)S +1627(de\256ned)S +1996(\(i.e.)S +2213(returned)S +2623(coordinates)S +3174(are)S +3352(frame)S +3652(bu)S +3762 H + (f)show 11 -.5 mul h (f)show +11 R +3829(er)S +3959(coords\).)S +4394(As)S +4562(an)S +4711(example)S +5129(of)S +4020 V +900(how)S +1134(the)S +1313(WCS)S +1597(is)S +1716(de\256ned,)S +2112(the)S +2291(default)S +2640(WCS)S +2924(for)S +3096(an)S +3244(image)S +11 I +3557(IMX)S +11 R +3796(x)S +11 I +3896(IMY)S +11 R +4130(pixels)S +4438(in)S +4569(a)S +4661(frame)S +4959(bu)S +5069 H + (f)show 11 -.5 mul h (f)show +11 R +5136(er)S +4140 V +11 I +900(FBX)S +11 R +1134(x)S +11 I +1222(FBY)S +11 R +1451(pixels)S +1747(is)S +1854(de\256ned)S +2210(as)S +4320 V +11 C +1428(a)S +1626(=)S +1824(1.0;)S +3738(/*)S +3936(no)S +4134(rotation)S +4728(*/)S +4440 V +1428(b)S +1626(=)S +1824(0.0;)S +4560 V +1428(c)S +1626(=)S +1824(0.0;)S +4680 V +1428(d)S +1626(=)S +1758(-1.0;)S +4800 V +1428(tx)S +1626(=)S +1758(\()S +11 I +1824(IMX)S +11 C +2084(/)S +2216(2\))S +2414(-)S +2546(\()S +11 I +2612(FBX)S +11 C +2879(/)S +3011(2\))S +3209(+)S +3341(1;)S +3737(/*)S +3935(center)S +4397(in)S +4595(FB)S +4793(*/)S +4920 V +1428(ty)S +1626(=)S +1758(\()S +11 I +1824(FBY)S +11 C +2086(/)S +2218(2\))S +2416(+)S +2548(\()S +11 I +2614(IMY)S +11 C +2869(/)S +3001(2\);)S +5040 V +1428(z1)S +1626(=)S +1758(z1;)S +3738(/*)S +3936(zscale)S +4398(values)S +4860(*/)S +5160 V +1428(z2)S +1626(=)S +1758(z2;)S +5280 V +1428(zt)S +1626(=)S +1758(1;)S +5520 V +11 R +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +5640 V +11 C +1175(int)S +1439(cdl_setWCS)S +2165(\(CDLPtr)S +2693(cdl,)S +3023(char)S +3353(*name,)S +3815(char)S +4145(*title,)S +5760 V +1439(float)S +1835(a,)S +2033(float)S +2429(b,)S +2627(float)S +3023(c,)S +3221(float)S +3617(d,)S +3815(float)S +4211(tx,)S +4475(float)S +4871(ty,)S +5880 V +1439(float)S +1835(z1,)S +2099(float)S +2495(z2,)S +2759(int)S +3023(zt\))S +6000 V +1175(int)S +1439(cdl_getWCS)S +2165(\(CDLPtr)S +2693(cdl,)S +3023(char)S +3353(*name,)S +3815(char)S +4145(*title,)S +6120 V +1439(float)S +1835(*a,)S +2099(float)S +2495(*b,)S +2759(float)S +3155(*c,)S +3419(float)S +3815(*d,)S +4079(float)S +4475(*tx,)S +4805(float)S +5201(*ty,)S +6240 V +1439(float)S +1835(*z1,)S +2165(float)S +2561(*z2,)S +2891(int)S +3155(*zt\))S +6480 V +11 B +900(4.8.1.)S +1215(Image)S +1540(Mappings)S +6636 V +11 R +1175(Beginning)S +1668(with)S +11 B +1898(X11IRAF)S +2389(V1.3)S +11 R +2640(the)S +11 I +2808(XImtool)S +11 R +3196(display)S +3549(server)S +3850(has)S +4031(had)S +4224(the)S +4393(ability)S +4710(to)S +4831(use)S +5012(mul-)S +6756 V +900(tiple)S +1135(world)S +1430(coordinate)S +1931(systems)S +2319(in)S +2444(a)S +2531(frame)S +2824(\(e.g.)S +3058(subrasters)S +3535(of)S +3664(a)S +3750(mosaic)S +4099(display\).)S +4552(To)S +4712(do)S +4860(this,)S +5086(the)S +6876 V +11 B +900(IRAF)S +11 R +1214(and)S +11 B +1418(CDL)S +11 R +1696(display)S +2060(interfaces)S +2530(were)S +2787(modi\256ed)S +3225(to)S +3357(pass)S +3593(in)S +3726(extra)S +3991(information)S +4557(with)S +4800(the)S +4981(WCS)S +6996 V +900(string)S +1188(to)S +1311(de\256ne)S +1616(the)S +1787(mapping)S +2209(of)S +2337(the)S +2508(image)S +2813(pixels)S +3112(to)S +3234(the)S +3404(frame)S +3694(bu)S +3804 H + (f)show 11 -.5 mul h (f)show +11 R +3871(er)S +3991(pixels.)S +4351(This)S +4583(extra)S +4837(informa-)S +7116 V +900(tion)S +1119(allows)S +1453(the)S +1634(XImtool)S +2055(to)S +2189(know)S +2481(when)S +2766(the)S +2948(cursor)S +3269(in)S +3403(within)S +3733(one)S +3939(of)S +4078(the)S +4260(image)S +4576(subrasters)S +5062(and)S +7236 V +900(compute)S +1321(coordinates)S +1869(appropriately.)S +2557(\(See)S +2794(the)S +11 I +2971(XImtool)S +11 R +3368(documentation)S +4063(for)S +4232(details)S +4561(on)S +4713(how)S +4944(this)S +5146(is)S +7920 V +EP +%%Page: 8 11 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2963(- 8 -)S +840 V +900(done)S +1146(exactly\).)S +996 V +1175(The)S +1391(CDL)S +1657(will)S +1875(automatically)S +2519(determine)S +3003(when)S +3286(the)S +3466(connection)S +3993(is)S +4114(\256rst)S +4333(established)S +4868(whether)S +1116 V +900(the)S +1068(server)S +1368(is)S +1476(aware)S +1768(of)S +1892(this)S +2085(new)S +2300(mapping)S +2718(information.)S +3331(Calls)S +3591(to)S +3710(send)S +3944(or)S +4068(receive)S +4415(mapping)S +4833(data)S +5048(will)S +1236 V +900(be)S +1036(ignored)S +1404(for)S +1564(servers)S +1906(which)S +2208(are)S +2374(not)S +2549(aware)S +2842(of)S +2967(the)S +3135(extra)S +3387(data)S +3603(in)S +3723(the)S +3891(string.)S +4237(For)S +4424(servers)S +4767(which)S +5069(can)S +1356 V +900(use)S +1079(the)S +1246(mappings,)S +1735(and)S +1926(where)S +2225(a)S +2306(mapping)S +2724(has)S +2903(been)S +3142(provided,)S +3626(the)S +3793(WCS)S +4065(string)S +4349(now)S +4571(looks)S +4843(like)S +1536 V +11 I +1428(name)S +11 R +1698(-)S +11 I +1767(title)S +11 R +1939(\\n)S +1656 V +1450(a)S +1531(b)S +1619(c)S +1700(d)S +1788(tx)S +1907(ty)S +2026(z1)S +2162(z2)S +2298(zt\\n)S +1776 V +11 B +1450(region_name)S +2093(sx)S +2224(sy)S +2355(snx)S +2548(sny)S +2741(dx)S +2891(dy)S +3041(dnx)S +3253(dny\\n)S +1896 V +1450(object_refR)S +2076 V +900(where)S +1218(the)S +1397(new)S +1619(parameters)S +2186(are)S +2370(de\256ned)S +2747(to)S +2871(be:)S +2280 V +1606(region_name)S +11 I +2546(User-de\256ned)S +3144(name)S +3414(for)S +3576(the)S +3743(region.)S +2400 V +11 B +1606(sx,)S +1765(sy,)S +1924(snx,)S +2145(sny)S +11 I +2546(Source)S +2883(rect)S +3086(in)S +3205(the)S +3372(object.)S +2520 V +11 B +1606(dx,)S +1784(dy,)S +1962(dnx,)S +2202(dny)S +11 I +2546(Destination)S +3093(rect)S +3296(in)S +3415(the)S +3582(display)S +3933(frame)S +4222(bu)S +4332 H + (f)show 11 -.5 mul h (f)show +11 I +4388(er.)S +2640 V +11 B +1606(object_ref)S +11 I +2546(Full)S +2763(node!/path)S +3272(image)S +3573(speci\256cation.)S +2820 V +11 B +900(The)S +11 I +1124(object_ref)S +11 R +1609(should)S +1943(be)S +2086(a)S +2174(complete)S +2616(node!path)S +3094(speci\256cation)S +3689(to)S +3815(the)S +3989(image)S +4297(including)S +4753(any)S +4952(image)S +2940 V +900(section)S +1253(or)S +1385(extension.)S +1908(This)S +2145(is)S +2260(needed)S +2610(by)S +2761(the)S +2936(XImtool)S +3350(coordinate/pixel)S +4104(plug-in)S +4463(to)S +4590(map)S +4820(the)S +4995(same)S +3060 V +900(image)S +1206(as)S +1335(was)S +1543(displayed)S +2002(by)S +2150(the)S +2322(client.)S +2665(The)S +2873(path)S +3100(and)S +3296(node)S +3547(are)S +3717(required)S +4119(to)S +4244(ensure)S +4568(the)S +4741(image)S +5048(will)S +3180 V +900(be)S +1041(found)S +1335(properly.)S +1805(The)S +11 I +2013(region_name)S +11 R +2630(can)S +2819(be)S +2960(anything)S +3383(such)S +3621(as)S +11 I +3749(image)S +11 R +4017(,)S +11 I +4082(subraster1)S +11 R +4553(,)S +4618(or)S +11 I +4746(ccd3)S +11 R +4952(.)S +5050(The)S +3300 V +900(purpose)S +1294(of)S +1432(this)S +1639(\256eld)S +1883(is)S +2005(to)S +2139(provide)S +2522(some)S +2802(named)S +3142(value)S +3427(for)S +3602(the)S +3784(mapping)S +4217(that)S +4430(may)S +4667(be)S +4818(useful)S +5134(to)S +3420 V +900(other)S +1159(client)S +1437(programs)S +1885(needing)S +2266(to)S +2386(access)S +2698(the)S +2865(mapping.)S +11 I +3344(Source)S +11 R +3681(coordinates)S +4219(refer)S +4456(to)S +4575(the)S +4742(image)S +5043(pix-)S +3540 V +900(els,)S +11 I +1083(destination)S +11 R +1606(coordinates)S +2144(refer)S +2381(to)S +2500(the)S +2667(frame)S +2954(bu)S +3064 H + (f)show 11 -.5 mul h (f)show +11 R +3131(er.)S +3696 V +1175(Because)S +1580(we)S +1748(did)S +1930(not)S +2112(wish)S +2361(to)S +2488(change)S +2838(any)S +3037(of)S +3169(the)S +3344(existing)S +3734(interfaces,)S +4227(mappings)S +4696(must)S +4953(be)S +5098(set)S +3816 V +900(prior)S +1152(to)S +1277(the)S +11 B +1449(cdl_setWCS\(\))S +11 R +2133(call)S +2362(using)S +2639(the)S +11 B +2811(cdl_setMapping\(\))S +11 R +3674(procedure.)S +4209(The)S +4417(mapping)S +4840(is)S +4952(stored)S +3936 V +900(until)S +1147(the)S +1325(WCS)S +1608(is)S +1726(actually)S +2117(sent.)S +2399(Similarly,)S +2882(a)S +2974(mapping)S +3403(may)S +3636(be)S +3783(retrieved)S +11 I +4216(after)S +11 R +4469(a)S +11 B +4562(cdl_getWCS\(\))S +4056 V +11 R +900(call)S +1124(using)S +1428(the)S +11 B +1627(cdl_getMapping\(\))S +11 R +2529(procedure)S +3030(to)S +3181(return)S +3507(the)S +3706(values)S +4051(read)S +4303(with)S +4564(the)S +4763(last)S +4981(WCS)S +4176 V +900(retrieval.)S +1359(Since)S +1637(there)S +1889(can)S +2074(at)S +2187(times)S +2460(be)S +2597(more)S +2856(than)S +3079(one)S +3271(WCS)S +3545(in)S +3666(a)S +3749(frame,)S +4066(it's)S +4242(also)S +4454(possible)S +4850(to)S +4971(query)S +4296 V +900(the)S +1074(mapping)S +1499(for)S +1665(a)S +1752(particular)S +2210(WCS)S +2488(by)S +2637(number)S +3011(\(e.g.)S +3245(the)S +3418(WCS)S +3696(number)S +4070(returned)S +4473(in)S +4598(a)S +4685(cursor)S +4997(read\))S +4416 V +900(using)S +1178(the)S +11 I +1351(cdl_queryMap\(\))S +11 R +2101(procedure.)S +2637(See)S +2834(the)S +3008(sample)S +3359(programs)S +3813(in)S +3939(the)S +4113(appendices)S +4639(for)S +4806(examples)S +4536 V +900(of)S +1024(how)S +1246(these)S +1504(procedures)S +2016(might)S +2307(be)S +2443(called.)S +4776 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +4896 V +11 C +1175(int)S +1439(cdl_getMapping\(CDLPtr)S +2891(cdl,)S +3221(char)S +3551(*region,)S +5016 V +1439(float)S +1835(*sx,)S +2165(float)S +2561(*sy,)S +2891(int)S +3155(*snx,)S +3551(int)S +3815(*sny,)S +5136 V +1439(int)S +1703(*dx,)S +2033(int)S +2297(*dy,)S +2627(int)S +2891(*dnx,)S +3287(int)S +3551(*dny,)S +3947(char)S +4277(*ref\);)S +5256 V +1175(int)S +1439(cdl_setMapping\(CDLPtr)S +2891(cdl,)S +3221(char)S +3551(*region,)S +5376 V +1439(float)S +1835(sx,)S +2099(float)S +2495(sy,)S +2759(int)S +3023(snx,)S +3353(int)S +3617(sny,)S +5496 V +1439(int)S +1703(dx,)S +1967(int)S +2231(dy,)S +2495(int)S +2759(dnx,)S +3089(int)S +3353(dny,)S +3683(char)S +4013(*ref\);)S +5616 V +1175(int)S +1439(cdl_queryMap\(CDLPtr)S +2759(cdl,)S +3089(int)S +3353(wcs,)S +3683(char)S +4013(*region,)S +5736 V +1439(float)S +1835(*sx,)S +2165(float)S +2561(*sy,)S +2891(int)S +3155(*snx,)S +3551(int)S +3815(*sny,)S +5856 V +1439(int)S +1703(*dx,)S +2033(int)S +2297(*dy,)S +2627(int)S +2891(*dnx,)S +3287(int)S +3551(*dny,)S +3947(char)S +4277(*objref\);)S +6216 V +11 B +900(4.9.)S +1132(Image)S +1457(Colormaps)S +6372 V +11 R +1175(The)S +1395(IIS)S +1579(protocol)S +1996(used)S +2248(does)S +2500(not)S +2692(permit)S +3030(the)S +3215(downloading)S +3840(of)S +3982(user-de\256ned)S +4574(colormaps,)S +5110(all)S +6492 V +900(images)S +1255(are)S +1431(loaded)S +1767(as)S +1902(raw)S +2109(grayscale)S +2565(values)S +2889(according)S +3364(to)S +3494(the)S +3672(XImtool)S +4089(colormap)S +4547(model)S +4866(used)S +5110(by)S +6612 V +900(currently)S +1348(supported)S +1834(servers.)S +2257(All)S +2451(images)S +2815(containing)S +3332(private)S +3689(colormaps)S +4200(or)S +4345(more)S +4624(than)S +4867(the)S +5055(201)S +6732 V +900(grayscale)S +1355(values)S +1678(de\256ned)S +2043(by)S +2195(the)S +2371(Imtool)S +2707(colormap)S +3163(model)S +3480(must)S +3737(either)S +4028(convert)S +4398(the)S +4574(image)S +4884(to)S +5012(8-bit)S +6852 V +900(grayscale)S +1418(values)S +1804(by)S +2020(calling)S +2425(the)S +2665(CDL)S +2991(zscale)S +3364(procedures)S +3950(\()S +11 B +3986(cdl_computeZscale\(\))S +11 R +5062(and)S +6972 V +11 B +900(cdl_zscaleImage\(\))S +11 R +1733(\))S +1814(or)S +1950(scale)S +2213(the)S +2392(images)S +2748(in)S +2879(client)S +3168(code)S +3419(with)S +3660(user)S +3887(LUTs.)S +4249(The)S +4464(CDL)S +4728(zscale)S +5038(pro-)S +7092 V +900(cedures)S +1276(scale)S +1537(image)S +1849(to)S +1979(201)S +2188(grayscale)S +2644(values)S +2968(so)S +3110(that)S +3319(they)S +3552(are)S +3728(displayed)S +4193(to)S +4323(the)S +4501(full)S +4698(8-bit)S +4950(range,)S +7212 V +900(user)S +1135(LUT)S +1401(transformations)S +2143(or)S +2287(user)S +2522(code)S +2781(for)S +2961(converting)S +3483(to)S +3621(grayscale)S +4085(from)S +4350(a)S +4450(private)S +4806(colormap)S +7920 V +EP +%%Page: 9 12 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2963(- 9 -)S +840 V +900(procedures)S +1412(should)S +1739(do)S +1882(the)S +2049(same.)S +1080 V +11 B +900(4.9.1.)S +1215(Imtool)S +1559(Color)S +1860(Model)S +1236 V +11 R +1175(The)S +1383(IMTOOL)S +1847(color)S +2110(model)S +2423(de\256nes)S +2772(at)S +2889(most)S +3142(201)S +3345(grayscale)S +3795(values)S +4113(for)S +4278(use)S +4463(in)S +4588(displaying)S +5086(the)S +1356 V +900(image,)S +1239(a)S +1330(set)S +1495(of)S +1629(16)S +1782(static)S +2057(colors)S +2368(are)S +2543(also)S +2763(de\256ned)S +3129(for)S +3299(overlay)S +3670(graphics.)S +4145(Pixel)S +4415(values)S +4738(sent)S +4958(to)S +5086(the)S +1476 V +900(server)S +1200(should)S +1528(be)S +1665(already)S +2020(scaled)S +2327(to)S +2447(this)S +2641(model,)S +2978(i.e.)S +3147(the)S +3315(image)S +3617(pixels)S +3914(should)S +4242(be)S +4380(scaled)S +4688(to)S +4809(the)S +4978(range)S +1596 V +900(1-200,)S +1231(values)S +1558(above)S +1866(this)S +2073(will)S +2292(either)S +2588(represent)S +3035(the)S +3216(overlay)S +3591(colors)S +3906(or)S +4044(will)S +4263(wrap)S +4528(around)S +4879(to)S +5012(8-bit)S +1716 V +900(values.)S +1286(The)S +1501(CDL)S +1766(zscale)S +2077(procedures)S +2601(will)S +2818(automatically)S +3461(scale)S +3724(arbitrary)S +4145(pixel)S +4410(values)S +4736(to)S +4868(use)S +5060(this)S +1836 V +900(color)S +1169(model,)S +1516(the)S +1694(overlay)S +2066(procedures)S +2589(assume)S +2956(color)S +3224(values)S +3547(are)S +3722(de\256ned)S +4088(for)S +4258(the)S +4435(static)S +4710(color)S +4978(range)S +1956 V +900(201-217)S +1299(but)S +1473(any)S +1664(8-bit)S +1905(value)S +2175(may)S +2397(be)S +2533(used.)S +2112 V +1175(A)S +1287(summary)S +1729(of)S +1853(the)S +2020(color)S +2278(model)S +2586(values)S +2899(is)S +3006(included)S +3417(below:)S +2292 V +11 B +1593(Color)S +2080(Description)S +3337(Color)S +3819(Description)S +2412 V +11 R +1593(0)S +2080(Background)S +3388(208)S +3819(Cyan)S +2532 V +1593(1)S +1681(-)S +1750(200)S +2080(Image)S +2386(data)S +3388(209)S +3819(Magenta)S +2652 V +1593(201)S +2080(Cursor)S +2412(\(white\))S +3388(210)S +3819(Coral)S +2772 V +1593(202)S +2080(Background)S +2649(\(black\))S +3388(211)S +3819(Maroon)S +2892 V +1593(203)S +2080(White)S +3388(212)S +3819(Orange)S +3012 V +1593(204)S +2080(Red)S +3388(213)S +3819(Khaki)S +3132 V +1593(205)S +2080(Green)S +3388(214)S +3819(Orchid)S +3252 V +1593(206)S +2080(Blue)S +3388(215)S +3819(Turquoise)S +3372 V +1593(207)S +2080(Yellow)S +3388(216)S +3819(Violet)S +3492 V +1593(217)S +2080(Wheat)S +3288(218-255)S +3819(unde\256ned)S +3792 V +11 B +900(4.10.)S +1187(ZScale)S +1538(Intensity)S +1987(Mapping)S +3948 V +11 R +1175(Since)S +1455(most)S +1706(display)S +2060(servers)S +2405(are)S +2573(only)S +2805(capable)S +3174(of)S +3301(displaying)S +3796(8-bit)S +4041(pixel)S +4298(values,)S +4676(images)S +5024(with)S +4068 V +900(more)S +1172(than)S +1408(8-bits)S +1706(per)S +1892(pixel)S +2159(must)S +2421(be)S +2571(scaled)S +2891(prior)S +3151(to)S +3284(display.)S +3710(For)S +3910(linear)S +4205(transformations)S +4940(this)S +5146(is)S +4188 V +900(typically)S +1334(done)S +1596(using)S +1885(a)S +1983(simple)S +2327(conversion)S +2858(of)S +2999(the)S +3183(image)S +3501(min/max)S +3943(values)S +4273(to)S +4409(the)S +4593(256)S +4808(grayscale)S +4308 V +900(values,)S +1247(however)S +1662(this)S +1861(doesn't)S +2223(produce)S +2614(very)S +2847(good)S +3106(results)S +3432(when)S +3708(most)S +3962(pixel)S +4220(values)S +4538(are)S +4708(near)S +4933(one)S +5129(of)S +4428 V +900(the)S +1088(extremes)S +1537(\(usually)S +1945(the)S +2133(image)S +2455(min)S +2681(for)S +2862(astronomical)S +3483(images\).)S +3945(To)S +4121(solve)S +4407(this)S +4622(IRAF)S +4928(uses)S +5172(a)S +4548 V +11 I +900(zscale)S +11 R +1218(mapping)S +1653(algorithm)S +2131(where)S +2447(a)S +2544(sampling)S +2997(grid)S +3223(is)S +3346(used)S +3596(to)S +3731(approximate)S +4328(the)S +4511(image)S +4828(min/max)S +4668 V +900(values)S +1214(rather)S +1502(than)S +1725(computing)S +2230(it)S +2326(directly,)S +2723(a)S +2806(line)S +3006(is)S +3115(then)S +3339(\256t)S +3467(to)S +3588(these)S +3848(sample)S +4194(pixels)S +4492(to)S +4613(determine)S +5086(the)S +4788 V +900(optimal)S +1274(transformation)S +1957(to)S +2080(the)S +2251(display)S +2606(values.)S +2984(This)S +3217(is)S +3328(not)S +3506(only)S +3739(more)S +4001(e)S +4049 H + (f)show 11 -.5 mul h (\256)show +11 R +4141(cient)S +4390(but)S +4567(maps)S +4835(the)S +5005(most)S +4908 V +900(common)S +1318(pixel)S +1571(values)S +1884(to)S +2003(the)S +2170(display)S +2521(range)S +2796(producing)S +3274(a)S +3355(better)S +3637(image.)S +5064 V +1175(The)S +1379(CDL)S +1633(has)S +1813(several)S +2156(routines)S +2544(for)S +2705(doing)S +2991(the)S +3160(same)S +3420(transformation:)S +4132(the)S +11 I +4301(cdl_computeZscale\(\))S +5184 V +11 R +900(procedure)S +1383(is)S +1504(used)S +1752(to)S +1885(compute)S +2310(the)S +2491(optimal)S +11 I +2875(z1)S +11 R +3020(and)S +11 I +3225(z2)S +11 R +3370(values)S +3697(\(the)S +3914(min/max)S +4353(used)S +4601(for)S +4774(the)S +4954(zscale)S +5304 V +900(transform\))S +1402(for)S +1569(an)S +1712(image)S +2020(of)S +2151(any)S +2349(pixel)S +2609(size.)S +2880(The)S +11 I +3090(bitpix)S +11 R +3381(argument)S +3835(is)S +3949(the)S +4123(number)S +4498(of)S +4629(bits-per-pixel)S +5424 V +900(for)S +1086(the)S +1279(input)S +1565(array)S +1847(and)S +2063(has)S +2267(the)S +2459(same)S +2742(meaning)S +3178(as)S +3327(for)S +3512(the)S +3704(FITS)S +11 I +3989(BITPIX)S +11 R +4382(keyword.)S +4851(To)S +5031(then)S +5544 V +900(transform)S +1361(the)S +1530(image)S +1833(using)S +2107(these)S +2368(values)S +2684(\(or)S +2847(user-de\256ned)S +3424(values\))S +3776(the)S +11 I +3946(cdl_zscaleImage\(\))S +11 R +4784(procedure)S +5664 V +900(is)S +1015(used.)S +1318(The)S +1528(input)S +1795(pixels)S +2098(are)S +2270(modi\256ed)S +2702(by)S +2852(this)S +3052(procedure)S +3528(but)S +3709(the)S +3883(array)S +4146(is)S +4260(not)S +4441(reallocated)S +4960(to)S +5086(the)S +5784 V +900(smaller)S +1273(size)S +1493(needed)S +1852(by)S +2012(an)S +2166(8-bit)S +2425(array.)S +2760(The)S +11 B +2981(cdl_setSample\(\))S +11 R +3776(and)S +11 B +3985(cdl_setSampleLines\(\))S +11 R +5038(pro-)S +5904 V +900(cedures)S +1278(can)S +1474(be)S +1622(used)S +1868(to)S +1999(change)S +2352(the)S +2530(sampling)S +2978(grid)S +3199(and)S +3401(number)S +3780(of)S +3915(sample)S +4270(points)S +4584(\(the)S +4798(default)S +5146(is)S +6024 V +900(600)S +1099(points)S +1403(on)S +1547(5)S +1636(lines\).)S +1975(The)S +11 B +2179(cdl_setContrast\(\))S +11 R +3022(procedure)S +3493(can)S +3679(be)S +3817(used)S +4053(to)S +4174(change)S +4518(the)S +4687(default)S +5026(con-)S +6144 V +900(trast)S +1128(adjustment)S +1650(to)S +1775(the)S +1948(slope)S +2219(used)S +2459(in)S +2584(the)S +2757(transformation)S +3442(\(the)S +3651(default)S +3993(is)S +4105(0.25\).)S +4433(If)S +4543(a)S +4629(value)S +4904(of)S +5033(zero)S +6264 V +900(is)S +1007(given)S +1284(then)S +1506(the)S +1673(minimum)S +2136(and)S +2327(maximum)S +2807(of)S +2931(the)S +3098(intensity)S +3511(sample)S +3855(is)S +3962(used)S +4196(as)S +4320(the)S +4487(z1/z2)S +4757(value.)S +6420 V +1175(Each)S +1440(of)S +1578(the)S +1759(CDL)S +2026(display)S +2391(procedures)S +2917(has)S +3110(a)S +11 I +3205(zscale)S +11 R +3520(\257ag)S +3732(to)S +3865(automatically)S +4510(scale)S +4775(the)S +4957(pixels)S +6540 V +900(prior)S +1151(to)S +1275(display.)S +1691(Applications)S +2290(wishing)S +2676(to)S +2799(set)S +2958(their)S +3196(own)S +3422(z1/z2)S +3696(values)S +4013(will)S +4222(need)S +4465(to)S +4588(call)S +4783(the)S +4954(zscale)S +6660 V +900(procedures)S +1421(and)S +1621(disable)S +1974(this)S +2176(\257ag.)S +2444(By)S +2615(default)S +2961(cdl_zscaleImage\(\))S +3803(will)S +4017(use)S +4206(a)S +4297(linear)S +4589(transform,)S +5086(the)S +6780 V +11 B +900(cdl_setZTrans\(\))S +11 R +1764(procedure)S +2312(may)S +2613(be)S +2828(used)S +3141(to)S +3339(change)S +3760(this.)S +4093(Acceptable)S +4696(values)S +5088(are)S +6900 V +11 B +900(CDL_UNITARY)S +11 R +1733(\(zero\))S +2026(for)S +2187(a)S +2269(unitary)S +2614(transform,)S +11 B +3102(CDL_LINEAR)S +11 R +3851(\(one\))S +4115(for)S +4276(a)S +4358(linear)S +4641(transform,)S +5129(or)S +7020 V +11 B +900(CDL_LOG)S +11 R +1466(\(two\))S +1736(for)S +1896(a)S +1977(log10)S +2261(transform.)S +7260 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +7920 V +EP +%%Page: 10 13 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 10 -)S +840 V +11 C +1175(void)S +1505(cdl_computeZscale)S +2693(\(CDLPtr)S +3221(cdl,)S +3551(uchar)S +3947(*pix,)S +4343(int)S +4607(nx,)S +960 V +1439(int)S +1703(ny,)S +1967(int)S +2231(bitpix,)S +2759(float)S +3155(*z1,)S +3485(float)S +3881(*z2\))S +1080 V +1175(void)S +1505(cdl_zscaleImage)S +2561(\(CDLPtr)S +3089(cdl,)S +3419(uchar)S +3815(**pix,)S +4277(int)S +4541(nx,)S +1200 V +1439(int)S +1703(ny,)S +1967(int)S +2231(bitpix,)S +2759(float)S +3155(z1,)S +3419(float)S +3815(z2\))S +1440 V +1175(void)S +1505(cdl_setZTrans)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(int)S +3551(ztrans\))S +1560 V +1175(void)S +1505(cdl_getZTrans)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(int)S +3551(*ztrans\))S +1680 V +1175(void)S +1505(cdl_setZScale)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(float)S +3683(z1,)S +3947(float)S +4343(z2\))S +1800 V +1175(void)S +1505(cdl_getZScale)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(float)S +3683(*z1,)S +4013(float)S +4409(*z2\))S +2040 V +1175(void)S +1505(cdl_setSample)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(int)S +3551(nsample\))S +2160 V +1175(void)S +1505(cdl_setSampleLines)S +2759(\(CDLPtr)S +3287(cdl,)S +3617(int)S +3881(nlines\))S +2280 V +1175(void)S +1505(cdl_setContrast)S +2561(\(CDLPtr)S +3089(cdl,)S +3419(float)S +3815(contrast\))S +2400 V +1175(void)S +1505(cdl_getSample)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(int)S +3551(*nsample\))S +2520 V +1175(void)S +1505(cdl_getSampleLines)S +2759(\(CDLPtr)S +3287(cdl,)S +3617(int)S +3881(*nlines\))S +2640 V +1175(void)S +1505(cdl_getContrast)S +2561(\(CDLPtr)S +3089(cdl,)S +3419(float)S +3815(*contrast\))S +3000 V +11 B +900(4.11.)S +1187(Image)S +1512(Hardcopy)S +3156 V +11 R +1175(While)S +1479(most)S +1731(servers)S +2077(include)S +2437(some)S +2706(hardcopy)S +3150(capability)S +3620(of)S +3748(their)S +3986(own)S +4212(the)S +4383(CDL)S +4640(provides)S +5055(two)S +3276 V +900(procedures)S +1428(for)S +1603(creating)S +2003(hardcopy)S +2458(images)S +2817(from)S +3078(the)S +3260(client)S +3552(\(e.g.)S +3795(for)S +3970(a)S +4066(batch)S +4351(processing)S +4868(applica-)S +3396 V +900(tion\).)S +1207(The)S +1415(client)S +1697(will)S +1907(typically)S +2330(read)S +2555(back)S +2799(the)S +2971(entire)S +3258(image,)S +3592(frame)S +3884(bu)S +3994 H + (f)show 11 -.5 mul h (f)show +11 R +4061(er,)S +4212(of)S +4342(just)S +4541(a)S +4628(subraster)S +5062(and)S +3516 V +900(pass)S +1134(those)S +1411(pixels)S +1718(to)S +1848(the)S +2026(print)S +2278(procedure.)S +2819(Images)S +3179(will)S +3395(be)S +3542(written)S +3897(as)S +4032(Pseudocolor)S +4619(Postscript)S +5098(\(to)S +3636 V +900(preserve)S +1376(the)S +1617(overlay)S +2052(marker)S +2468(colors\))S +2879(and)S +3144(may)S +3440(be)S +3650(disposed)S +4142(to)S +4335(a)S +4490(\256le)S +4739(using)S +5086(the)S +3756 V +11 B +900(cdl_printPixToFile\(\))S +11 R +1903(procedure)S +2376(or)S +2504(to)S +2627(any)S +2822(command)S +3292(string)S +3580(accepting)S +4036(input)S +4299(from)S +11 I +4548(stdin)S +11 R +4799(\(typically)S +3876 V +900(just)S +1093(an)S +1229('lpr')S +1456(command\))S +1958(by)S +2101(using)S +2373(the)S +11 B +2540(cdl_printPix\(\))S +11 R +3233(procedure.)S +4116 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +4236 V +11 C +1175(int)S +1439(cdl_printPix)S +2297(\(CDLPtr)S +2825(cdl,)S +3155(char)S +3485(*cmd,)S +3881(uchar)S +4277(*pix,)S +4673(int)S +4937(nx,)S +4356 V +1439(int)S +1703(ny,)S +1967(int)S +2231(annotate\))S +4476 V +1175(int)S +1439(cdl_printPixToFile)S +2693(\(CDLPtr)S +3221(cdl,)S +3551(char)S +3881(*fname,)S +4409(uchar)S +4805(*pix,)S +4596 V +1439(int)S +1703(nx,)S +1967(int)S +2231(ny,)S +2495(int)S +2759(annotate\))S +4836 V +11 B +900(4.12.)S +1187(Image)S +1512(Cursor)S +4992 V +11 R +1175(The)S +1390(image)S +1703(cursor)S +2021(is)S +2140(read)S +2372(using)S +2656(the)S +11 B +2835(cdl_readCursor\(\))S +11 R +3696(procedure.)S +4238(The)S +4453(returned)S +4863(value)S +5146(is)S +5112 V +900(the)S +1082(cursor)S +11 I +1403(\(x,y\))S +11 R +1647(position)S +2051(as)S +2190(\257oating)S +2575(point)S +2850(value)S +3135(in)S +3269(terms)S +3561(of)S +3700(the)S +3881(currently)S +4323(de\256ne)S +4638(image)S +4953(WCS.)S +5232 V +900(Note)S +1149(that)S +1350(this)S +1546(position)S +1938(must)S +2189(be)S +2328(converted)S +2796(to)S +2919(integer)S +3260(if)S +3364(it)S +3463(is)S +3574(to)S +3697(be)S +3837(used)S +4075(in)S +4198(one)S +4393(of)S +4521(the)S +4692(marker)S +5038(pro-)S +5352 V +900(cedures.)S +5592 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +5712 V +11 C +1175(int)S +1439(cdl_readCursor)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(int)S +3551(sample,)S +4079(float)S +4475(*x,)S +5832 V +1439(float)S +1835(*y,)S +2099(int)S +2363(*wcs,)S +2759(char)S +3089(*key\))S +6072 V +11 R +900(The)S +11 I +1103(wcs)S +11 R +1301(argument)S +1748(is)S +1855(de\256ned)S +2211(as)S +6312 V +1164(wcs)S +1367(=)S +1462(frame)S +1749(*)S +1837(100)S +2035(+)S +2130(wcs_number)S +6552 V +900(\(where)S +1247(wcs_number=0)S +1969(for)S +2141(frame)S +2440(bu)S +2550 H + (f)show 11 -.5 mul h (f)show +11 R +2617(er)S +2746(coords)S +3083(and)S +3286(1)S +3386(for)S +3558(image)S +3872(coords\).)S +4307(So,)S +4498(you)S +4709(can)S +4906(get)S +5086(the)S +6672 V +900(frame)S +1187(as)S +1311(simply)S +6912 V +1164(frame)S +1451(=)S +1546(\(int\))S +1768(\(wcs)S +2007(/)S +2071(100\))S +7920 V +EP +%%Page: 11 14 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 11 -)S +840 V +11 B +900(4.12.1.)S +1270(Cursor)S +1638(Sampling)S +996 V +11 R +1175(If)S +1307(the)S +1501(cdl_readCursor\(\))S +11 I +2308(sample)S +11 R +2680(\257ag)S +2906(is)S +3041(non-zero)S +3490(the)S +11 I +3685(logical)S +4052(image)S +4381(cursor)S +11 R +4729(position)S +5146(is)S +1116 V +900(returned)S +1300(immediately,)S +1914(otherwise)S +2376(the)S +2545(display)S +2898(server)S +3199(will)S +3406(wait)S +3630(for)S +3792(a)S +3875(keystroke)S +4336(before)S +4649(returning)S +5086(the)S +1236 V +900(cursor)S +1214(position.)S +1672(The)S +1883(logical)S +2223(image)S +2532(cursor)S +2846(is)S +2961(the)S +3136(last)S +3330(value)S +3609(set)S +3773(by)S +3925(a)S +11 I +4015(cdl_setCursor\(\))S +11 R +4753(call)S +4953(or)S +5086(the)S +1356 V +900(last)S +1101(value)S +1386(returned)S +1798(by)S +1956(a)S +11 I +2051(cdl_readCursor\(\))S +11 R +2873(call.)S +3139(When)S +3447(sampling)S +3898(the)S +4079(cursor)S +4399(position)S +4802(the)S +4983(keys-)S +1476 V +900(troke)S +1158(value)S +1428(is)S +1535(unde\256ned.)S +1716 V +11 B +900(4.13.)S +1187(Image)S +1512(Readout)S +1872 V +11 R +1175(The)S +1390(CDL)S +1655(maintains)S +2128(an)S +2276(internal)S +2657(knowledge)S +3184(of)S +3321(where)S +3633(an)S +3782(image)S +4096(has)S +4288(been)S +4540(positioned)S +5045(if)S +5158(it)S +1992 V +900(was)S +1110(displayed)S +1571(using)S +1850(one)S +2048(of)S +2179(the)S +11 I +2353(cdl_display*)S +11 R +2955(procedures.)S +3535(The)S +11 B +3744(cdl_readImage\(\))S +11 R +4556(procedure)S +5031(may)S +2112 V +900(be)S +1046(used)S +1290(to)S +1419(read)S +1649(back)S +1899(the)S +2077(entire)S +2370(image)S +2682(pixels)S +2989(from)S +3246(the)S +3424(server)S +3734(ignoring)S +4151(the)S +4329(region)S +4653(of)S +4788(the)S +4966(frame)S +2232 V +900(bu)S +1010 H + (f)show 11 -.5 mul h (f)show +11 R +1077(er)S +1203(outside)S +1563(of)S +1696(the)S +1872(image,)S +2209(the)S +11 B +2384(cdl_readFrameBu)S +3238 H + (f)show 11 -.5 mul h (f)show +11 B +3305(er\(\))S +11 R +3514(procedure)S +3991(will)S +4204(read)S +4432(back)S +4679(the)S +4854(contents)S +2352 V +900(of)S +1024(the)S +1191(entire)S +1473(frame)S +1760(bu)S +1870 H + (f)show 11 -.5 mul h (f)show +11 R +1937(er.)S +2115(The)S +2318(dimensions)S +2853(of)S +2977(the)S +3144(array)S +3400(are)S +3565(returned)S +3962(in)S +4081(the)S +11 I +4248(nx)S +11 R +4384(and)S +11 I +4575(ny)S +11 R +4711(arguments.)S +2592 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +2712 V +11 C +1175(int)S +1439(cdl_readImage)S +2363(\(CDLPtr)S +2891(cdl,)S +3221(uchar)S +3617(**pix,)S +4079(int)S +4343(*nx,)S +2832 V +1439(int)S +1703(*ny\)R)S +2952 V +1175(int)S +1439(cdl_readFrameBuffer)S +2759(\(CDLPtr)S +3287(cdl,)S +3617(uchar)S +4013(**pix,)S +3072 V +1439(int)S +1703(*nx,)S +2033(int)S +2297(*ny\)R)S +3312 V +11 B +900(4.14.)S +1187(Subraster)S +1684(I/O)S +3468 V +11 R +1175(The)S +11 B +1379(cdl_writeSubRaster\(\))S +11 R +2418(procedure)S +2888(is)S +2996(used)S +3231(to)S +3351(write)S +3610(an)S +3747(arbitrary)S +4157(raster)S +4433(to)S +4553(any)S +4745(location)S +5134(in)S +3588 V +900(the)S +1069(display.)S +1483(Similarly)S +1929(the)S +11 B +2098(cdl_readSubRaster\(\))S +11 R +3109(procedure)S +3580(is)S +3689(used)S +3925(to)S +4046(read)S +4268(back)S +4509(an)S +4647(arbitrary)S +5057(ras-)S +3708 V +900(ter.)S +1127(When)S +1439(an)S +1593(image)S +1912(has)S +2109(previously)S +2624(been)S +2881(displayed)S +3353(the)S +3538(subraster)S +3984(position)S +4392(is)S +4518(given)S +4814(in)S +4952(image)S +3828 V +900(coordinates)S +1446(\(e.g.)S +1682(when)S +1960(writing)S +2319(a)S +2408(subregion)S +2882(of)S +3014(edited)S +3323(pixels\),)S +3690(otherwise)S +4156(the)S +4330(position)S +4726(is)S +4840(in)S +4966(frame)S +3948 V +900(bu)S +1010 H + (f)show 11 -.5 mul h (f)show +11 R +1077(er)S +1256(coordinates)S +1856(\(e.g.)S +2146(to)S +2327(display)S +2740(multiple)S +3203(images)S +3609(per)S +3843(frame)S +4193(you)S +4454(should)S +4844(use)S +5086(the)S +4068 V +900(cdl_writeSubRaster\(\))S +1885(call\).)S +2187(See)S +2392(the)S +2573(section)S +2931(on)S +11 I +3088(Marker)S +3463(Coordinates)S +11 R +4055(for)S +4228(further)S +4571(explanation)S +5129(of)S +4188 V +900(the)S +1067(coordinate)S +1562(systems)S +1944(used.)S +4428 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +4548 V +11 C +1175(int)S +1439(cdl_writeSubRaster)S +2693(\(CDLPtr)S +3221(cdl,)S +3551(int)S +3815(lx,)S +4079(int)S +4343(ly,)S +4607(int)S +4871(nx,)S +4668 V +1439(int)S +1703(ny,)S +1967(uchar)S +2363(*pix\))S +4788 V +1175(int)S +1439(cdl_readSubRaster)S +2627(\(CDLPtr)S +3155(cdl,)S +3485(int)S +3749(lx,)S +4013(int)S +4277(ly,)S +4541(int)S +4805(nx,)S +4908 V +1439(int)S +1703(ny,)S +1967(uchar)S +2363(**pix\))S +5148 V +11 B +900(5.)S +1049(Graphics)S +1517(Overlay)S +5388 V +900(5.1.)S +1132(Marker)S +1529(Coordinates)S +5544 V +11 R +1175(All)S +1369(marker)S +1731(positions)S +2183(are)S +2368(assumed)S +2799(to)S +2938(be)S +3094(image)S +3415(pixel)S +3688(coordinates,)S +4274(although)S +4712(there)S +4983(is)S +5110(no)S +5664 V +900(requirement)S +1465(that)S +1666(the)S +1836(position)S +2227(be)S +2365(on)S +2510(the)S +2679(image)S +2982(itself.)S +3298(When)S +3594(an)S +3732(image)S +4035(WCS)S +4309(is)S +4418(de\256ned)S +4776(\(using)S +5086(the)S +5784 V +900(CDL)S +1162(display)S +1522(procedures)S +2043(or)S +2176(explicitly\))S +2670(the)S +2846(origin)S +3151(of)S +3284(the)S +3460(coordinates)S +4007(used)S +4251(shifts)S +4533(from)S +4789(the)S +4966(frame)S +5904 V +900(bu)S +1010 H + (f)show 11 -.5 mul h (f)show +11 R +1077(er)S +1205(lower-left)S +1680(to)S +1810(the)S +1988(lower-left)S +2463(of)S +2598(the)S +2776(image)S +3088(as)S +3222(displayed)S +3686(in)S +3815(the)S +3992(frame.)S +4383(Negative)S +4821(positions)S +6024 V +900(are)S +1069(allowed)S +1453(and)S +1648(will)S +1857(either)S +2144(refer)S +2386(to)S +2510(empty)S +2823(pixels)S +3124(if)S +3229(the)S +3401(frame)S +3693(bu)S +3803 H + (f)show 11 -.5 mul h (f)show +11 R +3870(er)S +3992(is)S +4104(larger)S +4396(than)S +4623(the)S +4795(image,)S +5129(or)S +6144 V +900(pixels)S +1213(outside)S +1581(the)S +1765(frame)S +2069(bu)S +2179 H + (f)show 11 -.5 mul h (f)show +11 R +2246(er)S +2380(boundaries.)S +2971(Raster)S +3300(I/O)S +3495(requests)S +3903(will)S +4124(be)S +4276(clipped)S +4648(to)S +4783(the)S +4966(frame)S +6264 V +900(bu)S +1010 H + (f)show 11 -.5 mul h (f)show +11 R +1077(er)S +1194(endpoints,)S +1683(a)S +1764(request)S +2113(completely)S +2634(outside)S +2985(the)S +3152(frame)S +3439(bu)S +3549 H + (f)show 11 -.5 mul h (f)show +11 R +3616(er)S +3733(is)S +3840(an)S +3976(error.)S +6504 V +11 B +900(5.2.)S +1132(Mapping)S +1595(a)S +1683(Previously)S +2211(Displayed)S +2710(Image)S +6660 V +11 R +1175(Ideally)S +1512(any)S +1703(application)S +2224(wishing)S +2606(to)S +2725(draw)S +2976(markers)S +3361(on)S +3504(an)S +3641(image)S +3943(will)S +4149(have)S +4389(also)S +4600(displayed)S +5055(that)S +6780 V +900(image,)S +1242(however)S +1664(the)S +11 B +1844(cdl_mapFrame\(\))S +11 R +2675(procedure)S +3157(may)S +3392(be)S +3540(used)S +3786(to)S +3917(map)S +4151(the)S +4330(requested)S +4794(frame)S +5093(for)S +6900 V +900(marker)S +1247(overlay.)S +1674(It)S +1779(does)S +2018(this)S +2216(by)S +2365(reading)S +2732(the)S +2905(WCS)S +3183(de\256ned)S +3545(for)S +3711(that)S +3915(frame)S +4208(and)S +4405(assumes)S +4810(an)S +4952(image)S +7020 V +900(has)S +1089(been)S +1338(displayed)S +1802(and)S +2003(centered)S +2415(in)S +2544(the)S +2721(frame)S +3018(bu)S +3128 H + (f)show 11 -.5 mul h (f)show +11 R +3195(er,)S +3350(then)S +3582(resets)S +3874(the)S +4051(internal)S +4428(CDL)S +4690(image)S +5000(posi-)S +7140 V +900(tion.)S +1200(For)S +1387(this)S +1581(reason)S +1900(it)S +1997(should)S +2326(not)S +2502(be)S +2640(used)S +2876(when)S +3148(multiple)S +3551(image)S +3854(mappings)S +4317(have)S +4558(been)S +4799(displayed)S +7260 V +900(to)S +1026(a)S +1114(frame)S +1408(unless)S +1723(the)S +1897(marker)S +2246(overlay)S +2614(can)S +2805(be)S +2948(done)S +3201(reliably)S +3576(using)S +3855(the)S +4029(last)S +4222(WCS)S +4501(displayed)S +4961(to)S +5086(the)S +7920 V +EP +%%Page: 12 15 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 12 -)S +840 V +900(frame)S +1191(bu)S +1301 H + (f)show 11 -.5 mul h (f)show +11 R +1368(er.)S +1550(If)S +1659(no)S +1807(image)S +2113(has)S +2297(been)S +2541(displayed)S +3000(the)S +3172(frame)S +3464(bu)S +3574 H + (f)show 11 -.5 mul h (f)show +11 R +3641(er)S +3763(is)S +3875(mapped)S +4260(directly.)S +4694(This)S +4928(can)S +5117(be)S +960 V +900(used)S +1142(for)S +1310(example)S +1722(to)S +1849(map)S +2079(an)S +2223(empty)S +2539(frame)S +2834(for)S +3002(displaying)S +3502(just)S +3703(the)S +3878(markers)S +4271(without)S +4649(an)S +4793(image,)S +5129(or)S +1080 V +900(for)S +1063(mapping)S +1484(another)S +1849(frame's)S +2219(WCS)S +2495(for)S +2659(use)S +2842(on)S +2989(the)S +3160(current)S +3506(display.)S +3922(The)S +4129(frame)S +4420(is)S +4531(not)S +4709(changed)S +5110(by)S +1200 V +900(the)S +1067(procedure)S +1536(call)S +1727(however)S +2136(the)S +2303(current)S +2645(WCS)S +11 I +2917(is)S +11 R +3024(changed.)S +1440 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +1560 V +11 C +1175(int)S +1439(cdl_mapFrame)S +2297(\(CDLPtr)S +2825(cdl,)S +3155(int)S +3419(frame\))S +1800 V +11 B +900(5.3.)S +1132(Marking)S +1581(a)S +1669(Coordinate)S +2233(File)S +1956 V +11 R +1175(Since)S +1465(a)S +1559(common)S +1990(function)S +2402(for)S +2576(programs)S +3037(will)S +3256(be)S +3406(to)S +3539(mark)S +3811(a)S +3906(list)S +4089(of)S +4227(coordinates,)S +4807(the)S +4988(high-)S +2076 V +900(level)S +11 B +1158(cdl_markCoordsFile\(\))S +11 R +2246(procedure)S +2727(is)S +2846(provided)S +3281(to)S +3412(make)S +3693(this)S +3897(easier.)S +4256(The)S +4470(input)S +4741(parameters)S +2196 V +900(include)S +1273(a)S +1371(\256lename)S +1799(expected)S +2237(to)S +2373(contain)S +2747(a)S +2846(set)S +3019(of)S +3161(\(x,y\))S +3422(points)S +3743(\(real)S +3993(or)S +4135(integer\),)S +4554(and)S +4763(arguments)S +2316 V +900(specifying)S +1395(the)S +1567(point)S +1832(type,)S +2087(size)S +2294(and)S +2489(color)S +2751(to)S +2874(draw.)S +3190(If)S +3299(the)S +11 I +3470(label)S +11 R +3727(argument)S +4178(is)S +4289(positive)S +4675(each)S +4911(marker)S +2436 V +900(point)S +1160(will)S +1365(be)S +1501(labeled)S +1850(with)S +2079(it's)S +2254(relative)S +2616(number)S +2985(in)S +3105(the)S +3273(\256le.)S +3509(The)S +3713(size,)S +3945(type)S +4168(and)S +4360(color)S +4619(arguments)S +5110(all)S +2556 V +900(have)S +1139(the)S +1306(same)S +1564(meaning)S +1975(as)S +2099(for)S +2259(the)S +11 B +2426(cdl_markPoint\(\))S +11 R +3234(procedure)S +3703(described)S +4155(below.)S +2796 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +2916 V +11 C +1175(int)S +1439(cdl_markCoordsFile)S +2693(\(CDLPtr)S +3221(cdl,)S +3551(char)S +3881(*fname,)S +4409(int)S +4673(type,)S +3036 V +1439(int)S +1703(size,)S +2099(int)S +2363(color,)S +2825(int)S +3089(label\))S +3276 V +11 B +900(5.4.)S +1132(Marker)S +1529(Colors)S +3432 V +11 R +1175(Markers)S +1576(may)S +1802(be)S +1942(drawn)S +2252(using)S +2528(any)S +2723(8-bit)S +2969(value,)S +3272(in)S +3396(order)S +3664(to)S +3788(use)S +3972(the)S +4144(static)S +4414(overlay)S +4780(colors)S +5086(the)S +3552 V +900(color)S +1174(must)S +1438(be)S +1589(in)S +1723(the)S +1905(range)S +2195(201-217)S +2609(\(see)S +2832(above)S +3141(for)S +3316(notes)S +3596(on)S +3754(the)S +3936(XImtool)S +4357(color)S +4630(model\).)S +5050(The)S +3672 V +900(")S +11 I +945(cdl.h)S +11 R +1162(")S +1272(include)S +1660(\256le)S +1866(for)S +2059(C)S +2199(programs,)S +2707(the)S +2907(")S +11 I +2952(cdlftn.inc)S +11 R +3365(")S +3476(include)S +3865(for)S +4058(fortran)S +4421(programs,)S +4929(or)S +5086(the)S +3792 V +900(")S +11 I +945(cdlspp.h)S +11 R +1315(")S +1402(include)S +1767(for)S +1936(SPP)S +2164(programs,)S +2648(de\256nes)S +3001(the)S +3177(following)S +3647(symbolic)S +4093(constants)S +4544(for)S +4713(each)S +4954(of)S +5086(the)S +3912 V +900(static)S +1165(overlay)S +1526(colors:)S +4152 V +11 B +1730(C_BLACK)S +11 R +2603(202)S +11 B +3263(C_CORAL)S +11 R +4224(210)S +4272 V +11 B +1730(C_WHITE)S +11 R +2603(203)S +11 B +3263(C_MAROON)S +11 R +4224(211)S +4392 V +11 B +1730(C_RED)S +11 R +2603(204)S +11 B +3263(C_ORANGE)S +11 R +4224(212)S +4512 V +11 B +1730(C_GREEN)S +11 R +2603(205)S +11 B +3263(C_KHAKI)S +11 R +4224(213)S +4632 V +11 B +1730(C_BLUE)S +11 R +2603(206)S +11 B +3263(C_ORCHID)S +11 R +4224(214)S +4752 V +11 B +1730(C_YELLOW)S +11 R +2603(207)S +11 B +3263(C_TURQUOISE)S +11 R +4224(215)S +4872 V +11 B +1730(C_CYAN)S +11 R +2603(208)S +11 B +3263(C_VIOLET)S +11 R +4224(216)S +4992 V +11 B +1730(C_MAGENTA)S +11 R +2603(209)S +11 B +3263(C_WHEAT)S +11 R +4224(217)S +5292 V +11 B +900(5.5.)S +1132(Marker)S +1529(Types)S +5448 V +11 R +1175(Currently)S +1629(supported)S +2095(marker)S +2437(types)S +2702(include:)S +5628 V +11 I +1534(Point)S +1974(Line)S +2846(Box)S +3317(Polyline)S +4220(Polygon)S +5748 V +1534(Circle)S +1974(Circular)S +2387(Annuli)S +2846(Ellipse)S +3317(Elliptical)S +3761(Annuli)S +4220(Text)S +5964 V +11 R +1175(The)S +1386(")S +11 I +1431(cdl.h)S +11 R +1648(")S +1734(include)S +2099(\256le)S +2282(for)S +2451(C)S +2567(programs,)S +3051(the)S +3227(")S +11 I +3272(cdlftn.inc)S +11 R +3685(")S +3772(include)S +4137(for)S +4306(fortran)S +4645(programs,)S +5129(or)S +6084 V +900(the)S +1075(")S +11 I +1120(cdlspp.h)S +11 R +1490(")S +1576(include)S +1940(\256le)S +2122(SPP)S +2349(programs,)S +2832(de\256nes)S +3184(the)S +3359(following)S +3828(symbolic)S +4273(constants)S +4723(for)S +4890(each)S +5129(of)S +6204 V +900(the)S +1067(de\256ned)S +11 I +1423(Point)S +11 R +1695(marker)S +2037(types:)S +6384 V +11 B +1835(M_FILL)S +11 R +2761(1)S +11 B +3311(M_CIRCLE)S +11 R +4174(64)S +6504 V +11 B +1835(M_POINT)S +11 R +2761(2)S +11 B +3311(M_STAR)S +11 R +4119(128)S +6624 V +11 B +1835(M_BOX)S +11 R +2761(4)S +11 B +3311(M_HLINE)S +11 R +4119(256)S +6744 V +11 B +1835(M_PLUS)S +11 R +2761(8)S +11 B +3311(M_VLINE)S +11 R +4119(512)S +6864 V +11 B +1835(M_CROSS)S +11 R +2706(16)S +11 B +3311(M_HBLINE)S +11 R +4064(1024)S +6984 V +11 B +1835(M_DIAMOND)S +11 R +2706(32)S +11 B +3311(M_VBLINE)S +11 R +4064(2048)S +7920 V +EP +%%Page: 13 16 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 13 -)S +840 V +1175(Point)S +1449(markers)S +1841(are)S +2013(drawn)S +2326(using)S +2605(the)S +11 B +2779(cdl_markPoint\(\))S +11 R +3594(procedure,)S +4098(point)S +4365(types)S +4638(may)S +4868(be)S +5012(logi-)S +960 V +900(cally)S +11 I +1156(OR)S +11 R +1302('d)S +1436(to)S +1565(create)S +1867(composite)S +2362(markers,)S +2784(closed)S +3106(shapes)S +3440(such)S +3683(as)S +3816(a)S +3906(circles,)S +4261(diamonds,)S +4759(or)S +4892(squares)S +1080 V +900(may)S +1122(be)S +11 I +1258(OR)S +11 R +1404('d)S +1528(with)S +1757(the)S +1924(M_FILL)S +2342(\257ag)S +2540(to)S +2659(\257ood-\256ll)S +3079(the)S +3246(point)S +3506(with)S +3735(the)S +3902(current)S +4244(overlay)S +4605(color.)S +1320 V +11 B +900(5.5.1.)S +1215(Point)S +1476 V +11 R +1175(The)S +11 B +1384(cdl_markPoint\(\))S +11 R +2199(procedure)S +2675(is)S +2789(used)S +3030(to)S +3156(mark)S +3421(a)S +3509(speci\256c)S +3884(point)S +4151(on)S +4301(the)S +4475(image)S +4783(using)S +5062(one)S +1596 V +900(of)S +1033(the)S +1209(marker)S +1560(types)S +1834(listed)S +2115(above.)S +2479(The)S +2691(marker)S +3042(is)S +3158(centered)S +3569(at)S +3690(the)S +3866(coordinates)S +4413(speci\256ed)S +4845(by)S +4997(the)S +11 I +5172(x)S +1716 V +11 R +900(and)S +11 I +1099(y)S +11 R +1188(arguments,)S +11 I +1714(type)S +11 R +1937(is)S +2052(an)S +2196(integer)S +2542(\257ag)S +2749(indicating)S +3231(what)S +3486(kind)S +3724(of)S +3857(marker)S +4208(to)S +4336(draw)S +4596(and)S +4796(may)S +5027(be)S +5172(a)S +1836 V +900(composite)S +1393(type)S +1623(by)S +1774(logically)S +2200(ORing)S +2535(two)S +2741(or)S +2873(more)S +3138(marker)S +3487(types.)S +11 I +3820(Size)S +11 R +4037(is)S +4151(the)S +4325(width)S +4616(and)S +4814(height)S +5129(of)S +1956 V +900(the)S +1082(marker)S +1439(measured)S +1906(in)S +2040(pixel)S +2308(unxits,)S +2654(and)S +11 I +2860(color)S +11 R +3140(is)S +3262(the)S +3444(color)S +3717(used)S +3966(to)S +4100(draw)S +4366(the)S +4548(marker.)S +4966(If)S +5086(the)S +2076 V +11 I +900(number)S +11 R +1280(argument)S +1739(is)S +1858(greater)S +2205(than)S +2439(zero)S +2671(that)S +2881(number)S +3260(will)S +3476(be)S +3623(drawn)S +3940(next)S +4173(to)S +4303(the)S +4481(point)S +4752(as)S +4887(a)S +4979(label,)S +2196 V +900(creating)S +1285(text)S +1483(labels)S +1772(for)S +1932(point)S +2192(markers)S +2577(can)S +2761(be)S +2897(done)S +3143(using)S +3415(the)S +11 I +3582(cdl_markPointLabel)S +11 R +4519(procedure.)S +2352 V +1175(Most)S +1466(marker)S +1839(names)S +2183(are)S +2379(fairly)S +2680(obvious)S +3093(but)S +3299(several)S +3673(are)S +3870(worth)S +4191(special)S +4560(mention:)S +5050(The)S +2472 V +900(M_DIAMOND,)S +1676(M_CIRCLE)S +2287(and)S +2511(M_BOX)S +2962(marker)S +3337(types)S +3635(may)S +3890(be)S +4059(logically)S +11 I +4510(OR)S +11 R +4656(ed)S +4825(with)S +5086(the)S +2592 V +900(M_FILL)S +1331(\257ag)S +1542(to)S +1674(produce)S +2072(a)S +2166(\256lled)S +2439(marker)S +2794(type.)S +3090(Unless)S +11 I +3435(OR)S +11 R +3581(d)S +3682(with)S +3924(the)S +4104(M_POINT)S +4626(\257ag)S +4837(all)S +4993(point)S +2712 V +900(markers)S +1306(will)S +1531(leave)S +1814(the)S +2001(center)S +2320(pixel)S +2593(unchanged.)S +3181(The)S +3404(M_HLINE)S +3938(and)S +4149(M_VLINE)S +4683(markers)S +5088(are)S +2832 V +900(most)S +1149(useful)S +1451(in)S +1571(astronomical)S +2172(applications)S +2737(to)S +2857(mark)S +3116(an)S +3253(individual)S +3734(star,)S +3954(they)S +4177(are)S +4343(horizontal)S +4822(and)S +5014(vert-)S +2952 V +900(ical)S +1117(lines)S +1384(respectively)S +1971(with)S +2225(a)S +2331(gap)S +2547(in)S +2691(the)S +2883(middle)S +3247(third)S +3513(of)S +3662(the)S +3854(marker)S +4221(\(the)S +4449(M_HBLINE)S +5062(and)S +3072 V +900(M_VBLINE)S +1488(are)S +1653(identical)S +2064(but)S +2238(with)S +2467(a)S +2548(width)S +2832(of)S +2956(3)S +3044(pixels\).)S +3252 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +3372 V +11 C +1175(int)S +1439(cdl_markPoint)S +2363(\(CDLPtr)S +2891(cdl,)S +3221(int)S +3485(x,)S +3683(int)S +3947(y,)S +4145(int)S +4409(number,)S +3492 V +1439(int)S +1703(size,)S +2099(int)S +2363(type,)S +2759(int)S +3023(color\))S +3612 V +1175(int)S +1439(cdl_markPointLabel)S +2693(\(CDLPtr)S +3221(cdl,)S +3551(int)S +3815(x,)S +4013(int)S +4277(y,)S +4475(char)S +4805(*label)S +3732 V +1439(int)S +1703(size,)S +2099(int)S +2363(type,)S +2759(int)S +3023(color\))S +3972 V +11 B +900(5.5.2.)S +1215(Line)S +4128 V +11 R +1175(The)S +11 B +1399(cdl_markLine\(\))S +11 R +2192(procedure)S +2682(is)S +2810(used)S +3065(to)S +3205(draw)S +3477(a)S +3579(line)S +3798(of)S +3943(the)S +4131(speci\256ed)S +4576(color)S +4856(between)S +4248 V +900(points)S +1203(\()S +11 I +1239(xs,ys)S +11 R +1449(\))S +1518(and)S +1709(\()S +11 I +1745(xe,ye)S +11 R +1965(\).)S +4428 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +4548 V +11 C +1175(int)S +1439(cdl_markLine)S +2297(\(CDLPtr)S +2825(cdl,)S +3155(int)S +3419(xs,)S +3683(int)S +3947(ys,)S +4211(int)S +4475(xe,)S +4739(int)S +5003(ye,)S +4668 V +1439(int)S +1703(color\))S +4908 V +11 B +900(5.5.3.)S +1215(Box)S +5064 V +11 R +1175(The)S +11 B +1378(cdl_markBox\(\))S +11 R +2120(procedure)S +2590(is)S +2698(used)S +2933(to)S +3053(draw)S +3305(a)S +3387(box)S +3586(of)S +3711(the)S +3879(speci\256ed)S +4303(color)S +4562(with)S +4792(endpoints)S +5184 V +900(speci\256ed)S +1323(by)S +1466(\()S +11 I +1502(lx,ly)S +11 R +1688(\))S +1757(and)S +1948(\()S +11 I +1984(ux,uy)S +11 R +2218(\).)S +2348(If)S +2453(the)S +11 I +2620(\256ll)S +11 R +2770(\257ag)S +2968(is)S +3075(set)S +3230(the)S +3397(box)S +3595(will)S +3800(be)S +3936(\256lled)S +4196(with)S +4425(the)S +4592(marker)S +4934(color.)S +5364 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +5484 V +11 C +1175(int)S +1439(cdl_markBox)S +2231(\(CDLPtr)S +2759(cdl,)S +3089(int)S +3353(lx,)S +3617(int)S +3881(ly,)S +4145(int)S +4409(ux,)S +4673(int)S +4937(uy,)S +5604 V +1439(int)S +1703(fill,)S +2099(int)S +2363(color\))S +5844 V +11 B +900(5.5.4.)S +1215(Circle)S +6000 V +11 R +1175(The)S +11 B +1393(cdl_markCircle\(\))S +11 R +2250(procedure)S +2734(is)S +2856(used)S +3105(to)S +3239(draw)S +3505(a)S +3601(circle)S +3891(of)S +4031(the)S +4214(speci\256ed)S +4653(color)S +4927(with)S +5172(a)S +6120 V +900(center)S +1209(at)S +1331(\()S +11 I +1367(x,y)S +11 R +1491(\))S +1570(and)S +1771(radius)S +11 I +2082(radius)S +11 R +2364(.)S +2468(If)S +2583(the)S +11 I +2760(\256ll)S +11 R +2920(\257ag)S +3128(is)S +3245(set)S +3409(the)S +3585(circle)S +3869(will)S +4083(be)S +4228(\256lled)S +4497(with)S +4735(the)S +4911(marker)S +6240 V +900(color.)S +6420 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +6540 V +11 C +1175(int)S +1439(cdl_markCircle)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(int)S +3551(x,)S +3749(int)S +4013(y,)S +4211(int)S +4475(radius,)S +6660 V +1439(int)S +1703(fill,)S +2099(int)S +2363(color\))S +7920 V +EP +%%Page: 14 17 +BP +/slant 0 def +/height 1.000000 def +11 C +11 C +480 V +11 R +2936(- 14 -)S +840 V +11 B +900(5.5.5.)S +1215(Polyline)S +996 V +11 R +1175(The)S +11 B +1401(cdl_markPolyline\(\))S +11 R +2361(procedure)S +2853(is)S +2983(used)S +3240(to)S +3382(draw)S +3656(a)S +3760(line)S +3981(connecting)S +4518(the)S +11 I +4709(npts)S +11 R +4950(points)S +1116 V +900(speci\256ed)S +1323(by)S +1466(the)S +11 I +1633(xpts)S +11 R +1843(and)S +11 I +2034(ypts)S +11 R +2244(array)S +2500(in)S +2619(the)S +2786(desired)S +11 I +3135(color)S +11 R +3367(.)S +1296 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +1416 V +11 C +1175(int)S +1439(cdl_markPolyline)S +2561(\(CDLPtr)S +3089(cdl,)S +3419(int)S +3683(*xpts,)S +4145(int)S +4409(*ypts,)S +1536 V +1439(int)S +1703(npts,)S +2099(int)S +2363(color\))S +1776 V +11 B +900(5.5.6.)S +1215(Polygon)S +1932 V +11 R +1175(The)S +11 B +1390(cdl_markPolygon\(\))S +11 R +2339(procedure)S +2820(is)S +2939(used)S +3185(to)S +3316(draw)S +3579(a)S +3673(closed)S +3999(polygon)S +4406(consisting)S +4899(of)S +11 I +5036(npts)S +2052 V +11 R +900(vertices)S +1275(speci\256ed)S +1700(by)S +1845(the)S +11 I +2014(xpts)S +11 R +2226(and)S +11 I +2418(ypts)S +11 R +2629(array)S +2886(in)S +3006(the)S +3174(desired)S +11 I +3524(color)S +11 R +3756(.)S +3851(The)S +4055(last)S +4242(point)S +4503(in)S +4623(the)S +4791(array)S +5048(will)S +2172 V +900(automatically)S +1542(be)S +1689(connected)S +2176(to)S +2306(the)S +2484(\256rst)S +2700(point)S +2971(by)S +3125(the)S +3303(procedure.)S +3845(If)S +3962(the)S +11 I +4141(\256ll)S +11 R +4303(\257ag)S +4513(is)S +4632(set)S +4799(the)S +4978(circle)S +2292 V +900(will)S +1105(be)S +1241(\256lled)S +1501(with)S +1730(the)S +1897(marker)S +2239(color.)S +2472 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +2592 V +11 C +1175(int)S +1439(cdl_markPolygon)S +2495(\(CDLPtr)S +3023(cdl,)S +3353(int)S +3617(*xpts,)S +4079(int)S +4343(*ypts,)S +2712 V +1439(int)S +1703(npts,)S +2099(int)S +2363(fill,)S +2759(int)S +3023(color\))S +2952 V +11 B +900(5.5.7.)S +1215(Ellipse)S +3108 V +11 R +1175(The)S +11 B +1383(cdl_markEllipse\(\))S +11 R +2265(procedure)S +2739(is)S +2851(used)S +3091(to)S +3216(draw)S +3473(an)S +3615(ellipse)S +3941(of)S +4071(the)S +4244(speci\256ed)S +4673(color)S +4937(with)S +5172(a)S +3228 V +900(center)S +1207(at)S +1327(\()S +11 I +1363(x,y)S +11 R +1487(\))S +1563(and)S +1761(semimajor-axis)S +11 I +2478(xrad)S +11 R +2719(and)S +2917(semiminor-axis)S +11 I +3641(yrad)S +11 R +3882(pixels)S +4185(long.)S +4482(A)S +4601(rotation)S +4983(angle)S +3348 V +900(for)S +1063(the)S +1233(ellipse)S +1556(may)S +1781(be)S +1920(speci\256ed)S +2346(by)S +2492(passing)S +2858(a)S +2942(non-zero)S +11 I +3366(angle)S +11 R +3646(argument,)S +4124(the)S +4294(angle)S +4567(is)S +4678(measured)S +5134(in)S +3468 V +900(degrees)S +1276(from)S +1532(the)S +1709(positive)S +2101(x-axis.)S +2473(If)S +2587(the)S +11 I +2763(\256ll)S +11 R +2922(\257ag)S +3129(is)S +3245(set)S +3409(the)S +3585(circle)S +3869(will)S +4083(be)S +4228(\256lled)S +4497(with)S +4735(the)S +4911(marker)S +3588 V +900(color.)S +3768 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +3888 V +11 C +1175(int)S +1439(cdl_markEllipse)S +2495(\(CDLPtr)S +3023(cdl,)S +3353(int)S +3617(x,)S +3815(int)S +4079(y,)S +4277(int)S +4541(xrad,)S +4008 V +1439(int)S +1703(yrad,)S +2099(float)S +2495(ang,)S +2825(int)S +3089(fill,)S +3485(int)S +3749(color\))S +4248 V +11 B +900(5.5.8.)S +1215(Circular)S +1650(Annuli)S +4404 V +11 R +1175(The)S +11 B +1391(cdl_markCircAnnuli\(\))S +11 R +2494(procedure)S +2976(is)S +3096(used)S +3344(to)S +3477(draw)S +11 I +3742(nannuli)S +11 R +4126(circles)S +4458(separated)S +4917(by)S +11 I +5074(sep)S +4524 V +11 R +900(pixels)S +1196(each.)S +1489(The)S +1692(circle)S +1967(is)S +2074(centered)S +2476(at)S +2588(\()S +11 I +2624(x,y)S +11 R +2748(\))S +2817(with)S +3046(an)S +3182(initial)S +3473(radius)S +3774(of)S +11 I +3898(radius)S +11 R +4213(pixels.)S +4704 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +4824 V +11 C +1175(int)S +1439(cdl_markCircAnnuli)S +2693(\(CDLPtr)S +3221(cdl,)S +3551(int)S +3815(x,)S +4013(int)S +4277(y,)S +4475(int)S +4739(radius,)S +4944 V +1439(int)S +1703(nannuli,)S +2297(int)S +2561(sep,)S +2891(int)S +3155(color\))S +5184 V +11 B +900(5.5.9.)S +1215(Elliptical)S +1678(Annuli)S +5340 V +11 R +1175(The)S +11 B +1385(cdl_markEllipAnnuli\(\))S +11 R +2505(procedure)S +2981(is)S +3095(used)S +3336(to)S +3462(draw)S +11 I +3721(nannuli)S +11 R +4099(ellipses)S +4470(separated)S +4923(by)S +11 I +5074(sep)S +5460 V +11 R +900(pixels)S +1220(each.)S +1537(The)S +1764(ellipse)S +2108(is)S +2239(centered)S +2665(at)S +2801(\()S +11 I +2837(x,y)S +11 R +2961(\))S +3054(with)S +3307(an)S +3467(initial)S +3782(semimajor)S +4302(and)S +4516(semiminor)S +5043(axis)S +5580 V +900(speci\256ed)S +1335(by)S +1490(the)S +11 I +1669(xrad)S +11 R +1915(and)S +11 I +2118(yrad)S +11 R +2364(arguments.)S +2927(Each)S +3190(ellipse)S +3522(will)S +3739(be)S +3887(optionally)S +4379(rotate)S +4673(by)S +4828(an)S +11 I +4976(angle)S +5700 V +11 R +900(degrees)S +1266(as)S +1390(measured)S +1842(from)S +2088(the)S +2255(positive)S +2637(x-axis.)S +5880 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +6000 V +11 C +1175(int)S +1439(cdl_markEllipAnnuli)S +2759(\(CDLPtr)S +3287(cdl,)S +3617(x,)S +3815(y,)S +4013(xrad,)S +4409(yrad,)S +4805(ang,)S +6120 V +1439(int)S +1703(nannuli,)S +2297(int)S +2561(sep,)S +2891(int)S +3155(color\))S +6360 V +11 B +900(5.5.10.)S +1270(Text)S +6516 V +11 R +1175(The)S +11 B +1393(cdl_markText\(\))S +11 R +2178(procedure)S +2662(is)S +2784(used)S +3033(to)S +3167(draw)S +3433(a)S +3529(text)S +3742(string)S +4042(speci\256ed)S +4481(by)S +11 I +4640(str)S +11 R +4806(argument)S +6636 V +900(with)S +1142(an)S +1291(initial)S +1595(position)S +1997(at)S +2121(\()S +11 I +2157(x,y)S +11 R +2281(\))S +2362(and)S +2565(optionally)S +3057(rotated)S +3406(by)S +11 I +3561(angle)S +11 R +3850(degrees)S +4228(as)S +4364(measured)S +4828(from)S +5086(the)S +6756 V +900(positive)S +1288(x-axis.)S +1657(The)S +1867(default)S +11 I +2211(size)S +11 R +2416(is)S +2530(1.0)S +2708(and)S +2906(is)S +3020(approximately)S +3694(a)S +3782(6x13)S +4042(font,)S +4287(the)S +4461(font)S +4678(size)S +4888(may)S +5117(be)S +6876 V +900(scaled)S +1206(by)S +1349(any)S +1540(fractional)S +1992(amount.)S +7056 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +7176 V +11 C +1175(int)S +1439(cdl_markText)S +2297(\(CDLPtr)S +2825(cdl,)S +3155(int)S +3419(x,)S +3617(int)S +3881(y,)S +4079(char)S +4409(*str,)S +7296 V +1439(float)S +1835(size,)S +2231(float)S +2627(angle,)S +3089(int)S +3353(color\))S +7920 V +EP +%%Page: 15 18 +BP +/slant 0 def +/height 1.000000 def +11 C +11 C +480 V +11 R +2936(- 15 -)S +840 V +11 B +900(5.6.)S +1132(Text)S +1378(Fonts)S +996 V +11 R +1175(The)S +11 B +1382(cdl_setFont\(\))S +11 R +2034(procedure)S +2507(is)S +2618(used)S +2856(to)S +2979(choose)S +3320(between)S +3721(one)S +3917(of)S +4046(four)S +4266(available)S +4699(fonts)S +4957(as)S +5086(the)S +1116 V +900(text)S +1099(marker)S +1442(default:)S +1811(Roman,)S +2191(Greek,)S +2518(Futura,)S +2866(Bold)S +3114(and)S +3305(Times)S +3613(respectively.)S +4236(By)S +4398(default)S +4735(the)S +4902(Roman)S +1236 V +900(font)S +1110(will)S +1315(be)S +1451(used.)S +1713(The)S +1916(width)S +2200(of)S +2324(the)S +2491(lines)S +2732(used)S +2966(to)S +3085(draw)S +3336(the)S +3503(text)S +3701(may)S +3923(also)S +4133(be)S +4269(set.)S +1416 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +1536 V +11 C +1175(void)S +1505(cdl_setFont)S +2297(\(CDLPtr)S +2825(cdl,)S +3155(int)S +3419(font\))S +1656 V +1175(void)S +1505(cdl_setTextWidth)S +2627(\(CDLPtr)S +3155(cdl,)S +3485(int)S +3749(width\))S +1836 V +11 R +900(A)S +1023(complete)S +1469(listing)S +1790(of)S +1925(the)S +2103(Greek)S +2413(character)S +2856(mappings)S +3329(can)S +3525(be)S +3673(found)S +3974(in)S +4105(the)S +4284(\256le)S +4470('greek.ps')S +4955(in)S +5086(the)S +1956 V +900('doc')S +1173(subdirectory)S +1764(of)S +1898(the)S +2074(CDL)S +2336(distribution.)S +3223(The)S +11 I +3435(Roman)S +11 R +3788(font)S +4007(is)S +4123(the)S +4299(font)S +4518(implemented)S +5134(in)S +2076 V +900(the)S +1084(original)S +1476(version)S +1849(of)S +1990(the)S +2174(CDL)S +2444(and)S +2652(works)S +2970(well)S +3209(for)S +3386(most)S +3651(applications.)S +4294(Both)S +4560(the)S +11 I +4745(Greek)S +11 R +5062(and)S +2196 V +11 I +900(Times)S +11 R +1211(fonts)S +1479(are)S +1659(hi-resolution)S +2269(fonts)S +2537(which)S +2853(work)S +3126(best)S +3351(for)S +3526(larger)S +3828(frame)S +4130(bu)S +4240 H + (f)show 11 -.5 mul h (f)show +11 R +4307(ers)S +4482(but)S +4670(can)S +4868(produce)S +2316 V +900(publication)S +1429(quality)S +1769(text.)S +2029(The)S +11 I +2233(Futura)S +11 R +2573(font)S +2784(is)S +2892(a)S +2974(simpler)S +3338(font)S +3549(which)S +3852(can)S +4038(produce)S +4425(better)S +4709(results)S +5031(than)S +2436 V +900(the)S +1072(default)S +1414(on)S +1562(small)S +1839(size)S +2047(frame)S +2339(bu)S +2449 H + (f)show 11 -.5 mul h (f)show +11 R +2516(ers.)S +2742(A)S +11 I +2859(Bold)S +11 R +3105(font)S +3320(automatically)S +3956(increases)S +4394(the)S +4565(text)S +4767(line)S +4969(width)S +2556 V +900(by)S +1043(one)S +1234(pixel)S +1487(over)S +1714(the)S +1881(current)S +2223(setting)S +2550(and)S +2741(may)S +2963(be)S +3099(used)S +3333(with)S +3562(any)S +3753(font.)S +2796 V +11 B +900(5.6.1.)S +1215(In-Line)S +1604(Font)S +1857(Changes)S +2952 V +11 R +1175(Text)S +1421(markers)S +1818(are)S +1995(drawn)S +2314(using)S +2599(the)S +2779(font)S +3002(selected)S +3400(with)S +3642(the)S +11 I +3822(cdl_setFont\(\))S +11 R +4459(routine,)S +4844(however)S +3072 V +900(fonts)S +1174(may)S +1417(be)S +1573(change)S +1935(within)S +2270(a)S +2371(string)S +2675(itself)S +2948(\(e.g.)S +3196(to)S +3335(set)S +3510(a)S +3611(Greek)S +3930(character\))S +4417(using)S +4709(a)S +4810(\\f)S +4930(escape)S +3192 V +900(sequence.)S +1399(The)S +1608(escape)S +1937(is)S +2050(followed)S +2479(by)S +2628(the)S +2801(character)S +3238('R')S +3423(to)S +3548(set)S +3709(a)S +3796(Roman)S +4153(font,)S +4397('G')S +4587(for)S +4753(Greek,)S +5086('F')S +3312 V +900(for)S +1061(futura,)S +1384('B')S +1564(for)S +1725(bold)S +1954(and)S +2145('T')S +2317(for)S +2477(Times.)S +2846(Any)S +3068(number)S +3436(of)S +3560(escapes)S +3926(are)S +4091(permitted)S +4545(within)S +4860(a)S +4941(string,)S +3432 V +900(the)S +1071(font)S +1285(change)S +1631(will)S +1840(remain)S +2181(in)S +2304(e)S +2352 H + (f)show 11 -.5 mul h (f)show +11 R +2419(ect)S +2583(until)S +2823(it)S +2922(is)S +3033(changed,)S +3462(or)S +3590(the)S +3761(end)S +3956(of)S +4085(string)S +4374(at)S +4491(which)S +4797(point)S +5062(any)S +3552 V +900(subsequent)S +1431(strings)S +1768(will)S +1982(again)S +2261(be)S +2406(drawn)S +2721(with)S +2959(the)S +3135(default)S +3481(font.)S +3761(Additionally)S +4360(a)S +4450('P')S +4626(in)S +4754(the)S +4930(escape)S +3672 V +900(sequence)S +1333(will)S +1538(change)S +1880(the)S +2047(font)S +2257(to)S +2376(the)S +2543(one)S +2734(previously)S +3231(used,)S +3493(whatever)S +3926(that)S +4124(may)S +4346(be.)S +3828 V +1175(The)S +1382(CDL)S +1639(also)S +1853(supports)S +2263(a)S +2348(sub/superscripting)S +3191(of)S +3319(text)S +3521(which)S +3826(can)S +4014(only)S +4247(be)S +4387(done)S +4637(with)S +4871(the)S +5043(font)S +3948 V +900(escapes.)S +1337(In)S +1471(this)S +1674(case)S +1904(the)S +2081(escape)S +2414(character)S +2855(followed)S +3288(by)S +3441(a)S +3532('U')S +3726(produces)S +4164(a)S +4255(superscript)S +4779(and)S +4979(a)S +5069('D')S +4068 V +900(produces)S +1334(a)S +1421(subscript.)S +1918(The)S +2127(changes)S +2518(may)S +2746(be)S +2889(nested)S +3209(permitting)S +3708(several)S +4057(levels)S +4353(of)S +4484(sub/superscripts,)S +4188 V +900(these)S +1159(escapes)S +1526(may)S +1749(also)S +1960(be)S +2097(used)S +2332(in)S +2452(conjunction)S +3005(with)S +3235(a)S +3317(font)S +3528(change)S +3871(to)S +3991(cause)S +4267(the)S +4435(sub/superscript)S +5134(to)S +4308 V +900(be)S +1045(drawn)S +1360(with)S +1598(a)S +1688(di)S +1774 H + (f)show 11 -.5 mul h (f)show +11 R +1841(erent)S +2101(font.)S +2381(A)S +2502(superscript)S +3025(escape)S +3357(will)S +3571(remain)S +3917(in)S +4045(e)S +4093 H + (f)show 11 -.5 mul h (f)show +11 R +4160(ect)S +4329(until)S +4574(the)S +4751(end)S +4952(of)S +5086(the)S +4428 V +900(string)S +1188(or)S +1316(a)S +1401(\\fD)S +1584(escape)S +1911(is)S +2022(seen.)S +2314(Similarly)S +2762(a)S +2847(subscript)S +3281(remains)S +3665(in)S +3788(e)S +3836 H + (f)show 11 -.5 mul h (f)show +11 R +3903(ect)S +4067(until)S +4307(the)S +4478(end)S +4672(of)S +4799(the)S +4969(string)S +4548 V +900(of)S +1028(a)S +1113(\\fU)S +1296(escape.)S +1684(Sub/superscripted)S +2508(text)S +2710(is)S +2821(drawn)S +3131(using)S +3407(a)S +3492(smaller)S +3852(font)S +4066(size,)S +4302(there)S +4558(is)S +4670(presently)S +5110(no)S +4668 V +900(way)S +1115(to)S +1234(specify)S +1583(a)S +1664(di)S +1750 H + (f)show 11 -.5 mul h (f)show +11 R +1817(erent)S +2068(size)S +2271(for)S +2431(the)S +2598(sub/superscripted)S +3399(text.)S +4848 V +11 B +2436(Summary)S +2933(of)S +3057(Font)S +3310(Escapes)S +5028 V +11 R +2179(\\fR)S +2521(change)S +2863(to)S +2982(Roman)S +3333(font)S +5148 V +2179(\\fG)S +2521(change)S +2863(to)S +2982(Greek)S +3281(font)S +5268 V +2179(\\fF)S +2521(change)S +2863(to)S +2982(Futura)S +3302(font)S +5388 V +2179(\\fT)S +2521(change)S +2863(to)S +2982(Times)S +3290(font)S +5508 V +2179(\\fB)S +2521(change)S +2863(to)S +2982(bold)S +3211(font)S +5628 V +2179(\\fP)S +2521(change)S +2863(to)S +2982(previous)S +3393(font)S +5748 V +2179(\\fU)S +2521(begin)S +2798(relative)S +3159(superscripted)S +3776(text)S +5868 V +2179(\\fD)S +2521(begin)S +2798(relative)S +3159(subscripted)S +3692(text)S +6168 V +11 B +900(5.7.)S +1132(Line)S +1380(Widths)S +1757(and)S +1969(Styles)S +6324 V +11 R +1175(The)S +11 B +1407(cdl_setLineWidth\(\))S +11 R +2380(procedure)S +2878(can)S +3091(be)S +3256(used)S +3519(to)S +3667(set)S +3851(the)S +4047(line)S +4275(width)S +4589(used)S +4853(to)S +5002(draw)S +6444 V +900(polygon)S +1306(or)S +1442(polyline)S +1848(markers,)S +2273(point)S +2544(markers)S +2940(will)S +3156(not)S +3341(be)S +3488(a)S +3536 H + (f)show 11 -.5 mul h (f)show +11 R +3603(ected.)S +3938(The)S +11 B +4152(cdl_setLineStyle\(\))S +11 R +5038(pro-)S +6564 V +900(cedure)S +1223(is)S +1330(used)S +1564(to)S +1683(set)S +1838(a)S +1919(line)S +2117(style)S +2358(other)S +2616(than)S +2838(solid.)S +6744 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +6864 V +11 C +1175(void)S +1505(cdl_setLineWidth)S +2627(\(CDLPtr)S +3155(cdl,)S +3485(int)S +3749(width\))S +6984 V +1175(void)S +1505(cdl_setLineStyle)S +2627(\(CDLPtr)S +3155(cdl,)S +3485(int)S +3749(style\))S +7140 V +11 R +1175(The)S +1386(")S +11 I +1431(cdl.h)S +11 R +1648(")S +1734(include)S +2099(\256le)S +2282(for)S +2451(C)S +2567(programs,)S +3051(the)S +3227(")S +11 I +3272(cdlftn.inc)S +11 R +3685(")S +3772(include)S +4137(for)S +4306(fortran)S +4645(programs,)S +5129(or)S +7260 V +900(the)S +1075(")S +11 I +1120(cdlspp.h)S +11 R +1490(")S +1576(include)S +1940(\256le)S +2122(SPP)S +2349(programs,)S +2832(de\256nes)S +3184(the)S +3359(following)S +3828(symbolic)S +4273(constants)S +4723(for)S +4890(each)S +5129(of)S +7920 V +EP +%%Page: 16 19 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 16 -)S +840 V +900(the)S +1067(de\256ned)S +1423(line)S +1621(styles:)S +1020 V +11 B +1933(L_SOLID)S +11 R +2743(0)S +11 B +3293(L_DASHED)S +11 R +4132(1)S +1140 V +11 B +1933(L_DOTTED)S +11 R +2743(2)S +11 B +3293(L_DOTDASH)S +11 R +4132(3)S +1260 V +11 B +1933(L_HOLLOW)S +11 R +2743(4)S +11 B +3293(L_SHADOW)S +11 R +4132(5)S +1476 V +1175(The)S +11 I +1379(hollow)S +11 R +1714(line)S +1913(style)S +2155(is)S +2263(drawn)S +2571(with)S +2802(a)S +2885(linewidth)S +3336(of)S +3462(\256ve)S +3662(pixels,)S +3988(two)S +4188(pixels)S +4486(of)S +4612(color,)S +4900(a)S +4983(black)S +1596 V +900(line,)S +1132(and)S +1329(two)S +1533(pixels)S +1835(of)S +1965(color.)S +2290(It)S +2396(is)S +2509(best)S +2725(used)S +2965(when)S +3241(the)S +3414(marker)S +3761(will)S +3971(traverse)S +4354(extreme)S +4744(changes)S +5134(in)S +1716 V +900(brightness,)S +1414(due)S +1606(to)S +1726(the)S +1894(thickness)S +2337(of)S +2462(the)S +2630(line)S +2829(it)S +2925(may)S +3148(work)S +3407(best)S +3618(with)S +3848(larger)S +4137(frame)S +4426(bu)S +4536 H + (f)show 11 -.5 mul h (f)show +11 R +4603(ers.)S +4826(The)S +11 I +5031(sha-)S +1836 V +900(dow)S +11 R +1128(linestyle)S +1545(is)S +1663(drawn)S +1980(as)S +2115(two)S +2324(pixels)S +2631(of)S +2766(color)S +3035(and)S +3237(two)S +3445(pixels)S +3751(of)S +3885(black)S +4165(and)S +4366(should)S +4703(be)S +4849(used)S +5093(for)S +1956 V +900(similar)S +1240(brightness)S +1726(variations,)S +2221(however)S +2631(it)S +2727(e)S +2775 H + (f)show 11 -.5 mul h (f)show +11 R +2842(ectively)S +3223(shows)S +3532(up)S +3676(as)S +3802(a)S +3885(line)S +4085(only)S +4316(two)S +4516(pixels)S +4814(wide)S +5062(and)S +2076 V +900(may)S +1122(be)S +1258(preferred)S +1689(for)S +1849(medium)S +2243(or)S +2367(smaller)S +2723(frame)S +3010(bu)S +3120 H + (f)show 11 -.5 mul h (f)show +11 R +3187(ers.)S +2232 V +1175(The)S +1390(three)S +1654(dashed)S +2004(linestyles)S +2466(are)S +2644(drawn)S +2963(using)S +3248("gap")S +3542(spacings)S +3966(of)S +4103(5)S +4204(pixels)S +4513(in)S +4645(between)S +5055(line)S +2352 V +900(segments.)S +1405(Whether)S +1816(or)S +1942(not)S +2118(these)S +2378(gaps)S +2614(are)S +2781(resolved)S +3187(depends)S +3581(on)S +3726(the)S +3895(size)S +4100(of)S +4225(the)S +4393(frame)S +4681(bu)S +4791 H + (f)show 11 -.5 mul h (f)show +11 R +4858(er)S +4976(being)S +2472 V +900(used)S +1150(and)S +1358(the)S +1542(magni\256cation)S +2197(used)S +2448(in)S +2584(the)S +2768(display)S +3136(server.)S +3513(By)S +3692(default)S +4046(they)S +4285(should)S +4629(resolve)S +4995(com-)S +2592 V +900(pletely)S +1271(using)S +1582(frame)S +1908(bu)S +2018 H + (f)show 11 -.5 mul h (f)show +11 R +2085(ers)S +2284(up)S +2466(to)S +2624(1024x1024)S +3191(pixels,)S +3554(or)S +3717(magni\256cation)S +4393(factors)S +4761(displaying)S +2712 V +900(1024x1024)S +1428(pixels.)S +1785(If)S +1890(larger)S +2177(sizes)S +2423(are)S +2588(needed)S +2930(the)S +3097(image)S +3398(should)S +3725(be)S +3862(subsampled)S +4415(prior)S +4662(to)S +4782(display)S +5134(to)S +2832 V +900(maintain)S +1318(the)S +1485(marker)S +1827(resolution)S +2300(needed)S +2642(for)S +2802(these)S +3060(linestyles.)S +3192 V +11 B +900(5.8.)S +1132(Deleting)S +1555(Markers)S +3348 V +11 R +1175(When)S +1481(markers)S +1878(are)S +2055(drawn)S +2373(the)S +2552(underlying)S +3073(subraster)S +3514(is)S +3634(\256rst)S +3852(saved)S +4147(to)S +4279(an)S +4428(internal)S +4809(structure,)S +3468 V +900(erasure)S +1268(is)S +1396(done)S +1663(by)S +1827(simply)S +2181(redisplaying)S +2777(the)S +2964(saved)S +3266(raster.)S +3622(Problems)S +4091(can)S +4295(arise)S +4554(however)S +4983(when)S +3588 V +900(markers)S +1295(overlap;)S +1730(when)S +2010(deleting)S +2407(a)S +2498(marker)S +2850(that)S +3058(is)S +11 I +3175(under)S +11 R +3474(another)S +3845(marker)S +4198(the)S +4376(original)S +4762(pixels)S +5069(can)S +3708 V +900(overwrite)S +1372(the)S +1559(pixels)S +1875(of)S +2019(the)S +2206(marker)S +2568(on)S +2731(top.)S +2986(This)S +3235(is)S +3362(an)S +3517(unfortunate)S +4074(side)S +4303(e)S +4351 H + (f)show 11 -.5 mul h (f)show +11 R +4418(ect)S +4597(of)S +4740(the)S +4926(simple)S +3828 V +900(scheme)S +1268(used)S +1509(in)S +1635(this)S +1835(version)S +2198(of)S +2329(the)S +2503(package,)S +2928(users)S +3193(can)S +3384(call)S +3582(the)S +11 B +3757(cdl_redrawOverlay\(\))S +11 R +4784(procedure)S +3948 V +900(to)S +1019(help)S +1241(clean)S +1504(up)S +1647(any)S +1838(artifacts)S +2223(left)S +2402(behind.)S +4188 V +11 B +900(5.8.1.)S +1215(Individual)S +1742(Markers)S +4344 V +11 R +1175(The)S +11 B +1396(cdl_deleteMark\(\))S +11 R +2257(procedure)S +2745(is)S +2871(used)S +3124(to)S +3262(delete)S +3575(a)S +3675(single)S +3990(marker)S +4351(from)S +4616(the)S +4802(display\(\).)S +4464 V +900(The)S +1107(\()S +11 I +1143(x,y)S +11 R +1267(\))S +1340(argument)S +1791(is)S +1902(either)S +2188(the)S +2358(center)S +2660(position)S +3052(of)S +3179(the)S +3349(marker)S +3694(if)S +3797(that)S +3998(is)S +4108(know)S +4388(by)S +4534(the)S +4704(application,)S +4584 V +900(more)S +1162(typically)S +1584(it)S +1683(will)S +1893(be)S +2034(an)S +2175(approximate)S +2761(position.)S +3216(In)S +3345(the)S +3517(latter)S +3780(case)S +4005(the)S +4177(marker)S +4524(whose)S +4842(center)S +5146(is)S +4704 V +900(closest)S +1234(to)S +1355(this)S +1550(position)S +1941(will)S +2148(be)S +2286(deleted.)S +2698(For)S +2886(markers)S +3273(with)S +3504(no)S +3648(de\256ned)S +4005(center)S +4338(the)S +4506(distance)S +4899(used)S +5134(to)S +4824 V +900(decide)S +1220(if)S +1323(the)S +1493(marker)S +1838(should)S +2168(be)S +2307(deleted)S +2659(is)S +2769(the)S +2939(distance)S +3334(from)S +3583(the)S +3753(argument)S +4203(position)S +4595(to)S +4717(the)S +4887(edge)S +5129(of)S +4944 V +900(the)S +1075(marker.)S +1486(For)S +1680(example,)S +2120(distance)S +2520(from)S +2774(a)S +2863(box)S +3069(or)S +3201(polygon)S +3603(is)S +3718(measured)S +4177(as)S +4308(the)S +4482(distance)S +4881(from)S +5134(to)S +5064 V +900(one)S +1103(of)S +1239(the)S +1418(sides,)S +1711(for)S +1883(text)S +2093(it)S +2200(is)S +2319(the)S +2498(distance)S +2902(to)S +3033(the)S +3212(start)S +3446(of)S +3582(the)S +3761(text)S +3972(string.)S +4330(There)S +4630(is)S +4750(no)S +4906(way)S +5134(to)S +5184 V +11 I +900(un)S +11 R +1010(delete)S +1304(a)S +1385(marker)S +1727(other)S +1985(than)S +2207(to)S +2326(redraw)S +2661(it.)S +5364 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +5484 V +11 C +1175(int)S +1439(cdl_deleteMark)S +2429(\(CDLPtr)S +2957(cdl,)S +3287(int)S +3551(x,)S +3749(int)S +4013(y\))S +5724 V +11 B +900(5.8.2.)S +1215(The)S +1432(Entire)S +1764(Overlay)S +5880 V +11 R +1175(To)S +1337(erase)S +1600(all)S +1750(markers)S +2142(currently)S +2577(displayed)S +3039(use)S +3226(the)S +11 B +3401(cdl_clearOverlay\(\))S +11 R +4318(procedure.)S +4856(Markers)S +6000 V +900(are)S +1069(erased)S +1383(in)S +1505(the)S +1675(reverse)S +2025(order)S +2291(they)S +2516(were)S +2763(drawn)S +3072(to)S +3194(help)S +3419(reduce)S +3745(the)S +3915(chance)S +4253(that)S +4454(overlaying)S +4959(mark-)S +6120 V +900(ers)S +1060(will)S +1265(leave)S +1528(stray)S +1774(pixels.)S +6300 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +6420 V +11 C +1175(int)S +1439(cdl_clearOverlay)S +2561(\(CDLPtr)S +3089(cdl\))S +6660 V +11 B +900(5.9.)S +1132(Redraw)S +6816 V +11 R +1175(The)S +11 B +1389(cdl_redrawOverlay\(\))S +11 R +2419(procedure)S +2899(can)S +3094(be)S +3241(used)S +3486(to)S +3616(redraw)S +3963(all)S +4118(markers)S +4515(currently)S +4955(in)S +5086(the)S +6936 V +900(display)S +1271(list.)S +1520(This)S +1768(is)S +1894(sometimes)S +2417(needed)S +2778(when)S +3067(subraster)S +3514(I/O)S +3712(procedures)S +4243(are)S +4427(used)S +4680(to)S +4818(redisplay)S +7056 V +900(subregions)S +1409(and)S +1600(overwrite)S +2052(existing)S +2434(markers.)S +7236 V +900(Synopsis)S +11 Y1 +900(2)S +914(2222222)S +7920 V +EP +%%Page: 17 20 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 17 -)S +840 V +11 C +1175(int)S +1439(cdl_redrawOverlay)S +2627(\(CDLPtr)S +3155(cdl\))S +1080 V +11 B +900(6.)S +1049(ANSI)S +1345(C)S +1457(Function)S +1913(Prototypes)S +1236 V +11 R +1175(The)S +1387(current)S +1738(release)S +2082(of)S +2215(CDL)S +2477(provides)S +2897(full)S +3092(ANSI)S +3390(C)S +3506(function)S +3914(prototypes)S +4421(for)S +4591(all)S +4744(public)S +5062(and)S +1356 V +900(private)S +1244(procedures.)S +1824(By)S +1993(default)S +2337(these)S +2602(will)S +2814(not)S +2994(be)S +3136(used)S +3376(even)S +3621(on)S +3770(systems)S +4158(with)S +4393(native)S +4700(ANSI)S +4995(com-)S +1476 V +900(pilers,)S +1227(however.)S +1719(To)S +1896(make)S +2188(use)S +2389(of)S +2535(the)S +2724(CDL)S +3000(prototypes)S +3520(users)S +3801(will)S +4029(need)S +4291(to)S +4433(de\256ne)S +4757(the)S +4947(macro)S +1596 V +11 B +900(CDL_ANSIC)S +11 R +1566(either)S +1852(when)S +2126(compiling)S +2609(the)S +2779(program)S +3186(\(using)S +3497(the)S +3667(-D)S +3818(option)S +4136(to)S +4258(the)S +4428(compiler\),)S +4918(or)S +5045(as)S +5172(a)S +1716 V +900(de\256nition)S +1356(in)S +1475(the)S +1642(program)S +2046(source)S +2364(preceding)S +2828(the)S +2995('cdl.h')S +3317(include)S +3673(directive.)S +1872 V +1175(For)S +1361(example,)S +2052 V +11 C +1175(#define)S +1769(CDL_ANSIC)S +2172 V +1175(#include)S +1769("cdl.h")S +2292 V +1505(:)S +2412 V +1175(main)S +1505(\(int)S +1835(argc,)S +2231(char)S +2561(**argv\))S +2532 V +1505(:)S +2712 V +11 R +900(or)S +1024(when)S +1294(compiling)S +1774(using)S +2046(something)S +2538(like)S +2892 V +11 C +1175(cc)S +1373(-DCDL_ANSIC)S +2165(client.c)S +2759(libcdl.a)S +3353(-lm)S +3072 V +11 R +1175(Note)S +1424(that)S +1625(when)S +1898(using)S +2173(CDL_ANSIC)S +2814(to)S +2936(build)S +3199(the)S +3370(client)S +3651(program)S +4059(it)S +4158(is)S +4269(also)S +4483(required)S +4884(that)S +5086(the)S +3192 V +900(CDL)S +1163(itself)S +1426(be)S +1572(built)S +1818(in)S +1946(the)S +2122(same)S +2389(way)S +2613(to)S +2741(avoid)S +3027(confusing)S +3502(FPE)S +3735(errors.)S +4092(Similarly,)S +4573(when)S +4852(building)S +3312 V +900(client)S +1178(tasks)S +1432(that)S +11 I +1631(do)S +1775(not)S +11 R +1950(use)S +2130(CDL_ANSIC)S +2769(you)S +2968(must)S +3217(use)S +3397(a)S +3479(version)S +3836(of)S +3961(the)S +4130(library)S +4457(that)S +4657(has)S +4838(not)S +5014(been)S +3432 V +900(compiled)S +1342(with)S +1571(prototypes.)S +3588 V +1175(The)S +1378(reason)S +1696(is)S +1803(that)S +2001(the)S +2168(\257oat)S +2397(args)S +2612(to)S +2731(the)S +2898(CDL)S +3151(procedures)S +3663(in)S +3782(the)S +3949(library,)S +4302(or)S +4426(in)S +4545(your)S +4780(task)S +4991(calls,)S +3708 V +900(are)S +1071(promoted)S +1531(to)S +1656(doubles)S +2037(when)S +2313(compiling)S +2799(those)S +3070(procedures,)S +3616(but)S +3796(may)S +4023(only)S +4257(be)S +4398(passed)S +4728(as)S +4857(\257oats)S +5134(in)S +3828 V +900(your)S +1134(code)S +1373(\(or)S +1533(as)S +1657(double)S +1989(where)S +2288(the)S +2455(CDL)S +2709(is)S +2817(expecting)S +3277(\257oat\).)S +3571(This)S +3801(means)S +4115(the)S +4283(argument)S +4731(stack)S +4990(is)S +5098(o)S +5153 H + (f)show 11 -.5 mul h (f)show +11 R +3948 V +900(by)S +1045(4)S +1135(bytes)S +1402(for)S +1564(each)S +1798(\257oat)S +2029(arg)S +2203(and)S +2396(the)S +2565(values)S +2880(interpreted)S +3389(by)S +3534(the)S +3703(CDL)S +3958(procedure)S +4429(will)S +4636(be)S +4773(corrupted.)S +4068 V +900(If)S +1031(you're)S +1376(going)S +1687(to)S +1833(use)S +2039(the)S +2233(prototypes)S +2757(you'll)S +3080(need)S +3346(to)S +3492(edit)S +3717(the)S +3911(CDL)S +4191(Imake\256le)S +4665(to)S +4811(de\256ne)S +5139("-)S +4188 V +900(DCDL_ANSIC")S +1665(in)S +1787(the)S +1957(EXTRA_DEFINES)S +2865(so)S +2998(it)S +3095(will)S +3302(use)S +3483(the)S +3652(prototypes)S +4151(and)S +4344(everything)S +4848(will)S +5055(line)S +4308 V +900(up.)S +1104(You)S +1326(will)S +1531(then)S +1753(need)S +1992(to)S +2111(rebuild)S +2455(the)S +2622(libcdl.a)S +2982(as)S +3106(well)S +3328(as)S +3452(relink)S +3741(your)S +3975(program.)S +4548 V +11 B +900(7.)S +1049(Fortran)S +1453(Language)S +1952(Binding)S +2362(Notes)S +4704 V +11 R +1175(The)S +1396(Fortran)S +1770(language)S +2216(binding)S +2604(routines)S +3009(are)S +3193(implemented)S +3819(in)S +3957(C)S +4083(but)S +4276(should)S +4622(be)S +4777(accessible)S +4824 V +900(from)S +1155(any)S +1355(fortran)S +1694(program)S +2107(as)S +2240(though)S +2588(they)S +2819(were)S +3072(real)S +3277(fortran)S +3616(subroutines.)S +4226(The)S +4437(calling)S +4777(sequences)S +4944 V +900(are)S +1065(the)S +1232(same)S +1490(as)S +1614(with)S +1843(the)S +2010(C)S +2117(library)S +2442(routines)S +2829(with)S +3058(the)S +3225(following)S +3686(exceptions:)S +5100 V +11 Y1 +1150(d)S +11 R +1289(The)S +1500(CDL)S +1761(package)S +2159(pointer)S +2511(is)S +2626(maintained)S +3155(internally)S +3617(so)S +3756(no)S +3907('cdl')S +4155(pointer)S +4508(is)S +4624(passed)S +4958(in)S +5086(the)S +5220 V +1150(fortran)S +1480(interface.)S +5376 V +11 Y1 +1150(d)S +11 R +1289(All)S +1471(routines)S +1866(which)S +2175(are)S +2348(integer)S +2693(procedures)S +3213(in)S +3340(the)S +3515(C)S +3630(interface)S +4053(return)S +4356(an)S +4501(extra)S +4761('ier')S +4990(argu-)S +5496 V +1150(ment)S +1403(to)S +1522(contain)S +1878(the)S +2045(error)S +2289(\257ag.)S +2548(All)S +2722(Fortran)S +3078(functions)S +3520(are)S +3685(implemented)S +4292(as)S +4416(subroutines.)S +5652 V +11 Y1 +1150(d)S +11 R +1281(The)S +1485(procedure)S +1955(names)S +2269(are)S +2435(the)S +2603(same)S +2862(except)S +3181(that)S +11 I +3380(cdl_)S +11 R +3603(has)S +3783(been)S +4023(replaced)S +4426(with)S +11 I +4656(cf)S +11 R +4769(in)S +4889(the)S +5057(for-)S +5772 V +1150(tran)S +1353(binding.)S +1784(If)S +1889(your)S +2123(compiler)S +2546(is)S +2653(case-sensitive)S +3294(then)S +3516(use)S +3695(all)S +3838(lower)S +4120(case)S +4340(letters.)S +5928 V +900(The)S +1117(binding)S +1501(has)S +1695(been)S +1949(tested)S +2253(on)S +2411(a)S +2507(number)S +2890(of)S +3029(di)S +3115 H + (f)show 11 -.5 mul h (f)show +11 R +3182(erent)S +3448(platforms)S +3917(without)S +4302(problems.)S +4820(The)S +5038(pro-)S +6048 V +900(cedure)S +1243(names)S +1576(haven't)S +1957(been)S +2216(restricted)S +2676(to)S +2815(the)S +3002(traditional)S +3506(6-character)S +4047(fortran)S +4396(names)S +4728(since)S +5005(most)S +6168 V +900(modern)S +1278(compilers)S +1754(can)S +1948(handle)S +2283(longer)S +2606(names,)S +2957(if)S +3067(yours)S +3354(isn't)S +3593(one)S +3794(of)S +3929(them)S +4193(contact)S +11 I +4553(iraf@noao.edu)S +6288 V +11 R +900(for)S +1060(help)S +1282(in)S +1401(changing)S +1836(the)S +2003(names.)S +6444 V +1175(Since)S +1456(the)S +1627(CDL)S +1884(is)S +1995(implemented)S +2606(as)S +2734(a)S +2819(set)S +2978(of)S +3106(C)S +3217(routines,)S +3637(the)S +3809(one)S +4005(aspect)S +4316(that)S +4519(cannot)S +4849(be)S +4990(over-)S +6564 V +900(looked)S +1245(in)S +1377(the)S +1557(fortran)S +1900(binding)S +2283(is)S +2403(the)S +2583(between)S +2993(Fortran)S +3362(and)S +3566(C)S +3686(storage)S +4048(order)S +4324(for)S +4497(arrays.)S +4869(In)S +5005(most)S +6684 V +900(cases)S +1166(this)S +1362(will)S +1570(not)S +1747(be)S +1886(a)S +1970(problem)S +2372(since)S +2633(the)S +2803(CDL)S +3059(routines)S +3449(are)S +3617(just)S +3813(passing)S +4179(around)S +4519(pointers)S +4910(even)S +5153(if)S +6804 V +900(they)S +1136(live)S +1348(for)S +1522(a)S +1617(short)S +1884(while)S +2174(in)S +2306(a)S +2400(fortran)S +2743(program.)S +3221(The)S +3437(problem)S +3849(comes)S +4175(when)S +4458(using)S +4743(the)S +4923(fortran)S +6924 V +900(program)S +1313(to)S +1441(read)S +1670(the)S +1846(arrays,)S +2183(for)S +2353(example)S +2767(in)S +2896(using)S +3178(the)S +3355(array)S +3621(returned)S +4028(by)S +4181(the)S +11 B +4358(cfreadIRAF\(\))S +11 R +5038(pro-)S +7044 V +900(cedure,)S +1254(or)S +1381(when)S +1654(passing)S +2020(in)S +2142(arrays)S +2444(for)S +2607(display)S +2961(that)S +3162(originated)S +3643(in)S +3765(the)S +3935(user's)S +4232(fortran)S +4565(code.)S +4868(In)S +4995(these)S +7164 V +900(cases)S +1179(the)S +1362(array)S +11 B +1634(must)S +11 R +1915(be)S +2067(transposed)S +2585(to)S +2720(be)S +2872(interpreted)S +3395(correctly.)S +3893(It)S +4009(was)S +4228(assumed)S +4655(that)S +4869(in)S +5005(most)S +7284 V +900(applications)S +1481(arrays)S +1797(returned)S +2211(by)S +2371(CDL)S +2641(procedures)S +3170(would)S +3495(be)S +3648(immediately)S +4248(passed)S +4590(to)S +4726(other)S +5000(CDL)S +7920 V +EP +%%Page: 18 21 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 18 -)S +840 V +900(procedures)S +1415(so)S +1549(having)S +1885(the)S +2056(binding)S +2430(routines)S +2821(transpose)S +3272(the)S +3443(array)S +3703(to/from)S +4070(Fortran)S +4430(storage)S +4783(order)S +5050(was)S +960 V +900(unnecessarily)S +1529(ine)S +1663 H + (f)show 11 -.5 mul h (\256)show +11 R +1755(cient.)S +2062(This)S +2291(may)S +2513(be)S +2649(changed)S +3046(in)S +3165(later)S +3392(releases)S +3770(if)S +3870(required.)S +1320 V +11 B +900(8.)S +1049(SPP)S +1278(Language)S +1777(Binding)S +2187(Notes)S +1476 V +11 R +1175(The)S +1390(SPP)S +1621(language)S +2061(binding)S +2443(is)S +2562(experimental)S +3179(and)S +3382(is)S +3501(intended)S +3924(to)S +4055(provide)S +4436(a)S +4530(way)S +4758(to)S +4890(quickly)S +1596 V +900(prototype)S +1356(tasks,)S +1639(it)S +1736(should)S +2065(not)S +2241(be)S +2379(used)S +2615(in)S +2736(production)S +3247(code)S +3488(as)S +3614(it)S +3711(may)S +3935(not)S +4111(be)S +4249(as)S +4375(portable)S +4769(as)S +4894(the)S +5062(rest)S +1716 V +900(of)S +1033(the)S +1209(task.)S +1489(In)S +1622(essence)S +1997(this)S +2200(binding)S +2580(is)S +2697(a)S +2788(layer)S +3049(on)S +3202(top)S +3386(of)S +3520(the)S +3697(Fortran)S +4063(binding)S +4443(since)S +4711(most)S +4969(IRAF)S +1836 V +900(platforms)S +1357(still)S +1560(use)S +1742(Fortran)S +2101(as)S +2228(the)S +2398(intermediate)S +2982(code.)S +3285(The)S +3490(calling)S +3824(sequences)S +4302(are)S +4469(the)S +4638(same)S +4898(as)S +5024(with)S +1956 V +900(the)S +1067(Fortran)S +1423(library)S +1748(routines)S +2135(with)S +2364(the)S +2531(following)S +2992(caveats:)S +2112 V +11 Y1 +1150(d)S +11 R +1290(The)S +1502('cdlspp.h')S +1986(SPP)S +2214(include)S +2579(\256le)S +2762(is)S +2878(required)S +3284(by)S +3437(all)S +3590(\256les)S +3817(which)S +4128(call)S +4329(CDL)S +4592(routines.)S +5050(The)S +2232 V +1150(binding)S +1535(names)S +1863(are)S +2043(actually)S +2438(SPP)S +2672(macros)S +3036(to)S +3170(resolve)S +3534(the)S +3716(current)S +4073(6)S +4176(character)S +4622(limit)S +4880(on)S +5038(pro-)S +2352 V +1150(cedure)S +1473(names.)S +2508 V +11 Y1 +1150(d)S +11 R +1287(All)S +1467(character)S +1904(string)S +2194(arguments)S +2690(must)S +2944(be)S +3086(dimensioned)S +3687(to)S +3812(at)S +3930(least)S +4170(SZ_FNAME)S +4779(characters)S +2628 V +1150(in)S +1269(length.)S +2784 V +11 Y1 +1150(d)S +11 R +1289(The)S +1500(CDL)S +1761(package)S +2159(pointer)S +2511(is)S +2626(maintained)S +3155(internally)S +3617(so)S +3756(no)S +3907('cdl')S +4155(pointer)S +4508(is)S +4624(passed)S +4958(in)S +5086(the)S +2904 V +1150(fortran)S +1480(interface.)S +3060 V +11 Y1 +1150(d)S +11 R +1289(All)S +1471(routines)S +1866(which)S +2175(are)S +2348(integer)S +2693(procedures)S +3213(in)S +3340(the)S +3515(C)S +3630(interface)S +4053(return)S +4356(an)S +4501(extra)S +4761('ier')S +4990(argu-)S +3180 V +1150(ment)S +1403(to)S +1522(contain)S +1878(the)S +2045(error)S +2289(\257ag.)S +2548(All)S +2722(SPP)S +2941(functions)S +3383(are)S +3548(implemented)S +4155(as)S +4279(subroutines.)S +3336 V +11 Y1 +1150(d)S +11 R +1293(On)S +1472(HPUX)S +1816(or)S +1952(IBM)S +2205(RS6000)S +2606(systems)S +3001(the)S +3181('cdlspp.h')S +3669(\256le)S +3856(must)S +4117(be)S +4266(edited)S +4580(to)S +4712(remove)S +5086(the)S +3456 V +1150(trailing)S +1507(underscores)S +2068(from)S +2320(the)S +2493(procedure)S +2968(name)S +3244(macros.)S +3659(This)S +3893(is)S +4005(because)S +4388(on)S +4536(these)S +4799(platforms)S +3576 V +1150(the)S +1319(fortran)S +1652(compiler)S +2078(will)S +2286(not)S +2463(append)S +2815(an)S +2954(underscore)S +3469(to)S +3591(the)S +3761(SPP)S +3983(symbols)S +4387(as)S +4514(it)S +4612(does)S +4849(on)S +4995(other)S +3696 V +1150(platforms.)S +4056 V +11 B +900(9.)S +1049(IIS)S +1230(Protocol)S +1658(Description)S +4212 V +11 R +1175(The)S +1383(communications)S +2148(protocol)S +2552(used)S +2791(by)S +2939(the)S +3111(CDL)S +3369(and)S +3565(servers)S +3913(such)S +4153(as)S +11 I +4283(XImtool)S +11 R +4676(and)S +11 I +4873(SAOim-)S +4332 V +900(age)S +11 R +1058(,)S +1121(is)S +1230(a)S +1313(slightly)S +1679(modi\256ed)S +2105(version)S +2462(of)S +2587(that)S +2786(used)S +3021(by)S +3165(the)S +3333(IIS)S +3501(Model)S +3822(70.)S +4027(All)S +4202(operations)S +4693(are)S +4859(initiated)S +4452 V +900(by)S +1051(sending)S +1434(a)S +1523(header)S +1855(packet)S +2182(containing)S +2688(a)S +11 I +2778(thing)S +3047(id)S +11 R +3175(\(tid\))S +3406(and)S +11 I +3606(subunit)S +11 R +3973(selecting)S +4405(the)S +4581(function)S +4989(to)S +5117(be)S +4572 V +900(performed,)S +1429(optionally)S +1922(followed)S +2358(by)S +2514(data)S +2742(up)S +2897(to)S +3028(32K)S +3262(bytes)S +3539(long.)S +3841(The)S +4056(IIS)S +4235(header)S +4570(packet)S +4900(used)S +5146(is)S +4692 V +900(de\256ned)S +1256(as)S +4812 V +11 C +1450(struct)S +1978(iism70)S +2440({)S +4932 V +1725(short)S +2253(tid;)S +5052 V +1725(short)S +2253(thingct;)S +5172 V +1725(short)S +2253(subunit;)S +5292 V +1725(short)S +2253(checksum;)S +5412 V +1725(short)S +2253(x,)S +2451(y,)S +2649(z;)S +5532 V +1725(short)S +2253(t;)S +5652 V +1450(};)S +5892 V +11 R +900(The)S +11 I +1109(thing)S +1375(count)S +11 R +1658(\256eld)S +1893(contains)S +2299(the)S +2473(negative)S +2884(number)S +3259(of)S +3390(bytes)S +3662(of)S +3793(data)S +4015(that)S +4220(will)S +4432(be)S +4575(sent)S +4792(following)S +6012 V +900(the)S +1067(header)S +1390(packet.)S +1769(The)S +1972(IIS)S +2139(header)S +2462(checksum)S +2933(is)S +3040(computed)S +3506(as)S +6252 V +11 C +1164(checksum)S +1758(=)S +1890(0177777)S +2418(-)S +2550(\(tid)S +2880(+)S +3012(subunit)S +3540(+)S +3672(thingct)S +4200(+)S +4332(x)S +4464(+)S +4596(y)S +4728(+)S +4860(z)S +4992(+)S +5124(t\);)S +6492 V +11 R +900(The)S +1112(four)S +1336(IIS)S +1512(registers)S +1925(are)S +2099(set)S +2263(di)S +2349 H + (f)show 11 -.5 mul h (f)show +11 R +2416(erently)S +2762(depending)S +3261(on)S +3414(the)S +3591(operation,)S +4076(a)S +4167(summary)S +4619(of)S +4753(the)S +4930(header)S +6612 V +900(packets)S +1261(for)S +1421(each)S +1653(operation)S +2100(is)S +2207(summarized)S +2776(below.)S +7920 V +EP +%%Page: 19 22 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 19 -)S +840 V +11 B +2373(IIS)S +2554(Header)S +2934(Packet)S +3283(Summary)S +1020 V +11 R +2296(TID)S +3291(Subunit)S +4061(Tct)S +4394(X)S +4638(Y)S +4933(Z)S +5268(T)S +5575(Data)S +1030 V +11 Y1 +1805(2)S +1845(2222222222222222222222222222222222222222222222222222222222222222222222222)S +1150 V +11 R +900(Read)S +1158(Data)S +1887(IIS_READ)S +11 B +2375(|)S +11 R +2399(PACKED)S +3052(MEMORY)S +4040(-NB)S +4406(x)S +4650(y)S +4882(fr)S +5217(-)S +5552(NB)S +1270 V +900(Write)S +1182(Data)S +1887(IIS_WRITE)S +11 B +2423(|)S +11 R +2447(PACKED)S +3052(MEMORY)S +4040(-NB)S +4406(x)S +4650(y)S +4882(fr)S +5217(-)S +5552(NB)S +1390 V +900(Read)S +1158(Cursor)S +1887(IIS_READ)S +3052(IMCURSOR)S +4116(-)S +4415(-)S +4659(-)S +4882(-)S +5217(-)S +5552(-)S +1510 V +900(Write)S +1182(Cursor)S +1887(IIS_WRITE)S +3052(IMCURSOR)S +4116(-)S +4406(x)S +4650(y)S +4882(wcs)S +5217(-)S +5552(-)S +1630 V +900(Set)S +1074(Frame)S +1887(IIS_WRITE)S +3052(LUT)S +11 B +3265(|)S +11 R +3289(COMMAND)S +4089(-1)S +4415(-)S +4659(-)S +4882(-)S +5217(-)S +5552(2)S +1750 V +900(Erase)S +1175(Frame)S +1887(IIS_WRITE)S +11 B +2456(|)S +11 R +2513(fb)S +3052(FEEDBACK)S +4116(-)S +4415(-)S +4659(-)S +4882(fr)S +5217(-)S +5552(-)S +1990 V +900(Old)S +1098(Write)S +1380(WCS)S +1887(IIS_WRITE)S +11 B +2423(|)S +11 R +2447(PACKED)S +3052(WCS)S +4077(-N)S +4415(-)S +4659(-)S +4882(fr)S +5217(fb)S +5552(320)S +2110 V +900(Old)S +1098(Read)S +1356(WCS)S +1887(IIS_READ)S +3052(WCS)S +4116(-)S +4415(-)S +4659(-)S +4882(fr)S +5217(wcs)S +5552(320)S +2350 V +900(WCS)S +1172(Version?)S +1887(IIS_READ)S +3052(WCS)S +4116(-)S +4406(1)S +4650(1)S +4882(-)S +5217(-)S +5552(320)S +2470 V +900(WCS)S +1172(by)S +1315(Number?)S +1887(IIS_READ)S +3052(WCS)S +4116(-)S +4406(1)S +4659(-)S +4882(fr)S +5217(wcs)S +5552(1024)S +2590 V +900(New)S +1139(Write)S +1421(WCS)S +1887(IIS_WRITE)S +11 B +2423(|)S +11 R +2447(PACKED)S +3052(WCS)S +4077(-N)S +4406(1)S +4659(-)S +4882(fr)S +5217(fb)S +5552(1024)S +2710 V +900(New)S +1139(Read)S +1397(WCS)S +1887(IIS_READ)S +3052(WCS)S +4116(-)S +4406(1)S +4659(-)S +4882(fr)S +5217(wcs)S +5552(1024)S +2720 V +11 Y1 +1805(2)S +1845(2222222222222222222222222222222222222222222222222222222222222222222222222)S +1804(1)S +2680 V +1804(1)S +2570 V +1804(1)S +2460 V +1804(1)S +2350 V +1804(1)S +2240 V +1804(1)S +2130 V +1804(1)S +2020 V +1804(1)S +1910 V +1804(1)S +1800 V +1804(1)S +1690 V +1804(1)S +1580 V +1804(1)S +1470 V +1804(1)S +1360 V +1804(1)S +1250 V +1804(1)S +1140 V +1804(1)S +2720 V +2969(1)S +2680 V +2969(1)S +2570 V +2969(1)S +2460 V +2969(1)S +2350 V +2969(1)S +2240 V +2969(1)S +2130 V +2969(1)S +2020 V +2969(1)S +1910 V +2969(1)S +1800 V +2969(1)S +1690 V +2969(1)S +1580 V +2969(1)S +1470 V +2969(1)S +1360 V +2969(1)S +1250 V +2969(1)S +1140 V +2969(1)S +2720 V +3957(1)S +2680 V +3957(1)S +2570 V +3957(1)S +2460 V +3957(1)S +2350 V +3957(1)S +2240 V +3957(1)S +2130 V +3957(1)S +2020 V +3957(1)S +1910 V +3957(1)S +1800 V +3957(1)S +1690 V +3957(1)S +1580 V +3957(1)S +1470 V +3957(1)S +1360 V +3957(1)S +1250 V +3957(1)S +1140 V +3957(1)S +2720 V +4311(1)S +2680 V +4311(1)S +2570 V +4311(1)S +2460 V +4311(1)S +2350 V +4311(1)S +2240 V +4311(1)S +2130 V +4311(1)S +2020 V +4311(1)S +1910 V +4311(1)S +1800 V +4311(1)S +1690 V +4311(1)S +1580 V +4311(1)S +1470 V +4311(1)S +1360 V +4311(1)S +1250 V +4311(1)S +1140 V +4311(1)S +2720 V +4555(1)S +2680 V +4555(1)S +2570 V +4555(1)S +2460 V +4555(1)S +2350 V +4555(1)S +2240 V +4555(1)S +2130 V +4555(1)S +2020 V +4555(1)S +1910 V +4555(1)S +1800 V +4555(1)S +1690 V +4555(1)S +1580 V +4555(1)S +1470 V +4555(1)S +1360 V +4555(1)S +1250 V +4555(1)S +1140 V +4555(1)S +2720 V +4799(1)S +2680 V +4799(1)S +2570 V +4799(1)S +2460 V +4799(1)S +2350 V +4799(1)S +2240 V +4799(1)S +2130 V +4799(1)S +2020 V +4799(1)S +1910 V +4799(1)S +1800 V +4799(1)S +1690 V +4799(1)S +1580 V +4799(1)S +1470 V +4799(1)S +1360 V +4799(1)S +1250 V +4799(1)S +1140 V +4799(1)S +2720 V +5134(1)S +2680 V +5134(1)S +2570 V +5134(1)S +2460 V +5134(1)S +2350 V +5134(1)S +2240 V +5134(1)S +2130 V +5134(1)S +2020 V +5134(1)S +1910 V +5134(1)S +1800 V +5134(1)S +1690 V +5134(1)S +1580 V +5134(1)S +1470 V +5134(1)S +1360 V +5134(1)S +1250 V +5134(1)S +1140 V +5134(1)S +2720 V +5469(1)S +2680 V +5469(1)S +2570 V +5469(1)S +2460 V +5469(1)S +2350 V +5469(1)S +2240 V +5469(1)S +2130 V +5469(1)S +2020 V +5469(1)S +1910 V +5469(1)S +1800 V +5469(1)S +1690 V +5469(1)S +1580 V +5469(1)S +1470 V +5469(1)S +1360 V +5469(1)S +1250 V +5469(1)S +1140 V +5469(1)S +2720 V +5860(1)S +2680 V +5860(1)S +2570 V +5860(1)S +2460 V +5860(1)S +2350 V +5860(1)S +2240 V +5860(1)S +2130 V +5860(1)S +2020 V +5860(1)S +1910 V +5860(1)S +1800 V +5860(1)S +1690 V +5860(1)S +1580 V +5860(1)S +1470 V +5860(1)S +1360 V +5860(1)S +1250 V +5860(1)S +1140 V +5860(1)S +2960 V +11 R +900(Where)S +1355(NB)S +2218(=)S +2313(number)S +2681(of)S +2805(bytes)S +3070(expected)S +3491(or)S +3615(written)S +3080 V +1355(x)S +2218(=)S +2313(x)S +2401(position)S +2790(of)S +2914(operation)S +3361(in)S +3480(frame)S +3767(bu)S +3877 H + (f)show 11 -.5 mul h (f)show +11 R +3944(er)S +4061(coords)S +3200 V +1355(y)S +2218(=)S +2313(y)S +2401(position)S +2790(of)S +2914(operation)S +3361(in)S +3480(frame)S +3767(bu)S +3877 H + (f)show 11 -.5 mul h (f)show +11 R +3944(er)S +4061(coords)S +3320 V +1355(fr)S +2218(=)S +2313(frame)S +2600(number)S +2968(\(passed)S +3329(as)S +3453(bit\257ag)S +3768(\(i.e.)S +3972(1,)S +4088(2)S +4176(,4)S +4292(8,)S +4408(etc\))S +3440 V +1355(fb)S +2218(=)S +2313(frame)S +2600(bu)S +2710 H + (f)show 11 -.5 mul h (f)show +11 R +2777(er)S +2894(con\256g)S +3202(number)S +3570(\(zero)S +3826(indexed\))S +3560 V +1355(N)S +2218(=)S +2313(length)S +2621(of)S +2745(WCS)S +3017(string)S +3680 V +1355(wcs)S +2218(=)S +2313(WCS)S +2585(number)S +2953(\(usually)S +3340(zero\))S +3800 V +1355(Data)S +2218(=)S +2313(the)S +2480(number)S +2848(of)S +2972(bytes)S +3237(of)S +3361(data)S +3576(to)S +3695(be)S +3831(read)S +4051(or)S +4175(written)S +4519(following)S +4980(the)S +5147(header)S +5470(packet.)S +4040 V +1355(IIS_WRITE)S +2251(=)S +2346(0400000)S +4160 V +1355(IIS_READ)S +2251(=)S +2346(0100000)S +4280 V +1355(COMMAND)S +2251(=)S +2346(0100000)S +4400 V +1355(PACKED)S +2251(=)S +2346(0040000)S +4520 V +1355(IMC_SAMPLE)S +2251(=)S +2346(0040000)S +4760 V +1355(MEMORY)S +2251(=)S +2346(001)S +4880 V +1355(LUT)S +2251(=)S +2346(002)S +5000 V +1355(FEEDBACK)S +2251(=)S +2346(005)S +5120 V +1355(IMCURSOR)S +2251(=)S +2346(020)S +5240 V +1355(WCS)S +2251(=)S +2346(021)S +5456 V +900(TID)S +1119(\256elds)S +1395(can)S +1583(be)S +1723(logically)S +2145(OR'd)S +2426(with)S +2659(the)S +2830(PACKED)S +3307(\257ag)S +3509(indicating)S +3986(the)S +4157(number)S +4529(of)S +4657(data)S +4876(bytes)S +5146(is)S +5576 V +900(exactly)S +11 I +1252(thingct)S +11 R +1594(bytes)S +1862(long,)S +2122(otherwise)S +11 I +2584(thingct)S +11 R +2926(must)S +3177(be)S +3316(speci\256ed)S +3742(as)S +3869(half)S +4075(the)S +4245(number)S +4616(of)S +4743(data)S +4960(bytes.)S +5696 V +900(In)S +1028(a)S +1113(cursor)S +1423(read,)S +1675(if)S +1779(the)S +1951(IIS_READ)S +2477(\257ag)S +2680(is)S +2792(OR'd)S +3074(with)S +3308(IMC_SAMPLE)S +4044(the)S +4216(logical)S +4553(cursor)S +4864(position)S +5816 V +900(\(i.e.)S +1153(the)S +1336(last)S +1538(value)S +1824(read)S +2060(or)S +2200(set\))S +2407(is)S +2530(returned)S +2943(immediately,)S +3570(otherwise)S +4044(the)S +4226(server)S +4540(will)S +4760(wait)S +4997(for)S +5172(a)S +5936 V +900(keystroke)S +1366(to)S +1492(be)S +1635(hit)S +1792(before)S +2110(returning)S +2552(a)S +2640(string)S +2932(containing)S +3437(the)S +3612(\(x,y\))S +3863(position,)S +4288(wcs)S +4499(of)S +4631(the)S +4806(read,)S +5062(and)S +6056 V +900(the)S +1072(keystroke.)S +1597(When)S +1896(setting)S +2228(the)S +2400(frame)S +2692(you)S +2895(must)S +3148(send)S +3387(a)S +3473(short)S +3731(integer)S +4072(in)S +4195(the)S +4366(data)S +4585(containing)S +5086(the)S +6176 V +900(frame)S +1187(selected.)S +6536 V +11 B +900(10.)S +1104(VXIMTOOL)S +1761(Proxy/Display)S +2461(Server)S +2803(Usage)S +6692 V +11 I +900(VXIMTOOL)S +11 R +1481(is)S +1593(a)S +1679(image)S +1986(display)S +2343(server)S +2648(process)S +3015(much)S +3298(like)S +11 I +3502(XIMTOOL)S +11 R +3978(,)S +4045(except)S +4369(that)S +4573(all)S +4722(it)S +4823(normally)S +6812 V +900(does)S +1139(is)S +1251(respond)S +1636(to)S +1760(datastream)S +2272(requests)S +2669(to)S +2793(read)S +3018(and)S +3214(write)S +3477(to)S +3600(internal)S +3972(frame)S +4263(bu)S +4373 H + (f)show 11 -.5 mul h (f)show +11 R +4440(ers)S +4604(maintained)S +5129(as)S +6932 V +900(arrays)S +1201(in)S +1322(memory.)S +1784(Multiple)S +2199(frame)S +2488(bu)S +2598 H + (f)show 11 -.5 mul h (f)show +11 R +2665(ers)S +2827(and)S +3020(frame)S +3309(bu)S +3419 H + (f)show 11 -.5 mul h (f)show +11 R +3486(er)S +3605(con\256gurations)S +4269(are)S +4436(supported.)S +4966(It)S +5069(can)S +7052 V +900(be)S +1038(used)S +1274(to)S +1395(debug)S +1698(CDL)S +1953(programs)S +2402(by)S +2547(printing)S +2931(out)S +3107(the)S +3276(protocol)S +3677(packets)S +4040(received,)S +4472(or)S +4597(can)S +4782(simply)S +5117(be)S +7172 V +900(used)S +1148(as)S +1286(a)S +1381(dummy)S +1766(server)S +2080(in)S +2214(cases)S +2492(where)S +2806(no)S +2964(image)S +3280(display)S +3646(is)S +3768(really)S +4065(needed.)S +4483(By)S +4660(enabling)S +5086(the)S +7292 V +11 I +900(-proxy)S +11 R +1219(\257ag)S +1418(the)S +1585(server)S +1884(can)S +2068(also)S +2278(be)S +2414(used)S +2648(to)S +2767(repeat)S +3066(the)S +3233(datastream)S +3740(requests)S +4132(to)S +4251(a)S +4332(list)S +4501(of)S +4625(other)S +4883(servers,)S +7920 V +EP +%%Page: 20 23 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 20 -)S +840 V +900(e)S +948 H + (f)show 11 -.5 mul h (f)show +11 R +1015(ectively)S +1399(splitting)S +1799(the)S +1970(image)S +2275(display)S +2630(to)S +2753(a)S +2838(number)S +3210(of)S +3338(other)S +3600(servers.)S +4007(See)S +4202(the)S +11 I +4373(vximtool)S +11 R +4788(man)S +5014(page)S +960 V +900(for)S +1060(details)S +1380(on)S +1523(other)S +1781(command-line)S +2448(arguments)S +2938(and)S +3129(usage.)S +1116 V +900(The)S +1116(program)S +1533(was)S +1749(originally)S +2223(intended)S +2647(as)S +2785(a)S +2880(debugging)S +3391(tool,)S +3638(either)S +3934(in)S +4067(the)S +4248(development)S +4862(of)S +5000(CDL)S +1236 V +900(clients)S +1233(directly)S +1614(or)S +1751(in)S +1883(cases)S +2159(where)S +2471(the)S +2651(display)S +3015(may)S +3249(need)S +3500(to)S +3631(go)S +3786(to)S +3917(separate)S +4319(screens)S +4685(as)S +4821(part)S +5036(of)S +5172(a)S +1356 V +900(larger)S +1207(project.)S +1625(For)S +1832(example,)S +2285(engineers)S +2758(may)S +3001(wish)S +3263(to)S +3403("eavesdrop")S +3990(on)S +4154(the)S +4342(system)S +4702(by)S +4866(viewing)S +1476 V +900(images)S +1249(displayed)S +1708(by)S +1856(CDL)S +2114(clients)S +2439(used)S +2678(as)S +2807(part)S +3015(of)S +3144(a)S +3230(data)S +3449(acquisition)S +3969(system.)S +4373(It)S +4477(can)S +4665(also)S +4879(be)S +5019(used)S +1596 V +900(as)S +1036(a)S +1129(memory-only)S +1772(display)S +2135(server)S +2446(for)S +2618(CDL)S +2883(clients)S +3215(which)S +3529(need)S +3781(to)S +3913(be)S +4062(run)S +4254(in)S +4386(the)S +4566(background)S +5129(as)S +1716 V +900(part)S +1103(of)S +1227(a)S +1308(pipeline)S +1695(processing)S +2197(system)S +2536(requiring)S +2971(a)S +3052(frame)S +3339(bu)S +3449 H + (f)show 11 -.5 mul h (f)show +11 R +3516(er)S +3633(for)S +3793(image)S +4094(marking.)S +1872 V +900(In)S +1031(proxy)S +1327(mode)S +1611(the)S +1785(program)S +2197(acts)S +2408(as)S +2540(a)S +2629(relay)S +2888(for)S +3056(the)S +3231(IIS)S +3406(datastream)S +3921(packets,)S +4318(sending)S +4701(image)S +5010(data,)S +1992 V +900(frame)S +1188(requests,)S +1609(etc.)S +1798(to)S +1918(a)S +2000(list)S +2169(of)S +2293(other)S +2551(servers)S +2893(speci\256ed)S +3316(on)S +3459(the)S +3626(command)S +4092(line.)S +4351(The)S +4554(e)S +4602 H + (f)show 11 -.5 mul h (f)show +11 R +4669(ect)S +4829(of)S +4953(this)S +5146(is)S +2112 V +900(to)S +1027(allow)S +1312(a)S +1402(client)S +1688(to)S +1816(display)S +2176(to)S +2304(this)S +2506(program)S +2919(which)S +3229(then)S +3460(re-displays)S +3983(to)S +4111(each)S +4352(of)S +4485(the)S +4661(other)S +4928(named)S +2232 V +900(servers.)S +1289(Of)S +1456(course)S +1793(CDL)S +2065(clients)S +2404(can)S +2607(also)S +2836(do)S +2998(this)S +3210(internally)S +3683(by)S +3844(opening)S +4249(multiple)S +4668(connections,)S +2352 V +900(using)S +11 I +1185(vximtool)S +11 R +1609(in)S +1741(proxy)S +2044(mode)S +2335(adds)S +2583(the)S +2764(functionality)S +3373(to)S +3506(programs)S +3967(which)S +4282(may)S +4518(use)S +4711(this)S +4918(feature)S +2472 V +900(only)S +1132(ocasionally.)S +1729(A)S +1844(maximum)S +2327(of)S +2453(8)S +2543(servers)S +2887(may)S +3111(be)S +3249(named,)S +3604(they)S +3828(may)S +4052(be)S +4190(either)S +4474(on)S +4619(the)S +4788(local)S +5036(host)S +2592 V +900(or)S +1024(a)S +1105(remote)S +1442(machine)S +1846(and)S +2037(connections)S +2594(can)S +2779(be)S +2916(established)S +3438(using)S +3711(either)S +3994(\256fos)S +4224(or)S +4349(sockets.)S +4767(See)S +4959(above)S +2712 V +900(or)S +1024(the)S +11 I +1191(vximtool)S +11 R +1602(man)S +1824(page)S +2063(for)S +2223(details)S +2543(on)S +2686(how)S +2908(to)S +3027(specify)S +3376(the)S +3543(server)S +3842(connection.)S +2868 V +900(The)S +1103(current)S +1445(implementation)S +2169(has)S +2348(a)S +2429(few)S +2625(restrictions)S +3146(users)S +3404(should)S +3731(keep)S +3970(in)S +4089(mind:)S +3024 V +11 Y1 +1150(d)S +11 R +1288(The)S +1498(time)S +1734(to)S +1860(display)S +2218(an)S +2361(image)S +2669(or)S +2801(perform)S +3194(any)S +3393(output)S +3716(operation)S +4171(scales)S +4473(with)S +4710(the)S +4885(number)S +3144 V +1150(of)S +1285(connected)S +1772(hosts.)S +2104(Each)S +2366(IIS)S +2544(packet)S +2873(is)S +2991(forwarded)S +3483(to)S +3612(each)S +3854(host)S +4081(in)S +4210(turn)S +4430(before)S +4751(processing)S +3264 V +1150(the)S +1317(next)S +1539(input)S +1799(packet,)S +2145(and)S +2336(connection)S +2850(over)S +3077(a)S +3158(slow)S +3399(network)S +3791(will)S +3996(delay)S +4266(the)S +4433(entire)S +4715(process.)S +3420 V +11 Y1 +1150(d)S +11 R +1298(Cursor)S +1647(and)S +1855(image)S +2173(readback)S +2616(are)S +2799(done)S +3063(by)S +3224(sending)S +3617(the)S +3802(request)S +11 I +4169(only)S +11 R +4409(to)S +4546(the)S +4731(\256rst)S +4954(server)S +3540 V +1150(named)S +1483(on)S +1634(the)S +1809(command)S +2283(line.)S +2550(This)S +2787(is)S +2902(done)S +3156(to)S +3283(avoid)S +3568(forcing)S +3925(a)S +4014(cursor)S +4327(mode)S +4611(on)S +4761(all)S +4911(servers)S +3660 V +1150(which)S +1455(cannot)S +1784(be)S +1924(terminated)S +2430(when)S +2705(a)S +2791(response)S +3212(is)S +3324(received)S +3731(from)S +3982(only)S +4216(one)S +4412(server,)S +4744(and)S +4940(means)S +3780 V +1150(that)S +1365(the)S +1549(\256rst)S +1771(server)S +2087(named)S +2429(should)S +2773(be)S +2926(the)S +3110(one)S +3318(used)S +3569(to)S +3705(control)S +4066(interactive)S +4578(sessions.)S +5050(The)S +3900 V +1150(remaining)S +1648(servers)S +2010(however)S +2439(can)S +2643(still)S +2863(respond)S +3263(to)S +3403(cursor)S +3730(requests)S +4143(from)S +4410(other)S +4689(applications)S +4020 V +1150(connected)S +1626(to)S +1745(that)S +1943(server)S +2242(on)S +2385(another)S +2746(channel.)S +4176 V +11 Y1 +1150(d)S +11 R +1282(All)S +1457(named)S +1783(servers)S +2126(must)S +2375(be)S +2513(running)S +2890(prior)S +3138(to)S +3259(starting)S +3624(the)S +3793(proxy)S +4084(server.)S +4413(The)S +4618(connection)S +5134(to)S +4296 V +1150(the)S +1321(remote)S +1661(servers)S +2006(is)S +2116(established)S +2640(when)S +2913(this)S +3109(task)S +3322(is)S +3432(\256rst)S +3640(run)S +3822(and)S +4016(if)S +4119(no)S +4265(server)S +4567(is)S +4677(running)S +5055(that)S +4416 V +1150(connection)S +1687(will)S +1915(be)S +2074(ignored.)S +2493(The)S +2719(task)S +2952(will)S +3180(exit)S +3401(if)S +3524(no)S +3690(remote)S +4050(servers)S +4415(can)S +4622(be)S +4781(found)S +5093(for)S +4536 V +1150(display.)S +4692 V +11 Y1 +1150(d)S +11 R +1295(Any)S +1531(connected)S +2021(server)S +2334(that)S +2546(shuts)S +2820(down)S +3111(while)S +3402(the)S +3583(proxy)S +3887(server)S +4201(is)S +4323(running)S +4713(is)S +4835(likely)S +5134(to)S +4812 V +1150(cause)S +1425(the)S +1592(program)S +1996(to)S +2115(crash)S +2378(on)S +2521(the)S +2688(next)S +2910(display.)S +7920 V +EP +%%Page: 21 24 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 21 -)S +840 V +11 B +900(11.)S +1104(C)S +1216(Interface)S +1673(Summary)S +996 V +11 R +1260(#include)S +1704(")S +11 B +1749(cdl.h)S +11 R +1980(")S +1296 V +1537(CDLPtr)S +11 B +1919(cdl_open)S +11 R +2507(\(imtdev\))S +1416 V +1504(int)S +11 B +1654(cdl_displayPix)S +11 R +2507(\(cdl,)S +2738(pix,)S +2940(nx,)S +3111(ny,)S +3282(bitpix,)S +3601(frame,)S +3916(fbcon\256g,)S +4343(zscale\))S +1536 V +1378(char)S +11 B +1598(cdl_readCursor)S +11 R +2507(\(cdl,)S +2738(sample,)S +3110(x,)S +3226(y,)S +3342(wcs,)S +3573(key\))S +1656 V +1534(int)S +11 B +1684(cdl_setCursor)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(wcs\))S +1776 V +1618(int)S +11 B +1768(cdl_setWCS)S +11 R +2507(\(cdl,)S +2738(name,)S +3036(title,)S +3269(a,)S +3378(b,)S +3494(c,)S +3603(d,)S +3719(tx,)S +3866(ty,)S +4013(z1,)S +4177(z2,)S +4341(zt\))S +1896 V +1606(int)S +11 B +1756(cdl_getWCS)S +11 R +2507(\(cdl,)S +2738(name,)S +3036(title,)S +3269(a,)S +3378(b,)S +3494(c,)S +3603(d,)S +3719(tx,)S +3866(ty,)S +4013(z1,)S +4177(z2,)S +4341(zt\))S +2016 V +1481(void)S +11 B +1710(cdl_setFrame)S +11 R +2507(\(cdl,)S +2738(frame\))S +2136 V +1457(int)S +11 B +1607(cdl_clearFrame)S +11 R +2507(\(cdl\))S +2256 V +1692(void)S +11 B +1921(cdl_close)S +11 R +2507(\(cdl\))S +2496 V +1439(int)S +11 B +1589(cdl_setMapping)S +11 R +2507(\(cdl,)S +2738(region,)S +3079(sx,sy,snx,sny,)S +3726(dx,dy,dnx,dny,)S +4421(ref\))S +2616 V +1427(int)S +11 B +1577(cdl_getMapping)S +11 R +2507(\(cdl,)S +2738(region,)S +3079(sx,sy,snx,sny,)S +3726(dx,dy,dnx,dny,)S +4421(ref\))S +2736 V +1501(int)S +11 B +1651(cdl_queryMap)S +11 R +2507(\(cdl,)S +2738(wcs,)S +2969(region,)S +3310(sx,sy,snx,sny,)S +3957(dx,dy,dnx,dny,)S +4652(objref\))S +2976 V +1389(int)S +11 B +1539(cdl_displayIRAF)S +11 R +2507(\(cdl,)S +2738(fname,)S +3072(band,)S +3346(frame,)S +3661(fbcon\256g,)S +4088(zscale\))S +3096 V +1654(int)S +11 B +1804(cdl_isIRAF)S +11 R +2507(\(fname\))S +3216 V +1515(int)S +11 B +1665(cdl_readIRAF)S +11 R +2507(\(fname,)S +2877(band,)S +3151(pix,)S +3353(nx,)S +3524(ny,)S +3695(bitpix,)S +4014(title\))S +3456 V +1411(int)S +11 B +1561(cdl_displayFITS)S +11 R +2507(\(cdl,)S +2738(fname,)S +3072(frame,)S +3387(fbcon\256g,)S +3814(zscale\))S +3576 V +1676(int)S +11 B +1826(cdl_isFITS)S +11 R +2507(\(fname\))S +3696 V +1537(int)S +11 B +1687(cdl_readFITS)S +11 R +2507(\(fname,)S +2877(pix,)S +3079(nx,)S +3250(ny,)S +3421(bitpix,)S +3740(title\))S +3936 V +1216(void)S +11 B +1445(cdl_computeZscale)S +11 R +2507(\(cdl,)S +2738(pix,)S +2940(nx,)S +3111(ny,)S +3282(bitpix,)S +3601(z1,)S +3765(z2\))S +4056 V +1352(void)S +11 B +1581(cdl_zscaleImage)S +11 R +2507(\(cdl,)S +2738(pix,)S +2940(nx,)S +3111(ny,)S +3282(bitpix,)S +3601(z1,)S +3765(z2\))S +4296 V +1604(int)S +11 B +1754(cdl_printPix)S +11 R +2507(\(cdl,)S +2738(cmd,)S +2988(pix,)S +3190(nx,)S +3361(ny,)S +3532(annotate\))S +4416 V +1298(int)S +11 B +1448(cdl_printPixToFile)S +11 R +2507(\(cdl,)S +2738(fname,)S +3072(pix,)S +3274(nx,)S +3445(ny,)S +3616(annotate\))S +4656 V +1491(int)S +11 B +1641(cdl_readImage)S +11 R +2507(\(cdl,)S +2738(pix,)S +2940(nx,)S +3111(ny\))S +4776 V +1175(int)S +11 B +1325(cdl_readFrameBu)S +2179 H + (f)show 11 -.5 mul h (f)show +11 B +2246(er)S +11 R +2507(\(cdl,)S +2738(pix,)S +2940(nx,)S +3111(ny\))S +4896 V +1288(int)S +11 B +1438(cdl_readSubRaster)S +11 R +2507(\(cdl,)S +2738(lx,)S +2885(ly,)S +3032(nx,)S +3203(ny,)S +3374(pix\))S +5016 V +1259(int)S +11 B +1409(cdl_writeSubRaster)S +11 R +2507(\(cdl,)S +2738(lx,)S +2885(ly,)S +3032(nx,)S +3203(ny,)S +3374(pix\))S +5256 V +1522(void)S +11 B +1751(cdl_selectFB)S +11 R +2507(\(cdl,)S +2738(nx,)S +2909(ny,)S +3080(fb,)S +3232(w,)S +3372(h,)S +3488(nf,)S +3640(reset\))S +5376 V +1336(void)S +11 B +1565(cdl_setFBCon\256g)S +11 R +2507(\(cdl,)S +2738(con\256gno\))S +5496 V +1324(void)S +11 B +1553(cdl_getFBCon\256g)S +11 R +2507(\(cdl,)S +2738(con\256gno,)S +3184(w,)S +3324(h,)S +3440(nf\))S +5616 V +1260(void)S +11 B +1489(cdl_lookupFBSize)S +11 R +2507(\(cdl,)S +2738(con\256gno,)S +3184(w,)S +3324(h,)S +3440(nf\))S +5856 V +1434(void)S +11 B +1663(cdl_setZTrans)S +11 R +2507(\(cdl,)S +2738(ztrans\))S +5976 V +1472(void)S +11 B +1701(cdl_setZScale)S +11 R +2507(\(cdl,)S +2738(z1,)S +2902(z2\))S +6096 V +1441(void)S +11 B +1670(cdl_setSample)S +11 R +2507(\(cdl,)S +2738(nsample\))S +6216 V +1183(void)S +11 B +1412(cdl_setSampleLines)S +11 R +2507(\(cdl,)S +2738(nlines\))S +6336 V +1376(void)S +11 B +1605(cdl_setContrast)S +11 R +2507(\(cdl,)S +2738(contrast\))S +6456 V +1517(void)S +11 B +1746(cdl_setName)S +11 R +2507(\(cdl,)S +2738(imname\))S +6576 V +1570(void)S +11 B +1799(cdl_setTitle)S +11 R +2507(\(cdl,)S +2738(imtitle\))S +6816 V +1469(void)S +11 B +1698(cdl_getFrame)S +11 R +2507(\(cdl,)S +2738(frame\))S +6936 V +1422(void)S +11 B +1651(cdl_getZTrans)S +11 R +2507(\(cdl,)S +2738(ztrans\))S +7056 V +1460(void)S +11 B +1689(cdl_getZScale)S +11 R +2507(\(cdl,)S +2738(z1,)S +2902(z2\))S +7176 V +1429(void)S +11 B +1658(cdl_getSample)S +11 R +2507(\(cdl,)S +2738(nsample\))S +7296 V +1171(void)S +11 B +1400(cdl_getSampleLines)S +11 R +2507(\(cdl,)S +2738(nlines\))S +7920 V +EP +%%Page: 22 25 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 22 -)S +840 V +1364(void)S +11 B +1593(cdl_getContrast)S +11 R +2507(\(cdl,)S +2738(contrast\))S +960 V +1505(void)S +11 B +1734(cdl_getName)S +11 R +2507(\(cdl,)S +2738(imname\))S +1080 V +1558(void)S +11 B +1787(cdl_getTitle)S +11 R +2507(\(cdl,)S +2738(imtitle\))S +1320 V +1479(int)S +11 B +1629(cdl_mapFrame)S +11 R +2507(\(cdl,)S +2738(frame\))S +1440 V +1221(int)S +11 B +1371(cdl_markCoordsFile)S +11 R +2507(\(cdl,)S +2738(fname,)S +3072(type,)S +3322(size,)S +3553(color,)S +3839(label\))S +1560 V +1489(int)S +11 B +1639(cdl_markPoint)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(number,)S +3366(size,)S +3597(type,)S +3847(color\))S +1680 V +1219(int)S +11 B +1369(cdl_markPointLabel)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(label,)S +3244(size,)S +3475(type,)S +3725(color\))S +1800 V +1525(int)S +11 B +1675(cdl_markLine)S +11 R +2507(\(cdl,)S +2738(xs,)S +2897(ys,)S +3056(xe,)S +3220(ye,)S +3384(color\))S +1920 V +1556(int)S +11 B +1706(cdl_markBox)S +11 R +2507(\(cdl,)S +2738(lx,)S +2885(ly,)S +3032(ux,)S +3203(uy,)S +3374(\256ll,)S +3559(color\))S +2040 V +1360(int)S +11 B +1510(cdl_markPolygon)S +11 R +2507(\(cdl,)S +2738(xarray,)S +3077(yarray,)S +3416(npts,)S +3661(\256ll,)S +3846(color\))S +2160 V +1360(int)S +11 B +1510(cdl_markPolyline)S +11 R +2507(\(cdl,)S +2738(xarray,)S +3077(yarray,)S +3416(npts,)S +3661(color\))S +2280 V +1455(int)S +11 B +1605(cdl_markCircle)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(radius,)S +3299(\256ll,)S +3484(color\))S +2400 V +1207(int)S +11 B +1357(cdl_markCircAnnuli)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(radius,)S +3299(nannuli,)S +3690(sep,)S +3897(color\))S +2520 V +1420(int)S +11 B +1570(cdl_markEllipse)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(xrad,)S +3225(yrad,)S +3480(rotang,)S +3821(\256ll,)S +4006(color\))S +2640 V +1184(int)S +11 B +1334(cdl_markEllipAnnuli)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(xrad,)S +3225(yrad,)S +3480(ang,)S +3699(nannuli,)S +4090(sep,)S +4297(color\))S +2760 V +1527(int)S +11 B +1677(cdl_markText)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y,)S +2970(str,)S +3141(size,)S +3372(angle,)S +3670(color\))S +2880 V +1649(int)S +11 B +1799(cdl_setFont)S +11 R +2507(\(cdl,)S +2738(font\))S +3000 V +1355(int)S +11 B +1505(cdl_setTextWidth)S +11 R +2507(\(cdl,)S +2738(width\))S +3120 V +1353(int)S +11 B +1503(cdl_setLineWidth)S +11 R +2507(\(cdl,)S +2738(width\))S +3240 V +1422(int)S +11 B +1572(cdl_setLineStyle)S +11 R +2507(\(cdl,)S +2738(style\))S +3360 V +1455(int)S +11 B +1605(cdl_deleteMark)S +11 R +2507(\(cdl,)S +2738(x,)S +2854(y\))S +3480 V +1355(int)S +11 B +1505(cdl_clearOverlay)S +11 R +2507(\(cdl\))S +3600 V +1245(int)S +11 B +1395(cdl_redrawOverlay)S +11 R +2507(\(cdl\))S +7920 V +EP +%%Page: 23 26 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 23 -)S +840 V +11 B +900(12.)S +1104(C)S +1216(Example)S +1665(Tasks)S +996 V +11 R +1175(The)S +1381(examples)S +1831(shown)S +2154(here)S +2377(are)S +2545(for)S +2708(demonstration)S +3374(purposes)S +3801(only.)S +4095(They)S +4357(are)S +4526(based)S +4812(on)S +4959(work-)S +1116 V +900(ing)S +1079(example)S +1488(tasks)S +1746(in)S +1870(the)S +2042(CDL)S +2300(source)S +11 I +2622(examples)S +11 R +3066(subdirectory,)S +3679(see)S +3855(the)S +4026(programs)S +4477(there)S +4732(for)S +4896(the)S +5067(full)S +1236 V +900(program)S +1304(listing.)S +1596 V +11 B +900(12.1.)S +1187(Display)S +1576(Example)S +1832 V +9 C +900(#include)S +1386(<stdio.h>)S +1932 V +900(#include)S +1386(<unistd.h>)S +2032 V +900(#include)S +1386("cdl.h")S +2232 V +900(/*)S +9 I +1116(DISPLAY)S +1493(--)S +1580(Example)S +1922(task)S +2094(to)S +2191(display)S +2478(an)S +2595(image)S +2842(as)S +2949(a)S +3021(command-line)S +3563(task.)S +2332 V +954(*)S +1053(This)S +1235(task)S +1407(is)S +1494(meant)S +1741(to)S +1838(show)S +2050(three)S +2262(ways)S +2469(the)S +2606(CDL)S +2808(can)S +2965(be)S +3077(used)S +3269(to)S +3366(display)S +2432 V +954(*)S +1053(an)S +1170(image,)S +1440(see)S +1582(the)S +1719(code)S +1916(comments)S +2303(for)S +2435(a)S +2507(description)S +2939(of)S +3036(each)S +3233(method.)S +2532 V +954(*)S +2632 V +954(*)S +1053(Examples:)S +2732 V +954(*)S +1161(To)S +1283(display)S +1570(a)S +1642(simple)S +1904(IRAF)S +2126(or)S +2233(FITS)S +2440(\256le:)S +2832 V +954(*)S +1283(%)S +1385(./display)S +1720(-frame)S +1987(2)S +2059(image.imh)S +2932 V +954(*)S +1242(%)S +1344(./display)S +1679(image.\256ts)S +3032 V +954(*)S +3132 V +954(*)S +1161(To)S +1283(display)S +1570(a)S +1642(FITS)S +1849(\256le)S +1986(as)S +2093(a)S +2165(raw)S +2332(image:)S +3232 V +954(*)S +1269(%)S +1371(./display)S +1706(-nx)S +1848(512)S +2010(-ny)S +2152(512)S +2314(-depth)S +2571(16)S +2688(-hskip)S +2935(5760)S +3142(-raw)S +3339(dpix.\256ts)S +3332 V +954(*)S +3432 V +954(*)S +1053(Usage:)S +3532 V +954(*)S +1175(display)S +1462([-depth)S +1754(N])S +1876([-\256ts])S +2108([-frame)S +2410(N])S +2532([-fbcon\256g)S +2914(N])S +3036([-hskip)S +3318(N])S +3632 V +954(*)S +1283([-iraf])S +1540([-nozscale])S +1977([-nx)S +2154(N])S +2276([-ny)S +2453(N])S +2575([-raw])S +2842([-zscale])S +3189(\256le)S +3732 V +9 C +954(*/)S +3932 V +900(#define)S +1332(NONE)S +1725(-1)S +4032 V +900(#define)S +1450(IRAF)S +1779(0)S +4132 V +900(#define)S +1450(FITS)S +1779(1)S +4232 V +900(#define)S +1450(RAW)S +1779(2)S +4432 V +900(main)S +1170(\(argc,)S +1548(argv\))S +4532 V +900(int)S +1175(argc;)S +4632 V +900(char)S +1175(*argv[];)S +4732 V +900({)S +4832 V +1175(CDLPtr)S +1725(cdl;)S +4932 V +1175(char)S +1450(*fname,)S +1882(title[128];)S +5032 V +1175(int)S +1450(i,)S +1612(status)S +1990(=)S +2098(0,)S +2260(frame)S +2584(=)S +2692(1,)S +2854(fbconfig)S +3340(=)S +3448(0,)S +3610(zscale)S +3988(=)S +4096(1;)S +5132 V +1175(int)S +1450(format)S +1828(=)S +1936(NONE,)S +2260(nx)S +2422(=)S +2530(0,)S +2692(ny)S +2854(=)S +2962(0,)S +3124(depth)S +3448(=)S +3556(8,)S +3718(hskip)S +4042(=)S +4150(0;)S +5232 V +1175(float)S +1725(z1,)S +1941(z2;)S +5332 V +1175(int)S +1450(fb_w,)S +1774(fb_h,)S +2098(nf;)S +5432 V +1175(unsigned)S +1661(char)S +1931(*pix)S +2201(=)S +2309(NULL;)S +5632 V +1175(/*)S +9 I +1337(Process)S +1649(the)S +1786(command)S +2163(line)S +2325(options.)S +9 C +2667(*/)S +5732 V +1175(if)S +1337(\(argc)S +1661(>)S +1769(1\))S +1931({)S +5832 V +1391(for)S +1607(\(i=1;)S +1931(i)S +2039(<)S +2147(argc;)S +2471(i++\))S +2741({)S +5932 V +1548(if)S +1710(\(strcmp)S +2142(\(argv[i],)S +2682("-depth"\))S +3222(==)S +3384(0\))S +3978(depth)S +4302(=)S +4410(atoi)S +4680(\(argv[++i]\);)S +6032 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-fits"\))S +3438(==)S +3600(0\))S +3978(format)S +4356(=)S +4464(FITS;)S +6132 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-frame"\))S +3492(==)S +3654(0\))S +3978(frame)S +4302(=)S +4410(atoi)S +4680(\(argv[++i]\);)S +6232 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-fbconfig"\))S +3654(==)S +3816(0\))S +3978(fbconfig)S +4464(=)S +4572(atoi)S +4842(\(argv[++i]\);)S +6332 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-hskip"\))S +3492(==)S +3654(0\))S +3978(hskip)S +4302(=)S +4410(atoi)S +4680(\(argv[++i]\);)S +6432 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-iraf"\))S +3438(==)S +3600(0\))S +3978(format)S +4356(=)S +4464(IRAF;)S +6532 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-nozscale"\))S +3654(==)S +3816(0\))S +3978(zscale)S +4356(=)S +4464(0;)S +6632 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-nx"\))S +3330(==)S +3492(0\))S +3978(nx)S +4140(=)S +4248(atoi)S +4518(\(argv[++i]\);)S +6732 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-ny"\))S +3330(==)S +3492(0\))S +3978(ny)S +4140(=)S +4248(atoi)S +4518(\(argv[++i]\);)S +6832 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-raw"\))S +3384(==)S +3546(0\))S +3978(format)S +4356(=)S +4464(RAW;)S +6932 V +1548(else)S +1818(if)S +1980(\(strcmp)S +2412(\(argv[i],)S +2952("-zscale"\))S +3546(==)S +3708(0\))S +3978(zscale)S +4356(=)S +4464(1;)S +7032 V +1391(})S +7132 V +1175(})S +7920 V +EP +%%Page: 24 27 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +460 V +11 R +2936(- 24 -)S +820 V +9 C +1175(/*)S +9 I +1337(Open)S +1559(the)S +1696(package)S +2023(and)S +2185(a)S +2257(connection)S +2679(to)S +2776(the)S +2913(server.)S +9 C +3215(*/)S +920 V +1175(if)S +1337(\(!\(cdl)S +1715(=)S +9 B +1823(cdl_open)S +9 C +2222(\(\(char)S +2600(*\)getenv\("IMTDEV"\)\)\))S +3734(\))S +1020 V +1337(exit)S +1607(\(-1\);)S +1220 V +1175(fname)S +1499(=)S +1607(argv[argc-1];)S +1420 V +1175(/*)S +9 I +1337(METHOD)S +1739(1:)S +1868(Displays)S +2210(the)S +2347(image)S +2594(using)S +2816(the)S +2953(high-level)S +3340(format)S +3607(display)S +1520 V +1229(*)S +1301(call.)S +1513(Display)S +1820(as)S +1927(an)S +2044(IRAF)S +2266(image)S +2513(if)S +2590(the)S +2727(option)S +2984(was)S +3151(set)S +3278(indicating)S +1620 V +1229(*)S +1301(this)S +1458(is)S +1545(the)S +1682(format,)S +1972(otherwise)S +2349(test)S +2501(the)S +2638(\256le)S +2775(to)S +2872(see)S +3014(if)S +3091(it)S +3168(is)S +3255(anyway.)S +1720 V +9 C +1229(*/)S +1820 V +1175(if)S +1337(\(format)S +1769(==)S +1931(IRAF)S +2201(||)S +2363(\(format)S +2795(==)S +2957(NONE)S +3227(&&)S +9 B +3389(cdl_isIRAF)S +9 C +3883(\(fname\)\)\))S +4423({)S +1920 V +1391(status)S +1769(=)S +9 B +1877(cdl_displayIRAF)S +9 C +2586(\(cdl,)S +2910(fname,)S +3288(1,)S +3450(frame,)S +3828(FB_AUTO,)S +4314(zscale\);)S +2120 V +1175(/*)S +9 I +1337(METHOD)S +1739(2:)S +1868(Uses)S +2070(the)S +2207(CDL)S +2409(procedure)S +2806(for)S +2938(getting)S +3215(image)S +3462(pixels)S +3699(from)S +2220 V +1229(*)S +1301(a)S +1373(known)S +1635(format,)S +1925(minimal)S +2247(work)S +2454(required)S +2791(to)S +2888(display)S +3175(an)S +3292(image.)S +3589(The)S +2320 V +1229(*)S +1301(point)S +1513(here)S +1700(is)S +1787(that)S +1954(you)S +2111(can)S +2268(use)S +2415(this)S +2572(method)S +2864(to)S +2961(process)S +3263(the)S +3400(image)S +2420 V +1229(*)S +1301(yourself)S +1618(prior)S +1830(to)S +1927(display,)S +2237(e.g.)S +2395(subsample)S +2802(the)S +2939(pixels,)S +3199(apply)S +3426(a)S +3498(user)S +2520 V +1229(*)S +1301(LUT,)S +1516(etc)S +1648(but)S +1790(still)S +1952(use)S +2099(the)S +2236(CDL)S +2438(to)S +2535(get)S +2672(the)S +2809(raw)S +2976(image)S +3223(and)S +3385(do)S +3502(the)S +2620 V +1229(*)S +1301(display.)S +2720 V +9 C +1229(*/)S +2820 V +1175(})S +1283(else)S +1553(if)S +1715(\(format)S +2147(==)S +2309(FITS)S +2579(||)S +2741(\(format)S +3173(==)S +3335(NONE)S +3605(&&)S +9 B +3767(cdl_isFITS)S +9 C +4241(\(fname\)\)\))S +4781({)S +3020 V +1391(/*)S +9 I +1553(Get)S +1710(the)S +1847(FITS)S +2054(image)S +2301(pixels,)S +2561(exit)S +2718(w/)S +2830(an)S +2947(error)S +3164(status)S +3401(if)S +3478(something)S +3120 V +1445(*)S +1517(went)S +1714(wrong,)S +1994(the)S +2131(procedure)S +2528(will)S +2690(print)S +2892(what)S +3094(that)S +3261(was.)S +3220 V +9 C +1445(*/)S +3320 V +1391(if)S +1553(\()S +9 B +1607(cdl_readFITS)S +9 C +2196(\(fname,)S +2628(&pix,)S +2952(&nx,)S +3222(&ny,)S +3492(&depth,)S +3924(title\)\))S +4356({)S +3420 V +9 B +1450(cdl_close)S +9 C +1849(\(cdl\);)S +2550(/*)S +9 I +2712(close)S +2924(the)S +3061(package)S +9 C +3469(*/)S +3520 V +1450(exit)S +1720(\(1\);)S +2550(/*)S +9 I +2712(exit)S +2869(w/)S +2981(error)S +3198(code)S +9 C +3422(*/)S +3620 V +1391(})S +3820 V +1391(/*)S +9 I +1553(Now)S +1745(select)S +1977(a)S +2049(frame)S +2286(bu)S +2376 H + (f)show 9 -.5 mul h (f)show +9 I +2422(er)S +2524(large)S +2741(enough)S +3033(for)S +3165(the)S +3302(image.)S +3572(The)S +3920 V +1445(*)S +1517(fbcon\256g)S +1834(number)S +2136(is)S +2223(passed)S +2495(in)S +2592(the)S +2729(WCS)S +2936(packet,)S +3221(but)S +3363(the)S +3500(display)S +4020 V +1445(*)S +1517(call)S +1679(below)S +1921(will)S +2083(compute)S +2415(the)S +2552(correct)S +2839(WCS)S +3046(for)S +3178(the)S +3315(image)S +3562(and)S +4120 V +1445(*)S +1517(transmit)S +1844(that)S +2011(prior)S +2223(to)S +2320(display,)S +2630(all)S +2752(we're)S +2984(doing)S +3216(here)S +3403(is)S +4220 V +1445(*)S +1517(setting)S +1784(up)S +1901(the)S +2038(FB)S +2175(to)S +2272(be)S +2384(used.)S +4320 V +9 C +1445(*/)S +4420 V +1391(if)S +1553(\(fbconfig)S +2093(==)S +2255(0\))S +4520 V +9 B +1607(cdl_selectFB)S +9 C +2146(\(cdl,)S +2470(nx,)S +2686(ny,)S +2902(&fbconfig,)S +3496(&fb_w,)S +3874(&fb_h,)S +4252(&nf,)S +4522(0\);)S +4720 V +1391(/*)S +9 I +1553(Lastly,)S +1823(display)S +2110(the)S +2247(pixels)S +2484(to)S +2581(the)S +2718(requested)S +3095(frame,)S +3355(do)S +3472(any)S +4820 V +1445(*)S +1517(zscaling)S +1839(requested)S +2216(using)S +2438(the)S +2575(CDL)S +2777(procedure.)S +4920 V +9 C +1445(*/)S +5020 V +1391(status)S +1769(=)S +9 B +1877(cdl_displayPix)S +9 C +2491(\(cdl,)S +2815(pix,)S +3085(nx,)S +3301(ny,)S +3517(depth,)S +3895(frame,)S +5120 V +1450(fbconfig,)S +1990(zscale\);)S +5320 V +1175(/*)S +9 I +1337(METHOD)S +1739(3:)S +1868(Displays)S +2210(an)S +2327(image)S +2574(of)S +2671(raw)S +2838(pixels.)S +3125(The)S +3287(client)S +3514(code)S +3711(is)S +5420 V +1229(*)S +1301(responsible)S +1743(for)S +1875(reading)S +2182(the)S +2319(image)S +2566(and)S +2728(calling)S +3005(all)S +3127(the)S +3264(procedures)S +5520 V +1229(*)S +1301(needed)S +1583(for)S +1715(image)S +1962(display,)S +2272(initialize)S +2614(the)S +2751(frame,)S +3011(zscaling)S +3333(pix,)S +3493(etc.)S +5620 V +1229(*)S +1301(While)S +1538(we)S +1665(assume)S +1957(a)S +2029(simple)S +2291(raster)S +2533(format)S +2800(in)S +2897(this)S +3054(program,)S +3419(the)S +3556(user)S +5720 V +1229(*)S +1301(code)S +1498(can)S +1655(read)S +1847(a)S +1919(compressed)S +2371(image)S +2618(format)S +2885(such)S +3077(as)S +3184(GIF,)S +3384(mosaic)S +3666(multiple)S +5820 V +1229(*)S +1301(images)S +1583(for)S +1715(display)S +2002(as)S +2109(a)S +2181(single)S +2423(image,)S +2693(or)S +2800(just)S +2957(about)S +3189(anything)S +3531(that)S +5920 V +1229(*)S +1301(produces)S +1658(a)S +1730(raster)S +1972(for)S +2104(display.)S +2414(The)S +2576(intent)S +2808(here)S +2995(is)S +3082(to)S +3179(show)S +3391(all)S +3513(the)S +6020 V +1229(*)S +1301(lowest)S +1558(level)S +1755(calls)S +1952(needed)S +2234(for)S +2366(displaying)S +2768(the)S +2905(image.)S +6120 V +9 C +1229(*/)S +6220 V +1175(})S +1283(else)S +1553(if)S +1715(\(format)S +2147(==)S +2309(RAW\))S +2579({)S +6320 V +1391(FILE)S +1725(*fd;)S +6420 V +1391(int)S +2000(lx,)S +2216(ly;)S +6620 V +1391(if)S +1553(\(nx)S +1769(==)S +1931(0)S +2039(||)S +2201(ny)S +2363(==)S +2525(0\))S +2687({)S +6720 V +1607(fprintf)S +2039(\(stderr,)S +2525("No)S +2741(size)S +3011(given)S +3335(for)S +3551(raw)S +3767(data.\\n"\);)S +6820 V +1607(exit)S +1877(\(1\);)S +6920 V +1391(})S +7120 V +1391(/*)S +9 I +1553(Open)S +1775(the)S +1912(image)S +2159(\256le)S +2296(if)S +2373(we)S +2500(can.)S +9 C +2707(*/)S +7220 V +1391(if)S +1553(\(fd)S +1769(=)S +1877(fopen)S +2201(\(fname,)S +2633("r"\)\))S +2957({)S +7920 V +EP +%%Page: 25 28 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +460 V +11 R +2936(- 25 -)S +820 V +9 C +1450(/*)S +9 I +1612(Seek)S +1804(to)S +1901(the)S +2038(o)S +2083 H + (f)show 9 -.5 mul h (f)show +9 I +2129(set)S +2256(speci\256ed.)S +9 C +2648(*/)S +920 V +1450(lseek)S +1774(\(fileno\(fd\),)S +2476(\(off_t\))S +2908(hskip,)S +3286(SEEK_SET\);)S +1120 V +1450(/*)S +9 I +1612(Allocate)S +1939(the)S +2076(pixel)S +2278(pointer)S +2565(and)S +2727(read)S +2919(the)S +3056(data.)S +9 C +3293(*/)S +1220 V +1450(pix)S +1666(=)S +1774(\(unsigned)S +2314(char)S +2584(*\))S +2746(malloc)S +3124(\(nx)S +3340(*)S +3448(ny)S +3610(*)S +3718(\(depth)S +4096(/)S +4204(8\)\);)S +1320 V +1450(fread)S +1774(\(pix,)S +2098(depth/8,)S +2584(nx)S +2746(*)S +2854(ny,)S +3070(fd\);)S +1520 V +1450(/*)S +9 I +1612(If)S +1694(we're)S +1926(zscaling)S +2248(and)S +2410(depth)S +2637(is)S +2724(more)S +2936(than)S +3123(8-bits,)S +3378(do)S +3495(that.)S +9 C +3712(*/)S +1620 V +1450(if)S +1612(\(zscale)S +2044(&&)S +2206(depth)S +2530(>)S +2638(8\))S +2800({)S +1720 V +9 B +1666(cdl_computeZscale)S +9 C +2455(\(cdl,)S +2779(pix,)S +3049(nx,)S +3265(ny,)S +3481(depth,)S +3859(&z1,)S +4129(&z2\);)S +1820 V +9 B +1666(cdl_zscaleImage)S +9 C +2345(\(cdl,)S +2669(&pix,)S +2993(nx,)S +3209(ny,)S +3425(depth,)S +3803(z1,)S +4019(z2\);)S +1920 V +1450(})S +2120 V +1450(/*)S +9 I +1612(Now)S +1804(select)S +2036(a)S +2108(frame)S +2345(bu)S +2435 H + (f)show 9 -.5 mul h (f)show +9 I +2481(er)S +2583(large)S +2800(enough)S +3092(for)S +3224(the)S +3361(image.)S +2220 V +1477(*)S +1549(We'll)S +1771(ask)S +1918(that)S +2085(this)S +2242(be)S +2354(reset)S +2556(but)S +2698(the)S +2835(change)S +3122(won't)S +3354(go)S +3471(to)S +2320 V +1477(*)S +1549(the)S +1686(server)S +1938(until)S +2130(we)S +2257(send)S +2449(in)S +2546(the)S +2683(WCS)S +2890(below.)S +2420 V +9 C +1504(*/)S +2520 V +9 B +1450(cdl_selectFB)S +9 C +1989(\(cdl,)S +2313(nx,)S +2529(ny,)S +2745(&fbconfig,)S +3339(&fb_w,)S +3717(&fb_h,)S +4095(&nf,)S +4365(1\);)S +2720 V +1450(/*)S +9 I +1612(Compute)S +1964(the)S +2101(image)S +2348(placement)S +2745(so)S +2852(it's)S +2994(centered)S +3331(in)S +3428(the)S +3565(frame,)S +2820 V +1477(*)S +1549(but)S +1691(note)S +1873(the)S +2010(cdl_writeSubRaster\(\))S +2807(routine)S +3094(can)S +3251(place)S +3473(an)S +2920 V +1477(*)S +1549(arbitrary)S +1906(raster)S +2148(anywhere)S +2525(in)S +2622(the)S +2759(frame)S +2996(bu)S +3086 H + (f)show 9 -.5 mul h (f)show +9 I +3132(er.)S +3020 V +9 C +1450(lx)S +1612(=)S +1720(\(fb_w)S +2044(/)S +2152(2\))S +2314(-)S +2422(\(nx)S +2638(/)S +2746(2\);)S +3120 V +1450(ly)S +1612(=)S +1720(fb_h)S +1990(-)S +2098(\(\(fb_h)S +2476(/)S +2584(2\))S +2746(+)S +2854(\(ny)S +3070(/)S +3178(2\)\);)S +3320 V +1450(/*)S +9 I +1612(Set)S +1749(the)S +1886(mapping)S +2228(we'll)S +2435(send)S +2627(with)S +2809(the)S +2946(WCS)S +3153(which)S +3395(must)S +3592(be)S +3420 V +1477(*)S +1549(called)S +1796(before)S +2053(the)S +2190(cdl_setWCS\(\))S +2712(call)S +2874(since)S +3086(the)S +3223(data)S +3410(is)S +3497(sent)S +3520 V +1477(*)S +1549(with)S +1731(the)S +1868(WCS)S +2075(and)S +2237(not)S +2379(as)S +2486(a)S +2558(separate)S +2895(call.)S +3620 V +9 C +1504(*)S +3720 V +1504(*)S +9 R +1612(First)S +1804(we)S +1936(must)S +2138(compose)S +2485(a)S +2552(node!path)S +2939(pre\256x)S +3176(for)S +3308(the)S +3445(image.)S +9 C +3742(*/)S +3820 V +1504(*/)S +3920 V +1450(gethostname)S +2098(\(node,)S +2476(512\);)S +4020 V +1450(\(void\))S +1828(getcwd)S +2206(\(path,)S +2584(512\);)S +4120 V +1450(if)S +1612(\(*fname)S +2044(==)S +2206('/'\))S +4220 V +1666(\(void\))S +2044(sprintf)S +2476(\(path_prefix,)S +3232("%s!%s",)S +3718(node,)S +4042(fname\);)S +4320 V +1450(else)S +4420 V +1666(\(void\))S +2044(sprintf)S +2476(\(path_prefix,)S +3232("%s!%s/%s",)S +3880(node,)S +4204(path,)S +4528(fname\);)S +4620 V +9 B +1450(cdl_setMapping)S +9 C +2119(\(cdl,)S +2443("image",)S +2929(0.,)S +3145(0.,)S +3361(nx,)S +3577(ny,)S +3793(lx,)S +4009(ly,)S +4225(nx,)S +4441(ny,)S +4720 V +1612(path_prefix\);)S +4920 V +1450(/*)S +9 I +1612(For)S +1774(the)S +1911(WCS)S +2118(we)S +2245(assume)S +2537(a)S +2609(simple)S +2871(linear)S +3113(transform)S +3495(where)S +3742(the)S +5020 V +1477(*)S +1549(image)S +1796(is)S +1883(Y-\257ipped,)S +2258(the)S +2395(\(x,y\))S +2585(translation)S +3007(is)S +3094(computed)S +3471(so)S +5120 V +1477(*)S +1549(it)S +1626(is)S +1713(correct)S +2000(for)S +2132(an)S +2249(frame)S +2486(bu)S +2576 H + (f)show 9 -.5 mul h (f)show +9 I +2622(er)S +2724(>=)S +2873(than)S +3060(the)S +3197(image)S +3444(size.)S +5220 V +9 C +1504(*/)S +5320 V +9 B +1450(cdl_setWCS)S +9 C +1974(\(cdl,)S +2298(fname,)S +2676("",)S +2892(1.,)S +3108(0.,)S +3324(0.,)S +3540(-1.,)S +5420 V +1666(\(float\))S +2098(\(nx)S +2314(/)S +2422(2\))S +2584(-)S +2692(\(fb_w)S +3016(/)S +3124(2\))S +3286(+)S +3394(1,)S +3826(/*)S +9 I +3988(X)S +4070(trans.)S +9 C +4494(*/)S +5520 V +1666(\(float\))S +2098(\(fb_h)S +2422(/)S +2530(2\))S +2692(+)S +2800(\(ny)S +3016(/)S +3124(2\),)S +3826(/*)S +9 I +3988(Y)S +4065(trans.)S +9 C +4489(*/)S +5620 V +1666(z1,)S +1882(z2,)S +2098(CDL_LINEAR\);)S +3826(/*)S +9 I +3988(Z)S +4065(transform)S +9 C +4474(*/)S +5820 V +1450(/*)S +9 I +1612(Finally,)S +1922(display)S +2209(the)S +2346(pixels.)S +9 C +2687(*/)S +5920 V +1450(if)S +1612(\()S +9 B +1666(cdl_writeSubRaster)S +9 R +2458(\(cdl,)S +2648(lx,)S +2768(ly,)S +2888(nx,)S +3028(ny,)S +3168(pix\)\))S +6020 V +1558(status)S +1790(=)S +1867(1;)S +6120 V +1283(})S +1353(else)S +6220 V +1450(status)S +1682(=)S +1759(1;)S +6320 V +1175(})S +1245(else)S +1412({)S +6420 V +1283(if)S +1365(\(access)S +1652(\(fname,)S +1957(F_OK\))S +2239(==)S +2366(0\))S +6520 V +1450(fprintf)S +1707(\(stderr,)S +1992("'%s':)S +2251(unknown)S +2613(image)S +2860(format.\\n",)S +3280(fname\);)S +6620 V +1283(else)S +6720 V +1450(fprintf)S +1707(\(stderr,)S +1992("'%s':)S +2251(image)S +2498(does)S +2690(not)S +2832(exist.\\n",)S +3182(fname\);)S +6820 V +1283(status)S +1515(=)S +1592(1;)S +6920 V +1175(})S +7120 V +1175(/*)S +9 I +1272(Now)S +1464(just)S +1621(free)S +1788(the)S +1925(pixel)S +2127(pointer)S +2414(to)S +2511(clean)S +2733(up.)S +9 R +2873(*/)S +7220 V +1175(if)S +1257(\(pix\))S +7920 V +EP +%%Page: 26 29 +BP +/slant 0 def +/height 1.000000 def +9 R +9 R +460 V +11 R +2936(- 26 -)S +820 V +9 R +1283(free)S +1450(\(\(unsigned)S +1862(char)S +2044(*\))S +2146(pix\);)S +920 V +9 B +1175(cdl_close)S +9 R +1547(\(cdl\);)S +2275(/*)S +9 I +2372(close)S +2584(the)S +2721(package)S +9 R +3048(*/)S +1020 V +1175(exit)S +1337(\(status\);)S +1120 V +900(})S +7920 V +EP +%%Page: 27 30 +BP +/slant 0 def +/height 1.000000 def +9 R +9 R +480 V +11 R +2936(- 27 -)S +840 V +11 B +900(12.2.)S +1187(Interactive)S +1730(Graphics)S +2198(Overlay)S +2609(Example)S +1076 V +9 C +900(#include)S +1386(<stdio.h>)S +1176 V +900(#include)S +1386(<unistd.h>)S +1276 V +900(#include)S +1386(<math.h>)S +1376 V +900(#include)S +1386("cdl.h")S +1576 V +900(/*)S +1676 V +9 I +954(*)S +1053(TVMARK)S +1430(--)S +1517(Example)S +1859(task)S +2031(for)S +2163(displaying)S +2565(an)S +2682(marking)S +3009(images.)S +3341(This)S +3523(program)S +1776 V +954(*)S +1053(can)S +1210(be)S +1322(used)S +1514(to)S +1611(either)S +1848(display)S +2135(an)S +2252(image)S +2499(and)S +2661(overlay)S +2958(points)S +3205(de\256ned)S +3492(in)S +1876 V +954(*)S +1053(a)S +1125(coordinate)S +1542(\256le,)S +1702(map)S +1884(an)S +2001(existing)S +2308(display)S +2595(frame)S +2832(for)S +2964(marking,)S +3314(or)S +3421(option-)S +1976 V +954(*)S +1053(ally)S +1215(enter)S +1427(a)S +1499(cursor)S +1761(command)S +2138(loop)S +2325(after)S +2522(either)S +2759(of)S +2856(these)S +3068(providing)S +3445(other)S +2076 V +954(*)S +1053(marking)S +1380(capability.)S +1817(All)S +1949(options)S +2241(support)S +2543(minimum)S +2905(match.)S +2176 V +954(*)S +2276 V +954(*)S +1053(Examples:)S +2376 V +954(*)S +1175(%)S +1277(tvmark)S +1554(dpix.\256ts)S +2476 V +954(*)S +1175(%)S +1277(tvmark)S +1554(-coords)S +1856(coords)S +2128(-color)S +2375(205)S +2537(dpix.\256ts)S +2576 V +954(*)S +1175(%)S +1277(tvmark)S +1554(-frame)S +1821(2)S +2676 V +954(*)S +1175(%)S +1277(tvmark)S +1554(-coords)S +1856(coords)S +2128(-interactive)S +2570(dpix.\256ts)S +2776 V +954(*)S +2876 V +954(*)S +1053(Usage:)S +2976 V +954(*)S +1175(tvmark)S +1452([-frame)S +1754(N])S +1876([-fbcon\256g)S +2258(N])S +2380([-coords)S +2717(<\256le>])S +3011([-size)S +3238(N])S +3360([-color)S +3642(N])S +3076 V +954(*)S +1310([-nolabel])S +1707([-\256ll])S +1929([-interactive])S +2441([image])S +3176 V +9 C +954(*/)S +3376 V +900(main)S +1170(\(argc,)S +1548(argv\))S +3476 V +900(int)S +1175(argc;)S +3576 V +900(char)S +1175(*argv[];)S +3676 V +900({)S +3776 V +1175(CDLPtr)S +1725(cdl;)S +3876 V +1175(char)S +1450(*fname)S +1828(=)S +1936(NULL,)S +2260(*cfname)S +2692(=)S +2800(NULL;)S +3976 V +1175(int)S +1450(i,)S +1612(status)S +1990(=)S +2098(0,)S +2260(fill)S +2530(=)S +2638(0,)S +2800(frame)S +3124(=)S +3232(1,)S +3394(fb)S +3556(=)S +3664(FB_AUTO,)S +4150(zscale)S +4528(=)S +4636(1;)S +4076 V +1175(int)S +1450(color)S +1774(=)S +1882(201,)S +2152(label)S +2476(=)S +2584(1,)S +2746(size)S +3016(=)S +3124(9,)S +3286(interactive)S +3934(=)S +4042(0;)S +4176 V +1175(float)S +1725(z1,)S +1941(z2;)S +4276 V +1175(int)S +1450(fb_w,)S +1774(fb_h,)S +2098(nf;)S +4376 V +1175(unsigned)S +1661(char)S +1931(*pix)S +2201(=)S +2309(NULL;)S +4576 V +1175(/*)S +9 I +1337(Process)S +1649(the)S +1786(command)S +2163(line)S +2325(options.)S +9 C +2667(*/)S +4676 V +1175(if)S +1337(\(argc)S +1661(>)S +1769(1\))S +1931({)S +4776 V +1391(for)S +1607(\(i=1;)S +1931(i)S +2039(<)S +2147(argc;)S +2471(i++\))S +2741({)S +4876 V +1548(if)S +1710(\(strncmp\(argv[i],)S +2682("-color",4\))S +3330(==)S +3492(0\))S +3654(color)S +3978(=)S +4086(atoi)S +4356(\(argv[++i]\);)S +4976 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-coords",4\))S +3654(==)S +3816(0\))S +3978(cfname)S +4356(=)S +4464(argv[++i];)S +5076 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-fbconfig",3\))S +3762(==)S +3924(0\))S +4086(fb)S +4248(=)S +4356(atoi)S +4626(\(argv[++i]\);)S +5176 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-fill",4\))S +3546(==)S +3708(0\))S +3870(fill)S +4140(=)S +4248(1;)S +5276 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-frame",3\))S +3600(==)S +3762(0\))S +3924(frame)S +4248(=)S +4356(atoi)S +4626(\(argv[++i]\);)S +5376 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-interactive",4\))S +3924(==)S +4086(0\))S +4248(interactive)S +4896(=)S +5004(1;)S +5476 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-nolabel",4\))S +3708(==)S +3870(0\))S +4032(label)S +4356(=)S +4464(0;)S +5576 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-nozscale",4\))S +3762(==)S +3924(0\))S +4086(zscale)S +4464(=)S +4572(0;)S +5676 V +1548(else)S +1818(if)S +1980(\(strncmp\(argv[i],)S +2952("-size",2\))S +3546(==)S +3708(0\))S +3870(size)S +4140(=)S +4248(atoi)S +4518(\(argv[++i]\);)S +5776 V +1391(else)S +5876 V +1607(fname)S +1931(=)S +2039(argv[i];)S +5976 V +1391(})S +6076 V +1175(})S +6276 V +1175(/*)S +9 I +1337(Open)S +1559(the)S +1696(package)S +2023(and)S +2185(a)S +2257(connection)S +2679(to)S +2776(the)S +2913(server.)S +9 C +3215(*/)S +6376 V +1175(if)S +1337(\(!\(cdl)S +1715(=)S +9 B +1823(cdl_open)S +9 C +2222(\(\(char)S +2600(*\)getenv\("IMTDEV"\)\)\))S +3734(\))S +6476 V +1337(exit)S +1607(\(-1\);)S +6676 V +1175(/*)S +9 I +1337(If)S +1419(an)S +1536(image)S +1783(was)S +1950(speci\256ed)S +2292(display)S +2579(it)S +2656(\256rst,)S +2846(otherwise)S +3223(assume)S +3515(the)S +6776 V +1229(*)S +1301(image)S +1548(has)S +1700(already)S +2002(been)S +2199(loaded)S +2471(in)S +2568(the)S +2705(frame)S +2942(and)S +3104(mark)S +3316(that.)S +6876 V +9 C +1229(*/)S +6976 V +1175(if)S +1337(\(fname\))S +1769({)S +7076 V +1391(if)S +1553(\()S +9 B +1607(cdl_isIRAF)S +9 C +2101(\(fname\)\))S +7176 V +1607(status)S +1985(=)S +9 B +2093(cdl_displayIRAF)S +9 C +2802(\(cdl,)S +3126(fname,)S +3504(1,)S +3666(frame,)S +4044(fb,)S +4260(zscale\);)S +7276 V +1391(else)S +1661(if)S +1823(\()S +9 B +1877(cdl_isFITS)S +9 C +2351(\(fname\)\))S +7920 V +EP +%%Page: 28 31 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +460 V +11 R +2936(- 28 -)S +820 V +9 C +1607(status)S +1985(=)S +9 B +2093(cdl_displayFITS)S +9 C +2782(\(cdl,)S +3106(fname,)S +3484(frame,)S +3862(fb,)S +4078(zscale\);)S +920 V +1391(else)S +1661({)S +1020 V +1450(if)S +1612(\(access)S +2044(\(cfname,)S +2530(F_OK\))S +2854(==)S +3016(0\))S +1120 V +1823(fprintf)S +2255(\(stderr,)S +2741("'%s':)S +3119(unknown)S +3551(image)S +3875(format.\\n",)S +4523(fname\);)S +1220 V +1450(else)S +1320 V +1823(fprintf)S +2255(\(stderr,)S +2741("'%s':)S +3119(image)S +3443(doesn't)S +3875(exist.\\n",)S +4469(fname\);)S +1420 V +1607(status)S +1985(=)S +2093(1;)S +1520 V +1391(})S +1620 V +1391(if)S +1553(\(status\))S +2093(goto)S +2363(err_;)S +1720 V +1175(})S +1283(else)S +1553({)S +1920 V +1391(/*)S +9 I +1553(If)S +1635(we've)S +1872(requested)S +2249(a)S +2321(special)S +2603(frame)S +2840(bu)S +2930 H + (f)show 9 -.5 mul h (f)show +9 I +2976(er,)S +3101(set)S +3228(it)S +3305(now.)S +9 C +3532(*/)S +2020 V +1391(if)S +1553(\(fb)S +1769(>)S +1877(0\))S +2120 V +9 B +1558(cdl_setFBCon\256g)S +9 C +2247(\(cdl,)S +2571(fb\);)S +2320 V +1391(/*)S +9 I +1553(Map)S +1745(the)S +1882(current)S +2174(display)S +2461(frame)S +2698(for)S +2830(use)S +2977(as)S +3084(an)S +3201(image.)S +9 C +3498(*/)S +2420 V +9 B +1391(cdl_mapFrame)S +9 C +2030(\(cdl,)S +2354(frame\);)S +2520 V +1175(})S +2720 V +1175(/*)S +9 I +1337(If)S +1419(a)S +1491(coordinate)S +1908(\256le)S +2045(was)S +2212(speci\256ed)S +2554(read)S +2746(the)S +2883(\256le)S +3020(and)S +3182(mark)S +3394(those)S +2820 V +1229(*)S +1301(coords)S +1573(with)S +1755(points.)S +2920 V +9 C +1229(*/)S +3020 V +1175(if)S +1337(\(cfname\))S +3120 V +9 B +1548(cdl_markCoordsFile)S +9 C +2397(\(cdl,)S +2721(cfname,)S +3153(M_STAR,)S +3585(size,)S +3909(color,)S +4287(label\);)S +3320 V +1175(/*)S +9 I +1337(Lastly,)S +1607(start)S +1799(up)S +1916(an)S +2033(interactive)S +2445(cursor)S +2707(loop)S +2894(if)S +2971(needed.)S +9 C +3303(*/)S +3420 V +1175(if)S +1337(\(interactive\))S +3520 V +1391(tvmInteractive)S +2201(\(cdl,)S +2525(label,)S +2903(fill,)S +3227(color,)S +3605(size\);)S +3720 V +1175(/*)S +9 I +1337(Close)S +1569(the)S +1706(package)S +2033(and)S +2195(clean)S +2417(up.)S +9 C +2584(*/)S +3820 V +900(err_:)S +9 B +1175(cdl_close)S +9 C +1574(\(cdl\);)S +3920 V +1175(exit)S +1445(\(status\);)S +4020 V +900(})S +4220 V +900(/*)S +9 I +1116(TVMINTERACTIVE)S +1878(--)S +1965(Process)S +2277(commands)S +2689(interactively.)S +9 C +3270(*/)S +4420 V +900(tvmInteractive)S +1710(\(cdl,)S +2034(label,)S +2412(fill,)S +2736(color,)S +3114(size\))S +4520 V +900(CDLPtr)S +1450(cdl;)S +4620 V +900(int)S +1175(label,)S +1553(fill,)S +1877(color,)S +2255(size;)S +4720 V +900({)S +4820 V +1175(float)S +1607(angle)S +1931(=)S +2039(0.0,)S +2309(rx,)S +2525(ry,)S +2741(txsize)S +3119(=)S +3227(1.;)S +4920 V +1175(int)S +1607(nx,)S +1823(ny,)S +2039(i,)S +2201(x,)S +2363(y,)S +2525(x2,)S +2741(y2,)S +2957(wcs;)S +5020 V +1175(int)S +1607(number=1,)S +2147(radius=11,)S +2741(xrad=11,)S +3227(yrad=6,)S +3659(nannuli=3,)S +4253(sep=5;)S +5120 V +1175(char)S +1607(key,)S +1877(cmd[SZ_NAME],)S +2633(str[SZ_NAME];)S +5220 V +1175(unsigned)S +1661(char)S +1931(*pix;)S +5420 V +1175(/*)S +9 I +1337(Process)S +1649(commands)S +2061(until)S +2253(a)S +2325('q')S +2457(keystroke)S +2824(is)S +2911(hit.)S +9 C +3083(*/)S +5520 V +1175(while)S +1499(\()S +9 B +1553(cdl_readCursor)S +9 C +2217(\(cdl,)S +2541(0,)S +2703(&rx,)S +2973(&ry,)S +3243(&wcs,)S +3567(&key\))S +3891(!=)S +4053('q'\))S +4323({)S +5620 V +1391(x)S +1499(=)S +1607(\(int\))S +1931(\(rx)S +2147(+)S +2255(0.5\);)S +2550(/*)S +9 I +2712(convert)S +3009(to)S +3106(int)S +3228(pixels)S +9 C +3492(*/)S +5720 V +1391(y)S +1499(=)S +1607(\(int\))S +1931(\(ry)S +2147(+)S +2255(0.5\);)S +5920 V +1391(switch)S +1769(\(key\))S +2093({)S +6020 V +1391(case)S +1661(':':)S +2550(/*)S +9 I +2712(process)S +3014(a)S +3086(colon)S +3313(command)S +9 C +3717(*/)S +6120 V +1450(putchar)S +1882(\(':'\);)S +6220 V +1450(gets)S +1720(\(str\);)S +6320 V +1450(for)S +1666(\(i=0;)S +1990(str[i])S +2368(!=)S +2530(')S +2638(')S +2746(&&)S +2908(str[i];)S +3340(i++\))S +6420 V +1666(cmd[i])S +2044(=)S +2152(str[i];)S +6520 V +1450(cmd[i++])S +1936(=)S +2044(')S +2152(';)S +6720 V +1450(if)S +1612(\(strcmp)S +2044(\(cmd,)S +2368("angle"\))S +2854(==)S +3016(0\))S +3556(angle)S +3880(=)S +3988(atof)S +4258(\(&str[i]\);)S +6820 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("color"\))S +3124(==)S +3286(0\))S +3556(color)S +3880(=)S +3988(atoi)S +4258(\(&str[i]\);)S +6920 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("fill"\))S +3070(==)S +3232(0\))S +3556(fill)S +3826(=)S +3934(atoi)S +4204(\(&str[i]\);)S +7020 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("number"\))S +3178(==)S +3340(0\))S +3556(number)S +3934(=)S +4042(atoi)S +4312(\(&str[i]\);)S +7120 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("nannuli"\))S +3232(==)S +3394(0\))S +3556(nannuli)S +3988(=)S +4096(atoi)S +4366(\(&str[i]\);)S +7220 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("label"\))S +3124(==)S +3286(0\))S +3556(label)S +3880(=)S +3988(atoi)S +4258(\(&str[i]\);)S +7920 V +EP +%%Page: 29 32 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +460 V +11 R +2936(- 29 -)S +820 V +9 C +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("sep"\))S +3016(==)S +3178(0\))S +3556(sep)S +3772(=)S +3880(atoi)S +4150(\(&str[i]\);)S +920 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("size"\))S +3070(==)S +3232(0\))S +3556(size)S +3826(=)S +3934(atoi)S +4204(\(&str[i]\);)S +1020 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("txsize"\))S +3178(==)S +3340(0\))S +3556(txsize)S +3934(=)S +4042(atof)S +4312(\(&str[i]\);)S +1120 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("xrad"\))S +3070(==)S +3232(0\))S +3556(xrad)S +3826(=)S +3934(atoi)S +4204(\(&str[i]\);)S +1220 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("yrad"\))S +3070(==)S +3232(0\))S +3556(yrad)S +3826(=)S +3934(atoi)S +4204(\(&str[i]\);)S +1320 V +1450(else)S +1720(if)S +1882(\(strcmp)S +2314(\(cmd,)S +2638("print"\))S +3124(==)S +3286(0\))S +3448({)S +1420 V +9 B +1666(cdl_readFrameBu)S +2366 H + (f)show 9 -.5 mul h (f)show +9 B +2421(er)S +9 C +2555(\(cdl,)S +2879(&pix,)S +3203(&nx,)S +3473(&ny\);)S +1520 V +9 B +1666(cdl_printPix)S +9 C +2200(\(cdl,)S +2524(NULL,)S +2848(pix,)S +3118(nx,)S +3334(ny,)S +3550(1\);)S +1620 V +1450(})S +1558(else)S +1828(if)S +1990(\(strcmp)S +2422(\(cmd,)S +2746("snap"\))S +3178(==)S +3340(0\))S +3502({)S +1720 V +9 B +1666(cdl_readFrameBu)S +2366 H + (f)show 9 -.5 mul h (f)show +9 B +2421(er)S +9 C +2555(\(cdl,)S +2879(&pix,)S +3203(&nx,)S +3473(&ny\);)S +1820 V +9 B +1666(cdl_printPixToFile)S +9 C +2450(\(cdl,)S +2774(&str[i],)S +3260(pix,)S +3530(nx,)S +3746(ny,)S +3962(1\);)S +1920 V +1450(})S +1558(else)S +1828(if)S +1990(\(strcmp)S +2422(\(cmd,)S +2746("status"\))S +3286(==)S +3448(0\))S +3610({)S +2020 V +1666(printf)S +2044(\("angle)S +2550(=)S +2658(%-5.3gcolor)S +3375(=)S +3483(%d",)S +3753(angle,)S +4131(color\);)S +2120 V +1666(printf)S +2044(\("fill)S +2550(=)S +2658(%-5dnumber)S +3375(=)S +3483(%d\\n",)S +3861(fill,)S +4185(number\);)S +2220 V +1666(printf)S +2044(\("nannuli)S +2550(=)S +2658(%-5dsep)S +3100(=)S +3208(%d",)S +3478(nannuli,)S +3964(sep\);)S +2320 V +1666(printf)S +2044(\("size)S +2550(=)S +2658(%-5dtxsize)S +3375(=)S +3483(%g\\n",)S +3861(size,)S +4185(txsize\);)S +2420 V +1666(printf)S +2044(\("xrad)S +2550(=)S +2658(%-5dyrad)S +3100(=)S +3208(%d",)S +3478(xrad,)S +3802(yrad\);)S +2520 V +1666(printf)S +2044(\("label)S +2550(=)S +2658(%-5d\\n",)S +3144(label\);)S +2620 V +1450(})S +2720 V +1450(break;)S +2920 V +1391(case)S +1661('?':)S +3020 V +1450(/*)S +1612(......)S +9 I +1936(help)S +2118(procedures)S +9 C +2577(*/)S +3120 V +1450(break;)S +3320 V +1391(case)S +1661('p':)S +2825(/*)S +9 I +2987(plus)S +3164(mark)S +9 C +3375(*/)S +3420 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_PLUS,)S +4779(color\);)S +3520 V +1450(break;)S +3620 V +1391(case)S +1661('x':)S +2825(/*)S +9 I +2987(cross)S +3204(mark)S +9 C +3650(*/)S +3720 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_CROSS,)S +4833(color\);)S +3820 V +1450(break;)S +3920 V +1391(case)S +1661('.':)S +2825(/*)S +9 I +2987(point)S +3199(mark)S +9 C +3650(*/)S +4020 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_POINT,)S +4833(color\);)S +4120 V +1450(break;)S +4220 V +1391(case)S +1661('*':)S +2825(/*)S +9 I +2987(star)S +3154(mark)S +9 C +3375(*/)S +4320 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_STAR,)S +4779(color\);)S +4420 V +1450(break;)S +4520 V +1391(case)S +1661('_':)S +2825(/*)S +9 I +2987(horiz)S +3199(dash)S +3396(mark)S +9 C +3581(*/)S +4620 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_HBLINE,)S +4887(color\);)S +4720 V +1450(break;)S +4820 V +1391(case)S +1661('|':)S +2825(/*)S +9 I +2987(vert)S +3154(dash)S +3351(mark)S +9 C +3650(*/)S +4920 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_VBLINE,)S +4887(color\);)S +5020 V +1450(break;)S +5120 V +1391(case)S +1661('o':)S +2825(/*)S +9 I +2987(circle)S +3219(mark)S +9 C +3650(*/)S +5220 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_CIRCLE|fill,)S +5157(color\);)S +5320 V +1450(break;)S +5420 V +1391(case)S +1661('s':)S +2825(/*)S +9 I +2987(square)S +3259(mark)S +9 C +3650(*/)S +5520 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_BOX|fill,)S +4995(color\);)S +5620 V +1450(break;)S +5720 V +1391(case)S +1661('v':)S +2825(/*)S +9 I +2987(diamond)S +3329(mark)S +9 C +3650(*/)S +5820 V +9 B +1450(cdl_markPoint)S +9 C +2079(\(cdl,)S +2403(x,)S +2565(y,)S +2727(\(label)S +3105(?)S +3213(number++)S +3699(:)S +3807(0\),)S +4023(size,)S +4347(M_DIAMOND|fill,)S +5211(color\);)S +5920 V +1450(break;)S +6120 V +1391(case)S +1661('b':)S +2825(/*)S +9 I +2987(Box)S +9 C +3650(*/)S +6220 V +1450(printf)S +1828(\("Hit)S +2152(another)S +2584(key)S +2800(to)S +2962(define)S +3340(the)S +3556(box...\\n"\);)S +6320 V +1450(\(void\))S +9 B +1828(cdl_readCursor)S +9 C +2492(\(cdl,)S +2816(0,)S +2978(&rx,)S +3248(&ry,)S +3518(&wcs,)S +3842(&key\);)S +6420 V +1450(x2)S +1612(=)S +1720(\(int\))S +2044(\(rx)S +2260(+)S +2368(0.5\);)S +3100(y2)S +3262(=)S +3370(\(int\))S +3694(\(ry)S +3910(+)S +4018(0.5\);)S +6520 V +9 B +1450(cdl_markBox)S +9 C +2024(\(cdl,)S +2348(x,)S +2510(y,)S +2672(x2,)S +2888(y2,)S +3104(fill,)S +3428(color\);)S +6620 V +1450(break;)S +6720 V +1391(case)S +1661('c':)S +2825(/*)S +9 I +2987(Circle)S +9 C +3650(*/)S +6820 V +1450(printf)S +1828(\("Hit)S +2152(another)S +2584(key)S +2800(to)S +2962(set)S +3178(radius)S +3556(...\\n"\);)S +6920 V +1450(\(void\))S +9 B +1828(cdl_readCursor)S +9 C +2492(\(cdl,)S +2816(0,)S +2978(&rx,)S +3248(&ry,)S +3518(&wcs,)S +3842(&key\);)S +7020 V +1450(x2)S +1612(=)S +1720(\(int\))S +2044(\(rx)S +2260(+)S +2368(0.5\);)S +3100(y2)S +3262(=)S +3370(\(int\))S +3694(\(ry)S +3910(+)S +4018(0.5\);)S +7120 V +1450(radius)S +1828(=)S +1936(\(int\))S +2260(sqrt)S +2530(\(\(double\))S +3070(\(\(x2-x\)*\(x2-x\))S +3880(+)S +3988(\(y2-y\)*\(y2-y\)\)\);)S +7220 V +9 B +1450(cdl_markCircle)S +9 C +2109(\(cdl,)S +2433(x,)S +2595(y,)S +2757(radius,)S +3189(fill,)S +3513(color\);)S +7920 V +EP +%%Page: 30 33 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +460 V +11 R +2936(- 30 -)S +820 V +9 C +1450(break;)S +920 V +1391(case)S +1661('d':)S +2825(/*)S +9 I +2987(Delete)S +3249(marker)S +9 C +3650(*/)S +1020 V +9 B +1450(cdl_deleteMark)S +9 C +2109(\(cdl,)S +2433(x,)S +2595(y\);)S +1120 V +1450(break;)S +1220 V +1391(case)S +1661('e':)S +2825(/*)S +9 I +2987(Ellipse)S +9 C +3375(*/)S +1320 V +9 B +1450(cdl_markEllipse)S +9 C +2134(\(cdl,)S +2458(x,)S +2620(y,)S +2782(xrad,)S +3106(yrad,)S +3430(angle,)S +3808(fill,)S +4132(color\);)S +1420 V +1450(break;)S +1520 V +1391(case)S +1661('l':)S +2825(/*)S +9 I +2987(Line)S +9 C +3650(*/)S +1620 V +1450(printf)S +1828(\("Hit)S +2152(another)S +2584(key)S +2800(to)S +2962(set)S +3178(line)S +3448(endpoint...\\n"\);)S +1720 V +1450(\(void\))S +9 B +1828(cdl_readCursor)S +9 C +2492(\(cdl,)S +2816(0,)S +2978(&rx,)S +3248(&ry,)S +3518(&wcs,)S +3842(&key\);)S +1820 V +1450(x2)S +1612(=)S +1720(\(int\))S +2044(\(rx)S +2260(+)S +2368(0.5\);)S +3100(y2)S +3262(=)S +3370(\(int\))S +3694(\(ry)S +3910(+)S +4018(0.5\);)S +1920 V +9 B +1450(cdl_markLine)S +9 C +2049(\(cdl,)S +2373(x,)S +2535(y,)S +2697(x2,)S +2913(y2,)S +3129(color\);)S +2020 V +1450(break;)S +2120 V +1391(case)S +1661('t':)S +2825(/*)S +9 I +2987(Text)S +3169(string)S +9 C +3650(*/)S +2220 V +1450(printf)S +1828(\("Text)S +2206(string:)S +2638("\);)S +2320 V +1450(gets)S +1720(\(str\);)S +2420 V +9 B +1450(cdl_markText)S +9 C +2049(\(cdl,)S +2373(x,)S +2535(y,)S +2697(str,)S +2967(txsize,)S +3399(angle,)S +3777(color\);)S +2520 V +1450(break;)S +2620 V +1391(case)S +1661('C':)S +2825(/*)S +9 I +2987(Circular)S +3324(annuli)S +9 C +3554(*/)S +2720 V +9 B +1450(cdl_markCircAnnuli)S +9 C +2309(\(cdl,)S +2633(x,)S +2795(y,)S +2957(radius,)S +3389(nannuli,)S +3875(sep,)S +4145(color\);)S +2820 V +1450(break;)S +2920 V +1391(case)S +1661('D':)S +2825(/*)S +9 I +2987(Delete)S +3249(all)S +3371(markers)S +9 C +3666(*/)S +3020 V +9 B +1450(cdl_clearOverlay)S +9 C +2164(\(cdl\);)S +3120 V +1450(break;)S +3220 V +1391(case)S +1661('E':)S +2825(/*)S +9 I +2987(Elliptical)S +3349(annuli)S +9 C +3579(*/)S +3320 V +9 B +1450(cdl_markEllipAnnuli)S +9 C +2324(\(cdl,)S +2648(x,)S +2810(y,)S +2972(xrad,)S +3296(yrad,)S +3620(angle,)S +3998(nannuli,)S +4484(sep,)S +4754(color\);)S +3420 V +1450(break;)S +3520 V +1391(default:)S +3620 V +1450(break;)S +3720 V +1391(})S +3820 V +1175(})S +3920 V +900(})S +7920 V +EP +%%Page: 31 34 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +480 V +11 R +2936(- 31 -)S +840 V +11 B +900(12.3.)S +1187(Image)S +1512(Mosaic)S +1880(Example)S +976 V +9 R +1260(#include)S +1597(<stdio.h>)S +1076 V +1260(#include)S +1597(<unistd.h>)S +1176 V +1260(#)S +9 B +1305(include)S +1612("cdl.h")S +1376 V +9 R +1260(/*)S +9 I +1357(MOSAIC)S +1714(--)S +1801(Example)S +2143(task)S +2315(to)S +2412(mosaic)S +2694(several)S +2981(images)S +3263(on)S +3380(a)S +3452(display.)S +3762(Demonstrates)S +1476 V +1287(*)S +1359(usage)S +1596(of)S +1693(low-level)S +2050(routines)S +2372(for)S +2504(complex)S +2831(display)S +3118(operations.)S +1576 V +9 R +1287(*/)S +1776 V +1260(main)S +1467(\(argc,)S +1702(argv\))S +1876 V +1260(int)S +1535(argc;)S +1976 V +1260(char)S +1535(*argv[];)S +2076 V +1260({)S +2176 V +1535(CDLPtr)S +2085(cdl;)S +2276 V +1535(char)S +1810(*fname)S +2107(=)S +2184(NULL,)S +2474(title[128];)S +2376 V +1535(int)S +1810(i,)S +1885(j,)S +1960(k,)S +2055(status=0,)S +2405(label=0,)S +2725(frame=1,)S +3080(fb=FB_AUTO,)S +3660(zscale=1;)S +2476 V +1535(int)S +1810(sample=1,)S +2210(pad=0,)S +2485(col=204,)S +2830(imx,)S +3020(imy,)S +3210(bitpix,)S +3470(nimages,)S +3820(nim;)S +2576 V +1535(int)S +1810(ii,)S +1910(xinit,)S +2125(rowx,)S +2360(rowy,)S +2595(nnx,)S +2780(nny,)S +2965(fb_w,)S +3200(fb_h,)S +3415(nf,)S +3540(mx,)S +3705(my,)S +3870(nx,)S +4010(ny;)S +2676 V +1535(\257oat)S +1810(z1,)S +1945(z2;)S +2776 V +1535(unsigned)S +1887(char)S +2069(*pix)S +2256(=)S +2333(NULL;)S +2976 V +1535(/*)S +9 I +1632(Process)S +1944(the)S +2081(command)S +2458(line)S +2620(options.)S +9 R +2935(*/)S +3076 V +1535(if)S +1617(\(argc)S +1829(>)S +1906(1\))S +2008({)S +3176 V +1589(for)S +1721(\(i=1;)S +1923(i)S +1975(<)S +2052(argc;)S +2259(i++\))S +2441({)S +3276 V +1584(if)S +1666(\(strncmp)S +2013(\(argv[i],)S +2338("-fbcon\256g",3\))S +2867(==)S +2994(0\))S +3096(fb=atoi\(argv[++i]\);)S +3376 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-frame",3\))S +2976(==)S +3103(0\))S +3205(frame=atoi\(argv[++i]\);)S +3476 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-color",3\))S +2951(==)S +3078(0\))S +3180(col=atoi\(argv[++i]\);)S +3576 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-label",4\))S +2941(==)S +3068(0\))S +3170(label=1;)S +3676 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-nozscale",4\))S +3076(==)S +3203(0\))S +3305(zscale=0;)S +3776 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-nx",3\))S +2856(==)S +2983(0\))S +3085(nx=atoi\(argv[++i]\);)S +3876 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-ny",3\))S +2856(==)S +2983(0\))S +3085(ny=atoi\(argv[++i]\);)S +3976 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-pad",4\))S +2896(==)S +3023(0\))S +3125(pad=atoi\(argv[++i]\);)S +4076 V +1643(else)S +1810(if)S +1892(\(strncmp)S +2239(\(argv[i],"-sample",4\))S +3021(==)S +3148(0\))S +3250(sample=atoi\(argv[++i]\);)S +4176 V +1643(else)S +4276 V +1751(break;)S +4376 V +1589(})S +4476 V +1535(})S +4576 V +1535(nimages)S +1862(=)S +1939(argc)S +2121(-)S +2178(i;)S +4776 V +1535(/*)S +9 I +1632(Open)S +1854(the)S +1991(package)S +2318(and)S +2480(a)S +2552(connection)S +2974(to)S +3071(the)S +3208(server.)S +9 R +3483(*/)S +4876 V +1535(if)S +1617(\(!\(cdl)S +1844(=)S +9 B +1921(cdl_open)S +9 R +2293(\(\(char)S +2535(*\)getenv\("IMTDEV"\)\)\))S +3421(\))S +4976 V +1616(exit)S +1778(\(-1\);)S +5176 V +1535(/*)S +9 I +1632(Clear)S +1864(the)S +2001(frame)S +2238(to)S +2335(begin.)S +9 R +2585(*/)S +5276 V +1535(\(void\))S +9 B +1782(cdl_clearFrame)S +9 R +2414(\(cdl\);)S +5476 V +1535(/*)S +9 I +1632(Loop)S +1844(over)S +2031(each)S +2228(of)S +2325(the)S +2462(images)S +2744(in)S +2841(the)S +2978(list.)S +9 R +3138(*/)S +5576 V +1535(nim)S +1702(=)S +1779(rowx)S +1991(=)S +2068(rowy)S +2280(=)S +2357(nnx)S +2519(=)S +2596(nny)S +2758(=)S +2835(0;)S +5676 V +1535(for)S +1667(\(k=0;)S +1889(k)S +1961(<)S +2038(ny)S +2155(&&)S +2322(nim)S +2489(<)S +2566(nimages;)S +2918(k++\))S +3120({)S +5776 V +1643(rowy)S +1855(+=)S +1982(nny)S +2144(+)S +2221(pad;)S +5876 V +1643(for)S +1775(\(rowx)S +2017(=)S +2094(xinit,)S +2309(j=0;)S +2481(j)S +2533(<)S +2610(nx)S +2727(&&)S +2894(nim)S +3061(<)S +3138(nimages;)S +3490(j++\))S +3672({)S +6076 V +1810(/*)S +9 I +1907(Get)S +2064(the)S +2201(image)S +2448(name)S +2670(for)S +2802(display.)S +9 R +3112(*/)S +6176 V +1810(fname)S +2062(=)S +2139(argv[i++];)S +6376 V +1810(/*)S +9 I +1907(Figure)S +2179(out)S +2321(what)S +2523(kind)S +2705(of)S +2802(image)S +3049(it)S +3126(is)S +3213(and)S +3375(get)S +3512(the)S +3649(pixels.)S +9 R +3909(*/)S +6476 V +1810(if)S +1892(\(cdl_isIRAF)S +2369(\(fname\)\))S +6576 V +1918(status)S +2150(=)S +9 B +2227(cdl_readIRAF)S +9 R +2809(\(fname,)S +3114(1,)S +3209(&pix,)S +3444(&imx,)S +3704(&imy,)S +3964(&bitpix,)S +4294(title\);)S +6676 V +1810(else)S +1977(if)S +2059(\(cdl_isFITS)S +2516(\(fname\)\))S +6776 V +1918(status)S +2150(=)S +9 B +2227(cdl_readFITS)S +9 R +2789(\(fname,)S +3094(&pix,)S +3329(&imx,)S +3589(&imy,)S +3849(&bitpix,)S +4179(title\);)S +6876 V +1810(else)S +1977({)S +6976 V +1918(fprintf\(stderr,)S +2433("'%s':)S +2692(unknown)S +3054(or)S +3156(nonexistant)S +3598(image.\\n",)S +3998(fname\);)S +7076 V +1918(status)S +2150(=)S +2227(1;)S +7176 V +1810(})S +7276 V +1810(if)S +1892(\(status\))S +2211(goto)S +2398(err_;)S +7920 V +EP +%%Page: 32 35 +BP +/slant 0 def +/height 1.000000 def +9 R +9 R +460 V +11 R +2936(- 32 -)S +820 V +9 R +1810(/*)S +9 I +1907(Compute)S +2259(subsampled)S +2711(image)S +2958(size.)S +9 R +3143(*/)S +920 V +1810(if)S +1892(\(sample)S +2204(>)S +2281(1\))S +1020 V +1918(nnx)S +2080(=)S +2157(imx)S +2324(/)S +2376(sample,)S +2681(nny)S +2843(=)S +2920(imy)S +3087(/)S +3139(sample;)S +1120 V +1810(else)S +1220 V +1918(nnx)S +2080(=)S +2157(imx,)S +2347(nny)S +2509(=)S +2586(imy;)S +1420 V +1810(/*)S +9 I +1907(Unless)S +2179(we)S +2306(asked)S +2538(for)S +2670(a)S +2742(speci\256c)S +3039(FB)S +3176(size)S +3338(\256nd)S +3500(one)S +3657(large)S +3874(enough)S +1520 V +1837(*)S +1909(to)S +2006(handle)S +2278(the)S +2415(mosaic.)S +2747(We)S +2889(don't)S +3106(check)S +3338(to)S +3435(be)S +3547(sure)S +3729(what's)S +1620 V +1837(*)S +1909(returned)S +2246(is)S +2333(really)S +2570(large)S +2787(enough.)S +1720 V +9 R +1837(*/)S +1820 V +1810(if)S +1892(\(nim)S +2089(==)S +2216(0)S +2288(&&)S +2455(fb)S +2557(==)S +2684(FB_AUTO\))S +1920 V +9 B +1918(cdl_selectFB)S +9 R +2430(\(cdl,)S +2620(nx*nnx+\(pad*\(nx-1\)\),)S +3450(ny*nny+\(pad*\(ny-1\)\),)S +4280(&fb,)S +4475(&fb_w,)S +4780(&fb_h,)S +5065(&nf,)S +5260(1\);)S +2020 V +1810(else)S +1977({)S +2120 V +9 B +1918(cdl_setFBCon\256g)S +9 R +2580(\(cdl,)S +2770(fb\);)S +2220 V +9 B +1918(cdl_lookupFBSize)S +9 R +2640(\(cdl,)S +2830(fb,)S +2955(&fb_w,)S +3260(&fb_h,)S +3545(&nf\);)S +2320 V +1810(})S +2520 V +1810(/*)S +9 I +1907(De\256ne)S +2169(a)S +2241(WCS)S +2448(for)S +2580(the)S +2717(frame.)S +9 R +2977(*/)S +2620 V +9 B +1810(cdl_setWCS)S +9 R +2307(\(cdl,)S +2497("image)S +2781(mosaic",)S +3123(title,)S +3313(1.,)S +3431(0.,)S +3549(0.,)S +3667(-1.,)S +3815(0.,)S +3933(\(\257oat\))S +4180(ny*imy+\(pad*\(ny+1\)\),)S +5035(1.,)S +5153(255.,)S +5361(1\);)S +2820 V +1810(/*)S +9 I +1907(The)S +2069(\256rst)S +2236(time)S +2418(through)S +2730(\256gure)S +2967(out)S +3109(the)S +3246(placement)S +3643(so)S +3750(the)S +2920 V +1837(*)S +1909(entire)S +2146(mosaic)S +2428(is)S +2515(centered)S +2852(in)S +2949(the)S +3086(frame.)S +3020 V +9 R +1837(*/)S +3120 V +1810(if)S +1919(\(nim)S +2116(==)S +2243(0\))S +2345({)S +3220 V +1918(mx)S +2060(=)S +2137(\(nx)S +2284(*)S +2356(nnx\))S +2548(+)S +2625(pad)S +2782(*)S +2854(\(nx-1\);)S +3320 V +1918(my)S +2060(=)S +2137(\(ny)S +2284(*)S +2356(nny\))S +2548(+)S +2625(pad)S +2782(*)S +2854(\(ny-1\);)S +3420 V +1918(rowy)S +2130(=)S +2207(\(fb_h)S +2429(-)S +2486(my\))S +2658(/)S +2710(2;)S +3520 V +1918(xinit)S +2110(=)S +2187(rowx)S +2399(=)S +2476(\(fb_w)S +2718(-)S +2775(mx\))S +2947(/)S +2999(2;)S +3620 V +1810(})S +3820 V +1810(/*)S +9 I +1907(Compute)S +2259(the)S +2396(zscaled)S +2688(imaged)S +2980(pixels.)S +9 R +3240(*/)S +3920 V +1810(if)S +1892(\(zscale\))S +2199({)S +4020 V +9 B +1918(cdl_computeZscale)S +9 R +2680(\(cdl,)S +2870(pix,)S +3035(imx)S +3202(,imy,)S +3415(bitpix,)S +3675(&z1,)S +3880(&z2\);)S +4120 V +9 B +1918(cdl_zscaleImage)S +9 R +2570(\(cdl,)S +2760(&pix,)S +2995(imx)S +3162(,imy,)S +3375(bitpix,)S +3635(z1,)S +3770(z2\);)S +4220 V +1810(})S +4420 V +1810(/*)S +9 I +1907(Subsample)S +2324(the)S +2461(image)S +2708(if)S +2785(requested.)S +9 R +3185(*/)S +4520 V +1810(if)S +1892(\(sample)S +2204(>)S +2281(1\))S +2383({)S +4620 V +1918(int)S +2040(l,)S +2115(m,)S +2235(n=0;)S +4720 V +1918(for)S +2050(\(l=0;)S +2252(l)S +2304(<)S +2381(imy;)S +2573(l+=sample\))S +4820 V +2026(for)S +2158(\(m=0;)S +2405(m)S +2502(<)S +2579(imx;)S +2771(m+=sample\))S +4920 V +2134(pix[n++])S +2481(=)S +2558(pix[\(l*imx\)+m];)S +5020 V +1810(})S +5220 V +1810(/*)S +9 I +1907(Write)S +2134(the)S +2271(image)S +2518(to)S +2615(the)S +2752(frame)S +2989(bu)S +3079 H + (f)show 9 -.5 mul h (f)show +9 I +3125(er.)S +9 R +3250(*/)S +5320 V +1810(if)S +1892(\()S +9 B +1922(cdl_writeSubRaster)S +9 R +2714(\(cdl,)S +2904(rowx,)S +3139(rowy,)S +3374(nnx,)S +3559(nny,)S +3744(pix\)\))S +3946(goto)S +4133(err_;)S +5520 V +1810(/*)S +9 I +1907(Draw)S +2139(the)S +2276(image)S +2523(name)S +2745(as)S +2852(a)S +2924(label.)S +9 R +3154(*/)S +5620 V +1810(if)S +1892(\(label\))S +9 B +2154(cdl_markText)S +9 R +2726(\(cdl,)S +2916(rowx+10,)S +3291(rowy+10,)S +3666(fname,)S +3941(1.,)S +4059(0.,)S +4177(col\);)S +5820 V +1810(nim++;)S +2360(rowx)S +2572(+=)S +2699(nnx)S +2861(+)S +2938(pad;)S +5920 V +1643(})S +6020 V +1535(})S +6220 V +1535(/*)S +9 I +1632(Close)S +1864(the)S +2001(package)S +2328(and)S +2490(clean)S +2712(up.)S +9 R +2852(*/)S +6320 V +1260(err_:)S +9 B +1535(cdl_close)S +9 R +1907(\(cdl\);)S +6420 V +1535(exit)S +1697(\(status\);)S +6520 V +1260(})S +7920 V +EP +%%Page: 33 36 +BP +/slant 0 def +/height 1.000000 def +9 R +9 R +480 V +11 R +2936(- 33 -)S +840 V +11 B +900(13.)S +1104(Fortran)S +1541(Interface)S +1998(Summary)S +996 V +11 R +1260(include)S +1649(")S +11 B +1694(cdlftn.inc)S +11 R +2138(")S +1296 V +11 B +1910(cfopen)S +11 R +2386(\(imtdev,)S +2789(ier\))S +1416 V +11 B +1645(cfdisplayPix)S +11 R +2386(\(pix,)S +2624(nx,)S +2795(ny,)S +2966(bitpix,)S +3285(frame,)S +3600(fbcon\256g,)S +4027(zscale,)S +4354(ier\))S +1536 V +11 B +1589(cfreadCursor)S +11 R +2386(\(sample,)S +2794(x,)S +2910(y,)S +3026(key,)S +3245(ier\))S +1656 V +11 B +1675(cfsetCursor)S +11 R +2386(\(x,)S +2538(y,)S +2654(wcs,)S +2885(ier\))S +1776 V +11 B +1759(cfsetWCS)S +11 R +2386(\(name,)S +2720(title,)S +2953(a,)S +3062(b,)S +3178(c,)S +3287(d,)S +3403(tx,)S +3550(ty,)S +3697(z1,)S +3861(z2,)S +4025(zt,)S +4165(ier\))S +1896 V +11 B +1747(cfgetWCS)S +11 R +2386(\(name,)S +2720(title,)S +2953(a,)S +3062(b,)S +3178(c,)S +3287(d,)S +3403(tx,)S +3550(ty,)S +3697(z1,)S +3861(z2,)S +4025(zt,)S +4165(ier\))S +2016 V +11 B +1701(cfsetFrame)S +11 R +2386(\(frame\))S +2136 V +11 B +1598(cfclearFrame)S +11 R +2386(\(ier\))S +2256 V +11 B +1912(cfclose)S +11 R +2386(\(\))S +2496 V +11 B +1580(cfsetMapping)S +11 R +2386(\(region,)S +2763(sx,sy,snx,sny,)S +3410(dx,dy,dnx,dny,)S +4105(ref,)S +4286(ier\))S +2616 V +11 B +1568(cfgetMapping)S +11 R +2386(\(region,)S +2763(sx,sy,snx,sny,)S +3410(dx,dy,dnx,dny,)S +4105(ref,)S +4286(ier\))S +2736 V +11 B +1642(cfqueryMap)S +11 R +2386(\(wcs,)S +2653(region,)S +2994(sx,sy,snx,sny,)S +3641(dx,dy,dnx,dny,)S +4336(objref,)S +4658(ier\))S +2976 V +11 B +1530(cfdisplayIRAF)S +11 R +2386(\(fname,)S +2756(band,)S +3030(frame,)S +3345(fbcon\256g,)S +3772(zscale,)S +4099(ier\))S +3096 V +11 B +1800(c\256sIRAF)S +11 R +2386(\(fname,)S +2756(isiraf\))S +3216 V +11 B +1656(cfreadIRAF)S +11 R +2386(\(fname,)S +2756(band,)S +3030(pix,)S +3232(nx,)S +3403(ny,)S +3574(bitpix,)S +3893(title,)S +4126(ier\))S +3456 V +11 B +1552(cfdisplayFITS)S +11 R +2386(\(fname,)S +2756(frame,)S +3071(fbcon\256g,)S +3498(zscale,)S +3825(ier\))S +3576 V +11 B +1822(c\256sFITS)S +11 R +2386(\(fname,)S +2756(is\256ts\))S +3696 V +11 B +1678(cfreadFITS)S +11 R +2386(\(fname,)S +2756(pix,)S +2958(nx,)S +3129(ny,)S +3300(bitpix,)S +3619(title,)S +3852(ier\))S +3936 V +11 B +1436(cfcomputeZscale)S +11 R +2386(\(pix,)S +2624(nx,)S +2795(ny,)S +2966(bitpix,)S +3285(z1,)S +3449(z2\))S +4056 V +11 B +1572(cfzscaleImage)S +11 R +2386(\(pix,)S +2624(nx,)S +2795(ny,)S +2966(bitpix,)S +3285(z1,)S +3449(z2\))S +4296 V +11 B +1745(cfprintPix)S +11 R +2386(\(cmd,)S +2672(pix,)S +2874(nx,)S +3045(ny,)S +3216(annotate,)S +3648(ier\))S +4416 V +11 B +1439(cfprintPixToFile)S +11 R +2386(\(fname,)S +2756(pix,)S +2958(nx,)S +3129(ny,)S +3300(annotate,)S +3732(ier\))S +4656 V +11 B +1632(cfreadImage)S +11 R +2386(\(pix,)S +2624(nx,)S +2795(ny,)S +2966(ier\))S +4776 V +11 B +1316(cfreadFrameBu)S +2058 H + (f)show 11 -.5 mul h (f)show +11 B +2125(er)S +11 R +2386(\(pix,)S +2624(nx,)S +2795(ny,)S +2966(ier\))S +4896 V +11 B +1429(cfreadSubRaster)S +11 R +2386(\(lx,)S +2569(ly,)S +2716(nx,)S +2887(ny,)S +3058(pix,)S +3260(ier\))S +5016 V +11 B +1400(cfwriteSubRaster)S +11 R +2386(\(lx,)S +2569(ly,)S +2716(nx,)S +2887(ny,)S +3058(pix,)S +3260(ier\))S +5256 V +11 B +1742(cfselectFB)S +11 R +2386(\(nx,)S +2593(ny,)S +2764(fb,)S +2916(w,)S +3056(h,)S +3172(nf,)S +3324(reset\))S +5376 V +11 B +1556(cfsetFBCon\256g)S +11 R +2386(\(con\256gno\))S +5496 V +11 B +1544(cfgetFBCon\256g)S +11 R +2386(\(con\256gno,)S +2868(w,)S +3008(h,)S +3124(nf\))S +5616 V +11 B +1485(c\257ookupFBSize)S +11 R +2386(\(con\256gno,)S +2868(w,)S +3008(h,)S +3124(nf\))S +5856 V +11 B +1654(cfsetZTrans)S +11 R +2386(\(ztrans\))S +5976 V +11 B +1692(cfsetZScale)S +11 R +2386(\(z1,)S +2586(z2\))S +6096 V +11 B +1661(cfsetSample)S +11 R +2386(\(nsample\))S +6216 V +11 B +1403(cfsetSampleLines)S +11 R +2386(\(nlines\))S +6336 V +11 B +1596(cfsetContrast)S +11 R +2386(\(contrast\))S +6456 V +11 B +1737(cfsetName)S +11 R +2386(\(imname\))S +6576 V +11 B +1790(cfsetTitle)S +11 R +2386(\(imtitle\))S +6816 V +11 B +1689(cfgetFrame)S +11 R +2386(\(frame\))S +6936 V +11 B +1642(cfgetZTrans)S +11 R +2386(\(ztrans\))S +7056 V +11 B +1680(cfgetZScale)S +11 R +2386(\(z1,)S +2586(z2\))S +7176 V +11 B +1649(cfgetSample)S +11 R +2386(\(nsample\))S +7296 V +11 B +1391(cfgetSampleLines)S +11 R +2386(\(nlines\))S +7920 V +EP +%%Page: 34 37 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 34 -)S +840 V +11 B +1584(cfgetContrast)S +11 R +2386(\(contrast\))S +960 V +11 B +1725(cfgetName)S +11 R +2386(\(imname\))S +1080 V +11 B +1778(cfgetTitle)S +11 R +2386(\(imtitle\))S +1320 V +11 B +1620(cfmapFrame)S +11 R +2386(\(frame,)S +2737(ier\))S +1440 V +11 B +1630(cfmarkPoint)S +11 R +2386(\(x,)S +2538(y,)S +2654(number,)S +3050(size,)S +3281(type,)S +3531(color,)S +3817(ier\))S +1560 V +11 B +1429(cfmarkcoords\256le)S +11 R +2386(\(fname,)S +2756(type,)S +3006(size,)S +3237(color,)S +3523(label,)S +3797(ier\))S +1680 V +11 B +1360(cfmarkPointLabel)S +11 R +2386(\(x,)S +2538(y,)S +2654(label,)S +2928(size,)S +3159(type,)S +3409(color,)S +3695(ier\))S +1800 V +11 B +1666(cfmarkLine)S +11 R +2386(\(xs,)S +2581(ys,)S +2740(xe,)S +2904(ye,)S +3068(color,)S +3354(ier\))S +1920 V +11 B +1697(cfmarkBox)S +11 R +2386(\(lx,)S +2569(ly,)S +2716(ux,)S +2887(uy,)S +3058(\256ll,)S +3243(color,)S +3529(ier\))S +2040 V +11 B +1501(cfmarkPolygon)S +11 R +2386(\(xarray,)S +2761(yarray,)S +3100(npts,)S +3345(\256ll,)S +3530(color,)S +3816(ier\))S +2160 V +11 B +1501(cfmarkPolyline)S +11 R +2386(\(xarray,)S +2761(yarray,)S +3100(npts,)S +3345(color,)S +3631(ier\))S +2280 V +11 B +1596(cfmarkCircle)S +11 R +2386(\(x,)S +2538(y,)S +2654(radius,)S +2983(\256ll,)S +3168(color,)S +3454(ier\))S +2400 V +11 B +1348(cfmarkCircAnnuli)S +11 R +2386(\(x,)S +2538(y,)S +2654(radius,)S +2983(nannuli,)S +3374(sep,)S +3581(color,)S +3867(ier\))S +2520 V +11 B +1561(cfmarkEllipse)S +11 R +2386(\(x,)S +2538(y,)S +2654(xrad,)S +2909(yrad,)S +3164(rotang,)S +3505(\256ll,)S +3690(color,)S +3976(ier\))S +2640 V +11 B +1325(cfmarkEllipAnnuli)S +11 R +2386(\(x,)S +2538(y,)S +2654(xrad,)S +2909(yrad,)S +3164(ang,)S +3383(nannuli,)S +3774(sep,)S +3981(color,)S +4267(ier\))S +2760 V +11 B +1668(cfmarkText)S +11 R +2386(\(x,)S +2538(y,)S +2654(str,)S +2825(size,)S +3056(angle,)S +3354(color,)S +3640(ier\))S +2880 V +11 B +1821(cfsetfont)S +3000 V +1565(cfsettextwidth)S +11 R +2386(\(width\))S +3120 V +11 B +1709(cfsetlwidth)S +11 R +2386(\(width\))S +3240 V +11 B +1766(cfsetlstyle)S +11 R +2386(\(style\))S +3360 V +11 B +1596(cfdeleteMark)S +11 R +2386(\(x,)S +2538(y,)S +2654(ier\))S +3480 V +11 B +1529(cfclearOverlay)S +11 R +2386(\(ier\))S +3600 V +11 B +1419(cfredrawOverlay)S +11 R +2386(\(ier\))S +7920 V +EP +%%Page: 35 38 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 35 -)S +840 V +11 B +900(14.)S +1104(Fortran)S +1508(Example)S +1957(Tasks)S +996 V +11 R +1175(The)S +1381(examples)S +1831(shown)S +2154(here)S +2377(are)S +2545(for)S +2708(demonstration)S +3374(purposes)S +3801(only.)S +4095(They)S +4357(are)S +4526(based)S +4812(on)S +4959(work-)S +1116 V +900(ing)S +1079(example)S +1488(tasks)S +1746(in)S +1870(the)S +2042(CDL)S +2300(source)S +11 I +2622(examples)S +11 R +3066(subdirectory,)S +3679(see)S +3855(the)S +4026(programs)S +4477(there)S +4732(for)S +4896(the)S +5067(full)S +1236 V +900(program)S +1304(listing.)S +1596 V +11 B +900(14.1.)S +1187(Display)S +1576(Example)S +1796 V +9 C +1260(C)S +1368(========================================================================)S +1896 V +1260(C)S +1422(FDISPLAY)S +1908(--)S +2070(Example)S +2502(fortran)S +2934(program)S +3366(showing)S +3798(the)S +4014(use)S +4230(of)S +4392(the)S +4608(Client)S +1996 V +1260(C)S +1422(Display)S +1854(Library)S +2286(\(CDL\))S +2610(Fortran)S +3042(interface)S +3582(for)S +3798(displaying)S +4392(images.)S +2096 V +1260(C)S +1368(========================================================================)S +2296 V +1535(PROGRAM)S +1967(FDISPLAY)S +2396 V +1535(character*64)S +2345(imname)S +2596 V +1260(C)S +9 I +1535(Initialize)S +1882(the)S +2019(CDL)S +2221(package)S +2696 V +9 C +1535(call)S +9 B +1805(cfopen)S +9 C +2114(\(0,)S +2330(ier\))S +2796 V +1535(if)S +1697(\(ier)S +1967(.gt.)S +2237(0\))S +2399(then)S +2896 V +1751(write)S +2075(\(*,*\))S +2399('open:)S +2777(Error)S +3101(return)S +3479(from)S +3749(CDL')S +2996 V +1751(goto)S +2021(999)S +3096 V +1535(endif)S +3296 V +1535(write)S +1859(\(*,)S +2075("\('Image)S +2561(Name:)S +2885(',)S +3047($\)"\))S +3396 V +1535(read)S +1805(\(5,)S +2021(*\))S +2183(imname)S +3496 V +1535(write)S +1859(\(*,)S +2075("\('Frame)S +2561(Number:)S +2993(',)S +3155($\)"\))S +3596 V +1535(read)S +1805(\(5,)S +2021(*\))S +2183(iframe)S +3696 V +1535(write)S +1859(\(*,)S +2075("\('Frame)S +2561(buffer)S +2939(configuration)S +3695(number:)S +4127(',)S +4289($\)"\))S +3796 V +1535(read)S +1805(\(5,)S +2021(*\))S +2183(ifb)S +3996 V +1260(C)S +9 I +1535(If)S +1617(we've)S +1854(got)S +1996(a)S +2068(FITS)S +2275(format)S +2542(image,)S +2812(go)S +2929(ahead)S +3176(and)S +3338(display)S +3625(it.)S +4096 V +9 C +1535(call)S +9 B +1805(c\256sFITS)S +9 C +2184(\(imname,)S +2670(isfits\))S +4196 V +1535(if)S +1697(\(isfits)S +2129(.gt.)S +2399(0\))S +2561(then)S +4296 V +1751(call)S +9 B +2021(cfdisplayFITS)S +9 C +2620(\(imname,)S +3106(iframe,)S +3538(ifb,)S +3808(1,)S +3970(ier\))S +4396 V +1535(else)S +4496 V +1260(C)S +9 I +1751(We've)S +2003(got)S +2145(an)S +2262(IRAF)S +2484(format)S +2751(image,)S +3021(go)S +3138(ahead)S +3385(and)S +3547(display)S +3834(it.)S +4596 V +9 C +1751(call)S +9 B +2021(c\256sIRAF)S +9 C +2420(\(imname,)S +2906(isiraf\))S +4696 V +1751(if)S +1913(\(isiraf)S +2345(.gt.)S +2615(0\))S +2777(then)S +4796 V +1967(call)S +9 B +2237(cfdisplayIRAF)S +9 C +2856(\(imname,)S +3342(1,)S +3504(iframe,)S +3936(ifb,)S +4206(1,)S +4368(ier\))S +4896 V +1751(else)S +4996 V +1260(C)S +9 I +1810(Unrecognized)S +2342(image,)S +2612(punt)S +2799(and)S +2961(exit.)S +5096 V +9 C +1967(write)S +2291(\(*,*\))S +2615('Unrecognized)S +3371(image)S +3695(format')S +5196 V +1751(endif)S +5296 V +1535(endif)S +5496 V +1260(C)S +9 I +1535(Clean)S +1777(up)S +1894(and)S +2056(exit.)S +5596 V +9 C +1260(999)S +1535(continue)S +5696 V +1535(call)S +9 B +1805(cfclose)S +9 C +2114(\(ier\))S +5796 V +1535(end)S +7920 V +EP +%%Page: 36 39 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +480 V +11 R +2936(- 36 -)S +840 V +11 B +900(14.2.)S +1187(Interactive)S +1730(Graphics)S +2198(Overlay)S +2609(Example)S +1040 V +9 C +1260(C)S +1368(==========================================================================)S +1140 V +1260(C)S +1422(FTVMARK)S +1854(--)S +2070(Example)S +2502(fortran)S +2934(program)S +3366(showing)S +3798(the)S +4014(use)S +4230(of)S +4392(the)S +4608(Client)S +1240 V +1260(C)S +1422(Display)S +1854(Library)S +2286(\(CDL\))S +2610(Fortran)S +3042(interface)S +3582(for)S +3798(doing)S +4122(graphics)S +4608(overlay.)S +5094(No)S +1340 V +1260(C)S +1422(checking)S +1908(of)S +2070(the)S +2286(error)S +2610(flag)S +2880(is)S +3042(done)S +3312(here)S +3582(for)S +3798(space)S +4122(considerations.)S +1440 V +1260(C)S +1368(==========================================================================)S +1640 V +1535(PROGRAM)S +1967(FTVMARK)S +1740 V +1535(include)S +2085(")S +9 B +2139(cdlftn.inc)S +9 C +2502(")S +1840 V +1535(character*64)S +2360(imname)S +2040 V +1260(C)S +9 I +1535(Initialize)S +1882(the)S +2019(CDL)S +2221(package)S +2140 V +9 C +1535(call)S +9 B +1805(cfopen)S +9 C +2114(\(0,)S +2330(ier\))S +2340 V +1535(write)S +1859(\(*,)S +2075("\('Image)S +2561(Name:)S +2885(',)S +3047($\)"\))S +2440 V +1535(read)S +1805(\(5,)S +2021(*\))S +2183(imname)S +2540 V +1535(write)S +1859(\(*,)S +2075("\('Frame)S +2561(Number:)S +2993(',)S +3155($\)"\))S +2640 V +1535(read)S +1805(\(5,)S +2021(*\))S +2183(iframe)S +2740 V +1535(write)S +1859(\(*,)S +2075("\('Frame)S +2561(buffer)S +2939(configuration)S +3695(number:)S +4127(',)S +4289($\)"\))S +2840 V +1535(read)S +1805(\(5,)S +2021(*\))S +2183(ifb)S +3040 V +1260(C)S +9 I +1535(If)S +1617(we've)S +1854(got)S +1996(a)S +2068(FITS)S +2275(format)S +2542(image,)S +2812(go)S +2929(ahead)S +3176(and)S +3338(display)S +3625(it.)S +3140 V +9 C +1535(call)S +9 B +1805(c\256sFITS)S +9 C +2184(\(imname,)S +2670(isfits\))S +3240 V +1535(if)S +1697(\(isfits)S +2129(.gt.)S +2399(0\))S +2561(then)S +3340 V +1751(call)S +9 B +2021(cfdisplayFITS)S +9 C +2620(\(imname,)S +3106(iframe,)S +3538(ifb,)S +3808(1,)S +3970(ier\))S +3440 V +1535(else)S +3540 V +1260(C)S +9 I +1751(We've)S +2003(got)S +2145(an)S +2262(IRAF)S +2484(format)S +2751(image,)S +3021(go)S +3138(ahead)S +3385(and)S +3547(display)S +3834(it.)S +3640 V +9 C +1751(call)S +9 B +2021(c\256sIRAF)S +9 C +2420(\(imname,)S +2906(isiraf\))S +3740 V +1751(if)S +1913(\(isiraf)S +2345(.gt.)S +2615(0\))S +2777(then)S +3840 V +1967(call)S +9 B +2237(cfdisplayIRAF)S +9 C +2856(\(imname,)S +3342(1,)S +3504(iframe,)S +3936(ifb,)S +4206(1,)S +4368(ier\))S +3940 V +1751(else)S +4040 V +1260(C)S +9 I +1967(No)S +2099(valid)S +2306(image)S +2553(given,)S +2798(so)S +2905(map)S +3087(the)S +3224(current)S +3516(display)S +3803(for)S +3935(marking.)S +4140 V +9 C +1967(call)S +9 B +2237(cfmapFrame)S +9 C +2786(\(iframe\))S +4240 V +1751(endif)S +4340 V +1535(endif)S +4540 V +1260(C)S +9 I +1535(Now)S +1727(that)S +1894(we've)S +2131(got)S +2273(an)S +2390(image)S +2637(displayed)S +3009(or)S +3116(mapped,)S +3451(enter)S +3663(a)S +3735(cursor)S +3997(loop)S +4184(to)S +4281(mark)S +4493(the)S +4630(image.)S +4640 V +9 C +1535(call)S +1805(markInteractive)S +2669(\(\))S +4840 V +1260(C)S +9 I +1535(Clean)S +1777(up)S +1894(and)S +2056(exit)S +4940 V +9 C +1260(999)S +1535(continue)S +5040 V +1535(call)S +9 B +1805(cfclose)S +9 C +2114(\(ier\))S +5140 V +1535(end)S +5340 V +1260(C)S +9 I +1476(MARKINTERACTIVE)S +2303(--)S +2390(Subroutine)S +2812(for)S +2944(processing)S +3361(the)S +3498(cursor)S +3760(loop.)S +5440 V +9 C +1535(subroutine)S +2129(markInteractive)S +2993(\(\))S +5540 V +1535(include)S +2085(")S +9 B +2139(cdlftn.inc)S +9 C +2502(")S +5640 V +1535(real)S +2085(angle,)S +2463(rx,)S +2679(ry,)S +2895(txsize)S +5740 V +1535(integer)S +2360(nx,)S +2576(ny,)S +2792(x,)S +2954(y,)S +3116(x2,)S +3332(y2,)S +3548(fill,)S +3872(size,)S +4196(color)S +5840 V +1535(integer)S +2360(number,)S +2792(radius,)S +3224(xrad,)S +3548(yrad,)S +3872(nannuli,)S +4358(sep)S +5940 V +1535(character)S +2085(key)S +6040 V +1535(character*64)S +2360(cmd,)S +2630(str)S +6240 V +1260(C)S +9 I +1535(Allocate)S +1862(a)S +1934(1024x1024)S +2361(array)S +2588(for)S +2720(pixels.)S +6340 V +9 C +1535(character)S +2085(pix\(1048576\))S +6540 V +1260(C)S +9 I +1535(....Initialize)S +1974(the)S +2111(local)S +2318(parameters)S +2755(to)S +2852(use)S +6740 V +9 C +1260(C)S +9 I +1535(Read)S +1747(a)S +1819(cursor)S +2081(keystroke)S +2448(telling)S +2705(us)S +2812(what)S +3014(to)S +3111(do.)S +6840 V +9 C +1260(10)S +1535(call)S +9 B +1805(cfreadCursor)S +9 C +2379(\(0,)S +2595(rx,)S +2811(ry,)S +3027(key,)S +3297(ier\))S +7040 V +1260(C)S +9 I +1535(Round)S +1797(the)S +1934(real)S +2106(cursor)S +2368(position)S +2685(to)S +2782(integer)S +3064(pixel)S +3266(positions.)S +7140 V +9 C +1751(x)S +1859(=)S +1967(nint)S +2237(\(rx)S +2453(+)S +2561(0.5\))S +7240 V +1751(y)S +1859(=)S +1967(nint)S +2237(\(ry)S +2453(+)S +2561(0.5\))S +7920 V +EP +%%Page: 37 40 +BP +/slant 0 def +/height 1.000000 def +9 C +9 C +460 V +11 R +2936(- 37 -)S +820 V +9 C +1260(C)S +9 I +1535(Check)S +1787(the)S +1924(keystroke)S +2291(and)S +2453(take)S +2630(the)S +2767(appropriate)S +3224(action.)S +920 V +9 C +1260(C)S +9 I +1751(Colon)S +1998(Commands)S +1020 V +9 C +1751(if)S +1913(\(key)S +2183(.eq.)S +2453(':'\))S +2723(then)S +1120 V +1260(C)S +9 I +1810(Read)S +2022(a)S +2094(three)S +2306(character)S +2683(command)S +3060(and)S +3222(value)S +3444(\256eld)S +3626(and)S +3788(process)S +4090(the)S +4227(colon)S +4454(command)S +1220 V +9 C +1810(read)S +2080(\(*,'\(A3,)S +2566(i4\)'\))S +2890(cmd,)S +3160(ival)S +1320 V +1810(if)S +1972(\(cmd\(1:3\))S +2512(.eq.)S +2782('ang'\))S +3160(then)S +1420 V +2026(angle)S +2350(=)S +2458(real)S +2728(\(ival\))S +1520 V +1810(else)S +2080(if)S +2242(\(cmd\(1:3\))S +2782(.eq.)S +3052('col'\))S +3430(then)S +1620 V +2026(color)S +2350(=)S +2458(ival)S +1720 V +1810(else)S +2080(if)S +2242(\(cmd\(1:3\))S +2782(.eq.)S +3052('fil'\))S +3430(then)S +1820 V +2026(fill)S +2296(=)S +2404(ival)S +1920 V +9 I +2085(:)S +2020 V +2085(....and)S +2339(so)S +2446(on)S +2563(to)S +2660(set)S +2787(local)S +2994(variables)S +2120 V +2085(:)S +2220 V +9 R +1810(else)S +1977(if)S +2059(\(cmd\(1:3\))S +2446(.eq.)S +2604('pri'\))S +2821(then)S +2320 V +1260(C)S +9 I +1918(Print)S +2130(contents)S +2457(of)S +2554(the)S +2691(current)S +2983(frame)S +3220(bu)S +3310 H + (f)show 9 -.5 mul h (f)show +9 I +3356(er)S +2420 V +9 R +1918(call)S +9 B +2075(cfreadFrameBu)S +2685 H + (f)show 9 -.5 mul h (f)show +9 B +2740(er)S +9 R +2847(\(pix,)S +3042(nx,)S +3182(ny,)S +3322(ier\))S +2520 V +1918(call)S +9 B +2075(cfprintPix)S +9 R +2492(\("lpr",)S +2746(pix,)S +2911(nx,)S +3051(ny,)S +3191(1,)S +3286(ier\))S +2620 V +1810(else)S +1977(if)S +2059(\(cmd\(1:3\))S +2446(.eq.)S +2604('sta'\))S +2821(then)S +2720 V +9 I +2085(....print)S +2379(out)S +2521(the)S +2658(status)S +2895(\(value\))S +3177(of)S +3274(variables)S +2820 V +9 R +1810(endif)S +3020 V +1260(C)S +9 I +1643(Point)S +1865(Markers)S +3120 V +9 R +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('p'\))S +2399(then)S +3220 V +1810(call)S +9 B +1967(cfmarkPoint)S +9 R +2479(\(x,)S +2604(y,)S +2699(1,)S +2794(size,)S +2984(M_PLUS,)S +3379(color,)S +3614(ier\))S +3320 V +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('x'\))S +2399(then)S +3420 V +1810(call)S +9 B +1967(cfmarkPoint)S +9 R +2479(\(x,)S +2604(y,)S +2699(1,)S +2794(size,)S +2984(M_CROSS,)S +3444(color,)S +3679(ier\))S +3520 V +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('_'\))S +2399(then)S +3620 V +1810(call)S +9 B +1967(cfmarkPoint)S +9 R +2479(\(x,)S +2604(y,)S +2699(1,)S +2794(size,)S +2984(M_HBLINE,)S +3489(color,)S +3724(ier\))S +3720 V +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('o'\))S +2399(then)S +3820 V +1260(C)S +9 I +1810(Example)S +2152(of)S +2249(a)S +2321(\256lled)S +2528(point)S +2740(marker)S +3920 V +9 R +1810(call)S +9 B +1967(cfmarkPoint)S +9 R +2479(\(x,)S +2604(y,)S +2699(1,)S +2794(size,)S +2984(or\(M_CIRCLE,\256ll\),)S +3737(color,)S +3972(ier\))S +4020 V +9 I +2085(:)S +4120 V +2085(....and)S +2339(so)S +2446(on)S +2563(to)S +2660(set)S +2787(other)S +3004(types)S +3216(of)S +3313(point)S +3525(markers)S +4320 V +9 R +1260(C)S +9 I +1643(Other)S +1880(Markers)S +4420 V +9 R +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('b'\))S +2399(then)S +4520 V +1810(print)S +2007('\("Hit)S +2246(another)S +2543(key)S +2700(to)S +2797(de\256ne)S +3044(the)S +3181(box)S +3343(...."\)')S +4620 V +1810(call)S +9 B +1967(cfreadCursor)S +9 R +2514(\(0,)S +2639(rx,)S +2764(ry,)S +2889(key,)S +3069(ier\))S +4720 V +1810(x2)S +1927(=)S +2004(nint)S +2171(\(rx)S +2303(+)S +2380(0.5\))S +4820 V +1810(y2)S +1927(=)S +2004(nint)S +2171(\(ry)S +2303(+)S +2380(0.5\))S +4920 V +1810(call)S +9 B +1967(cfmarkBox)S +9 R +2424(\(x,)S +2549(y,)S +2644(x2,)S +2784(y2,)S +2924(\256ll,)S +3074(color,)S +3309(ier\))S +5020 V +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('d'\))S +2399(then)S +5120 V +1810(call)S +9 B +1967(cfdeleteMark)S +9 R +2509(\(x,)S +2634(y,)S +2729(ier\))S +5220 V +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('e'\))S +2394(then)S +5320 V +1810(call)S +9 B +1967(cfmarkEllipse)S +9 R +2534(\(x,)S +2659(y,)S +2754(xrad,)S +2964(yrad,)S +3174(angle,)S +3419(\256ll,)S +3569(color,)S +3804(ier\))S +5420 V +1584(else)S +1751(if)S +1833(\(key)S +2020(.eq.)S +2178('t'\))S +2320(then)S +5520 V +1692(print)S +1889('\("Text)S +2178(string:)S +2462(",)S +2549($\)')S +5620 V +1692(read)S +1874(\(*,'\(A64\)'\))S +2304(str)S +5720 V +1692(call)S +9 B +1849(cfmarkText)S +9 R +2331(\(x,)S +2456(y,)S +2551(str,)S +2691(txsize,)S +2951(angle,)S +3196(color,)S +3431(ier\))S +5820 V +9 I +2085(:)S +5920 V +2085(....and)S +2339(so)S +2446(on)S +2563(to)S +2660(set)S +2787(other)S +3004(types)S +3216(of)S +3313(markers)S +6120 V +9 R +1260(C)S +9 I +1643(Quit)S +6220 V +9 R +1643(else)S +1810(if)S +1892(\(key)S +2079(.eq.)S +2237('q'\))S +2399(then)S +6320 V +1810(goto)S +1997(998)S +6420 V +1643(endif)S +6620 V +1260(C)S +9 I +1535(Loop)S +1747(back)S +1944(until)S +2136(we)S +2263(want)S +2465(to)S +2562(quit)S +6720 V +9 R +1535(goto)S +1722(10)S +6820 V +1260(998)S +1535(continue)S +6920 V +1535(end)S +7920 V +EP +%%Page: 38 41 +BP +/slant 0 def +/height 1.000000 def +9 R +9 R +480 V +11 R +2936(- 38 -)S +840 V +11 B +900(15.)S +1104(SPP)S +1333(Interface)S +1790(Summary)S +996 V +11 R +1260(#include)S +1704(")S +11 B +1749(cdlspp.h)S +11 R +2147(")S +1296 V +11 B +1854(cdl_open)S +11 R +2442(\(imtdev,)S +2845(ier\))S +1416 V +11 B +1589(cdl_displayPix)S +11 R +2442(\(pix,)S +2680(nx,)S +2851(ny,)S +3022(bitpix,)S +3341(frame,)S +3656(fbcon\256g,)S +4083(zscale,)S +4410(ier\))S +1536 V +11 B +1533(cdl_readCursor)S +11 R +2442(\(sample,)S +2850(x,)S +2966(y,)S +3082(wcs,)S +3313(key,)S +3532(ier\))S +1656 V +11 B +1619(cdl_setCursor)S +11 R +2442(\(x,)S +2594(y,)S +2710(wcs,)S +2941(ier\))S +1776 V +11 B +1703(cdl_setWCS)S +11 R +2442(\(name,)S +2776(title,)S +3009(a,)S +3118(b,)S +3234(c,)S +3343(d,)S +3459(tx,)S +3606(ty,)S +3753(z1,)S +3917(z2,)S +4081(zt,)S +4221(ier\))S +1896 V +11 B +1691(cdl_getWCS)S +11 R +2442(\(name,)S +2776(title,)S +3009(a,)S +3118(b,)S +3234(c,)S +3343(d,)S +3459(tx,)S +3606(ty,)S +3753(z1,)S +3917(z2,)S +4081(zt,)S +4221(ier\))S +2016 V +11 B +1645(cdl_setFrame)S +11 R +2442(\(frame\))S +2136 V +11 B +1542(cdl_clearFrame)S +11 R +2442(\(ier\))S +2256 V +11 B +1856(cdl_close)S +11 R +2442(\(\))S +2496 V +11 B +1524(cdl_setMapping)S +11 R +2442(\(region,)S +2819(sx,sy,snx,sny,)S +3466(dx,dy,dnx,dny,)S +4161(ref,)S +4342(ier\))S +2616 V +11 B +1512(cdl_getMapping)S +11 R +2442(\(region,)S +2819(sx,sy,snx,sny,)S +3466(dx,dy,dnx,dny,)S +4161(ref,)S +4342(ier\))S +2736 V +11 B +1586(cdl_queryMap)S +11 R +2442(\(wcs,)S +2709(region,)S +3050(sx,sy,snx,sny,)S +3697(dx,dy,dnx,dny,)S +4392(objref,)S +4714(ier\))S +2976 V +11 B +1474(cdl_displayIRAF)S +11 R +2442(\(fname,)S +2812(band,)S +3086(frame,)S +3401(fbcon\256g,)S +3828(zscale,)S +4155(ier\))S +3096 V +11 B +1739(cdl_isIRAF)S +11 R +2442(\(fname,)S +2812(isiraf\))S +3216 V +11 B +1600(cdl_readIRAF)S +11 R +2442(\(fname,)S +2812(band,)S +3086(pix,)S +3288(nx,)S +3459(ny,)S +3630(bitpix,)S +3949(title,)S +4182(ier\))S +3456 V +11 B +1496(cdl_displayFITS)S +11 R +2442(\(fname,)S +2812(frame,)S +3127(fbcon\256g,)S +3554(zscale,)S +3881(ier\))S +3576 V +11 B +1761(cdl_isFITS)S +11 R +2442(\(fname,)S +2812(is\256ts\))S +3696 V +11 B +1622(cdl_readFITS)S +11 R +2442(\(fname,)S +2812(pix,)S +3014(nx,)S +3185(ny,)S +3356(bitpix,)S +3675(title,)S +3908(ier\))S +3936 V +11 B +1380(cdl_computeZscale)S +11 R +2442(\(pix,)S +2680(nx,)S +2851(ny,)S +3022(bitpix,)S +3341(z1,)S +3505(z2\))S +4056 V +11 B +1516(cdl_zscaleImage)S +11 R +2442(\(pix,)S +2680(nx,)S +2851(ny,)S +3022(bitpix,)S +3341(z1,)S +3505(z2\))S +4296 V +11 B +1689(cdl_printPix)S +11 R +2442(\(cmd,)S +2728(pix,)S +2930(nx,)S +3101(ny,)S +3272(annotate,)S +3704(ier\))S +4416 V +11 B +1383(cdl_printPixToFile)S +11 R +2442(\(fname,)S +2812(pix,)S +3014(nx,)S +3185(ny,)S +3356(annotate,)S +3788(ier\))S +4656 V +11 B +1576(cdl_readImage)S +11 R +2442(\(pix,)S +2680(nx,)S +2851(ny,)S +3022(ier\))S +4776 V +11 B +1260(cdl_readFrameBu)S +2114 H + (f)show 11 -.5 mul h (f)show +11 B +2181(er)S +11 R +2442(\(pix,)S +2680(nx,)S +2851(ny,)S +3022(ier\))S +4896 V +11 B +1373(cdl_readSubRaster)S +11 R +2442(\(lx,)S +2625(ly,)S +2772(nx,)S +2943(ny,)S +3114(pix,)S +3316(ier\))S +5016 V +11 B +1344(cdl_writeSubRaster)S +11 R +2442(\(lx,)S +2625(ly,)S +2772(nx,)S +2943(ny,)S +3114(pix,)S +3316(ier\))S +5256 V +11 B +1686(cdl_selectFB)S +11 R +2442(\(nx,)S +2649(ny,)S +2820(fb,)S +2972(w,)S +3112(h,)S +3228(nf,)S +3380(reset\))S +5376 V +11 B +1500(cdl_setFBCon\256g)S +11 R +2442(\(con\256gno\))S +5496 V +11 B +1488(cdl_getFBCon\256g)S +11 R +2442(\(con\256gno,)S +2924(w,)S +3064(h,)S +3180(nf\))S +5616 V +11 B +1424(cdl_lookupFBSize)S +11 R +2442(\(con\256gno,)S +2924(w,)S +3064(h,)S +3180(nf\))S +5856 V +11 B +1598(cdl_setZTrans)S +11 R +2442(\(ztrans\))S +5976 V +11 B +1636(cdl_setZScale)S +11 R +2442(\(z1,)S +2642(z2\))S +6096 V +11 B +1605(cdl_setSample)S +11 R +2442(\(nsample\))S +6216 V +11 B +1347(cdl_setSampleLines)S +11 R +2442(\(nlines\))S +6336 V +11 B +1540(cdl_setContrast)S +11 R +2442(\(contrast\))S +6456 V +11 B +1681(cdl_setName)S +11 R +2442(\(imname\))S +6576 V +11 B +1734(cdl_setTitle)S +11 R +2442(\(imtitle\))S +6816 V +11 B +1633(cdl_getFrame)S +11 R +2442(\(frame\))S +6936 V +11 B +1586(cdl_getZTrans)S +11 R +2442(\(ztrans\))S +7056 V +11 B +1624(cdl_getZScale)S +11 R +2442(\(z1,)S +2642(z2\))S +7176 V +11 B +1593(cdl_getSample)S +11 R +2442(\(nsample\))S +7296 V +11 B +1335(cdl_getSampleLines)S +11 R +2442(\(nlines\))S +7920 V +EP +%%Page: 39 42 +BP +/slant 0 def +/height 1.000000 def +11 R +11 R +480 V +2936(- 39 -)S +840 V +11 B +1528(cdl_getContrast)S +11 R +2442(\(contrast\))S +960 V +11 B +1669(cdl_getName)S +11 R +2442(\(imname\))S +1080 V +11 B +1722(cdl_getTitle)S +11 R +2442(\(imtitle\))S +1320 V +11 B +1564(cdl_mapFrame)S +11 R +2442(\(frame,)S +2793(ier\))S +1440 V +11 B +1306(cdl_markCoordsFile)S +11 R +2442(\(fname,)S +2812(type,)S +3062(size,)S +3293(color,)S +3579(label,)S +3853(ier\))S +1560 V +11 B +1574(cdl_markPoint)S +11 R +2442(\(x,)S +2594(y,)S +2710(number,)S +3106(size,)S +3337(type,)S +3587(color,)S +3873(ier\))S +1680 V +11 B +1304(cdl_markPointLabel)S +11 R +2442(\(x,)S +2594(y,)S +2710(label,)S +2984(size,)S +3215(type,)S +3465(color,)S +3751(ier\))S +1800 V +11 B +1610(cdl_markLine)S +11 R +2442(\(xs,)S +2637(ys,)S +2796(xe,)S +2960(ye,)S +3124(color,)S +3410(ier\))S +1920 V +11 B +1641(cdl_markBox)S +11 R +2442(\(lx,)S +2625(ly,)S +2772(ux,)S +2943(uy,)S +3114(\256ll,)S +3299(color,)S +3585(ier\))S +2040 V +11 B +1445(cdl_markPolygon)S +11 R +2442(\(xarray,)S +2817(yarray,)S +3156(npts,)S +3401(\256ll,)S +3586(color,)S +3872(ier\))S +2160 V +11 B +1445(cdl_markPolyline)S +11 R +2442(\(xarray,)S +2817(yarray,)S +3156(npts,)S +3401(color,)S +3687(ier\))S +2280 V +11 B +1540(cdl_markCircle)S +11 R +2442(\(x,)S +2594(y,)S +2710(radius,)S +3039(\256ll,)S +3224(color,)S +3510(ier\))S +2400 V +11 B +1292(cdl_markCircAnnuli)S +11 R +2442(\(x,)S +2594(y,)S +2710(radius,)S +3039(nannuli,)S +3430(sep,)S +3637(color,)S +3923(ier\))S +2520 V +11 B +1505(cdl_markEllipse)S +11 R +2442(\(x,)S +2594(y,)S +2710(xrad,)S +2965(yrad,)S +3220(rotang,)S +3561(\256ll,)S +3746(color,)S +4032(ier\))S +2640 V +11 B +1269(cdl_markEllipAnnuli)S +11 R +2442(\(x,)S +2594(y,)S +2710(xrad,)S +2965(yrad,)S +3220(ang,)S +3439(nannuli,)S +3830(sep,)S +4037(color,)S +4323(ier\))S +2760 V +11 B +1612(cdl_markText)S +11 R +2442(\(x,)S +2594(y,)S +2710(str,)S +2881(size,)S +3112(angle,)S +3410(color,)S +3696(ier\))S +2880 V +11 B +1734(cdl_setFont)S +11 R +2442(\(font\))S +3000 V +11 B +1440(cdl_setTextWidth)S +11 R +2442(\(width\))S +3120 V +11 B +1438(cdl_setLineWidth)S +11 R +2442(\(width\))S +3240 V +11 B +1507(cdl_setLineStyle)S +11 R +2442(\(style\))S +3360 V +11 B +1540(cdl_deleteMark)S +11 R +2442(\(x,)S +2594(y,)S +2710(ier\))S +3480 V +11 B +1473(cdl_clearOverlay)S +11 R +2442(\(ier\))S +3600 V +11 B +1363(cdl_redrawOverlay)S +11 R +2442(\(ier\))S +3720 V +11 B +1648(cdl_setDebug)S +11 R +2442(\(level\))S +7920 V +EP +%%Trailer +%%DocumentFonts: Times-Roman Times-Bold Times-Italic Courier Troff +%%Pages: 42 +
\ No newline at end of file |