%!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()S 2594(:)S 2726(
)S 4884 V 11 R 900(where)S 1204()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()S 11 B 2431(:)S 11 C 2467()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()S 1932 V 900(#include)S 1386()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()S 1176 V 900(#include)S 1386()S 1276 V 900(#include)S 1386()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()S 1076 V 1260(#include)S 1597()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