home *** CD-ROM | disk | FTP | other *** search
/ Photo CD Demo 1 / Demo.bin / composit / compsttl.ch3 < prev    next >
Text File  |  1992-07-17  |  33KB  |  880 lines

  1. 3.1    CompostieTool Frames
  2.  
  3.  
  4. NCSA CompositeTool    3.1
  5.  
  6.  
  7. National Center for Supercomputing Applications
  8.  
  9. April 1990
  10.  
  11.                                                                 
  12.  
  13.  
  14.  
  15.  
  16. 3.1    NCSA CompositeTool
  17.  
  18. CompositeTool Frames    3.1
  19.  
  20. National Center for Supercomputing Applications
  21.  
  22. April 1990
  23.  
  24.                                                                 
  25.  
  26.  
  27. 1/24/92
  28.  
  29.  
  30.  
  31.  
  32. Chapter 3    CompositeTool Frames
  33.  
  34.  
  35.  
  36. Chapter Overview
  37. Base Frame
  38. Canvas Frame
  39. Frame Manipulation
  40. Grid Frame
  41. Palette Frame
  42. Colorbar Frame
  43. Text Frame
  44. Image Frame
  45. Contour Frame
  46. Vector Frame
  47. Features Frame
  48. File Utility Frame
  49. Display Photographs
  50.  
  51. Chapter Overview
  52.  
  53. This chapter discusses the options available in the CompositeTool 
  54. frames: Base, Canvas, Grid, Palette, Colorbar, Text, Images, 
  55. Contours, Vectors, Features, and Utilities.
  56.  
  57.  
  58. Base Frame
  59.  
  60. The Base frame (Figure 3.1) appears on the screen when 
  61. CompositeTool is invoked, and remains up for as long as you run 
  62. the program. The frame includes 13 options as displayed below:  
  63. Canvas, FinalPic, Clear Palette, Grid, ColorBar, Text, Image, 
  64. Contour, Vector, Feature, FileUtil, and Quit. Notice that when you 
  65. choose a Base frame button option that displays new windows, the 
  66. selected button disappears from the Base frame. This feature 
  67. prevents you from opening more than one window of the same type. 
  68. The buttons reappear on the Base frame when their corresponding 
  69. windows are closed.
  70.  
  71. Figure 3.1  Base Frame
  72.                                             
  73.  
  74. Canvas
  75. The canvas button opens up a new canvas. (See Chapter 1, 
  76. "CompositeTool Basics.")
  77.  
  78.  
  79. Final Pic
  80. The Final Pic button erases the canvas and draws everything that 
  81. has a FinalPic toggle setting of ON. This button applies to stored 
  82. data, not to the currently displayed data.
  83.  
  84.  
  85. Clear
  86. The Clear button erases the displayed contents of the canvas, but 
  87. not the canvas itself.
  88.  
  89.  
  90. Palette
  91. The Palette button opens the palette frame.
  92. Grid
  93. The Grid button opens the grid frame.
  94.  
  95.  
  96. ColorBar
  97. The ColorBar button opens the colorbar frame.
  98.  
  99.  
  100. Text
  101. The Text button opens the text frame.
  102.  
  103.  
  104. Image
  105. The Image button opens the image frame.
  106.  
  107.  
  108. Contour
  109. The Contour button opens the contour frame.
  110.  
  111.  
  112. Vector
  113. The Vector button opens the vector frame.
  114.  
  115.  
  116. Feature
  117. The Feature button opens the image, contour, and vector features 
  118. frame.
  119.  
  120.  
  121. FileUtil
  122. The FileUtil button opens the file utility frame.
  123.  
  124.  
  125. Quit
  126. The Quit button closes the CompositeTool application.
  127.  
  128.  
  129. Canvas
  130.  
  131. Before you can load any images, contours, or vectors into 
  132. CompositeTool, you must first open a canvas frame. To do so, click 
  133. the Canvas button on the Base frame.
  134.  
  135. NOTE:  When CompositeTool reads program setting files from the 
  136. FileUtil frame, you do not have to have the Canvas frame opened. 
  137. However, you do have to open the canvas and click the FinalPic 
  138. button before the setting file composite will appear on the canvas.`
  139.  
  140. When the canvas opens (Figure 3.2), it is considerably smaller 
  141. than full screen size, since you are actually only viewing the top 
  142. section of the complete canvas frame.
  143.  
  144. Figure 3.2  Canvas Frame
  145.                                             
  146.  
  147.  
  148. You may load in data, manipulate text, and perform all 
  149. CompositeTool functions regardless of the size of the canvas, 
  150. although you may not be able to fully view the results until the 
  151. canvas is enlarged. To do so, use the right mouse button as 
  152. explained in the section "Mouse Buttons" in Chapter 1. When 
  153. selecting an option from the SunView Frame Selection menu in 
  154. this manner, use the Fullscreen option rather than the Zoom option 
  155. in order to ensure both vertical and horizontal expansion. At any 
  156. time, you can return the canvas to its original, smaller size by 
  157. selecting the Unzoom option on the SunView Frame Selection 
  158. menu.
  159.  
  160. NOTE:   In order to remain oriented to the absolute nature of the 
  161. canvas size, use the grid (refer to this chapter's section "Grid 
  162. Frame") while laying out a display.
  163.  
  164. In its entirety, the Canvas frame  is 1152 horizontal pixels by 900 
  165. vertical pixels. The canvas frame border is 5 pixels wide on every 
  166. side, leaving a canvas of 1142 horizontal pixels by 890 vertical 
  167. pixels available for your use.
  168.  
  169. Finally, note that the origin of the canvas is always in the upper 
  170. left corner, and this origin is absolute (that is, the canvas cannot be 
  171. scrolled up and down or from side to side).
  172.  
  173. To take a photographs of the canvas and its contents of it, using the 
  174. negative to make 35mm slides see this chapter's section 
  175. "Photographing Your Display." In order not to detract from the 
  176. final presentation-quality screen display, the Canvas frame does 
  177. not contain a title bar.
  178.  
  179.  
  180. Frame Manipulation
  181.  
  182. Most CompositeTool frames are set up so that you work through 
  183. their options as outlined below; however, you do not have to strictly 
  184. adhere to these steps.
  185.  
  186. 1.    Select the desired frame from the Base frame.
  187.  
  188. 2.    Enter the specifications for your image in the frame (e.g. pixel 
  189. size, pixel color range, palette, tag, and filenames, etc.) by 
  190. positioning the mouse beside the available options. Click the 
  191. mouse to move the prompt to that point, and type the values in.
  192.  
  193. 3.    Click the DRAW it or ERASE it buttons to view the image with 
  194. the specifications you have just entered.
  195.  
  196. 4.    Click STORE displayed values or DISCARD displayed values to 
  197. store or discard the most recently entered values.
  198.  
  199. 5.    Click FinalPic toggle to ON in order to permanently save the 
  200. most recently entered values and to view them when you press 
  201. the FinalPic button in the Base frame. Click FinalPic toggle to 
  202. OFF to not save values.
  203.  
  204. 6.    Click Done in the opened frame to close it.
  205.  
  206. 7.    Click FinalPic in the Base frame to display the new image.
  207.  
  208.  
  209. Grid Frame
  210.  
  211. The Grid (Figure 3.3) frame is intended as an aid in layout while 
  212. developing the canvas image. You can turn on the grid (via a 
  213. toggle) during development, and once you are satisfied with the 
  214. layout, turn it off before drawing the final picture.
  215.  
  216. Figure 3.3  Grid Frame
  217.                                             
  218. Defining Grid Color
  219. The Color variable defines the color of the drawn grid. The Color 
  220. number is a palette entry index into the current palette and must be 
  221. in the range (0-255). See this chapter's section "Palette Frame" 
  222. and Chapter 2's "Raw Palette Files." 
  223.  
  224.  
  225. Defining Grid Spacing
  226. The Pix/x-grid and Pix/y-grid variables refer to the pixel spacing 
  227. between x and y grid lines. In addition to the x (horizontal) and y 
  228. (vertical) lines, an "x" is drawn on the canvas in such a way that 
  229. the diagonal lines meet at the exact center of the canvas. During 
  230. development of the canvas picture, you may have only a part of the 
  231. canvas visible. The "x" serves to orient the center of the canvas 
  232. when you open the screen to full-size.
  233.  
  234.  
  235. FinalPic toggle
  236. This ON/OFF toggle applies to the FinalPic button on the Base 
  237. frame. The current setting is shown on the button. If OFF, the 
  238. newly entered values for the grid will not be drawn when the 
  239. FinalPic button is pressed. If ON, the new grid will be drawn when 
  240. the FinalPic button is pressed.
  241.  
  242.  
  243. STORE displayed values
  244. The numerical values shown for grid color and spacing (in pixels) 
  245. are stored, replacing the previously stored values. 
  246.  
  247. NOTE:  Just because you enter values in a frame or have 
  248. CompositeTool draw your image specifications by pressing the 
  249. DRAW it button, numerical values ARE NOT SAVED. Once the 
  250. frame is closed, the most recently entered values are lost and the 
  251. last stored values are restored. Thus, you MUST press the STORE 
  252. displayed values button before pressing FinalPic in the Base 
  253. frame for CompositeTool to save and display the new values.
  254.  
  255.  
  256. DISCARD displayed values
  257. DISCARD displayed values discards the numerical values shown 
  258. for grid color and spacing (in pixels) and replaces them by the 
  259. most recently stored numerical values.
  260.  
  261.  
  262. DRAW it
  263. DRAW it draws the grid using the numerical values shown for 
  264. color and spacing (not the currently stored numerical values). 
  265. Only one grid can be drawn at a time. This means that the current 
  266. grid is always erased before a new one is drawn.
  267.  
  268.  
  269. ERASE it
  270. ERASE it erases the grid by filling it in using the current canvas 
  271. background pixel value which you've specified in the Palette 
  272. frame.
  273.  
  274.  
  275. Done
  276. The Done button closes the Grid frame. If you've entered any 
  277. values without pressing the Stored Displyed values button to store 
  278. the data, a message appears on the screen asking you to confirm 
  279. this decision. This feature helps prevent accidental loss of newly 
  280. entered data.
  281.  
  282.  
  283. Palette Frame
  284.  
  285. The Sun Workstation uses the RGB (red, green, blue) color model, 
  286. where each of the three primary colors can take 256 distinct 
  287. gradations, ranging from no color to full color. A single byte, 
  288. consisting of 8 bits, is used to distinguish the 256 possible values of 
  289. gradation. These gradations are stored in arrays (one for each 
  290. primary color), and when a color is displayed on the screen, the 
  291. Sun combines the gradations for the three primary colors to form 
  292. the color displayed. For example, a high gradation of red and 
  293. green plus a low gradation of blue will produce a shade of yellow.
  294.  
  295. Each array that stores the gradations of the three primary colors is 
  296. 256 bytes long, and the elements of each array are completely 
  297. arbitrary. That is, the levels of color gradation (the elements of the 
  298. arrays) may be in any order, with duplicates and omissions 
  299. allowed.
  300.  
  301. The three arrays used to store the gradations of the three primary 
  302. colors are collectively referred to as the palette. Once a palette has 
  303. been defined (that is, once the three arrays have been loaded), the 
  304. colors that are displayed on the screen are referred to by number (0 
  305. through 255), representing the element number of each of the red, 
  306. green, and blue arrays. For example, referring to pixel value 8 
  307. means that element number 8 of the red array plus element 
  308. number 8 of the green array plus element number 8 of the green 
  309. array are to be combined to form the color displayed on the screen.
  310.  
  311. CompositeTool provides on startup an initial palette, which you 
  312. may change at any later time. When loading your own palette, 
  313. note that elements 0, 253, 254, and 255 are reserved. Element 0 
  314. (canvas background color) is set to white. Element 255 (canvas 
  315. foreground color) is set to black. Element 253 (set to black) and 
  316. element 254 (set to white) are used for other purposes. When a 
  317. palette is loaded, CompositeTool will change these elements 
  318. accordingly, no matter what values you assign. Refer to Chapter 2, 
  319. section "Raw Palette Files," for more information on palettes.
  320.  
  321. NOTE:  You are advised not to use the color definitions in the 
  322. .sunview file in the home directory. If colors are defined, then 
  323. moving the cursor into and out of CompositeTool windows will 
  324. cause an irritating flash on the screen, and the CompositeTool 
  325. canvas will not be viewable unless the cursor is inside the canvas.
  326.  
  327. Figure 3.4  Palette Frame
  328.                                              
  329. Load palette
  330. Load palette allows you to enter a filename which CompositeTool 
  331. finds when you press the option's button. If the file is a "raw" 
  332. palette then it must be a stream of 768 bytes. The first 256 bytes 
  333. represent the gradations of red, the next 256 bytes represent the 
  334. gradations of green, and the final 256 bytes represent the 
  335. gradations of blue. Otherwise, it must be an HDF file with a palette 
  336. in it and the equivalent data is extracted from the first palette in the 
  337. file. Note that the palette data is actually stored "interleaved," that 
  338. is red byte, green byte, blue byte, etc. in an HDF file.
  339.  
  340. Load background color
  341. Load background color allows you to specify the canvas color when 
  342. you enter a number between 0 and 255 and press the button. A blank 
  343. field is interpreted as 0. The color chosen is based on the current 
  344. palette. Note that you must click the FinalPic button before 
  345. CompositeTool changes the canvas' background color.
  346.  
  347.  
  348. Done
  349. The Done button closes the frame. If you have entered any 
  350. information without pressing the button to store the data, you are 
  351. required to confirm the choice by pressing the button again. This 
  352. feature helps prevent accidental loss of data.
  353.  
  354.  
  355. Colorbar Frame
  356.  
  357. The Colorbar visually displays the range of colors in the palette. 
  358. The appearance of 2D images can vary substantially depending on 
  359. the palette currently being used, and the colorbar allows you to have 
  360. some basis for palette comparison. (See this chapter's section 
  361. "Palette Frame" for more information on palettes.)
  362.  
  363. Figure 3.5  Colorbar Frame
  364.                                             
  365. X/Y points and X/Y origins
  366. X/Y point options allow you to designate the width and length size 
  367. of the colorbar while the x/y origins options determine the 
  368. horizontal and vertical screen position of the bar. The number of 
  369. x-points (i.e., the width) is arbitrary, and should be based on 
  370. visibility. Since the colorbar is displayed vertically, 256 y-points 
  371. will display every allowable color. If the number of y-points does 
  372. not equal 256, linear scaling of the colorbar is performed. This 
  373. scaling has no effect on the palette. The colorbar origin is in pixels 
  374. from the upper left of the canvas.
  375.  
  376.  
  377. Show color
  378. Show color displays the numerical value of a particular color. 
  379. Specify the color value, which corresponds to a palette entry in the 
  380. current palette, and click the button. A "<" symbol appears on the 
  381. right edge of the displayed colorbar. The arrow points directly at 
  382. the color representation of the value you've entered. For example, 
  383. suppose you enter 100, which in this example will represent a 
  384. certain shade of red, in the Show color option. An arrow will appear 
  385. on the colorbar, pointing directly at the associated color of red.
  386.  
  387.  
  388. Standard Buttons
  389. Refer to this chapter's section "Grid Frame" for a description of the 
  390. FinalPic toggle, and the STORE displayed values, DISCARD 
  391. displayed values, DRAW it, and ERASE it buttons.
  392.  
  393.  
  394. mouse mv
  395. The mouse mv (mouse move) allows you to move a drawn colorbar 
  396. by using the mouse (instructions appear as a message on the base 
  397. frame when the button is pressed). When you move a colorbar, the 
  398. move is based on the currently shown numerical values (not the 
  399. stored values), and the currently shown numerical values are 
  400. updated to correctly indicate the new colorbar location on the 
  401. canvas. To deactivate the move capability, select the button again.
  402.  
  403. NOTE:  The arrows ("<") that point to specific colors on the 
  404. colorbar (see explanation in the section "Show color" above) do not 
  405. move from their original position on the screen. Thus, when you 
  406. move the colorbar, the arrows remain stationary.
  407.  
  408.  
  409. Done
  410. The Done button closes the Colorbar frame.
  411.  
  412.  
  413. Text Frame
  414.  
  415. The Text frame gives you the ability to add text to a screen display. 
  416. By doing so, you can easily differentiate between several images 
  417. that have been simultaneously displayed or label a display for a 
  418. presentation-quality slide.
  419.  
  420. Figure 3.6  Text Frame
  421.                                             
  422.  
  423. Tag Selector
  424. Tag Selector allows you to alter the text number. CompositeTool is 
  425. capable of displaying a number of texts simultaneously, and these 
  426. texts are distinguished by attaching a tag to each one. The current 
  427. tag is shown in the frame label, and when the text frame is brought 
  428. up from the base frame, tag 't0' is always displayed. You can 
  429. increment or decrement the currently shown tag by either one or 
  430. five, with the text frame label always showing the currently 
  431. displayed tag. When you increment or decrement the tag number, 
  432. the effect on the displayed information is the same as if you pressed 
  433. the Done button; i.e., you are warned that the previous information 
  434. will be lost. (For additional information, see Chapter 1 
  435. "CompositeTool Basics.")
  436.  
  437.  
  438. Copy data
  439. The Copy data option saves you the trouble of re-entering repetitious 
  440. information (especially color and font). By selecting a tag and 
  441. pressing the Copy data from text tag button, you copy the 
  442. characteristics from this previously defined tag, leaving only the 
  443. new text body and origin to be entered. Press STORE displayed 
  444. values and then the DRAW it button. The copy process is now 
  445. completed.
  446.  
  447.  
  448. X/Y Color and Origin of Text
  449. Ñ    Color
  450.     The Color entry refers to the pixel value of the drawn text. This 
  451. number is a palette entry index into the current palette and must 
  452. be in the range (0-255). 
  453.  
  454. Ñ    X/Y Origin
  455.     These variables define the origin, in pixels, of the lower left-
  456. hand corner of the text string.
  457.  
  458.  
  459. Standard Buttons
  460. Refer to this chapter's section "Grid Frame" for a description of the 
  461. FinalPic toggle, and the STORE displayed values, DISCARD 
  462. displayed values, DRAW it, and ERASE it buttons. Refer to this 
  463. chapter's section "Text Frame" for a discussion on the buttons Tag 
  464. Selection and Copy data from text tag.
  465.  
  466.  
  467. Text and Fonts
  468. Text and Font variables define the body of the text and the font to be 
  469. used, respectively. A default font is supplied by CompositeTool. It 
  470. is in the User Defaults Database for CompositeTool and can be 
  471. changed by running defaultsedit  in SunView or editing 
  472. $HOME/.defaults. To activate the new default font, you must 
  473. restart CompositeTool.
  474.  
  475. You may find out what fonts are available by listing all the 
  476. elements in the given font directory (these elements are the fonts 
  477. available).
  478.  
  479.  
  480. mouse mv
  481. The mouse mv (mouse move) button allows you to move text by 
  482. using the mouse. (Follow the messages that appear on the Base 
  483. frame after you've pressed the mouse mv button.) When you 
  484. depress the left mouse button, a small box, which you can move with 
  485. the mouse, appears on the screen. Drag the square to the desired 
  486. location on the canvas, being aware that the lower left-hand corner 
  487. of the box will define the position of the lower left-hand corner of the 
  488. text. When you release the left mouse button, the text moves to the 
  489. new location and the box disappears. The move, as reflected in the 
  490. Base frame, is based on the currently shown numerical values (not 
  491. the stored values). The current values are updated to correctly 
  492. indicate the new text location on the canvas. To deactivate the 
  493. mouse move capability, select the button again.
  494.  
  495.  
  496. Done
  497. The Done button closes the Text frame.
  498.  
  499. Image Frame
  500. CompositeTool determines the characteristics of your data from the 
  501. entries you've made in the Image frame (Figure 3.7). Refer to 
  502. Chapter 2, "Formatting Your Data Files" for a discussion of data 
  503. file formats for input data.
  504.  
  505. Figure 3.7  Image Frame
  506.                                             
  507. Standard Buttons
  508. Refer to this chapter's section "Grid Frame" for a discussion of the 
  509. FinalPic toggle, and the STORE displayed values, DISCARD 
  510. displayed values, DRAW it, and ERASE it buttons. Refer to this 
  511. chapter's section "Text Frame" for a discussion on the buttons Tag 
  512. Selection and Copy data from image tag. Refer to the section 
  513. "Colorbar Frame" for a discussion of the mouse mv button.
  514.  
  515.  
  516. X/Y points and origins
  517. The X/Y points and X/Y origins define, in pixels, the dimensions 
  518. of the two-dimensional data and its origin on the canvas, 
  519. respectively.
  520.  
  521. The X/Y points are never used for an HDF file. The dimensions in 
  522. the file are always displayed and replace any entered dimensions.
  523.  
  524.  
  525. File
  526. The File entry requires that you enter the name of the data file to be 
  527. displayed.
  528.  
  529.  
  530. Done
  531. The Done button closes the Image frame.
  532.  
  533.  
  534. Contour Frame
  535.  
  536. The Contour frame (Figure 3.8) resembles the Image frame, except 
  537. that the contour algorithm plots in the former are user-specified 
  538. contour intervals in your data, rather than individually plotted 
  539. data points as in the latter.
  540.  
  541. Figure 3.8  Contour Frame
  542.                                             
  543.  
  544. Standard Buttons
  545. Refer to this chapter's section "Image Frame" for a discussion of 
  546. features not outlined below.
  547.  
  548.  
  549. Contour levels 
  550. Ñ    Start/End color
  551.     Allows you to designate the start and end contour colors [pixel 
  552. values in the range (0-255)] for the input data .
  553.  
  554. Ñ    Contour interval
  555.     Allows you to designate the interval between the contour levels. 
  556. Note that large files (for example, of dimension 256 x 256) with 
  557. contour intervals close together (for example, intervals of 4) 
  558. may take a long time to plot.
  559.  
  560.  
  561. Color
  562. The Color entry (a pixel value) allows you to define the color of the 
  563. lines drawn within the contour plot. The pixel value is a palette 
  564. entry index into the current palette and must be in the range 
  565. (0-255). See this chapter's section "Palette Frame" for more 
  566. information on palettes.
  567.  
  568.  
  569. Done
  570. The Done button closes the Contour frame.
  571.  
  572. Vector Frame
  573.  
  574. The Vector frame (Figure 3.9) allows you to plot 2D data in a vector 
  575. format, using two files as input. One file contains x-component 
  576. data, the other, y-component data. These files are displayed by 
  577. CompositeTool as the vector magnitude sqrt(x*x + y*y) with 
  578. angle arctan(y/x). This feature is useful when displaying data 
  579. with real and imaginary components.
  580.  
  581. Figure 3.9  Vector Frame
  582.                                             
  583.  
  584. Standard Buttons
  585. Refer to this chapter's section "Image Frame" for information on 
  586. the features not discussed below.
  587.  
  588. NOTE:  Two data files (one for the x-component and one for the y-
  589. component)are required, rather than just a single file, as for 
  590. image data. If the x-component is stored in the first image set and 
  591. the y-component is stored in the second image set in an HDF file, 
  592. only the x-component filename is required. Any combination of 
  593. raw and HDF files are possible for the data files.
  594.  
  595.  
  596. Color/Scale data
  597. Ñ    X/Y color value
  598.     Color=0 refers to an image data value (from 0 through 255) that 
  599. is defined as zero. All numbers less than this value are 
  600. negative, and all numbers greater than this value are positive. 
  601. You must define these values for both the x-component file and 
  602. the y-component file.
  603.  
  604. Ñ    X/Y Scale
  605.     Allows you to define the x-component and y-component 
  606. magnitudes relative to each other. This is the only place in 
  607. CompositeTool where floating point numbers are used. When 
  608. entering the scales, you must use fixed decimal notation 
  609. (e format is not accepted).
  610. Ñ    Vector color
  611.     Defines the color of the lines drawn in the vector plot. The color 
  612. value is a palette entry represented in the current palette which 
  613. is defined in the range (0-255). (For more information on 
  614. palettes, see the section "Palette Frame").
  615.  
  616. Ñ    Max length
  617.     Refers to the maximum pixel length of the longest vector in the 
  618. data; all other vectors are scaled down in magnitude with 
  619. respect to this maximum.
  620.  
  621.  
  622. Points on image
  623. The Points on image feature refers to the location of data within the 
  624. x-file and the y-file that are to be displayed. For example, if X-start 
  625. is 10, X-end is 200, and X-interval is 60, then vectors will be 
  626. displayed for image data points 10, 70, 130, and 190 in the 
  627. horizontal direction, applying to every row for which Y-start, Y-
  628. end, and Y-interval are defined.
  629.  
  630. If Y-start is 20, Y-end is 30, and Y-interval is 10, then vectors will 
  631. be displayed for ordered data pairs:  (10, 20), (70, 20), (130, 20), 
  632. (190, 20), (10, 30), (70, 30), (130, 30), and (190, 30). Vectors will not be 
  633. displayed for any other points in the image files. The vector 
  634. magnitudes, angles, and color are as defined in the Color/Scale 
  635. data.
  636.  
  637.  
  638. Done
  639. The Done button closes the Vector frame.
  640.  
  641.  
  642. Features Frame
  643.  
  644. The Features frame (Figure 3.10) allows you to copy features from 
  645. other tags and apply them to a current tag, as well as annotate 2D 
  646. data with several commonly used visual features:  axes, grid 
  647. lines, and major and minor tick marks.
  648.  
  649. Figure 3.10  Features Frame
  650.                                              
  651.  
  652.  
  653. Select
  654. The Select button applies to any image, contour, or vector tag. You 
  655. must explicitly enter the appropriate tag to which this feature will 
  656. apply and then press the Select button. Specifications for image, 
  657. contour, and vector tags are shown in their respective frames.
  658.  
  659.  
  660. Copy
  661. The Copy button allows you to copy the features of any image, 
  662. contour, or vector data, once you have defined those features (fonts, 
  663. color, etc.). You can copy image features from contour features, 
  664. other image features, or vector features.
  665.  
  666.  
  667. Features ON/Features OFF
  668. The Features ON/Features OFF toggle turn axes, grids, and tick 
  669. marks on or off en masse.
  670.  
  671.  
  672. DRAW it/ERASE it
  673. DRAW it and ERASE it draw and erase the current features in the 
  674. usual manner. For a discussion of how these buttons work, refer to 
  675. this chapter's section "Grid Frame." These buttons draw or erase 
  676. only the features (specifications of the image, contour, or vector), 
  677. not the actual data image, contour, or vector that is being 
  678. annotated.
  679.  
  680.  
  681. Axes, Grids, and Tick Marks
  682. Axes, grids, and tick marks may be set on or off individually. To 
  683. change the current settings for any of these, press the ON/OFF 
  684. button located next to the desired option. The chosen feature will 
  685. change from lower case to upper case, and information on the 
  686. feature appears in the lower part of the frame. You can now change 
  687. the selected item's characteristics. For example, after selecting the 
  688. x-axis button, you would position the mouse in either the Thickness 
  689. or Color slider bar, and click at the desired location. The bar will 
  690. adjust itself by extending only to the point you've clicked. Notice 
  691. that the Thickness and Color values, located to the left of the bars, 
  692. also reflect the value of the area you have chosen.
  693.  
  694. Ñ    Axes
  695.     Allows you to adjust the thickness and color of axes using 
  696. sliders. The buttons allow you to set the top and/or bottom axis 
  697. on/off (for the x-axis), and the left and/or right axis on/off (for 
  698. the y-axis). When you click x-axis or y-axis, sliders appear at 
  699. the bottom of the Features frame. 
  700.  
  701. Ñ    Grids
  702.     Allows you to adjust the thickness, color, and spacing of grids 
  703. using sliders. Figure 3.11 shows the sliders that appear at the 
  704. bottom of the Features frame when you click x-grid. (The 
  705. Features frame appears similarly when y-grid is chosen.)
  706.  
  707. Figure 3.11    Feature Frame with 
  708. X-Grid Selected
  709.                                             
  710.  
  711. Ñ    Tick Marks
  712.     Allows you to adjust the thickness, color, spacing, and length of 
  713. major and minor tick marks using sliders. x-tic1/y-tic1 
  714. specify the x/y major tic marks while x-tic2/y-tic2 specify the 
  715. x/y minor tic marks. Figure 3.12 shows the sliders and buttons 
  716. that appear at the bottom of the Features frame when you click x-
  717. tic1. (The Features frame appears similarly when y-tic1, x-tic2, 
  718. and y-tic2 are chosen.) 
  719.  
  720. Figure 3.12    Feature Frame with 
  721. X-Tic Selected
  722.                                              
  723.  
  724.     The bot side ON and top side ON buttons allow you to set the top 
  725. and/or bottom tick marks on/off (for x-ticks) and the left and/or 
  726. right tick marks on/off (for y-ticks), respectively. The now IN 
  727. button, which toggles to now OFF, allows you to draw tick marks 
  728. into or out of the data region.
  729.  
  730.  
  731. Done
  732. The Done button closes the Features frame.
  733.  
  734.  
  735. File Utility Frame
  736.  
  737. The File Utility frame (Figure 3.13) allows you to store  
  738. CompositeTool sessions for later use, retrieve sessions previously 
  739. saved, and saves all or part of the Canvas frame (screen dumps) in 
  740. a file in one of three ways: (1) as an image and its palette as an 
  741. HDF 8 bit Raster Image Set, (2) as a compressed image and its 
  742. palette as an HDF 8 bit Raster Image Set, and (3) as an image 
  743. without a palette as a raw raster image.
  744.  
  745. Figure 3.13  File Utility Frame
  746.                                             
  747.  
  748. File
  749. The File button names the output file (for the WRITE, SAVE ALL, 
  750. and SAVE PART buttons), or the input file (for the READ button).
  751.  
  752.  
  753. Write
  754. The WRITE button stores the current CompositeTool session to a 
  755. file. Only the CompositeTool session variables are written (not the 
  756. actual data files themselves), so the file requires very little space.
  757.  
  758. NOTE:  The file is stored with all filenames specified by full 
  759. pathnames. Composites may be moved around as long as all files 
  760. referred to in the session file have been copied to the directory and 
  761. are at the same level as the session file.
  762.  
  763.  
  764. READ
  765. The READ button loads a CompositeTool session from a file.
  766.  
  767. NOTE:  If the reading of a session file fails and this is due to a 
  768. wrong absolute path of one or more files, copy those files to the 
  769. directory at the same level as the session file. You may find all the 
  770. filenames used in the composite by searching the session file with 
  771. a text editor.
  772.  
  773.  
  774. SAVE ALL
  775. The SAVE ALL button initiates and completes a screen dump of the 
  776. whole Canvas frame using the file format you've specified from 
  777. the File Format options. (See "File Formats" below.)
  778.  
  779.  
  780. SAVE  PART
  781. The SAVE PART button initiates and completes a screen dump, 
  782. based on the start and end points shown and the file format you've 
  783. specified from the File Format options. (See "File Format" below.)
  784.  
  785.  
  786. X and Y Pixel Ranges
  787. This option allows you to chose the pixel range representation of the 
  788. x and y values. You may either enter the x and y start and end 
  789. points explicitly, or load the points using the mouse. To use the 
  790. mouse, press the button labeled "Load start and end points by 
  791. mouse", and follow the instructions given in the message on the 
  792. Base frame.
  793.  
  794.  
  795. File Format
  796. Select the file format for a screen dump by clicking the circular 
  797. arrows at the bottom of the File Utility frame. In Figure 3.13, the 
  798. circle is labeled with the default format "Save palette and image as 
  799. HDF 8-bit Raster Image set." This label changes as you repeatedly 
  800. click the circular arrows using the left mouse button. Eventually, 
  801. the name of the file format in which you want to save your image 
  802. appears. The selections available include the following:  (1) Save 
  803. palette and image as HDF 8 bit Raster Image Set, (2) Save palette 
  804. and compressed image as HDF 8 bit Raster Image Set, and (3) Save 
  805. image only as raw raster. (Refer to Chapter 2, "Formatting Your 
  806. Data Files" for more detailed information on saving files.)
  807.  
  808.  
  809. Done
  810. The Done button closes the File Utility frame.
  811.  
  812.  
  813. Display Photographs
  814.  
  815. Like NCSA Layout for the Macintosh, CompositeTool makes it 
  816. easy for you to take presentation quality photographs of your 
  817. display. You can use a film recorder directly interfaced into the 
  818. computer, such as a Dunn or Mirus, or a 35mm camera to 
  819. photograph your displays. This section contains some suggestions 
  820. to help you take quality photographs of your display using your own 
  821. camera.
  822.  
  823. 1.    Select a film with a speed of 100 ASA. NCSA photographers have 
  824. had good results with Kodak Ektachrome 100 (daylight 
  825. balanced) film.
  826.  
  827. 2.    Set up the camera on a tripod directly in front of the screen. If 
  828. possible, use a cable release with the camera to minimize 
  829. shaking.
  830.  
  831. 3.    Make sure the camera is aligned squarely in front of the 
  832. monitor (see Figure 3.14).
  833.  
  834. 4.    If possible, use a narrow, or telephoto, lens. Wide angle lenses 
  835. tend to distort the image, whereas telephoto lenses actually 
  836. flatten it. The distance at which you set the camera will depend 
  837. on the focal length of the lens.
  838.  
  839. 5.    Photograph in the darkest environment possible, to reduce 
  840. reflection from the monitor. 
  841.  
  842.     NOTE: Since the dimensions of a Sun screen (see this chpater's 
  843. section "Canvas") are not proportional to those of a 35mm slide, 
  844. a small area of the monitor will probably be included in full-
  845. screen slides. However, if the film is shot in a room-darkened 
  846. environment, this area will appear as black on the slide.
  847.  
  848. 6.    Focus on a slightly larger area than what you want for the final 
  849. display, since the slide holder will probably obscure the 
  850. periphery of the slide.
  851.  
  852. 7.    Select a slow shooting speed. Speeds of 1/60 of a second and 
  853. faster are too fast for the refresh rates of most screens, and often 
  854. capture a refresh line on film. A typical exposure setting for 
  855. most computer screens, using ASA 100 film, is about f2.8 at 1/4 
  856. second. 
  857.  
  858. 8.    If you have an exposure meter on your camera, use it in the 
  859. following manner: Put a large mid-gray image on your screen; 
  860. that is, a gray which is roughly half way between the white and 
  861. black of your screen. (You can use a solid color, or even an 
  862. image, if you can safely say that the overall brightness is mid-
  863. gray╤not always an easy judgment.) Take an exposure 
  864. reading from this screen.
  865.  
  866. 9.    Photograph the same display at different exposures to ensure 
  867. that a properly exposed image is captured. This method of 
  868. shooting, called bracketing, is especially important when you 
  869. are using slide film, which is very sensitive to light changes.
  870.  
  871. Figure 3.14    Side and Top 
  872. Views of Photo 
  873. Display Setup
  874.                               
  875.  
  876.  
  877.                                
  878.  
  879.  
  880.