home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Divers / ImageMagick-4.0.6.tar.gz / ImageMagick-4.0.6.tar / ImageMagick-4.0.6 / README.txt < prev   
Text File  |  1998-05-12  |  27KB  |  761 lines
  1.   "I swear by my life and my love of it that I will never live
  2.    for the sake of another man, nor ask another man to live for
  3.    mine"
  4.  
  5.                     John Galt in "Atlas Shrugged", by Ayn Rand
  6.  
  7.  
  8. AUTHOR
  9.  
  10.   The author is cristy@mystic.es.dupont.com.  This software is NOT
  11.   shareware.  However, I am interested in who might be using it.
  12.   Please consider sending me a picture postcard of the area where you
  13.   live.  Send postcards to
  14.  
  15.     John Cristy
  16.     P.O. Box 40
  17.     Landenberg, PA  19350
  18.     USA
  19.  
  20.   I'm also interested in receiving coins from around the world for
  21.   my collection.  Or visit my mom's craft page at
  22.   http://www.sympatico.org/bunny/.
  23.  
  24.  
  25. AVAILABILITY
  26.  
  27.   ImageMagick is available as
  28.  
  29.     ftp://ftp.wizards.dupont.com/pub/ImageMagick/ImageMagick-4.0.6.tar.gz
  30.  
  31.   ImageMagick client executables are available for some platforms. See
  32.  
  33.     ftp://ftp.wizards.dupont.com/pub/ImageMagick/binaries
  34.     ftp://ftp.wizards.dupont.com/pub/ImageMagick/mac
  35.     ftp://ftp.wizards.dupont.com/pub/ImageMagick/nt
  36.     ftp://ftp.wizards.dupont.com/pub/ImageMagick/vms
  37.     ftp://ftp.wizards.dupont.com/pub/ImageMagick/linux
  38.  
  39.   I want ImageMagick to be of high quality, so if you encounter a
  40.   problem I will investigate.  However, be sure you are using the most
  41.   recent version from ftp://ftp.wizards.dupont.com/pub/ImageMagick
  42.   before submitting any bug reports or suggestions.
  43.  
  44.  
  45. WWW
  46.  
  47.   The official ImageMagick WWW page is
  48.  
  49.     http://www.wizards.dupont.com/cristy/ImageMagick.html
  50.  
  51.   Another useful ImageMagick WWW page is
  52.  
  53.     http://www.vrl.com/Imaging/
  54.  
  55.   To use display as your external image viewer, edit the global
  56.   mail-cap file or your personal mail-cap file .mailrc (located at your
  57.   home directory) and put this entry:
  58.  
  59.     image/*; display %s
  60.  
  61.  
  62. MAILING LIST
  63.  
  64.   There is a mailing list for discussions and bug reports about
  65.   ImageMagick.  To subscribe send the message
  66.  
  67.     subscribe magick
  68.  
  69.   to majordomo@wizards.dupont.com.  You will receive a welcome message
  70.   which tells you how to post messages to the list,
  71.   magick@wizards.dupont.com.
  72.  
  73.  
  74. MEMORY REQUIREMENTS
  75.  
  76.   You should allocate sufficient swap space on your system before
  77.   running ImageMagick; otherwise, you may experience random server or
  78.   application crashes. Anything less than 80 megabytes of swap space is
  79.   likely to cause random crashes.
  80.  
  81.   On many systems, you will find that 80 megabytes is insufficient and
  82.   you will have to allocate more swap space.  You should also have at
  83.   least 32 megabytes of real memory although 64 megabytes or more is
  84.   recommended.
  85.  
  86.  
  87. UNIX COMPILATION
  88.  
  89.   Type:
  90.  
  91.     gunzip ImageMagick-4.0.6.tar.gz
  92.     tar xvf ImageMagick-4.0.6.tar
  93.     cd ImageMagick
  94.  
  95.   If you do not have gunzip(1), it is available as
  96.   prep.ai.mit.edu:pub/gnu/gzip-1.2.4.shar.
  97.  
  98.   You might want to check the values of certain program definitions
  99.   before compiling. Change the definitions of ApplicationDefaults,
  100.   BrowseCommand, EditorCommand, PostscriptColorDevice, PrintCommand,
  101.   RGBColorDatabase, and TemporaryDirectory in magick/magick.h to suit
  102.   your local requirements.
  103.  
  104.   There are currently two mechanisms available to create makefiles to
  105.   build ImageMagick: 1) GNU configure;  2: X11 imake.  Each is described
  106.   in the following paragraphs.
  107.   
  108.   * * *
  109.  
  110.   GNU configure:
  111.   
  112.     This option is easiest to use and is recommended when ImageMagick
  113.     is to be installed outside of the X11 distribution or working imake
  114.     configuration files are not available.  Use of 'configure' enables
  115.     automated configuration, building, and installation of PerlMagick.
  116.  
  117.     If you are willing to accept configure's default options, type:
  118.     
  119.         ./configure
  120.   
  121.     and watch the configure script output to verify that it finds
  122.     everything that you think it should. If it does not, then adjust
  123.     your environment so that it does.
  124.  
  125.     If you are not happy with configure's choice of compiler,
  126.     compilation flags, or libraries, you can give `configure' initial
  127.     values for variables by setting them in the environment.  Using a
  128.     Bourne-compatible shell, you can do that on the command line like
  129.     this:
  130.  
  131.         CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
  132.  
  133.     Or on systems that have the `env' program, you can do it like this:
  134.  
  135.         env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
  136.  
  137.     The configure variables you should be aware of are:
  138.  
  139.         CC          Name of C compiler (e.g. 'cc -Xa') to use
  140.         CFLAGS      Compiler flags (e.g. '-g -O2') to compile with
  141.         CPPFLAGS    Include paths (-I/somedir) to look for header files
  142.         LDFLAGS     Library paths (-L/somedir) to look for libraries
  143.         LIBS        Extra libraries (-lsomelib) required to link
  144.  
  145.     Any variable (e.g. CPPFLAGS or LDFLAGS) which requires a directory
  146.     path must specify an absolute path rather than a relative path.
  147.  
  148.     By default, `make install' will install the package's files in
  149.     `/usr/local/bin', `/usr/local/man', etc.  You can specify an
  150.     installation prefix other than `/usr/local' by giving `configure'
  151.     the option `--prefix=PATH'.
  152.  
  153.     Configure can usually find the X include and library files
  154.     automatically, but if it doesn't, you can use the `configure'
  155.     options `--x-includes=DIR' and `--x-libraries=DIR' to specify their
  156.     locations.
  157.  
  158.     The configure script provides a number of ImageMagick specific
  159.     options.  When disabling an option --disable-something is equivalent
  160.     to specifying --enable-something=no and --without-something is
  161.     equivalent to --with-something=no.  The configure options are as
  162.     follows (execute 'configure --help' to see all options).
  163.  
  164.       --enable-shared      build shared libraries (default is no)
  165.       --enable-static      build static libraries (default is yes)
  166.       --enable-lzw         enable LZW support (default is no)
  167.       --enable-16bit-pixel enable 16 bit pixels (default is no)
  168.       --enable-socks       enable use of SOCKS 5 library and 'rftp'
  169.       --with-perl          enable build/install of PerlMagick (default is no)
  170.       --with-dps           enable Display Postscript (default is yes)
  171.       --with-fpx           enable FlashPIX (default is yes)
  172.       --with-hdf           enable HDF (default is yes)
  173.       --with-jbig          enable JBIG (default is yes)
  174.       --with-jpeg          enable JPEG (default is yes)
  175.       --with-mpeg          enable MPEG (default is yes)
  176.       --with-png           enable PNG (default is yes)
  177.       --with-tiff          enable TIFF (default is yes)
  178.       --with-ttf           enable TrueType (default is yes)
  179.       --with-x             use the X Window System
  180.  
  181.     ImageMagick options represent either features to be enabled or
  182.     packages to be included in the build.  When a feature is enabled
  183.     (via --enable-something), it enables code already present in
  184.     ImageMagick.  When a package is enabled (via --with-something), the
  185.     configure script will search for it, and if is is properly
  186.     installed and ready to use (headers and built libraries are found
  187.     by compiler) it will be included in the build.  The configure script
  188.     is delivered with all features disabled and all packages enabled
  189.     (except for PERL). In general, the only reason to disable a package
  190.     is if a package exists but it is unsuitable for the build (perhaps
  191.     an old version or not compiled with the right compilation flags).
  192.  
  193.     Several configure options require special note:
  194.  
  195.       o --disable-shared: the shared libraries is not built.  Shared
  196.     libraries are valuable because they are *shared* across more
  197.     than one invocation of an ImageMagick or PerlMagick client.  In
  198.     addition, the clients take much less disk space and shared
  199.     libraries are required to use PerlMagick.
  200.  
  201.         ImageMagick built with plug-ins (see MAGICK PLUG-INS below) can
  202.         pose additional challenges.  You can build all the plug-ins
  203.         statically and link them into the ImageMagick shared library
  204.         (i.e. libMagick.so) or alternatively you can build the plug-ins
  205.         as shared libraries (some systems already have plug-ins
  206.         installed as shared libraries).  Shared libraries compilation
  207.         flags differ from vendor to vendor (gcc's is -fPIC).  However,
  208.         you must compile all shared library source with the same flag
  209.         (for gcc use -FPIC rather than -fpic).
  210.  
  211.       o --disable-static: static archive libraries (with extension .a)
  212.     are not built.  If you are building shared libraries, there is
  213.     little value to building static libraries.  Reasons to build
  214.     static libraries include:  1) they can be easier to debug; 2)
  215.     the clients do not have external dependencies (i.e.
  216.     libMagick.so);  3) you are unable to build shared libraries.
  217.  
  218.       o --with-perl: conveniently compile and install PerlMagick in
  219.     one step.  Without this option you first install ImageMagick,
  220.     change to the PerlMagick subdirectory, build, and finally
  221.     install PerlMagick.  Note, PerlMagick is configured even if
  222.     --with-perl is not supplied.  If --enable-shared is not
  223.     specified then a new PERL interpreter (PerlMagick) is built
  224.     which is statically linked against the PerlMagick extension.
  225.     This new interpreter is installed alongside your existing PERL
  226.     interpreter.  If --enable-shared is specified, then the
  227.     PerlMagick extension is built as a dynamically loadable object
  228.     which is loaded into your current PERL interpreter at
  229.     run-time.  Use of dynamically-loaded extensions is preferable
  230.     over statically linked extensions so --enable-shared should be
  231.     specified if possible.  If the argument
  232.     --with-perl=/path/to/perl is supplied, then /path/to/perl will
  233.     be taken as the PERL interpreter to use.
  234.  
  235.       o --with-x=no: build and use the X11 stubs library
  236.         (ImageMagick/xlib) instead of the core X11 libraries.  This may
  237.         be necessary on systems where X11 is not installed (e.g. a web
  238.         server).  Display, animate, and import will not work with this
  239.         library.  The remaining programs have reduced functionality.
  240.  
  241.   * * *
  242.  
  243.   X11 Imake:
  244.  
  245.     Use this option if working imake configuration files are available,
  246.     the package is to be installed where ever imake installs things
  247.     (usually the X11 distribution directory), and you don't mind
  248.     editing a configuration file.  Use of this scheme requires a
  249.     seperate step to install PerlMagick (see the README file in the
  250.     PerlMagick subdirectory).
  251.  
  252.     Edit Magick.tmpl and set the variables to suit your local
  253.     environment.  Now type:
  254.     
  255.         xmkmf
  256.         make Makefiles
  257.         
  258.     or just
  259.       
  260.         xmkmf -a
  261.         
  262.     if you are using X11R6 imake.
  263.  
  264.   * * *
  265.   
  266.   To confirm your build of the ImageMagick distribution was
  267.   successful, type:
  268.  
  269.       display
  270.  
  271.   If the program faults ensure that you have not inadvertingly linked to
  272.   an older version of the libMagick library. To ensure this is not the
  273.   case type
  274.  
  275.       cd ImageMagick/magick
  276.       make install
  277.       cd ..
  278.       make
  279.  
  280.   If the image colors are not correct use this command:
  281.  
  282.       display -visual default
  283.  
  284.   Be sure to read the manual pages for the display(1), animate(1),
  285.   montage(1), import(1), mogrify(1), identify(1), combine(1), and
  286.   convert(1) utilities. Also read the ImageMagick frequently asked
  287.   questions in the file www/Magick.html. This is required reading. Most
  288.   of the questions I get via electronic mail are answered in this
  289.   document.
  290.  
  291.   Place display(1) X application defaults in
  292.   /usr/lib/X11/app-defaults/Display.  Use the appropriate name
  293.   for other clients (e.g. Animate, Montage, etc).  To execute display(1)
  294.   from as a menu item of any window manager (olwm, mwm, twm, etc), use
  295.  
  296.       logo:Untitled
  297.  
  298.  
  299. MAGICK PLUGS-INS
  300.  
  301.   To further enhance the capabilities of ImageMagick, you may
  302.   want to get these programs or libraries:
  303.  
  304.     o ImageMagick requires ralcgm from
  305.  
  306.           http://www.agocg.ac.uk/Graphics/CGM/ralcgm.html
  307.  
  308.       to read the Computer Graphics Metafile image format (may not compile
  309.       under linux).
  310.  
  311.     o ImageMagick requires fig2dev from
  312.  
  313.           ftp://ftp.x.org/contrib/applications/drawing_tools/transfig
  314.  
  315.       to read the TransFig image format.
  316.  
  317.     o ImageMagick requires the FreeType software available as
  318.  
  319.          http://www.physiol.med.tu-muenchen.de/~robert/freetype.html 
  320.  
  321.       to annotate with TrueType fonts.
  322.  
  323.     o ImageMagick requires Ghostscript software available from
  324.  
  325.          http://www.cs.wisc.edu/~ghost/
  326.  
  327.       to read the Postscript or the Portable Document format.  It is used
  328.       to annotate an image when an X server is not available.  See the
  329.       FreeType library above for another means to annotate an image.  Note,
  330.       Ghostscript must support the ppmraw device (type gs -h to verify).
  331.       If Ghostscript is unavailable, the Display Postscript extension is
  332.       used to rasterize a Postscript document (assuming you define HasDPS).
  333.       The DPS extension is less robust than Ghostscript in that it will only
  334.       rasterize one page of a multi-page document.
  335.  
  336.     o ImageMagick requires the FlashPix SDK available from
  337.  
  338.           http://www.kodak.com/US/en/drg/productsTechnologies/
  339.         prodTechFlashPix.shtml
  340.  
  341.       to read and write the FPX image format.
  342.  
  343.     o ImageMagick requires the NCSA HDF library available via anonymous FTP
  344.       as
  345.  
  346.           ftp://ftp.ncsa.uiuc.edu/HDF/HDF4.1r1/tar/HDF4.1r1.tar.gz
  347.  
  348.       to read and write the HDF image format.
  349.  
  350.     o ImageMagick requires the JBIG-Kit software available via anonymous
  351.       FTP as
  352.  
  353.           ftp://ftp.informatik.uni-erlangen.de/pub/doc/ISO/JBIG/
  354.             jbigkit-1.0.tar.gz
  355.  
  356.       to read the JBIG image format.
  357.  
  358.     o ImageMagick requires the Independent JPEG Group's software
  359.       available via anonymous FTP as
  360.  
  361.           ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz
  362.  
  363.       to read the JPEG image format.  ImageMagick creates progressive
  364.       JPEG images by default.  
  365.  
  366.       Concerning iterative JPEG compression:  see Kinoshita and
  367.       Yamamuro, Journal of Imaging Science and Technology, "Image
  368.       Quality with Reiterative JPEG Compression", Volume 39, Number 4,
  369.       July 1995, 306-312 who claim that (1) the iterative factor of the
  370.       repetitive JPEG operation had no influence on image quality, and
  371.       (2) the first compression determined base image quality.
  372.  
  373.     o ImageMagick requires the MPEG library available via
  374.       anonymous FTP as
  375.  
  376.           ftp://ftp.mni.mcgill.ca/pub/mpeg/mpeg_lib-1.2.1.tar.gz 
  377.  
  378.       to read the MPEG image format.  Use
  379.  
  380.           ftp://ftp.arc.umn.edu/pub/GVL/mpeg_encode1.2.2.tar.gz
  381.  
  382.       to write the MPEG image format.
  383.  
  384.     o ImageMagick requires the PNG library from
  385.  
  386.           http://www.cdrom.com/pub/png/pngcode.html
  387.  
  388.       to read the PNG image format.
  389.  
  390.     o ImageMagick requires ra_ppm from Greg Ward's Radiance
  391.       software available via anonymous FTP as
  392.  
  393.           ftp://hobbes.lbl.gov/rad/Radiance3R07.tar.Z
  394.  
  395.       to read the Radiance image format (may not compile under linux).
  396.  
  397.     o ImageMagick requires rawtorle from the Utah Raster Toolkit
  398.       available via anonymous FTP as
  399.  
  400.           ftp://ftp.cs.utah.edu/pub/urt-3.1b.tar.Z
  401.  
  402.       to write the RLE image format (may not compile under linux).
  403.  
  404.     o ImageMagick requires scanimage from
  405.  
  406.           http://www.mostang.com/sane/
  407.  
  408.       to import image from a scanner device.
  409.  
  410.     o ImageMagick requires Sam Leffler's TIFF software available
  411.       via anonymous FTP as
  412.  
  413.           ftp://ftp.sgi.com/graphics/tiff/tiff-v3.4beta037-tar.gz
  414.  
  415.       to read the TIFF image format.  It in turn optionally requires
  416.       the JPEG and ZLIB libraries.
  417.  
  418.     o ImageMagick requires the ZLIB library from
  419.  
  420.           http://www.cdrom.com/pub/infozip/zlib/
  421.  
  422.       to read the PNG image format or read and write Zip compressed
  423.       MIFF images.
  424.  
  425.     o ImageMagick requires GET(1) available via the Web as
  426.  
  427.           http://www.linpro.no/lwp/
  428.  
  429.       to read images specified with a World Wide Web (WWW) uniform
  430.       resource locator (URL).  GET(1) must be in /usr/local/bin.
  431.       See WWWcommand in magick/magick.h to change its location.  If
  432.       you do not have a HTTP server, you can use xtp(1), available
  433.       in the ImageMagick distribution, for URL's whose protocol is
  434.       FTP.
  435.  
  436.     o ImageMagick requires SOCKS version 5 available via the Web at
  437.  
  438.           http://www.socks.nec.com/
  439.  
  440.       in order for 'xtp' to work across a SOCKS5-based firewall. In
  441.       particular, 'xtp' makes use of SOCKS5 'rftp' as an external
  442.       program and supports use of the SOCKS5 library to perform DNS
  443.       lookups via the firewall rather than the internal DNS server.
  444.  
  445.     o ImageMagick requires a background texture for the TILE
  446.       format and for the -texture option of montage(1).  You can
  447.       use your own or get samples from
  448.  
  449.           http://the-tech.mit.edu/KPT/
  450.  
  451.   NOTE: The following procedure describes how to build ImageMagick
  452.   extension libraries in subdirectories of the ImageMagick directory.
  453.   An alternative to these procedures is to install one or more of
  454.   these under your system's regular include/lib directory (e.g. the
  455.   directory specified by --prefix to configure or /usr/local). This
  456.   allows the libraries to be shared by other packages. When using the
  457.   configure script, the two schemes may be mixed. Also, please note
  458.   that when the configure option --enable-shared is not disabled,
  459.   these procedures must be supplemented with whatever compilation
  460.   flags are required on your system to generate PIC code. In the case
  461.   of gcc, this usually means that -fPIC must be added to the compiler
  462.   options (i.e. CFLAGS) when building each plug-in library.
  463.   
  464.   To display images in the HDF, JBIG, JPEG, MPEG, PNG, TIFF, or TTF
  465.   format, get the respective archives and build ImageMagick as follows:
  466.  
  467.     HDF:
  468.       cd ImageMagick
  469.       gunzip -c HDF4.1r1.tar.gz | tar xvf -
  470.       mv HDF4.1r1 hdf
  471.       cd hdf
  472.       configure
  473.       make -k hdf-libnofortran
  474.       cd ..
  475.  
  476.     JBIG:
  477.       cd ImageMagick
  478.       gunzip -c jbigkit-1.0.tar.gz | tar xvof -
  479.       mv jbigkit jbig
  480.       cd jbig
  481.       make
  482.       cd ..
  483.  
  484.     JPEG:
  485.       cd ImageMagick
  486.       gunzip -c jpegsrc.v6b.tar.gz | tar xvof -
  487.       mv jpeg-6b jpeg
  488.       cd jpeg
  489.       configure CC=cc -with-maxmem=7
  490.       make
  491.       cd ..
  492.  
  493.     MPEG:
  494.       cd ImageMagick
  495.       gunzip -c mpeg_lib-1.2.1.tar.gz | tar xvof -
  496.       mv mpeg_lib mpeg
  497.       cd mpeg
  498.       ./configure
  499.       make
  500.       cd ..
  501.  
  502.     PNG:
  503.       cd ImageMagick
  504.       gunzip -c libpng-1.0.1.tgz | tar xvf -
  505.       mv libpng-1.0.1 png
  506.       cd png
  507.       make
  508.       cd ..
  509.  
  510.     TIFF:
  511.       cd ImageMagick
  512.       gunzip -c tiff-v3.4beta037.tar.Z | tar xvof -
  513.       mv tiff-v3.4beta037 tiff
  514.       cd tiff
  515.       ./configure
  516.       make
  517.       cd ..
  518.  
  519.     TTF:
  520.       cd ImageMagick
  521.       gunzip -c freetype-1.0.tar.gz | tar xvof -
  522.       mv freetype-1.0.tar.gz ttf
  523.       cd ttf
  524.       ./configure
  525.       make
  526.       cd ..
  527.  
  528.     ZLIB:
  529.       cd ImageMagick
  530.       gunzip -c zlib-1.1.2.tar.gz | tar xvf -
  531.       mv zlib-1.1.2 zlib
  532.       cd zlib
  533.       make
  534.       cd ..
  535.  
  536.   If your computer system supports shared libraries you must
  537.   type
  538.  
  539.       make install
  540.  
  541.   Finally, perform the following if you are using Imake:
  542.  
  543.       cd ImageMagick
  544.       < edit Magick.tmpl and define Has???? as instructed >
  545.       xmkmf
  546.       make Makefiles
  547.       make clean
  548.       make
  549.  
  550.   If prefer to use 'configure' rather than Imake:
  551.  
  552.       configure
  553.       make clean
  554.       make -k
  555.  
  556.   You can now convert or display images in the JPEG, TIFF, PNG, etc.
  557.   image formats.
  558.  
  559.  
  560. VMS COMPILATION
  561.  
  562.   You might want to check the values of certain program definitions
  563.   before compiling.  Change the definitions of ApplicationDefaults,
  564.   DocumentationBrowser, EditorCommand, PostscriptColorDevice,
  565.   PrintCommand, and RGBColorDatabase in magick/magick.h to suit your
  566.   local requirements.  Next, type.
  567.  
  568.   Type
  569.  
  570.       @make
  571.       set display/create/node=node_name::
  572.  
  573.   where node_name is the DECNET X server to contact.
  574.  
  575.   Finally type:
  576.  
  577.       display
  578.  
  579.   Alternatively, get a zipped distribution (with JPEG, MPEG, TIFF,
  580.   and XPM) from
  581.  
  582.       ftp://ftp.wizards.dupont.com/pub/ImageMagick/vms/ImageMagick-4.0.6.zip
  583.  
  584.   The VMS JPEG, TIFF, and XPM source libraries are available on
  585.   axp.psl.ku.dk in [anonymous.decwindows.lib].
  586.  
  587.   Thanks to pmoreau@cenaath.cena.dgac.fr for supplying
  588.   invaluable help as well as the VMS versions of the JPEG, MPEG, PNG,
  589.   TIFF, and XPM libraries.
  590.  
  591.  
  592. NT COMPILATION
  593.  
  594.   The NT distribution contains MetroWerks Codewarrior Professional
  595.   projects and a Visual C++ workspace (thanks to BillR@corbis.com) for
  596.   compilation.  For those who do not have access to CodeWarrior or
  597.   Visual C++, the binaries for the command line utilities are
  598.   enclosed.
  599.  
  600.   If you have an NT X server like Exceed (from Hummingbird) you will
  601.   also need to include
  602.  
  603.       SET DISPLAY=<local-ip-address>:0.0
  604.  
  605.   in the System Control panel (NT) or Autoexec.bat (Win95). Autoexec.bat
  606.   requires that you restart your computer.  See
  607.   http://www.rahul.net/kenton/xsites.html for a list of commercial and
  608.   free X server software. Without an X server you can still display or
  609.   animate to, or import from, a remote X server.  Convert, mogrify,
  610.   montage, combine, and identify will work with or without an X server
  611.   directly from the command prompt.
  612.  
  613.   Import(1) works if you have at least one X window open.  Alternatively,
  614.   type
  615.  
  616.       convert x:root image.gif
  617.  
  618.   Make sure gswin32 (Ghostscript) is in your execution path (see
  619.   Autoexec.bat), otherwise, you will be unable to convert or view
  620.   Postscript document.
  621.  
  622.   Make sure iexplore (Internet Explorer) is in your execution path (see
  623.   Autoexec.bat), otherwise, you will be unable to browse the ImageMagick
  624.   documentation.
  625.  
  626.   To compile the source with Codewarrior, start with Magick/Magick.mcp and
  627.   then animate.mcp, convert.mcp, etc..  The Visual C++ workspace is
  628.   ImageMagick.dsw.
  629.  
  630.   And yes, the NT executables will work under Windows 95.
  631.  
  632.  
  633. MACINTOSH COMPILATION
  634.  
  635.   The Macintosh distribution contains MetroWerks Codewarrior
  636.   Professional projects for compilation.  For those who do not have
  637.   access to CodeWarrior, the binaries for the command line utilities
  638.   are enclosed.  I had to comment the inline intrinsic functions in
  639.   math.h in order to compile.  If you have a better solution, let me
  640.   know.
  641.  
  642.   Display(1), animate(1), and import(1) currently do not work on the
  643.   Macintosh.
  644.  
  645.   I am looking for a volunteer to get display(1) and animate(1) to work
  646.   on the Macintosh.  I also need a volunteer is needed to write a
  647.   simple Mac program to call the libMagick routines and display an
  648.   image in a window.
  649.  
  650.  
  651. ANIMATION
  652.  
  653.   To prevent color flashing on visuals that have colormaps,
  654.   animate(1) creates a single colormap from the image sequence.
  655.   This can be rather time consuming.  You can speed this
  656.   operation up by reducing the colors in the image before you
  657.   `animate' them.  Use mogrify(1) to color reduce the images:
  658.  
  659.       mogrify +map -colors 256 scenes/dna.[0-9]*
  660.  
  661.   Alternatively, you can use a Standard Colormap; or a static, direct,
  662.   or true color visual.  You can define a Standard Colormap with
  663.   xstdcmap(1).  For example, to use the "best" Standard Colormap,
  664.   type:
  665.  
  666.       xstdcmap -best
  667.       animate -map best scenes/dna.[0-9]*
  668.  
  669.   or to use a true color visual:
  670.  
  671.       animate -visual truecolor scenes/dna.[0-9]*
  672.  
  673.   Image filenames can appear in any order on the command line if
  674.   the scene keyword is specified in the MIFF image.  Otherwise
  675.   the images display in the order they appear on the command
  676.   line.  A scene is specified when converting from another image
  677.   format to MIFF by using the "scene" option with any filter.
  678.   Be sure to choose a scene number other than zero.  For
  679.   example, to convert a TIFF image to a MIFF image as scene #2,
  680.   type:
  681.  
  682.       convert -scene 2 image.tiff image.miff
  683.  
  684.  
  685. 16-BIT IMAGING
  686.  
  687.   By default, ImageMagick uses a color depth of 8 bits (e.g.
  688.   [0..255] for each of red, green, blue, and transparency components).
  689.   Any 16-bit image is scaled to 8-bits before any image viewing or
  690.   processing occurs.  If you want to work directly with 16-bit images
  691.   (e.g. [0..65535]), edit Magick.tmpl and define QuantumLeap or use
  692.   -enable-16bit with configure.  Next, type:
  693.  
  694.       make clean
  695.       make
  696.  
  697.   In 16-bit mode expect to use about 33% more memory on the average.
  698.   Also expect some processing to be slower than in 8-bit mode (e.g.
  699.   Oil Painting, Segment, etc).
  700.  
  701.   In general, 16-bit mode is only useful if you have 16-bit images that
  702.   you want to manipulate and save the transformed image back to a
  703.   16-bit image format (e.g. PNG, VIFF).
  704.  
  705.  
  706. 64-BIT MACHINES
  707.  
  708.   Each pixel, within ImageMagick, is represented by the RunlengthPacket
  709.   structure found in magick/image.h.  Only 8 bits are required for each
  710.   color component and 16 bits for the colormap index for a total of 6
  711.   bytes.  If QuantumLeap is defined (see 16-BIT IMAGING above), the
  712.   color component size increases to 16 bits for a total of 10 bytes.
  713.   Some 64-bit machines pad the structure which can cause a significant
  714.   waste of memory.  For the cray, change the RunlengthPacket structure
  715.   to this
  716.  
  717.       typedef struct _RunlengthPacket
  718.       {
  719.         unsigned char
  720.           red : QuantumDepth,
  721.           green : QuantumDepth,
  722.           blue : QuantumDepth,
  723.           length : QuantumDepth;
  724.  
  725.         unsigned short
  726.           index : 16;
  727.       } RunlengthPacket;
  728.  
  729.   before compiling.
  730.  
  731.   I'm not sure if this will work on other 64-bit machines that pad.  If you
  732.   know a better solution, please send me E-mail.  Note, that the Dec Alpha
  733.   apparently does not pad the structure so ImageMagick should be fine on
  734.   this particular 64-bit machine.
  735.  
  736.  
  737. COPYRIGHT
  738.  
  739.   Permission is hereby granted, free of charge, to any person obtaining a    
  740.   copy of this software and associated documentation files ("ImageMagick"),  
  741.   to deal in ImageMagick without restriction, including without limitation   
  742.   the rights to use, copy, modify, merge, publish, distribute, sublicense,   
  743.   and/or sell copies of ImageMagick, and to permit persons to whom the       
  744.   ImageMagick is furnished to do so, subject to the following conditions:    
  745.                                                                              
  746.   The above copyright notice and this permission notice shall be included in 
  747.   all copies or substantial portions of ImageMagick.                         
  748.                                                                              
  749.   The software is provided "as is", without warranty of any kind, express or 
  750.   implied, including but not limited to the warranties of merchantability,   
  751.   fitness for a particular purpose and noninfringement.  In no event shall   
  752.   E. I. du Pont de Nemours and Company be liable for any claim, damages or   
  753.   other liability, whether in an action of contract, tort or otherwise,      
  754.   arising from, out of or in connection with ImageMagick or the use or other 
  755.   dealings in ImageMagick.                                                   
  756.                                                                              
  757.   Except as contained in this notice, the name of the E. I. du Pont de       
  758.   Nemours and Company shall not be used in advertising or otherwise to       
  759.   promote the sale, use or other dealings in ImageMagick without prior       
  760.   written authorization from the E. I. du Pont de Nemours and Company.       
  761.