1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>CAMERA_SetTransferLines</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">CAMERA_SetTransferLines <IMG src="../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <CODE>#include &lt;twl/camera.h&gt;</CODE><BR>
16  <BR>
17  <CODE>void CAMERA_SetTransferLines(int lines);</CODE>
18</DL>
19<H2>Arguments</H2>
20<TABLE border="1" width="100%">
21  <TBODY>
22    <TR>
23      <TD width="13%"><EM><STRONG>lines</STRONG></EM></TD>
24      <TD width="87%">Line count (1&ndash;16)</TD>
25    </TR>
26  </TBODY>
27</TABLE>
28<H2>Return Values</H2>
29<P>None.</P>
30<H2>Description</H2>
31<P>
32Sets the number of lines to transfer to the buffer at once. Configure the amount of data to save in the line buffer so that it does not exceed 1024 pixels (2 KB), which is the capacity of the line buffer.<BR> You can set the number of lines to the value found using <code><a href="CAMERA_GET_MAX_LINES.html">CAMERA_GET_MAX_LINES</a></code>.<br><BR> If there are any odd amounts at the end of a frame, a new DMA will be started synchronously with the start of a camera V-Blank and only the remaining amount will be transferred. Specifically, this is the case for odd amounts at the end when <SPAN class="argument">lines</SPAN> and the height specified by a <code><A href="CAMERA_I2CSize.html">CAMERA_I2CSize*</A></code> function or the <code><A href="CAMERA_SetTrimmingParams.html">CAMERA_SetTrimmingParams</A></code> function are not divisible.<BR><BR>This function must be called before the <A href="CAMERA_Start.html"><CODE>CAMERA_Start</CODE></A> or <A href="CAMERA_StartCapture.html"><CODE>CAMERA_StartCapture</CODE></A> function is used to start capturing.
33</P>
34<H2>See Also</H2>
35<P><CODE><A href="CAMERA_Start.html">CAMERA_Start</A>, <A href="CAMERA_StartCapture.html">CAMERA_StartCapture</A></CODE></P>
36<H2>Revision History</H2>
37<P>
382008/09/11 Added an explanation for the line count to set. <br>2007/11/14 Added a description about transferring odd amounts. <BR>2007/10/29 Added descriptions. <BR>2007/10/02 Initial version.</P>
39<hr><p>CONFIDENTIAL</p></body>
40</HTML>
41