Skip to page contents

[ CloneImageProfiles | DestroyImageProfiles | GetImageProfile | GetNextImageProfile | ProfileImage | RemoveImageProfile | ResetImageProfileIterator | SetImageProfile ]

CloneImageProfiles() clones one or more image profiles.

The format of the CloneImageProfiles method is:

  MagickBooleanType CloneImageProfiles(Image *image,
    const Image *clone_image)

A description of each parameter follows:

image

The image.

clone_image

The clone image.

DestroyImageProfiles() releases memory associated with an image profile map.

The format of the DestroyProfiles method is:

  void DestroyImageProfiles(Image *image)

A description of each parameter follows:

image

The image.

GetImageProfile() gets a profile associated with an image by name.

The format of the GetImageProfile method is:

  const StringInfo *GetImageProfile(const Image *image,const char *name)

A description of each parameter follows:

image

The image.

name

The profile name.

GetNextImageProfile() gets the next profile name for an image.

The format of the GetNextImageProfile method is:

  char *GetNextImageProfile(const Image *image)

A description of each parameter follows:

hash_info

The hash info.

ProfileImage() adds or removes a ICC, IPTC, or generic profile from an image. If the profile is NULL, it is removed from the image otherwise added. Use a name of '*' and a profile of NULL to remove all profiles from the image.

The format of the ProfileImage method is:

  MagickBooleanType ProfileImage(Image *image,const char *name,
    const void *datum,const unsigned long length,
    const MagickBooleanType clone)

A description of each parameter follows:

image

The image.

name

Name of profile to add or remove: ICC, IPTC, or generic profile.

datum

The profile data.

length

The length of the profile.

clone

should be MagickFalse.

RemoveImageProfile() removes a profile from the image-map by its name.

The format of the RemoveImageProfile method is:

  MagickBooleanTyupe RemoveImageProfile(Image *image,const char *name)

A description of each parameter follows:

image

The image.

name

The profile name.

ResetImageProfileIterator() resets the image profile iterator. Use it in conjunction with GetNextImageProfile() to iterate over all the profiles associated with an image.

The format of the ResetImageProfileIterator method is:

  ResetImageProfileIterator(Image *image)

A description of each parameter follows:

image

The image.

SetImageProfile() adds a named profile to the image. If a profile with the same name already exists, it is replaced. This method differs from the ProfileImage() method in that it does not apply CMS color profiles.

The format of the SetImageProfile method is:

  MagickBooleanType SetImageProfile(Image *image,const char *name,
    const StringInfo *profile)

A description of each parameter follows:

image

The image.

name

The profile name.

profile

A StringInfo structure that contains the named profile.