servicepoint_binding_c 0.15.0

#ifndef SERVICEPOINT_BINDINGS_C
#define SERVICEPOINT_BINDINGS_C

/* Generated with cbindgen:0.28.0 */

/* Warning, this file is autogenerated by cbindgen. Don't modify this manually. */

#include <stdarg.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <stdlib.h>

/**
 * pixel count on whole screen
 */
#define PIXEL_COUNT (PIXEL_WIDTH * PIXEL_HEIGHT)

/**
 * Display height in pixels
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::{PIXEL_HEIGHT, PIXEL_WIDTH, Bitmap};
 * let grid = Bitmap::new(PIXEL_WIDTH, PIXEL_HEIGHT);
 * ```
 */
#define PIXEL_HEIGHT (TILE_HEIGHT * TILE_SIZE)

/**
 * Display width in pixels
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::{PIXEL_HEIGHT, PIXEL_WIDTH, Bitmap};
 * let grid = Bitmap::new(PIXEL_WIDTH, PIXEL_HEIGHT);
 * ```
 */
#define PIXEL_WIDTH (TILE_WIDTH * TILE_SIZE)

/**
 * Display tile count in the y-direction
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::{Cp437Grid, TILE_HEIGHT, TILE_WIDTH};
 * let grid = Cp437Grid::new(TILE_WIDTH, TILE_HEIGHT);
 * ```
 */
#define TILE_HEIGHT 20

/**
 * size of a single tile in one dimension
 */
#define TILE_SIZE 8

/**
 * Display tile count in the x-direction
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::{Cp437Grid, TILE_HEIGHT, TILE_WIDTH};
 * let grid = Cp437Grid::new(TILE_WIDTH, TILE_HEIGHT);
 * ```
 */
#define TILE_WIDTH 56

/**
 * Binary operations for use with the [`BitVecCommand`] command.
 */
enum BinaryOperation
#ifdef __cplusplus
  : uint8_t
#endif // __cplusplus
 {
    /**
     * r := a
     */
    BINARY_OPERATION_OVERWRITE,
    /**
     * r := a && b
     */
    BINARY_OPERATION_AND,
    /**
     * r := a || b
     */
    BINARY_OPERATION_OR,
    /**
     * r := (a || b) && (a != b)
     */
    BINARY_OPERATION_XOR,
};
#ifndef __cplusplus
typedef uint8_t BinaryOperation;
#endif // __cplusplus

/**
 * The u16 command codes used for the [`crate::Command`]s.
 */
enum CommandCode
#ifdef __cplusplus
  : uint16_t
#endif // __cplusplus
 {
    COMMAND_CODE_CLEAR = 2,
    COMMAND_CODE_CP437_DATA = 3,
    COMMAND_CODE_CHAR_BRIGHTNESS = 5,
    COMMAND_CODE_BRIGHTNESS = 7,
    COMMAND_CODE_HARD_RESET = 11,
    COMMAND_CODE_FADE_OUT = 13,
    COMMAND_CODE_BITMAP_LEGACY = 16,
    COMMAND_CODE_BITMAP_LINEAR = 18,
    COMMAND_CODE_BITMAP_LINEAR_WIN_UNCOMPRESSED = 19,
    COMMAND_CODE_BITMAP_LINEAR_AND = 20,
    COMMAND_CODE_BITMAP_LINEAR_OR = 21,
    COMMAND_CODE_BITMAP_LINEAR_XOR = 22,
    COMMAND_CODE_BITMAP_LINEAR_WIN_ZLIB = 23,
    COMMAND_CODE_BITMAP_LINEAR_WIN_BZIP2 = 24,
    COMMAND_CODE_BITMAP_LINEAR_WIN_LZMA = 25,
    COMMAND_CODE_UTF8_DATA = 32,
    COMMAND_CODE_BITMAP_LINEAR_WIN_ZSTD = 26,
};
#ifndef __cplusplus
typedef uint16_t CommandCode;
#endif // __cplusplus

/**
 * Specifies the kind of command struct.
 *
 * This is _not_ equivalent to the [servicepoint::CommandCode]s.
 */
enum CommandTag
#ifdef __cplusplus
  : uint8_t
#endif // __cplusplus
 {
    COMMAND_TAG_INVALID = 0,
    COMMAND_TAG_BITMAP,
    COMMAND_TAG_BIT_VEC,
    COMMAND_TAG_BRIGHTNESS_GRID,
    COMMAND_TAG_CHAR_GRID,
    COMMAND_TAG_CP437_GRID,
    COMMAND_TAG_GLOBAL_BRIGHTNESS,
    COMMAND_TAG_CLEAR,
    COMMAND_TAG_HARD_RESET,
    COMMAND_TAG_FADE_OUT,
    COMMAND_TAG_BITMAP_LEGACY,
};
#ifndef __cplusplus
typedef uint8_t CommandTag;
#endif // __cplusplus

/**
 * Specifies the kind of compression to use. Availability depends on features.
 *
 * # Examples
 *
 * create command without payload compression
 * ```rust
 * # use servicepoint::*;
 * # let pixels = Bitmap::max_sized();
 * _ = BitmapCommand {
 *     origin: Origin::ZERO,
 *     bitmap: pixels,
 *     compression: CompressionCode::Uncompressed
 * };
 * ```
 *
 * create command with payload compressed with lzma and appropriate header flags
 * ```rust
 * # use servicepoint::*;
 * # let pixels = Bitmap::max_sized();
 * # #[cfg(feature = "compression_lzma")] {
 * _ = BitmapCommand {
 *     origin: Origin::ZERO,
 *     bitmap: pixels,
 *     compression: CompressionCode::Lzma
 * };
 * # }
 * ```
 */
enum CompressionCode
#ifdef __cplusplus
  : uint16_t
#endif // __cplusplus
 {
    /**
     * no compression
     */
    COMPRESSION_CODE_UNCOMPRESSED = 0,
    /**
     * compress using flate2 with zlib header
     */
    COMPRESSION_CODE_ZLIB = 26490,
    /**
     * compress using bzip2
     */
    COMPRESSION_CODE_BZIP2 = 25210,
    /**
     * compress using lzma
     */
    COMPRESSION_CODE_LZMA = 27770,
    /**
     * compress using Zstandard
     */
    COMPRESSION_CODE_ZSTD = 31347,
};
#ifndef __cplusplus
typedef uint16_t CompressionCode;
#endif // __cplusplus

/**
 * Set pixel data starting at the pixel offset on screen.
 *
 * The screen will continuously overwrite more pixel data without regarding the offset, meaning
 * once the starting row is full, overwriting will continue on column 0.
 *
 * The [`BinaryOperation`] will be applied on the display comparing old and sent bit.
 *
 * `new_bit = old_bit op sent_bit`
 *
 * For example, [`BinaryOperation::Or`] can be used to turn on some pixels without affecting other pixels.
 *
 * The contained [`DisplayBitVec`] is always uncompressed.
 */
typedef struct BitVecCommand BitVecCommand;

/**
 * A fixed-size 2D grid of booleans.
 *
 * The values are stored in packed bytes (8 values per byte) in the same order as used by the display for storing pixels.
 * This means that no conversion is necessary for sending the data to the display.
 * The downside is that the width has to be a multiple of 8.
 *
 * # Examples
 *
 * ```rust
 * use servicepoint::Bitmap;
 * let mut bitmap = Bitmap::new(8, 2);
 *
 * ```
 */
typedef struct Bitmap Bitmap;

/**
 * Overwrites a rectangular region of pixels.
 *
 * Origin coordinates must be divisible by 8.
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * #
 * let mut bitmap = Bitmap::max_sized();
 * // draw something to the pixels here
 * # bitmap.set(2, 5, true);
 *
 * // create command to send pixels
 * let command = BitmapCommand {
 *     bitmap,
 *     origin: Origin::ZERO,
 *     compression: CompressionCode::Uncompressed
 * };
 *
 * connection.send_command(command).expect("send failed");
 * ```
 */
typedef struct BitmapCommand BitmapCommand;

