home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / graphic / viewfits / viewfits.doc < prev    next >
Encoding:
Text File  |  1993-08-03  |  3.7 KB  |  111 lines
  1. ViewFITS : FITS viewer for OS/2 PM.
  2. -----------------------------------
  3.  
  4. Current status: Version 0.3, release 2, August 3, 1993
  5.  
  6. THIS VERSION (0.3, R2) IS FREEWARE, YOU CAN GIVE IT TO OTHER PERSONS WITHOUT
  7. ANY FEE.  YOU MUST GIVE IT IN THE SAME FORM, I.E. WITH THE SAME FILES, AS YOU
  8. RECEIVED IT. USE IT AT YOUR OWN RISKS.  THE AUTHOR IS NOT RESPONSIBLE FOR ANY
  9. DAMMAGES OR MISINTERPRETATIONS OF THE DATA HANDLED WITH THIS PROGRAM.
  10.  
  11.  
  12. Introduction:
  13. ------------
  14.  
  15. ViewFITS is a FITS viewer for the OS/2 PM.  "FITS" stands for "Flexible
  16. Image Transport System", a standard in use for many years by professonials.
  17. ViewFITS, in the current version, can display images of any format, 8 to 32
  18. bits per pixel, integers or floating points.  The colour palette (LookUp Table)
  19. can be easily modified to help the user to get the maximum of the image. Let's 
  20. see the principal characteristics.
  21.  
  22.  
  23. Handling data:
  24. -------------
  25.  
  26. In the present version, new image can only be got via menu (FILE/NEW).
  27. In a future release, we project to make the application be able to
  28. read arguments on command line and use pipes to communicate with other
  29. programs.  It will then be used as a "client" program.
  30.  
  31.  
  32. The colour palette:
  33. ------------------
  34.  
  35. The colour palette, or lookup table, contains 64 colours.  They are scaled
  36. via a linear equation.  So, the user can modify the contrast and the
  37. brightness of the palette to customize the display as s/he wants.  Negativation 
  38. can be do as well. In all cases, data are processed to be spread over all the 
  39. dynamic range of the palette:
  40.  
  41. e.g.:
  42.  
  43. Your image has pixels with values from 100 to 300, so the dynamic range is
  44. 200.  The intercept of the image is then Ii=100 and the slope is given by
  45. Si= (number of colour) / (dynamic range) = 64/200 = 0.32.
  46.  
  47. This way, each a pixel is drawn, its colour is Cp=(Vp - Ii) * Si.  Let's
  48. imagine we have Vp=150, Cp = (150 -100) * 0.32 = 16.  Pixels with Vp=100
  49. will get Cp=0 and Vp=300, Cp=63 (not 64!) where Cp is the colour index, i.e.
  50. the position in the lookup table.
  51.  
  52. The menu PALETTE allows the user to modify the contrast and the brightness of
  53. the lookup table.  This way, a given pixel will always have the same colour
  54. index but the corresponding colour value will change.
  55.  
  56. The PALETTE menu allows the user to do negativation too.
  57.  
  58. Zooming:
  59. -------
  60.  
  61. The zoom option on the menu allows the user to zoom in or zoom out the image.
  62. Each zooming modify the scaling factor by a factor of 2.
  63.  
  64. Known bugs:
  65. ----------
  66.  
  67. Here is a short list of know bugs:
  68.  
  69. 1- There is an error in the palette manager (I have nothing to do with this).
  70. If you have a window that modify the palette over the image, the palette
  71. won't be restored once the window has moved.  To correct that, use REFRESH.
  72.  
  73.     ( It seems to be fixed on OS/2 2.1 GA. )
  74.  
  75. 2- Because it use palette manager, this application cannot be used under OS/2
  76. 2.0.  It only works under version 2.1 beta and 2.1 GA.
  77.  
  78. 3- When zooming, it is not possible to see a hidden part of the image.  It
  79. will be fixed soon.
  80.  
  81.  
  82. Improvments since last release:
  83. ------------------------------
  84.  
  85. 1- A bitmap is now used insteed of direct drawing to the screen.  Faster!
  86.  
  87. 2- Zooming in and out is possible.
  88.  
  89. 3- Now, the data are displayed in the right sense, up is up and down is down.
  90.  
  91. 4- Before, a direct memory acces in the program caused a protection violation
  92. and an exit to the system.  Now it has been fixed.
  93.  
  94.  
  95. Unknown bugs:
  96. ------------
  97.  
  98. I'm waiting for your reports!  You can join me via e-mail at
  99.  
  100. beaucham@phy.ulaval.ca
  101.  
  102. or on the FIDONet forum "astronomy echo".
  103.  
  104.  
  105. VERSION 0.3, is FREEWARE.
  106.  
  107.  
  108. Dominique Beauchamp
  109. Quebec City
  110. August 3, 1993
  111.