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