### Example: hello.py

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/building.html

A basic example demonstrating initialization and displaying 'Hello' on the screen.

```python
import gc9a01
import framebuf
import time

from machine import Pin, SPI

# Display configuration (example for ESP32-S3-LCD-1.28)
spi = SPI(1, baudrate=32000000, polarity=0, phase=0, sck=Pin(10), mosi=Pin(11), miso=Pin(12))
display = gc9a01.GC9A01(spi, dc=Pin(9), reset=Pin(8), bl=Pin(7), rotation=0)

# Placeholder for actual 'Hello' display logic
# display.fill(gc9a01.BLACK)
# display.text("Hello", 50, 60, gc9a01.WHITE)

print("Hello example placeholder.")

```

--------------------------------

### Example: hello_world.py

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/building.html

A basic example demonstrating initialization and displaying 'Hello World!' on the screen.

```python
import gc9a01
import framebuf
import time

from machine import Pin, SPI

# Display configuration (example for ESP32-S3-LCD-1.28)
spi = SPI(1, baudrate=32000000, polarity=0, phase=0, sck=Pin(10), mosi=Pin(11), miso=Pin(12))
display = gc9a01.GC9A01(spi, dc=Pin(9), reset=Pin(8), bl=Pin(7), rotation=0)

# Placeholder for actual 'Hello World!' display logic
# display.fill(gc9a01.BLACK)
# display.text("Hello World!", 10, 60, gc9a01.WHITE)

print("Hello World example placeholder.")

```

--------------------------------

### Example: hello_world.py

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/configs.html

A standard introductory example script to display 'Hello, World!' on the GC9A01 display.

```python
import gc9a01
import time

# Assuming display is initialized elsewhere
# display = gc9a01.GC9A01(spi, dc, reset, ...) 

# Example usage (conceptual):
# display.fill(gc9a01.BLACK)
# display.text("Hello, World!", 20, 60, gc9a01.GREEN)
# display.show() # Or equivalent to update display

print("hello_world.py example: Standard 'Hello, World!' display.")

```

--------------------------------

### Example: hello_world.py

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/utils/image_converter.html

A Python example script for displaying 'Hello, World!' on the GC9A01 display.

```Python
# examples/hello_world.py
# 'Hello, World!' display example
```

--------------------------------

### Example: hello.py

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/configs.html

A basic example script to display 'Hello' or a similar greeting on the GC9A01 display.

```python
import gc9a01
import time

# Assuming display is initialized elsewhere
# display = gc9a01.GC9A01(spi, dc, reset, ...) 

# Example usage (conceptual):
# display.fill(gc9a01.BLUE)
# display.text("Hello", 50, 100, gc9a01.WHITE)
# display.show() # Or equivalent to update display

print("hello.py example: Basic 'Hello' message display.")

```

--------------------------------

### Example: hello.py

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/utils/image_converter.html

A basic Python example script to display 'Hello' text on the GC9A01 display.

```Python
# examples/hello.py
# Basic 'Hello' display example
```

--------------------------------

### GC9A01 Hello World Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/sphinx/examples/hello_world.rst

This example writes "Hello World" in random colors at random locations, split across two GC9A01 displays connected to a Raspberry Pi Pico. It showcases basic display output and random generation capabilities.

