/usr/share/doc/plplot-doc/html/api-internal.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Internal C functions in PLplot</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="The PLplot Plotting Library"
HREF="index.html"><LINK
REL="UP"
TITLE=" Reference "
HREF="part_reference.html"><LINK
REL="PREVIOUS"
TITLE="
      plrgb1: Set line color by 8-bit RGB values
    "
HREF="plrgb1.html"><LINK
REL="NEXT"
TITLE="
      plP_getinitdriverlist: Get the initialized-driver
      list
    "
HREF="plp_getinitdriverlist.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="stylesheet.css"></HEAD
><BODY
CLASS="chapter"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The PLplot Plotting Library: Programmer's Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="plrgb1.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="plp_getinitdriverlist.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="chapter"
><H1
><A
NAME="API-Internal"
></A
>Chapter 25. Internal C functions in PLplot</H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="api-internal.html#plP_checkdriverinit"
><CODE
CLASS="function"
>plP_checkdriverinit</CODE
>: Checks to see if any
      of the specified drivers have been initialized</A
></DT
><DT
><A
HREF="plp_getinitdriverlist.html"
><CODE
CLASS="function"
>plP_getinitdriverlist</CODE
>: Get the initialized-driver
      list</A
></DT
></DL
></DIV
><P
>&#13;    The purpose of this chapter is to document the API for every internal 
    C function in PLplot (other than language bindings) that
    is <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>not</I
></SPAN
> part of the common API that has already been
    documented in <A
HREF="api.html"
>Chapter 19</A
> or elsewhere. The functions documented 
    here are internal plplot functions. They are not intended for external use 
    and may change between releases. 
  </P
><P
>&#13;    This chapter is a work that is just starting.  There are many C functions
    in the code base that are not part of the common API, and we haven't even
    gotten to the point of listing them all.  What gets documented here now
    is whatever C-explicit code we are trying to understand at the time.
  </P
><DIV
CLASS="sect1"
><H3
CLASS="sect1"
><A
NAME="plP_checkdriverinit"
><CODE
CLASS="function"
>plP_checkdriverinit</CODE
>: Checks to see if any
      of the specified drivers have been initialized</A
></H3
><P
>&#13;      <DIV
CLASS="funcsynopsis"
><P
></P
><A
NAME="AEN15488"
></A
><TABLE
CLASS="funcprototype"
><TR
><TD
><CODE
CLASS="FUNCDEF"
>&#13;	    plP_checkdriverinit
	  </CODE
>(list);</TD
></TR
></TABLE
><P
></P
></DIV
>
    </P
><P
> Checks to see if any of the specified drivers have been
    initialized. Function tests a space-delimited list of driver names to
    see how many of the given drivers have been initialized, and how often.
    The return code of the function is: <TT
CLASS="literal"
>0</TT
> if no matching
    drivers were found to have been initialized; <TT
CLASS="literal"
>-1</TT
> if
    an error occurred allocating the internal buffer; or, a positive number
    indicating the number of streams encountered that belong to drivers on
    the provided list. This function invokes <A
HREF="plp_getinitdriverlist.html"
><CODE
CLASS="function"
>plP_getinitdriverlist</CODE
></A
>
    internally to get a <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>complete</I
></SPAN
> list of drivers that have been initialized
    in order to compare with the driver names specified in the argument list
    to <A
HREF="api-internal.html#plP_checkdriverinit"
><CODE
CLASS="function"
>plP_checkdriverinit</CODE
></A
>.
    </P
><TABLE
CLASS="variablelist"
><TR
><TD
><DL
><DT
><CODE
CLASS="parameter"
>list</CODE
>
	  (<TT
CLASS="literal"
>char *</TT
>, input)</DT
><DD
><P
>&#13;	    Pointer to character string specifying a space-delimited
	    list of driver names, e.g., <TT
CLASS="literal"
>"bmp jpeg tiff"</TT
>.
	  </P
></DD
></DL
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="plrgb1.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="plp_getinitdriverlist.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><CODE
CLASS="function"
>plrgb1</CODE
>: Set line color by 8-bit RGB values</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="part_reference.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><CODE
CLASS="function"
>plP_getinitdriverlist</CODE
>: Get the initialized-driver
      list</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
plplot-doc 5.9.9-2ubuntu2 / usr / share / doc / plplot-doc / html / api-internal.html
