1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../../css/manpage.css" type="text/css" />
7<title>SetDateTime</title>
8  </head>
9  <body>
10<h1><CODE>nn::jpeg::CTR::JpegMpEncoder::SetDateTime</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/jpeg.h&gt;
14void SetDateTime(
15     const char * pBuffer
16);
17</pre>
18    </div>
19<h2>Arguments</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>in</td>
31<th>pBuffer</th>
32<td>Specify the date and time. Use a string with the format &quot;<CODE>YYYY:MM:DD HH:MM:DD</CODE>&quot; terminated with <CODE>0x00</CODE>, for a total of 20 characters.<br />Specify <CODE>NULL</CODE> to clear the value.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36    <div class="section">
37None.
38               </div>
39<h2>Description</h2>
40    <div class="section">
41<p>Registers the date and time an image was taken, for embedding in the JPEG file.</p><p>This information is registered as the IFD0's <CODE>DateTime</CODE> tag and as the ExifID's <CODE>DateTimeOriginal</CODE> and <CODE>DateTimeDigitized</CODE> tags. The default is not to register this data. In this case, the encoding function calls <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/GetDateTimeNow.html"><CODE>GetDateTimeNow</CODE></a> and registers the current time. If option specifications are given by <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetOption.html">SetOption</a> and APPI is not recorded, the encode function does not call <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/GetDateTimeNow.html">GetDateTimeNow</a>.</p><p>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 <CODE>NULL</CODE> for the <SPAN class="argument">pBuffer</SPAN> argument, or if you reinitialize the encoder object using the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpEncoder/Initialize.html">Initialize</a></CODE> function.</p><!-- write here --></div>
42<h2>Revision History</h2>
43    <div class="section">
44      <dl class="history">
45        <dt>2010/10/22</dt>
46<dd>Added a description of <CODE>SetOption</CODE>.<br />
47        </dd>
48        <dt>2010/06/14</dt>
49<dd>Initial version.<br />
50        </dd>
51      </dl>
52    </div>
53  <hr><p>CONFIDENTIAL</p></body>
54</html>
55