```python
import random
import time

from machine import Pin, SPI
import gc9a01

# --- Configuration ---
# SPI Bus
spi = SPI(0, baudrate=40000000, miso=Pin(16), mosi=Pin(19), sck=Pin(18))

# GC9A01 Pins
# TFT_RESET = 20
# TFT_DC = 21
# TFT_CS = 17

# TFT_BL = 22 # Backlight control (optional)

# --- Initialize Displays ---
# Display 1
tft1 = gc9a01.GC9A01(
    spi,
    dc=Pin(21),
    cs=Pin(17),
    reset=Pin(20),
    rotation=0, # Adjust rotation as needed
    width=240,
    height=240,
    buffer_size=10240 # Adjust buffer size if needed
)

# Display 2 (assuming similar setup, adjust pins if different)
tft2 = gc9a01.GC9A01(
    spi,
    dc=Pin(15), # Example: different DC pin for second display
    cs=Pin(14), # Example: different CS pin for second display
    reset=Pin(13), # Example: different Reset pin for second display
    rotation=0, # Adjust rotation as needed
    width=240,
    height=240,
    buffer_size=10240
)

# --- Backlight Control (Optional) ---
# if 'TFT_BL' in locals():
#     bl = Pin(TFT_BL, Pin.OUT)
#     bl.on() # Turn backlight on

# --- Main Loop ---
print("Starting Hello World demo...")

# Clear displays
tft1.fill(0)
tft2.fill(0)

# Define some colors
colors = [
    gc9a01.RED, gc9a01.GREEN, gc9a01.BLUE,
    gc9a01.YELLOW, gc9a01.CYAN, gc9a01.MAGENTA,
    gc9a01.WHITE, gc9a01.ORANGE, gc9a01.PURPLE
]

for _ in range(50): # Run for a number of iterations
    # Get random position and color for display 1
    x1 = random.randint(0, tft1.width - 1)
    y1 = random.randint(0, tft1.height - 1)
    color1 = random.choice(colors)
    
    # Get random position and color for display 2
    x2 = random.randint(0, tft2.width - 1)
    y2 = random.randint(0, tft2.height - 1)
    color2 = random.choice(colors)

    # Write "Hello World" on each display
    tft1.text("Hello", x1, y1, color1)
    tft1.text("World", x1, y1 + 10, color1) # Offset for second line
    
    tft2.text("Hello", x2, y2, color2)
    tft2.text("World", x2, y2 + 10, color2)

    # Update displays
    tft1.show()
    tft2.show()

    time.sleep(0.5) # Pause for visibility

print("Demo finished.")

# Optional: Turn off backlight
# if 'TFT_BL' in locals():
#     bl.off()

```

--------------------------------

### GC9A01 Hello World Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/_sources/examples/hello_world.rst.txt

This example writes "Hello World" in random colors at random locations, split across two GC9A01 displays connected to a Raspberry Pi Pico. It showcases basic display output and random generation capabilities.

```python
import random
import time

from machine import Pin, SPI
import gc9a01

# --- Configuration ---
# SPI Bus
spi = SPI(0, baudrate=40000000, miso=Pin(16), mosi=Pin(19), sck=Pin(18))

# GC9A01 Pins
# TFT_RESET = 20
# TFT_DC = 21
# TFT_CS = 17

# TFT_BL = 22 # Backlight control (optional)

# --- Initialize Displays ---
# Display 1
tft1 = gc9a01.GC9A01(
    spi,
    dc=Pin(21),
    cs=Pin(17),
    reset=Pin(20),
    rotation=0, # Adjust rotation as needed
    width=240,
    height=240,
    buffer_size=10240 # Adjust buffer size if needed
)

# Display 2 (assuming similar setup, adjust pins if different)
tft2 = gc9a01.GC9A01(
    spi,
    dc=Pin(15), # Example: different DC pin for second display
    cs=Pin(14), # Example: different CS pin for second display
    reset=Pin(13), # Example: different Reset pin for second display
    rotation=0, # Adjust rotation as needed
    width=240,
    height=240,
    buffer_size=10240
)

# --- Backlight Control (Optional) ---
# if 'TFT_BL' in locals():
#     bl = Pin(TFT_BL, Pin.OUT)
#     bl.on() # Turn backlight on

# --- Main Loop ---
print("Starting Hello World demo...")

# Clear displays
tft1.fill(0)
tft2.fill(0)

# Define some colors
colors = [
    gc9a01.RED, gc9a01.GREEN, gc9a01.BLUE,
    gc9a01.YELLOW, gc9a01.CYAN, gc9a01.MAGENTA,
    gc9a01.WHITE, gc9a01.ORANGE, gc9a01.PURPLE
]

for _ in range(50): # Run for a number of iterations
    # Get random position and color for display 1
    x1 = random.randint(0, tft1.width - 1)
    y1 = random.randint(0, tft1.height - 1)
    color1 = random.choice(colors)
    
    # Get random position and color for display 2
    x2 = random.randint(0, tft2.width - 1)
    y2 = random.randint(0, tft2.height - 1)
    color2 = random.choice(colors)

    # Write "Hello World" on each display
    tft1.text("Hello", x1, y1, color1)
    tft1.text("World", x1, y1 + 10, color1) # Offset for second line
    
    tft2.text("Hello", x2, y2, color2)
    tft2.text("World", x2, y2 + 10, color2)

    # Update displays
    tft1.show()
    tft2.show()

    time.sleep(0.5) # Pause for visibility

print("Demo finished.")

# Optional: Turn off backlight
# if 'TFT_BL' in locals():
#     bl.off()

```

--------------------------------

### Alien JPG Drawing Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/examples/alien.html

