fill_2dnoise8()

void fill_2dnoise8	(	CRGB *	leds,
		int	width,
		int	height,
		bool	serpentine,
		uint8_t	octaves,
		uint16_t	x,
		int	xscale,
		uint16_t	y,
		int	yscale,
		uint16_t	time,
		uint8_t	hue_octaves,
		uint16_t	hue_x,
		int	hue_xscale,
		uint16_t	hue_y,
		uint16_t	hue_yscale,
		uint16_t	hue_time,
		bool	blend )

Fill an LED matrix with random colors, using 8-bit noise.

Parameters

leds	pointer to LED array
width	the width of the LED matrix
height	the height of the LED matrix
serpentine	whether the matrix is laid out in a serpentine pattern (alternating left/right directions per row)
octaves	the number of octaves to use for value (brightness) noise
x	x-axis coordinate on noise map for value (brightness) noise
xscale	the scale (distance) between x points when filling in value (brightness) noise
y	y-axis coordinate on noise map for value (brightness) noise
yscale	the scale (distance) between y points when filling in value (brightness) noise
time	the time position for the value (brightness) noise field
hue_octaves	the number of octaves to use for color hue noise
hue_x	x-axis coordinate on noise map for color hue noise
hue_xscale	the scale (distance) between x points when filling in color hue noise
hue_y	y-axis coordinate on noise map for color hue noise.
hue_yscale	the scale (distance) between y points when filling in color hue noise
hue_time	the time position for the color hue noise field
blend	if true, will blend the newly generated LED values into the array. If false, will overwrite the array values directly.

Definition at line 898 of file noise.cpp.

                                                                                                                                   {
  const size_t array_size = (size_t)height * width;
  if (array_size <= 0) return;
  FASTLED_STACK_ARRAY(uint8_t, V, array_size);
  FASTLED_STACK_ARRAY(uint8_t, H, array_size);
 
  memset(V,0,height*width);
  memset(H,0,height*width);
 
  fill_raw_2dnoise8((uint8_t*)V,width,height,octaves,x,xscale,y,yscale,time);
  fill_raw_2dnoise8((uint8_t*)H,width,height,hue_octaves,hue_x,hue_xscale,hue_y,hue_yscale,hue_time);
 
  int w1 = width-1;
  int h1 = height-1;
  for(int i = 0; i < height; ++i) {
    int wb = i*width;
    for(int j = 0; j < width; ++j) {
      CRGB led(CHSV(H[(h1-i)*width + (w1-j)], 255, V[i*width + j]));
 
      int pos = j;
      if(serpentine && (i & 0x1)) {
        pos = w1-j;
      }
 
      if(blend) {
        // Safer blending to avoid potential undefined behavior
        CRGB temp = leds[wb+pos];
        temp.nscale8(128); // Scale by 50%
        led.nscale8(128);
        leds[wb+pos] = temp + led;
      } else {
        leds[wb+pos] = led;
      }
    }
  }
}

References blend(), FASTLED_STACK_ARRAY, fill_raw_2dnoise8(), hue_octaves, hue_time, leds, CRGB::nscale8(), octaves, pos, x, xscale, y, and yscale.

Here is the call graph for this function: