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
       subpages.  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                        PLBOP(3)
