Skip to content

Points

Points 

Points(
    positions: Transform | Buffer,
    sizes: Transform | Buffer | float,
    fill_colors: Transform | Buffer | Color,
    line_colors: Transform | Buffer | Color,
    line_widths: Transform | Buffer | float,
)

Points are discs with a given size (diameter) and posses a surface that can be filled and stroked. They always face the viewer such that their rendered shape is a disc, independentely of any transform.

IN/OUT variables 
// Rendering stage 1
in uniform vec4 viewport;                    // in("viewport")
in attribute [ vec2 | vec3 ] positions;      // in("positions")
in [ attribute | uniform ] float sizes;      // in("sizes")
in [ attribute | uniform ] vec4 fill_colors; // in("fill_colors")
in [ attribute | uniform ] vec4 line_colors; // in("line_colors")
in [ attribute | uniform ] vec4 line_widths; // in("line_widths")

// Rendering stage 2
out attribute vec3 screen;              // out("screen[positions]")

// Rendering stage 3
out attribute float sizes;             // out("sizes")
out attribute vec4  fill_colors;       // out("fill_colors")
out attribute vec4  line_colors;       // out("line_colors")
out attribute float line_widths;       // out("line_widths")
Example 
1
2
3
4
5
6
positions = core.Buffer(3, np.dtype(np.float32))
points = visual.Points(positions,
                       sizes=5.0,
                       fill_colors=(0,0,0,1),
                       line_colors=(0,0,0,0),
                       line_widths=0.0)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
1. COMMAND
     - METHOD: "core.Buffer" (str)
     - COMMAND_ID: 1 (int)
     - TIMESTAMP: 2025-03-18T15:02:33.991912 (datetime)
   PARAMETERS
     - OBJECT_ID: 1 (int)
     - COUNT: 3 (int)
     - DTYPE: float32 (dtype)
     - DATA: None (memoryview | bytes)

2. COMMAND
     - METHOD: "visual.Points" (str)
     - COMMAND_ID: 2 (int)
     - TIMESTAMP: 2025-03-18T15:02:33.992013 (datetime)
   PARAMETERS
     - OBJECT_ID: 2 (int)
     - POSITIONS_ID: 1 (Transform | Buffer)
     - SIZES: 5.0 (Transform | Buffer | float)
     - FILL_COLORS: Color(r=0, g=0, b=0, a=1) (converted) (Transform | Buffer | Color)
     - LINE_COLORS: Color(r=0, g=0, b=0, a=0) (converted) (Transform | Buffer | Color)
     - LINE_WIDTHS: 0.0 (Transform | Buffer | float)


 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
  "jsonrpc": "2.0",
  "commands": [
    {
      "method": "core.Buffer",
      "id": 1,
      "timestamp": 1742306553.991912,
      "parameters": {
        "id": 1,
        "count": 3,
        "dtype": "float32",
        "data": null
      }
    },
    {
      "method": "visual.Points",
      "id": 2,
      "timestamp": 1742306553.992013,
      "parameters": {
        "id": 2,
        "positions(id)": 1,
        "sizes": 5.0,
        "fill_colors": [
          0,
          0,
          0,
          1
        ],
        "line_colors": [
          0,
          0,
          0,
          0
        ],
        "line_widths": 0.0
      }
    }
  ]
}

Create a visual of n points at given positions with given sizes, flll_colors., line_colors and line_widths.

Parameters:

Name Type Description Default
positions Transform | Buffer

Points position (vec3)

 required
sizes Transform | Buffer | Measure

Point sizes (float)

 required
fill_colors Transform | Buffer | Color

Points fill colors (vec4)

 required
line_colors Transform | Buffer | Color

Points line colors (vec4)

 required
line_widths Transform | Buffer | Measure

Points line colors (vec4)

 required

render 

render(
    viewport: Viewport,
    model: Matrix = None,
    view: Matrix = None,
    proj: Matrix = None,
)

Render the visual on viewport using the given model, view, proj matrices

Parameters:

Name Type Description Default
viewport Viewport

Viewport where to render the visual

 required
model Matrix

Model matrix to use for rendering

 None
view Matrix

View matrix to use for rendering

 None
proj Matrix

Projection matrix to use for rendering

 None