translate announce example

example/Makefile

@@ -4,6 +4,7 @@ CARGO := rustup run nightly cargo
 THIS_DIR := $(dir $(realpath $(lastword $(MAKEFILE_LIST))))
 REPO_ROOT := $(THIS_DIR)/..
 RUST_TARGET_DIR := $(REPO_ROOT)/target/x86_64-unknown-linux-musl/size-optimized
+export SERVICEPOINT_HEADER_OUT := $(REPO_ROOT)/include
 
 RUSTFLAGS := -Zlocation-detail=none \
 	-Zfmt-debug=none \
@@ -41,34 +42,34 @@ CCFLAGS := -static -Os \
 	-fno-exceptions
 	#-Wl,--icf=all \
 
-export SERVICEPOINT_HEADER_OUT := $(REPO_ROOT)/include
+STRIPFLAGS := -s --strip-unneeded -R .comment -R .gnu.version -R .comment -R .note -R .note.gnu.build-id -R .note.ABI-tag
 
-build: out/example
+src := $(wildcard *.c)
+programs := $(basename $(src))
+bins := $(addprefix out/, $(programs))
+unstripped_bins := $(addsuffix _unstripped, $(bins))
+
+all: $(bins)
 
 clean:
 	rm -r out || true
 	rm include/servicepoint.h || true
 	cargo clean
 
-run: out/example
-	out/example
+PHONY: all clean analyze-size
 
-PHONY: build clean dependencies run
-
-out/example_unstripped: dependencies main.c
+$(unstripped_bins): out/%_unstripped: %.c $(SERVICEPOINT_HEADER_OUT)/servicepoint.h
 	mkdir -p out || true
-	${CC} main.c \
+	${CC} $^ \
 		-I $(SERVICEPOINT_HEADER_OUT) \
 		-L $(RUST_TARGET_DIR)\
 		$(CCFLAGS) \
-		-o out/example_unstripped
-out/example: out/example_unstripped
-	strip -s --strip-unneeded \
-		-R .comment -R .gnu.version -R .comment -R .note -R .note.gnu.build-id -R .note.ABI-tag \
-		out/example_unstripped \
-		-o out/example
+		-o $@
 
-dependencies: FORCE
+$(bins): out/%: out/%_unstripped
+	strip $(STRIPFLAGS) $^ -o $@
+
+$(SERVICEPOINT_HEADER_OUT)/servicepoint.h: FORCE
 	mkdir -p include || true
 	# generate servicepoint header and binary to link against
 	${CARGO} rustc $(CARGOFLAGS) -- $(RUSTFLAGS)

example/announce.c

@@ -0,0 +1,32 @@
+#include <stdio.h>
+#include "servicepoint.h"
+
+int main(void) {
+    UdpConnection *connection = sp_udp_open_ipv4(172, 23, 42, 29, 2342);
+    if (connection == NULL)
+        return 1;
+
+    sp_udp_send_command(connection, sp_command_clear());
+
+    CharGrid *grid = sp_char_grid_new(5,2);
+    if (grid == NULL)
+        return 1;
+
+    sp_char_grid_set(grid, 0, 0, 'H');
+    sp_char_grid_set(grid, 1, 0, 'e');
+    sp_char_grid_set(grid, 2, 0, 'l');
+    sp_char_grid_set(grid, 3, 0, 'l');
+    sp_char_grid_set(grid, 4, 0, 'o');
+    sp_char_grid_set(grid, 0, 1, 'W');
+    sp_char_grid_set(grid, 1, 1, 'o');
+    sp_char_grid_set(grid, 2, 1, 'r');
+    sp_char_grid_set(grid, 3, 1, 'l');
+    sp_char_grid_set(grid, 4, 1, 'd');
+
+
+    TypedCommand *command = sp_command_char_grid(0, 0, grid);
+    sp_udp_send_command(connection, command);
+
+    sp_udp_free(connection);
+    return 0;
+}

include/servicepoint.h

@@ -668,6 +668,8 @@ size_t sp_brightness_grid_height(BrightnessGrid */*notnull*/ brightness_grid);
 /**
  * Loads a [BrightnessGrid] with the specified dimensions from the provided data.
  *
+ * Any out of range values will be set to [Brightness::MAX] or [Brightness::MIN].
+ *
  * returns: new [BrightnessGrid] instance, or NULL in case of an error.
  */
 BrightnessGrid *sp_brightness_grid_load(size_t width,