<!-- 

     This document is part of the libplot distribution, and is covered
     by the GNU GPL, a copy of which is in the file named COPYING inside the
     distribution.

     This program and it's documentation are distributed in the hope that 
     they will be useful,but WITHOUT ANY WARRANTY; without even the implied 
     warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
-->

<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">

<refentry id="plot_stringheight">
<refmeta>
<refentrytitle>plot_stringheight</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>

<refnamediv>
<refname>plot_stringheight</refname>
<refpurpose>determine how many pixels a string will take vertically</refpurpose>
</refnamediv>

<refsynopsisdiv>
<synopsis>
 #include&amp;lt;libmplot.h&amp;gt;
 unsigned int plot_stringheight(plot_state *state, char *string);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>DESCRIPTION</title>
<para>This function determines how many pixels a string will consume in the current font and size.</para>
</refsect1>

<refsect1>
<title>RETURNS</title>
<para>0 on success, -1 otherwise</para>
</refsect1>

<refsect1>
<title>EXAMPLE</title>
<programlisting>
Refer to plot_stringwidth for an example</programlisting>
</refsect1>


<refsect1>
    <title>VERSION</title>
    <para>
This documentation was generated for <command>libplot</command> 0.3 by <command>autodocbook</command> (http://www.stillhq.com).
    </para>
</refsect1>

<refsect1>
    <title>AUTHOR</title>
    <para>
<command>libplot</command> is under development by Michael Still (mikal@stillhq.com). All code is Copyright Michael Still 2002,  and is released under the GNU GPL. Code submissions are welcomed. Contact Michael at the address above if you have something you would like to contribute.
</para>
</refsect1>

<refsect1>
    <title>BUGS</title>
    <para>
There  are no known bugs in <command>libplot</command>. If you find one, please contact mikal@stillhq.com and let me know.
</para>
</refsect1>
</refentry>
