Ground and Shadows
The Polyscope scene view includes a ground plane which optionally supports reflection and soft-shadow effects. This section outlines the various modes and options available for the ground plane.
Ground plane and shadow modes
noneno ground plane, nor reflection/shadows are shown
tilea tiled ground plane
tile_reflectiona tiled ground plane with a reflection of the scene (default)
shadow_onlya transparent ground plane with a soft vertical shadow of the scene
The ground plane and shadow settings can also be manually adjusted in the GUI under the
[Appearance] --> [Ground Plane] menu.
Example: adjust the ground plane & shadow appearance
import polyscope as ps ps.init() # set soft shadows on the ground ps.set_ground_plane_mode("shadow_only") # set +Z as up direction ps.set_ground_plane_height_factor(-0.25) # adjust the plane height ps.set_shadow_darkness(0.1) # lighter shadows # ... load your mesh, point cloud, etc ... # take screenshot from the current camera view, which will have transparent shadows ps.screenshot("test_image.png", True); # open the GUI ps.show(3)
Set the mode used for the ground plane, as described above. Should be one of
Some more details: the ground plane is automatically faded away whenever the scene is viewed from underneath the ground, and also faded away in the distance far from the scene, as determined by the scene bounding box. Shadows are properly transparent, exporting a screenshot with transparency will set
alpha = shadow_darkness values for shadowed areas, and set
alpha=0 for unshadowed parts of the ground plane.
shadow_darkness parameters below adjust the visual appearance of soft shadows for the ground plane mode
The number of blur iterations used to blur soft shadows. Increase to make the shadows more fuzzy.
How dark the shadows are.
0 is totally transparent (white), and
1 is fully black. When taking screenshots with transparency, these will become alpha transparency values for the shadowed regions.
Ground plane positioning
The orientation of the ground plane is determined by the up direction for the scene, which can be set along any of the coordinate directions such as
The height of the ground plane is set by default from the bounding box of the scene. The
options::groundPlaneHeightFactor can be set to adjust the relative offset of the ground plane from the bounding box.
The offset of the ground plane from the bottom of the bounding box for the scene. Use postive/negative values to shift the ground plane up/down.
This parameter is a scaled value. By default, values will be interpreted relative to the scene length scale, whereas calling
set_ground_plane_height_factor(0.1, is_relative=False) will specify a value in absolute units.