File f32_to_i8_core.h¶

#ifndef DP_F32_TO_I8_CORE_H
#define DP_F32_TO_I8_CORE_H

#include "doppler/clib_common.h"
#include "doppler/dp_state.h"
#include "doppler/jm_perf.h"
#include <math.h>
#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
    float   scale;   /* multiply factor applied before saturation */
    uint8_t clipped; /* 1 if any sample has been saturated; 0 otherwise */
} dp_f32_to_i8_state_t;

dp_f32_to_i8_state_t *dp_f32_to_i8_create(float scale);

void dp_f32_to_i8_destroy(dp_f32_to_i8_state_t *state);

void dp_f32_to_i8_reset(dp_f32_to_i8_state_t *state);

JM_FORCEINLINE JM_HOT int8_t
dp_f32_to_i8_step(dp_f32_to_i8_state_t *state, float x)
{
    float s = state->scale * x;
    /* Detect saturation before clamping; set sticky flag. */
    state->clipped |= (uint8_t)(s > 127.0f || s < -128.0f);
    s = fmaxf(s, -128.0f);
    s = fminf(s,  127.0f);
    return (int8_t)lroundf(s);
}

void dp_f32_to_i8_steps(
    dp_f32_to_i8_state_t *state,
    const float    *input,
    int8_t          *output,
    size_t               n);

/* ── Serializable state (standard bytes interface; see dp_state.h) ──────────
 * Whole-struct POD snapshot (pointer-free); the sticky clip flag resumes exactly into an
 * identically-built instance. */
#define F32_TO_I8_STATE_MAGIC DP_FOURCC ('F','2','_','8')
#define F32_TO_I8_STATE_VERSION 1u
size_t dp_f32_to_i8_state_bytes (const dp_f32_to_i8_state_t *state);
void dp_f32_to_i8_get_state (const dp_f32_to_i8_state_t *state, void *blob);
int dp_f32_to_i8_set_state (dp_f32_to_i8_state_t *state, const void *blob);

#ifdef __cplusplus
}
#endif

#endif /* F32_TO_I8_CORE_H */