ImageMagick

https://imagemagick.org
Admin
ImageMagick® is a free, open-source software suite used for editing and manipulating digital images,...
Tokens:158,784
Snippets:2,011
Trust Score:9.7
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install ImageMagick

Source: https://imagemagick.org/advanced-linux-installation

Installs the compiled binaries and libraries to the system.

```bash
make install
```

--------------------------------

### Build and Install ImageMagick

Source: https://imagemagick.org/advanced-linux-installation

Compile the source code and install the binaries to the system.

```bash
make
```

```bash
sudo make install
```

--------------------------------

### Verify Installation with Logo Test

Source: https://imagemagick.org/install-source

Run a basic test to ensure the installation is functioning correctly.

```bash
/usr/local/bin/magick logo: logo.gif
```

--------------------------------

### Install Individual macOS Delegate

Source: https://imagemagick.org/advanced-linux-installation

Install specific optional delegate libraries as needed.

```bash
sudo port install jpeg
```

--------------------------------

### Basic Magick++ image processing example

Source: https://imagemagick.org/magick%2B%2B

A complete example demonstrating reading, cropping, and writing an image using the Magick++ API.

```cpp
#include <Magick++.h>
#include <iostream>

using namespace std;
using namespace Magick;

int main(int argc,char **argv)
{
  MagickPlusPlusGenesis genesis(*argv);

  // Construct the image object. Separating image construction from the
  // the read operation ensures that a failure to read the image file
  // doesn't render the image object useless.
  Image image;
  try {
    // Read a file into image object
    image.read( "logo:" );

    // Crop the image to specified size (width, height, xOffset, yOffset)
    image.crop( Geometry(100,100, 100, 100) );

    // Write the image to a file
    image.write( "logo.png" );
  }
  catch( Exception &error_ )
    {
      cout << "Caught exception: " << error_.what() << endl;
      return 1;
    }
  return 0;
}
```

--------------------------------

### Install macOS Delegate Libraries

Source: https://imagemagick.org/advanced-linux-installation

Install required delegate libraries using MacPorts before building ImageMagick.

```bash
sudo port -v install freetype +bytecode
sudo port -v install librsvg
sudo port -v install graphviz +gs +wmf +jbig +jpeg2 +lcms
```

--------------------------------

### Install PerlMagick on Windows

Source: https://imagemagick.org/perl-magick

Build and install PerlMagick using nmake on Windows systems.

```bash
cd PerlMagick
perl Makefile.nt
nmake
nmake install
```

--------------------------------

### Apply Global Definitions

Source: https://imagemagick.org/defines

Examples of using -define to control coders and -set to configure image properties.

```bash
magick bilevel.tif -define ps:imagemask eps3:stencil.ps
magick arrow.tga -set colorspace:auto-grayscale=off myArrow.tga
```

--------------------------------

### Verify ImageMagick Installation

Source: https://imagemagick.org/advanced-linux-installation

Check the installation by listing available fonts or testing the GUI.

```bash
/opt/local/bin/identify -list font
```

```bash
display -display :0
```

--------------------------------

### View Configuration Report

Source: https://imagemagick.org/advanced-linux-installation

Example output from the configure script showing detected system capabilities and delegate library status.