Demonstrates how to initialize the GC9A01 display and draw a JPG image at random locations using the fast drawing method. It includes setup for garbage collection and display configuration.

```python
import gc
import random
import gc9a01
import tft_config

def main():
    """
    Decode and draw jpg on display
    """
    gc.enable()
    gc.collect()

    tft = tft_config.config(tft_config.TALL)

    # enable display and clear screen
    tft.init()

    # cache width and height
    width = tft.width()
    height = tft.height()

    # display jpg in random locations
    while True:
        tft.rotation(random.randint(0, 4))
        tft.jpg(
            "alien.jpg",
            random.randint(0, width - 30),
            random.randint(0, height - 30),
            gc9a01.FAST,
        )


main()
```

--------------------------------

### Draw JPG Image on gc9a01 Display

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/examples/jpg_test.html

This script initializes the gc9a01 display and cycles through JPG images, drawing them onto the screen using a memory-efficient MCU block blitting method. It includes basic setup for the display and a loop to display multiple images with delays.

```python
import gc
import time
import gc9a01
import tft_config

def main():
    """
    Decode and draw jpg on display
    """
    gc.enable()
    gc.collect()

    tft = tft_config.config(tft_config.TALL)

    # enable display and clear screen
    tft.init()

    # cache width and height
    width = tft.width()
    height = tft.height()

    # cycle thru jpg's
    while True:
        for image in ["bigbuckbunny.jpg", "bluemarble.jpg"]:
            tft.jpg(image, 0, 0, gc9a01.SLOW)
            time.sleep(5)


main()
```

--------------------------------

### Script Usage Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/_sources/utils/create_png_examples.rst.txt

Demonstrates how to run the create_png_examples.py script from the command line, specifying input and output directories.

```console
- create_png_examples.py font_directory png_directory
```

--------------------------------

### Python chango.py Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/sphinx/examples/chango.rst

This snippet shows the Python code for the chango.py example, which is used for font2bitmap conversion. It includes line numbers as specified in the documentation.

```python
1 # SPDX-License-Identifier: MIT
2 # Copyright (c) 2019-2021 The Pybricks Authors
3 #
4 # Example for font2bitmap converter.
5 #
6 import math
7 import sys
8 import time
9 
10 from pybricks.builtins import abs, hex, str, int, list, dict, tuple, range, print, len, type, isinstance, reversed, sorted, sum, min, max, pow, round, open, input, break, continue, pass, del, return, yield, is_, in_, not_, or_, and_, if, elif, else, while, for, try, except, finally, with, import, from, as, def, class, True, False, None
11 from pybricks.ev3devices import (Motor, TouchSensor, ColorSensor, InfraredSensor, GyroSensor, UltrasonicSensor)
12 from pybricks.hubs import EV3Brick
13 from pybricks.languages import en
14 from pybricks.media import Image, Sound, Font
15 from pybricks.modules import StopWatch, countdown, wait
16 from pybricks.parameters import Button, Color, Direction, Event, FontAlign, ImageFile, Light, Port, Stop, SystemExit, Vector
17 
18 # A custom font.
19 #
20 # This font is 5x7 pixels and has 10 characters: 0-9.
21 #
22 # The font data is stored as a list of integers. Each integer represents a row of pixels.
23 # The most significant bit (MSB) is the leftmost pixel.
24 #
25 # Example: The character '0' is represented by the following 7 rows:
26 #
27 # 01110
28 # 10001
29 # 10001
30 # 10001
31 # 10001
32 # 01110
33 # 00000
34 #
35 # In binary, this is:
36 # 0b01110, 0b10001, 0b10001, 0b10001, 0b10001, 0b01110, 0b00000
37 #
38 # In decimal, this is:
39 # 14, 17, 17, 17, 17, 14, 0
40 #
41 CUSTOM_FONT_DATA = [
42     # 0
43     14, 17, 17, 17, 17, 14, 0,
44     # 1
45     0, 0, 17, 0, 0, 0, 0,
46     # 2
47     14, 17, 7, 14, 16, 14, 0,
48     # 3
49     14, 17, 7, 17, 17, 14, 0,
50     # 4
51     1, 14, 17, 14, 1, 0, 0,
52     # 5
53     14, 16, 14, 17, 17, 14, 0,
54     # 6
55     14, 17, 14, 17, 17, 14, 0,
56     # 7
57     14, 17, 1, 1, 1, 0, 0,
58     # 8
59     14, 17, 17, 14, 17, 14, 0,
60     # 9
61     14, 17, 17, 14, 1, 14, 0,
62 ]
63 
64 # Create a Font object from the custom font data.
65 # The font is 5 pixels wide and 7 pixels high.
66 # The characters are indexed from 0 to 9.
67 custom_font = Font(CUSTOM_FONT_DATA, 5, 7, 0, 9)
68 
69 # Initialize the EV3 Brick.
70 ev3 = EV3Brick()
71 
72 # Clear the screen and display a message.
73 ev3.screen.clear()
74 ev3.screen.draw_text(0, 10, "Custom Font:", text_color=Color.WHITE)
75 
76 # Display the numbers 0 through 9 using the custom font.
77 x = 0
78 y = 20
79 for i in range(10):
80     ev3.screen.draw_text(x, y, str(i), font=custom_font, text_color=Color.WHITE)
81     x += 6 # Move to the right for the next character
82 
83 # Wait for a button press before exiting.
84 ev3.waitForUserPress()

```

