pygfx.objects.Points

class pygfx.objects.Points(geometry=None, material=None, *, visible=True, render_order=0, render_mask='auto', name='')

Bases: WorldObject

A point cloud.

An object consisting of points represented by vertices (3D positions).

The picking info of a Points object (the result of renderer.get_pick_info()) will for most materials include vertex_index (int) and point_coord (tuple of 2 float coordinates in logical pixels).

Parameters:
  • geometry (Geometry) – The data defining the shape of the object.

  • material (Material) – The data defining the appearance of the object.

  • visible (bool) – Whether the object is visible.

  • render_order (int) – The render order (when applicable for the renderer’s blend mode).

  • render_mask (str) – Determines the render passes that the object is rendered in. It’s recommended to let the renderer decide, using “auto”.

  • position (Vector) – The position of the object in the world. Default (0, 0, 0).

Examples

Rendering Points

Rendering Points

Point Picking

Point Picking

Simulating grass with point sprites

Simulating grass with point sprites

Image with Points Overlaid

Image with Points Overlaid

Fly controller

Fly controller

Camera linking 2

Camera linking 2

Camera linking 1

Camera linking 1

Image Click Events

Image Click Events

Subplots 2

Subplots 2

Map Screen to World

Map Screen to World

Text align

Text align

Point Markers with Multiple Colors

Point Markers with Multiple Colors

Image Material

Image Material

Image on Plane Geometry 1

Image on Plane Geometry 1

Points with different sizes

Points with different sizes

Text justification

Text justification

Points drawn with different size_space

Points drawn with different size_space

Points with different markers

Points with different markers