ImageMagick (legacy) – MagickCore, C API: Convert to and from Cipher Pixels
Author: ImageMagick Studio LLC
Description: Create, Edit, Compose, or Convert Digital Images
Keywords: magickcore, c, api:, convert, to, from, cipher, pixels, image processing software

## AcquireAESInfo

AcquireAESInfo() allocate the AESInfo structure.

The format of the AcquireAESInfo method is:

    AESInfo *AcquireAESInfo(void)

## DestroyAESInfo

DestroyAESInfo() zeros memory associated with the AESInfo structure.

The format of the DestroyAESInfo method is:

    AESInfo *DestroyAESInfo(AESInfo *aes_info)

A description of each parameter follows:

aes_info
  the cipher context.

## EncipherAESBlock

EncipherAESBlock() enciphers a single block of plaintext to produce a block of ciphertext.

The format of the EncipherAESBlock method is:

    void EncipherAES(AESInfo *aes_info,const unsigned char *plaintext,
      unsigned char *ciphertext)

A description of each parameter follows:

aes_info
  the cipher context.
plaintext
  the plain text.
ciphertext
  the cipher text.

## PasskeyDecipherImage

PasskeyDecipherImage() converts cipher pixels to plain pixels.

The format of the PasskeyDecipherImage method is:

    MagickBooleanType PasskeyDecipherImage(Image *image,
      const StringInfo *passkey,ExceptionInfo *exception)
    MagickBooleanType DecipherImage(Image *image,const char *passphrase,
      ExceptionInfo *exception)

A description of each parameter follows:

image
  the image.
passphrase
  decipher cipher pixels with this passphrase.
passkey
  decrypt cipher pixels with this passkey.
exception
  return any errors or warnings in this structure.

## PasskeyEncipherImage

PasskeyEncipherImage() converts pixels to cipher-pixels.

The format of the PasskeyEncipherImage method is:

    MagickBooleanType PasskeyEncipherImage(Image *image,
      const StringInfo *passkey,ExceptionInfo *exception)
    MagickBooleanType EncipherImage(Image *image,const char *passphrase,
      ExceptionInfo *exception)

A description of each parameter follows:

image
  the image.
passphrase
  encipher pixels with this passphrase.
passkey
  decrypt cipher pixels with this passkey.
exception
  return any errors or warnings in this structure.

## SetAESKey

SetAESKey() sets the key for the AES cipher. The key length is specified in bits. Valid values are 128, 192, or 256 requiring a key buffer length in bytes of 16, 24, and 32 respectively.

The format of the SetAESKey method is:

    SetAESKey(AESInfo *aes_info,const StringInfo *key)

A description of each parameter follows:

aes_info
  the cipher context.
key
  the key.

## PasskeyDecipherImage

PasskeyDecipherImage() converts cipher pixels to plain pixels.

The format of the PasskeyDecipherImage method is:

    MagickBooleanType PasskeyDecipherImage(Image *image,
      const StringInfo *passkey,ExceptionInfo *exception)
    MagickBooleanType DecipherImage(Image *image,const char *passphrase,
      ExceptionInfo *exception)

A description of each parameter follows:

image
  the image.
passphrase
  decipher cipher pixels with this passphrase.
passkey
  decrypt cipher pixels with this passkey.
exception
  return any errors or warnings in this structure.

## PasskeyEncipherImage

PasskeyEncipherImage() converts pixels to cipher-pixels.

The format of the PasskeyEncipherImage method is:

    MagickBooleanType PasskeyEncipherImage(Image *image,
      const StringInfo *passkey,ExceptionInfo *exception)
    MagickBooleanType EncipherImage(Image *image,const char *passphrase,
      ExceptionInfo *exception)

A description of each parameter follows:

passphrase
  decipher cipher pixels with this passphrase.
passkey
  decrypt cipher pixels with this passkey.
exception
  return any errors or warnings in this structure.