home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / DemoApps / Graphics / Viewers / ImageViewer / README
Encoding:
Text File  |  1994-06-08  |  6.6 KB  |  159 lines
  1. Welcome to ImageViewer 0.9i
  2. ===========================
  3.  
  4. ImageViewer is a freeware application that gives you the ability to display
  5. and convert between a multitude of image formats.  Among the supported formats
  6. are:
  7.  
  8. atkras    Andrew Rasterfiles (binary and ascii)        read
  9. gif    Graphics Interchange Format            read
  10. itex    ITEX Framegrabber Files                read    write
  11. pbm    Jef Poskanzer's Portable Bitmaps (binary)    read    write
  12. pgm    Jef Poskanzer's Portable Graymaps (binary)    read    write
  13. ppm    Jef Poskanzer's Portable Pixmaps (binary)    read    write
  14. jpg    JPEG File Interchange Format (JFIF)        read    write
  15. macp    MacPaint Documents                read    write
  16. mtek    Mikrotek Scanner Files                read
  17. eps    PostScript Encapsulated Files            read    write
  18. ps    PostScript (plain)                    write
  19. ras    Sun Rasterfiles                    read    write
  20. rle    UTAH Run-length Encoded Rasterfiles        read
  21. icon    Sun Icon Files (old and new format)        read    write
  22. tiff    Tagged Image File Format            read    write
  23. face    USENET Face Files                read    write
  24. xbm    X11 Bitmaps                    read    write
  25. ilisp    Xerox Interlisp-D Source            read
  26. brush    Xerox Brush/Press Files                read
  27. ais    Xerox Array of Intensity Samples        read
  28.  
  29. ImageViewer is built around a general image reader/converter/writer that
  30. automatically identifies the type of each image by examining the contents of
  31. the file.  File types (extensions) are only used if the content detector
  32. fails.  The displayed images can be scaled, resized, and copied to the
  33. pasteboard as TIFFs, but that's pretty much all.
  34.  
  35. To change the size of an image, bring up the inspector panel and type in the
  36. new width and height (in pixels).  You can also scale it proportionally by
  37. entering a single scale factor in the scale field, or two factors (X and Y)
  38. separated by a slash.  Note that either of these operations will only change
  39. your view of the image.  If you save it, it will still be in its original
  40. size.
  41.  
  42. This version of ImageViewer also includes a minimal image filtering service
  43. that can translate the listed formats to TIFF.  The service will automatically
  44. be activated when any application that uses the NXImage object and wants to
  45. import an image file but doesn't understand the format.  Try it by installing
  46. ImageViewer in ~/Apps or /LocalApps and drag a non-TIFF image into an Edit
  47. window or a Mail message.  You should see the icon turn into the real image
  48. inside the Edit/Mail window after a short delay.  Note that you haven't
  49. changed the image file itself, ie. if you send that message, you're really
  50. sending the original image file, not a TIFF version of it.
  51.  
  52.  
  53. Some nits:
  54.  
  55. Because ImageViewer nominally can create TIFF files with non-standard
  56. bits/sample that currently are unreadable on a NeXT, there is a switch in the
  57. preference panel that will avoid this problem by always creating TIFFs with
  58. bits/sample values that are powers of two.  It is recommended that you always
  59. have this turned on, as the difference in saved storage space is minor.
  60.  
  61. The print function will normally produce output suitable for your chosen
  62. printer.  However, there are some circumstances under which it may create
  63. color PostScript while you only want grayscale.  To avoid this, check the
  64. preference marked "Print using grayscale".  (This used to be more of a problem
  65. under 2.X, so you probably won't need to worry about it.)
  66.  
  67. There is now a default compression choice for TIFF images in the preference
  68. panel.  Changing this will cause all TIFFs that you save to use the chosen
  69. compression.  Note that colormapped images can only be saved with without
  70. compression; choosing either LZW or JPEG will cause the images to be
  71. automatically converted to grayscale or RGB before being saved.
  72.  
  73. Sorry, alpha (transparency) is still not supported.  Images will alpha will
  74. receive a white background and lose their transparency.
  75.  
  76.  
  77. What about "image"?
  78.  
  79. "image" is a standalone command line converter based on the same conversion
  80. engine as ImageViewer.  Please see the supplied man page for instructions on
  81. how to use it.
  82.  
  83.  
  84. Changes since the last version (0.9e or so):
  85.  
  86. * Enabled optimized code that converts 8 bit CLUT images to 24 bit RGB.  The
  87.   code was already there, just not used (sigh).  This will make ImageViewer
  88.   decode all 8 bit CLUT images (eg. most GIFs) about 2x faster.
  89.  
  90. * Made ImageViewer recognize and claim .GIF and .JPG files (with capitalized
  91.   file types).
  92.  
  93. * Added a trivial image filtering service that translates typed filenames
  94.   to NXTIFFPboardType.  Worked around a limitation in services that maximizes
  95.   the number of send types to 16 by splitting up the declarations in batches.
  96.  
  97. * Fixed bug in code using NXStreams that left image files mapped into memory
  98.   even after they were closed.  This should make ImageViewer much less of a
  99.   memory hog.
  100.  
  101. * Fixed a bug in the decoding of ASCII PGM images.  The checkers are now
  102.   correctly sized.
  103.  
  104. * Fixed a bug in the code that demultiplies alpha out of 12 bit TIFF images.
  105.   No more weird golf playing tints.
  106.  
  107. * Added minimal GIF89a support and fixed a bug in the extensions processing
  108.   code. Mostly the same as before; main difference is that comment fields will
  109.   be printed on stderr.
  110.  
  111. * Fixed byte ordering dependencies (two if I remember correctly).  Fat (m68k,
  112.   i386, NRW) compiles now work like a charm.
  113.  
  114. * Removed Rainbow support.  I don't think anybody uses it anyway.
  115.  
  116. * Added minimal support for Windows BMP file format (does this work?)
  117.  
  118. * Fixed swapped 16 bit input bug in Utah RLE decoder.
  119.  
  120. * Made tiff decoder choose richest representation for multipart tiff files.
  121.   (Yes, it would be nice to be able to keep them all, but my internal
  122.   image representation can't handle it.  Sorry.)
  123.  
  124. * Fixed bug in grayscale resampling code (im_togray) that caused some printed
  125.   images to come out really aweful.
  126.  
  127. * Fixed some bugs that caused the right side of printed images to be
  128.   truncated.  Also reduced the margins.
  129.  
  130. * Added a max window size preference that will limit new windows to the given
  131.   width and height.  ShrinkWrapped images will be scaled while ScrollViews
  132.   will be clipped to conform.
  133.  
  134. * Added a default compression preference to be used when saving TIFF files.
  135.   Choosing anything else than "None" will cause NeXT's native TIFF routines to
  136.   be used instead of my own homebrew code.
  137.  
  138.  
  139. Disclaimer:
  140.  
  141. This is unsupported freeware; if it works, it works, if it doesn't, it
  142. doesn't.  Give it to anyone you like, but please don't charge for it.  I
  143. don't.  Feel free to let me know about any problems, but please don't rely on
  144. them being fixed.
  145.  
  146. ImageViewer is an application that I put together on my spare time while
  147. working at Rank Xerox EuroPARC.  It is not a product of, nor condoned by NeXT
  148. Inc. in any way.  Please don't bother them about problems or questions.
  149.  
  150. (Etc, etc.  I think you get the general gist.)
  151.  
  152.  
  153. Enjoy,
  154.  
  155. Lennart Lovstrand
  156. California, May 1993
  157.  
  158. lenlo@al.org, Lennart_Lovstrand@NeXT.COM
  159.