```text
ImageMagick is configured as follows. Please verify that this configuration
matches your expectations.

Host system type: x86_64-unknown-linux-gnu
Build system type: x86_64-unknown-linux-gnu

                  Option                     Value
-------------------------------------------------------------------------------
Shared libraries  --enable-shared=yes		yes
Static libraries  --enable-static=yes		yes
Module support    --with-modules=yes		yes
GNU ld            --with-gnu-ld=yes		yes
Quantum depth     --with-quantum-depth=16	16
High Dynamic Range Imagery
                  --enable-hdri=no		no

Delegate Configuration:
BZLIB             --with-bzlib=yes		yes
Autotrace         --with-autotrace=yes	yes
DJVU              --with-djvu=yes		no
DPS               --with-dps=yes		no
FlashPIX          --with-fpx=yes		no
FontConfig        --with-fontconfig=yes	yes
FreeType          --with-freetype=yes		yes
GhostPCL          None			pcl6 (unknown)
GhostXPS          None			gxps (unknown)
Ghostscript       None			gs (8.63)
result_ghostscript_font_dir='none'
Ghostscript fonts --with-gs-font-dir=default
Ghostscript lib   --with-gslib=yes		no (failed tests)
Graphviz          --with-gvc=yes		yes
JBIG              --with-jbig=		no
JPEG v1           --with-jpeg=yes		yes
JPEG-2000         --with-jp2=yes		yes
LCMS              --with-lcms=yes		yes
LQR               --with-lqr=yes		no
Magick++          --with-magick-plus-plus=yes	yes
OpenEXR           --with-openexr=yes		yes
PERL              --with-perl=yes		/usr/bin/perl
PNG               --with-png=yes		yes
RSVG              --with-rsvg=yes		yes
TIFF              --with-tiff=yes		yes
result_windows_font_dir='none'
Windows fonts     --with-windows-font-dir=
WMF               --with-wmf=yes		yes
X11               --with-x=			yes
XML               --with-xml=yes		yes
ZLIB              --with-zlib=yes		yes

X11 Configuration:
      X_CFLAGS        =
      X_PRE_LIBS      = -lSM -lICE
      X_LIBS          =
      X_EXTRA_LIBS    = -lXext -lSM -lICE -lX11 -lXt

Options used to compile and link:
  PREFIX          = /usr/local
  EXEC-PREFIX     = /usr/local
  VERSION         = 6.4.8
  CC              = gcc -std=gnu99
  CFLAGS          = -fopenmp -g -O2 -Wall -W -pthread
  MAGICK_CFLAGS   = -fopenmp -g -O2 -Wall -W -pthread
  CPPFLAGS        = -I/usr/local/include/ImageMagick
  PCFLAGS         = -fopenmp
  DEFS            = -DHAVE_CONFIG_H
  LDFLAGS         = -lfreetype
  MAGICK_LDFLAGS  = -L/usr/local/lib -lfreetype
  LIBS            = -lMagickCore-Q16 -llcms -ltiff -lfreetype -ljpeg -lfontconfig -lXext
                    -lSM -lICE -lX11 -lXt -lbz2 -lz -lm -lgomp -lpthread -lltdl
  CXX             = g++
  CXXFLAGS        = -g -O2 -Wall -W -pthread
```

--------------------------------

### Install JPEG Delegate Libraries

Source: https://imagemagick.org/advanced-linux-installation

Install the necessary JPEG development packages via yum to enable JPEG support.

```bash
yum install libjpeg libjpeg-devel
```

--------------------------------

### Set configure variables via command line

Source: https://imagemagick.org/advanced-linux-installation

Example of passing compiler and linker flags directly to the configure script.

```bash
configure CC=c99 CFLAGS=-O2 LDFLAGS='-L/usr/local/lib -R/usr/local/lib' LIBS=-lposix
```

--------------------------------

### Install ImageMagick Binary RPM

Source: https://imagemagick.org/advanced-linux-installation

Install the generated binary RPM package after the build process completes.

```bash
rpm -ivh ImageMagick-7.1.2.-?.*.rpm
```

--------------------------------

### Set Image Resolution and Density

Source: https://imagemagick.org/magick%2B%2B/Image%2B%2B.html

Example demonstrating how to configure the resolution units and density for an image before writing it to a file.

```cpp
image.resolutionUnits(PixelsPerInchResolution);
image.density(Geometry(150,150));   // could also use image.density("150x150")
image.write(filename)
```

--------------------------------

### Sinusoid Example

Source: https://imagemagick.org/command-line-options

An example usage of the Sinusoid function to generate an oscillating curve.

```bash
-function Sinusoid 3,-90,.2,.7
```

--------------------------------

### Create a Thumbnail with MagickWand

Source: https://imagemagick.org/magick-wand

A complete example program that reads an image, resizes it to a thumbnail, and writes the result to disk.

