Screen.put_pixel

Screen.put_pixel(x, y, color)

Sets exactly one pixel at (x, y) to the given color — the finest-grained drawing operation Ludic offers. Reach for it when you are plotting individual points such as stars, particles, a scatter of sparks, or hand-drawn curves where a full rectangle would be too coarse. For anything larger than a point prefer Screen.fill_rectangle, since one call per pixel is far more expensive than one call per block. Coordinates are pixels from the top-left of the screen, and out-of-range coordinates are ignored.

Parameters

xthe pixel column, in pixels from the left of the screen

ythe pixel row, in pixels from the top of the screen

colorthe pixel color, e.g. a Color.* name or a 0xRRGGBB literal

Example

program Starfield {
  property Position { column: int = 0, row: int = 0 }
  model Star { Position }

  handler SeedStars phase Start {
    Random.seed(value: 1)
    for spawn_index in 0 .. 40 {
      spawn Star {
        Position {
          column: Random.range(low: 0, high: 255),
          row: Random.range(low: 0, high: 223)
        }
      }
    }
  }

  handler DrawWorld phase Render {
    Screen.clear(Color.MidnightBlue)
    for (Position) in query [Position, {Star}] {
      Screen.put_pixel(x: Position.column, y: Position.row, color: Color.White)
    }
    Screen.show()
  }
}

← All symbols