home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / dos / imdisp / doc / buffers.txt next >
Encoding:
Internet Message Format  |  1994-06-01  |  8.3 KB
  1. From:    SMTP%"BAALKE@KELVIN.JPL.NASA.GOV" 21-JUN-1991 11:20:35.21
  2. To:    warnock@stars.gsfc.nasa.gov, mmartin@jplpds.span.nasa.gov
  3. CC:    
  4. Subj:    IMDISP 7.2
  5.  
  6. Date:    Fri, 21 Jun 1991 15:22:31 GMT+0000
  7. From:    BAALKE@KELVIN.JPL.NASA.GOV (Ron Baalke)
  8. Message-Id: <910621152231.2900358a@KELVIN.JPL.NASA.GOV>
  9. Subject: IMDISP 7.2
  10. To:      warnock@stars.gsfc.nasa.gov, mmartin@jplpds.span.nasa.gov
  11. X-Vmsmail-To: IMDISP
  12.  
  13. Here are my latest changes for IMDISP 7.2.  They don't include Archie's latest
  14. changes, so they will have to be merged together.
  15.  
  16.                       ==============
  17.                       FILTER UPGRADE
  18.                       ==============
  19.  
  20. I've extended the MEAN filter to support a 5x5 mask.  To use it, type
  21.  
  22.    ENHANCE MEAN 1
  23.  
  24. I've found that a 5x5 mask smooths out the Magellan images much
  25. better than the regular 3x3 mask.
  26.  
  27.                       ================
  28.                       MULTIPLE BUFFERS
  29.                       ================
  30.  
  31. Multiple copies of images (or the entire screen) can now be copied and stored
  32. away into buffers, limited by the available memory.  If you don't have enough
  33. memory, the buffers can still be used, but as virtual files (see HINTS & TIPS
  34. ON CONSERVING MEMORY, down below).  Using the buffers, images can now be
  35. merged together to create interesting effects.  You can add or subtract
  36. images from each other.  You can store an image away into a buffer before
  37. applying a filter, and if you didn't like the result, then retrieve it
  38. back from the buffer, effectively creating an UNDO feature.  You can create
  39. a "face-on-Venus image" by merging the face-on-Mars image with a Magellan
  40. image.
  41.  
  42. There are 26 buffers available in IMDISP, limited by memory or disk space.
  43. The buffers are referenced by name as a single letter, one for each letter
  44. of the alphabet (A-Z).  Two new commands have been created to use the
  45. buffers:
  46.  
  47.    COPY
  48.    MERGE.
  49.  
  50. Buffers can only be created with the COPY or MERGE command.
  51.  
  52. The following existing commands were changed to accomodate the buffers:
  53.  
  54.    DISPLAY
  55.    ERASE
  56.    BROWSE
  57.    SET
  58.  
  59. ---------------------------------------------
  60. COPY - copies the image or screen to a buffer
  61. ----------------------------------------------
  62.  
  63. Syntax:
  64.  
  65. COPY  buffer [FILe]
  66. COPY  TO buffer [FILe]
  67. COPY  source TO buffer [FILe]
  68.  
  69.       where buffer = A-Z
  70.       where source = A-Z or SCReen
  71.  
  72. The COPY command will attempt to copy the image last displayed with the
  73. DISPLAY command, the screen or another buffer to a destination buffer.
  74. IMDISP will attempt to put the buffer into extended memory.  An FILE option
  75. is provided to allow the buffer to be put into a file on the disk.
  76.  
  77.  
  78. Examples:
  79.  
  80. COPY A                Copies the last displayed image to buffer A
  81. COPY A TO B           Copies buffer A to buffer B
  82. COPY A TO B FILE      Copies buffer A to buffer B, buffer B is a file
  83. COPY SCREEN TO Z      Copies the entire screen to buffer Z
  84.  
  85. ----------------------
  86. MERGE - Merge buffers
  87. ----------------------
  88.  
  89. Syntax:
  90.  
  91. MERGE buffer
  92. MERGE source1 [scale1] WITH source2 [scale2] [TO buffer] [FILE]
  93.  
  94. The MERGE command will merge buffers, images or the screen together.  A
  95. scaling option can be provided to control the amount of merging.  If the
  96. TO option is not used then the result will be displayed on the screen by
  97. default.  The result can also be written to a buffer.
  98.  
  99. Examples:
  100.  
  101. MERGE A                   Merge the last displayed image with buffer A and
  102.                           display the result back on the screen
  103.  
  104. MERGE A WITH B            Merge buffer A with buffer B and display the result
  105.                           on the screen.  Since no scaling parameter are
  106.                           specified IMDISP will default to 50% of A and 50% of
  107.                           B.
  108.  
  109. MERGE A WITH B TO C       Merge buffer A with buffer B and store the result
  110.                           into buffer C
  111.  
  112. MERGE A WITH B -1         Subtract buffer A from buffer B
  113.  
  114. MERGE A .75               Merge 25% of the last displayed image with 75% of
  115.                           buffer A, display the result on the screen.
  116.  
  117. MERGE A .75 with B .8     Merge 75% of buffer B with 80% of buffer B, display
  118.                           result on the screen
  119.  
  120. MERGE B WITH SCREEN       Merge buffer B with the screen
  121.  
  122. MERGE A 3 WITH B -2 TO C FILE    Subtract 200% of buffer B from 300% of A,
  123.                                  store the result in buffer.
  124.  
  125. -------------------
  126. DISPLAY (modified)
  127. -------------------
  128.  
  129. Modified to display a buffer.  Most of the options of the DISPLAY command
  130. can be used with the buffer
  131.  
  132. Examples:
  133.  
  134. DISP A                   Displays buffer A
  135. DISP A SUB 2             Displays buffer A, subsampled twice
  136. DISP A CEN ZOOM 3        Zooms in on the center of buffer A
  137.  
  138. ---------------
  139. ERASE (modifed)
  140. ---------------
  141.  
  142. When the ERASE is used with a buffer, the buffer will be erased and
  143. any memory allocated for the buffer will be freed up.
  144.  
  145. Example:
  146.  
  147. ERASE A                 Erase buffer A
  148.  
  149. ------------------
  150. BROWSE (modifed)
  151. -----------------
  152.  
  153. You can BROWSE through all of the buffers that have been created.  Useful
  154. if you forget what you put in which buffer.  Most of the options normally
  155. used with the BROWSE command can be applied to the buffers.
  156.  
  157. Examples:
  158.  
  159. BROWSE BUFFERS PAUSE      Displays the contents of each buffer, pausing
  160.                           in between each display
  161.  
  162. BRO BUFFERS SIZE 100 SUB 4    Displays a small version of each buffer
  163.  
  164. ------------
  165. SET BUFFERS
  166. ------------
  167.  
  168. If you use the FILE option on the COPY or MERGE command, IMDISP will create
  169. the buffer as a file on the hard disk.  The file will be created on the
  170. root directory of the C drive by default.  The file will be deleted if
  171. you ERASE the buffer, or upon exit from IMDISP.  If you do not want to
  172. have the buffer file created on the C:\ directory, then you specify the
  173. directory name with the SET BUFFERS command.
  174.  
  175. Examples:
  176.  
  177. SET BUFFERS c:\temp\
  178. SET BUFFERS d:\buffers\
  179.  
  180. ------------------------
  181. Putting it all together:
  182. ------------------------
  183.  
  184. The following example shows how to use the buffers that will sharpen an
  185. image.  If you blur an image, and then subtract the original from the blurred
  186. image, the net result is the image will be sharpened.
  187.  
  188. FILE io.img                load in a image
  189. DISP                       display it
  190. COPY A                     copy the image to buffer A
  191. ENH MEAN 1                 apply a 5x5 mean filter to blur the image
  192. COPY B                     copy the blurred image to buffer B
  193. MERGE A 3 WITH B -2        subtract 2 * B from 3 * A, display the result
  194.                            on the screen.  The image should now be sharpened.
  195.  
  196.  
  197.                      =================================
  198.                      HINTS & TIPS ON CONSERVING MEMORY
  199.                      =================================
  200.  
  201. If you have no extended memory, or don't have enough extended memory, don't
  202. despair.  You can still use the buffers if you use the following tips to
  203. help you maximize the use of the memory
  204.  
  205.      o IMDISP will automatically create a refresh buffer in extended memory
  206.        whose size is he size of the screen.  You can disable the refresh
  207.        buffer and this memory will be freed up for buffer use.  To disable
  208.        the refresh buffer, type:
  209.  
  210.            SET REFRESH OFF
  211.  
  212.        The refresh buffer can be enabled with
  213.  
  214.            SET REFRESH ON
  215.  
  216.      o IMDISP will also attempt to load an entire image into extended memory
  217.        whenever you do the FILE command.  You can have IMDISP not do this
  218.        by using the NOMEMORY option:
  219.  
  220.            FILE IO.IMG NOMEMORY
  221.  
  222.      o If you are using a Super VGA graphics card in its highest resolution,
  223.        then if you switch to a lower screen resolution, this will generally
  224.        cause the buffers to be smaller.  For example, if you using an
  225.        Orchid Pro Designer II card in its highest resolution (1024x768), then
  226.        you can switch to the 800x600 or 640x480 screen resolutions:
  227.  
  228.             SET DIS ORCHID800
  229.             SET DIS ORCHID
  230.  
  231.      o Subsample the image so that it doesn't take up the entire screen, which
  232.        then can be saved to smaller buffers:
  233.  
  234.              DISP SUB 3
  235.  
  236.      o Use the FILE option on the COPY or MERGE commands to store buffers
  237.        into a file instead of extended memory.
  238.  
  239.      o Erase any unused buffers:
  240.  
  241.               ERASE A
  242.