dots

visualife.core.shapes.dots(viewport, id_str, x, y, w, h, r, c, **kwargs)

Draws a dotted pattern.

Draws a dotted pattern; every dot will be placed in a rectangular grid node. The number of dots will be assigned automatically to fill the given h x w rectangle.

Parameters:
  • viewport – viewport for drawing
  • id_str – (string) unique ID string for the group containing grid dots
  • x – (float) X coordinate of the top left corner of the rectangle bounding the dots
  • y – (float) Y coordinate of the top left corner of the rectangle bounding the dots
  • w – (float) width of the bounding rectangle
  • h – (float) height of the bounding rectangle
  • r – radius value(s) to draw circles (value, list(value) or list(list(value))) or even a method (callable) that will return a radius for a given (x,y) coordinates of a dot
  • c – (float or list[float]) color(s) for the circles
  • kwargs – see below
Returns:

None

Keyword Arguments:
 
  • step (value) – grid spacing - separation between circles
  • xstep (value) – vertical grid spacing
  • ystep (value) – horizontal grid spacing

All other arguments are passed to group construction method of the viewer