home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / plotting / imagetoo / imagetl1.lha / Imagetool / adocs / IT.Apx.B < prev    next >
Encoding:
Text File  |  1991-07-01  |  5.5 KB  |  207 lines
  1. B.1    NCSA ImageTool
  2.  
  3. Errors and Warnings    B.1
  4.  
  5. National Center for Supercomputing Applications
  6.  
  7. January 1991
  8.  
  9.                                                                 
  10.  
  11.  
  12. January 1991
  13.  
  14.  
  15.  
  16.  
  17. Appendix  B    Errors and Warnings
  18.  
  19.  
  20.  
  21.  
  22. Overview
  23. This appendix describes the meaning of many of NCSA 
  24. ImageTool's error numbers and warning messages, as well as 
  25. some operation system errors. Instructions to correct specific 
  26. problems are included.
  27.  
  28.  
  29. NCSA ImageTool Error Messages
  30.  
  31. Error, warning, and status messages appear in the message panel. 
  32. The panel numbers actions or their results from 1 to 20, then begins 
  33. again at 1. The scroll bar to the left of the panel lets you move 
  34. forward and backward through the entries. 
  35.  
  36. Table 3.1 lists errors that can be easily corrected in most 
  37. instances.
  38.  
  39.  
  40. Table B.1    Error Numbers, 
  41. Meanings, and 
  42. Corrections
  43. Error Number    Meaning and Correction
  44.  
  45.     2    Filename is missing from the NCSA 
  46.         ImageTool control panel. Enter a character 
  47.         string in the Image text field (click the 
  48.         mouse next to the text item "Image" and type 
  49.         the string).
  50.  
  51.     3    The file was not found when NCSA     
  52.         ImageTool tried to load it. Check to see if 
  53.         you typed in the correct filename or you are 
  54.         using the correct working directory.
  55.  
  56.     4    Filename is ambiguous. This happens 
  57.         when you have *, ?, or other wildcard 
  58.         characters in the name string that represent 
  59.         more than one file in the current working 
  60.         directory. Therefore, check the filename.
  61.  
  62.     5    Image dimensions are missing. Enter 
  63.         integers on the text items Xdim and Ydim on 
  64.         the NCSA ImageTool control panel.
  65.  
  66. Table B.1    Error Numbers, 
  67. Meaning, and 
  68. Correction (Cont'd)
  69. Error Number    Meaning and Correction
  70.  
  71.     6    Image dimensions are larger than the full 
  72.         screen size of 1150 x 900 pixels.
  73.  
  74.     7    Error in opening a file to read. If you are 
  75.         running on a networked disked disk, this 
  76.         could occur if files are not found or there is a 
  77.         file server problem 
  78.  
  79.     8    Error in opening a file to write. Check the 
  80.         permission levels for the file and directory 
  81.         to which you are writing.
  82.     9    SunView lib call memcreate() failed. The 
  83.         system could be out of memory.
  84.  
  85.     10    UNIX call malloc() or calloc() failed.
  86.  
  87.     11    Error in reading a file.
  88.  
  89.     12    Error in writing a file. Check the directory 
  90.         permissions.
  91.  
  92.     13    Negative input for logarithmic functions. 
  93.         Make sure your input is positive when you 
  94.         use logarithmic scaled computations.
  95.  
  96.     14    UNIX library call tempnam() failed (that 
  97.         is, the system cannot create a tmp file in 
  98.         /usr/tmp). This is due to a space problem.
  99.  
  100.     15    SunView call textswstorefile() failed 
  101.         (cannot write the content of the text window 
  102.         to a disk file). Check the disk space.
  103.  
  104.     16    UNIX call chdir() failed. Check the 
  105.         directory pathname.
  106.  
  107.     17    Syntax error with a UNIX  name string.
  108.  
  109.     18    No FTP connection when selecting the Get 
  110.         Loop option. Select Connect from the FTP 
  111.         menu first.
  112.  
  113.     19    Unknown strings in the default file     
  114.         .imagetool_defaults. Use the Set 
  115.         defaults option from the Option menu to 
  116.         set up the default file.
  117.  
  118.     20    Unknown font. NCSA ImageTool could not 
  119.         find the specific font in         
  120.         /usr/lib/fonts/fixedwidthfonts.
  121.  
  122.  
  123. NCSA ImageTool Warning Messages
  124.  
  125. Warnings are not catastrophic failures, but the warnings in Table 
  126. B.2 indicate a situation that may require attention.
  127.  
  128.  
  129. Table B.2    Warning Numbers 
  130. and Descriptions
  131. Warning Number    Description
  132.  
  133.     25    Fewer bytes read from an image file. Either 
  134.         you have opened a bad image file or     
  135.         specified the wrong dimensions.
  136.  
  137.     26    Fewer bytes than specified written to a file. 
  138.         The system may be out of disk space.
  139.  
  140.     27    The raster format selected is not supported 
  141.         in the current version.
  142.  
  143.     28     The expansion factors are missing, and you 
  144.         have selected Expand from the Zoom menu. 
  145.         You must provide two integer expansion 
  146.         factors in the pop-up dialog box. The default 
  147.         factors are set to 1 x 1.
  148.  
  149.     29    The default file is missing. If you do not 
  150.         have a default file, .imagetool_defaults, 
  151.         in your home directory, NCSA ImageTool 
  152.         assumes the current directory is the default. 
  153.         NCSA ImageTool contains the images, 
  154.         palettes, and help files. You may select Set 
  155.         defaults from the Options menu to 
  156.         change the defaults.
  157.  
  158.  
  159. SunView and Operating System Errors
  160.  
  161. Operating system errors (Table B.3) indicate problems in 
  162. operating NCSA ImageTool or Suntool. These errors are not easily 
  163. recoverable, and may require the assistance of a system 
  164. administrator.
  165.  
  166. Table B.3    SunView and 
  167. Operating System 
  168. Errors
  169. Number    Cause and Solution
  170.  
  171.     9    SunView library call memcreate() failed. The 
  172.         system memory could be depleted.
  173.  
  174.     10    A UNIX memory allocation call,         
  175.         malloc() or calloc(), failed. Virtual memory 
  176.         space may be depleted.
  177.  
  178.     11    An error occurred while the system was     
  179.         reading a file. This should never happen. It could 
  180.         be caused by a system problem.
  181.  
  182.     12    An error occurred while the system was    
  183.         writing a file. You may have run out of disk space 
  184.         on the volume to which you were writing.
  185.  
  186.     14    The UNIX library call tempnam() failed. Space 
  187.         could not be allocated in the /usr/tmp directory. 
  188.         Check the available disk space on the /usr disk.
  189.  
  190.     15    The SunView call textswstorefile() failed. 
  191.         The textswstorefile() call attempts to store the 
  192.         contents of a text window to a file. If this call fails, 
  193.         you may have run out of disk space.
  194.  
  195.     20    NCSA ImageTool could not find the font it uses in 
  196.         the directory 
  197.         /usr/lib/ fonts/fixedwidthfonts.
  198.  
  199.  
  200. Numerical Problems
  201.  
  202.     13    The input value for a logarithmic function was 
  203.         negative. Make sure that input to a logarithmic 
  204.         scaling function is positive.
  205.  
  206.  
  207.