home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / ImageMagick / README < prev    next >
Encoding:
Text File  |  1995-07-14  |  11.4 KB  |  327 lines
  1. AUTHOR
  2.  
  3.   The author is cristy@dupont.com.  Comments, suggestions, or bug
  4.   reports are welcome, but be kind.
  5.  
  6.  
  7. AVAILABLILITY
  8.  
  9.   Anonymous FTP at export.lcs.mit.edu, file contrib/ImageMagick.tar.Z.
  10.  
  11.  
  12. UNIX COMPILATION
  13.  
  14.   Type:
  15.  
  16.     uncompress ImageMagick.tar.Z
  17.     tar xvf ImageMagick.tar
  18.     cd ImageMagick
  19.     xmkmf
  20.     make Makefiles
  21.     make
  22.  
  23.   If you do not have 'xmkmf', edit 'Makefile' as required by your
  24.   hardware environment and type 'make'.
  25.  
  26.   Finally type:
  27.  
  28.     display images/aquarium.miff
  29.     display -monochrome -dither images/aquarium.miff
  30.  
  31.   If the image colors are not correct use this command:
  32.  
  33.     display -visual default images/aquarium.miff
  34.  
  35.   You can find other example images in the 'images' directory.
  36.  
  37.   Be sure to read the manual pages for the display, animate, montage,
  38.   XtoPS, import, mogrify, and convert utilities.
  39.  
  40.   The ImageMagick utilites read and write MIFF images.  Refer to the
  41.   end of this message for more information about MIFF.  Use `convert'
  42.   to convert images to and from the MIFF format.
  43.  
  44.   Some ImageMagick utilities recognizes these `alien' image formats:
  45.  
  46.     GIF
  47.     JPEG
  48.     Postscript
  49.     PPM
  50.     RLE
  51.     SUN Raster
  52.     TIFF
  53.     Utah Raster
  54.     VICAR
  55.     X Bitmap
  56.     X Window Dump
  57.  
  58.   and for your convenience automatically converts the alien image
  59.   format to MIFF at execution time.  However, the MIFF image format has
  60.   several advantages over most image formats (i.e. runlength encoding,
  61.   digital signature on an image colormap, etc.).  ImageMagick is
  62.   designed to exploit these advantages.  Whenever possible convert an
  63.   alien image format to the MIFF format before using the various
  64.   ImageMagick programs.
  65.  
  66.   Other alien formats are also recognized.  See CONVERT(1) for a list
  67.   of valid image formats.  You can specify a particular image format by
  68.   prefixing the image filename with the image type and a colon (i.e.
  69.   mtv:image.mtv).
  70.  
  71.   ImageMagick requires GNU's Ghostscript software available via FTP as
  72.   ftp.uu.net:systems/gnu/ghostscript-2.5.2.tar.Z to read the
  73.   Postscript format.  For ImageMagick to read Postscript files, `gs'
  74.   must be in your execution path and the `ppmraw' device must be
  75.   recognized.  Add it to your 'DEVICE_DEVS' define in your `Makefile'
  76.   and recompile.
  77.  
  78.   ImageMagick requires the Independent JPEG Group's software available via 
  79.   FTP as ftp.uu.net:graphics/jpeg/jpegsrc.v4.tar.Z to read the JPEG image
  80.   format.
  81.  
  82.   ImageMagick requires Sam Leffler's TIFF software available via FTP as 
  83.   sgi.com:graphics/tiff/v3.2beta.tar.Z to read the TIFF image format.
  84.  
  85.   To display images in the JPEG or TIFF format, get the JPEG and TIFF
  86.   archives and build ImageMagick as follows:
  87.  
  88.     cd ImageMagick
  89.     mkdir jpeg
  90.     cd jpeg
  91.     zcat jpegsrc.v4.tar.Z | tar xvf -
  92.     cp jmemnobs.c jmemsys.c
  93.     cp makefile.unix Makefile
  94.     make libjpeg.a
  95.     cd ..
  96.     mkdir tiff
  97.     cd tiff
  98.     zcat v3.2beta.tar.Z | tar xvf -
  99.     cd libtiff
  100.     cp Makefile.sun Makefile
  101.     make
  102.     cd ../..
  103.     < edit Magick.tmpl and uncomment JPEG and TIFF lines as instructed >
  104.     touch alien.c
  105.     xmkmf
  106.     make Makefiles
  107.     make
  108.  
  109.   You can now display images in the JPEG or TIFF format.
  110.  
  111.   If you have a colormapped X server, the number of unique colors in an
  112.   image must first be reduced to match the requirements of your server
  113.   before it can be displayed.  ImageMagick tries to make the color reduced
  114.   image closely resemble the original.  However, this process can be
  115.   time consuming.  To speed it up, ImageMagick trades image quality for
  116.   processing time.  For the "best" image possible, type
  117.  
  118.       display -colors 256 -dither image.jpeg
  119.  
  120.   or add this to your X resources file:
  121.  
  122.       display.colors: 256
  123.  
  124.   This example assumes your server supports 256 colors.  Choose
  125.   whatever value is appropriate for your X server.  Alternatively if
  126.   you intend to view the image frequently, reduce the number of colors
  127.   to match the resolution of your X server once and write to a new
  128.   image.  Then display this new image.  For example,
  129.  
  130.       convert -colors 256 -dither image.jpeg image.miff
  131.       display image.miff
  132.  
  133.  
  134. VMS COMPILATION
  135.  
  136.   Type
  137.  
  138.     @make
  139.     set display/create/node=node_name::
  140.  
  141.   where node_name is the DECNET X server to contact.
  142.  
  143.   Finally type:
  144.  
  145.     display images/aquarium.miff
  146.     display -monochrome -dither images/aquarium.miff
  147.  
  148.  
  149. ANIMATION
  150.  
  151.   An example animation sequence is available from anonymous FTP at
  152.   export.lcs.mit.edu, file contrib/ImageMagick.animation.tar.Z Or
  153.   alternatively, you can create this sequence yourself.  Just look at
  154.   README in the scenes directory.
  155.   
  156.   To prevent color flashing on visuals that have colormaps, `animate'
  157.   creates a single colormap from the image sequence.  This can be
  158.   rather time consuming.  You can speed this operation up by reducing
  159.   the colors in the image before you `animate' them.  Use `mogrify' to
  160.   color reduce the images:
  161.  
  162.     mogrify -colors 256 scenes/dna.[0-9]*
  163.  
  164.   Note, the image sequence in ImageMagick.animation.tar.Z is already
  165.   reduced.  Alternatively, you can use a Standard Colormap; or a
  166.   static, direct, or true color visual.  You can define a Standard
  167.   Colormap with `xstdcmap'.  For example, to use the "best" Standard
  168.   Colormap, type:
  169.  
  170.     xstdcmap -best
  171.     animate -map best scenes/dna.[0-9]*
  172.  
  173.   or to use a true color visual:
  174.  
  175.     animate -visual truecolor scenes/dna.[0-9]*
  176.  
  177.   Image filenames can appear in any order on the command line if the
  178.   scene keyword is specified in the MIFF image.  Otherwise the images
  179.   display in the order they appear on the command line.  A scene is
  180.   specified when converting from another image format to MIFF by using
  181.   the "scene" option with any filter.  Be sure to choose a scene number
  182.   other than zero.  For example, to convert a TIFF image to a MIFF
  183.   image as scene #2, type:
  184.  
  185.     convert -scene 2 image.tiff image.miff
  186.  
  187.  
  188. NOTES
  189.  
  190.   1.  If you get a compile error on XTextProperty in PreRvIcccm.h,
  191.       change it to _XTextProperty. If you get a compile error on
  192.       XVisualIDFromVisual in PreRvIcccm.c, change it to
  193.       _XVisualIDFromVisual.
  194.  
  195.   2.  24 bit images are reduced to 244 colors on an 8 bit display to
  196.       help prevent colormap flashing.  If you want all 256 colors, type
  197.  
  198.         display -colors 256 image.miff
  199.  
  200.       To further help reduce colormap flashing, do not install the
  201.       default standard colormap (RGB_DEFAULT_MAP).
  202.  
  203.   3.  Machine dependancies:
  204.  
  205.       For MacX, set the DISPLAY variable to host:0.2 for the color
  206.       rootless window.
  207.  
  208.       I suspect all the following problems will be fixed when these
  209.       vendors upgrade to X11R4.  I find conditional compilation
  210.       statements offensive.  So if you have any of the following
  211.       problems, the fix must be applied manually.
  212.  
  213.       MIPS does not always generate exposure events correctly when
  214.       displaying a monochrome image on their color server.  Holes in the
  215.       image may appear when an area is blocked then exposed.  I do not
  216.       currently have a solution for this problem.
  217.  
  218.       Images do not dislay correctly on the IBM R6000 visual with 4096
  219.       colors.  However they do display correctly on the visual with 256
  220.       colors.  Until IBM fixes their server, type xdpyinfo to determine 
  221.       the ID of the 256 color visual and type
  222.  
  223.         display -visual 0x???? image.miff
  224.  
  225.       On the Stardent put
  226.  
  227.         *installColormap:  on
  228.  
  229.       in your X resource file.
  230.  
  231.       Digital and Tektronix has a bug in their servers.  When converting
  232.       from LSBFirst to MSBFirst X server (or visa-versa) you may get the 
  233.       error
  234.  
  235.         Illegal unit size: 8 found in routine: _normalizeimagebits
  236.  
  237.   4.  On occasion, a window manager (twm) may get in strange state which will 
  238.       cause the display program to work improperly.  Fix this by restarting the
  239.       window manager.
  240.  
  241.   5.  If the image is displayed with incorrect colors, try using a different
  242.       visual.  Type xdpyinfo and choose an alternative visual (if one exists)
  243.       by either visual class or visual id.  For example, to specifically 
  244.       choose a PseudoColor visual on a server that supports it, type
  245.  
  246.         display -visual pseudocolor image.miff
  247.  
  248.   6.  Make sure that the include file math.h defines the function atof as
  249.       type double.  Otherwise the -gamma option will not work properly.
  250.  
  251.  
  252. MIFF IMAGE FORMAT
  253.  
  254.   MIFF is an image format, which I developed.  I like it because it
  255.  
  256.     1) It is machine independant.  It can be read on virtually any
  257.        computer.  No byte swapping is necessary.
  258.  
  259.     2) It has a text header.  Most image formats are coded in binary
  260.        and you cannot easily tell attributes about the image.  Use
  261.        'more' on MIFF image files and the attributes are displayed in
  262.        text form.
  263.  
  264.     3) It can handle runlength-encoded images.  Although most scanned
  265.        images do not benefit from runlength-encoding, most
  266.        computer-generated images do.  Images of mostly uniform colors
  267.        have a high compression ratio and therefore take up less memory
  268.        and disk space.
  269.  
  270.     4) It allows a scene number to be specified.  This allows you to
  271.        specify an animation sequence out-of-order on the command line.
  272.        The correct order is determined by the scene number of each
  273.        image.
  274.  
  275.     5) MIFF computes a digital signature for colormapped images.  This
  276.        is useful for animating a sequence of images on a colormapped X
  277.        server.  If all signatures match in the image sequence,
  278.        computing a global colormap is not necessary.
  279.  
  280.   One way to get an image into MIFF format is to use `convert'.  or
  281.   read it from an X window using the 'import' program.  Alternatively,
  282.   type the necessary header information in a file with a text editor.
  283.   Next, dump the binary bytes into another file.  Finally, type
  284.  
  285.     cat header binary_image | display -write image.miff -
  286.  
  287.   For example, suppose you have a raw red, green, blue image file on
  288.   disk that is 640 by 480.  The header file would look like this:
  289.  
  290.     id=ImageMagick columns=640 rows=480 :
  291.  
  292.   The image file would have red, green, blue tuples (rgbrgbrgb...).
  293.  
  294.   Refer to the 'display' manual page for more details.
  295.  
  296. ACKNOWLEDGEMENTS
  297.  
  298.   o Dirk Wetzel <wetzel@forwiss.uni-erlangen.de> fixed the select statement 
  299.     in animate.c.
  300.  
  301.   o Eric Haines <erich@eye.com> fixed ReadRLEImage in alien.c.  It previously
  302.     did not check to see if the background color was present in the image.
  303.  
  304.  
  305. COPYRIGHT
  306.  
  307.   Copyright 1992 E. I. du Pont de Nemours & Company
  308.  
  309.   Permission to use, copy, modify, distribute, and sell this software and
  310.   its documentation for any purpose is hereby granted without fee,
  311.   provided that the above copyright notice appear in all copies and that
  312.   both that copyright notice and this permission notice appear in
  313.   supporting documentation, and that the name of E. I. du Pont de Nemours
  314.   & Company not be used in advertising or publicity pertaining to
  315.   distribution of the software without specific, written prior
  316.   permission.  E. I. du Pont de Nemours & Company makes no representations
  317.   about the suitability of this software for any purpose.  It is provided
  318.   "as is" without express or implied warranty.
  319.  
  320.   E. I. du Pont de Nemours & Company disclaims all warranties with regard
  321.   to this software, including all implied warranties of merchantability
  322.   and fitness, in no event shall E. I. du Pont de Nemours & Company be
  323.   liable for any special, indirect or consequential damages or any
  324.   damages whatsoever resulting from loss of use, data or profits, whether
  325.   in an action of contract, negligence or other tortious action, arising
  326.   out of or in connection with the use or performance of this software.
  327.