BitmapMetadataHandler Class Reference

Class to deal with reconciling and extracting metadata from bitmap images. More...

Public Member Functions
	addMetadata ( $metaArray, $type='other')
	Add misc metadata.
	getExif ( $filename, $byteOrder)
	Get exif info using exif class.
	getMetadataArray ()
	Merge together the various types of metadata the different types have different priorities, and are merged in order.

Static Public Member Functions
static	getTiffByteOrder ( $filename)
	Read the first 2 bytes of a tiff file to figure out Little Endian or Big Endian.
static	GIF ( $filename)
	function for gif images.
static	Jpeg ( $filename)
	Main entry point for jpeg's.
static	PNG ( $filename)
	Entry point for png At some point in the future this might merge the png various tEXt chunks to that are interesting, but for now it only does XMP.
static	Tiff ( $filename)
	This doesn't do much yet, but eventually I plan to add XMP support for Tiff.

Detailed Description

Class to deal with reconciling and extracting metadata from bitmap images.

This is meant to comply with http://www.metadataworkinggroup.org/pdf/mwg_guidance.pdf

This sort of acts as an intermediary between MediaHandler::getMetadata and the various metadata extractors.

Todo

Other image formats.

Stability: newable

Note

marked as newable in 1.35 for lack of a better alternative, but should become a stateless service, or a handler managed registry for metadata handlers for different file types.

Definition at line 44 of file BitmapMetadataHandler.php.

Member Function Documentation

addMetadata()

BitmapMetadataHandler::addMetadata	(		$metaArray,
			$type = 'other' )

Add misc metadata.

Warning: atm if the metadata category doesn't have a priority, it will be silently discarded.

Parameters

array	$metaArray	Array of metadata values
string	$type	Type. defaults to other. if two things have the same type they're merged

Definition at line 115 of file BitmapMetadataHandler.php.

References $type.

Referenced by getExif().

getExif()

BitmapMetadataHandler::getExif	(		$filename,
			$byteOrder )

Get exif info using exif class.

Basically what used to be in BitmapHandler::getMetadata(). Just calls stuff in the Exif class.

Parameters are passed to the Exif class.

Parameters

string	$filename
string	$byteOrder

Definition at line 98 of file BitmapMetadataHandler.php.

References addMetadata().

getMetadataArray()

BitmapMetadataHandler::getMetadataArray

(

)

Merge together the various types of metadata the different types have different priorities, and are merged in order.

This function is generally called by the media handlers' getMetadata()

Returns

array

Definition at line 133 of file BitmapMetadataHandler.php.

References $type.

getTiffByteOrder()

static BitmapMetadataHandler::getTiffByteOrder ( $filename )

static

Read the first 2 bytes of a tiff file to figure out Little Endian or Big Endian.

Needed for exif stuff.

Parameters

string

$filename

Returns

string|false 'BE' or 'LE' or false

Definition at line 312 of file BitmapMetadataHandler.php.

Referenced by Tiff().

GIF()

static BitmapMetadataHandler::GIF ( $filename )

static

function for gif images.

They don't really have native metadata, so just merges together XMP and image comment.

Parameters

string

$filename

Full path to file

Returns

array Metadata array

Definition at line 246 of file BitmapMetadataHandler.php.

References $type, GIFMetadataExtractor\getMetadata(), and GIFMetadataExtractor\VERSION.

Referenced by GIFHandler\getSizeAndMetadata().

Jpeg()

static BitmapMetadataHandler::Jpeg ( $filename )

static

Main entry point for jpeg's.

Parameters

string

$filename

Filename (with full path)

Returns

array Metadata result array.

Exceptions

MWException

On invalid file.

Definition at line 168 of file BitmapMetadataHandler.php.

References $res, $type, and JpegMetadataExtractor\segmentSplitter().

Referenced by JpegHandler\getSizeAndMetadata().

PNG()

static BitmapMetadataHandler::PNG ( $filename )

static

Entry point for png At some point in the future this might merge the png various tEXt chunks to that are interesting, but for now it only does XMP.

Parameters

string

$filename

Full path to file

Returns

array Array for storage in img_metadata.

Definition at line 213 of file BitmapMetadataHandler.php.

References $type, PNGMetadataExtractor\getMetadata(), and PNGMetadataExtractor\VERSION.

Referenced by PNGHandler\getSizeAndMetadata().

Tiff()

static BitmapMetadataHandler::Tiff ( $filename )

static

This doesn't do much yet, but eventually I plan to add XMP support for Tiff.

(PHP's exif support already extracts but needs some further processing because PHP's exif support is stupid...)

Todo

Add XMP support, so this function actually makes sense to put here.

The various exceptions this throws are caught later.

Parameters

string

$filename

Exceptions

MWException

Returns

array The metadata.

Definition at line 285 of file BitmapMetadataHandler.php.

References getTiffByteOrder(), and Exif\version().

Referenced by TiffHandler\getSizeAndMetadata().

---

The documentation for this class was generated from the following file:

• includes/media/BitmapMetadataHandler.php