Replaces all filled cells in the quadrille with the specified value — empty cells are untouched: the exact complement of fill(value), which touches only empties. Chained, they two-tone a board totally: q.replace(red).fill(green) turns every filled cell red and every empty cell green. Returns the quadrille (chainable).

Example#

(click or press any key to toggle between replacing cells and resetting)

Quadrille.cellLength = 40;
let quadrille;
let replaced = false;

function setup() {  
  createCanvas(400, 400);
  reset();  
}  

function draw() {  
  background('black');  
  drawQuadrille(quadrille);  
}  

function mouseClicked() {
  replaced = !replaced;
  replaced ? quadrille.replace('🐛') : reset();
}  

function keyPressed() {  
  replaced = !replaced;
  replaced ? quadrille.replace('🙈') : reset();
}  

function reset() {  
  quadrille = createQuadrille(10, 10, 25, color('red'));
  quadrille.rand(25, color('lime')).rand(25, color('blue'));  
}  

Like fill(value), a non-factory value is stored as one shared instance across all replaced cells — see the identity note there: it is what makes the replaced region strict-searchable and floodable as one.

Syntax#

replace(value)

Parameters#