NAME

Gnuplot::Builder::Wgnuplot - wrap wgnuplot with gnuplot_builder_tempfile_wrapper

SYNOPSIS

    ## use Gnuplot::Builder;         ## instead of Gnuplot::Builder...
    use Gnuplot::Builder::Wgnuplot;  ## use this in Windows interactive session.
    
    my $script = gscript(terminal => "windows");
    $script->plot("sin(x)", "cos(x)");

DESCRIPTION

Gnuplot::Builder::Wgnuplot is a drop-in replacement (or strictly speaking, a wrapper) for Gnuplot::Builder. It loads Gnuplot::Builder and sets

    @Gnuplot::Builder::Process::COMMAND = qw(gnuplot_builder_tempfile_wrapper wgnuplot -persist)

This means it changes the back-end to "wgnuplot" and script text is given to it as a temporary file.

Why Do I Need This?

It seems "wgnuplot" is the only implementation in Windows platform that can handle persistent plot windows correctly.

Use this module if and only if you are on Windows and you want to plot graphs in interactive plot windows (i.e. use "windows" or "wxt" terminals).

CAVEAT

As of gnuplot 4.6, "wgnuplot" has a bug that it turns into a never-ending zombie process if it does not create a plot window.

This means if you call ghelp(), "wgnuplot" process persists even after you close the help window. To terminate the process, you have to use the Task Manager.

FUNCTIONS

Gnuplot::Builder::Wgnuplot exports just the same functions as Gnuplot::Builder.

SEE ALSO

AUTHOR

Toshio Ito, <toshioito at cpan.org>