FastLED 3.9.15
Loading...
Searching...
No Matches

◆ noiseCylinderCRGB()

CRGB fl::noiseCylinderCRGB ( float angle,
float height,
u32 time,
float radius = 1.0f )

Generate CRGB noise for a cylinder pattern.

Samples three z-slices of 3D Perlin noise to create independent red, green, and blue components (direct RGB, not HSV conversion). Maps the angle around the circumference using sin/cos, and samples height directly.

Parameters
anglePosition around the cylinder (radians, 0 to 2π)
heightVertical position on the cylinder
timeAnimation time parameter
radiusNoise zoom level (level of detail). Larger values = coarser pattern, smaller = more detail (default 1.0)
Returns
CRGB color with 8-bit components

Definition at line 208 of file noise.cpp.hpp.

208 {
209 // Convert cylindrical coordinates to cartesian
210 // angle: azimuth around cylinder (0 to 2π)
211 // height: vertical position (used directly)
212 // x = cos(angle)
213 // y = sin(angle)
214 // z = height
215 float x = fl::cosf(angle);
216 float y = fl::sinf(angle);
217
218 // Map sin/cos values from [-1, 1] to [0, 0xFFFF]
219 // This ensures positive values for uint32_t conversion
220 u32 nx = static_cast<u32>((x + 1.0f) * 0.5f * radius * 0xffff);
221 u32 ny = static_cast<u32>((y + 1.0f) * 0.5f * radius * 0xffff);
222 u32 nz = static_cast<u32>(height * radius * 0xffff);
223
224 // Sample three different t-slices for R, G, B components (direct RGB)
225 // Using offsets 0x0, 0x10000, 0x20000 to separate them in noise space
226 u16 r16_raw = inoise16(nx, ny, nz, time);
227 u16 g16_raw = inoise16(nx, ny, nz, time + 0x10000);
228 u16 b16_raw = inoise16(nx, ny, nz, time + 0x20000);
229
230 // Rescale from observed noise range to full 0-65535 range using global extents
231 u16 r16 = rescaleNoiseValue16(r16_raw);
232 u16 g16 = rescaleNoiseValue16(g16_raw);
233 u16 b16 = rescaleNoiseValue16(b16_raw);
234
235 // Scale down to 8-bit
236 u8 r = fl::int_scale<u16, u8>(r16);
237 u8 g = fl::int_scale<u16, u8>(g16);
238 u8 b = fl::int_scale<u16, u8>(b16);
239
240 return CRGB(r, g, b);
241}
fl::u16 inoise16(fl::u32 x, fl::u32 y, fl::u32 z, fl::u32 t)
unsigned char u8
Definition stdint.h:131
fl::CRGB CRGB
Definition video.h:15
FASTLED_FORCE_INLINE u16 rescaleNoiseValue16(u16 raw_value)
Rescale raw inoise16() output to full 16-bit range [0, 65535] Curries in the global NOISE16_EXTENT_MI...
Definition noise.cpp.hpp:21
fl::u64 time() FL_NOEXCEPT
Alias for millis64() - returns 64-bit millisecond time.
Definition chrono.h:346
u8 u8 height
Definition blur.h:186
float sinf(float value) FL_NOEXCEPT
Definition math.h:352
float cosf(float value) FL_NOEXCEPT
Definition math.h:358

References cosf(), height, inoise16(), rescaleNoiseValue16(), sinf(), time(), x, and y.

+ Here is the call graph for this function: