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.

Note that if you use Gnuplot::Builder::Wgnuplot, you cannot get diagnostic messages from plotting methods such as plot(). This is because "wgnuplot" does not use pipes at all and gnuplot_builder_tempfile_wrapper discards the output in the first place.

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>