home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / unix / immagick / readme.txt < prev    next >
Encoding:
Text File  |  1994-06-01  |  10.9 KB  |  298 lines
  1.   "I swear by my life and my love of it that I will never live for
  2.    the sake of another man, nor ask another man to live for mine."
  3.  
  4.                         John Galt in "Atlas Shrugged", by Ayn Rand
  5.  
  6.  
  7. AUTHOR
  8.  
  9.   The author is cristy@dupont.com.  This software is NOT shareware.
  10.   However, I am interested in who might be using it.  Please consider
  11.   sending me a picture postcard of the area where you live.  Send
  12.   postcards to
  13.  
  14.     John Cristy
  15.     5 Middleton Lane
  16.     Landenberg, PA  19350
  17.     USA
  18.  
  19. AVAILABILITY
  20.  
  21.   Anonymous FTP at ftp.x.org, file contrib/ImageMagick-3.0.tar.gz.  I want
  22.   ImageMagick to be of high quality, so if you encounter a problem I
  23.   will investigate. However, be sure you are using the most recent
  24.   version from ftp.x.org before submitting any bug reports or
  25.   suggestions.
  26.  
  27.  
  28. UNIX COMPILATION
  29.  
  30.   Type:
  31.  
  32.     gunzip ImageMagick-3.0.tar.gz
  33.     tar xvf ImageMagick-3.0.tar
  34.     cd ImageMagick
  35.     xmkmf
  36.     make Makefiles
  37.     make
  38.  
  39.   If you do not have 'gunzip', it is available as
  40.   prep.ai.mit.edu:pub/gnu/gzip-1.2.4.shar.  If you do not have 'xmkmf',
  41.   edit 'Makefile' as required by your hardware environment and type
  42.  
  43.     make
  44.  
  45.   Finally type:
  46.  
  47.     display images/aquarium.miff
  48.     display -monochrome -dither images/aquarium.miff
  49.  
  50.   The aquarium and other images are available from anonymous FTP at
  51.   ftp.x.org, file contrib/ImageMagick.images.tar.gz.
  52.  
  53.   If the image colors are not correct use this command:
  54.  
  55.     display -visual default images/aquarium.miff
  56.  
  57.   You can find other example images in the 'images' directory.
  58.  
  59.   Be sure to read the manual pages for the display, animate, montage,
  60.   import, mogrify, and convert utilities.
  61.  
  62.   The ImageMagick utilities read and write MIFF images.  Refer to the
  63.   end of this message for more information about MIFF.  Use `convert'
  64.   to convert images to and from the MIFF format.
  65.  
  66.   ImageMagick utilities recognizes these image formats:
  67.  
  68.        Tag       Description
  69.        ----------------------------------------------------
  70.        AVS       AVS X image file
  71.        BMP       Microsoft Windows bitmap image file
  72.        CMYK      Raw cyan, magenta, yellow, and black bytes
  73.        EPS       Adobe Encapsulated Postscript
  74.        FAX       Group 3
  75.        FITS      Flexible Image Transport System
  76.        GIF       Compuserve Graphics image file
  77.        GRAY      Raw gray bytes
  78.        JPEG
  79.        MAP       colormap intensities and indices
  80.        MATTE     Raw matte bytes
  81.        MIFF      Magick image file format
  82.        MTV
  83.        PCX       ZSoft IBM PC Paintbrush file
  84.        PICT      Apple Macintosh QuickDraw/PICT file
  85.        PNM       Portable bitmap
  86.        PS        Adobe PostScript file
  87.        PS2       Adobe PostScript Level II file
  88.        RGB       Raw red, green, and blue bytes
  89.        RLE       Utah Raster Toolkit
  90.        SUN       SUN raster
  91.        TGA       Truevision Targa image file
  92.        TEXT      raw text file;  read only
  93.        TIFF      Tagged Image File Format
  94.        VICAR
  95.        VIFF      Khoros Visualization image file.
  96.        X         select image from X server screen
  97.        XC        constant image of X server background color
  98.        XBM       X11 bitmap
  99.        XPM       X11 pixmap
  100.        XWD       X11 window dump
  101.        YUV       CCIR 601 1:1:1 file.
  102.        YUV3      CCIR 601 2:1:1 files.
  103.  
  104.   and for your convenience automatically converts most of these alien image
  105.   format to MIFF at execution time.  However, the MIFF image format has
  106.   several advantages over most image formats (i.e. runlength encoding,
  107.   digital signature on an image colormap, etc.).  ImageMagick is
  108.   designed to exploit these advantages.  Whenever possible convert an
  109.   alien image format to the MIFF format before using the various
  110.   ImageMagick programs.
  111.  
  112.   Other formats may also be recognized.  See CONVERT(1) for a list of
  113.   valid image formats.  You can specify a particular image format by
  114.   prefixing the image filename with the image type and a colon (i.e.
  115.   ps:image.ps).
  116.  
  117.   ImageMagick requires GNU's Ghostscript software available via FTP as
  118.   ftp.uu.net:systems/gnu/ghostscript-2.6.1.tar.gz to read the
  119.   Postscript format.  For ImageMagick to read Postscript files, `gs'
  120.   must be in your execution path and the `pbmraw' and `ppmraw' devices
  121.   must be recognized (try gs -h to verify).  If they are not defined, add
  122.   them to your 'DEVICE_DEVS' define in your Ghostscript `Makefile' and
  123.   recompile (i.e. DEVICE_DEVS=x11.dev pbmraw.dev ppmraw.dev).
  124.  
  125.   ImageMagick requires picttoppm from contrib/netpbm-7dec1993.tar.gz on
  126.   ftp.x.org to read Macintosh PICT images.
  127.  
  128.   ImageMagick requires hpcdtoppm from contrib/netpbm-7dec1993.tar.gz on
  129.   ftp.x.org to read Photo CD images.
  130.  
  131.   ImageMagick requires the Independent JPEG Group's software available via
  132.   FTP as ftp.uu.net:graphics/jpeg/jpegsrc.v4.tar.Z to read the JPEG image
  133.   format.
  134.  
  135.   ImageMagick requires Sam Leffler's TIFF software available via FTP as
  136.   sgi.com:graphics/tiff/v3.2beta.tar.Z to read the TIFF image format. If
  137.   you have an ANSI compiler, try sgi.com:graphics/tiff/v3.3beta002.src.tar.Z.
  138.  
  139.   ImageMagick requires Arnaud Le Hors XPM software available via FTP as
  140.   ftp.x.org:contrib/xpm-3.4a.tar.gz to read the XPM image format.
  141.  
  142.   To display images in the JPEG, TIFF, or XPM format, get the JPEG, TIFF,
  143.   or XPM archives and build ImageMagick as follows:
  144.  
  145.     cd ImageMagick
  146.     mkdir jpeg
  147.     cd jpeg
  148.     zcat jpegsrc.v4.tar.Z | tar xvof -
  149.     cp jmemnobs.c jmemsys.c
  150.     cp makefile.unix Makefile
  151.     make libjpeg.a
  152.     cd ..
  153.     mkdir tiff
  154.     cd tiff
  155.     zcat v3.2beta.tar.Z | tar xvof -
  156.     cd libtiff
  157.     cp Makefile.sun Makefile
  158.     make
  159.     cd ../..
  160.     mkdir xpm
  161.     < copy xpm-3.4a/lib/* to xpm >
  162.     cd xpm
  163.     xmkmf
  164.     make
  165.     cd ..
  166.     < edit Magick.tmpl and define HasJPEG, HasTIFF, or HasXPM as instructed >
  167.     xmkmf
  168.     make Makefiles
  169.     make clean
  170.     make
  171.  
  172.   You can now display images in the JPEG, TIFF, or XPM format.
  173.  
  174.  
  175. VMS COMPILATION
  176.  
  177.   Type
  178.  
  179.     @make
  180.     set display/create/node=node_name::
  181.  
  182.   where node_name is the DECNET X server to contact.
  183.  
  184.   Finally type:
  185.  
  186.     display [.images]aquarium.miff
  187.     display -monochrome -dither [.images]aquarium.miff
  188.  
  189.  
  190. ANIMATION
  191.  
  192.   An example animation sequence is available from anonymous FTP at
  193.   ftp.x.org, file contrib/ImageMagick.animation.tar.gz.  Or
  194.   alternatively, you can create this sequence yourself.  Just look at
  195.   README in the scenes directory.
  196.  
  197.   To prevent color flashing on visuals that have colormaps, `animate'
  198.   creates a single colormap from the image sequence.  This can be
  199.   rather time consuming.  You can speed this operation up by reducing
  200.   the colors in the image before you `animate' them.  Use `mogrify' to
  201.   color reduce the images:
  202.  
  203.     mogrify -colors 256 scenes/dna.[0-9]*
  204.  
  205.   Note, the image sequence in ImageMagick.animation.tar.gz is already
  206.   reduced.  Alternatively, you can use a Standard Colormap; or a
  207.   static, direct, or true color visual.  You can define a Standard
  208.   Colormap with `xstdcmap'.  For example, to use the "best" Standard
  209.   Colormap, type:
  210.  
  211.     xstdcmap -best
  212.     animate -map best scenes/dna.[0-9]*
  213.  
  214.   or to use a true color visual:
  215.  
  216.     animate -visual truecolor scenes/dna.[0-9]*
  217.  
  218.   Image filenames can appear in any order on the command line if the
  219.   scene keyword is specified in the MIFF image.  Otherwise the images
  220.   display in the order they appear on the command line.  A scene is
  221.   specified when converting from another image format to MIFF by using
  222.   the "scene" option with any filter.  Be sure to choose a scene number
  223.   other than zero.  For example, to convert a TIFF image to a MIFF
  224.   image as scene #2, type:
  225.  
  226.     convert -scene 2 image.tiff image.miff
  227.  
  228.  
  229. MIFF IMAGE FORMAT
  230.  
  231.   MIFF is an image format which I developed.  I like it because it
  232.  
  233.     1) It is machine independent.  It can be read on virtually any
  234.        computer.  No byte swapping is necessary.
  235.  
  236.     2) It has a text header.  Most image formats are coded in binary
  237.        and you cannot easily tell attributes about the image.  Use
  238.        'more' on MIFF image files and the attributes are displayed in
  239.        text form.
  240.  
  241.     3) It can handle runlength-encoded images.  Although most scanned
  242.        images do not benefit from runlength-encoding, most
  243.        computer-generated images do.  Images of mostly uniform colors
  244.        have a high compression ratio and therefore take up less memory
  245.        and disk space.
  246.  
  247.     4) It allows a scene number to be specified.  This allows you to
  248.        specify an animation sequence out-of-order on the command line.
  249.        The correct order is determined by the scene number of each
  250.        image.
  251.  
  252.     5) MIFF computes a digital signature for colormapped images.  This
  253.        is useful for animating a sequence of images on a colormapped X
  254.        server.  If all signatures match in the image sequence,
  255.        computing a global colormap is not necessary.
  256.  
  257.     6) There is a `montage' keyword allowing an image to act as a visual
  258.        image directory.  See display(1) for more details.
  259.  
  260.   One way to get an image into MIFF format is to use `convert'.  or
  261.   read it from an X window using the 'import' program.  Alternatively,
  262.   type the necessary header information in a file with a text editor.
  263.   Next, dump the binary bytes into another file.  Finally, type
  264.  
  265.     cat header binary_image | display -write image.miff -
  266.  
  267.   For example, suppose you have a raw red, green, blue image file on
  268.   disk that is 640 by 480.  The header file would look like this:
  269.  
  270.     id=ImageMagick columns=640 rows=480 :
  271.  
  272.   The image file would have red, green, blue tuples (rgbrgbrgb...).
  273.  
  274.   Refer to the 'display' manual page for more details.
  275.  
  276. COPYRIGHT
  277.  
  278.   Copyright 1994 E. I. du Pont de Nemours & Company
  279.  
  280.   Permission to use, copy, modify, distribute, and sell this software and
  281.   its documentation for any purpose is hereby granted without fee,
  282.   provided that the above copyright notice appear in all copies and that
  283.   both that copyright notice and this permission notice appear in
  284.   supporting documentation, and that the name of E. I. du Pont de Nemours
  285.   & Company not be used in advertising or publicity pertaining to
  286.   distribution of the software without specific, written prior
  287.   permission.  E. I. du Pont de Nemours & Company makes no representations
  288.   about the suitability of this software for any purpose.  It is provided
  289.   "as is" without express or implied warranty.
  290.  
  291.   E. I. du Pont de Nemours & Company disclaims all warranties with regard
  292.   to this software, including all implied warranties of merchantability
  293.   and fitness, in no event shall E. I. du Pont de Nemours & Company be
  294.   liable for any special, indirect or consequential damages or any
  295.   damages whatsoever resulting from loss of use, data or profits, whether
  296.   in an action of contract, negligence or other tortious action, arising
  297.   out of or in connection with the use or performance of this software.
  298.