```c
#include <stdio.h>
#include <stdlib.h>
#include <MagickWand/MagickWand.h>

int main(int argc,char **argv)
{
#define ThrowWandException(wand) \
{ \
  char \
    *description; \
 \
  ExceptionType \
    severity; \
 \
  description=MagickGetException(wand,&severity); \
  (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
  description=(char *) MagickRelinquishMemory(description); \
  exit(-1); \
}

  MagickBooleanType
    status;

  MagickWand
    *magick_wand;

  if (argc != 3)
    {
      (void) fprintf(stdout,"Usage: %s image thumbnail\n",argv[0]);
      exit(0);
    }
  /*
    Read an image.
  */
  MagickWandGenesis();
  magick_wand=NewMagickWand();
  status=MagickReadImage(magick_wand,argv[1]);
  if (status == MagickFalse)
    ThrowWandException(magick_wand);
  /*
    Turn the images into a thumbnail sequence.
  */
  MagickResetIterator(magick_wand);
  while (MagickNextImage(magick_wand) != MagickFalse)
    MagickResizeImage(magick_wand,106,80,LanczosFilter,1.0);
  /*
    Write the image then destroy it.
  */
  status=MagickWriteImages(magick_wand,argv[2],MagickTrue);
  if (status == MagickFalse)
    ThrowWandException(magick_wand);
  magick_wand=DestroyMagickWand(magick_wand);
  MagickWandTerminus();
  return(0);
}
```

--------------------------------

### Install Full ImageMagick Build

Source: https://imagemagick.org/download

Installs a version of ImageMagick with additional delegates and codecs. Note that this package is keg-only and not automatically linked to the system PATH.

```bash
brew install imagemagick-full
```

--------------------------------

### Install ImageMagick via Package Managers

Source: https://imagemagick.org/download

Commands for installing ImageMagick using scoop or chocolatey.

```shell
scoop install main/imagemagick
```

```shell
choco install imagemagick
```

--------------------------------

### Verify ImageMagick Installation

Source: https://imagemagick.org/download

Run these commands in a Command Prompt to confirm that ImageMagick is correctly installed and functional.

```shell
magick logo: logo.gif
magick identify logo.gif
```

--------------------------------

### Create Linear Gradients

Source: https://imagemagick.org/gradient

Examples of generating linear gradients with default or specified colors.

```bash
magick -size 256x256 gradient: linear_gradient.png
magick -size 256x256 gradient:white-black linear_gradient.png
```

--------------------------------

### Configure Dynamic Linker

Source: https://imagemagick.org/install-source

Update the dynamic linker run-time bindings after installation.

```bash
sudo ldconfig /usr/local/lib
```

--------------------------------

### Create Radial Gradients

Source: https://imagemagick.org/gradient

Examples of generating radial gradients with default or specified colors.

```bash
magick -size 256x256 radial-gradient: radial_gradient.png
magick -size 256x256 radial-gradient:white-black radial_gradient.png
```

--------------------------------

### Configure ImageMagick Build

Source: https://imagemagick.org/advanced-linux-installation

Run the configure script with specific flags to set installation paths and features.

```bash
./configure --prefix=/opt --with-quantum-depth=16 \
  --disable-dependency-tracking --with-x=yes \
  --x-includes=/usr/X11R6/include --x-libraries=/usr/X11R6/lib/ \
  --without-perl"
```

--------------------------------

### Run Regression Tests

Source: https://imagemagick.org/perl-magick

Execute tests to verify the installation.

```bash
make test
```

--------------------------------

### Create a checkerboard using MPR

Source: https://imagemagick.org/formats

Example demonstrating the use of the Magick Persistent Registry (MPR) to generate a checkerboard pattern in memory.

```bash
convert -size 64x64 xc:white -size 32x32 xc:black +append \( +clone -flop \) -append \( +clone -flop \) -append mpr:checkerboard
convert -size 256x256 tile:mpr:checkerboard show:
```

--------------------------------

### Start and Utilize a Single Distributed Pixel Cache

Source: https://imagemagick.org/distribute-pixel-cache

Start the cache server on localhost and reference it in an ImageMagick command using the registry:cache:hosts definition.

```bash
$ magick -distribute-cache 6668 &  # start on localhost
$ magick -limit memory 1GiB -limit map 2GiB -limit disk 4GiB \
  -define registry:cache:hosts=localhost:6668 \
  myhugeimage.jpg -sharpen 5x2 myhugeimage.png
```

--------------------------------

### Install ImageMagick via winget

Source: https://imagemagick.org/download

Use these commands to install specific ImageMagick versions or the general package via the Windows Package Manager.

```shell
winget install ImageMagick.Q16-HDRI
```

```shell
winget install ImageMagick.Q16
```

```shell
winget install ImageMagick.Q8
```

