blob - Read or Write Binary Large OBjects
Description: ImageMagick - a robust collection of tools and libraries to read, write and manipulate an image in any of the popular image formats. ImageMagick allows dynamic creation of GIFs, making it suitable for Web applications.
Keywords: ImageMagick,PerlMagick,GraphicsMagick,Magick++,Image,Magick,Magic,Pixel,Perl,Wand

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"