__init__ (version 0.0.5)

index
/media/pi/PI4_TT/unicornhathd2/__init__.py

Unicorn HAT HD library 2.
 
Drive the 16x16 RGB pixel Pimoroni Unicorn HAT HD
over SPI from a Raspberry Pi or compatible platform.
Using the two chip selectors

 
Modules

      

 

colorsys

numpy

spidev

time

 
Classes

      

 

  • Display

 
class Display

   

Represents a single display in a multi-display chain.
 
Contains the coordinates for the slice of the pixel buffer
which should be visible on this particular display.
 

 

Methods defined here:

  • __init__(self, enabled, x, y, rotation)
  • Initialise display.
     
    :param enabled: True/False to indicate if this display is enabled
    :param x: x offset of display portion in buffer
    :param y: y offset of display portion in buffer
    :param rotation: rotation of display
  • get_buffer_window(self, source)
  • Grab the correct portion of the supplied buffer for this display.
     
    :param source: source buffer, should be a numpy array
  • update(self, x, y, rotation)
  • Update display position.
     
    :param x: x offset of display portion in buffer
    :param y: y offset of display portion in buffer
    :param rotation: rotation of display

 
Functions

      

 

  • brightness(b)
  • Set the display brightness between 0.0 and 1.0.
     
    :param b: Brightness from 0.0 to 1.0 (default 0.5)
  • clear()
  • Clear the buffer.
  • enable_addressing(enabled=True)
  • Enable multi-panel addressing support (for Ubercorn).
  • enable_display(address, enabled=True)
  • Enable a single display in the chain.
     
    :param address: address of the display from 0 to 7
    :param enabled: True/False to indicate display is enabled
  • get_pixel(x, y)
  • Get pixel colour in RGB as a tuple.
     
    :param x: Horizontal position from 0 to 15
    :param y: Veritcal position from 0 to 15
  • get_pixels()
  • Return entire buffer.
  • get_rotation()
  • Return the display rotation in degrees.
  • get_shape()
  • Return the shape (width, height) of the display.
  • off()
  • Clear the buffer and immediately update Unicorn HAT HD.
     
    Turns off all pixels.
  • rotation(r)
  • Set the display rotation in degrees.
     
    Actual rotation will be snapped to the nearest 90 degrees.
  • set_all(r, g, b)
  • Set all pixels to RGB colour.
     
    :param r: Amount of red from 0 to 255
    :param g: Amount of green from 0 to 255
    :param b: Amount of blue from 0 to 255
  • set_pixel(x, y, r, g, b)
  • Set a single pixel to RGB colour.
     
    :param x: Horizontal position from 0 to 15
    :param y: Veritcal position from 0 to 15
    :param r: Amount of red from 0 to 255
    :param g: Amount of green from 0 to 255
    :param b: Amount of blue from 0 to 255
  • set_pixel_hsv(x, y, h, s=1.0, v=1.0)
  • Set a single pixel to a colour using HSV.
     
    :param x: Horizontal position from 0 to 15
    :param y: Veritcal position from 0 to 15
    :param h: Hue from 0.0 to 1.0 ( IE: degrees around hue wheel/360.0 )
    :param s: Saturation from 0.0 to 1.0
    :param v: Value (also known as brightness) from 0.0 to 1.0
  • setup(address=0)
  • Initialize Unicorn HAT HD.
  • setup_buffer(width, height)
  • Set up the internal pixel buffer.
     
    :param width: width of buffer, ideally in multiples of 16
    :param height: height of buffer, ideally in multiples of 16
  • setup_display(address, x, y, rotation)
  • Configure a single display in the chain.
     
    :param x: x offset of display portion in buffer
    :param y: y offset of display portion in buffer
    :param rotation: rotation of display
  • shade_pixels(shader)
  • Set all pixels to a colour determined by a shader function.
     
    :param shader: function that accepts x/y position and returns an r,g,b tuple.
  • show()
  • Output the contents of the buffer to Unicorn HAT HD.

 
Data

      

 

HEIGHT = 16
PANEL_SHAPE = (16, 16)
WIDTH = 16
__version__ = '0.0.5'
is_setup = False