home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Science / Science.zip / imdisp79.zip / IMDISP.HLP < prev    next >
Text File  |  1992-12-21  |  18KB  |  415 lines
  1. .HELP
  2.  
  3. The following commands are available :
  4. BATch        . . . .  to execute a batch command file
  5. BRIghten     . . . .  add n to each DN value
  6. BROwse       . . . .  to display multiple files
  7. CD           . . . .  MSDOS change directory command
  8. COPy         . . . .  copy image to an internal buffer
  9. CURsor       . . . .  to move the cursor around
  10. DARken       . . . .  subtract n to each DN value
  11. DIR          . . . .  MSDOS directory command
  12. DISplay      . . . .  to display the image
  13. ENHance name . . . .  filter the image
  14. ERAse        . . . .  to erase the display
  15. EXIt or QUIt . . . .  to exit from the program
  16. FILe         . . . .  to specify the name of the image
  17. HIStogram    . . . .  to display the histogram of the image
  18. LABel        . . . .  to show image label
  19. LOG          . . . .  to save commands to a text file
  20. MASk         . . . .  to mask off pixels in the image
  21. MENu         . . . .  to invoke menu list
  22. MERge        . . . .  to combine internal buffers
  23. NEGative     . . . .  to photo negative the image
  24. OVErlay      . . . .  to draw grid lines on image
  25. PALette      . . . .  to adjust the palette for the display
  26. PERspective  . . . .  to display a pseudo-3D plot of the image
  27. PLOt         . . . .  to display and plot spectral data
  28. PROfile      . . . .  to plot a profile of the image
  29. REFresh      . . . .  to refresh the image plane
  30. ROTate       . . . .  to rotate a piece of the image
  31. SAVe         . . . .  to save the image display to a file
  32. SET          . . . .  to set display options
  33. SLAnt        . . . .  displays the image slanted left/right
  34. STRetch      . . . .  to do a linear gray scale stretch
  35. SYStem       . . . .  to execute MSDOS commands
  36. TEXt         . . . .  to place text on screen
  37. TYPe         . . . .  MSDOS type command
  38. WINdow       . . . .  to mark of a subimage on the display
  39.  
  40. Only the capitalized letters are required for the command.
  41. The commands take optional keywords and values.
  42.    The syntax is: COMMAND  KEY1=VAL1  KEY2 VAL2  . . .
  43. Type 'HELP command' for help on a particular command.
  44. .FILE
  45. FILE takes a required string value, i.e. the file name
  46. FILE without filename enters file prompt mode
  47. FILE with a filename mask enters file prompt mode with only the
  48.      matching filenames
  49. FILE also takes the following keyword:
  50.  
  51. NOMemory     forces FILE to read the image from disk, even if the
  52.              image is already in XMS memory
  53.  
  54. If the file does not have a recognizable (PDS, FITS, VICAR or
  55. GIF) header, the user is prompted for the number of lines,
  56. samples and bits per pixel and the number of initial bytes to
  57. skip.  If a pixel requires more than 1 byte of storage, the user
  58. is also asked whether the bytes need to be swapped (e.g., 16-bit
  59. integers written by a VAX will need to be swapped).  If the bytes
  60. need to be swapped, the displayed image or plot will look like
  61. random noise.
  62. .DISPLAY
  63. DISPlay takes the following keywords:
  64.  
  65. SUBsample    a positive integral subsampling factor
  66. ZOOm         a positive integral zoom factor
  67. CENter       to display area around cursor
  68. AUToset      to automatically set dnlow and dnhigh to some
  69.              percent n (def. 5 percent), based on histogram
  70. NL NS        number of lines and samples to display in image
  71. SL SS        starting line and sample in image
  72. LEFT RIGHT   move starting sample left or right from previous
  73. UP DOWN      move starting line up or down from previous
  74. DSL DSS      starting line and sample on display
  75. FLIp         flips the image top-to-bottom
  76. SOUrce       displays the source file, if given in the label for
  77.              Mars MDIM and Magellan F-MIDR only
  78. NOPrompt     command line prompt is not displayed
  79. .ERASE
  80. ERAse takes no parameters
  81. .SET
  82. SET takes the following keywords :
  83.  
  84. DNLOw  DNHIgh   the DN range to compress into display pixel
  85.                 Use no parameters to see the current values
  86. BROwse fname    sets the default filename for use with BROWSE
  87. SELect fname    sets default filename for use with BROWSE SELECT
  88. PALette dir     sets default palette directory name for use with
  89.                 PAL LOAD command
  90. NS = n          sets the number of samples/line for display
  91. SWAP            swaps bytes when reading the image (>8 bits)
  92. UNSWAP          resets SWAP, so bytes aren't swapped
  93. REFRESH ON      turns on the refresh buffer
  94. REFRESH OFF     turns off the refresh buffer
  95. DELay ON        for batch files - pauses before executing a line
  96. DELay OFF       for batch files - no pause before executing a line
  97. PROmpt ON       for batch files - enables display of each command
  98. PROmpt OFF      for batch files - disables display of each command
  99.  
  100. DISplay vname   changes the display type to the one specified.
  101.                 Standard graphics modes supported:
  102.                   CGA     (640x200x2)    EGA     (640x350x16)
  103.                   EGA480  (640x480x16)   VGA320  (320x200x256)
  104.                   VGA     (640x480x16)
  105.  
  106.                 Super VGA supported for the following:
  107.                  ATI640      (640x480x256) - ATI VGA Wonder Board
  108.                  ATI800      (800x600x256) - ATI VGA Wonder Board
  109.                  ATI1024     (1024x768x16) - ATI VGA Wonder Board
  110.                  EVGA512     (512x480x256) - Everex Board
  111.                  EVGA640     (640x480x256) - Everex Board
  112.                  ORCHID      (640x480x256) - Orchid Board
  113.                  ORCHID800   (800x600x256) - Orchid Board
  114.                  ORCHID1024 (1024x768x256) - Orchid Board
  115.                  PARADISE    (640x400x256) - Paradise Board 256K
  116.                              (640x480x256) - Paradise Board 512K
  117.                  TRIDENT     (800x600x256) - Trident SVGA Boards
  118.                  PGA         (640x480x256) - PGA Board
  119.  Use the DOS SET command before starting IMDISP to set the
  120.  default display type. EG: SET IMDISP=VGA will start up in VGA
  121.  mode.
  122. .HISTOGRAM
  123. HISTogram takes the following keywords :
  124.  
  125. SUBsample    a integral subsample factor for speed
  126. NL NS        number of lines and samples from image
  127. SL SS        starting line and sample in image
  128. CENter       do histogram on displayed portion of image
  129. VOY          Use histogram from standard PDS Voyager image
  130. VIK          Use histogram from standard PDS Viking image
  131. COL          draw histogram using current color settings
  132. .PALETTE
  133. PALette takes the following keywords :
  134.  
  135. EDIt = n    to interactively adjust n color palette using the
  136.             arrow keys on numeric keypad:
  137.              left(4) and right(6) move to different palette
  138.              color, ^left and ^right move to colors in larger
  139.              steps, HOME and END move to the beginning/end
  140.              colors, up(2), down(8) to increment/decrement all
  141.              colors, letters R, r, G, g, B, b to incr/decr the
  142.              color, invert the palette with x or X, scroll with S
  143.              or s, and . or carriage return to end.
  144. PSeudo color    PS = 0  for default palette
  145.                 PS = 1  for gray scale palette
  146.                 PS = 2  IBM EGA palette
  147.                 PS = 3  Redorange  PS = 4 Prism
  148.                 PS = 5  Topo       PS = 6 Contour
  149.                 PS = 7  BGRY       PS = 8 Glasses1
  150.                 PS = 9  Glasses2   PS =10 Perspective
  151. SAVe = file     saves palette in text file
  152. LOAd = file     loads palette from file, if no file is blank,
  153.                 then prompt mode is entered
  154. DISplay         displays the current palette on the screen
  155. ERAse           erases the current palette from the screen
  156. CYCle number    Cycle color palette, S or s saves the palette
  157.                 CYC = 0 Blink         CYC = 1 Blink 4 times
  158.                 CYC = 2 Rotate left   CYC = 3 Rotate right
  159.                 CYC = 4 Rotate+random CYC = 5 Random
  160.                 CYC = 6 Double rotate CYC = 7 Random swap
  161.                 FAST    delay .1 seconds between cycles
  162.                         instead of the default .3 seconds
  163.                 TIME n  to cycle for n seconds
  164. .STRETCH
  165. STREtch takes the following keywords :
  166.  
  167. LOw, HIgh     the low and high DN values of the stretch
  168.      e.g.  STRET HI=128     for a stretch between 0 and 128
  169. .CURSOR
  170. CURSor takes the following keywords:
  171.  
  172. DSL, DSS      place the cursor at the specified display line and
  173.               sample location
  174.  
  175. Use the mouse or numeric keypad to move the cursor around, '-'
  176.  and '+' to change the cursor step size, and '.' or carriage
  177.  return to end.
  178. .PROFILE
  179. PROFile takes no parameters
  180. Use the mouse or numeric keypad to move the cursor around, '-'
  181.  and '+' to change the cursor step size, '.' or carriage return
  182.  to select the first and second points
  183. .REFRESH
  184. REFResh takes no parameters
  185. Redisplays the images from the refresh buffer and erases any
  186. graphics currently on the screen.
  187. .BATCH
  188. BATch takes the following keywords :
  189.  
  190. filename     filename of batch command file
  191. .SAVE
  192. SAVe takes the following keywords :
  193.  
  194. filename     filename of image to save. If the filename has the
  195.              extension GIF, the file will be saved in GIF format.
  196.              Be patient - GIF takes time.
  197. REFRESH      saves the screen to the refresh buffer
  198. NL NS        number of lines and samples to save
  199. SL SS        starting line and sample to save
  200. BP           number of bits per pixel in output image
  201. .DOS
  202. The following MSDOS commands are supported:
  203.  
  204. drive letter:  Change default drive to specified letter
  205. CD    path     MSDOS change directory command
  206. DIR   mask     MSDOS directory command
  207. TYPe  filename MSDOS type command
  208. SYStem or >    Spawns an MSDOS process
  209. SYStem name    executes program name
  210. .MENU
  211. MENu takes the following keywords :
  212.  
  213. filename     filename of menu list file
  214. .LABEL
  215. LABel prints the label for the current PDS or FITS
  216. format image.
  217. .TEXT
  218. TEXt takes the following format :
  219.  
  220. LINe         line number to position text at
  221. SAMple       sample number to position text at
  222. TEXT         'text to type out on screen' <cr>
  223. .OVERLAY
  224. OVErlay takes the following keywords :
  225.  
  226. MAXLAT       the upper left latitude of the current image
  227. MAXLON       the upper left longitude of the current image
  228. LEGend       draw a legend with the current color assignments
  229. DN           the dn value to use for drawing grid lines
  230. .BROWSE
  231. BROwse takes the following keywords :
  232.  
  233. mask         a wildcard (ie. *.IMG) to select files to browse
  234. SIZE         the size to use for displaying multiple images
  235. SUB          a subsampling factor to use to display images ie.
  236.              'SUB 2' scales the image to half size
  237. AUToset      to automatically set dnlow and dnhigh to some
  238.              percent n (def. 5 percent), based on histogram
  239. NOLabel      do not put the filename label on displayed images
  240. DNLow DNHigh sets the DN range for all images (see SET)
  241. PAUse n      pauses display for n seconds when the screen gets full
  242. ALL          searches all subdirectories in addition to the
  243.              current directory
  244. SELect       interactively selects files as they are being
  245.              displayed and writes the filenames out to a select
  246.              file
  247. FILe fname   select files to browse from a file instead of using
  248.              a mask
  249. .PLOT
  250. PLOt takes the following keywords :
  251.  
  252. LIN n      plot line n of the image (2-D file only)
  253. SYMbol x   draw the plot using character x instead of a line
  254. ZOOm       prompt user to zoom the plot
  255. OVErlay    overplot - do not erase the current plot
  256. CENter     plot the image line containing the cursor
  257. MAX n      set the maximum value in the plot
  258. MIN n      set the minimum value in the plot
  259. COLor n    use DN value n to plot the data
  260. SPEctral   analyze the plot of a spectrum
  261. .SERIAL
  262. SERial takes the following keywords :
  263.  
  264. INIt               initialize the serial port
  265. COM  n             set COMn as the serial port to use
  266. BAUd n             set the baud rate to n
  267. COMmand 'string'   write 'string' out the serial port
  268. .PRINT
  269. PRInt takes the following keyword :
  270.  
  271. TEK4693      use the Tektronix 4693DX driver
  272. .NEGATIVE
  273. NEGative takes no parameters
  274. .BRIGHTEN
  275. BRIghten n  adds n to every pixel in the image
  276.             The default is 10% of the total range, i.e., 2 for a
  277.             16 color display, 26 for a 256 color
  278. .DARKEN
  279. DARken n    subtracts n from every pixel in the image
  280.             The default is 10% of the total range, i.e., 2 for a
  281.             16 color display, 26 for a 256 color
  282. .ENHANCE
  283. ENHance takes the following keywords:
  284.  
  285. BAAlke         applies a custom filter developed by Ron Baalke
  286. CONvolution n  applies one of 2 weighted 3x3 filter to the image
  287. EDGe n         applies one of 4 3x3 edge enhancement filters
  288. LOG n          applies a logarithmic filter to the image
  289. MEAn n         applies one of 3 mean filters to the image
  290. MEDian         applies a 3x3 median filter to the image
  291. POWer n        applies an exponential filter to the image
  292. STAir n        applies a stairstep smoothing to the image
  293. SMEar          applies a smearing filter to the image
  294. UNSharp        applies an unsharp mask filter to the image
  295. SCReen         applies the filter only to the image on the
  296.                screen, instead of the entire image
  297. .SLANT
  298. SLAnt takes the following keywords:
  299.  
  300. LEFt         displays the image slanted to the left
  301. RIGht        displays the image slanted to the right (default)
  302. SCReen       slants the image currently on the screen
  303. .LOG
  304. LOG takes the following keywords:
  305.  
  306. ON           saves entered commands to the file IMDISP.LOG
  307. FILe name    saves entered commands to the file named
  308. OFF          closes the log file (same as CLOse)
  309. CLOse        closes the log file (same as OFF)
  310. .PERSPECTIVE
  311. PERspective takes the following keywords:
  312.  
  313. SL n         starting line of the image
  314. SCR          reads image from the screen buffer
  315. .COPY
  316. COPy uses buffers named A through Z.  COPy has these forms:
  317.  
  318. COPy buffer [FILE]  copies last displayed image to the buffer
  319.                     specified (may be a disk file
  320.  
  321. COPy source TO buffer [FILE]  where source can be SCREEN or
  322.                               another buffer
  323. .MERGE
  324. MERge combines buffers or images.  MERge has these forms:
  325.  
  326. MERGE buffer  Merge last displayed image with the buffer named
  327.               and display the result
  328.  
  329. MERge source1 [scale1] WITH source2 [scale2] [TO buffer] [FILE]
  330.         to perform image arithmetic
  331. .MASK
  332. MASk substitutes a value for all pixels above or below a
  333.      specified value.  MASk takes the following keywords:
  334.  
  335. LO n     sets all pixels with a DN less than n to 0
  336. HI n     sets all pixels with a DN greater than n to 255
  337. WITh n   sets the pixels to value n instead of the default
  338. .WINDOW
  339. WINdow  sets the limits of a subimage by marking out a box on the
  340.         screen. WINdow takes the following keywords:
  341.  
  342. CANcel  sets the default back to the entire screen
  343. L1      sets the first line of the window
  344. L2      sets the last line of the window
  345. S1      sets the first sample of the window
  346. S2      sets the last sample of the window
  347. .ROTATE
  348. ROTate  n  rotates the image or subimage through the specified
  349.            angle. ROTate takes the following keywords:
  350.  
  351. SCReen     rotates the screen, rather than the entire image
  352. CLIp       trims off pieces of the image off the screen
  353. NOFill     don't blank out the empty parts of the result
  354. .OPTIONS
  355.    Within this command summary listing, brackets ([]) indicate
  356. optional parameters or keywords.  Filename is the name of a file
  357. in the current directory or a fully qualified filename which can
  358. include drive letter and pathname.  Directory name is an MS-DOS
  359. directory path specification, a valid directory mask a
  360. specification containing wild card characters (*, ?) per MS-DOS
  361. rules for wildcard use in the DIRECTORY command.  The symbol "n"
  362. is used to indicate an integer value.
  363.  
  364.   BATCH        [filename]
  365.   BRIGHTEN     [n]
  366.   BROWSE       [directory mask] [SIZe n] [SUB n] [NOLabel]
  367.                [DNLOw n] [DNHIgh n] [PAUse n] [ALL] [SELect]
  368.                [FILe] [BUFFERS] [AUToset n]
  369.   CD           [directory name] [..]
  370.   CHDIR        [directory name] [..]
  371.   COPY         [buffer [TO buffer]] [FILE]
  372.   CURSOR       [DSL n] [DSS n]
  373.   DARKEN       [n]
  374.   DIRECTORY    [directory mask] [/w]
  375.   DISPLAY      [SUB n] [SL n] [SS n] [NL n] [NS n] [BP n]
  376.                [CENTer] [DSL n] [DSS n] [ZOOm] [FLIP] [NOPrompt]
  377.                [NOMemory] [AUToset] [SOUrce] [CURsor] [buffer]
  378.   ENHANCE      [BAAlke] [CONvolution n] [EDGe n] [HIGh n]
  379.                [HIStogram] [LOG n] [MEAn n] [MEDian] [POWer n]
  380.                [STAir n] [SMEar] [SCReen] [UNSharp]
  381.   ERASE        [REFRESH] [buffer]
  382.   EXIT         [NOClear]
  383.   FILE         [filename[.GIF]] ["CD:mm:ss:bb"] [NOMemory]
  384.   HELP         [command name]
  385.   HISTOGRAM    [SUB n] [SL n] [SS n] [NL n] [NS n] [BP n]
  386.                [CENter] [VOYager] [VIKing] [buffer]
  387.   LABEL
  388.   LOG          [ON] [FILe filename] [CLOse] [OFF]
  389.   MASK         [LO n [WITH n]] [HI n [WITH n]]
  390.   MENU         [filename]
  391.   MERGE        [buffer [scale] [WITH buffer [scale] [TO buffer]]]
  392.                [FILE]
  393.   NEG
  394.   OVERLAY      [MAXLAT n] [MAXLON n] [MINLAT n] [MINLON n] [LEGend]
  395.   PALETTE      [EDIT n] [PS n] [LOAd filename] [SAVe filename]
  396.                [DISplay] [ERAse] [CYC n [FAST] [TIME n]]
  397.   PERSPECTIVE  [SL n] [SCR]
  398.   PLOT         [LINE n] [SYMBOL x] [COLOR n] [MAX n] [MIN n]
  399.                [OVERLAY] [ZOOM] [SPECTRAL]
  400.   PROFILE
  401.   QUIT         [NOClear]
  402.   REFRESH
  403.   ROTATE       [n] [SCReen] [NOFill] [CLIp]
  404.   SAVE         filename[.GIF] [FORmat fmt] [SL n] [SS n] [NL n]
  405.                [NS n] [BP n] [REFRESH]
  406.   SET          [DNLO n] [DNHI n] [BROwse filename] [DIS name]
  407.                [NS n] [PAL dir] [REFresh ON/OFF] [DELay ON/OFF]
  408.                [PROmpt ON/OFF] [BUFFERS dir]
  409.   SLANT        [RIGht] [LEFt]
  410.   STRETCH      [LO n] [HI n]
  411.   SYSTEM       [MS-DOS command]
  412.   TEXT         [LINe n] [SAMple n] "text" or 'text' [NOPrompt]
  413.   TYPE         filename
  414.   WINDOW       [CANcel] [S1 n] [L1 n] [S2 n] [L2 n]
  415.