1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> 3<title>FLAC: FLAC__StreamMetadata_Picture Struct Reference</title> 4<link href="doxygen.css" rel="stylesheet" type="text/css"> 5</head><body> 6<!-- Generated by Doxygen 1.4.2 --> 7<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="hierarchy.html">Class Hierarchy</a> | <a class="qindex" href="classes.html">Alphabetical List</a> | <a class="qindex" href="annotated.html">Class List</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Class Members</a> | <a class="qindex" href="globals.html">File Members</a></div> 8<h1>FLAC__StreamMetadata_Picture Struct Reference<br> 9<small> 10[<a class="el" href="group__flac__format.html">FLAC/format.h: format components</a>]</small> 11</h1><code>#include <<a class="el" href="format_8h-source.html">format.h</a>></code> 12<p> 13<a href="structFLAC____StreamMetadata__Picture-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2> 14FLAC PICTURE structure. (See the <a href="../format.html#metadata_block_picture">format specification</a> for the full description of each field.) 15<p> 16<table border="0" cellpadding="0" cellspacing="0"> 17<tr><td></td></tr> 18<tr><td colspan="2"><br><h2>Public Attributes</h2></td></tr> 19<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__flac__format.html#ga114">FLAC__StreamMetadata_Picture_Type</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo0">type</a></td></tr> 20 21<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo1">mime_type</a></td></tr> 22 23<tr><td class="memItemLeft" nowrap align="right" valign="top">FLAC__byte * </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo2">description</a></td></tr> 24 25<tr><td class="memItemLeft" nowrap align="right" valign="top">FLAC__uint32 </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo3">width</a></td></tr> 26 27<tr><td class="memItemLeft" nowrap align="right" valign="top">FLAC__uint32 </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo4">height</a></td></tr> 28 29<tr><td class="memItemLeft" nowrap align="right" valign="top">FLAC__uint32 </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo5">depth</a></td></tr> 30 31<tr><td class="memItemLeft" nowrap align="right" valign="top">FLAC__uint32 </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo6">colors</a></td></tr> 32 33<tr><td class="memItemLeft" nowrap align="right" valign="top">FLAC__uint32 </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo7">data_length</a></td></tr> 34 35<tr><td class="memItemLeft" nowrap align="right" valign="top">FLAC__byte * </td><td class="memItemRight" valign="bottom"><a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo8">data</a></td></tr> 36 37</table> 38<hr><h2>Member Data Documentation</h2> 39<a class="anchor" name="FLAC____StreamMetadata__Pictureo0" doxytag="FLAC__StreamMetadata_Picture::type"></a><p> 40<table class="mdTable" cellpadding="2" cellspacing="0"> 41 <tr> 42 <td class="mdRow"> 43 <table cellpadding="0" cellspacing="0" border="0"> 44 <tr> 45 <td class="md" nowrap valign="top"><a class="el" href="group__flac__format.html#ga114">FLAC__StreamMetadata_Picture_Type</a> <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo0">FLAC__StreamMetadata_Picture::type</a> </td> 46 </tr> 47 </table> 48 </td> 49 </tr> 50</table> 51<table cellspacing="5" cellpadding="0" border="0"> 52 <tr> 53 <td> 54 55 </td> 56 <td> 57 58<p> 59The kind of picture stored. </td> 60 </tr> 61</table> 62<a class="anchor" name="FLAC____StreamMetadata__Pictureo1" doxytag="FLAC__StreamMetadata_Picture::mime_type"></a><p> 63<table class="mdTable" cellpadding="2" cellspacing="0"> 64 <tr> 65 <td class="mdRow"> 66 <table cellpadding="0" cellspacing="0" border="0"> 67 <tr> 68 <td class="md" nowrap valign="top">char* <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo1">FLAC__StreamMetadata_Picture::mime_type</a> </td> 69 </tr> 70 </table> 71 </td> 72 </tr> 73</table> 74<table cellspacing="5" cellpadding="0" border="0"> 75 <tr> 76 <td> 77 78 </td> 79 <td> 80 81<p> 82Picture data's MIME type, in ASCII printable characters 0x20-0x7e, NUL terminated. For best compatibility with players, use picture data of MIME type <code>image/jpeg</code> or <code>image/png</code>. A MIME type of '-->' is also allowed, in which case the picture data should be a complete URL. In file storage, the MIME type is stored as a 32-bit length followed by the ASCII string with no NUL terminator, but is converted to a plain C string in this structure for convenience. </td> 83 </tr> 84</table> 85<a class="anchor" name="FLAC____StreamMetadata__Pictureo2" doxytag="FLAC__StreamMetadata_Picture::description"></a><p> 86<table class="mdTable" cellpadding="2" cellspacing="0"> 87 <tr> 88 <td class="mdRow"> 89 <table cellpadding="0" cellspacing="0" border="0"> 90 <tr> 91 <td class="md" nowrap valign="top">FLAC__byte* <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo2">FLAC__StreamMetadata_Picture::description</a> </td> 92 </tr> 93 </table> 94 </td> 95 </tr> 96</table> 97<table cellspacing="5" cellpadding="0" border="0"> 98 <tr> 99 <td> 100 101 </td> 102 <td> 103 104<p> 105Picture's description in UTF-8, NUL terminated. In file storage, the description is stored as a 32-bit length followed by the UTF-8 string with no NUL terminator, but is converted to a plain C string in this structure for convenience. </td> 106 </tr> 107</table> 108<a class="anchor" name="FLAC____StreamMetadata__Pictureo3" doxytag="FLAC__StreamMetadata_Picture::width"></a><p> 109<table class="mdTable" cellpadding="2" cellspacing="0"> 110 <tr> 111 <td class="mdRow"> 112 <table cellpadding="0" cellspacing="0" border="0"> 113 <tr> 114 <td class="md" nowrap valign="top">FLAC__uint32 <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo3">FLAC__StreamMetadata_Picture::width</a> </td> 115 </tr> 116 </table> 117 </td> 118 </tr> 119</table> 120<table cellspacing="5" cellpadding="0" border="0"> 121 <tr> 122 <td> 123 124 </td> 125 <td> 126 127<p> 128Picture's width in pixels. </td> 129 </tr> 130</table> 131<a class="anchor" name="FLAC____StreamMetadata__Pictureo4" doxytag="FLAC__StreamMetadata_Picture::height"></a><p> 132<table class="mdTable" cellpadding="2" cellspacing="0"> 133 <tr> 134 <td class="mdRow"> 135 <table cellpadding="0" cellspacing="0" border="0"> 136 <tr> 137 <td class="md" nowrap valign="top">FLAC__uint32 <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo4">FLAC__StreamMetadata_Picture::height</a> </td> 138 </tr> 139 </table> 140 </td> 141 </tr> 142</table> 143<table cellspacing="5" cellpadding="0" border="0"> 144 <tr> 145 <td> 146 147 </td> 148 <td> 149 150<p> 151Picture's height in pixels. </td> 152 </tr> 153</table> 154<a class="anchor" name="FLAC____StreamMetadata__Pictureo5" doxytag="FLAC__StreamMetadata_Picture::depth"></a><p> 155<table class="mdTable" cellpadding="2" cellspacing="0"> 156 <tr> 157 <td class="mdRow"> 158 <table cellpadding="0" cellspacing="0" border="0"> 159 <tr> 160 <td class="md" nowrap valign="top">FLAC__uint32 <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo5">FLAC__StreamMetadata_Picture::depth</a> </td> 161 </tr> 162 </table> 163 </td> 164 </tr> 165</table> 166<table cellspacing="5" cellpadding="0" border="0"> 167 <tr> 168 <td> 169 170 </td> 171 <td> 172 173<p> 174Picture's color depth in bits-per-pixel. </td> 175 </tr> 176</table> 177<a class="anchor" name="FLAC____StreamMetadata__Pictureo6" doxytag="FLAC__StreamMetadata_Picture::colors"></a><p> 178<table class="mdTable" cellpadding="2" cellspacing="0"> 179 <tr> 180 <td class="mdRow"> 181 <table cellpadding="0" cellspacing="0" border="0"> 182 <tr> 183 <td class="md" nowrap valign="top">FLAC__uint32 <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo6">FLAC__StreamMetadata_Picture::colors</a> </td> 184 </tr> 185 </table> 186 </td> 187 </tr> 188</table> 189<table cellspacing="5" cellpadding="0" border="0"> 190 <tr> 191 <td> 192 193 </td> 194 <td> 195 196<p> 197For indexed palettes (like GIF), picture's number of colors (the number of palette entries), or <code>0</code> for non-indexed (i.e. 2^depth). </td> 198 </tr> 199</table> 200<a class="anchor" name="FLAC____StreamMetadata__Pictureo7" doxytag="FLAC__StreamMetadata_Picture::data_length"></a><p> 201<table class="mdTable" cellpadding="2" cellspacing="0"> 202 <tr> 203 <td class="mdRow"> 204 <table cellpadding="0" cellspacing="0" border="0"> 205 <tr> 206 <td class="md" nowrap valign="top">FLAC__uint32 <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo7">FLAC__StreamMetadata_Picture::data_length</a> </td> 207 </tr> 208 </table> 209 </td> 210 </tr> 211</table> 212<table cellspacing="5" cellpadding="0" border="0"> 213 <tr> 214 <td> 215 216 </td> 217 <td> 218 219<p> 220Length of binary picture data in bytes. </td> 221 </tr> 222</table> 223<a class="anchor" name="FLAC____StreamMetadata__Pictureo8" doxytag="FLAC__StreamMetadata_Picture::data"></a><p> 224<table class="mdTable" cellpadding="2" cellspacing="0"> 225 <tr> 226 <td class="mdRow"> 227 <table cellpadding="0" cellspacing="0" border="0"> 228 <tr> 229 <td class="md" nowrap valign="top">FLAC__byte* <a class="el" href="structFLAC____StreamMetadata__Picture.html#FLAC____StreamMetadata__Pictureo8">FLAC__StreamMetadata_Picture::data</a> </td> 230 </tr> 231 </table> 232 </td> 233 </tr> 234</table> 235<table cellspacing="5" cellpadding="0" border="0"> 236 <tr> 237 <td> 238 239 </td> 240 <td> 241 242<p> 243Binary picture data. </td> 244 </tr> 245</table> 246<hr>The documentation for this struct was generated from the following file:<ul> 247<li>include/FLAC/<a class="el" href="format_8h-source.html">format.h</a></ul> 248 249<hr size="1"> 250<div class="copyright"> 251 <!-- @@@ oh so hacky --> 252 <table> 253 <tr> 254 <td align="left"> 255 Copyright (c) 2000,2001,2002,2003,2004,2005,2006,2007 Josh Coalson 256 </td> 257 <td width="1%" align="right"> 258 <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=13478&type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a> 259 </td> 260 </tr> 261 </table> 262</div> 263<!-- Copyright (c) 2000,2001,2002,2003,2004,2005,2006,2007 Josh Coalson --> 264<!-- Permission is granted to copy, distribute and/or modify this document --> 265<!-- under the terms of the GNU Free Documentation License, Version 1.1 --> 266<!-- or any later version published by the Free Software Foundation; --> 267<!-- with no invariant sections. --> 268<!-- A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html --> 269</body> 270</html> 271