nn::jpeg::CTR::JpegMpEncoder::SetDateTime Member Function

Syntax

#include <nn/jpeg.h>

void SetDateTime(
     const char * pBuffer
);

Parameters

Name Description
in pBuffer Specify the date and time. Use a string with the format "YYYY:MM:DD HH:MM:DD" terminated with 0x00, for a total of 20 characters.
Specify NULL to clear the value.

Return Values

None.

Description

Registers the date and time an image was taken, for embedding in the JPEG file.

This information is registered as the IFD0's DateTime tag and as the EXIF IFD's DateTimeOriginal and DateTimeDigitized tags. The default is not to register this data. In this case, the encoding function calls GetDateTimeNow and registers the current time. If option specifications are given by SetOption and APPI is not recorded, the encode function does not call GetDateTimeNow.

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.

Revision History

2010/10/22
Added a description of SetOption.
2010/06/14
Initial version.

CONFIDENTIAL