Net

class net.DisplayServer(display)

TCP-Server that listens on a specified port for TCP-Connections. Every request sent to the server has to be one of the special commands described later on or a string of 0s and 1s each specifying a dot to be turned on or off respectively. For instance, to display the letter ‘T’ on a 4x3 display of this form

1111
0110
0110

the following request must be sent to the server: 111101100110.

A simple command line client like nc can send this request to ‘server’ listening on port 10101:

$ echo 111101100110 | nc server 10101

If the request contains the string ‘SIZE’ (ignoring case), the server will respond with the dimensions of the display (width x height).

Lets start a server. Here we use a thread in order to be able to run the client afterwards. In practice the server will run on a different platform and can be started directly.

>>> import net
>>> import displayprovider
>>> import threading
>>> ds = net.DisplayServer(displayprovider.DisplayBase())
>>> th = threading.Thread(target=ds.start)
>>> th.setDaemon(True)
>>> th.start()
Starting server for dimension 4 x 3 on 0.0.0.0 at port 10101

Now we can start a client and send some pixels to the server.

>>> cl = net.RemoteDisplay(host="0.0.0.0")
Remote display will send data to 0.0.0.0 on port 10101
>>> cl.px(1, 1, True)
>>> cl.px(2, 3, True)
>>> cl.show()
Listening on 0.0.0.0 at port 10101

The output lines after show() are coming from the server.

handle_request(payload)

start(host='0.0.0.0', port=10101)

class net.PixelflutServer(display)

PixeflutServer that conforms to the Pixelflut protocol outlined at https://c3pixelflut.de/how.html

PX <x> <y> <rrggbb|aarrggbb> # set pixel at x,y with color rrggbb PX <x> <y> # get pixel color info for pixel at x,y SIZE # get size of the display OFFSET <x> <y> # set offset for following commands

get_pixel(x, y)

Get the color of a specific pixel on the display. Will return the color of the pixel at the specified coordinates as a hex string.

handle_request(payload)

Handle incoming requests and execute commands based on the payload. The payload is expected to be a string of ASCII-encoded commands separated by newlines. Each command is processed and appropriate actions are taken. Commands: - PX x y color: Set the pixel at (x, y) to the specified color. - PX x y: Get the color of the pixel at (x, y). - SIZE: Get the dimensions of the grid. - OFFSET x y: Set the offset for the grid coordinates. Args:

payload (bytes): The ASCII-encoded command string.

Returns:

str: The responses to the commands, joined by newlines.

set_pixel(x, y, color)

Set the color of a specific pixel on the display. Parameters: x (int): The x-coordinate of the pixel. y (int): The y-coordinate of the pixel. color (str): The color to set the pixel to, represented as a hex string.

If the color is “000000”, the pixel will be turned off. Otherwise it will be turned on.

start(host='0.0.0.0', port=10101)

class net.RemoteDisplay(host='0.0.0.0', port=10101, width=28, height=13)

Remote class to connect with a running DisplayServer instance.

led(on_off)

Turn LED of the display on (True) or off (False)

px(x, y, val)

show()