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 <style type="text/css"><!-- 8 span.static_style 9 { 10 font-size : 8pt; 11 color : white; 12 font-weight : bold; 13 background : #44f; 14 border-left : solid 1px #aaf; 15 border-top : solid 1px #aaf; 16 border-right : solid 1px #00c; 17 border-bottom : solid 1px #00c; 18 padding-left : 2px; 19 padding-right : 2px; 20 } 21 22 span.virtual_style 23 { 24 font-size : 8pt; 25 color : white; 26 font-weight : bold; 27 background : #0a0; 28 border-left : solid 1px #0f0; 29 border-top : solid 1px #0f0; 30 border-right : solid 1px #060; 31 border-bottom : solid 1px #060; 32 padding-left : 2px; 33 padding-right : 2px; 34 } 35 36 span.protected_style 37 { 38 font-size : 8pt; 39 color : white; 40 font-weight : bold; 41 background : #444; 42 border-left : solid 1px #ccc; 43 border-top : solid 1px #ccc; 44 border-right : solid 1px #222; 45 border-bottom : solid 1px #222; 46 padding-left : 2px; 47 padding-right : 2px; 48 } 49 --></style> 50<title><CODE>nn::jpeg::CTR</CODE></title> 51 </head> 52 <body> 53<h1><CODE>nn::jpeg::CTR</CODE> Namespace</h1> 54<h2>Description</h2> 55 <div class="section"> 56<p>The <a href="../../../nn/jpeg/CTR/Overview.html">CTR</a> JPEG namespace. <br />(This can also be written without the <CODE>::CTR</CODE> portion.)</p><p> 57Decodable JPEG Data and MP-Format Data 58 </p><p> 59The only JPEG data that the <CODE>nn::jpeg::JpegMpDecoder</CODE> class can decode is baseline JPEG compression method.<br /><br />The same applies to data in MP-format data.<br /><br />In particular, decoding will fail for data in the following JPEG and MP formats. 60<ul><li>Progressive</li><li>Uncompressed</li><li>If APP1 have been recorded, the first APP1 is not Exif information. When multiple APP1 have been recorded, all but the first APP1 are ignored.</li></ul> 61Even data in baseline JPEG compression format may not be decodable if it was not created by the <CODE>nn::jpeg::JpegMpEncoder</CODE> class.<br /><br />If decoding fails, it may be possible to decode it after deleting the Exif information, thumbnail, or APP<EM>n</EM> (<EM>n</EM> being 0-15). For data in MP format, however, keep the MP format related information in the APP2. 62 </p></div> 63 <a name="class" id="class"> 64<h2>Classes</h2> 65 <div class="section"> 66 <table class="members"> 67 <tr> 68 <th> 69<a href="../../../nn/jpeg/CTR/JpegMpDecoder/Overview.html"><CODE>nn::jpeg::CTR::JpegMpDecoder</CODE></a> 70 </th> 71<td>This class performs JPEG decoding.</td> 72 </tr> 73 <tr> 74 <th> 75<a href="../../../nn/jpeg/CTR/JpegMpEncoder/Overview.html"><CODE>nn::jpeg::CTR::JpegMpEncoder</CODE></a> 76 </th> 77<td>This class performs JPEG encoding.</td> 78 </tr> </table> 79 </div> 80 </a> <a name="struct" id="struct"> 81<h2>Structures</h2> 82 <div class="section"> 83 <table class="members"> 84 <tr> 85 <th> 86<a href="../../../nn/jpeg/CTR/MpIndex/Overview.html"><CODE>nn::jpeg::CTR::MpIndex</CODE></a> 87 </th> 88<td>Structure holding the MP Index IFD in a format easily processed by the library. The MP Index IFD is included in the data stored in MP format.</td> 89 </tr> 90 <tr> 91 <th> 92<a href="../../../nn/jpeg/CTR/MpEntry/Overview.html"><CODE>nn::jpeg::CTR::MpEntry</CODE></a> 93 </th> 94<td>Structure holding an MP entry in a format easily processed by the library. MP entries are included in the data stored in MP format.</td> 95 </tr> 96 <tr> 97 <th> 98<a href="../../../nn/jpeg/CTR/Rational/Overview.html"><CODE>nn::jpeg::CTR::Rational</CODE></a> 99 </th> 100<td><CODE>RATIONAL</CODE> (unsigned rational number) data type, used for members of the MP Attribute IFD and GPS IFD.</td> 101 </tr> 102 <tr> 103 <th> 104<a href="../../../nn/jpeg/CTR/Srational/Overview.html"><CODE>nn::jpeg::CTR::Srational</CODE></a> 105 </th> 106<td><CODE>SRATIONAL</CODE> (signed rational number) data type, used for members of the MP Attribute IFD and GPS IFD.</td> 107 </tr> 108 <tr> 109 <th> 110<a href="../../../nn/jpeg/CTR/MpAttribute/Overview.html"><CODE>nn::jpeg::CTR::MpAttribute</CODE></a> 111 </th> 112<td>Structure holding the MP Attribute IFD in a format easily processed by the library. The MP Attribute IFD is included in the data stored in MP format.</td> 113 </tr> 114 <tr> 115 <th> 116<a href="../../../nn/jpeg/CTR/MpRegionsToBuildJpegData/Overview.html"><CODE>nn::jpeg::CTR::MpRegionsToBuildJpegData</CODE></a> 117 </th> 118<td>Structure holding the region information (pointer and byte count) for rebuilding the JPEG data.</td> 119 </tr> 120 <tr> 121 <th> 122<a href="../../../nn/jpeg/CTR/GpsData/Overview.html">nn::jpeg::CTR::GpsData</a> 123 </th> 124<td>This structure maintains GPS IFD in a format easily processed by the library.</td> 125 </tr> </table> 126 </div> 127 </a> <a name="enum" id="enum"> 128<h2>Enumerated Types</h2> 129 <div class="section"> 130 <table class="members"> 131 <tr> 132 <td width="100"> </td> 133 <th> 134<a href="../../../nn/jpeg/CTR/PixelSampling.html"><CODE>PixelSampling</CODE></a> 135 </th> 136<td>Enumerated type indicating the output format when encoding.</td> 137 </tr> 138 <tr> 139 <td width="100"> </td> 140 <th> 141<a href="../../../nn/jpeg/CTR/PixelFormat.html"><CODE>PixelFormat</CODE></a> 142 </th> 143<td>Enumerated type indicating the pixel format.</td> 144 </tr> 145 <tr> 146 <td width="100"> </td> 147 <th> 148<a href="../../../nn/jpeg/CTR/MpTypeFlag.html"><CODE>MpTypeFlag</CODE></a> 149 </th> 150<td>Flag(s) included in the MP type information.</td> 151 </tr> 152 <tr> 153 <td width="100"> </td> 154 <th> 155<a href="../../../nn/jpeg/CTR/MpTypeDataFormat.html"><CODE>MpTypeDataFormat</CODE></a> 156 </th> 157<td>Data format included in the MP type information.</td> 158 </tr> 159 <tr> 160 <td width="100"> </td> 161 <th> 162<a href="../../../nn/jpeg/CTR/MpTypeCode.html"><CODE>MpTypeCode</CODE></a> 163 </th> 164<td>Type code included in the MP type information.</td> 165 </tr> 166 <tr> 167 <td width="100"> </td> 168 <th> 169<a href="../../../nn/jpeg/CTR/EncoderErrorCode.html">EncoderErrorCode</a> 170 </th> 171<td>Gives the reason why the encoding just performed failed.</td> 172 </tr> 173 <tr> 174 <td width="100"> </td> 175 <th> 176<a href="../../../nn/jpeg/CTR/DecoderErrorCode.html">DecoderErrorCode</a> 177 </th> 178<td>Gives the reason why the decoding or other operation just performed failed.</td> 179 </tr> 180 <tr> 181 <td width="100"> </td> 182 <th> 183<a href="../../../nn/jpeg/CTR/EncoderOption.html">EncoderOption</a> 184 </th> 185<td>Options used when encoding.</td> 186 </tr> 187 <tr> 188 <td width="100"> </td> 189 <th> 190<a href="../../../nn/jpeg/CTR/DecoderOption.html">DecoderOption</a> 191 </th> 192<td>Options used when decoding.</td> 193 </tr> </table> 194 </div> 195 </a> <a name="constant" id="constant"> 196<h2>Constants</h2> 197 <div class="section"> 198 <table class="members"> 199 <tr> 200 <td width="100"> </td> 201 <th> 202<span class="argument"><a href="../../../nn/jpeg/CTR/DATE_TIME_SIZE.html"><CODE>DATE_TIME_SIZE</CODE></a></span> 203 </th> 204<td>Number of bytes in the buffer that stores date and time information. This constant is a string with the format "<CODE>YYYY:MM:DD HH:MM:DD</CODE>" terminated with <CODE>0x00</CODE>, for a total of 20 characters.</td> 205 </tr> 206 <tr> 207 <td width="100"> </td> 208 <th> 209<span class="argument"><a href="../../../nn/jpeg/CTR/IMAGE_UID_SIZE.html"><CODE>IMAGE_UID_SIZE</CODE></a></span> 210 </th> 211<td>Number of bytes in the JPEG's unique image ID. This also represents the number of bytes in one element of the MP format's unique ID list for individual images.</td> 212 </tr> 213 <tr> 214 <td width="100"> </td> 215 <th> 216<span class="argument"><a href="../../../nn/jpeg/CTR/MPF_VERSION_SIZE.html">MPF_VERSION_SIZE</a></span> 217 </th> 218<td>The number of bytes of the MP format version.</td> 219 </tr> 220 <tr> 221 <td width="100"> </td> 222 <th> 223<span class="argument"><a href="../../../nn/jpeg/CTR/MP_ENTRY_SIZE.html"><CODE>MP_ENTRY_SIZE</CODE></a></span> 224 </th> 225<td>This constant represents the number of bytes in one element of an MP-format MP entry. This is not the number of bytes in the <CODE><a href="../../../nn/jpeg/CTR/MpEntry/Overview.html">MpEntry</a></CODE> structure.</td> 226 </tr> 227 <tr> 228 <td width="100"> </td> 229 <th> 230<span class="argument"><a href="../../../nn/jpeg/CTR/GPS_VERSION_ID_SIZE.html">GPS_VERSION_ID_SIZE</a></span> 231 </th> 232<td>The number of bytes of the GPS tag version.</td> 233 </tr> 234 <tr> 235 <td width="100"> </td> 236 <th> 237<span class="argument"><a href="../../../nn/jpeg/CTR/GPS_DATE_STAMP_SIZE.html">GPS_DATE_STAMP_SIZE</a></span> 238 </th> 239<td>The number of bytes in the GPS date stamp.</td> 240 </tr> 241 <tr> 242 <td width="100"> </td> 243 <th> 244<span class="argument"><a href="../../../nn/jpeg/CTR/MIN_DECODER_SHRINK_LEVEL.html"><CODE>MIN_DECODER_SHRINK_LEVEL</CODE></a></span> 245 </th> 246<td>Minimum value that can be specified for the shrink level when shrink decoding.</td> 247 </tr> 248 <tr> 249 <td width="100"> </td> 250 <th> 251<span class="argument"><a href="../../../nn/jpeg/CTR/MAX_DECODER_SHRINK_LEVEL.html"><CODE>MAX_DECODER_SHRINK_LEVEL</CODE></a></span> 252 </th> 253<td>Maximum value that can be specified for the shrink level when shrink decoding.</td> 254 </tr> 255 <tr> 256 <td width="100"> </td> 257 <th> 258<span class="argument"><a href="../../../nn/jpeg/CTR/TWL_PHOTO_MAKER_NOTE_SIZE.html"><CODE>TWL_PHOTO_MAKER_NOTE_SIZE</CODE></a></span> 259 </th> 260<td>The number of bytes in a MakerNote for the Nintendo DSi Camera application.</td> 261 </tr> 262 <tr> 263 <td width="100"> </td> 264 <th> 265<span class="argument"><a href="../../../nn/jpeg/CTR/MAX_DECODER_OUTPUT_BUFFER_WIDTH.html"><CODE>MAX_DECODER_OUTPUT_BUFFER_WIDTH</CODE></a></span> 266 </th> 267<td>Maximum value (number of pixels) that can be specified for the output image buffer width when decoding.</td> 268 </tr> 269 <tr> 270 <td width="100"> </td> 271 <th> 272<span class="argument"><a href="../../../nn/jpeg/CTR/MAX_ENCODER_INPUT_BUFFER_WIDTH.html"><CODE>MAX_ENCODER_INPUT_BUFFER_WIDTH</CODE></a></span> 273 </th> 274<td>Maximum value (number of pixels) that can be specified for the input image buffer width when encoding.</td> 275 </tr> 276 <tr> 277 <td width="100"> </td> 278 <th> 279<span class="argument"><a href="../../../nn/jpeg/CTR/DEFAULT_THUMBNAIL_PIXEL_SAMPLING.html"><CODE>DEFAULT_THUMBNAIL_PIXEL_SAMPLING</CODE></a></span> 280 </th> 281<td>Default thumbnail output format.</td> 282 </tr> 283 <tr> 284 <td width="100"> </td> 285 <th> 286<span class="argument"><a href="../../../nn/jpeg/CTR/DEFAULT_THUMBNAIL_WIDTH.html"><CODE>DEFAULT_THUMBNAIL_WIDTH</CODE></a></span> 287 </th> 288<td>Default thumbnail image width, in pixels.</td> 289 </tr> 290 <tr> 291 <td width="100"> </td> 292 <th> 293<span class="argument"><a href="../../../nn/jpeg/CTR/DEFAULT_THUMBNAIL_HEIGHT.html"><CODE>DEFAULT_THUMBNAIL_HEIGHT</CODE></a></span> 294 </th> 295<td>Default thumbnail image height, in pixels.</td> 296 </tr> </table> 297 </div> 298 </a> 299<h2>Revision History</h2> 300 <div class="section"> 301 <dl class="history"> 302 <dt>2011/04/08</dt> 303<dd>Revised the description of examples of data that fail to decode.<br /> 304 </dd> 305 <dt>2011/03/04</dt> 306<dd>Added information about decodable JPEG and MP-format data<br /> 307 </dd> 308 <dt>2010/10/21</dt> 309<dd>Added descriptions of GpsData, EncoderErrorCode, DecoderErrorCode, EncoderOption, and DecoderOption.<br /> 310 </dd> 311 <dt>2010/04/14</dt> 312<dd>Initial version.<br /> 313 </dd> 314 </dl> 315 </div> 316 <hr><p>CONFIDENTIAL</p></body> 317</html>