```shell
winget install ImageMagick.ImageMagick
```

--------------------------------

### Set TIFF resolution attributes

Source: https://imagemagick.org/magick%2B%2B/Image%2B%2B.html

Example demonstrating how to read an image and set its resolution attributes.

```cpp
string filename("file.tiff");
Image image;
image.read(filename);
```

--------------------------------

### Set Registry Path

Source: https://imagemagick.org/defines

Example of setting a temporary path for work files using the registry prefix.

```bash
-define registry:temporary-path=/data/tmp
```

--------------------------------

### Color Decision List XML Example

Source: https://imagemagick.org/command-line-options

An example of a ColorCorrectionCollection XML file used with the -cdl option.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
  <ColorCorrection id="cc06668">
    <SOPNode>
      <Slope> 0.9 1.2 0.5 </Slope>
      <Offset> 0.4 -0.5 0.6 </Offset>
      <Power> 1.0 0.8 1.5 </Power>
    </SOPNode>
    <SATNode>
      <Saturation> 0.85 </Saturation>
    </SATNode>
  </ColorCorrection>
</ColorCorrectionCollection>
```

--------------------------------

### Sequential Filename Generation

Source: https://imagemagick.org/command-line-processing

Example of expected output files when using sequential formatting characters.

```text
image-0.jpg
image-1.jpg
image-2.jpg
```

--------------------------------

### Define drawing instructions in a file

Source: https://imagemagick.org/perl-magick

Example content for a text file used to supply drawing primitives to the Draw method.

```text
rectangle 20, 20 100, 100
rectangle 40, 40 200, 200
rectangle 60, 60 300, 300
```

--------------------------------

### Negating Image Channels

Source: https://imagemagick.org/porting

Example showing the transition from using channel-specific methods to using channel masks with standard methods.

```C
NegateImageChannel(image,channel);
```

```C
channel_mask=SetImageChannelMask(image,channel);
NegateImage(image,exception);
(void) SetImageChannelMask(image,channel_mask);
```

--------------------------------

### Create Grayscale Images from Channels

Source: https://imagemagick.org/porting

Example of using -channel-fx to split an image into three separate grayscale images based on RGB channels.

```bash
-channel-fx "red; green; blue"
```

--------------------------------

### Run Demonstration Scripts

Source: https://imagemagick.org/perl-magick

Build and run the provided demonstration scripts.

```bash
cd demo
make
```

--------------------------------

### Configure a Jinc-windowed Sinc filter

Source: https://imagemagick.org/command-line-options

Example command to apply an 8-lobe Jinc-windowed Sinc filter to an image.

```bash
$ magick image.png \
  -filter sinc \
```

--------------------------------

### Verify ImageMagick Installation

Source: https://imagemagick.org/install-source

Check if ImageMagick is already installed and identify the version.

```bash
magick identify -version
```

--------------------------------

### View configure help options

Source: https://imagemagick.org/advanced-linux-installation

Command to list all available configuration options for the build script.

```bash
configure --help
```

--------------------------------

### Thresholding with sRGB Colors

Source: https://imagemagick.org/color-thresholding

Examples of applying color thresholding using sRGB color ranges.

```bash
$ magick monet.jpg -color-threshold 'sRGB(163,112,0)-sRGB(203,152,40)' monet.gif
```

```bash
$magick monet.jpg -color-threshold 'sRGB(159,150,0)-sRGB(205,100,45)' monet.gif
```

--------------------------------

### Initialize Distributed Pixel Cache

Source: https://imagemagick.org/architecture

Start a remote cache server and configure ImageMagick to utilize it for image processing.

```bash
$ magick -distribute-cache 6668 &  // start on 192.168.100.50
$ magick -define registry:cache:hosts=192.168.100.50:6668 myimage.jpg -sharpen 5x2 mimage.png
```

--------------------------------

### MagickCore Thumbnail Generation Example

Source: https://imagemagick.org/magick-core

A complete C program demonstrating how to initialize the MagickCore environment, read an image, resize it to a thumbnail, and write the result to disk.

```c
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include <MagickCore/MagickCore.h>

