NAME SYNOPSIS FUNCTION DESCRIPTIONS AttachBlob BlobToFile BlobToImage CloneBlobInfo DestroyBlob DetachBlob FileToBlob GetBlobInfo GetBlobStreamData GetBlobStreamType GetConfigureBlob ImageToBlob ImageToFile PingBlob ReferenceBlob # NAME blob - Read or Write Binary Large OBjects # SYNOPSIS void AttachBlob( BlobInfo *blob_info, const void *blob, const size_t length ); unsigned int BlobToFile( char *filename, const void *blob, const size_t length, ExceptionInfo *exception ); Image * BlobToImage( const ImageInfo *image_info, const void *blob, const size_t length, ExceptionInfo *exception ); BlobInfo * CloneBlobInfo( const BlobInfo *blob_info ); void DestroyBlob( Image *image ); void DetachBlob( BlobInfo *blob_info ); void * FileToBlob( const char *filename, size_t *length, ExceptionInfo *exception ); void GetBlobInfo( BlobInfo *blob_info ); unsigned char * GetBlobStreamData( const Image *image ); StreamType GetBlobStreamType( const Image *image ); void * GetConfigureBlob( const char *filename, ExceptionInfo *exception ); void * ImageToBlob( const ImageInfo *image_info, Image *image, size_t *length, ExceptionInfo *exception ); unsigned int ImageToFile( Image *image, char *filename, ExceptionInfo *exception ); Image * PingBlob( const ImageInfo *image_info, const void *blob, const size_t length, ExceptionInfo *exception ); BlobInfo ReferenceBlob( BlobInfo *blob_info ); # FUNCTION DESCRIPTIONS ## AttachBlob AttachBlob() attaches a blob to the BlobInfo structure. The format of the AttachBlob method is: void AttachBlob ( BlobInfo *blob_info, const void *blob, const size_t length ); A description of each parameter follows: blob_info: Specifies a pointer to a BlobInfo structure. blob: The address of a character stream in one of the image formats understood by ImageMagick. length: This size_t integer reflects the length in bytes of the blob. ## BlobToFile BlobToFile() writes a blob to a file. It returns False if an error occurs otherwise True. The format of the BlobToFile method is: unsigned int BlobToFile ( char *filename, const void *blob, const size_t length, ExceptionInfo *exception ); A description of each parameter follows: status: BlobToFile returns True on success; otherwise, it returns False if an error occurs. filename: Write the blob to this file. blob: The address of a blob. length: This length in bytes of the blob. exception: Return any errors or warnings in this structure. ## BlobToImage 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 void *blob, const size_t length, ExceptionInfo *exception ); A description of each parameter follows: image_info: The image info. blob: The address of a character stream in one of the image formats understood by ImageMagick. length: This size_t integer reflects the length in bytes of the blob. exception: Return any errors or warnings in this structure. ## CloneBlobInfo CloneBlobInfo() makes a duplicate of the given blob info structure, or if blob info is NULL, a new one. The format of the CloneBlobInfo method is: BlobInfo *CloneBlobInfo ( const BlobInfo *blob_info ); A description of each parameter follows: clone_info: Method CloneBlobInfo returns a duplicate of the given blob info, or if blob info is NULL a new one. quantize_info: a structure of type info. ## DestroyBlob DestroyBlob() deallocates memory associated with a blob. The format of the DestroyBlob method is: void DestroyBlob ( Image *image ); A description of each parameter follows: image: The image. ## DetachBlob DetachBlob() detaches a blob from the BlobInfo structure. The format of the DetachBlob method is: void DetachBlob ( BlobInfo *blob_info ); A description of each parameter follows: blob_info: Specifies a pointer to a BlobInfo structure. ## FileToBlob FileToBlob() returns the contents of a file as a blob. It returns the file as a blob and its length. If an error occurs, NULL is returned. The format of the FileToBlob method is: void *FileToBlob ( const char *filename, size_t *length, ExceptionInfo *exception ); A description of each parameter follows: blob: `FileToBlob()` returns the contents of a file as a blob. If an error occurs NULL is returned. filename: The filename. length: This pointer to a size_t integer sets the initial length of the blob. On return, it reflects the actual length of the blob. exception: Return any errors or warnings in this structure. ## GetBlobInfo 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. ## GetBlobStreamData GetBlobStreamData() returns the stream data for the image. The format of the GetBlobStreamData method is: unsigned char *GetBlobStreamData ( const Image *image ); A description of each parameter follows: image: The image. ## GetBlobStreamType GetBlobStreamType() returns the stream type for the image. The format of the GetBlobStreamType method is: StreamType GetBlobStreamType ( const Image *image ); A description of each parameter follows: image: The image. ## GetConfigureBlob GetConfigureBlob() returns the specified configure file as a blob. The format of the GetConfigureBlob method is: void *GetConfigureBlob ( const char *filename, ExceptionInfo *exception ); A description of each parameter follows: filename: The configure file name. path: return the full path information of the configure file. length: This pointer to a size_t integer sets the initial length of the blob. On return, it reflects the actual length of the blob. exception: Return any errors or warnings in this structure. ## ImageToBlob ImageToBlob() implements direct to memory image formats. It returns the image as a blob and its length. The magick member of the Image structure determines the format of the returned blob ( GIG, JPEG, PNG, etc. ) The format of the ImageToBlob method is: void *ImageToBlob ( const ImageInfo *image_info, Image *image, size_t *length, ExceptionInfo *exception ); A description of each parameter follows: image_info: The image info.. image: The image. length: This pointer to a size_t integer sets the initial length of the blob. On return, it reflects the actual length of the blob. exception: Return any errors or warnings in this structure. ## ImageToFile ImageToFile() writes an image to a file. It returns False if an error occurs otherwise True. The format of the ImageToFile method is: unsigned int ImageToFile ( Image *image, char *filename, ExceptionInfo *exception ); A description of each parameter follows: status: ImageToFile returns True on success; otherwise, it returns False if an error occurs. image: The image. filename: Write the image to this file. exception: Return any errors or warnings in this structure. ## PingBlob PingBlob() returns all the attributes of an image or image sequence except for the pixels. It is much faster and consumes far less memory than BlobToImage ( ) . On failure, a NULL image is returned and exception describes the reason for the failure. The format of the PingBlob method is: Image *PingBlob ( const ImageInfo *image_info, const void *blob, const size_t length, ExceptionInfo *exception ); A description of each parameter follows: image_info: The image info. blob: The address of a character stream in one of the image formats understood by ImageMagick. length: This size_t integer reflects the length in bytes of the blob. exception: Return any errors or warnings in this structure. ## ReferenceBlob ReferenceBlob() increments the reference count associated with the pixel blob returning a pointer to the blob. The format of the ReferenceBlob method is: BlobInfo ReferenceBlob ( BlobInfo *blob_info ); A description of each parameter follows: blob_info: The blob_info. "Image manipulation software that works like magick"