---
name: "plcpstrm"
section: "3plplot"
platform: "linux"
package: "plplot-doc"
version: "5.15.0+dfsg2-15"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/plcpstrm"
---

# plcpstrm(3plplot)

Copy state parameters from the reference stream to the current stream

## NAME

**plcpstrm** - Copy state parameters from the reference stream to the current stream

## SYNOPSIS

**plcpstrm**(*iplsr*, *flags*)

## DESCRIPTION

Copies state parameters from the reference stream to the current stream. Tell driver interface to map device coordinates unless *flags* == 1.

This function is used for making save files of selected plots (e.g. from the TK driver).  After initializing, you can get a copy of the current plot to the specified device by switching to this stream and issuing a [**plcpstrm**(3plplot)](/plcpstrm/3plplot.md) and a [**plreplot**(3plplot)](/plreplot/3plplot.md), with calls to [**plbop**(3plplot)](/plbop/3plplot.md) and [**pleop**(3plplot)](/pleop/3plplot.md) as appropriate.  The plot buffer must have previously been enabled (done automatically by some display drivers, such as X).

Redacted form: **plcpstrm(iplsr, flags)**

This function is used in example 1,20.

## ARGUMENTS

- *iplsr* (**PLINT**(3plplot), input)

  Number of reference stream.

- *flags* (**PLBOOL**(3plplot), input)

  If *flags* is set to true the device coordinates are not copied from the reference to current stream.

## AUTHORS

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

## SEE ALSO

PLplot documentation at http://plplot.org/documentation.php.