


PLBOP(3)                    PLplot API                   PLBOP(3)


NAME
       plbop - Begin a new page

SYNOPSIS
       plbop()

DESCRIPTION
       Begins  a  new  page.   For a file driver, the output file is opened if
       necessary.  Advancing the page via pleop(3) and plbop(3) is useful when
       a  page  break  is  desired at a particular point when plotting to sub-
       pages.  Another use for pleop(3) and plbop(3) is when plotting pages to
       different  files,  since  you can manually set the file name by calling
       plsfnam(3) after the call to pleop(3). (In fact some drivers  may  only
       support  a  single page per file, making this a necessity.)  One way to
       handle this case automatically is to page  advance  via  pladv(3),  but
       enable familying (see plsfam(3)) with a small limit on the file size so
       that a new family member file will be created on each page break.

       Redacted form: plbop()

       This function is used in examples 2,20.

AUTHORS
       Geoffrey Furnish and Maurice LeBrun wrote and  maintain  PLplot.   This
       man  page  was  automatically  generated from the DocBook source of the
       PLplot  documentation,  maintained  by  Alan  W.   Irwin   and   Rafael
       Laboissiere.

SEE ALSO
       PLplot documentation at http://plplot.sourceforge.net/resources.



























                          November, 2007                        1


