Screenshots

Polyscope includes simple functionality for saving screenshots from the current camera view to disk. The ImGUI interface windows will be automatically hidden when taking a screenshot.

Screenshots can be taken manually by pressing the [screenshot] button in the options GUI window, or programmatically using the functions below. Clicking the GUI button generates a numbered screenshot file in the current directory; the arrow to the side of the button can be used to adjust file format and transparency settings for these screenshots.

It is not necessary to call polyscope::show() before taking screenshots. You can set up you scene and programmatically configure the camera view, then call polyscope::screenshot() to save a rendered image to disk, all without any user interaction.

Example: Register a mesh, position the camera, and take a screenshot

#include "polyscope/polyscope.h"
#include "polyscope/surface_mesh.h"

// Initialize Polyscope
polyscope::init();

// Register your mesh with Polyscope
polyscope::registerSurfaceMesh("input mesh", /* your verts */, /* your faces */);

// Position the camera
polyscope::view::lookAt(glm::vec3{10., 10., 0.}, glm::vec3{0., 2., 0.});

// Adjust some screenshot default settings if you'd like
polyscope::screenshotExtension = ".jpg";

// Take a screenshot
// It will be written to your current directory as screenshot_000000.jpg, etc
polyscope::screenshot();

void screenshot(bool transparentBG = true)

numbered screenshot

Saves a screenshot to the current directory, with file named like screenshot_000000.png, numbered automatically in increasing order. The numbering is reset to 0 for each run of the program; existing files will be silently overwritten.

If transparentBG is true, the background will be rendered as transparent, and set as transparency alpha in the saved image if the file format supports it.

std::string options::screenshotExtension

screenshot extension

Set the extension used when taking automatically-numbered screenshots, either with screenshot() or by clicking the GUI button.

The extension should be .png, or .jpg.

void screenshot(std::string filename, bool transparentBG = true)

named screenshot

Saves a screenshot to the path given as filename, with format inferred from the file extension.

The extension should be .png, or .jpg.

If transparentBG is true, the background will be rendered as transparent.

std::vector<unsigned char> screenshotToBuffer(bool transparentBG = true)

screenshot to buffer

Take a screenshot from the current view and return it as a buffer. The dimensions are view::bufferWidth * view::bufferHeight, with entries RGBA at 1 byte each.

If transparentBG is true, the background will be rendered as transparent.