--------------------------------

### Python chango.py Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/_sources/examples/chango.rst.txt

This snippet shows the Python code for the chango.py example, which is used for font2bitmap conversion. It includes line numbers as specified in the documentation.

```python
1 # SPDX-License-Identifier: MIT
2 # Copyright (c) 2019-2021 The Pybricks Authors
3 #
4 # Example for font2bitmap converter.
5 #
6 import math
7 import sys
8 import time
9 
10 from pybricks.builtins import abs, hex, str, int, list, dict, tuple, range, print, len, type, isinstance, reversed, sorted, sum, min, max, pow, round, open, input, break, continue, pass, del, return, yield, is_, in_, not_, or_, and_, if, elif, else, while, for, try, except, finally, with, import, from, as, def, class, True, False, None
11 from pybricks.ev3devices import (Motor, TouchSensor, ColorSensor, InfraredSensor, GyroSensor, UltrasonicSensor)
12 from pybricks.hubs import EV3Brick
13 from pybricks.languages import en
14 from pybricks.media import Image, Sound, Font
15 from pybricks.modules import StopWatch, countdown, wait
16 from pybricks.parameters import Button, Color, Direction, Event, FontAlign, ImageFile, Light, Port, Stop, SystemExit, Vector
17 
18 # A custom font.
19 #
20 # This font is 5x7 pixels and has 10 characters: 0-9.
21 #
22 # The font data is stored as a list of integers. Each integer represents a row of pixels.
23 # The most significant bit (MSB) is the leftmost pixel.
24 #
25 # Example: The character '0' is represented by the following 7 rows:
26 #
27 # 01110
28 # 10001
29 # 10001
30 # 10001
31 # 10001
32 # 01110
33 # 00000
34 #
35 # In binary, this is:
36 # 0b01110, 0b10001, 0b10001, 0b10001, 0b10001, 0b01110, 0b00000
37 #
38 # In decimal, this is:
39 # 14, 17, 17, 17, 17, 14, 0
40 #
41 CUSTOM_FONT_DATA = [
42     # 0
43     14, 17, 17, 17, 17, 14, 0,
44     # 1
45     0, 0, 17, 0, 0, 0, 0,
46     # 2
47     14, 17, 7, 14, 16, 14, 0,
48     # 3
49     14, 17, 7, 17, 17, 14, 0,
50     # 4
51     1, 14, 17, 14, 1, 0, 0,
52     # 5
53     14, 16, 14, 17, 17, 14, 0,
54     # 6
55     14, 17, 14, 17, 17, 14, 0,
56     # 7
57     14, 17, 1, 1, 1, 0, 0,
58     # 8
59     14, 17, 17, 14, 17, 14, 0,
60     # 9
61     14, 17, 17, 14, 1, 14, 0,
62 ]
63 
64 # Create a Font object from the custom font data.
65 # The font is 5 pixels wide and 7 pixels high.
66 # The characters are indexed from 0 to 9.
67 custom_font = Font(CUSTOM_FONT_DATA, 5, 7, 0, 9)
68 
69 # Initialize the EV3 Brick.
70 ev3 = EV3Brick()
71 
72 # Clear the screen and display a message.
73 ev3.screen.clear()
74 ev3.screen.draw_text(0, 10, "Custom Font:", text_color=Color.WHITE)
75 
76 # Display the numbers 0 through 9 using the custom font.
77 x = 0
78 y = 20
79 for i in range(10):
80     ev3.screen.draw_text(x, y, str(i), font=custom_font, text_color=Color.WHITE)
81     x += 6 # Move to the right for the next character
82 
83 # Wait for a button press before exiting.
84 ev3.waitForUserPress()

```

