pygfx.objects.Points

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

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 appearence 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

Fly controller

Fly controller

Image with Points Overlaid

Image with Points Overlaid

Point Picking

Point Picking

Image Click Events

Image Click Events

Subplots 2

Subplots 2

Map Screen to World

Map Screen to World

Image Material

Image Material

Image on Plane Geometry 1

Image on Plane Geometry 1

Render Text with Qt

Render Text with Qt