QuickStart.txt 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136
  1. This file documents how to use the binary distribution packages built by
  2. ImageMagick Studio LLC, and found in the ImageMagick 'binaries' subdirectory
  3. of ImageMagick download sites. Those who want to build ImageMagick from source
  4. code should refer to https://imagemagick.org/script/install-source.php.
  5. Unix/Linux/Darwin/Mac OS X/Cygwin/MinGW Install:
  6. Download the appropriate binary from
  7. https://download.imagemagick.org/ImageMagick/download/binaries
  8. Create (or choose) a directory to install the package into and change to that
  9. directory, for example:
  10. cd $HOME
  11. Extract the contents of the package using the command
  12. gzip -dc /path/to/package.tar.gz | tar -xf -
  13. If the 'bin' subdirectory of the extracted package is not already in your
  14. executable search path, add it to your PATH environment variable. For
  15. example
  16. export PATH; PATH="$HOME/ImageMagick/bin:$PATH"
  17. Set the MAGICK_HOME environment variable to the path where you extracted the
  18. ImageMagick files. For example
  19. export MAGICK_HOME="$HOME/ImageMagick-7.0.11"
  20. On Linux and Solaris machines set the LD_LIBRARY_PATH environment variable:
  21. export LD_LIBRARY_PATH="$HOME/ImageMagick-7.0.11/lib"
  22. On Mac OS X (Darwin) machines set the DYLD_LIBRARY_PATH environment variable:
  23. export DYLD_LIBRARY_PATH="$HOME/ImageMagick-7.0.11/lib"
  24. Now, test ImageMagick to see if it is working
  25. convert logo: logo.gif
  26. display logo.gif
  27. To install PerlMagick type
  28. cd ImageMagick-7.0.11/PerlMagick
  29. perl Makefile.PL
  30. make
  31. make install
  32. Additional Information
  33. Environment Variables:
  34. In addition to the MAGICK_HOME environment variable defined above, you may
  35. find these variables useful:
  36. MAGICK_TMPDIR path to store temporary files
  37. LD_LIBRARY_PATH path to libMagick.so and other libraries
  38. Configuration Files
  39. ImageMagick depends on a number of external configuration files which
  40. include colors.xml, delegates.xml, and others.
  41. ImageMagick searches for configuration files in the following order, and
  42. loads them if found:
  43. $MAGICK_CONFIGURE_PATH
  44. $MAGICK_HOME/etc/ImageMagick
  45. $MAGICK_HOME/share/ImageMagick-7.0.11/config
  46. $HOME/.config/ImageMagick/
  47. <client path>/etc/ImageMagick/
  48. <current directory>/
  49. Font Files
  50. ImageMagick is able to load raw TrueType and Postscript font files. It
  51. searches for the font configuration file, type.xml, in the following
  52. order, and loads them if found:
  53. $MAGICK_CONFIGURE_PATH
  54. $MAGICK_HOME/etc/ImageMagick
  55. $MAGICK_HOME/share/ImageMagick-7.0.11/config
  56. $HOME/.config/ImageMagick/
  57. <client path>/etc/ImageMagick/
  58. <current directory>/
  59. $MAGICK_FONT_PATH
  60. Module Files
  61. ImageMagick's file format support is usually provided in the form of
  62. loadable modules. It searches for loadable modules in the following order
  63. and it uses the first match found:
  64. <current directory>/
  65. $MAGICK_HOME/etc/ImageMagick/modules-Q16/coders/
  66. $HOME/.config/ImageMagick/
  67. <client path>/../etc/ImageMagick/modules-Q16/coders/
  68. $MAGICK_HOME/etc/ImageMagick/modules-Q16/coders
  69. $MAGICK_HOME/share/ImageMagick-7.0.11/modules-Q16/coders
  70. $HOME/.config/ImageMagick/
  71. <client path>/etc/ImageMagick/modules-Q16/coders
  72. <current directory>/
  73. Windows Vista, XP, and NT Install:
  74. Download one of
  75. https://download.imagemagick.org/download/ImageMagick/binaries/ImageMagick-7.0.11-15-Q16-windows-dll.exe
  76. https://download.imagemagick.org/download/ImageMagick/binaries/ImageMagick-7.0.11-15-Q16-windows-static.exe
  77. https://download.imagemagick.org/download/ImageMagick/binaries/ImageMagick-7.0.11-15-Q8-windows-dll.exe
  78. https://download.imagemagick.org/download/ImageMagick/binaries/ImageMagick-7.0.11-15-Q8-windows-static.exe
  79. and execute it (or "open" it from your browser) to start the installation
  80. program.
  81. Once ImageMagick is installed, Select Start->Programs->Command Prompt. In
  82. the Command Prompt window type
  83. convert logo: logo.gif
  84. imdisplay logo.gif
  85. If you have an X11 server, from the Command Prompt window type
  86. set DISPLAY=:0
  87. display
  88. VMS Install:
  89. Type
  90. unzip ImageMagick.zip
  91. set default [.imagemagick]
  92. @make
  93. identify -verbose logo: