NAME

Gnuplot::Builder::Process - gnuplot process manager

SYNOPSIS

    use Gnuplot::Builder::Process;
    
    @Gnuplot::Builder::Process::COMMAND = ("/path/to/gnuplot", "-p");

DESCRIPTION

Gnuplot::Builder::Process class manages gnuplot processes spawned by all Gnuplot::Builder::Script objects.

You can configure its package variables to change its behavior.

The default values for these variables may be changed in future releases.

PACKAGE VARIABLES

@COMMAND

The command and arguments to run a gnuplot process.

By default, it's ("gnuplot", "--persist").

You can also set this variable by the environment variable PERL_GNUPLOT_BUILDER_PROCESS_COMMAND.

$MAX_PROCESSES

Maximum number of gnuplot processes that can run in parallel. If $MAX_PROCESSES <= 0, the number of processes is unlimited.

By default, it's 10.

You can also set this variable by the environment variable PERL_GNUPLOT_BUILDER_PROCESS_MAX_PROCESSES.

$PAUSE_FINISH

If set to true, Gnuplot::Builder sends "pause mouse close" command to the gnuplot process just before finishing the script.

By default, it's 0 (false).

You can also set this variable by the environment variable PERL_GNUPLOT_BUILDER_PROCESS_PAUSE_FINISH.

$TAP

A subroutine reference to tap the IPC with the gnuplot process. This is useful for debugging.

If set, the subroutine reference is called for each event.

    $TAP->($pid, $event, $body)

where $pid is the PID of the gnuplot process, $event is a string describing the event type, and $body is an object describing the event.

Currently $event is always "write", which is called every time some data is written to the gnuplot process. $body is the written string.

To set $TAP from outside the program, use Gnuplot::Builder::Tap.

AUTHOR

Toshio Ito, <toshioito at cpan.org>