registry
In-memory image registration interface
DeleteMagickRegistry
Synopsis
MagickPassFail DeleteMagickRegistry( const long id );
Description
DeleteMagickRegistry() deletes an entry in the registry as defined by the id. It returns MagickPass if the entry is deleted otherwise MagickFail if no entry is found in the registry that matches the id.
The format of the DeleteMagickRegistry method is:
MagickPassFail DeleteMagickRegistry( const long id );
A description of each parameter follows:
- id:
The registry id.
GetImageFromMagickRegistry
Synopsis
Image *GetImageFromMagickRegistry( const char *name, long *id, ExceptionInfo *exception );
Description
GetImageFromMagickRegistry() gets an image from the registry as defined by its name. If the blob that matches the name is not found, NULL is returned.
The format of the GetImageFromMagickRegistry method is:
Image *GetImageFromMagickRegistry( const char *name, long *id, ExceptionInfo *exception );
- name:
The name of the image to retrieve from the registry.
- id:
The registry id.
- exception:
Return any errors or warnings in this structure.
GetMagickRegistry
Synopsis
const void *GetMagickRegistry( const long id, RegistryType *type, size_t *length, ExceptionInfo *exception );
Description
GetMagickRegistry() gets a blob from the registry as defined by the id. If the blob that matches the id is not found, NULL is returned.
The format of the GetMagickRegistry method is:
const void *GetMagickRegistry( const long id, RegistryType *type, size_t *length, ExceptionInfo *exception );
- id:
The registry id.
- type:
The registry type.
- length:
The blob length in number of bytes.
- exception:
Return any errors or warnings in this structure.
SetMagickRegistry
Synopsis
long SetMagickRegistry( const RegistryType type, const void *blob, const size_t length, ExceptionInfo *exception );
Description
SetMagickRegistry() sets a blob into the registry and returns a unique ID. If an error occurs, -1 is returned.
The format of the SetMagickRegistry method is:
long SetMagickRegistry( const RegistryType type, const void *blob, const size_t length, ExceptionInfo *exception );
- type:
The registry type.
- blob:
The address of a Binary Large OBject.
- length:
For a registry type of ImageRegistryType use sizeof(Image) otherwise the blob length in number of bytes.
- exception:
Return any errors or warnings in this structure.