plot_client 1.4.4

Overview

C++ library to create plots. Point clouds are rendered by an application plot.exe installed via one of dependencis plot_viewer.nupkg. This library is a client library to pass point cloud data to render in the application. Some of rendering configurations including point styles, mesh styles, frame styles can be modified by this library.

Features

• Draw points
• Draw line segments
• Draw polylines
• Draw meshes using arrays of vertex indices
• Configure point size, line thickness, colors and so on

Sample code

Here is sample code to build a plot using class plotclient::plot.

#include <plot_client interface/plot.h>
#include <plot_client interface/plot_exception.h>

/// Point data buffer///
auto num_points = 1000;
auto x = new double[num_points];
auto y = new double[num_points];
auto z = new double[num_points];
auto ref = new double[num_points];

//////////////////////////////////////
// Fill x, y, z and color arrays here
//////////////////////////////////////

try
{
    auto plot = plotclient::plot::create(L"sample points");
    plot->set_points3d(num_points, x, y, z);
    plot->set_colorrefs(ref);

    plot->set_title(L"Num of points: %d", num_points);
    plot->set_frame_ratio(1.0f, 1.0f, 0.5f);
    plot->set_window_size(800, 600);
    plot->build();

}catch (plotclient::plot_exception ex)
{
    // Handle the exception if any.
}

delete[] x;
delete[] y;
delete[] z;
delete[] color;

Note that "plot->build()" internally executes plot.exe which is automatically deployed to the current and output paths. Some other settings are configurable. See the main header "plot.h" to find available settings.

plot viewer quick manual

• R-click & drag : Rotate in 3D
• Ctrl & R-click & drag : Rotate along z direction in 3D
• L-click & drag : Move xyz range
• L-click & drag on color scale: Move color scale range
• Wheel on plot : Scale xyz range
• Wheel on color scale : Scale color scale range
• X & Wheel : Scale x range
• Y & Wheel : Scale y range
• Z & Wheel : Scale z range
• Ctrl & Wheel : Change magnification
• Ctrl & P : Change projection mode
• Ctrl & F : ON and OFF frames
• Ctrl & I : Go back to initial state
• Ctrl & S : Save as a file (.plot is not supported yet)