Get led code
From Just in Time
<source lang='cpp'> /**
* A data structure for a sparse representation of values in a LED string. * * A non-sparse representation of an LED string holds 3 bytes for every * LED in the string. For a 60 LED string this means that at least 180 bytes * of memory are required. * * This type also has a buffer of bytes, but these bytes hold sequences of * the form: * <jump>, <count>, G1, R1, B1, G2, R2, B2, <jump>, <count>, G3, R3, B3, etc... * * <jump> represents an amount of black pixels, <count> is the number of GRB values * that follow * * A buffer is terminated by a zero <jump> value or a zero <count>. The first <jump> * never terminates the sequence, even if it is zero. A zero <jump> count at the start * means the string starts with a lit LED. */
template<uint8_t buffer_size, uint8_t led_string_size> struct sparse_leds { uint8_t buffer[buffer_size];
/// move the range [begin, end> towards buffer_end. /// buffer_end must be higher than end, for this function to work correctly. /// The bytes that become available are filled with zeros. static void move_right( uint8_t *begin, uint8_t *end, uint8_t *buffer_end) { while (begin < end) *(--buffer_end) = *(--end); while( begin < buffer_end) *(--buffer_end) = 0; } };
/**
* specialization of the led_buffer_traits for sparse buffers. * * For regular arrays, the led string size is simply the number of bytes * divided by three. A sparse buffer has the number of leds encoded in the * type as a template argument. */
template< uint8_t buffer_size, uint8_t led_string_size> struct led_buffer_traits<sparse_leds<buffer_size, led_string_size> > { static const uint8_t count = led_string_size; static const uint8_t size = buffer_size; };
/**
* clear a sparse buffer. This fills the buffer with as many * black leds as there are leds in the string. */
template<uint8_t buffer_size, uint8_t led_string_size> inline void clear( sparse_leds<buffer_size, led_string_size> &leds) { leds.buffer[0] = led_string_size; leds.buffer[1] = 0; }
/**
* Given a sparse buffer and a position in the LED string, find the position in * the buffer that corresponds with this LED. If such a position did not exist, it * will be created by introducing a new block inside the buffer or by appending * a location for the LED at the start or end of an existing block. * * This function assumes that the current buffer already covers the complete LED * string, or in other words, the sum of all <jump> and <count> values must be higher * than the argument 'position' to this function. This function makes sure that * the sum of <jump>s and <count>s remains the same. * * This function is deliberately not implemented as an operator[] of sparse_leds, because * using an explicit function call makes it clear that code is being run and that it is * worthwhile to store the result of this function instead of calling the function twice. * Measurements have shown that the compiler will not memoize a second call to this function with * the same arguments. */
template<uint8_t buffer_size, uint8_t led_string_size> rgb & get( sparse_leds<buffer_size, led_string_size> &leds, uint8_t position) {
uint8_t *buffer_iterator = &leds.buffer[0]; uint8_t * const end = buffer_iterator + buffer_size; uint8_t current_pos = 0; while (buffer_iterator < end) { // current_pos pointing one past the previous block // buffer_iterator pointing at a 'jump'
uint8_t jump_pos = current_pos + *buffer_iterator; if (jump_pos > position + 1) { // need to add a new block before the one we're pointing at. *buffer_iterator = (jump_pos - position - 1); leds.move_right( buffer_iterator, end - 5, end); *buffer_iterator++ = position - current_pos; *buffer_iterator++=1; break; } current_pos = jump_pos; // current_pos now pointing at the location of the first led in the block if (current_pos == position + 1) { // prepend the new led to the current block of leds --(*buffer_iterator); ++buffer_iterator; ++*buffer_iterator; ++buffer_iterator; leds.move_right( buffer_iterator, end-3, end); break; } ++buffer_iterator; // pointing at the led block size jump_pos = position - current_pos; if ( jump_pos < *buffer_iterator) { // we're actually pointing to a led that is inside the current block buffer_iterator += (1 + 3 * jump_pos); break; } current_pos += *buffer_iterator; // pointing one past the last led in the string. jump_pos = 3 * (*buffer_iterator) + 1; //buffer_iterator += 3 * (*buffer_iterator); if (position == current_pos) { // decrease distance between this block and the next by one if (--(*(buffer_iterator+jump_pos)) == 0) { // distance is zero, concatenate two blocks.
// new size is the old size plus the size of the next block plus // 1 for the new led. *buffer_iterator += *(buffer_iterator + jump_pos + 1)+1; buffer_iterator += jump_pos; leds.move_right( buffer_iterator, end - 1, end); } else { // distance is non-zero, just enlarge the current block ++*buffer_iterator; buffer_iterator += jump_pos; leds.move_right( buffer_iterator, end - 3, end); } break; } buffer_iterator+=jump_pos; }
return *(reinterpret_cast<rgb *>(buffer_iterator)); } </source>