<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>libgutenprint API Reference: array</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.6 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="classes.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>array</h1>The array is a simple "two-dimensional array of numbers" data structure.
<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct stp_array </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The array opaque data type. <a href="#g26a474575a39c1c36ad520b95aa813b0"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#ga3d385d3e2f248b1c1ac88d5f103e9a2">stp_array_create</a> (int x_size, int y_size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a new array. <a href="#ga3d385d3e2f248b1c1ac88d5f103e9a2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#gafb2573df35220ef9be3f6ba4b8c871b">stp_array_destroy</a> (<a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destroy an array. <a href="#gafb2573df35220ef9be3f6ba4b8c871b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#gaa9bf798890e01b4bbce8cda45615021">stp_array_copy</a> (<a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *dest, const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *source)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy an array. <a href="#gaa9bf798890e01b4bbce8cda45615021"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#gd0b50228ca40df79196197f9c21f4b56">stp_array_create_copy</a> (const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy and allocate an array. <a href="#gd0b50228ca40df79196197f9c21f4b56"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#ge6fb91b246ef5abd388927cb9674503e">stp_array_set_size</a> (<a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array, int x_size, int y_size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Resize an array. <a href="#ge6fb91b246ef5abd388927cb9674503e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#gfe61db801ab3b0326646178e536dd161">stp_array_get_size</a> (const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array, int *x_size, int *y_size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the size of an array. <a href="#gfe61db801ab3b0326646178e536dd161"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#gea0493f5bec9c5c185679adfde3edc9a">stp_array_set_data</a> (<a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array, const double *data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the data in an array. <a href="#gea0493f5bec9c5c185679adfde3edc9a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#ge0d44ee80048189d244b16f231c54b80">stp_array_get_data</a> (const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array, size_t *size, const double **data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the data in an array. <a href="#ge0d44ee80048189d244b16f231c54b80"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#gd6b95b2efd500007b098594826f4467f">stp_array_set_point</a> (<a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array, int x, int y, double data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the data at a single point in the array. <a href="#gd6b95b2efd500007b098594826f4467f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#g9078af984a5e1ec80a6068bdb51c9a6d">stp_array_get_point</a> (const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array, int x, int y, double *data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the data at a single point in the array. <a href="#g9078af984a5e1ec80a6068bdb51c9a6d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="group__sequence.html#g327a46aa1d782a4cd53abf306068e272">stp_sequence_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__array.html#ge05ba5cfe8c03e2435348d6c5488d87e">stp_array_get_sequence</a> (const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> *array)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the underlying stp_sequence_t. <a href="#ge05ba5cfe8c03e2435348d6c5488d87e"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
The array is a simple "two-dimensional array of numbers" data structure.
<p>
array "inherits" from the sequence data structure (implemented via containment). <hr><h2>Typedef Documentation</h2>
<a class="anchor" name="g26a474575a39c1c36ad520b95aa813b0"></a><!-- doxytag: member="array.h::stp_array_t" ref="g26a474575a39c1c36ad520b95aa813b0" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct stp_array <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The array opaque data type.
<p>
</div>
</div><p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="gaa9bf798890e01b4bbce8cda45615021"></a><!-- doxytag: member="array.h::stp_array_copy" ref="gaa9bf798890e01b4bbce8cda45615021" args="(stp_array_t *dest, const stp_array_t *source)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void stp_array_copy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>source</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Copy an array.
<p>
Both dest and source must be valid arrays previously created with <a class="el" href="group__array.html#ga3d385d3e2f248b1c1ac88d5f103e9a2" title="Create a new array.">stp_array_create()</a>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dest</em> </td><td>the destination array. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source</em> </td><td>the source array. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ga3d385d3e2f248b1c1ac88d5f103e9a2"></a><!-- doxytag: member="array.h::stp_array_create" ref="ga3d385d3e2f248b1c1ac88d5f103e9a2" args="(int x_size, int y_size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a>* stp_array_create </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>x_size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>y_size</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a new array.
<p>
The total size of the array will be (x_size * y_size). <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>x_size</em> </td><td>the number of "columns". </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y_size</em> </td><td>the number of "rows". </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the newly created array. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gd0b50228ca40df79196197f9c21f4b56"></a><!-- doxytag: member="array.h::stp_array_create_copy" ref="gd0b50228ca40df79196197f9c21f4b56" args="(const stp_array_t *array)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a>* stp_array_create_copy </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Copy and allocate an array.
<p>
dest will be created, and then the contents of source will be copied into it. dest must not have been previously allocated with <a class="el" href="group__array.html#ga3d385d3e2f248b1c1ac88d5f103e9a2" title="Create a new array.">stp_array_create()</a>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the source array. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the new copy of the array. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gafb2573df35220ef9be3f6ba4b8c871b"></a><!-- doxytag: member="array.h::stp_array_destroy" ref="gafb2573df35220ef9be3f6ba4b8c871b" args="(stp_array_t *array)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void stp_array_destroy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destroy an array.
<p>
It is an error to destroy the array more than once. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to destroy. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ge0d44ee80048189d244b16f231c54b80"></a><!-- doxytag: member="array.h::stp_array_get_data" ref="ge0d44ee80048189d244b16f231c54b80" args="(const stp_array_t *array, size_t *size, const double **data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void stp_array_get_data </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t * </td>
<td class="paramname"> <em>size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double ** </td>
<td class="paramname"> <em>data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the data in an array.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to get the data from. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>size</em> </td><td>the number of elements in the array (x_size * y_size) are stored in the size_t pointed to. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>a pointer to the first element of an array of doubles is stored in a pointer to double*. <div class="fragment"><pre class="fragment"> <a class="code" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0" title="The array opaque data type.">stp_array_t</a> *array;
<span class="keywordtype">size_t</span> size;
<span class="keywordtype">double</span> *data;
<a class="code" href="group__array.html#ge0d44ee80048189d244b16f231c54b80" title="Get the data in an array.">stp_array_get_data</a>(array, &size, &data);
</pre></div> </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="g9078af984a5e1ec80a6068bdb51c9a6d"></a><!-- doxytag: member="array.h::stp_array_get_point" ref="g9078af984a5e1ec80a6068bdb51c9a6d" args="(const stp_array_t *array, int x, int y, double *data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int stp_array_get_point </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double * </td>
<td class="paramname"> <em>data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the data at a single point in the array.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to use. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td>the x location. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>the y location. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>the datum is stored in the double pointed to. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>1 on success, 0 on failure. </dd></dl>
</div>
</div><p>
<a class="anchor" name="ge05ba5cfe8c03e2435348d6c5488d87e"></a><!-- doxytag: member="array.h::stp_array_get_sequence" ref="ge05ba5cfe8c03e2435348d6c5488d87e" args="(const stp_array_t *array)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="group__sequence.html#g327a46aa1d782a4cd53abf306068e272">stp_sequence_t</a>* stp_array_get_sequence </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the underlying stp_sequence_t.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to use. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the (constant) stp_sequence_t. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gfe61db801ab3b0326646178e536dd161"></a><!-- doxytag: member="array.h::stp_array_get_size" ref="gfe61db801ab3b0326646178e536dd161" args="(const stp_array_t *array, int *x_size, int *y_size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void stp_array_get_size </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>x_size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>y_size</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the size of an array.
<p>
The current x and y sizes are stored in the integers pointed to by x_size and y_size. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to get the size of. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>x_size</em> </td><td>a pointer to an integer to store the x size in. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y_size</em> </td><td>a pointer to an integer to store the y size in. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="gea0493f5bec9c5c185679adfde3edc9a"></a><!-- doxytag: member="array.h::stp_array_set_data" ref="gea0493f5bec9c5c185679adfde3edc9a" args="(stp_array_t *array, const double *data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void stp_array_set_data </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double * </td>
<td class="paramname"> <em>data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the data in an array.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>a pointer to the first member of an array containing the data to set. This array must be at least as long as (x_size * y_size). </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="gd6b95b2efd500007b098594826f4467f"></a><!-- doxytag: member="array.h::stp_array_set_point" ref="gd6b95b2efd500007b098594826f4467f" args="(stp_array_t *array, int x, int y, double data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int stp_array_set_point </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"> <em>data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the data at a single point in the array.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to use. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td>the x location. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>the y location. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>the datum to set. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>1 on success, 0 on failure. </dd></dl>
</div>
</div><p>
<a class="anchor" name="ge6fb91b246ef5abd388927cb9674503e"></a><!-- doxytag: member="array.h::stp_array_set_size" ref="ge6fb91b246ef5abd388927cb9674503e" args="(stp_array_t *array, int x_size, int y_size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void stp_array_set_size </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__array.html#g26a474575a39c1c36ad520b95aa813b0">stp_array_t</a> * </td>
<td class="paramname"> <em>array</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>x_size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>y_size</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Resize an array.
<p>
Resizing an array will destroy all data stored in the array. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>array</em> </td><td>the array to resize. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>x_size</em> </td><td>the new number of "columns". </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y_size</em> </td><td>the new number of "rows". </td></tr>
</table>
</dl>
</div>
</div><p>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Tue Aug 10 20:32:51 2010 for libgutenprint API Reference by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
</body>
</html>