/**
 * Legacy command code, gets ignored by the real display.
 *
 * Might be useful as a noop package.
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * // this sends a packet that does nothing
 * connection.send_command(BitmapLegacyCommand).unwrap();
 * ```
 */
typedef struct BitmapLegacyCommand BitmapLegacyCommand;

/**
 * Set the brightness of individual tiles in a rectangular area of the display.
 */
typedef struct BrightnessGridCommand BrightnessGridCommand;

/**
 * Show text on the screen.
 *
 * The text is sent in the form of a 2D grid of UTF-8 encoded characters (the default encoding in rust).
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * let grid = CharGrid::from("Hello,\nWorld!");
 * connection.send_command(CharGridCommand { origin: Origin::ZERO, grid }).expect("send failed");
 * ```
 */
typedef struct CharGridCommand CharGridCommand;

/**
 * Set all pixels to the off state. Does not affect brightness.
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * connection.send_command(ClearCommand).unwrap();
 * ```
 */
typedef struct ClearCommand ClearCommand;

/**
 * Show text on the screen.
 *
 * The text is sent in the form of a 2D grid of [CP-437] encoded characters.
 *
 * <div class="warning">You probably want to use [Command::Utf8Data] instead</div>
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * let grid = CharGrid::from("Hello,\nWorld!");
 * # #[cfg(feature = "cp437")] {
 * let grid = Cp437Grid::from(&grid);
 * connection.send_command(Cp437GridCommand{ origin: Origin::ZERO, grid }).expect("send failed");
 * # }
 * ```
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * let grid = Cp437Grid::load_ascii("Hello\nWorld", 5, false).unwrap();
 * connection.send_command(Cp437GridCommand{ origin: Origin::new(2, 2), grid }).unwrap();
 * ```
 * [CP-437]: https://en.wikipedia.org/wiki/Code_page_437
 */
typedef struct Cp437GridCommand Cp437GridCommand;

/**
 * This is a type only used by cbindgen to have a type for pointers.
 */
typedef struct DisplayBitVec DisplayBitVec;

/**
 * <div class="warning">Untested</div>
 *
 * Slowly decrease brightness until off or something like that?
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * connection.send_command(FadeOutCommand).unwrap();
 * ```
 */
typedef struct FadeOutCommand FadeOutCommand;

/**
 * Set the brightness of all tiles to the same value.
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * let command = GlobalBrightnessCommand { brightness: Brightness::MAX };
 * connection.send_command(command).unwrap();
 * ```
 */
typedef struct GlobalBrightnessCommand GlobalBrightnessCommand;

/**
 * Kills the udp daemon on the display, which usually results in a restart.
 *
 * Please do not send this in your normal program flow.
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * # let connection = FakeConnection;
 * connection.send_command(HardResetCommand).unwrap();
 * ```
 */
typedef struct HardResetCommand HardResetCommand;

/**
 * The raw packet.
 *
 * Contents should probably only be used directly to use features not exposed by the library.
 *
 * You may want to use [`crate::Command`] or [`crate::TypedCommand`] instead.
 */
typedef struct Packet Packet;

/**
 * This is a type only used by cbindgen to have a type for pointers.
 *
 * See [servicepoint::UdpSocketExt].
 */
typedef struct UdpSocket UdpSocket;

/**
 * A 2D grid of values.
 *
 * The memory layout is the one the display expects in [`crate::Command`]s.
 *
 * This structure can be used with any type that implements the [Value] trait.
 * You can also use the concrete type aliases provided in this crate, e.g. [`crate::CharGrid`] and [`crate::ByteGrid`].
 */
typedef struct ValueGrid_Brightness ValueGrid_Brightness;

/**
 * A 2D grid of values.
 *
 * The memory layout is the one the display expects in [`crate::Command`]s.
 *
 * This structure can be used with any type that implements the [Value] trait.
 * You can also use the concrete type aliases provided in this crate, e.g. [`crate::CharGrid`] and [`crate::ByteGrid`].
 */
typedef struct ValueGrid_char ValueGrid_char;

/**
 * A 2D grid of values.
 *
 * The memory layout is the one the display expects in [`crate::Command`]s.
 *
 * This structure can be used with any type that implements the [Value] trait.
 * You can also use the concrete type aliases provided in this crate, e.g. [`crate::CharGrid`] and [`crate::ByteGrid`].
 */
typedef struct ValueGrid_u8 ValueGrid_u8;

/**
 * Type alias for documenting the meaning of the u16 in enum values
 */
typedef size_t Offset;

/**
 * Represents a span of memory (`&mut [u8]` ) as a struct.
 *
 * # Safety
 *
 * The caller has to make sure that:
 *
 * - accesses to the memory pointed to with `start` is never accessed outside `length`
 * - the lifetime of the `CByteSlice` does not outlive the memory it points to, as described in
 *   the function returning this type.
 * - if `start` is NULL or `length` is 0, do not dereference `start`.
 *
 * # Examples
 *
 * ```c
 * ByteSlice empty = {.start: NULL, .length = 0};
 * ```
 */
typedef struct ByteSlice {
    /**
     * The start address of the memory.
     */
    uint8_t *start;
    /**
     * The amount of memory in bytes.
     */
    size_t length;
} ByteSlice;

/**
 * A grid containing brightness values.
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * let mut grid = BrightnessGrid::new(2,2);
 * grid.set(0, 0, Brightness::MIN);
 * grid.set(1, 1, Brightness::MIN);
 *
 * # let connection = FakeConnection;
 * connection.send_command(BrightnessGridCommand {
 *     origin: Origin::new(3, 7),
 *     grid
 * }).unwrap()
 * ```
 */
typedef struct ValueGrid_Brightness BrightnessGrid;

/**
 * A display brightness value, checked for correct value range
 *
 * # Examples
 *
 * ```
 * # use servicepoint::*;
 * let b = Brightness::MAX;
 * let val: u8 = b.into();
 *
 * let b = Brightness::try_from(7).unwrap();
 * # let connection = FakeConnection;
 * let result = connection.send_command(GlobalBrightnessCommand::from(b));
 * ```
 */
typedef uint8_t Brightness;
/**
 * highest possible brightness value, 11
 */
#define Brightness_MAX 11
/**
 * lowest possible brightness value, 0
 */
#define Brightness_MIN 0

/**
 * A grid containing UTF-8 characters.
 *
 * To send a `CharGrid` to the display, use a [`crate::CharGridCommand`].
 *
 * Also see [`ValueGrid`] for the non-specialized operations and examples.
 *
 * # Examples
 *
 * ```rust
 * # use servicepoint::*;
 * let grid = CharGrid::from("You can\nload multiline\nstrings directly");
 * assert_eq!(grid.get_row_str(1), Some("load multiline\0\0".to_string()));
 *
 * # let connection = FakeConnection;
 * let command = CharGridCommand { origin: Origin::ZERO, grid };
 * connection.send_command(command).unwrap()
 * ```
 */
typedef struct ValueGrid_char CharGrid;

/**
 * A grid containing codepage 437 characters.
 *
 * The encoding is currently not enforced.
 */
typedef struct ValueGrid_u8 Cp437Grid;

/**
 * Pointer to one of the available command structs.
 */
typedef union CommandUnion {
    uint8_t *null;
    struct BitmapCommand */*notnull*/ bitmap;
    struct BitVecCommand */*notnull*/ bit_vec;
    struct BrightnessGridCommand */*notnull*/ brightness_grid;
    struct CharGridCommand */*notnull*/ char_grid;
    struct Cp437GridCommand */*notnull*/ cp437_grid;
    struct GlobalBrightnessCommand */*notnull*/ global_brightness;
    struct ClearCommand */*notnull*/ clear;
    struct BitmapLegacyCommand */*notnull*/ bitmap_legacy;
    struct HardResetCommand */*notnull*/ hard_reset;
    struct FadeOutCommand */*notnull*/ fade_out;
} CommandUnion;

/**
 * This struct represents a pointer to one of the possible command structs.
 *
 * Only ever access `data` with the correct data type as specified by `tag`!
 *
 * Rust equivalent: [TypedCommand].
 */
