Visualize images using gnuplot.
gnuplot_plot displays an image as a 3D-plot using gnuplot. If there is an active gnuplot sub-process (started with gnuplot_open_pipe), the image is displayed in a gnuplot window. Otherwise, the image is output to a file, which can be later read by gnuplot. The parameters SamplesX and SamplesY determine the number of data points in the x- and y-direction, respectively, which gnuplot should use to display the image. They are the equivalent of the gnuplot variables samples and isosamples. The parameters ViewRotX und ViewRotZ determine the rotation of the plot with respect to the viewer. ViewRotX is the rotation of the coordinate system about the x-axis, while ViewRotZ is the rotation of the plot about the z-axis. These two parameters correspond directly to the first two parameters of the 'set view' command in gnuplot. The parameter Hidden3D determines whether hidden surfaces should be removed. This is equivalent to the 'set hidden3d' command in gnuplot. If a single image is passed to the operator, it is displayed in a separate plot. If multiple images are passed, they are displayed in the same plot.
At least version 3.2 of gnuplot has to be used because earlier versions are not capable of rendering hidden surfaces.
Image (input_object) |
image -> object |
Image to be plotted. |
SamplesX (input_control) |
integer -> integer |
Number of samples in the x-direction. | |
Default value: 64 | |
Range of values: 2 <= SamplesX <= 10000 | |
Restriction: SamplesX >= 2 |
SamplesY (input_control) |
integer -> integer |
Number of samples in the y-direction. | |
Default value: 64 | |
Range of values: 2 <= SamplesY <= 10000 | |
Restriction: SamplesY >= 2 |
ViewRotX (input_control) |
number -> real / integer |
Rotation of the plot about the x-axis. | |
Default value: 60 | |
Range of values: 0 <= ViewRotX <= 180 | |
Minimum increment: 0.01 | |
Recommended increment: 10 | |
Restriction: (0 <= ViewRotX) && (ViewRotX <= 180) |
ViewRotZ (input_control) |
number -> real / integer |
Rotation of the plot about the z-axis. | |
Default value: 30 | |
Range of values: 0 <= ViewRotZ <= 360 | |
Minimum increment: 0.01 | |
Recommended increment: 10 | |
Restriction: (0 <= ViewRotZ) && (ViewRotZ <= 360) |
Hidden3D (input_control) |
string -> string |
Plot the image with hidden surfaces removed? | |
Default value: 'hidden3d' | |
List of values: 'hidden3d', 'nohidden3d' |
gnuplot_plot returns the value if there is an active gnuplot stream opened with gnuplot_open_pipe or gnuplot_open_file, and if the data file for the current plot could be opened. Otherwise, an exception is raised.
gnuplot_open_pipe, gnuplot_open_file
gnuplot_open_pipe, gnuplot_open_file, gnuplot_close