nn::jpeg::CTR::JpegMpEncoder::GetMpRegionsToBuildJpegData Member Function

#include <nn/jpeg.h>

bool GetMpRegionsToBuildJpegData(
     MpRegionsToBuildJpegData * pBuffer
);

	Name	Description
out	pBuffer	Buffer storing memory region information.

Returns true on success. Returns false on failure.
Could not get the reason for failure. This function does not update the value returned by GetLastError.

Gets the memory region information for reconstructing JPEG data from the encoding results of the most recent call to the StartMpEncoderFirst, StartMpEncoderNext, or StartMpEncoderLR function.

If that processing fails, this function also fails. This function also fails if the StartJpegEncoder function was called immediately previously. This function also fails right after encoding an image for monitor display using the StartMpEncoderNext function. Encoding results are needed to reconstruct the JPEG data, so do not destroy the encoded data.

Instead of JPEG-encoding the same image twice, once in MP format and once not, use this function to take the MP-encoded results and get the plain JPEG-encoded results at high speed.

Simply put, individual image data in MP format has this structure: [(JPEG header) + (APP2) + (JPEG data)], where APP2 includes the information associated with MP format. If we leave out the APP2, we have [(JPEG header) + (JPEG data)], which is identical to JPEG encoding results that are not MP format. This function gets pointers and byte sizes for the (JPEG header) and (JPEG data) memory regions.

If StartMpEncoderLR was the function called immediately previously, this function is only able to get the memory region information for the left-eye image.

2010/06/14

Initial version.