Skip to page contents

[ AcquireAESInfo | DecipherImage | DestroyAESInfo | EncipherImage | EncipherAESBlock | SetAESKey ]

AcquireAESInfo() allocate the AESInfo structure.

The format of the AcquireAESInfo method is:

  AESInfo *AcquireAESInfo(void)

DecipherImage() converts cipher pixels to plain pixels.

The format of the DecipherImage method is:

  MagickBooleanType DecipherImage(Image *image,const char *passphrase,
    ExceptionInfo *exception)
  MagickBooleanType PasskeyDecipherImage(Image *image,
    const StringInfo *passkey,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.

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.

EncipherImage() converts pixels to cipher-pixels.

The format of the EncipherImage method is:

  MagickBooleanType EncipherImage(Image *image,const char *passphrase,
    ExceptionInfo *exception)
  MagickBooleanType PasskeyEncipherImage(Image *image,
    const StringInfo *passkey,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.

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.

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.