int main(int argc,char **argv)
{
  ExceptionInfo
    *exception;

  Image
    *image,
    *images,
    *resize_image,
    *thumbnails;

  ImageInfo
    *image_info;

  if (argc != 3)
    {
      (void) fprintf(stdout,"Usage: %s image thumbnail\n",argv[0]);
      exit(0);
    }
  /*
    Initialize the image info structure and read an image.
  */
  MagickCoreGenesis(*argv,MagickTrue);
  exception=AcquireExceptionInfo();
  image_info=CloneImageInfo((ImageInfo *) NULL);
  (void) strcpy(image_info->filename,argv[1]);
  images=ReadImage(image_info,exception);
  if (exception->severity != UndefinedException)
    CatchException(exception);
  if (images == (Image *) NULL)
    exit(1);
  /*
    Convert the image to a thumbnail.
  */
  thumbnails=NewImageList();
  while ((image=RemoveFirstImageFromList(&images)) != (Image *) NULL)
  {
    resize_image=ResizeImage(image,106,80,LanczosFilter,exception);
    if (resize_image == (Image *) NULL)
      MagickError(exception->severity,exception->reason,exception->description);
    (void) AppendImageToList(&thumbnails,resize_image);
    DestroyImage(image);
  }
  /*
    Write the image thumbnail.
  */
  (void) strcpy(thumbnails->filename,argv[2]);
  WriteImage(image_info,thumbnails,exception);
  /*
    Destroy the image thumbnail and exit.
  */
  thumbnails=DestroyImageList(thumbnails);
  image_info=DestroyImageInfo(image_info);
  exception=DestroyExceptionInfo(exception);
  MagickCoreTerminus();
  return(0);
}
```

--------------------------------

### Install Ghostscript Fonts

Source: https://imagemagick.org/download

Installs Ghostscript fonts, which are a dependency for ImageMagick functionality.

```bash
brew install ghostscript
```

--------------------------------

### Execute ImageMagick Script

Source: https://imagemagick.org/magick-script

Examples of running an ImageMagick script using either the dedicated interpreter or the magick utility.

```bash
#!/bin/env magick-script
-size 100x100 xc:red ( rose: -rotate -90 ) +append  -write show:
```

```bash
#!/bin/magick -script
-size 100x100 xc:red ( rose: -rotate -90 ) +append  -write show:
```

--------------------------------

### Initialize OpenCL environment

Source: https://imagemagick.org/opencl

Run the initial configuration tests for OpenCL acceleration.

```bash
MAGICK_OCL_DEVICE=true magick sample.jpg -blur 0x5 null:
```

--------------------------------

### Configure with Modules

Source: https://imagemagick.org/install-source

Enable modules build for advanced configuration.

```bash
./configure --with-modules
```

--------------------------------

### Verify PerlMagick Installation

Source: https://imagemagick.org/perl-magick

Check if the Perl module is correctly installed by printing the QuantumDepth.

```bash
perl -MImage::Magick -le 'print Image::Magick->QuantumDepth'
```

--------------------------------

### Initialize Magick++ on Windows

Source: https://imagemagick.org/magick%2B%2B

Initialize the library using MagickPlusPlusGenesis, passing the program path to locate DLLs.

```cpp
int main( int argc, char ** argv) {
  MagickPlusPlusGenesis genesis(*argv);
  ...
```

--------------------------------

### Shear Image Command Examples

Source: https://imagemagick.org/command-line-options

Demonstrates the non-commutative nature of horizontal and vertical shears and the optimized single-command approach.

```bash
$ magick logo: -shear 20x0 -shear 0x60 logo-sheared.png
convert logo: -shear 0x60 -shear 20x0 logo-sheared.png
```

```bash
$ magick logo: -shear 20x60 logo-sheared.png
```

--------------------------------

### Configure PNG chunk inclusion

Source: https://imagemagick.org/defines

Example of using the include-chunk define to specify which ancillary chunks are included in the PNG output.

```bash
-define png:include-chunk=none,gAMA
```

--------------------------------

### Perform Basic Image Manipulation

Source: https://imagemagick.org/magick%2B%2B/Image%2B%2B.html

Example of reading an image, applying a noise filter, and writing the result back to disk.

```cpp
Image image;
image.read("myImage.tiff");
image.addNoise(GaussianNoise);
image.write("myImage.tiff");
```

--------------------------------

### Verify ImageMagick Installation

Source: https://imagemagick.org/advanced-linux-installation

Tests the installation by generating a logo image and identifying its properties.

```bash
magick logo: logo.gif
identify logo.gif
```

--------------------------------

### Install PerlMagick via yum

Source: https://imagemagick.org/perl-magick

Install the PerlMagick package on CentOS systems using yum.

```bash
yum install ImageMagick-perl
```

--------------------------------

### HSB Color Examples

Source: https://imagemagick.org/color

Examples of HSB color triples using both percentage and integer formats.

```text
hsb(0,   100%,  100%)    or    hsb(0,   255,   255)       full red
hsb(120, 100%,  100%)    or    hsb(120, 255,   255)       full green
hsb(120, 100%,  75%)     or    hsb(120, 255,   191.25)    medium green
hsb(120, 100%,  50%)     or    hsb(120, 255,   127.5)     dark green
hsb(120, 100%,  25%)     or    hsb(120, 255,   63.75)     very dark green
hsb(120, 50%,   50%)     or    hsb(120, 127.5, 127.5)     pastel green
```

--------------------------------

### Perform Forward Discrete Fourier Transform

Source: https://imagemagick.org/command-line-options

Examples of using the -fft operator to transform an image into the frequency domain, producing magnitude and phase components.

```bash
$ magick image.png -fft fft_image.miff
```

```bash
$ magick image.png -fft fft_image.png
```

--------------------------------

### Fill Color Specifications

Source: https://imagemagick.org/command-line-options

Examples of specifying colors for graphic primitives. Enclose in quotes to avoid shell interpretation of special characters.

```bash
-fill blue
-fill "#ddddff"
-fill "rgb(255,255,255)"
```

--------------------------------

### Configure WebP for Small Colorful Images

Source: https://imagemagick.org/webp

Minimalist settings for small, vibrant images.

```bash
-define webp:sns-strength=0
-define webp:filter-strength=0
-define webp:preprocessing=0
```

--------------------------------

### HSL Color Examples

Source: https://imagemagick.org/color

Examples of HSL color triples demonstrating the double cone model structure.

```text
hsl(0,   100%,  50%)     or    hsl(0,   255,   127.5)     full red
hsl(120, 100%,  100%)    or    hsl(120, 255,   255)       white
hsl(120, 100%,  75%)     or    hsl(120, 255,   191.25)    pastel green
hsl(120, 100%,  50%)     or    hsl(120, 255,   127.5)     full green
hsl(120, 100%,  25%)     or    hsl(120, 255,   63.75)     dark green
hsl(120, 50%,   50%)     or    hsl(120, 127.5, 127.5)     medium green
```

--------------------------------

### Create a MagickCache

Source: https://imagemagick.org/magick-cache

Initializes a new cache directory on the local filesystem using a passkey file.

```bash
$ magick-cache -passkey passkey.txt create /opt/magick-cache
```

--------------------------------

### Initialize OpenCL via API

Source: https://imagemagick.org/opencl

Use the C API to programmatically initialize the OpenCL environment.

```c
clEnv=GetCurrentOpenCLEnv();
if (InitializeOpenCL(clEnv,exception) == MagickFalse)
  {
    /* looks like OpenCL is not supported  */
  }
```

--------------------------------

### Install ImageMagick via Homebrew

Source: https://imagemagick.org/download

Installs the standard ImageMagick package on macOS using the Homebrew package manager.

```bash
brew install imagemagick
```

--------------------------------

### Initialize with Attributes

Source: https://imagemagick.org/perl-magick

Pass parameters directly to the new() method to set initial image attributes.

```perl
$image = Image::Magick->new(size=>'384x256');
```

--------------------------------

### Perform Inverse Discrete Fourier Transform

Source: https://imagemagick.org/command-line-options

Examples of using the -ift operator to transform frequency domain images back to the spatial domain.

```bash
$ magick fft_image.miff -ift fft_image_ift.png
```

```bash
$ magick fft_image-0.png fft_image-1.png -ift fft_image_ift.png
```

--------------------------------

### MIFF Header Key-Value Example

Source: https://imagemagick.org/miff

Example of defining MIFF header attributes, including the use of braces for values containing whitespace.

```text
id=ImageMagick
class=PseudoClass  colors=256  matte=False
columns=1280  rows=1024  depth=8
compression=RLE
colorspace=RGB
copyright={© 1999-2017 ImageMagick Studio LLC}
⋮
```

--------------------------------

### List ImageMagick Configuration

Source: https://imagemagick.org/advanced-linux-installation

Displays the current build configuration settings.

```bash
$ magick identify -list configure
```

--------------------------------

### Use blend composition with magick command

Source: https://imagemagick.org/compose

Demonstrates how to apply the blend composition method using the -compose and -define flags.

```bash
magick ... -compose blend -define compose:args=50,50 -composite ...
```

--------------------------------

### Configure WebP for Outdoor Photographs

Source: https://imagemagick.org/webp

Settings optimized for outdoor scenes with natural lighting.

```bash
-define webp:sns-strength=80
-define webp:filter-sharpness=3
-define webp:filter-strength=30
-define webp:preprocessing=2
```

--------------------------------

### magick import

Source: https://imagemagick.org/import

The import command captures an X server screen or window and saves it to a file or the clipboard.

```APIDOC
## magick import

### Description
Captures an X server screen or a specific window and saves the result to a file or the system clipboard.

### Usage
`magick import [options] [file|clipboard:]`

### Examples
- Capture a window to a file: `magick import rose.jpg`
- Capture the entire root screen: `magick import -window root screen.ps`
- Copy selection to clipboard: `magick import clipboard:`

### Options
- -adjoin: join images into a single multi-image file
- -annotate: annotate the image with text
- -border: include window border in the output image
- -colors: preferred number of colors in the image
- -crop: preferred size and location of the cropped image
- -display: get image or font from this X server
- -help: print program options
- -quality: JPEG/MIFF/PNG compression level
- -resize: resize the image
- -rotate: apply rotation to the image
- -screen: select image from root window
- -window: select window with this id or name
```

--------------------------------

### Retrieve Image Attributes with Get()

Source: https://imagemagick.org/perl-magick

Use the Get() method to fetch specific attributes from an image object. The method can return multiple values or target specific images in a sequence.

```perl
($a, $b, $c) = $image->Get('colorspace', 'magick', 'adjoin');
$width = $image->[3]->Get('columns');
```

--------------------------------

### Read, Crop, and Write an Image

Source: https://imagemagick.org/magick%2B%2B/Image%2B%2B.html

Demonstrates reading an image file, applying a crop transformation, and writing the result to a new file with exception handling.

```cpp
#include <Magick++.h>
#include <iostream>
using namespace std;
using namespace Magick;
int main(int argc,char **argv)
{
  InitializeMagick(*argv);

  // Construct the image object. Separating image construction from the
  // the read operation ensures that a failure to read the image file
  // doesn't render the image object useless.
  Image image;
  try {
    // Read a file into image object
    image.read( "girl.gif" );

    // Crop the image to specified size (width, height, xOffset, yOffset)
    image.crop( Geometry(100,100, 100, 100) );

    // Write the image to a file
    image.write( "x.gif" );
  }
  catch( Exception &error_ )
    {
      cout << "Caught exception: " << error_.what() << endl;
      return 1;
    }
  return 0;
}
```

--------------------------------

### Querying Image Format Information

Source: https://imagemagick.org/magick%2B%2B/CoderInfo.html

Demonstrates how to instantiate CoderInfo for a specific format and retrieve its properties.

```cpp
CoderInfo info("GIF");
cout < info->name() << ": (" << info->description() << ") : ";
cout << "Readable = ";
if ( info->isReadable() )
  cout << "true";
else
  cout << "false";
cout << ", ";
cout << "Writable = ";
if ( info->isWritable() )
  cout << "true";
else
  cout << "false";
cout << ", ";
cout << "Multiframe = ";
if ( info->isMultiframe() )
  cout << "true";
else
  cout << "false";
cout << endl;
```

--------------------------------

### GetPixel

Source: https://imagemagick.org/perl-magick

Gets a single pixel value.

```APIDOC
## GetPixel

### Description
Get a single pixel. By default normalized pixel values are returned.

### Parameters
- **geometry** (geometry) - Optional
- **channel** (enum) - Optional
- **normalize** (boolean) - Optional
- **x** (integer) - Required
- **y** (integer) - Required
```

--------------------------------

### Define Configuration File Search Paths

Source: https://imagemagick.org/resources

Search order for configuration files on various platforms.

```text
$MAGICK_CONFIGURE_PATH
$PREFIX/etc/ImageMagick-7
$PREFIX/share/ImageMagick-7
$XDG_CACHE_HOME/ImageMagick
$HOME/.config/ImageMagick
<client path>/etc/ImageMagick
```

```text
$MAGICK_CONFIGURE_PATH
$MAGICK_HOME/etc/ImageMagick-7
$MAGICK_HOME/share/ImageMagick-7
$PREFIX/share/ImageMagick-7
$XDG_CACHE_HOME/ImageMagick
$HOME/.config/ImageMagick/
<client path>/etc/ImageMagick
<current directory>
```

```text
$MAGICK_CONFIGURE_PATH
<windows registry>
$PREFIX/config
$USERPROFILE/.config/ImageMagick
<client path>
```

```text
$MAGICK_CONFIGURE_PATH
$MAGICK_HOME
$USERPROFILE/.config/ImageMagick
client path
<current directory>
```

--------------------------------

### GetPixels

Source: https://imagemagick.org/perl-magick

Gets image pixels as defined by the map.

```APIDOC
## GetPixels

### Description
Get image pixels as defined by the map (e.g. "RGB", "RGBA", etc.). By default non-normalized pixel values are returned.

### Parameters
- **geometry** (geometry) - Optional
- **width** (integer) - Optional
- **height** (integer) - Optional
- **x** (integer) - Optional
- **y** (integer) - Optional
- **map** (string) - Optional
- **normalize** (boolean) - Optional
```

--------------------------------

### Capture Entire Screen to Postscript

Source: https://imagemagick.org/import

Captures the entire X server screen and saves it in Postscript format.

```bash
$ magick import -window root screen.ps
```

--------------------------------

### Read, Crop, and Write Image with Magick++

Source: https://imagemagick.org/source/magick%2B%2B.cpp

Demonstrates basic image operations: reading a default image, cropping it to a specific region, and writing the result to a new file. Ensure ImageMagick and Magick++ are installed and initialized.

```cpp
#include <Magick++.h>
#include <iostream>

using namespace std;
using namespace Magick;

int main(int argc,char **argv)
{
  InitializeMagick(*argv);

  // Construct the image object. Separating image construction from the 
  // the read operation ensures that a failure to read the image file 
  // doesn't render the image object useless. 
  Image image;
  try {
    // Read a file into image object 
    image.read( "logo:" );

    // Crop the image to specified size (width, height, xOffset, yOffset)
    image.crop( Geometry(100,100, 100, 100) );

    // Write the image to a file 
    image.write( "logo.png" );
  }
  catch( Exception &error_ )
    {
      cout << "Caught exception: " << error_.what() << endl;
      return 1;
    }
  return 0;
}

```

--------------------------------

### Get image statistics

Source: https://imagemagick.org/perl-magick

Returns statistics for each channel in the image.

```perl
@statistics = $image->Statistics();
```

--------------------------------

### DrawablePushPattern

Source: https://imagemagick.org/magick%2B%2B/Drawable.html

Starts a pattern definition with a specified ID, offset, and dimensions.

```APIDOC
## DrawablePushPattern(std::string &id_, ssize_t x_, ssize_t y_, size_t width_, size_t height_)

### Description
Starts a pattern definition with an arbitrary pattern name, offset, and size. The pattern is defined within the coordinate system defined by the specified offset and size.
```

--------------------------------

### xResolution / yResolution

Source: https://imagemagick.org/magick%2B%2B/Image%2B%2B.html

Methods to get or set the X and Y resolution of the image.

```APIDOC
## double xResolution()
## double yResolution()

### Description
Retrieves the X or Y resolution of the image.
```

--------------------------------

### Configure WebP for Digital Portraits

Source: https://imagemagick.org/webp

Use these settings for indoor shots and portraits to optimize quality and filtering.

```bash
-define webp:sns-strength=80
-define webp:filter-sharpness=4
-define webp:filter-strength=35
-define webp:preprocessing=0
```

--------------------------------

### Configure ImageMagick Build

Source: https://imagemagick.org/advanced-linux-installation

Navigate to the source directory and execute the configuration script to detect environment settings and dependencies.

```bash
$ cd ImageMagick-7.1.2-29

./configure
```
Tokens:
Raw