Introduction

This is a CircuitPython library to perform different effects on text labels.

Dependencies

This driver depends on:

• Adafruit CircuitPython <https://github.com/adafruit/circuitpython>_

Please ensure all dependencies are available on the CircuitPython filesystem.

Usage Example

    from text_animations import TextAnimations
    animations = TextAnimations(display, terminalio.FONT, color=0xFFFFFF)

    # Create a text label
    #text_area = animations.create_text("Fading Text!", x=10, y=30)
    # Set up the fade effect
    #fade_update = animations.fade(text_area, steps=50, delay=0.05, repeat=True)

    # Create a text label
    text_area = animations.create_text("Glitching Text!", x=10, y=30)
    # Set up the glitch effect
    glitch_update = animations.glitch(text_area, steps=50, delay=0.25, pause_cycles=20)

    # Create a text label
    #text_area = animations.create_text("Matrix Effect!", x=10, y=30)
    # Set up the matrix effect
    #matrix_update = animations.matrix(text_area, delay=0.2)

    # Create a text label
    #text_area = animations.create_text("Destroying Text!", x=10, y=30)
    # Set up the destroy effect
    #destroy_update = animations.destroy(text_area, delay=0.1, pause_cycles=20)

    # Create a text label
    #text_area = animations.create_text("Glitching Text!", x=10, y=30)
    # Set up the glitch2 effect with a pause of 20 cycles
    #glitchmore_update = animations.glitchmore(text_area, steps=20, delay=0.1, pause_cycles=20, max_shift=2)

    # Main loop
    while True:
        #fade_update()
        glitch_update()
        #matrix_update()
        #destroy_update()
        #glitchmore_update()

Uncomment / comment as appropriate

There are 5 effects so far:

• fade - this will fade the text in and out in a loop
• matrix - this will create a matrix rain effect to make the text appear and disappear in a loop
• glitch = this will glitch the text to make the text appear and disappear in a loop
• destroy - this will remove / add characters until the text appears and disappears in a loop
• glitchmore - similar to glitch but it also shifts the textbox around the screen Contributing ============

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.