<HTML ><HEAD ><TITLE >gnome-paper</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK REL="HOME" TITLE="Gnome Library Reference Manual" HREF="book1.html"><LINK REL="UP" TITLE="Gnome Library" HREF="libgnome.html"><LINK REL="PREVIOUS" TITLE="gnome-mime" HREF="gnome-gnome-mime.html"><LINK REL="NEXT" TITLE="gnome-popt" HREF="gnome-gnome-popt.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TH COLSPAN="4" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="5" >Gnome Library Reference Manual</FONT ></TH ></TR ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnome-gnome-mime.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gnome-gnome-popt.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOME-GNOME-PAPER" >gnome-paper</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN3327" ></A ><H2 >Name</H2 >gnome-paper -- Paper dimensions, printing unit conversions.</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN3330" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> typedef <A HREF="gnome-gnome-paper.html#PAPER" >Paper</A >; typedef <A HREF="gnome-gnome-paper.html#UNIT" >Unit</A >; <GTKDOCLINK HREF="GLIST" >GList</GTKDOCLINK >* <A HREF="gnome-gnome-paper.html#GNOME-PAPER-NAME-LIST" >gnome_paper_name_list</A > (void); const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK >* <A HREF="gnome-gnome-paper.html#GNOME-PAPER-WITH-NAME" >gnome_paper_with_name</A > (const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *papername); const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK >* <A HREF="gnome-gnome-paper.html#GNOME-PAPER-WITH-SIZE" >gnome_paper_with_size</A > (<GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > pswidth, <GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > psheight); const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK >* <A HREF="gnome-gnome-paper.html#GNOME-PAPER-NAME" >gnome_paper_name</A > (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper); <GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-PSWIDTH" >gnome_paper_pswidth</A > (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper); <GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-PSHEIGHT" >gnome_paper_psheight</A > (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper); <GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-LMARGIN" >gnome_paper_lmargin</A > (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper); <GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-TMARGIN" >gnome_paper_tmargin</A > (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper); <GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-RMARGIN" >gnome_paper_rmargin</A > (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper); <GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-BMARGIN" >gnome_paper_bmargin</A > (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper); const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK >* <A HREF="gnome-gnome-paper.html#GNOME-PAPER-NAME-DEFAULT" >gnome_paper_name_default</A > (void); <GTKDOCLINK HREF="GLIST" >GList</GTKDOCLINK >* <A HREF="gnome-gnome-paper.html#GNOME-UNIT-NAME-LIST" >gnome_unit_name_list</A > (void); const <GTKDOCLINK HREF="GNOMEUNIT" >GnomeUnit</GTKDOCLINK >* <A HREF="gnome-gnome-paper.html#GNOME-UNIT-WITH-NAME" >gnome_unit_with_name</A > (const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *unitname); <GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-CONVERT" >gnome_paper_convert</A > (<GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > psvalue, const <GTKDOCLINK HREF="GNOMEUNIT" >GnomeUnit</GTKDOCLINK > *unit); <GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > <A HREF="gnome-gnome-paper.html#GNOME-PAPER-CONVERT-TO-POINTS" >gnome_paper_convert_to_points</A > (<GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > othervalue, const <GTKDOCLINK HREF="GNOMEUNIT" >GnomeUnit</GTKDOCLINK > *unit);</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN3380" ></A ><H2 >Description</H2 ><P >The gnome-paper module provides a way of querying a database of existing paper dimensions, as well as the known or user-configured values for the margins.</P ><P >Support for converting values to and from PostScript points is also supported.</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN3384" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN3386" ></A ><H3 ><A NAME="PAPER" ></A >Paper</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >typedef GnomePaper Paper;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3391" ></A ><H3 ><A NAME="UNIT" ></A >Unit</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >typedef GnomeUnit Unit;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3396" ></A ><H3 ><A NAME="GNOME-PAPER-NAME-LIST" ></A >gnome_paper_name_list ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GLIST" >GList</GTKDOCLINK >* gnome_paper_name_list (void);</PRE ></TD ></TR ></TABLE ><P >grants access to the hardcoded internal list of paper specifications</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3403" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > internal list of paper specifications</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3412" ></A ><H3 ><A NAME="GNOME-PAPER-WITH-NAME" ></A >gnome_paper_with_name ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK >* gnome_paper_with_name (const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *papername);</PRE ></TD ></TR ></TABLE ><P >searches internal list of paper sizes, searching for one with the name 'papername'</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3420" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >papername</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > human name of desired paper type</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification with given name, or NULL</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3433" ></A ><H3 ><A NAME="GNOME-PAPER-WITH-SIZE" ></A >gnome_paper_with_size ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK >* gnome_paper_with_size (<GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > pswidth, <GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > psheight);</PRE ></TD ></TR ></TABLE ><P >create a custom paper type with given dimensions</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3442" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >pswidth</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > width of paper</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >psheight</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > height of paper</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3459" ></A ><H3 ><A NAME="GNOME-PAPER-NAME" ></A >gnome_paper_name ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK >* gnome_paper_name (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3467" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >paper</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > human readable name for paper type</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3480" ></A ><H3 ><A NAME="GNOME-PAPER-PSWIDTH" ></A >gnome_paper_pswidth ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > gnome_paper_pswidth (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper);</PRE ></TD ></TR ></TABLE ><P >returns the width of the paper, including the margins</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3488" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >paper</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > width of paper (in points)</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3501" ></A ><H3 ><A NAME="GNOME-PAPER-PSHEIGHT" ></A >gnome_paper_psheight ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > gnome_paper_psheight (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper);</PRE ></TD ></TR ></TABLE ><P >returns the height of the paper, including the margins</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3509" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >paper</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > height of paper (in points)</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3522" ></A ><H3 ><A NAME="GNOME-PAPER-LMARGIN" ></A >gnome_paper_lmargin ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > gnome_paper_lmargin (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3530" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >paper</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3543" ></A ><H3 ><A NAME="GNOME-PAPER-TMARGIN" ></A >gnome_paper_tmargin ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > gnome_paper_tmargin (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3551" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >paper</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > size of top margin (in points)</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3564" ></A ><H3 ><A NAME="GNOME-PAPER-RMARGIN" ></A >gnome_paper_rmargin ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > gnome_paper_rmargin (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3572" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >paper</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > size of right margin (in points)</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3585" ></A ><H3 ><A NAME="GNOME-PAPER-BMARGIN" ></A >gnome_paper_bmargin ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > gnome_paper_bmargin (const <GTKDOCLINK HREF="GNOMEPAPER" >GnomePaper</GTKDOCLINK > *paper);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3593" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >paper</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > paper specification</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > size of bottom margin (in points)</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3606" ></A ><H3 ><A NAME="GNOME-PAPER-NAME-DEFAULT" ></A >gnome_paper_name_default ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK >* gnome_paper_name_default (void);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3613" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > human readable name for default paper type</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3622" ></A ><H3 ><A NAME="GNOME-UNIT-NAME-LIST" ></A >gnome_unit_name_list ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GLIST" >GList</GTKDOCLINK >* gnome_unit_name_list (void);</PRE ></TD ></TR ></TABLE ><P >grants access to the hardcoded internal list of units</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3629" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > internal list of units</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3638" ></A ><H3 ><A NAME="GNOME-UNIT-WITH-NAME" ></A >gnome_unit_with_name ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const <GTKDOCLINK HREF="GNOMEUNIT" >GnomeUnit</GTKDOCLINK >* gnome_unit_with_name (const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *unitname);</PRE ></TD ></TR ></TABLE ><P >searches internal list of units, searching for one with the name 'unitname'</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3646" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >unitname</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > name of desired unit</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Unit with given name or NULL</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3659" ></A ><H3 ><A NAME="GNOME-PAPER-CONVERT" ></A >gnome_paper_convert ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GDOUBLE" >gdouble</GTKDOCLINK > gnome_paper_convert (<GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > psvalue, const <GTKDOCLINK HREF="GNOMEUNIT" >GnomeUnit</GTKDOCLINK > *unit);</PRE ></TD ></TR ></TABLE ><P >converts from value represented in points to value represented in given units.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3668" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >psvalue</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > value in points</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >unit</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > unit to convert to</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > value in given units</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN3685" ></A ><H3 ><A NAME="GNOME-PAPER-CONVERT-TO-POINTS" ></A >gnome_paper_convert_to_points ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > gnome_paper_convert_to_points (<GTKDOCLINK HREF="DOUBLE" >double</GTKDOCLINK > othervalue, const <GTKDOCLINK HREF="GNOMEUNIT" >GnomeUnit</GTKDOCLINK > *unit);</PRE ></TD ></TR ></TABLE ><P >Needed for gnome-paper-selector. converts from value represented in points to value represented in given units.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3694" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >othervalue</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > value in points</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >unit</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > unit to convert to</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > value in points</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><BR CLEAR="all"><BR><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnome-gnome-mime.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gnome-gnome-popt.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ><TR ><TD COLSPAN="2" ALIGN="left" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >gnome-mime</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >gnome-popt</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >