pladv(3plplot)

pladv3plplot

Advance the (sub-)page

Usage

pladv(page)

Overview

Advances to the next subpage if sub=0, performing a page advance if there are no remaining subpages on the current page. If subpages aren't being used, pladv(3plplot)(0) will always advance the page. If page>0, PLplot switches to the specified subpage. Note that this allows you to overwrite a plot on the specified subpage; if this is not what you intended, use pleop(3plplot) followed by plbop(3plplot) to first advance the page. This routine is called automatically (with page=0) by plenv(3plplot), but if plenv(3plplot) is not used, pladv(3plplot) must be called after initializing PLplot but before defining the viewport.

Redacted form: pladv(page)

This function is used in examples 1, 2, 4, 6-12, 14-18, 20, 21, 23-27, 29, and 31.

Arguments

page (PLINT(3plplot), input)

Specifies the subpage number (starting from 1 in the top left corner and increasing along the rows) to which to advance. Set to zero to advance to the next subpage (or to the next page if subpages are not being used).

Releases

11 releases since Debian 3.1 (Sarge); the text changed 10 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8
  7. 9
  8. 10
  9. 11
  10. 12
  11. 13

Authors

Many developers (who are credited at http://plplot.org/credits.php) have contributed to PLplot over its long history.

From plplot-doc 5.15.0+dfsg2-15 in Debian 13 (Trixie). Parsed by carta from the page's man source.