--------------------------------

### Script Usage Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/sphinx/utils/create_png_examples.rst

Demonstrates how to run the create_png_examples.py script from the command line, specifying input and output directories.

```console
- create_png_examples.py font_directory png_directory
```

--------------------------------

### create_png_examples.py Command Line Interface

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/_sources/utils/create_png_examples.rst.txt

Details the command-line arguments accepted by the create_png_examples.py script, including positional arguments for input and output directories, and optional arguments like help.

```APIDOC
create_png_examples.py
  usage: create_png_examples.py [-h] input output

  Creates png samples of each text font file from the input directory to the output directory.

  positional arguments:
    input       input directory containing font-bin files
    output      output directory to create pngs

  optional arguments:
    -h, --help  show this help message and exit
```

--------------------------------

### Example Programs

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/examples/fonts.html

This section provides links to various example programs that demonstrate the functionality of the GC9A01 MicroPython driver. Examples cover drawing primitives, text, images, and specific configurations.

```APIDOC
Example Programs:

Configuration Modules:
  ESP32-S3-LCD-1.28/tft_config.py
  ESP32-S3-LCD-1.28/tft_buttons.py
  RP2-Dual-Display/tft_config0.py
  RP2-Dual-Display/tft_config1.py
  RP2-Dual-Display/tft_buttons.py
  RP2040-Touch-LCD-1.28/tft_config.py
  RP2040-Touch-LCD-1.28/tft_buttons.py
  RP2/tft_config.py
  RP2/tft_buttons.py

General Examples:
  alien.py
  arcs.py
  bitarray.py
  bluemarble.py
  chango.py
  feathers.py
  fonts.py
  hello.py
  hello_world.py
  hershey.py
  jpg_test.py
  lines.py
  mono_fonts.py
  noto_fonts.py
  pinball.py
  proverbs.py
  roids.py
  rotations.py
  scroll.py
  tiny_toasters.py
  toasters.py
```

--------------------------------

### create_png_examples.py Command Line Interface

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/sphinx/utils/create_png_examples.rst

Details the command-line arguments accepted by the create_png_examples.py script, including positional arguments for input and output directories, and optional arguments like help.

```APIDOC
create_png_examples.py
  usage: create_png_examples.py [-h] input output

  Creates png samples of each text font file from the input directory to the output directory.

  positional arguments:
    input       input directory containing font-bin files
    output      output directory to create pngs

  optional arguments:
    -h, --help  show this help message and exit
```

--------------------------------

### Example Programs

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/examples/arcs.html

Links to various example Python programs demonstrating the functionality of the GC9A01C MicroPython driver. These examples cover different drawing techniques, text rendering, and specific use cases.

```Python
# Example: alien.py
# Description: Demonstrates drawing the alien animation.

```

```Python
# Example: arcs.py
# Description: Demonstrates drawing arcs.

```

```Python
# Example: bitarray.py
# Description: Demonstrates using bitarrays for drawing.

```

```Python
# Example: bluemarble.py
# Description: Displays a blue marble image.

```

```Python
# Example: chango.py
# Description: Demonstrates the chango animation.

```

```Python
# Example: feathers.py
# Description: Displays feather graphics.

```

```Python
# Example: fonts.py
# Description: Demonstrates using different fonts.

```

```Python
# Example: hello.py
# Description: Basic 'Hello' display example.

```

```Python
# Example: hello_world.py
# Description: Displays 'Hello World'.

```

```Python
# Example: hershey.py
# Description: Demonstrates Hershey fonts.

```

```Python
# Example: jpg_test.py
# Description: Tests JPEG image loading and display.

```

```Python
# Example: lines.py
# Description: Demonstrates drawing various lines.

```

```Python
# Example: mono_fonts.py
# Description: Demonstrates monochrome fonts.

```

```Python
# Example: noto_fonts.py
# Description: Demonstrates Noto fonts.

```

```Python
# Example: pinball.py
# Description: Displays a pinball animation.

```

```Python
# Example: proverbs.py
# Description: Displays proverbs on the screen.

```

```Python
# Example: roids.py
# Description: Demonstrates the 'roids' animation.

```

```Python
# Example: rotations.py
# Description: Demonstrates display rotation.

```

```Python
# Example: scroll.py
# Description: Demonstrates scrolling text or graphics.

```

```Python
# Example: tiny_toasters.py
# Description: Displays tiny toaster graphics.

```

