nn::jpeg::CTR::JpegMpEncoder::SetImageUid Member Function

#include <nn/jpeg.h>

void SetImageUid(
     const char * pBuffer
);

	Name	Description
in	pBuffer	Specifies a unique image ID. The ID is a 128-bit integer value represented as a 32-character hexadecimal ASCII string. When the terminating 0x00 character is included, this value has a byte length of IMAGE_UID_SIZE (33) bytes. Specify NULL to clear the value.

None.

Registers the unique image ID to embed in the EXIF IFD of a JPEG file.

To get embedded data, first either decode the image or extract its EXIF information, and then call the JpegMpDecoder::GetLastImageUid function.

When using MP format, specify to append a unique ID list for individual images using the StartMpEncoderFirst function, and then every time you call the StartMpEncoderNext function for an image, the ID registered for this image by this function is copied to the unique ID list for individual images (excluding the first image).

Call this function before calling the encoding function. The values specified by this function are cleared after the encoding function completes, regardless of whether the encoding function succeeded or failed. When encoding multiple times, you must call this function before each encoding function call. The values specified by this function are also cleared if you specify NULL for the pBuffer argument, or if you reinitialize the encoder object using the Initialize function.

2010/06/14

Initial version.