home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / d / disp125.zip / READ.ME < prev    next >
Text File  |  1993-03-29  |  8KB  |  226 lines

  1. ******   You may distribute this program freely for non-commercial use
  2.          if no fee is gained.
  3. ******   There is no warranty. The author is not responsible for any
  4.          damage caused by this program.
  5.  
  6.  
  7. (1) Introduction:
  8.   This program can let you READ, WRITE and DISPLAY images with different
  9.   formats. It also let you do some special effects(ROTATION, DITHERING ....) 
  10.   on image. Its main purpose is to let you convert image among different 
  11.   formts.
  12. +  There is NO LIMIT on image size.
  13. +  Currently this program supports 8, 15, 16, 24 bits display.
  14. +  If you want to use HiColor or TrueColor, you must have VESA driver.
  15. +  If you want to modify video driver, please read section (8).
  16.  
  17.  
  18. (2) Hardware Requirement:
  19.   PC 386 or better. MSDOS 3.3 or higher.
  20.   min amount of ram is 4M bytes(Maybe less memory will also work).
  21.   (I recommend min 8M bytes for better performance).
  22.   Hard disk for swapping(virtual memory).
  23.  
  24. +  The following description is borrowed from DJGPP.
  25. +
  26. +  Supported Wares:
  27. +
  28. +  * Up to 128M of extended memory (expanded under VCPI)
  29. +  * Up to 128M of disk space used for swapping
  30. +  * SuperVGA 256-color mode up to 1024x768
  31. +  * 80387
  32. +  * XMS & VDISK memory allocation strategies
  33. +  * VCPI programs, such as QEMM, DESQview, and 386MAX
  34. +
  35. +  Unsupported:
  36. +
  37. +  * DPMI
  38. +  * Microsoft Windows
  39. +
  40. +  Features: 80387 emulator, 32-bit unix-ish environment, flat memory
  41. +  model, SVGA graphics.
  42.  
  43.  
  44. +(3) Installation:
  45. +  Please read runme.bat for more information.
  46. +  Video drivers, emu387 and go32.exe are borrowed from DJGPP.
  47. +  (This GO32.EXE is a modified version for vesa and is COMPLETELY compatible
  48. +   with old version)
  49. +
  50. +  If you choose xxxxx.grn as video driver, add 'nc 256' to environment
  51. +    GO32.
  52. +
  53. +  For example, go32=driver x:/xxxxx/xxxxx.grn nc 256
  54. +
  55. +  If you don't have 80x87, add 'emu x:/xxxxx/emu387' to environment GO32.
  56. +
  57. +  For example, go32=driver x:/xxxxx/xxxxx.grd emu x:/xxxxx/emu387
  58. +
  59. +  **** Notes: 1. I only test tr8900.grn and et4000.grn. Other drivers are
  60. +                 not tested.
  61. +              2. I have modified et4000.grn to support 8, 15, 16, 24 bits
  62. +                 display. You don't need to use vesa driver.
  63. +                 If et4000.grn doesn't work, please try vesa.grn.
  64. +              3. For those who want to use HiColor or TrueColor display,
  65. +                 please use vesa.grn(except et4000 users).
  66. +                 You can find vesa driver from :
  67. +                   wuarchive.wustl.edu: /mirrors/msdos/graphics
  68. +                   godzilla.cgl.rmit.oz.au: /kjb/MGL
  69.  
  70.  
  71. +(4) Command Line Switch:
  72. +    
  73. +    Usage : display [-d initial display type]
  74. +
  75. +    Currently support 8(SVGA), 15, 16(HiColor), 24(TrueColor)
  76.  
  77.  
  78. (5) Function Key:
  79.  
  80.     F2: change driver
  81.  
  82.     F3: change filename mask (See match.doc)
  83.  
  84.     F4: change parameter
  85.  
  86.     F5: some effects on picture, eg. flip, rotate ....
  87.  
  88.     F7: Make Directory
  89.  
  90.     t : Tag file
  91.  
  92.     T : Tag all files
  93.  
  94.     u : Untag file
  95.  
  96.     U : Untag all files
  97.  
  98.     F6,m,M : Move file(s)
  99.  
  100.     F8,d,D : Delete file(s)
  101.  
  102.     r,R : Rename file
  103.  
  104.     c,C : Copy File(s)
  105.  
  106.     z,Z : Display first 10 bytes in Ascii, Hex and Dec modes.
  107.  
  108.     Page Up/Down : move one page
  109.  
  110.     TAB: change processing target.
  111.  
  112. +   Arrow keys, Home, End, Page Up, Page Down: Scroll image.
  113. +     Home: Left Most.
  114. +     End: Right Most.
  115. +     Page Up: Top Most.
  116. +     Page Down: Bottom Nost.
  117. +     in 'screen' menu :
  118. +       Left,Right arrow: change display type(8, 15, 16, 24 bits)        
  119.  
  120.     Escape: abort function and return.
  121.  
  122.  
  123. (6) Support Format:
  124.  
  125.   Read: GIF(.gif), Japan MAG(.mag), Japan PIC(.pic), Sun Raster(.ras),
  126.         Jpeg(.jpg), XBM(.xbm), Utah RLE(.rle), PBM(.pbm), PGM(.pgm),
  127.         PPM(.ppm), PM(.pm), PCX(.pcx), Japan MKI(.mki), Tiff(.tif),
  128.         Targa(.tga), XPM(.xpm), Mac Paint(.mac), GEM/IMG(.img),
  129.         IFF/ILBM(.lbm), Window BMP(.bmp), QRT ray tracing(.qrt),
  130.         Mac PICT(.pct), VIS(.vis), PDS(.pds), VIKING(.vik), VICAR(.vic).
  131.  
  132.         the extensions in () are standard extensions.
  133.  
  134.   Write: GIF, Sun Raster, Jpeg, XBM, PBM, PGM, PPM, PM, Tiff, Targa,
  135.          XPM, Mac Paint, Ascii, Laser Jet, IFF/ILBM, Window BMP,
  136.          Mac PICT, VIS.
  137.  
  138.   All Read/Write support full color(8 bits), grey scale, b/w dither,
  139.       and 24 bits image, if allowed for that format.
  140.  
  141.  
  142. (7) Detail:
  143.  
  144.    1. When you run this program, you will enter 'read' menu. Whthin this
  145.       menu you can press any function key except F5. If you move or copy
  146.       files, you will enter 'write' menu. the 'write' menu is much like
  147.       'read' menu, but only allow you to change directory.
  148.       press SPACE in 'read' menu will let you select which format to use
  149.         for reading current file.
  150.       press RETURN in 'read' menu will let you reading current file. This
  151.         program will automatically determine which format this file is.
  152.         The procedure is: First, check magic number. If fail, check
  153.         standard extension. Still fail, report error.
  154.  
  155.    2. Once image file is successfully read, you will enter 'screen' menu.
  156.       Within this menu F5 is turn on. You can do special effect on image.
  157.       press RETURN: read image.
  158.       press TAB: change processing target. This program allows you to do
  159.         special effects on 8-bit or 24-bit image.
  160. +     press Left,Right arrow: change display type. 8, 15, 16, 24 bits.
  161.       press SPACE: save current image to file.
  162.         B/W Dither: save as black/white image(1 bit).
  163.         Grey Scale: save as grey image(8 bits).
  164.         Full Color: save as color image(8 bits).
  165.         True Color: save as 24-bit image.
  166.       
  167. +       This program will ask you some questions if you want to write image
  168. +       to file. Some questions are format-dependent. Finally This program
  169. +       will prompt you a filename. If you want to save file under another
  170. +       directory other than current directory, please press SPACE. after
  171. +       pressing SPACE, you will enter 'write2' menu. You can change
  172. +       directory to what you want. Then,
  173. +
  174. +       press SPACE: this program will prompt you 'original' filename.
  175. +       press RETURN: this program will prompt you 'selected' filename
  176. +                     (filename under bar).
  177.  
  178.  
  179. + 3. This program supports 8, 15, 16, 24 bits display.
  180.  
  181.   4. This Program is MEMORY GREEDY. If you don't have enough memory,
  182.      the performance is poor.
  183.  
  184.   5. If you want to save 8 bits image :
  185.        try GIF then TIFF(LZW) then TARGA then Sun Raster then BMP then ...
  186.  
  187.      If you want to save 24 bits image (lossless):
  188.        try TIFF(LZW) or TARGA or ILBM or Sun Raster
  189.        (No one is better for true 24bits image)
  190.  
  191.   6. I recommend Jpeg for storing 24 bits images, even 8 bits images.
  192.  
  193.   7. Not all subroutines are fully tested
  194.  
  195.   8. This document is not well written. If you have any problem,
  196.      comment or image format document,
  197.      Please send to u7711501@bicmos.ee.nctu.edu.tw (140.113.11.13).
  198.  
  199.  
  200. (8) Tech. information:
  201.   Program (user interface and some subroutines) written by Jih-Shin Ho.
  202.   Some subroutines are borrowed from XV(2.21) and PBMPLUS(dec 91).
  203.   Tiff and Jpeg(V4) read/write are through public domain libraries.
  204.   Compiled with DJGPP.
  205.   You can get whole DJGPP package from SIMTEL20 or mirror sites.
  206.     For example, wuarchive.wustl.edu: /mirrors/msdos/djgpp
  207.  
  208.  
  209. +(9) For Thoese who want to modify video driver:
  210. +   1. get GRX source code from SIMTEL20 or mirror sites.
  211. +   2. For HiColor and TrueColor:
  212. +        15 bits : # of colors is set to 32768.
  213. +        16 bits : # of colors is set to 0xc010.  
  214. +        24 bits : # of colors is set to 0xc018.
  215.  
  216.  
  217. Acknowledgment:
  218.   I would like to thank the authors of XV and PBMPLUS for their permission
  219.     to let me use their subroutines.
  220.   Also I will thank the authors who write Tiff and Jpeg libraries.
  221.   Thank DJ. Without DJGPP I can't do any thing on PC.
  222.  
  223.  
  224.                                             Jih-Shin Ho
  225.                                    u7711501@bicmos.ee.nctu.edu.tw
  226.