NAME

blob -


SYNOPSIS

Image * BlobToImage( const ImageInfo *image_info, const char *blob, const unsigned long length );

void GetBlobInfo( BlobInfo *blob_info );

char * ImageToBlob( const ImageInfo *image_info, Image *image, unsigned long *length );

void SetBlobQuantum( BlobInfo *blob_info, const unsigned long quantum );


FUNCTION DESCRIPTIONS


BlobToImage

Method BlobToImage implements direct to memory image formats. It returns the blob as an image.

The format of the BlobToImage method is:

Image *BlobToImage ( const ImageInfo *image_info, const char *blob, const unsigned long length );

A description of each parameter follows:

image:

Method BlobToImage returns an image from the supplied blob. If an error occurs NULL is returned.

image_info:

Specifies a pointer to an ImageInfo structure.

blob:

The address of a character stream in one of the image formats understood by ImageMagick.

length:

This unsigned integer reflects the length in bytes of the blob.


GetBlobInfo

Method GetBlobInfo initializes the BlobInfo structure.

The format of the GetBlobInfo method is:

void GetBlobInfo ( BlobInfo *blob_info );

A description of each parameter follows:

blob_info:

Specifies a pointer to a BlobInfo structure.


ImageToBlob

Method ImageToBlob implements direct to memory image formats. It returns the image as a blob and its length.

The format of the ImageToBlob method is:

char *ImageToBlob ( const ImageInfo *image_info, Image *image, unsigned long *length );

A description of each parameter follows:

blob:

Method ImageToBlob returns a chunk of memory written in the desired image format (e.g. JPEG, GIF, etc.). If an error occurs NULL is returned.

image_info:

Specifies a pointer to an ImageInfo structure.

image:

The address of a structure of type Image.

length:

This pointer to an unsigned int sets the initial length of the blob. On return, it reflects the actual length of the blob.


SetBlobQuantum

Method SetBlobQuantum set the current value of the blob quantum. This is the size in bytes to add to a blob when writing to a blob exceeds its current length.

The format of the SetBlobQuantum method is:

void SetBlobQuantum ( BlobInfo *blob_info, const unsigned long quantum );

A description of each parameter follows:

blob_info:

A pointer to a BlobInfo structure.

quantum:

An unsigned long that reflects the number of bytes to increase a blob.