Media Gallery now exposes a small set of APIs that can be used by other Geeklog plugins to manipulate image media. This allows other plugin developers to leverage the work we've done with Media Gallery in supporting three different image backends (ImageMagick, GD Libs and NetPBM).

MG_getMediaMetaData( $filename )

This function will return an array of meta data. This is just a front-end to getID3(). The meta data varies depending on the media type, but the ['mime_type'] element will always be available.

Parameters: |$filename |Full path / filename of the media file |

Returns and arry:

Array of meta data – The contents of the array vary depending on the media type. The ‘mime_type’ element will always be populated.

MG_convertImageFormat ($srcImage, $destImage, $destFormat, $deleteOriginal=1 )

This function will convert an image from one format to another.

Parameters:

Notes:

$srcImage and $destImage can be the same path / filename, this will convert the original image in place.

Returns an array:

  MG_resizeImage($srcImage, $destImage, $dImageHeight, $dImageWidth, $mimeType='', $deleteSrc=0 )

This will resize an image to the desired $dImageWidth x $dImageHeight resolution. It will always maintain the original image aspect ratio. For example, if your source image is 640×320 and you pass 200×200 it will actually resize the image to 200×150 to maintain the aspect ratio.

Parameters:

Notes:

The $mimeType field is optional, if not passed (i.e.; blank), MG_resizeImage() will call MG_getMediaMetaData() to determine the source image mime type.

The destination image will be the same mime type as the source image.

Returns an array:

MG_rotateImage( $srcImage, $direction )

This function will rotate an image 'right' or 'left' 90 degrees.

Parameters:

Returns an array:

MG_watermarkImage( $origImage, $watermarkImage, $opacity, $location )

This function will apply a watermark to the original image.

Parameters:

Returns an array: