nn::jpeg::CTR::JpegMpDecoder::GetMpAttribute Member Function

#include <nn/jpeg.h>

bool GetMpAttribute(
     MpAttribute * pAttr,
     const u8 * src,
     size_t srcSize
);

	Name	Description
out	pAttr	Specifies the buffer for storing the MP Attribute IFD. The stored data has been converted to a format that is easier for the library to process, and thus the binary representation of a stored MP Attribute IFD differs from that of the original data.
in	src	Specifies the start of the individual image data.
in	srcSize	Specifies the size of src in bytes.

Returns true on success. Returns false on failure.
Use the GetLastError function to get the reason for failure.

Gets the MP Attribute IFD, which is included in the individual image data stored in MP format.

The MP Attribute IFD is included in the individual image data. Normally, the src argument contains a pointer to the position of the starting image plus the return value of GetMpImageOffset. srcSize contains the return value of GetMpImageSize. Confirm beforehand that the region specified by src and srcSize is a valid region.

This function will fail if the MP type (MpTypeCode) of the individual image is MP_TYPE_CODE_LARGE_THUMBNAIL_IMAGE_CLASS_1 or MP_TYPE_CODE_LARGE_THUMBNAIL_IMAGE_CLASS_2, because these types of images are for display on monitors and do not include an MP Attribute IFD or the other information associated with MP format.

This function only partially performs decoding and shared processing. Consequently, there are some functions you cannot call immediately after calling this function: the GetLastWidth, GetLastHeight, GetLastOutputBufferWidth, and GetLastOutputBufferHeight functions, and all functions that get EXIF information, such as the GetLastDateTime function. Calls to these functions will have undefined return values.

2010/06/14

Initial version.