Updated docu.

This commit is contained in:
Timo Lang
2015-06-08 11:04:50 +02:00
parent 86eb39b3a8
commit 42b6e3af36
202 changed files with 11953 additions and 976 deletions

View File

@@ -102,7 +102,9 @@ Include dependency graph for pixy_frame.c:</div>
<map name="common_2app_2pixy__frame_8c" id="common_2app_2pixy__frame_8c">
<area shape="rect" id="node2" href="pixy__frame_8h.html" title="pixy_frame.h" alt="" coords="131,80,227,107"/><area shape="rect" id="node6" href="pixy_8h.html" title="pixy.h" alt="" coords="269,80,325,107"/><area shape="rect" id="node8" href="tft_8h.html" title="tft.h" alt="" coords="5,155,49,181"/><area shape="rect" id="node5" href="filesystem_8h.html" title="filesystem.h" alt="" coords="125,155,217,181"/><area shape="rect" id="node7" href="pixydefs_8h.html" title="pixydefs.h" alt="" coords="344,155,425,181"/></map>
</div>
</div><table class="memberdecls">
</div>
<p><a href="pixy__frame_8c_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:afb06c0b9c06d1309cf67dcf1a9fc3eef"><td class="memItemLeft" align="right" valign="top">static int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="pixy__frame_8c.html#afb06c0b9c06d1309cf67dcf1a9fc3eef">renderBA81</a> (uint16_t xpos, uint16_t ypos, uint16_t width, uint16_t height, uint32_t frameLen, uint8_t *frame)</td></tr>
@@ -185,6 +187,32 @@ Functions</h2></td></tr>
</table>
</div><div class="memdoc">
<p>Definition at line <a class="el" href="pixy__frame_8c_source.html#l00108">108</a> of file <a class="el" href="pixy__frame_8c_source.html">pixy_frame.c</a>.</p>
<div class="fragment"><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>&#160;{</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>&#160; <span class="keywordflow">if</span> (y &amp; 1) {</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>&#160; <span class="keywordflow">if</span> (x &amp; 1) {</div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>&#160; *r = *pixel;</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>&#160; *g = (*(pixel - 1) + * (pixel + 1) + * (pixel + width) + * (pixel - width)) &gt;&gt; 2;</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>&#160; *b = (*(pixel - width - 1) + * (pixel - width + 1) + * (pixel + width - 1) + * (pixel + width + 1)) &gt;&gt; 2;</div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>&#160; } <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>&#160; *r = (*(pixel - 1) + * (pixel + 1)) &gt;&gt; 1;</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>&#160; *g = *pixel;</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>&#160; *b = (*(pixel - width) + * (pixel + width)) &gt;&gt; 1;</div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>&#160; }</div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>&#160; } <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>&#160; <span class="keywordflow">if</span> (x &amp; 1) {</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>&#160; *r = (*(pixel - width) + * (pixel + width)) &gt;&gt; 1;</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>&#160; *g = *pixel;</div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>&#160; *b = (*(pixel - 1) + * (pixel + 1)) &gt;&gt; 1;</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>&#160; } <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>&#160; *r = (*(pixel - width - 1) + * (pixel - width + 1) + * (pixel + width - 1) + * (pixel + width + 1)) &gt;&gt; 2;</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>&#160; *g = (*(pixel - 1) + * (pixel + 1) + * (pixel + width) + * (pixel - width)) &gt;&gt; 2;</div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>&#160; *b = *pixel;</div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>&#160; }</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>&#160; }</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>&#160;</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>&#160;}</div>
</div><!-- fragment -->
<p><div class="dynheader">
Here is the caller graph for this function:</div>
<div class="dyncontent">
@@ -252,6 +280,60 @@ Here is the caller graph for this function:</div>
</table>
</div><div class="memdoc">
<p>Definition at line <a class="el" href="pixy__frame_8c_source.html#l00139">139</a> of file <a class="el" href="pixy__frame_8c_source.html">pixy_frame.c</a>.</p>
<div class="fragment"><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>&#160;{</div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>&#160; uint16_t x, y;</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>&#160; uint8_t r, g, b;</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>&#160;</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>&#160;</div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>&#160; <span class="comment">// skip first line</span></div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>&#160; frame += width;</div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>&#160;</div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>&#160; <span class="comment">// don&#39;t render top and bottom rows, and left and rightmost columns because of color</span></div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>&#160; <span class="comment">// interpolation</span></div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>&#160; <span class="comment">//uint32_t decodedimage[(width-2)*(height-2)];</span></div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>&#160; uint16_t* decodedimage = malloc(<span class="keyword">sizeof</span>(uint16_t) * (width - 2) * (height - 2));</div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>&#160;</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>&#160; <span class="keywordflow">if</span> (decodedimage == NULL) { <span class="comment">//not enough free space to decode image in memory</span></div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>&#160; <span class="comment">//decode &amp; render image pixel by pixel</span></div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>&#160; <span class="keywordflow">for</span> (y = 1; y &lt; height - 1; y++) {</div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>&#160; frame++;</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>&#160;</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>&#160; <span class="keywordflow">for</span> (x = 1; x &lt; width - 1; x++, frame++) {</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>&#160; <a class="code" href="pixy__frame_8c.html#ac0bb3b512eb46a18bda67293e4453d76">interpolateBayer</a>(width, x, y, frame, &amp;r, &amp;g, &amp;b);</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>&#160; <a class="code" href="group__tft.html#ga82f9b498c57296310f0dfdaa3d7928ac">tft_draw_pixel</a>(xpos + x - 1, ypos + y - 1, <a class="code" href="group__tft.html#ga4a118ad3ee36468a3fa616977a64864e">RGB</a>(r, g, b));</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>&#160; }</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>&#160;</div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>&#160; frame++;</div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>&#160; }</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>&#160; } <span class="keywordflow">else</span> { <span class="comment">//enough space</span></div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>&#160; uint16_t* line = decodedimage;</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>&#160;</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>&#160; <span class="keywordflow">for</span> (y = 1; y &lt; height - 1; y++) {</div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>&#160; <span class="comment">//line = (unsigned int *)img.scanLine(y-1);</span></div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>&#160; frame++;</div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>&#160;</div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>&#160; <span class="keywordflow">for</span> (x = 1; x &lt; width - 1; x++, frame++) {</div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>&#160; <a class="code" href="pixy__frame_8c.html#ac0bb3b512eb46a18bda67293e4453d76">interpolateBayer</a>(width, x, y, frame, &amp;r, &amp;g, &amp;b);</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>&#160; <span class="comment">//*line++ = (0xff&lt;&lt;24) | (r&lt;&lt;16) | (g&lt;&lt;8) | (b&lt;&lt;0);</span></div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>&#160; *line++ = <a class="code" href="group__tft.html#ga4a118ad3ee36468a3fa616977a64864e">RGB</a>(r, g, b);</div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>&#160; }</div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>&#160;</div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>&#160; frame++;</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>&#160; }</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>&#160;</div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>&#160; <a class="code" href="group__tft.html#gab8914c547e697f173306d929ca56988f">tft_draw_bitmap_unscaled</a>(xpos, ypos, width - 2, height - 2, decodedimage);</div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>&#160;</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>&#160; free(decodedimage);</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>&#160; }</div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>&#160;</div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>&#160;}</div>
<div class="ttc" id="group__tft_html_ga4a118ad3ee36468a3fa616977a64864e"><div class="ttname"><a href="group__tft.html#ga4a118ad3ee36468a3fa616977a64864e">RGB</a></div><div class="ttdeci">#define RGB(r, g, b)</div><div class="ttdef"><b>Definition:</b> <a href="tft_8h_source.html#l00048">tft.h:48</a></div></div>
<div class="ttc" id="group__tft_html_gab8914c547e697f173306d929ca56988f"><div class="ttname"><a href="group__tft.html#gab8914c547e697f173306d929ca56988f">tft_draw_bitmap_unscaled</a></div><div class="ttdeci">void tft_draw_bitmap_unscaled(uint16_t x, uint16_t y, uint16_t width, uint16_t height, const uint16_t *dat)</div><div class="ttdef"><b>Definition:</b> <a href="tft_8c_source.html#l00072">tft.c:72</a></div></div>
<div class="ttc" id="pixy__frame_8c_html_ac0bb3b512eb46a18bda67293e4453d76"><div class="ttname"><a href="pixy__frame_8c.html#ac0bb3b512eb46a18bda67293e4453d76">interpolateBayer</a></div><div class="ttdeci">static void interpolateBayer(uint16_t width, uint16_t x, uint16_t y, uint8_t *pixel, uint8_t *r, uint8_t *g, uint8_t *b)</div><div class="ttdef"><b>Definition:</b> <a href="pixy__frame_8c_source.html#l00108">pixy_frame.c:108</a></div></div>
<div class="ttc" id="group__tft_html_ga82f9b498c57296310f0dfdaa3d7928ac"><div class="ttname"><a href="group__tft.html#ga82f9b498c57296310f0dfdaa3d7928ac">tft_draw_pixel</a></div><div class="ttdeci">void tft_draw_pixel(uint16_t x, uint16_t y, uint16_t color)</div><div class="ttdef"><b>Definition:</b> <a href="tft_8c_source.html#l00056">tft.c:56</a></div></div>
</div><!-- fragment -->
<p><div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
@@ -322,6 +404,54 @@ Here is the caller graph for this function:</div>
</table>
</div><div class="memdoc">
<p>Definition at line <a class="el" href="pixy__frame_8c_source.html#l00189">189</a> of file <a class="el" href="pixy__frame_8c_source.html">pixy_frame.c</a>.</p>
<div class="fragment"><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>&#160;{</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>&#160; uint16_t x, y;</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>&#160; uint8_t r, g, b;</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>&#160;</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>&#160; uint32_t fpos = handle-&gt;<a class="code" href="struct_f_i_l_e___h_a_n_d_l_e.html#ae776c66ed7fc6d25948f2bb573ca2198">fpos</a>;</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>&#160; uint32_t row_size_padded = ((width - 2) * 3 + 3) &amp; (~3); <span class="comment">//row size aligned to 4 bytes</span></div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>&#160; uint32_t fpos_end = fpos + row_size_padded * (height - 2);</div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>&#160;</div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>&#160;</div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>&#160; <span class="comment">// skip first line</span></div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>&#160; frame += width;</div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>&#160;</div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>&#160; <span class="comment">// don&#39;t render top and bottom rows, and left and rightmost columns because of color</span></div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>&#160; <span class="comment">// interpolation</span></div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>&#160;</div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>&#160; <span class="keywordflow">for</span> (y = 1; y &lt; height - 1; y++) {</div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>&#160; frame++;</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>&#160; uint8_t rowbuf[row_size_padded];</div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>&#160;</div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>&#160; <span class="comment">//Bitmaps are saved &quot;bottom-up&quot;. Seek to the right row.</span></div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>&#160; <span class="keywordflow">if</span> (<a class="code" href="group__filesystem.html#gac447af479c334caa207d6c279571d8a2">filesystem_file_seek</a>(handle, fpos_end - row_size_padded * y) != <a class="code" href="group__filesystem.html#ggab08f51089a5ddbb470a1a36a9478dda4ab16a72615f8613168ea14797c243fdfd">F_OK</a>) {</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>&#160; }</div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>&#160;</div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>&#160; <span class="keywordflow">for</span> (x = 1; x &lt; width - 1; x++, frame++) {</div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>&#160; <a class="code" href="pixy__frame_8c.html#ac0bb3b512eb46a18bda67293e4453d76">interpolateBayer</a>(width, x, y, frame, &amp;r, &amp;g, &amp;b);</div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>&#160; <span class="comment">//bitmaps are saved in 24bit b,g,r format</span></div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>&#160; rowbuf[(x - 1) * 3] = b;</div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>&#160; rowbuf[(x - 1) * 3 + 1] = g;</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>&#160; rowbuf[(x - 1) * 3 + 2] = r;</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>&#160; }</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>&#160;</div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>&#160; <span class="keywordflow">if</span> (<a class="code" href="group__filesystem.html#gae7124857f3ab32f6032ef129f2a80000">filesystem_file_write</a>(handle, rowbuf, row_size_padded) != <a class="code" href="group__filesystem.html#ggab08f51089a5ddbb470a1a36a9478dda4ab16a72615f8613168ea14797c243fdfd">F_OK</a>) {</div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>&#160; }</div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>&#160;</div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>&#160; frame++;</div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>&#160; }</div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>&#160;</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>&#160;}</div>
<div class="ttc" id="group__filesystem_html_gac447af479c334caa207d6c279571d8a2"><div class="ttname"><a href="group__filesystem.html#gac447af479c334caa207d6c279571d8a2">filesystem_file_seek</a></div><div class="ttdeci">FILE_STATUS filesystem_file_seek(FILE_HANDLE *handle, uint32_t offset)</div><div class="ttdef"><b>Definition:</b> <a href="filesystem_8c_source.html#l00043">filesystem.c:43</a></div></div>
<div class="ttc" id="pixy__frame_8c_html_ac0bb3b512eb46a18bda67293e4453d76"><div class="ttname"><a href="pixy__frame_8c.html#ac0bb3b512eb46a18bda67293e4453d76">interpolateBayer</a></div><div class="ttdeci">static void interpolateBayer(uint16_t width, uint16_t x, uint16_t y, uint8_t *pixel, uint8_t *r, uint8_t *g, uint8_t *b)</div><div class="ttdef"><b>Definition:</b> <a href="pixy__frame_8c_source.html#l00108">pixy_frame.c:108</a></div></div>
<div class="ttc" id="group__filesystem_html_gae7124857f3ab32f6032ef129f2a80000"><div class="ttname"><a href="group__filesystem.html#gae7124857f3ab32f6032ef129f2a80000">filesystem_file_write</a></div><div class="ttdeci">FILE_STATUS filesystem_file_write(FILE_HANDLE *handle, uint8_t *buf, uint32_t size)</div><div class="ttdef"><b>Definition:</b> <a href="filesystem_8c_source.html#l00053">filesystem.c:53</a></div></div>
<div class="ttc" id="struct_f_i_l_e___h_a_n_d_l_e_html_ae776c66ed7fc6d25948f2bb573ca2198"><div class="ttname"><a href="struct_f_i_l_e___h_a_n_d_l_e.html#ae776c66ed7fc6d25948f2bb573ca2198">FILE_HANDLE::fpos</a></div><div class="ttdeci">uint32_t fpos</div><div class="ttdoc">The current byte-position in the file. </div><div class="ttdef"><b>Definition:</b> <a href="filesystem_8h_source.html#l00083">filesystem.h:83</a></div></div>
<div class="ttc" id="group__filesystem_html_ggab08f51089a5ddbb470a1a36a9478dda4ab16a72615f8613168ea14797c243fdfd"><div class="ttname"><a href="group__filesystem.html#ggab08f51089a5ddbb470a1a36a9478dda4ab16a72615f8613168ea14797c243fdfd">F_OK</a></div><div class="ttdoc">Everything ok. </div><div class="ttdef"><b>Definition:</b> <a href="filesystem_8h_source.html#l00091">filesystem.h:91</a></div></div>
</div><!-- fragment -->
<p><div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
@@ -345,7 +475,7 @@ Here is the caller graph for this function:</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Mon Jun 8 2015 01:15:03 for discoverpixy by &#160;<a href="http://www.doxygen.org/index.html">
Generated on Mon Jun 8 2015 11:01:18 for discoverpixy by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.9.1
</small></address>