regenerate C header

This commit is contained in:
Vinzenz Schroeter 2024-11-13 18:36:59 +01:00
parent 3d74bfe05e
commit eed6d114fc

View file

@ -144,6 +144,8 @@ typedef struct SPBrightnessGrid SPBrightnessGrid;
* sp_connection_send_command(connection, sp_command_clear()); * sp_connection_send_command(connection, sp_command_clear());
* sp_connection_send_command(connection, sp_command_brightness(5)); * sp_connection_send_command(connection, sp_command_brightness(5));
* ``` * ```
*
* [SPConnection]: [crate::SPConnection]
*/ */
typedef struct SPCommand SPCommand; typedef struct SPCommand SPCommand;
@ -266,6 +268,8 @@ void sp_bitmap_fill(SPBitmap *bitmap, bool value);
* - `bitmap` points to a valid [SPBitmap] * - `bitmap` points to a valid [SPBitmap]
* - `bitmap` is not used concurrently or after bitmap call * - `bitmap` is not used concurrently or after bitmap call
* - `bitmap` was not passed to another consuming function, e.g. to create a [SPCommand] * - `bitmap` was not passed to another consuming function, e.g. to create a [SPCommand]
*
* [SPCommand]: [crate::SPCommand]
*/ */
void sp_bitmap_free(SPBitmap *bitmap); void sp_bitmap_free(SPBitmap *bitmap);
@ -479,6 +483,8 @@ void sp_bitvec_fill(SPBitVec *bit_vec, bool value);
* - `bit_vec` points to a valid [SPBitVec] * - `bit_vec` points to a valid [SPBitVec]
* - `bit_vec` is not used concurrently or after this call * - `bit_vec` is not used concurrently or after this call
* - `bit_vec` was not passed to another consuming function, e.g. to create a [SPCommand] * - `bit_vec` was not passed to another consuming function, e.g. to create a [SPCommand]
*
* [SPCommand]: [crate::SPCommand]
*/ */
void sp_bitvec_free(SPBitVec *bit_vec); void sp_bitvec_free(SPBitVec *bit_vec);
@ -695,6 +701,8 @@ void sp_brightness_grid_fill(SPBrightnessGrid *brightness_grid, uint8_t value);
* - `brightness_grid` points to a valid [SPBrightnessGrid] * - `brightness_grid` points to a valid [SPBrightnessGrid]
* - `brightness_grid` is not used concurrently or after this call * - `brightness_grid` is not used concurrently or after this call
* - `brightness_grid` was not passed to another consuming function, e.g. to create a [SPCommand] * - `brightness_grid` was not passed to another consuming function, e.g. to create a [SPCommand]
*
* [SPCommand]: [crate::SPCommand]
*/ */
void sp_brightness_grid_free(SPBrightnessGrid *brightness_grid); void sp_brightness_grid_free(SPBrightnessGrid *brightness_grid);
@ -805,7 +813,7 @@ SPBrightnessGrid *sp_brightness_grid_new(size_t width,
* *
* The caller has to make sure that: * The caller has to make sure that:
* *
* - `brightness_grid` points to a valid [SPBitVec] * - `brightness_grid` points to a valid [SPBrightnessGrid]
* - `brightness_grid` is not written to or read from concurrently * - `brightness_grid` is not written to or read from concurrently
*/ */
void sp_brightness_grid_set(SPBrightnessGrid *brightness_grid, void sp_brightness_grid_set(SPBrightnessGrid *brightness_grid,
@ -867,7 +875,7 @@ size_t sp_brightness_grid_width(const SPBrightnessGrid *brightness_grid);
* *
* The passed [SPBitVec] gets consumed. * The passed [SPBitVec] gets consumed.
* *
* Returns: a new [Command::BitmapLinear] instance. Will never return NULL. * Returns: a new [servicepoint::Command::BitmapLinear] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -898,7 +906,7 @@ SPCommand *sp_command_bitmap_linear(size_t offset,
* *
* The passed [SPBitVec] gets consumed. * The passed [SPBitVec] gets consumed.
* *
* Returns: a new [Command::BitmapLinearAnd] instance. Will never return NULL. * Returns: a new [servicepoint::Command::BitmapLinearAnd] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -929,7 +937,7 @@ SPCommand *sp_command_bitmap_linear_and(size_t offset,
* *
* The passed [SPBitVec] gets consumed. * The passed [SPBitVec] gets consumed.
* *
* Returns: a new [Command::BitmapLinearOr] instance. Will never return NULL. * Returns: a new [servicepoint::Command::BitmapLinearOr] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -955,7 +963,7 @@ SPCommand *sp_command_bitmap_linear_or(size_t offset,
* *
* The passed [SPBitmap] gets consumed. * The passed [SPBitmap] gets consumed.
* *
* Returns: a new [Command::BitmapLinearWin] instance. Will never return NULL. * Returns: a new [servicepoint::Command::BitmapLinearWin] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -987,7 +995,7 @@ SPCommand *sp_command_bitmap_linear_win(size_t x,
* *
* The passed [SPBitVec] gets consumed. * The passed [SPBitVec] gets consumed.
* *
* Returns: a new [Command::BitmapLinearXor] instance. Will never return NULL. * Returns: a new [servicepoint::Command::BitmapLinearXor] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -1011,7 +1019,7 @@ SPCommand *sp_command_bitmap_linear_xor(size_t offset,
/** /**
* Set the brightness of all tiles to the same value. * Set the brightness of all tiles to the same value.
* *
* Returns: a new [Command::Brightness] instance. Will never return NULL. * Returns: a new [servicepoint::Command::Brightness] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -1031,7 +1039,7 @@ SPCommand *sp_command_brightness(uint8_t brightness);
* *
* The passed [SPBrightnessGrid] gets consumed. * The passed [SPBrightnessGrid] gets consumed.
* *
* Returns: a new [Command::CharBrightness] instance. Will never return NULL. * Returns: a new [servicepoint::Command::CharBrightness] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -1055,7 +1063,7 @@ SPCommand *sp_command_char_brightness(size_t x,
* *
* Does not affect brightness. * Does not affect brightness.
* *
* Returns: a new [Command::Clear] instance. Will never return NULL. * Returns: a new [servicepoint::Command::Clear] instance. Will never return NULL.
* *
* # Examples * # Examples
* *
@ -1097,7 +1105,7 @@ SPCommand *sp_command_clone(const SPCommand *command);
* *
* The passed [SPCp437Grid] gets consumed. * The passed [SPCp437Grid] gets consumed.
* *
* Returns: a new [Command::Cp437Data] instance. Will never return NULL. * Returns: a new [servicepoint::Command::Cp437Data] instance. Will never return NULL.
* *
* # Panics * # Panics
* *
@ -1119,7 +1127,7 @@ SPCommand *sp_command_cp437_data(size_t x,
/** /**
* A yet-to-be-tested command. * A yet-to-be-tested command.
* *
* Returns: a new `Command::FadeOut` instance. Will never return NULL. * Returns: a new [servicepoint::Command::FadeOut] instance. Will never return NULL.
* *
* # Safety * # Safety
* *
@ -1159,7 +1167,7 @@ void sp_command_free(SPCommand *command);
* *
* Please do not send this in your normal program flow. * Please do not send this in your normal program flow.
* *
* Returns: a new [Command::HardReset] instance. Will never return NULL. * Returns: a new [servicepoint::Command::HardReset] instance. Will never return NULL.
* *
* # Safety * # Safety
* *
@ -1328,6 +1336,8 @@ void sp_cp437_grid_fill(SPCp437Grid *cp437_grid, uint8_t value);
* - `cp437_grid` points to a valid [SPCp437Grid] * - `cp437_grid` points to a valid [SPCp437Grid]
* - `cp437_grid` is not used concurrently or after cp437_grid call * - `cp437_grid` is not used concurrently or after cp437_grid call
* - `cp437_grid` was not passed to another consuming function, e.g. to create a [SPCommand] * - `cp437_grid` was not passed to another consuming function, e.g. to create a [SPCommand]
*
* [SPCommand]: [crate::SPCommand]
*/ */
void sp_cp437_grid_free(SPCp437Grid *cp437_grid); void sp_cp437_grid_free(SPCp437Grid *cp437_grid);
@ -1433,6 +1443,8 @@ SPCp437Grid *sp_cp437_grid_new(size_t width,
* *
* - `cp437_grid` points to a valid [SPBitVec] * - `cp437_grid` points to a valid [SPBitVec]
* - `cp437_grid` is not written to or read from concurrently * - `cp437_grid` is not written to or read from concurrently
*
* [SPBitVec]: [crate::SPBitVec]
*/ */
void sp_cp437_grid_set(SPCp437Grid *cp437_grid, void sp_cp437_grid_set(SPCp437Grid *cp437_grid,
size_t x, size_t x,