# SPDX-FileCopyrightText: 2020 Gamblor21 # # SPDX-License-Identifier: MIT """ `adafruit_led_animation.animation.volume` ================================================================================ Volume animation for CircuitPython helper library for LED animations. * Author(s): Mark Komus Implementation Notes -------------------- **Hardware:** * `Adafruit NeoPixels `_ * `Adafruit DotStars `_ **Software and Dependencies:** * Adafruit CircuitPython firmware for the supported boards: https://circuitpython.org/downloads """ from adafruit_led_animation.animation import Animation def map_range(x, in_min, in_max, out_min, out_max): """ Maps a number from one range to another. :return: Returns value mapped to new range :rtype: float """ mapped = (x - in_min) * (out_max - out_min) / (in_max - in_min) + out_min if out_min <= out_max: return max(min(mapped, out_max), out_min) return min(max(mapped, out_max), out_min) class Volume(Animation): """ Animate the brightness and number of pixels based on volume. :param pixel_object: The initialised LED object. :param float speed: Animation update speed in seconds, e.g. ``0.1``. :param brightest_color: Color at max volume ``(r, g, b)`` tuple, or ``0x000000`` hex format :param decoder: a MP3Decoder object that the volume will be taken from :param float max_volume: what volume is considered maximum where everything is lit up """ def __init__( self, pixel_object, speed, brightest_color, decoder, max_volume=500, name=None, ): self._decoder = decoder self._num_pixels = len(pixel_object) self._max_volume = max_volume self._brightest_color = brightest_color super().__init__(pixel_object, speed, brightest_color, name=name) def set_brightest_color(self, brightest_color): """ Animate the brightness and number of pixels based on volume. :param brightest_color: Color at max volume ``(r, g, b)`` tuple, or ``0x000000`` hex format """ self._brightest_color = brightest_color def draw(self): red = int( map_range( self._decoder.rms_level, 0, self._max_volume, 0, self._brightest_color[0], ) ) green = int( map_range( self._decoder.rms_level, 0, self._max_volume, 0, self._brightest_color[1], ) ) blue = int( map_range( self._decoder.rms_level, 0, self._max_volume, 0, self._brightest_color[2], ) ) lit_pixels = int( map_range( self._decoder.rms_level, 0, self._max_volume, 0, self._num_pixels, ) ) if lit_pixels > self._num_pixels: lit_pixels = self._num_pixels self.pixel_object[0:lit_pixels] = [(red, green, blue)] * lit_pixels self.pixel_object[lit_pixels : self._num_pixels] = [(0, 0, 0)] * ( self._num_pixels - lit_pixels )