HALCON Reference Manual 10.0.2

gnuplot_plot_imagegnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImage (Operator)

Name

gnuplot_plot_imagegnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImage — Visualize images using gnuplot.

Signature

gnuplot_plot_image(Image : : GnuplotFileID, SamplesX, SamplesY, ViewRotX, ViewRotZ, Hidden3D : )

gnuplot_plot_imagegnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImage displays an image as a 3D-plot using gnuplot. If there is an active gnuplot sub-process (started with gnuplot_open_pipegnuplot_open_pipegnuplot_open_pipeGnuplotOpenPipeGnuplotOpenPipe), the image is displayed in a gnuplot window. Otherwise, the image is output to a file, which can be later read by gnuplot. In both cases the gnuplot output stream is identified by GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileID. The parameters SamplesXSamplesXSamplesXSamplesXsamplesX and SamplesYSamplesYSamplesYSamplesYsamplesY 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 ViewRotXViewRotXViewRotXViewRotXviewRotX and ViewRotZViewRotZViewRotZViewRotZviewRotZ determine the rotation of the plot with respect to the viewer. ViewRotXViewRotXViewRotXViewRotXviewRotX is the rotation of the coordinate system about the x-axis, while ViewRotZViewRotZViewRotZViewRotZviewRotZ 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 Hidden3DHidden3DHidden3DHidden3Dhidden3D 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.

Parallelization

Multithreading type: exclusive (runs in parallel only with independent operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

ImageImageImageImageimage (input_object) image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Image to be plotted.

GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileID (input_control) gnuplot_id → (integer)

Identifier for the gnuplot output stream.

SamplesXSamplesXSamplesXSamplesXsamplesX (input_control) integer → (integer)

Number of samples in the x-direction.

Default value: 64

Typical range of values: 2 ≤ SamplesX SamplesX SamplesX SamplesX samplesX ≤ 10000

Restriction: SamplesX >= 2

SamplesYSamplesYSamplesYSamplesYsamplesY (input_control) integer → (integer)

Number of samples in the y-direction.

Default value: 64

Typical range of values: 2 ≤ SamplesY SamplesY SamplesY SamplesY samplesY ≤ 10000

Restriction: SamplesY >= 2

ViewRotXViewRotXViewRotXViewRotXviewRotX (input_control) number → (real / integer)

Rotation of the plot about the x-axis.

Default value: 60

Typical range of values: 0 ≤ ViewRotX ViewRotX ViewRotX ViewRotX viewRotX ≤ 180

Minimum increment: 0.01

Recommended increment: 10

Restriction: (0 <= ViewRotX) && (ViewRotX <= 180)

ViewRotZViewRotZViewRotZViewRotZviewRotZ (input_control) number → (real / integer)

Rotation of the plot about the z-axis.

Default value: 30

Typical range of values: 0 ≤ ViewRotZ ViewRotZ ViewRotZ ViewRotZ viewRotZ ≤ 360

Minimum increment: 0.01

Recommended increment: 10

Restriction: (0 <= ViewRotZ) && (ViewRotZ <= 360)

Hidden3DHidden3DHidden3DHidden3Dhidden3D (input_control) string → (string)

Plot the image with hidden surfaces removed.

Default value: 'hidden3d' "hidden3d" "hidden3d" "hidden3d" "hidden3d"

List of values: 'hidden3d'"hidden3d""hidden3d""hidden3d""hidden3d", 'nohidden3d'"nohidden3d""nohidden3d""nohidden3d""nohidden3d"

Result

gnuplot_plot_imagegnuplot_plot_imagegnuplot_plot_imageGnuplotPlotImageGnuplotPlotImage returns the value if GnuplotFileIDGnuplotFileIDGnuplotFileIDGnuplotFileIDgnuplotFileID is a valid gnuplot output stream, and if the data file for the current plot could be opened. Otherwise, an exception is raised.