From 90c32d32231b61eda896210f56ac762845e085ce Mon Sep 17 00:00:00 2001 From: waltem01 Date: Thu, 23 Nov 2023 11:45:56 +0100 Subject: [PATCH] added comments --- API/main.py | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 55 insertions(+), 2 deletions(-) diff --git a/API/main.py b/API/main.py index 64c47bd..a6f350d 100644 --- a/API/main.py +++ b/API/main.py @@ -11,102 +11,136 @@ api = Flask(__name__) @api.route('/text', methods=['POST']) def display_text(): + # prepare response data response = { 'success': True } try: global matrix + # receive client data data = request.get_json() + # try unpacking text and x,y coordinates text = data.get('text') x_coord = data.get('x') y_coord = data.get('y') + # call matrix method with data matrix.text(x_coord, y_coord, text) except Exception as e: + # error handling print(e) response['success'] = False + # respond to client return jsonify(response) @api.route('/pixel', methods=['POST']) def set_pixel(): + # prepare response data response = { 'success': True } try: global matrix + # receive client data data = request.get_json() + # try unpacking x,y coordinates x_coord = data.get('x') y_coord = data.get('y') + # call matrix method with data matrix.pixel(x_coord, y_coord) except Exception as e: + # error handling print(e) response['success'] = False + # respond to client return jsonify(response) @api.route('/circle', methods=['POST']) def draw_circle(): + # prepare response data response = { 'success': True } try: global matrix + # receive client data data = request.get_json() + # try unpacking radius and x,y coordinates radius = data.get('r') x_coord = data.get('x') y_coord = data.get('y') + # call matrix method with data matrix.circle(x_coord, y_coord, radius) except Exception as e: + # error handling print(e) response['success'] = False + # respond to client return jsonify(response) @api.route('/rectangle', methods=['POST']) def draw_rectangle(): + # prepare response data response = { 'success': True } try: global matrix + # receive client data data = request.get_json() + # try unpacking rectangle width and height width = data.get('w') height = data.get('h') + # try unpacking x,y coordinates x_coord = data.get('x') y_coord = data.get('y') + # call matrix method with data matrix.rectangle(x_coord, y_coord, width, height) except Exception as e: + # error handling print(e) response['success'] = False + # respond to client return jsonify(response) @api.route('/color', methods=['POST']) def set_color(): + # prepare response data response = { 'success': True } try: global matrix + # receive client data data = request.get_json() + # try unpacking red, green and blue color values red = data.get('r') green = data.get('g') blue = data.get('b') + # call matrix method with data matrix.set_color(red, green, blue) except Exception as e: + # error handling print(e) response['success'] = False + # respond to client return jsonify(response) @api.route('/clear', methods=['GET']) def update_matrix(): + # prepare response data response = { 'success': True } - try: global matrix + + # receive client data matrix.clear() except Exception as e: + # error handling print(e) response['success'] = False @@ -115,7 +149,6 @@ def update_matrix(): @api.route('/update', methods=['GET']) def update_matrix(): response = { 'success': True } - try: global matrix matrix.update() @@ -123,53 +156,73 @@ def update_matrix(): print(e) response['success'] = False + # respond to client return jsonify(response) +# derived class to access rgb-led-matrix class Matrix(SampleBase): def __init__(self, *args, **kwargs): super(Matrix, self).__init__(*args, **kwargs) + # run display program def run(self): + # initialize font self.font = graphics.Font() self.font.LoadFont("deps/fonts/9x18B.bdf") + # initialize color self.color = graphics.Color(255, 255, 255) + # initialize canvas self.canvas = self.matrix.CreateFrameCanvas() self.canvas.Clear() + # wait in idle while True: time.sleep(.05) + # clear canvas def clear(self): self.canvas.Clear() + # swap canvas with buffer def update(self): self.canvas = self.matrix.SwapOnVSync(self.canvas) self.clear() + # set current color def set_color(self, r, g, b): self.color = graphics.Color(r, g, b) + # set specified pixel to current color def pixel(self, x, y): self.canvas.SetPixel(x, y, self.color.red, self.color.green, self.color.blue) + # display text at position with current color def text(self, x, y, t): graphics.DrawText(self.canvas, self.font, x*9, (y+1)*18, self.color, t) + # display circle at position with radius in current color def circle(self, x, y, r): graphics.DrawCircle(self.canvas, self.font, x, y, r, self.color) + # display rectangle at position with dimensions in current color def rectangle(self, x, y, w, h): + # loop through each point in dimensions for i in range(w): for j in range(h): + # set next pixel in rectangle self.canvas.SetPixel(x+i, y+j, self.color.red, self.color.green, self.color.blue) +# initialize global matrix variable matrix = None if __name__ == "__main__": + # set matrix to instance matrix = Matrix() + # run rest api in thread, serving with 'waitress' threading.Thread(target=lambda: serve(api, host="0.0.0.0", port=8080)).start() + # help menu on call if not matrix.process(): matrix.print_help()