ppd_get_page_length(3) [debian man page]

ppd_get_page_length(3)					     Library Functions Manual					    ppd_get_page_length(3)

NAME

       ppd_get_page_length, ppd_get_page_size, ppd_get_page_width - set of functions for retrieving the page dimension from a PPD file.

SYNOPSIS

       #include <ppd.h>

       float ppd_get_page_length(PpdFile *ppd, const char *name);

       PpdSize *ppd_get_page_size(PpdFile *ppd, const char *name);

       float ppd_get_page_width(PpdFile *ppd, const char *name);

DESCRIPTION

       These function provide the programmer with a means of querying the dimensions of a given page layout within a PPD file.	All three function
       accept two parameters as input.	The first is a pointer to a valid PpdFile structure (see ppd_file_new(3)), and the second if the  name	of
       the page layout to be queried.

RETURN VALUE

       ppd_get_page_length()
	      Returns the page length for a given layout

       ppd_get_page_size()
	      Returns a pointer to the page size record for the given size

       ppd_get_page_width()
	      Returns the page width for a given layout

SEE ALSO

       ppd_file_new(3), ppd_emit_to_file(3), ppd_file_free(3), ppd_find_choice(3), ppd_check_option_is_marked(3), ppd_get_num_conflicts(3)

AUTHOR

       This  man  page	was  written  by  Gerald  Carter  <gcarter@valinux.com>.  It  was  updated by Mark Fasheh <mfasheh@valinux.com> to reflect
       changes in libppd 0.5.  Some  of  the code  was originally part of the Common UNIX Printing System (CUPS).

															    ppd_get_page_length(3)

ppd_check_option_is_marked(3)				     Library Functions Manual				     ppd_check_option_is_marked(3)

NAME

       ppd_check_option_is_marked,  ppd_mark_defaults,	ppd_mark_option - a set of functions for determining the current status of PPD options and
       selecting them.

SYNOPSIS

       #include <ppd.h>

       gboolean ppd_check_option_is_marked (PpdFile *ppd, const char *keyword, const char *option);

       gint ppd_mark_option(PpdFile *ppd, const char *option, const char *choice);

       void ppd_mark_defaults (PpdFile *ppd);

DESCRIPTION

       These three functions are used to query the marked status of an option in a PPD file as well as forcing an option to be selected.

   ppd_check_option_is_marked(PpdFile *ppd, const char *option, const char *choice);
       ppd_check_option_is_marked() accepts three parameters as input. The first is the PpdFile pointer to a PPD file obtained by calling  one	of
       the ppd_load(3) functions.  The second parameter is the option of the keyword name.  The final input parameter is the actual choice name.

   ppd_mark_option(PpdFile *ppd, const char *option, const char *choice);
       ppd_mark_option	allows	the  programmer  to  manually select an option in a PPD file.  The parameters are the a valid PpdFile pointer (see
       ppd_file_new(3)), the option name, and the choice name.

   void ppd_mark_defaults (PpdFile *ppd);
       ppd_mark_defaults() resets all the default options in the PPD file specified by the PpdFile pointer (see ppd_file_new(3)).

RETURN VALUE

       ppd_check_option_is_marked()
	      FALSE if the option is not currently selected and TRUE is it marked

       ppd_mark_option()
	      Always returns 0.  The only means of  determining  whether  or  not  the	function  succeeded  is  to  make  a  subsequent  call	to
	      ppd_check_option_is_marked() on the same option.

SEE ALSO

       ppd_file_new(3), ppd_emit_to_file(3), ppd_file_free(3), ppd_find_choice(3), ppd_get_num_conflicts(3), ppd_get_page_length(3)

AUTHOR

       This  man  page was written by Gerald Carter <gcarter@valinux.com>.  It was updated by Mark Fasheh <mfasheh@valinux.com> to reflect changes
       in libppd 0.5.  Some of the code was originally part of the Common UNIX Printing System (CUPS).

														     ppd_check_option_is_marked(3)