```Python
# Example: toasters.py
# Description: Displays toaster graphics.

```

--------------------------------

### Example Programs

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/examples/bitarray.html

This section lists various example programs demonstrating the capabilities of the GC9A01 MicroPython driver. These examples cover drawing primitives, text rendering, image display, and specific use cases.

```python
# Example: alien.py
# Demonstrates drawing bitmaps and text.

# Example: arcs.py
# Demonstrates drawing arcs and filled arcs.

# Example: bitarray.py
# Demonstrates using bitarrays for graphics.

# Example: bluemarble.py
# Displays a large bitmap image.

# Example: chango.py
# Shows text rendering with different fonts.

# Example: feathers.py
# Displays feather graphics.

# Example: fonts.py
# Demonstrates various font rendering capabilities.

# Example: hello.py
# Basic example to display "Hello, World!"

# Example: hello_world.py
# Another example for displaying "Hello, World!"

# Example: hershey.py
# Demonstrates Hershey vector font rendering.

# Example: jpg_test.py
# Tests JPEG image loading and display.

# Example: lines.py
# Demonstrates drawing various lines and shapes.

# Example: mono_fonts.py
# Shows rendering with monospaced fonts.

# Example: noto_fonts.py
# Demonstrates rendering with Noto fonts.

# Example: pinball.py
# A simple pinball simulation.

# Example: proverbs.py
# Displays rotating text with proverbs.

# Example: roids.py
# A simple Asteroids-like game.

# Example: rotations.py
# Demonstrates text and bitmap rotation.

# Example: scroll.py
# Shows vertical scrolling of content.

# Example: tiny_toasters.py
# Displays small toaster graphics.

# Example: toasters.py
# Displays larger toaster graphics.
```

--------------------------------

### Python Hello World Example

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/examples/hello.html

This Python script demonstrates how to initialize the GC9A01 display and write text. It uses a specific font module and the random module to display 'Hello!' multiple times with random positions and colors on the screen. The script cycles through display rotations.

```python
"""
hello.py
========

.. figure:: /_static/hello.png
  :align: center

Writes \"Hello!\" in random colors at random locations on the display.
"""

import random

import vga1_bold_16x32 as font
import gc9a01
import tft_config

tft = tft_config.config(tft_config.TALL)


def main():

    tft.init()

    while True:
        for rotation in range(4):
            tft.rotation(rotation)
            tft.fill(0)
            col_max = tft.width() - font.WIDTH * 6
            row_max = tft.height() - font.HEIGHT

            for _ in range(128):
                tft.text(
                    font,
                    "Hello!",
                    random.randint(0, col_max),
                    random.randint(0, row_max),
                    gc9a01.color565(
                        random.getrandbits(8),
                        random.getrandbits(8),
                        random.getrandbits(8),
                    ),
                    gc9a01.color565(
                        random.getrandbits(8),
                        random.getrandbits(8),
                        random.getrandbits(8),
                    ),
                )


main()

```

--------------------------------

### Example Programs

Source: https://github.com/russhughes/gc9a01_mpy/blob/main/docs/utils/write_font_converter.html

This section lists various example Python programs that demonstrate the functionality of the GC9A01C MicroPython driver. These examples cover drawing primitives, text rendering, image display, and specific hardware configurations.

```python
# Example: alien.py
# Demonstrates drawing graphics and text.

# Example: arcs.py
# Shows how to draw and fill arcs.

# Example: bitarray.py
# Illustrates using bitarrays for graphics.

# Example: bluemarble.py
# Displays a bitmap image, possibly the Blue Marble satellite image.

# Example: chango.py
# Likely demonstrates a specific graphical effect or animation.

# Example: feathers.py
# May showcase drawing feather-like patterns or using specific fonts.

# Example: fonts.py
# Demonstrates various font rendering capabilities.

# Example: hello.py
# A basic example to display "Hello, World!" or similar.

# Example: hello_world.py
# Another basic example for displaying text.

# Example: hershey.py
# Likely uses Hershey fonts for text rendering.

# Example: jpg_test.py
# Tests the functionality of displaying JPEG images.

# Example: lines.py
# Demonstrates drawing various types of lines.

# Example: mono_fonts.py
# Shows rendering of monochrome fonts.

# Example: noto_fonts.py
# Demonstrates using Noto fonts for text rendering.

# Example: pinball.py
# Likely a graphical demo simulating pinball elements.

# Example: proverbs.py
# Displays proverbs or quotes on the screen.
```