Point Cloud Settings¶

This notebook demonstrates how to configure point cloud material properties in the Potree viewer, including point size types, shapes, and colors.

In [ ]:

# %pip install anymap-ts

# %pip install anymap-ts

In [ ]:

from anymap_ts import PotreeViewer

from anymap_ts import PotreeViewer

Point Size Types¶

Potree supports three point size types:

• fixed: Constant screen-space size regardless of distance
• attenuated: Size decreases with distance (perspective)
• adaptive: Automatically adjusts based on point density

In [ ]:

viewer = PotreeViewer(height="600px", point_budget=1_000_000)
viewer

viewer = PotreeViewer(height="600px", point_budget=1_000_000) viewer

In [ ]:

url = "https://potree.github.io/potree/pointclouds/lion_takanawa/cloud.js"
viewer.load_point_cloud(
    url=url,
    name="lion_adaptive",
    point_size=1.0,
    point_size_type="adaptive",
    shape="circle",
)

url = "https://potree.github.io/potree/pointclouds/lion_takanawa/cloud.js" viewer.load_point_cloud( url=url, name="lion_adaptive", point_size=1.0, point_size_type="adaptive", shape="circle", )

Point Shapes¶

Potree supports three point shapes:

• square: Fastest rendering
• circle: Smooth round points
• paraboloid: 3D shading effect for depth perception

In [ ]:

viewer2 = PotreeViewer(height="600px", point_budget=1_000_000)
viewer2

viewer2 = PotreeViewer(height="600px", point_budget=1_000_000) viewer2

In [ ]:

viewer2.load_point_cloud(
    url=url,
    name="lion_paraboloid",
    point_size=2.0,
    point_size_type="fixed",
    shape="paraboloid",
)

viewer2.load_point_cloud( url=url, name="lion_paraboloid", point_size=2.0, point_size_type="fixed", shape="paraboloid", )

Adjusting Point Size¶

Change the global point size for all loaded point clouds.

In [ ]:

viewer.set_point_size(2.0)

viewer.set_point_size(2.0)

In [ ]:

viewer.set_point_size(0.5)

viewer.set_point_size(0.5)

Point Budget¶

The point budget controls how many points are rendered at once. Higher values show more detail but require more GPU memory.

In [ ]:

viewer.set_point_budget(500_000)  # Lower budget for performance

viewer.set_point_budget(500_000) # Lower budget for performance

In [ ]:

viewer.set_point_budget(3_000_000)  # Higher budget for detail

viewer.set_point_budget(3_000_000) # Higher budget for detail

Eye Dome Lighting (EDL)¶

EDL improves depth perception by adding shading based on neighboring point depths.

In [ ]:

# Strong EDL effect
viewer.set_edl(enabled=True, radius=2.0, strength=0.8)

# Strong EDL effect viewer.set_edl(enabled=True, radius=2.0, strength=0.8)

In [ ]:

# Subtle EDL effect
viewer.set_edl(enabled=True, radius=1.0, strength=0.2)

# Subtle EDL effect viewer.set_edl(enabled=True, radius=1.0, strength=0.2)

In [ ]:

# Disable EDL
viewer.set_edl(enabled=False)

# Disable EDL viewer.set_edl(enabled=False)

Background Colors¶

In [ ]:

viewer.set_background("#1a1a2e")  # Dark blue

viewer.set_background("#1a1a2e") # Dark blue

In [ ]:

viewer.set_background("#ffffff")  # White

viewer.set_background("#ffffff") # White

In [ ]:

viewer.set_background("#000000")  # Black (default)

viewer.set_background("#000000") # Black (default)