controller.h File Reference

Go to the source code of this file.

Data Structures
struct	animation_config_t
struct	animation_sample_t
	For animation config, this is the live record that ties type, fps, speed, hidden_policy together. The owning code creates it, updates it while work is active, and releases its handles and pointed-to storage before freeing the record. More...
struct	animation_t
struct	animation_target_t

Enumerations
enum	animation_type_t { ANIMATION_SPLASH_RAINBOW , ANIMATION_DIGITAL_RAIN , ANIMATION_RAINBOW_FILTER , ANIMATION_TEST_PATTERN }
enum	animation_hidden_policy_t { ANIMATION_HIDDEN_PAUSE , ANIMATION_HIDDEN_CONTINUE }
enum	animation_target_type_t { ANIMATION_TARGET_COLOR , ANIMATION_TARGET_ANSI , ANIMATION_TARGET_TEST_PATTERN }

Functions
asciichat_error_t	animation_init (animation_t *animation, const char *name, animation_config_t config)
void	animation_destroy (animation_t *animation)
void	animation_reset (animation_t *animation)
void	animation_set_paused (animation_t *animation, bool paused)
void	animation_set_visible (animation_t *animation, bool visible)
asciichat_error_t	animation_set_speed (animation_t *animation, double speed)
asciichat_error_t	animation_update (animation_t *animation, uint64_t timestamp_ns, animation_sample_t *out)
asciichat_error_t	animation_sample_at (animation_config_t config, double seconds, animation_sample_t *out)
asciichat_error_t	animation_apply (const animation_sample_t *sample, animation_target_t *target)

Enumeration Type Documentation

animation_hidden_policy_t

enum animation_hidden_policy_t

Enumerator
ANIMATION_HIDDEN_PAUSE
ANIMATION_HIDDEN_CONTINUE

Definition at line 15 of file video/anim/controller.h.

{ ANIMATION_HIDDEN_PAUSE, ANIMATION_HIDDEN_CONTINUE } animation_hidden_policy_t;

animation_target_type_t

enum animation_target_type_t

Enumerator
ANIMATION_TARGET_COLOR
ANIMATION_TARGET_ANSI
ANIMATION_TARGET_TEST_PATTERN

Definition at line 66 of file video/anim/controller.h.

{ ANIMATION_TARGET_COLOR, ANIMATION_TARGET_ANSI, ANIMATION_TARGET_TEST_PATTERN } animation_target_type_t;

animation_type_t

enum animation_type_t

Enumerator
ANIMATION_SPLASH_RAINBOW
ANIMATION_DIGITAL_RAIN
ANIMATION_RAINBOW_FILTER
ANIMATION_TEST_PATTERN

Definition at line 8 of file video/anim/controller.h.

             {
  ANIMATION_SPLASH_RAINBOW,
  ANIMATION_DIGITAL_RAIN,
  ANIMATION_RAINBOW_FILTER,
  ANIMATION_TEST_PATTERN,
} animation_type_t;

Function Documentation

animation_apply()

asciichat_error_t animation_apply	(	const animation_sample_t *	sample,
		animation_target_t *	target )

