#pragma once /* A sparse path through an xy grid. When a value is set != 0, it will get stored in the sparse grid. The raster will only store the values that are set, and will not allocate memory for the entire grid. This is useful for large grids where only a small number of pixels are set. */ #include "fl/stdint.h" #include "fl/int.h" #include "fl/geometry.h" #include "fl/grid.h" #include "fl/hash_map.h" #include "fl/map.h" #include "fl/namespace.h" #include "fl/span.h" #include "fl/tile2x2.h" #include "fl/xymap.h" FASTLED_NAMESPACE_BEGIN struct CRGB; FASTLED_NAMESPACE_END #ifndef FASTLED_RASTER_SPARSE_INLINED_COUNT #define FASTLED_RASTER_SPARSE_INLINED_COUNT 128 #endif namespace fl { class XYMap; class Gradient; class Tile2x2_u8; class Leds; // A raster of u8 values. This is a sparse raster, meaning that it will // only store the values that are set. class XYRasterU8Sparse { public: XYRasterU8Sparse() = default; XYRasterU8Sparse(int width, int height) { setBounds(rect(0, 0, width, height)); } XYRasterU8Sparse(const XYRasterU8Sparse &) = default; XYRasterU8Sparse &operator=(XYRasterU8Sparse &&) = default; XYRasterU8Sparse(XYRasterU8Sparse &&) = default; XYRasterU8Sparse &operator=(const XYRasterU8Sparse &) = default; XYRasterU8Sparse &reset() { mSparseGrid.clear(); mCache.clear(); return *this; } XYRasterU8Sparse &clear() { return reset(); } // Rasterizes point with a value For best visual results, you'll want to // rasterize tile2x2 tiles, which are generated for you by the XYPathRenderer // to represent sub pixel / neightbor splatting positions along a path. // TODO: Bring the math from XYPathRenderer::at_subpixel(float alpha) // into a general purpose function. void rasterize(const vec2 &pt, u8 value) { // Turn it into a Tile2x2_u8 tile and see if we can cache it. write(pt, value); } void setSize(u16 width, u16 height) { setBounds(rect(0, 0, width, height)); } void setBounds(const rect &bounds) { mAbsoluteBounds = bounds; mAbsoluteBoundsSet = true; } using iterator = fl::HashMap, u8>::iterator; using const_iterator = fl::HashMap, u8>::const_iterator; iterator begin() { return mSparseGrid.begin(); } const_iterator begin() const { return mSparseGrid.begin(); } iterator end() { return mSparseGrid.end(); } const_iterator end() const { return mSparseGrid.end(); } fl::size size() const { return mSparseGrid.size(); } bool empty() const { return mSparseGrid.empty(); } void rasterize(const span &tiles); void rasterize(const Tile2x2_u8 &tile) { rasterize_internal(tile); } void rasterize_internal(const Tile2x2_u8 &tile, const rect *optional_bounds = nullptr); // Renders the subpixel tiles to the raster. Any previous data is // cleared. Memory will only be allocated if the size of the raster // increased. void rasterize(const Slice &tiles); // u8 &at(u16 x, u16 y) { return mGrid.at(x, y); } // const u8 &at(u16 x, u16 y) const { return mGrid.at(x, // y); } pair at(u16 x, u16 y) const { const u8 *val = mSparseGrid.find_value(vec2(x, y)); if (val != nullptr) { return {true, *val}; } return {false, 0}; } rect bounds() const { if (mAbsoluteBoundsSet) { return mAbsoluteBounds; } return bounds_pixels(); } rect bounds_pixels() const { u16 min_x = 0; bool min_x_set = false; u16 min_y = 0; bool min_y_set = false; u16 max_x = 0; bool max_x_set = false; u16 max_y = 0; bool max_y_set = false; for (const auto &it : mSparseGrid) { const vec2 &pt = it.first; if (!min_x_set || pt.x < min_x) { min_x = pt.x; min_x_set = true; } if (!min_y_set || pt.y < min_y) { min_y = pt.y; min_y_set = true; } if (!max_x_set || pt.x > max_x) { max_x = pt.x; max_x_set = true; } if (!max_y_set || pt.y > max_y) { max_y = pt.y; max_y_set = true; } } return rect(min_x, min_y, max_x + 1, max_y + 1); } // Warning! - SLOW. u16 width() const { return bounds().width(); } u16 height() const { return bounds().height(); } void draw(const CRGB &color, const XYMap &xymap, CRGB *out); void draw(const CRGB &color, Leds *leds); void drawGradient(const Gradient &gradient, const XYMap &xymap, CRGB *out); void drawGradient(const Gradient &gradient, Leds *leds); // Inlined, yet customizable drawing access. This will only send you // pixels that are within the bounds of the XYMap. template void draw(const XYMap &xymap, XYVisitor &visitor) { for (const auto &it : mSparseGrid) { auto pt = it.first; if (!xymap.has(pt.x, pt.y)) { continue; } u32 index = xymap(pt.x, pt.y); u8 value = it.second; if (value > 0) { // Something wrote here. visitor.draw(pt, index, value); } } } static const int kMaxCacheSize = 8; // Max size for tiny cache. void write(const vec2 &pt, u8 value) { // FASTLED_WARN("write: " << pt.x << "," << pt.y << " value: " << // value); mSparseGrid.insert(pt, value); u8 **cached = mCache.find_value(pt); if (cached) { u8 *val = *cached; if (*val < value) { *val = value; } return; } if (mCache.size() <= kMaxCacheSize) { // cache it. u8 *v = mSparseGrid.find_value(pt); if (v == nullptr) { // FASTLED_WARN("write: " << pt.x << "," << pt.y << " value: " // << value); if (mSparseGrid.needs_rehash()) { // mSparseGrid is about to rehash, so we need to clear the // small cache because it shares pointers. mCache.clear(); } mSparseGrid.insert(pt, value); return; } mCache.insert(pt, v); if (*v < value) { *v = value; } return; } else { // overflow, clear cache and write directly. mCache.clear(); mSparseGrid.insert(pt, value); return; } } private: using Key = vec2; using Value = u8; using HashKey = Hash; using EqualToKey = EqualTo; using FastHashKey = FastHash; using HashMapLarge = fl::HashMap; HashMapLarge mSparseGrid; // Small cache for the last N writes to help performance. HashMap, u8 *, FastHashKey, EqualToKey, kMaxCacheSize> mCache; fl::rect mAbsoluteBounds; bool mAbsoluteBoundsSet = false; }; } // namespace fl namespace fl { // A raster of CRGB values. This is a sparse raster, meaning that it will // only store the values that are set. class XYRasterSparse_CRGB { public: XYRasterSparse_CRGB() = default; XYRasterSparse_CRGB(u16 width, u16 height) { setBounds(rect(0, 0, width, height)); } XYRasterSparse_CRGB(const XYRasterSparse_CRGB &) = default; XYRasterSparse_CRGB &operator=(XYRasterSparse_CRGB &&) = default; XYRasterSparse_CRGB(XYRasterSparse_CRGB &&) = default; XYRasterSparse_CRGB &operator=(XYRasterSparse_CRGB &) = default; XYRasterSparse_CRGB &reset() { mSparseGrid.clear(); mCache.clear(); return *this; } XYRasterSparse_CRGB &clear() { return reset(); } // Rasterizes point with a CRGB color value void rasterize(const vec2 &pt, const CRGB &color) { write(pt, color); } void setSize(u16 width, u16 height) { setBounds(rect(0, 0, width, height)); } void setBounds(const rect &bounds) { mAbsoluteBounds = bounds; mAbsoluteBoundsSet = true; } using iterator = fl::HashMap, CRGB>::iterator; using const_iterator = fl::HashMap, CRGB>::const_iterator; iterator begin() { return mSparseGrid.begin(); } const_iterator begin() const { return mSparseGrid.begin(); } iterator end() { return mSparseGrid.end(); } const_iterator end() const { return mSparseGrid.end(); } fl::size size() const { return mSparseGrid.size(); } bool empty() const { return mSparseGrid.empty(); } pair at(u16 x, u16 y) const { const CRGB *val = mSparseGrid.find_value(vec2(x, y)); if (val != nullptr) { return {true, *val}; } return {false, CRGB::Black}; } rect bounds() const { if (mAbsoluteBoundsSet) { return mAbsoluteBounds; } return bounds_pixels(); } rect bounds_pixels() const { u16 min_x = 0; bool min_x_set = false; u16 min_y = 0; bool min_y_set = false; u16 max_x = 0; bool max_x_set = false; u16 max_y = 0; bool max_y_set = false; for (const auto &it : mSparseGrid) { const vec2 &pt = it.first; if (!min_x_set || pt.x < min_x) { min_x = pt.x; min_x_set = true; } if (!min_y_set || pt.y < min_y) { min_y = pt.y; min_y_set = true; } if (!max_x_set || pt.x > max_x) { max_x = pt.x; max_x_set = true; } if (!max_y_set || pt.y > max_y) { max_y = pt.y; max_y_set = true; } } return rect(min_x, min_y, max_x + 1, max_y + 1); } // Warning! - SLOW. u16 width() const { return bounds().width(); } u16 height() const { return bounds().height(); } void draw(const XYMap &xymap, CRGB *out); void draw(Leds *leds); // Inlined, yet customizable drawing access. This will only send you // pixels that are within the bounds of the XYMap. template void draw(const XYMap &xymap, XYVisitor &visitor) { for (const auto &it : mSparseGrid) { auto pt = it.first; if (!xymap.has(pt.x, pt.y)) { continue; } u32 index = xymap(pt.x, pt.y); const CRGB &color = it.second; // Only draw non-black pixels (since black represents "no data") if (color.r != 0 || color.g != 0 || color.b != 0) { visitor.draw(pt, index, color); } } } static const int kMaxCacheSize = 8; // Max size for tiny cache. void write(const vec2 &pt, const CRGB &color) { CRGB **cached = mCache.find_value(pt); if (cached) { CRGB *val = *cached; // For CRGB, we'll replace the existing color (blend could be added later) *val = color; return; } if (mCache.size() <= kMaxCacheSize) { // cache it. CRGB *v = mSparseGrid.find_value(pt); if (v == nullptr) { if (mSparseGrid.needs_rehash()) { // mSparseGrid is about to rehash, so we need to clear the // small cache because it shares pointers. mCache.clear(); } mSparseGrid.insert(pt, color); return; } mCache.insert(pt, v); *v = color; return; } else { // overflow, clear cache and write directly. mCache.clear(); mSparseGrid.insert(pt, color); return; } } private: using Key = vec2; using Value = CRGB; using HashKey = Hash; using EqualToKey = EqualTo; using FastHashKey = FastHash; using HashMapLarge = fl::HashMap; HashMapLarge mSparseGrid; // Small cache for the last N writes to help performance. HashMap, CRGB *, FastHashKey, EqualToKey, kMaxCacheSize> mCache; fl::rect mAbsoluteBounds; bool mAbsoluteBoundsSet = false; }; } // namespace fl