typedef struct GenericCommand {
    /**
     * Specifies which kind of command struct is contained in `data`
     */
    CommandTag tag;
    /**
     * The pointer to the command struct
     */
    union CommandUnion data;
} GenericCommand;

/**
 * A raw header.
 *
 * The header specifies the kind of command, the size of the payload and where to display the
 * payload, where applicable.
 *
 * Because the meaning of most fields depend on the command, there are no speaking names for them.
 *
 * The contained values are in platform endian-ness and may need to be converted before sending.
 */
typedef struct Header {
    /**
     * The first two bytes specify which command this packet represents.
     */
    uint16_t command_code;
    /**
     * First command-specific value
     */
    uint16_t a;
    /**
     * Second command-specific value
     */
    uint16_t b;
    /**
     * Third command-specific value
     */
    uint16_t c;
    /**
     * Fourth command-specific value
     */
    uint16_t d;
} Header;



/**
 * Actual hardware limit is around 28-29ms/frame. Rounded up for less dropped packets.
 */
#define SP_FRAME_PACING_MS 30



#ifdef __cplusplus
extern "C" {
#endif // __cplusplus

/**
 * Calls method [`BitVecCommand::clone`].
 *
 *Clones a [`BitVecCommand`] instance.
 *
 * This function is part of the `bit_vec_command` module.
 */
struct BitVecCommand */*notnull*/ sp_bit_vec_command_clone(struct BitVecCommand */*notnull*/ instance);

/**
 *Deallocates a [`BitVecCommand`] instance.
 *
 * This function is part of the `bit_vec_command` module.
 */
void sp_bit_vec_command_free(struct BitVecCommand */*notnull*/ instance);

/**
 * Gets a reference to the field `bitvec` of the [`servicepoint::BitVecCommand`].
 *
 * - The returned reference inherits the lifetime of object in which it is contained.
 * - The returned pointer may not be used in a function that consumes the instance, e.g. to create a command.
 *
 * This function is part of the `bit_vec_command` module.
 */
DisplayBitVec */*notnull*/ sp_bit_vec_command_get_bitvec_mut(struct BitVecCommand */*notnull*/ instance);

/**
 * Gets the value of field `compression` of the [`servicepoint::BitVecCommand`].
 *
 * This function is part of the `bit_vec_command` module.
 */
CompressionCode sp_bit_vec_command_get_compression(struct BitVecCommand */*notnull*/ instance);

/**
 * Gets the value of field `offset` of the [`servicepoint::BitVecCommand`].
 *
 * This function is part of the `bit_vec_command` module.
 */
Offset sp_bit_vec_command_get_offset(struct BitVecCommand */*notnull*/ instance);

/**
 * Gets the value of field `operation` of the [`servicepoint::BitVecCommand`].
 *
 * This function is part of the `bit_vec_command` module.
 */
BinaryOperation sp_bit_vec_command_get_operation(struct BitVecCommand */*notnull*/ instance);

/**
 * Set pixel data starting at the pixel offset on screen.
 *
 * The screen will continuously overwrite more pixel data without regarding the offset, meaning
 * once the starting row is full, overwriting will continue on column 0.
 *
 * The [`BinaryOperation`] will be applied on the display comparing old and sent bit.
 *
 * `new_bit = old_bit op sent_bit`
 *
 * For example, [`BinaryOperation::Or`] can be used to turn on some pixels without affecting other pixels.
 *
 * The contained [`DisplayBitVec`] is always uncompressed.
 *
 * This function is part of the `bit_vec_command` module.
 */
struct BitVecCommand */*notnull*/ sp_bit_vec_command_new(DisplayBitVec */*notnull*/ bitvec,
                                                         size_t offset,
                                                         BinaryOperation operation,
                                                         CompressionCode compression);

/**
 * Sets the value of field `bitvec` of the [`servicepoint::BitVecCommand`].
 * The provided value is moved into the instance, potentially invalidating previously taken references.
 *
 * This function is part of the `bit_vec_command` module.
 */
void sp_bit_vec_command_set_bitvec(struct BitVecCommand */*notnull*/ instance,
                                   DisplayBitVec */*notnull*/ value);

/**
 * Sets the value of field `compression` of the [`servicepoint::BitVecCommand`].
 *
 * This function is part of the `bit_vec_command` module.
 */
void sp_bit_vec_command_set_compression(struct BitVecCommand */*notnull*/ instance,
                                        CompressionCode value);

/**
 * Sets the value of field `offset` of the [`servicepoint::BitVecCommand`].
 *
 * This function is part of the `bit_vec_command` module.
 */
void sp_bit_vec_command_set_offset(struct BitVecCommand */*notnull*/ instance,
                                   Offset value);

/**
 * Sets the value of field `operation` of the [`servicepoint::BitVecCommand`].
 *
 * This function is part of the `bit_vec_command` module.
 */
void sp_bit_vec_command_set_operation(struct BitVecCommand */*notnull*/ instance,
                                      BinaryOperation value);

/**
 *Tries to turn a [`BitVecCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `bit_vec_command` module.
 */
struct Packet *sp_bit_vec_command_try_into_packet(struct BitVecCommand */*notnull*/ instance);

/**
 * Calls method [`Bitmap::clone`].
 *
 *Clones a [`Bitmap`] instance.
 *
 * This function is part of the `bitmap` module.
 */
struct Bitmap */*notnull*/ sp_bitmap_clone(struct Bitmap */*notnull*/ instance);

/**
 * Calls method [`BitmapCommand::clone`].
 *
 *Clones a [`BitmapCommand`] instance.
 *
 * This function is part of the `bitmap_command` module.
 */
struct BitmapCommand */*notnull*/ sp_bitmap_command_clone(struct BitmapCommand */*notnull*/ instance);

/**
 *Deallocates a [`BitmapCommand`] instance.
 *
 * This function is part of the `bitmap_command` module.
 */
void sp_bitmap_command_free(struct BitmapCommand */*notnull*/ instance);

/**
 * Move the provided [Bitmap] into a new [BitmapCommand],
 * leaving other fields as their default values.
 *
 * Rust equivalent: `BitmapCommand::from(bitmap)`
 *
 * This function is part of the `bitmap_command` module.
 */
struct BitmapCommand */*notnull*/ sp_bitmap_command_from_bitmap(struct Bitmap */*notnull*/ bitmap);

/**
 * Gets a reference to the field `bitmap` of the [`servicepoint::BitmapCommand`].
 *
 * - The returned reference inherits the lifetime of object in which it is contained.
 * - The returned pointer may not be used in a function that consumes the instance, e.g. to create a command.
 *
 * This function is part of the `bitmap_command` module.
 */
struct Bitmap */*notnull*/ sp_bitmap_command_get_bitmap_mut(struct BitmapCommand */*notnull*/ instance);

/**
 * Gets the value of field `compression` of the [`servicepoint::BitmapCommand`].
 *
 * This function is part of the `bitmap_command` module.
 */
CompressionCode sp_bitmap_command_get_compression(struct BitmapCommand */*notnull*/ instance);

/**
 * Reads the origin field of the [`BitmapCommand`].
 *
 * This function is part of the `bitmap_command` module.
 */
void sp_bitmap_command_get_origin(struct BitmapCommand */*notnull*/ command,
                                  size_t */*notnull*/ origin_x,
                                  size_t */*notnull*/ origin_y);

/**
 * Sets a window of pixels to the specified values.
 *
 * The passed [Bitmap] gets consumed.
 *
 * Returns: a new [BitmapCommand] instance.
 *
 * This function is part of the `bitmap_command` module.
 */
struct BitmapCommand */*notnull*/ sp_bitmap_command_new(struct Bitmap */*notnull*/ bitmap,
                                                        size_t origin_x,
                                                        size_t origin_y,
                                                        CompressionCode compression);

/**
 * Sets the value of field `bitmap` of the [`servicepoint::BitmapCommand`].
 * The provided value is moved into the instance, potentially invalidating previously taken references.
 *
 * This function is part of the `bitmap_command` module.
 */
void sp_bitmap_command_set_bitmap(struct BitmapCommand */*notnull*/ instance,
                                  struct Bitmap */*notnull*/ value);

/**
 * Sets the value of field `compression` of the [`servicepoint::BitmapCommand`].
 *
 * This function is part of the `bitmap_command` module.
 */
void sp_bitmap_command_set_compression(struct BitmapCommand */*notnull*/ instance,
                                       CompressionCode value);

/**
 * Overwrites the origin field of the [`BitmapCommand`].
 *
 * This function is part of the `bitmap_command` module.
 */
void sp_bitmap_command_set_origin(struct BitmapCommand */*notnull*/ command,
                                  size_t origin_x,
                                  size_t origin_y);

/**
 *Tries to turn a [`BitmapCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `bitmap_command` module.
 */
struct Packet *sp_bitmap_command_try_into_packet(struct BitmapCommand */*notnull*/ instance);

/**
 * Calls method [`Bitmap::data_ref_mut`].
 *
 * Gets an unsafe reference to the data of the [Bitmap] instance.
 *
 * The returned memory is valid for the lifetime of the bitmap.
 *
 * This function is part of the `bitmap` module.
 */
struct ByteSlice sp_bitmap_data_ref_mut(struct Bitmap */*notnull*/ instance);

/**
 * Calls method [`Bitmap::fill`].
 *
 * Sets the state of all cells in the grid.
 *
 * # Arguments
 *
 * - `value`: the value to set all cells to
 *
 * This function is part of the `bitmap` module.
 */
void sp_bitmap_fill(struct Bitmap */*notnull*/ instance, bool value);

/**
 *Deallocates a [`Bitmap`] instance.
 *
 * This function is part of the `bitmap` module.
 */
void sp_bitmap_free(struct Bitmap */*notnull*/ instance);

/**
 * Tries to convert the BitVec to a Bitmap.
 *
 * The provided BitVec gets consumed.
 *
 * Returns NULL in case of error.
 *
 * This function is part of the `bitmap` module.
 */
struct Bitmap *sp_bitmap_from_bitvec(size_t width,
                                     DisplayBitVec */*notnull*/ bitvec);

/**
 * Calls method [`Bitmap::get`].
 *
 * Gets the current value at the specified position.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell to read
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 *
 * This function is part of the `bitmap` module.
 */
bool sp_bitmap_get(struct Bitmap */*notnull*/ instance, size_t x, size_t y);

/**
 * Calls method [`Bitmap::height`].
 *
 * Gets the height.
 *
 * This function is part of the `bitmap` module.
 */
size_t sp_bitmap_height(struct Bitmap */*notnull*/ instance);

/**
 * Consumes the Bitmap and returns the contained BitVec.
 *
 * This function is part of the `bitmap` module.
 */
DisplayBitVec */*notnull*/ sp_bitmap_into_bitvec(struct Bitmap */*notnull*/ bitmap);

/**
 * Loads a [Bitmap] with the specified dimensions from the provided data.
 *
 * # Arguments
 *
 * - `width`: size in pixels in x-direction
 * - `height`: size in pixels in y-direction
 *
 * returns: [Bitmap] that contains a copy of the provided data, or NULL in case of an error.
 *
 * This function is part of the `bitmap` module.
 */
struct Bitmap *sp_bitmap_load(size_t width,
                              size_t height,
                              struct ByteSlice data);

/**
 * Creates a new [Bitmap] with the specified dimensions.
 *
 * # Arguments
 *
 * - `width`: size in pixels in x-direction
 * - `height`: size in pixels in y-direction
 *
 * returns: [Bitmap] initialized to all pixels off, or NULL in case of an error.
 *
 * # Errors
 *
 * In the following cases, this function will return NULL:
 *
 * - when the width is not dividable by 8
 *
 * # Examples
 *
 * ```C
 * Cp437Grid grid = sp_bitmap_new(8, 3);
 * sp_bitmap_fill(grid, true);
 * sp_bitmap_set(grid, 0, 0, false);
 * sp_bitmap_free(grid);
 * ```
 *
 * This function is part of the `bitmap` module.
 */
struct Bitmap *sp_bitmap_new(size_t width, size_t height);

/**
 * Creates a new [Bitmap] with a size matching the screen.
 *
 * returns: [Bitmap] initialized to all pixels off.
 *
 * This function is part of the `bitmap` module.
 */
struct Bitmap */*notnull*/ sp_bitmap_new_max_sized(void);

/**
 * Calls method [`Bitmap::set`].
 *
 * Sets the value of the specified position.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell
 * - `value`: the value to write to the cell
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 *
 * This function is part of the `bitmap` module.
 */
void sp_bitmap_set(struct Bitmap */*notnull*/ instance,
                   size_t x,
                   size_t y,
                   bool value);

/**
 * Creates a [BitmapCommand] and immediately turns that into a [Packet].
 *
 * The provided [Bitmap] gets consumed.
 *
 * Returns NULL in case of an error.
 *
 * This function is part of the `bitmap` module.
 */
struct Packet *sp_bitmap_try_into_packet(struct Bitmap */*notnull*/ bitmap,
                                         size_t x,
                                         size_t y,
                                         CompressionCode compression);

/**
 * Calls method [`Bitmap::width`].
 *
 * Gets the width.
 *
 * This function is part of the `bitmap` module.
 */
size_t sp_bitmap_width(struct Bitmap */*notnull*/ instance);

/**
 * Calls method [`BrightnessGrid::clone`].
 *
 *Clones a [`BrightnessGrid`] instance.
 *
 * This function is part of the `brightness_grid` module.
 */
BrightnessGrid */*notnull*/ sp_brightness_grid_clone(BrightnessGrid */*notnull*/ instance);

/**
 * Calls method [`BrightnessGridCommand::clone`].
 *
 *Clones a [`BrightnessGridCommand`] instance.
 *
 * This function is part of the `brightness_grid_command` module.
 */
struct BrightnessGridCommand */*notnull*/ sp_brightness_grid_command_clone(struct BrightnessGridCommand */*notnull*/ instance);

/**
 *Deallocates a [`BrightnessGridCommand`] instance.
 *
 * This function is part of the `brightness_grid_command` module.
 */
void sp_brightness_grid_command_free(struct BrightnessGridCommand */*notnull*/ instance);

/**
 * Moves the provided [BrightnessGrid] into a new [BrightnessGridCommand],
 * leaving other fields as their default values.
 *
 * This function is part of the `brightness_grid_command` module.
 */
struct BrightnessGridCommand */*notnull*/ sp_brightness_grid_command_from_grid(BrightnessGrid */*notnull*/ grid);

/**
 * Gets a reference to the field `grid` of the [`servicepoint::BrightnessGridCommand`].
 *
 * - The returned reference inherits the lifetime of object in which it is contained.
 * - The returned pointer may not be used in a function that consumes the instance, e.g. to create a command.
 *
 * This function is part of the `brightness_grid_command` module.
 */
BrightnessGrid */*notnull*/ sp_brightness_grid_command_get_grid_mut(struct BrightnessGridCommand */*notnull*/ instance);

/**
 * Reads the origin field of the [`BrightnessGridCommand`].
 *
 * This function is part of the `brightness_grid_command` module.
 */
void sp_brightness_grid_command_get_origin(struct BrightnessGridCommand */*notnull*/ command,
                                           size_t */*notnull*/ origin_x,
                                           size_t */*notnull*/ origin_y);

/**
 * Set the brightness of individual tiles in a rectangular area of the display.
 *
 * The passed [BrightnessGrid] gets consumed.
 *
 * Returns: a new [BrightnessGridCommand] instance.
 *
 * This function is part of the `brightness_grid_command` module.
 */
struct BrightnessGridCommand */*notnull*/ sp_brightness_grid_command_new(BrightnessGrid */*notnull*/ grid,
                                                                         size_t origin_x,
                                                                         size_t origin_y);

/**
 * Sets the value of field `grid` of the [`servicepoint::BrightnessGridCommand`].
 * The provided value is moved into the instance, potentially invalidating previously taken references.
 *
 * This function is part of the `brightness_grid_command` module.
 */
void sp_brightness_grid_command_set_grid(struct BrightnessGridCommand */*notnull*/ instance,
                                         BrightnessGrid */*notnull*/ value);

/**
 * Overwrites the origin field of the [`BrightnessGridCommand`].
 *
 * This function is part of the `brightness_grid_command` module.
 */
void sp_brightness_grid_command_set_origin(struct BrightnessGridCommand */*notnull*/ command,
                                           size_t origin_x,
                                           size_t origin_y);

/**
 *Tries to turn a [`BrightnessGridCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `brightness_grid_command` module.
 */
struct Packet *sp_brightness_grid_command_try_into_packet(struct BrightnessGridCommand */*notnull*/ instance);

/**
 * Gets an unsafe reference to the data of the instance.
 *
 * The returned memory is valid for the lifetime of the grid.
 *
 * This function is part of the `brightness_grid` module.
 */
struct ByteSlice sp_brightness_grid_data_ref_mut(BrightnessGrid */*notnull*/ instance);

/**
 * Calls method [`BrightnessGrid::fill`].
 *
 * Sets the state of all cells in the grid.
 *
 * # Arguments
 *
 * - `value`: the value to set all cells to
 *
 * This function is part of the `brightness_grid` module.
 */
void sp_brightness_grid_fill(BrightnessGrid */*notnull*/ instance,
                             Brightness value);

/**
 *Deallocates a [`BrightnessGrid`] instance.
 *
 * This function is part of the `brightness_grid` module.
 */
void sp_brightness_grid_free(BrightnessGrid */*notnull*/ instance);

/**
 * Calls method [`BrightnessGrid::get`].
 *
 * Gets the current value at the specified position.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell to read
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 *
 * This function is part of the `brightness_grid` module.
 */
Brightness sp_brightness_grid_get(BrightnessGrid */*notnull*/ instance,
                                  size_t x,
                                  size_t y);

/**
 * Calls method [`BrightnessGrid::height`].
 *
 * Gets the height.
 *
 * This function is part of the `brightness_grid` module.
 */
size_t sp_brightness_grid_height(BrightnessGrid */*notnull*/ instance);

/**
 * 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.
 *
 * This function is part of the `brightness_grid` module.
 */
BrightnessGrid *sp_brightness_grid_load(size_t width,
                                        size_t height,
                                        struct ByteSlice data);

/**
 * Creates a new [BrightnessGrid] with the specified dimensions.
 *
 * returns: [BrightnessGrid] initialized to 0.
 *
 * # Examples
 * ```C
 * UdpSocket *connection = sp_udp_open("127.0.0.1:2342");
 * if (connection == NULL)
 *     return 1;
 *
 * BrightnessGrid *grid = sp_brightness_grid_new(2, 2);
 * sp_brightness_grid_set(grid, 0, 0, 0);
 * sp_brightness_grid_set(grid, 1, 1, 10);
 *
 * TypedCommand *command = sp_command_char_brightness(grid);
 * sp_udp_free(connection);
 * ```
 *
 * This function is part of the `brightness_grid` module.
 */
BrightnessGrid */*notnull*/ sp_brightness_grid_new(size_t width, size_t height);

/**
 * Calls method [`BrightnessGrid::set`].
 *
 * Sets the value of the specified position.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell
 * - `value`: the value to write to the cell
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 *
 * This function is part of the `brightness_grid` module.
 */
void sp_brightness_grid_set(BrightnessGrid */*notnull*/ instance,
                            size_t x,
                            size_t y,
                            Brightness value);

/**
 * Creates a [BrightnessGridCommand] and immediately turns that into a [Packet].
 *
 * The provided [BrightnessGrid] gets consumed.
 *
 * Returns NULL in case of an error.
 *
 * This function is part of the `brightness_grid` module.
 */
struct Packet *sp_brightness_grid_try_into_packet(BrightnessGrid */*notnull*/ grid,
                                                  size_t x,
                                                  size_t y);

/**
 * Calls method [`BrightnessGrid::width`].
 *
 * Gets the width.
 *
 * This function is part of the `brightness_grid` module.
 */
size_t sp_brightness_grid_width(BrightnessGrid */*notnull*/ instance);

/**
 * Calls method [`CharGrid::clone`].
 *
 *Clones a [`CharGrid`] instance.
 *
 * This function is part of the `char_grid` module.
 */
CharGrid */*notnull*/ sp_char_grid_clone(CharGrid */*notnull*/ instance);

/**
 * Calls method [`CharGridCommand::clone`].
 *
 *Clones a [`CharGridCommand`] instance.
 *
 * This function is part of the `char_grid_command` module.
 */
struct CharGridCommand */*notnull*/ sp_char_grid_command_clone(struct CharGridCommand */*notnull*/ instance);

/**
 *Deallocates a [`CharGridCommand`] instance.
 *
 * This function is part of the `char_grid_command` module.
 */
void sp_char_grid_command_free(struct CharGridCommand */*notnull*/ instance);

/**
 * Moves the provided [CharGrid] into a new [CharGridCommand],
 * leaving other fields as their default values.
 *
 * This function is part of the `char_grid_command` module.
 */
struct CharGridCommand */*notnull*/ sp_char_grid_command_from_grid(CharGrid */*notnull*/ grid);

/**
 * Gets a reference to the field `grid` of the [`servicepoint::CharGridCommand`].
 *
 * - The returned reference inherits the lifetime of object in which it is contained.
 * - The returned pointer may not be used in a function that consumes the instance, e.g. to create a command.
 *
 * This function is part of the `char_grid_command` module.
 */
CharGrid */*notnull*/ sp_char_grid_command_get_grid_mut(struct CharGridCommand */*notnull*/ instance);

/**
 * Reads the origin field of the [`CharGridCommand`].
 *
 * This function is part of the `char_grid_command` module.
 */
void sp_char_grid_command_get_origin(struct CharGridCommand */*notnull*/ command,
                                     size_t */*notnull*/ origin_x,
                                     size_t */*notnull*/ origin_y);

/**
 * Show UTF-8 encoded text on the screen.
 *
 * The passed [CharGrid] gets consumed.
 *
 * Returns: a new [CharGridCommand] instance.
 *
 * This function is part of the `char_grid_command` module.
 */
struct CharGridCommand */*notnull*/ sp_char_grid_command_new(CharGrid */*notnull*/ grid,
                                                             size_t origin_x,
                                                             size_t origin_y);

/**
 * Sets the value of field `grid` of the [`servicepoint::CharGridCommand`].
 * The provided value is moved into the instance, potentially invalidating previously taken references.
 *
 * This function is part of the `char_grid_command` module.
 */
void sp_char_grid_command_set_grid(struct CharGridCommand */*notnull*/ instance,
                                   CharGrid */*notnull*/ value);

/**
 * Overwrites the origin field of the [`CharGridCommand`].
 *
 * This function is part of the `char_grid_command` module.
 */
void sp_char_grid_command_set_origin(struct CharGridCommand */*notnull*/ command,
                                     size_t origin_x,
                                     size_t origin_y);

/**
 *Tries to turn a [`CharGridCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `char_grid_command` module.
 */
struct Packet *sp_char_grid_command_try_into_packet(struct CharGridCommand */*notnull*/ instance);

/**
 * Sets the value of all cells in the grid.
 *
 * # Arguments
 *
 * - `value`: the value to set all cells to
 * - when providing values that cannot be converted to Rust's `char`.
 *
 * This function is part of the `char_grid` module.
 */
void sp_char_grid_fill(CharGrid */*notnull*/ instance, uint32_t value);

/**
 *Deallocates a [`CharGrid`] instance.
 *
 * This function is part of the `char_grid` module.
 */
void sp_char_grid_free(CharGrid */*notnull*/ instance);

/**
 * Returns the current value at the specified position.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell to read
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 *
 * This function is part of the `char_grid` module.
 */
uint32_t sp_char_grid_get(CharGrid */*notnull*/ instance, size_t x, size_t y);

/**
 * Calls method [`CharGrid::height`].
 *
 * Gets the height.
 *
 * This function is part of the `char_grid` module.
 */
size_t sp_char_grid_height(CharGrid */*notnull*/ instance);

/**
 * Loads a [CharGrid] with the specified dimensions from the provided data.
 *
 * returns: new CharGrid or NULL in case of an error
 *
 * This function is part of the `char_grid` module.
 */
CharGrid *sp_char_grid_load(size_t width, size_t height, struct ByteSlice data);

/**
 * Creates a new [CharGrid] with the specified dimensions.
 *
 * returns: [CharGrid] initialized to 0.
 *
 * # Examples
 *
 * ```C
 * CharGrid grid = sp_char_grid_new(4, 3);
 * sp_char_grid_fill(grid, '?');
 * sp_char_grid_set(grid, 0, 0, '!');
 * sp_char_grid_free(grid);
 * ```
 *
 * This function is part of the `char_grid` module.
 */
CharGrid */*notnull*/ sp_char_grid_new(size_t width, size_t height);

/**
 * Sets the value of the specified position in the grid.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell
 * - `value`: the value to write to the cell
 *
 * returns: old value of the cell
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 * - when providing values that cannot be converted to Rust's `char`.
 *
 * This function is part of the `char_grid` module.
 */
void sp_char_grid_set(CharGrid */*notnull*/ instance,
                      size_t x,
                      size_t y,
                      uint32_t value);

/**
 * Creates a [CharGridCommand] and immediately turns that into a [Packet].
 *
 * The provided [CharGrid] gets consumed.
 *
 * Returns NULL in case of an error.
 *
 * This function is part of the `char_grid` module.
 */
struct Packet *sp_char_grid_try_into_packet(CharGrid */*notnull*/ grid,
                                            size_t x,
                                            size_t y);

/**
 * Calls method [`CharGrid::width`].
 *
 * Gets the width.
 *
 * This function is part of the `char_grid` module.
 */
size_t sp_char_grid_width(CharGrid */*notnull*/ instance);

/**
 * Calls method [`ClearCommand::clone`].
 *
 *Clones a [`ClearCommand`] instance.
 *
 * This function is part of the `clear_command` module.
 */
struct ClearCommand */*notnull*/ sp_clear_command_clone(struct ClearCommand */*notnull*/ instance);

/**
 *Deallocates a [`ClearCommand`] instance.
 *
 * This function is part of the `clear_command` module.
 */
void sp_clear_command_free(struct ClearCommand */*notnull*/ instance);

/**
 * Set all pixels to the off state.
 *
 * Does not affect brightness.
 *
 * Returns: a new [`ClearCommand`] instance.
 *
 * This function is part of the `clear_command` module.
 */
struct ClearCommand */*notnull*/ sp_clear_command_new(void);

/**
 *Tries to turn a [`ClearCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `clear_command` module.
 */
struct Packet *sp_clear_command_try_into_packet(struct ClearCommand */*notnull*/ instance);

/**
 * Calls method [`Cp437Grid::clone`].
 *
 *Clones a [`Cp437Grid`] instance.
 *
 * This function is part of the `cp437_grid` module.
 */
Cp437Grid */*notnull*/ sp_cp437_grid_clone(Cp437Grid */*notnull*/ instance);

/**
 * Calls method [`Cp437GridCommand::clone`].
 *
 *Clones a [`Cp437GridCommand`] instance.
 *
 * This function is part of the `cp437_grid_command` module.
 */
struct Cp437GridCommand */*notnull*/ sp_cp437_grid_command_clone(struct Cp437GridCommand */*notnull*/ instance);

/**
 *Deallocates a [`Cp437GridCommand`] instance.
 *
 * This function is part of the `cp437_grid_command` module.
 */
void sp_cp437_grid_command_free(struct Cp437GridCommand */*notnull*/ instance);

/**
 * Moves the provided [Cp437Grid] into a new [Cp437GridCommand],
 * leaving other fields as their default values.
 *
 * This function is part of the `cp437_grid_command` module.
 */
struct Cp437GridCommand */*notnull*/ sp_cp437_grid_command_from_grid(Cp437Grid */*notnull*/ grid);

/**
 * Gets a reference to the field `grid` of the [`servicepoint::Cp437GridCommand`].
 *
 * - The returned reference inherits the lifetime of object in which it is contained.
 * - The returned pointer may not be used in a function that consumes the instance, e.g. to create a command.
 *
 * This function is part of the `cp437_grid_command` module.
 */
Cp437Grid */*notnull*/ sp_cp437_grid_command_get_grid_mut(struct Cp437GridCommand */*notnull*/ instance);

/**
 * Reads the origin field of the [`Cp437GridCommand`].
 *
 * This function is part of the `cp437_grid_command` module.
 */
void sp_cp437_grid_command_get_origin(struct Cp437GridCommand */*notnull*/ command,
                                      size_t */*notnull*/ origin_x,
                                      size_t */*notnull*/ origin_y);

/**
 * Show text on the screen.
 *
 * The text is sent in the form of a 2D grid of [CP-437] encoded characters.
 *
 * The origin is relative to the top-left of the display.
 *
 * This function is part of the `cp437_grid_command` module.
 */
struct Cp437GridCommand */*notnull*/ sp_cp437_grid_command_new(Cp437Grid */*notnull*/ grid,
                                                               size_t origin_x,
                                                               size_t origin_y);

/**
 * Sets the value of field `grid` of the [`servicepoint::Cp437GridCommand`].
 * The provided value is moved into the instance, potentially invalidating previously taken references.
 *
 * This function is part of the `cp437_grid_command` module.
 */
void sp_cp437_grid_command_set_grid(struct Cp437GridCommand */*notnull*/ instance,
                                    Cp437Grid */*notnull*/ value);

/**
 * Overwrites the origin field of the [`Cp437GridCommand`].
 *
 * This function is part of the `cp437_grid_command` module.
 */
void sp_cp437_grid_command_set_origin(struct Cp437GridCommand */*notnull*/ command,
                                      size_t origin_x,
                                      size_t origin_y);

/**
 *Tries to turn a [`Cp437GridCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `cp437_grid_command` module.
 */
struct Packet *sp_cp437_grid_command_try_into_packet(struct Cp437GridCommand */*notnull*/ instance);

/**
 * Calls method [`Cp437Grid::data_ref_mut`].
 *
 * Gets an unsafe reference to the data of the grid.
 *
 * The returned memory is valid for the lifetime of the instance.
 *
 * This function is part of the `cp437_grid` module.
 */
struct ByteSlice sp_cp437_grid_data_ref_mut(Cp437Grid */*notnull*/ instance);

/**
 * Calls method [`Cp437Grid::fill`].
 *
 * Sets the state of all cells in the grid.
 *
 * # Arguments
 *
 * - `value`: the value to set all cells to
 *
 * This function is part of the `cp437_grid` module.
 */
void sp_cp437_grid_fill(Cp437Grid */*notnull*/ instance, uint8_t value);

/**
 *Deallocates a [`Cp437Grid`] instance.
 *
 * This function is part of the `cp437_grid` module.
 */
void sp_cp437_grid_free(Cp437Grid */*notnull*/ instance);

/**
 * Calls method [`Cp437Grid::get`].
 *
 * Gets the current value at the specified position.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell to read
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 *
 * This function is part of the `cp437_grid` module.
 */
uint8_t sp_cp437_grid_get(Cp437Grid */*notnull*/ instance, size_t x, size_t y);

/**
 * Calls method [`Cp437Grid::height`].
 *
 * Gets the height.
 *
 * This function is part of the `cp437_grid` module.
 */
size_t sp_cp437_grid_height(Cp437Grid */*notnull*/ instance);

/**
 * Loads a [Cp437Grid] with the specified dimensions from the provided data.
 *
 * This function is part of the `cp437_grid` module.
 */
Cp437Grid *sp_cp437_grid_load(size_t width,
                              size_t height,
                              struct ByteSlice data);

/**
 * Creates a new [Cp437Grid] with the specified dimensions.
 *
 * returns: [Cp437Grid] initialized to 0.
 *
 * This function is part of the `cp437_grid` module.
 */
Cp437Grid */*notnull*/ sp_cp437_grid_new(size_t width, size_t height);

/**
 * Calls method [`Cp437Grid::set`].
 *
 * Sets the value of the specified position.
 *
 * # Arguments
 *
 * - `x` and `y`: position of the cell
 * - `value`: the value to write to the cell
 *
 * # Panics
 *
 * - when accessing `x` or `y` out of bounds
 *
 * This function is part of the `cp437_grid` module.
 */
void sp_cp437_grid_set(Cp437Grid */*notnull*/ instance,
                       size_t x,
                       size_t y,
                       uint8_t value);

/**
 * Creates a [Cp437GridCommand] and immediately turns that into a [Packet].
 *
 * The provided [Cp437Grid] gets consumed.
 *
 * Returns NULL in case of an error.
 *
 * This function is part of the `cp437_grid` module.
 */
struct Packet *sp_cp437_grid_try_into_packet(Cp437Grid */*notnull*/ grid,
                                             size_t x,
                                             size_t y);

/**
 * Calls method [`Cp437Grid::width`].
 *
 * Gets the width.
 *
 * This function is part of the `cp437_grid` module.
 */
size_t sp_cp437_grid_width(Cp437Grid */*notnull*/ instance);

/**
 * Calls method [`DisplayBitVec::as_raw_mut_slice`].
 *
 * Gets an unsafe reference to the data of the [DisplayBitVec] instance.
 *
 * The returned memory is valid for the lifetime of the bitvec.
 *
 * This function is part of the `display_bit_vec` module.
 */
struct ByteSlice sp_display_bit_vec_as_raw_mut_slice(DisplayBitVec */*notnull*/ instance);

/**
 * Calls method [`DisplayBitVec::clone`].
 *
 *Clones a [`DisplayBitVec`] instance.
 *
 * This function is part of the `display_bit_vec` module.
 */
DisplayBitVec */*notnull*/ sp_display_bit_vec_clone(DisplayBitVec */*notnull*/ instance);

/**
 * Calls method [`DisplayBitVec::fill`].
 *
 * Sets the value of all bits.
 *
 * # Arguments
 *
 * - `value`: the value to set all bits to
 *
 * This function is part of the `display_bit_vec` module.
 */
void sp_display_bit_vec_fill(DisplayBitVec */*notnull*/ instance, bool value);

/**
 *Deallocates a [`DisplayBitVec`] instance.
 *
 * This function is part of the `display_bit_vec` module.
 */
void sp_display_bit_vec_free(DisplayBitVec */*notnull*/ instance);

/**
 * Gets the value of a bit.
 *
 * # Arguments
 *
 * - `bit_vec`: instance to read from
 * - `index`: the bit index to read
 *
 * returns: value of the bit
 *
 * # Panics
 *
 * - when accessing `index` out of bounds
 *
 * This function is part of the `display_bit_vec` module.
 */
bool sp_display_bit_vec_get(DisplayBitVec */*notnull*/ instance, size_t index);

/**
 * Calls method [`DisplayBitVec::is_empty`].
 *
 * Returns true if length is 0.
 *
 * This function is part of the `display_bit_vec` module.
 */
bool sp_display_bit_vec_is_empty(DisplayBitVec */*notnull*/ instance);

/**
 * Calls method [`DisplayBitVec::len`].
 *
 * Gets the length in bits.
 *
 * This function is part of the `display_bit_vec` module.
 */
size_t sp_display_bit_vec_len(DisplayBitVec */*notnull*/ instance);

/**
 * Interpret the data as a series of bits and load then into a new [DisplayBitVec] instance.
 *
 * returns: [DisplayBitVec] instance containing data.
 *
 * This function is part of the `display_bit_vec` module.
 */
DisplayBitVec */*notnull*/ sp_display_bit_vec_load(struct ByteSlice data);

/**
 * Creates a new [DisplayBitVec] instance.
 *
 * # Arguments
 *
 * - `size`: size in bits.
 *
 * returns: [DisplayBitVec] with all bits set to false.
 *
 * # Panics
 *
 * - when `size` is not divisible by 8.
 *
 * This function is part of the `display_bit_vec` module.
 */
DisplayBitVec */*notnull*/ sp_display_bit_vec_new(size_t size);

/**
 * Calls method [`DisplayBitVec::set`].
 *
 * Sets the value of a bit.
 *
 * # Arguments
 *
 * - `index`: the bit index to edit
 * - `value`: the value to set the bit to
 *
 * # Panics
 *
 * - when accessing `index` out of bounds
 *
 * This function is part of the `display_bit_vec` module.
 */
void sp_display_bit_vec_set(DisplayBitVec */*notnull*/ instance,
                            size_t index,
                            bool value);

/**
 * Creates a [BitVecCommand] and immediately turns that into a [Packet].
 *
 * The provided [DisplayBitVec] gets consumed.
 *
 * Returns NULL in case of an error.
 *
 * This function is part of the `display_bit_vec` module.
 */
struct Packet *sp_display_bit_vec_try_into_packet(DisplayBitVec */*notnull*/ bitvec,
                                                  size_t offset,
                                                  BinaryOperation operation,
                                                  CompressionCode compression);

/**
 * Call this function at the beginning of main to enable rust logging controlled by the
 * `RUST_LOG` environment variable. See [env_logger](https://docs.rs/env_logger/latest/env_logger/).
 *
 * This function is part of the `envlogger` module.
 */
void sp_envlogger_init(void);

/**
 * Calls method [`FadeOutCommand::clone`].
 *
 *Clones a [`FadeOutCommand`] instance.
 *
 * This function is part of the `fade_out_command` module.
 */
struct FadeOutCommand */*notnull*/ sp_fade_out_command_clone(struct FadeOutCommand */*notnull*/ instance);

/**
 *Deallocates a [`FadeOutCommand`] instance.
 *
 * This function is part of the `fade_out_command` module.
 */
void sp_fade_out_command_free(struct FadeOutCommand */*notnull*/ instance);

/**
 * A yet-to-be-tested command.
 *
 * Returns: a new [`FadeOutCommand`] instance.
 *
 * This function is part of the `fade_out_command` module.
 */
struct FadeOutCommand */*notnull*/ sp_fade_out_command_new(void);

/**
 *Tries to turn a [`FadeOutCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `fade_out_command` module.
 */
struct Packet *sp_fade_out_command_try_into_packet(struct FadeOutCommand */*notnull*/ instance);

/**
 * Calls method [`GenericCommand::clone`].
 *
 *Clones a [`GenericCommand`] instance.
 *
 * This function is part of the `generic_command` module.
 */
struct GenericCommand */*notnull*/ sp_generic_command_clone(struct GenericCommand */*notnull*/ instance);

/**
 *Deallocates a [`GenericCommand`] instance.
 *
 * This function is part of the `generic_command` module.
 */
void sp_generic_command_free(struct GenericCommand */*notnull*/ instance);

/**
 * Tries to turn a [Packet] into a [GenericCommand].
 *
 * The packet is dropped in the process.
 *
 * Returns: pointer to new [GenericCommand] instance or NULL if parsing failed.
 *
 * This function is part of the `generic_command` module.
 */
struct GenericCommand */*notnull*/ sp_generic_command_try_from_packet(struct Packet */*notnull*/ packet);

/**
 * Tries to turn a [GenericCommand] into a [Packet].
 * The [GenericCommand] gets consumed.
 *
 * Returns tag [CommandTag::Invalid] in case of an error.
 *
 * This function is part of the `generic_command` module.
 */
struct Packet *sp_generic_command_try_into_packet(struct GenericCommand */*notnull*/ command);

/**
 * Calls method [`GlobalBrightnessCommand::clone`].
 *
 *Clones a [`GlobalBrightnessCommand`] instance.
 *
 * This function is part of the `global_brightness_command` module.
 */
struct GlobalBrightnessCommand */*notnull*/ sp_global_brightness_command_clone(struct GlobalBrightnessCommand */*notnull*/ instance);

/**
 *Deallocates a [`GlobalBrightnessCommand`] instance.
 *
 * This function is part of the `global_brightness_command` module.
 */
void sp_global_brightness_command_free(struct GlobalBrightnessCommand */*notnull*/ instance);

/**
 * Gets the value of field `brightness` of the [`servicepoint::GlobalBrightnessCommand`].
 *
 * This function is part of the `global_brightness_command` module.
 */
Brightness sp_global_brightness_command_get_brightness(struct GlobalBrightnessCommand */*notnull*/ instance);

/**
 * Set the brightness of all tiles to the same value.
 *
 * Returns: a new [GlobalBrightnessCommand] instance.
 *
 * This function is part of the `global_brightness_command` module.
 */
struct GlobalBrightnessCommand */*notnull*/ sp_global_brightness_command_new(Brightness brightness);

/**
 * Sets the value of field `brightness` of the [`servicepoint::GlobalBrightnessCommand`].
 *
 * This function is part of the `global_brightness_command` module.
 */
void sp_global_brightness_command_set_brightness(struct GlobalBrightnessCommand */*notnull*/ instance,
                                                 Brightness value);

/**
 *Tries to turn a [`GlobalBrightnessCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `global_brightness_command` module.
 */
struct Packet *sp_global_brightness_command_try_into_packet(struct GlobalBrightnessCommand */*notnull*/ instance);

/**
 * Calls method [`HardResetCommand::clone`].
 *
 *Clones a [`HardResetCommand`] instance.
 *
 * This function is part of the `hard_reset_command` module.
 */
struct HardResetCommand */*notnull*/ sp_hard_reset_command_clone(struct HardResetCommand */*notnull*/ instance);

/**
 *Deallocates a [`HardResetCommand`] instance.
 *
 * This function is part of the `hard_reset_command` module.
 */
void sp_hard_reset_command_free(struct HardResetCommand */*notnull*/ instance);

/**
 * Kills the udp daemon on the display, which usually results in a restart.
 *
 * Please do not send this in your normal program flow.
 *
 * Returns: a new [`HardResetCommand`] instance.
 *
 * This function is part of the `hard_reset_command` module.
 */
struct HardResetCommand */*notnull*/ sp_hard_reset_command_new(void);

/**
 *Tries to turn a [`HardResetCommand`] into a [Packet].
 *
 * Returns: NULL or a [Packet] containing the command.
 *
 * [Packet]: [`servicepoint::Packet`]
 *
 * This function is part of the `hard_reset_command` module.
 */
struct Packet *sp_hard_reset_command_try_into_packet(struct HardResetCommand */*notnull*/ instance);

/**
 * Calls method [`Packet::clone`].
 *
 *Clones a [`Packet`] instance.
 *
 * This function is part of the `packet` module.
 */
struct Packet */*notnull*/ sp_packet_clone(struct Packet */*notnull*/ instance);

/**
 *Deallocates a [`Packet`] instance.
 *
 * This function is part of the `packet` module.
 */
void sp_packet_free(struct Packet */*notnull*/ instance);

/**
 * Creates a raw [Packet] from parts.
 *
 * returns: new instance. Will never return null.
 *
 * This function is part of the `packet` module.
 */
struct Packet */*notnull*/ sp_packet_from_parts(struct Header header,
                                                struct ByteSlice payload);

/**
 * Gets the value of field `header` of the [`servicepoint::Packet`].
 *
 * This function is part of the `packet` module.
 */
struct Header sp_packet_get_header(struct Packet */*notnull*/ instance);

/**
 * Gets a reference to the field `header` of the [`servicepoint::Packet`].
 *
 * - The returned reference inherits the lifetime of object in which it is contained.
 * - The returned pointer may not be used in a function that consumes the instance, e.g. to create a command.
 *
 * This function is part of the `packet` module.
 */
struct Header */*notnull*/ sp_packet_get_header_mut(struct Packet */*notnull*/ instance);

/**
 * Returns a pointer to the current payload of the provided packet.
 *
 * Returns an [ByteSlice::INVALID] instance in case the packet does not have any payload.
 *
 * The returned memory can be changed and will be valid until a new payload is set.
 *
 * This function is part of the `packet` module.
 */
struct ByteSlice sp_packet_get_payload(struct Packet */*notnull*/ packet);

/**
 * Serialize the packet into the provided buffer.
 *
 * # Panics
 *
 * - if the buffer is not big enough to hold header+payload.
 *
 * This function is part of the `packet` module.
 */
size_t sp_packet_serialize_to(struct Packet */*notnull*/ packet,
                              struct ByteSlice buffer);

/**
 * Sets the value of field `header` of the [`servicepoint::Packet`].
 *
 * This function is part of the `packet` module.
 */
void sp_packet_set_header(struct Packet */*notnull*/ instance,
                          struct Header value);

/**
 * Sets the payload of the provided packet to the provided data.
 *
 * This makes previous payload pointers invalid.
 *
 * This function is part of the `packet` module.
 */
void sp_packet_set_payload(struct Packet */*notnull*/ packet,
                           struct ByteSlice data);

/**
 * Tries to load a [Packet] from the passed array with the specified length.
 *
 * returns: NULL in case of an error, pointer to the allocated packet otherwise
 *
 * This function is part of the `packet` module.
 */
struct Packet *sp_packet_try_load(struct ByteSlice data);

/**
 * Converts u16 into [CommandCode].
 *
 * If the provided value is not valid, false is returned and result is not changed.
 *
 * This function is part of the `sp` module.
 */
bool sp_sp_u16_to_command_code(uint16_t code,
                               CommandCode */*notnull*/ result);

/**
 *Deallocates a [`UdpSocket`] instance.
 *
 * This function is part of the `udp_socket` module.
 */
void sp_udp_socket_free(struct UdpSocket */*notnull*/ instance);

/**
 * Creates a new instance of [UdpSocket].
 *
 * returns: NULL if connection fails, or connected instance
 *
 * # Examples
 *
 * ```C
 * UdpSocket connection = sp_udp_open("172.23.42.29:2342");
 * if (connection != NULL)
 *     sp_udp_send_command(connection, sp_command_clear());
 * ```
 *
 * This function is part of the `udp_socket` module.
 */
struct UdpSocket *sp_udp_socket_open(char */*notnull*/ host);

/**
 * Creates a new instance of [UdpSocket].
 *
 * returns: NULL if connection fails, or connected instance
 *
 * # Examples
 *
 * ```C
 * UdpSocket connection = sp_udp_open_ipv4(172, 23, 42, 29, 2342);
 * if (connection != NULL)
 *     sp_udp_send_command(connection, sp_command_clear());
 * ```
 *
 * This function is part of the `udp_socket` module.
 */
struct UdpSocket *sp_udp_socket_open_ipv4(uint8_t ip1,
                                          uint8_t ip2,
                                          uint8_t ip3,
                                          uint8_t ip4,
                                          uint16_t port);

/**
 * Sends a [GenericCommand] to the display using the [UdpSocket].
 *
 * The passed `command` gets consumed.
 *
 * returns: true in case of success
 *
 * # Examples
 *
 * ```C
 * sp_udp_send_command(connection, sp_command_brightness(5));
 * ```
 *
 * This function is part of the `udp_socket` module.
 */
bool sp_udp_socket_send_command(struct UdpSocket */*notnull*/ connection,
                                struct GenericCommand */*notnull*/ command);

/**
 * Sends a [Header] to the display using the [UdpSocket].
 *
 * returns: true in case of success
 *
 * # Examples
 *
 * ```C
 * sp_udp_send_header(connection, sp_command_brightness(5));
 * ```
 *
 * This function is part of the `udp_socket` module.
 */
bool sp_udp_socket_send_header(struct UdpSocket */*notnull*/ udp_connection,
                               struct Header header);

/**
 * Sends a [Packet] to the display using the [UdpSocket].
 *
 * The passed `packet` gets consumed.
 *
 * returns: true in case of success
 *
 * This function is part of the `udp_socket` module.
 */
bool sp_udp_socket_send_packet(struct UdpSocket */*notnull*/ connection,
                               struct Packet */*notnull*/ packet);

#ifdef __cplusplus
}  // extern "C"
#endif  // __cplusplus

#endif  /* SERVICEPOINT_BINDINGS_C */