Definition at line 89 of file video/anim/controller.c.

                                                                                      {
  if (!s || !t || !isfinite(s->seconds) || s->seconds < 0)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid animation sample or target");
  switch (s->type) {
  case ANIMATION_SPLASH_RAINBOW: {
    if (t->type != ANIMATION_TARGET_COLOR || !t->color.out || !isfinite(t->color.position))
      break;
    static const rgb_pixel_t colors[] = {{255, 0, 0},   {255, 165, 0}, {255, 255, 0}, {0, 255, 0},
                                         {0, 255, 255}, {0, 0, 255},   {255, 0, 255}};
    double position = fmod(t->color.position, 1.0) + fmod(s->seconds, 2.5) * 0.4;
    double phase = (position - floor(position)) * 6;
    int i = (int)phase;
    double blend = phase - i;
    rgb_pixel_t a = colors[i], b = colors[i + 1];
    *t->color.out =
        (rgb_pixel_t){(uint8_t)(a.r * (1 - blend) + b.r * blend), (uint8_t)(a.g * (1 - blend) + b.g * blend),
                      (uint8_t)(a.b * (1 - blend) + b.b * blend)};
    return ASCIICHAT_OK;
  }
  case ANIMATION_RAINBOW_FILTER:
    if (t->type == ANIMATION_TARGET_COLOR && t->color.out) {
      color_filter_calculate_rainbow((float)fmod(s->seconds, 3.5), &t->color.out->r, &t->color.out->g,
                                     &t->color.out->b);
      return ASCIICHAT_OK;
    }
    if (t->type != ANIMATION_TARGET_ANSI || !t->ansi.input || !t->ansi.out)
      break;
    *t->ansi.out = rainbow_render_ansi_at(t->ansi.input, (float)fmod(s->seconds, 3.5));
    return *t->ansi.out ? ASCIICHAT_OK : SET_ERRNO(ERROR_MEMORY, "Rainbow output allocation failed");
  case ANIMATION_DIGITAL_RAIN:
    if (t->type != ANIMATION_TARGET_ANSI || !t->ansi.input || !t->ansi.out || !t->ansi.rain)
      break;
    *t->ansi.out = digital_rain_render_at(t->ansi.rain, t->ansi.input, (float)s->seconds);
    return *t->ansi.out ? ASCIICHAT_OK : SET_ERRNO(ERROR_MEMORY, "Digital rain output allocation failed");
  case ANIMATION_TEST_PATTERN:
    if (t->type != ANIMATION_TARGET_TEST_PATTERN || !t->test_pattern.context)
      break;
    return test_pattern_render_at(t->test_pattern.context, t->test_pattern.index, s->seconds * 1000.0,
                                  t->test_pattern.cadence);
  }
  return SET_ERRNO(ERROR_INVALID_PARAM, "Animation type does not support this target");
}

References ANIMATION_DIGITAL_RAIN, ANIMATION_RAINBOW_FILTER, ANIMATION_SPLASH_RAINBOW, ANIMATION_TARGET_ANSI, ANIMATION_TARGET_COLOR, ANIMATION_TARGET_TEST_PATTERN, ANIMATION_TEST_PATTERN, animation_target_t::ansi, ASCIICHAT_OK, rgb_pixel_t::b, animation_target_t::cadence, animation_target_t::color, color_filter_calculate_rainbow(), colors, animation_target_t::context, digital_rain_render_at(), ERROR_INVALID_PARAM, ERROR_MEMORY, rgb_pixel_t::g, animation_target_t::index, animation_target_t::input, animation_target_t::out, animation_target_t::position, rgb_pixel_t::r, animation_target_t::rain, rainbow_render_ansi_at(), animation_sample_t::seconds, SET_ERRNO, animation_target_t::test_pattern, test_pattern_render_at(), animation_sample_t::type, and animation_target_t::type.

Referenced by digital_rain_apply(), rainbow_replace_ansi_colors(), and test_pattern_render().

animation_destroy()

void animation_destroy

(

animation_t *

animation

)

Definition at line 24 of file video/anim/controller.c.

                                       {
  if (!a)
    return;
  NAMED_UNREGISTER(a);
  memset(a, 0, sizeof(*a));
}

References NAMED_UNREGISTER.

Referenced by digital_rain_destroy(), and ui_session_destroy().

animation_init()

asciichat_error_t animation_init	(	animation_t *	animation,
		const char *	name,
		animation_config_t	config )

