PAPERINFO(3)                                         PAPERINFO(3)


NNAAMMEE
       paperinfo,     paperwithsize,    paperfirst,    paperlast,
       papernext, paperprev - return informations about a paper

SSYYNNOOPPSSYYSS
       ##iinncclluuddee <<ppaappeerr..hh>>

       ccoonnsstt ssttrruucctt ppaappeerr** ppaappeerriinnffoo((ccoonnsstt cchhaarr** ppaappeerrnnaammee))
       ccoonnsstt ssttrruucctt ppaappeerr** ppaappeerrwwiitthhssiizzee((ddoouubbllee ppssww,, ddoouubbllee ppsshh))

       cchhaarr**  ppaappeerrnnaammee((ccoonnsstt ssttrruucctt ppaappeerr**))
       ddoouubbllee ppaappeerrppsswwiiddtthh((ccoonnsstt ssttrruucctt ppaappeerr**))
       ddoouubbllee ppaappeerrppsshheeiiggtthh((ccoonnsstt ssttrruucctt ppaappeerr**))

       ccoonnsstt ssttrruucctt ppaappeerr** ppaappeerrffiirrsstt((vvooiidd))
       ccoonnsstt ssttrruucctt ppaappeerr** ppaappeerrnneexxtt((ccoonnsstt ssttrruucctt ppaappeerr** ppiinnffoo))
       ccoonnsstt ssttrruucctt ppaappeerr** ppaappeerrpprreevv((ccoonnsstt ssttrruucctt ppaappeerr** ppiinnffoo))
       ccoonnsstt ssttrruucctt ppaappeerr** ppaappeerrllaasstt((vvooiidd))

DDEESSCCRRIIPPTTIIOONN
       ppaappeerriinnffoo(()) returns a pointer to a ssttrruucctt ppaappeerr containing
       informations  about  the  paper with name ppaappeerrnnaammee ppaappeerr--
       wwiitthhssiizzee(()) looks for a paper whose width and height is ppssww
       and  ppsshh  in  PostScript points, and return a pointer to a
       ssttrruucctt ppaappeerr corresponding to the paper found.

       ppaappeerrnnaammee(()) returns the name of a paper  described  by  an
       opaque  struct  paper  object  ppaappeerrppsswwiiddtthh(())  returns the
       width, in PostScript points, of a paper  described  by  an
       opaque  struct  paper  object  ppaappeerrppsshheeiigghhtt(()) returns the
       height, in PostScript points, of a paper described  by  an
       opaque struct paper object

       ppaappeerrffiirrsstt(())  and  ppaappeerrllaasstt(())  return  the first and last
       entries for papers.  Iteration from one entry to the  next
       or  the  previous  one  can  be  done with ppaappeerrnneexxtt(()) and
       ppaappeerrpprreevv(()) respectively.

SSEEEE AALLSSOO
       ppaappeerriinniitt(3), ppaappeerrddoonnee(3) ddeeffaauullttppaappeerrnnaammee(3)
       ppaappeerrssiizzee(5)
















                        24 September 1996                       1