Definition at line 16 of file video/anim/controller.c.

                                                                                              {
  if (!a || !name || !valid_config(config))
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid animation configuration");
  *a = (animation_t){.config = config, .visible = true};
  NAMED_REGISTER(a, name, "animation", NULL, NULL);
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, ERROR_INVALID_PARAM, NAMED_REGISTER, and SET_ERRNO.

Referenced by digital_rain_init(), and ui_session_create().

animation_reset()

void animation_reset

(

animation_t *

animation

)

Definition at line 31 of file video/anim/controller.c.

                                     {
  if (!a)
    return;
  a->seconds = 0;
  a->started = false;
  a->last_frame = 0;
}

References animation_t::last_frame, animation_t::seconds, and animation_t::started.

Referenced by digital_rain_reset(), and ui_session_loading().

animation_sample_at()

asciichat_error_t animation_sample_at	(	animation_config_t	config,
		double	seconds,
		animation_sample_t *	out )

Definition at line 53 of file video/anim/controller.c.

                                                                                                          {
  if (!out || !valid_config(config) || !isfinite(seconds) || seconds < 0 || seconds * config.fps >= (double)UINT64_MAX)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid animation timestamp");
  *out = (animation_sample_t){.type = config.type,
                              .seconds = seconds,
                              .frame = (uint64_t)(seconds * config.fps),
                              .changed = true,
                              .next_frame_ns = UINT64_MAX};
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, ERROR_INVALID_PARAM, animation_config_t::fps, out, SET_ERRNO, and animation_config_t::type.

Referenced by animation_update(), rainbow_replace_ansi_colors(), and test_pattern_render().

animation_set_paused()

void animation_set_paused	(	animation_t *	animation,
		bool	paused )

Definition at line 38 of file video/anim/controller.c.

                                                       {
  if (a)
    a->paused = paused;
}

References animation_t::paused.

animation_set_speed()

asciichat_error_t animation_set_speed	(	animation_t *	animation,
		double	speed )

Definition at line 46 of file video/anim/controller.c.

                                                                    {
  if (!a || !isfinite(speed) || speed < 0)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid animation speed");
  a->config.speed = speed;
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, animation_t::config, ERROR_INVALID_PARAM, SET_ERRNO, and animation_config_t::speed.

Referenced by digital_rain_apply().

animation_set_visible()

void animation_set_visible	(	animation_t *	animation,
		bool	visible )

Definition at line 42 of file video/anim/controller.c.

                                                         {
  if (a)
    a->visible = visible;
}

References animation_t::visible.

Referenced by ui_session_render().

animation_update()

asciichat_error_t animation_update	(	animation_t *	animation,
		uint64_t	timestamp_ns,
		animation_sample_t *	out )

Definition at line 64 of file video/anim/controller.c.

                                                                                          {
  if (!a || !out || !valid_config(a->config) || (a->started && now < a->last_ns))
    return SET_ERRNO(ERROR_INVALID_PARAM, "Animation timestamps must be monotonic; reset before seeking");
  bool running =
      !a->paused && a->config.speed > 0 && (a->visible || a->config.hidden_policy == ANIMATION_HIDDEN_CONTINUE);
  double seconds = a->seconds;
  if (a->started && running)
    seconds += (double)(now - a->last_ns) / 1e9 * a->config.speed;
  asciichat_error_t err = animation_sample_at(a->config, seconds, out);
  if (err != ASCIICHAT_OK)
    return err;
  out->changed = !a->started || out->frame != a->last_frame;
  if (running) {
    double remaining = ((double)out->frame + 1.0) / a->config.fps - seconds;
    double delay = ceil(fmax(1.0, remaining * 1e9 / a->config.speed));
    if (delay < (double)(UINT64_MAX - now))
      out->next_frame_ns = now + (uint64_t)delay;
  }
  a->seconds = seconds;
  a->last_ns = now;
  a->last_frame = out->frame;
  a->started = true;
  return ASCIICHAT_OK;
}

References ANIMATION_HIDDEN_CONTINUE, animation_sample_at(), ASCIICHAT_OK, animation_t::config, ERROR_INVALID_PARAM, animation_config_t::fps, animation_config_t::hidden_policy, animation_t::last_frame, animation_t::last_ns, out, animation_t::paused, animation_t::seconds, SET_ERRNO, animation_config_t::speed, animation_t::started, and animation_t::visible.

Referenced by digital_rain_apply(), digital_rain_init(), digital_rain_reset(), and ui_session_render().