visualization.c File Reference

Go to the source code of this file.

Data Structures
struct	waveform_color_stop_t
	waveform color stop keeps the values that move through the subsystem: frequency, red, green, blue. Some members are pointers into caller- or subsystem-owned memory, so lifetime follows the API that populated them rather than the struct copy itself. More...

Functions
void	visualization_color_for_level (float frequency_hz, float level, int color_mode, unsigned char *red, unsigned char *green, unsigned char *blue)
void	audio_visualization_submit_stereo (audio_visualization_source_t source, const float *samples, size_t count)
void	audio_visualization_submit (audio_visualization_source_t source, const float *samples, size_t count)
void	audio_visualization_read (audio_visualization_source_t source, float *samples, size_t count)
char *	visualization_encode (const char *cells, const unsigned char *colors, bool column_colors, unsigned int width, unsigned int height, bool use_color, bool flip_x, bool flip_y)

Function Documentation

audio_visualization_read()

void audio_visualization_read	(	audio_visualization_source_t	source,
		float *	samples,
		size_t	count )

Definition at line 108 of file visualization.c.

                                                                                                 {
  if (!samples)
    return;
  if (source < AUDIO_VISUALIZATION_SOURCE_MIC || source >= AUDIO_VISUALIZATION_SOURCE_COUNT) {
    memset(samples, 0, count * sizeof(float));
    return;
  }
  static_mutex_lock_named(&history_mutex, "audio_visualization_history");
  size_t available_count = count < VISUALIZATION_HISTORY ? count : VISUALIZATION_HISTORY;
  size_t output_offset = count - available_count;
  for (size_t i = 0; i < count; i++)
    samples[i] = 0.0f;
  size_t first_source = source;
  size_t last_source = source;
  if (source == AUDIO_VISUALIZATION_SOURCE_MIX) {
    first_source = AUDIO_VISUALIZATION_SOURCE_MIC;
    last_source = AUDIO_VISUALIZATION_SOURCE_REMOTE;
  } else if (source == AUDIO_VISUALIZATION_SOURCE_LOCAL_MIX) {
    first_source = AUDIO_VISUALIZATION_SOURCE_MIC;
    last_source = AUDIO_VISUALIZATION_SOURCE_MEDIA;
  }
  for (size_t current = first_source; current <= last_source; current++) {
    size_t start = (write_position[current] + VISUALIZATION_HISTORY - available_count) % VISUALIZATION_HISTORY;
    for (size_t i = 0; i < available_count; i++)
      samples[output_offset + i] += history[current][(start + i) % VISUALIZATION_HISTORY];
  }
  static_mutex_unlock(&history_mutex);
  for (size_t i = 0; i < count; i++)
    samples[i] = fmaxf(-1.0f, fminf(1.0f, samples[i]));
}

References AUDIO_VISUALIZATION_SOURCE_COUNT, AUDIO_VISUALIZATION_SOURCE_LOCAL_MIX, AUDIO_VISUALIZATION_SOURCE_MEDIA, AUDIO_VISUALIZATION_SOURCE_MIC, AUDIO_VISUALIZATION_SOURCE_MIX, AUDIO_VISUALIZATION_SOURCE_REMOTE, source, and VISUALIZATION_HISTORY.

Referenced by audio_visualization_render_fft(), and audio_visualization_render_waveform().

audio_visualization_submit()

void audio_visualization_submit	(	audio_visualization_source_t	source,
		const float *	samples,
		size_t	count )

Definition at line 93 of file visualization.c.

                                                                                                         {
  if ((!GET_OPTION(waveform) && !GET_OPTION(fft)) || !samples || source < AUDIO_VISUALIZATION_SOURCE_MIC ||
      source > AUDIO_VISUALIZATION_SOURCE_REMOTE)
    return;
  static_mutex_lock_named(&history_mutex, "audio_visualization_history");
  size_t position = write_position[source];
  for (size_t i = 0; i < count; i++) {
    float sample = samples[i];
    history[source][position] = isfinite(sample) ? fmaxf(-1.0f, fminf(1.0f, sample)) : 0.0f;
    position = (position + 1) % VISUALIZATION_HISTORY;
  }
  write_position[source] = position;
  static_mutex_unlock(&history_mutex);
}

References AUDIO_VISUALIZATION_SOURCE_MIC, AUDIO_VISUALIZATION_SOURCE_REMOTE, GET_OPTION, source, and VISUALIZATION_HISTORY.

Referenced by audio_visualization_submit_stereo(), and mirror_submit_audio_samples().

audio_visualization_submit_stereo()

void audio_visualization_submit_stereo	(	audio_visualization_source_t	source,
		const float *	samples,
		size_t	count )

Downmix interleaved stereo only for display analysis, preserving its sample clock.

Definition at line 78 of file visualization.c.

                                                                                                                {
  if (!samples || count % 2)
    return;
  float mono[480];
  for (size_t offset = 0; offset < count;) {
    size_t frames = (count - offset) / 2;
    if (frames > 480)
      frames = 480;
    for (size_t i = 0; i < frames; i++)
      mono[i] = samples[offset + i * 2] * 0.5f + samples[offset + i * 2 + 1] * 0.5f;
    audio_visualization_submit(source, mono, frames);
    offset += frames * 2;
  }
}

References audio_visualization_submit(), and source.

Referenced by audio_write_samples().

visualization_color_for_level()

void visualization_color_for_level	(	float	frequency_hz,
		float	level,
		int	color_mode,
		unsigned char *	red,
		unsigned char *	green,
		unsigned char *	blue )

Definition at line 62 of file visualization.c.

                                                                              {
  visualization_color_for_frequency(frequency_hz, red, green, blue);
  float brightness = 0.5f + 0.5f * level;
  float white_mix = 0.0f;
  if (color_mode == AUDIO_VISUALIZATION_COLOR_DARKER) {
    brightness = 0.24f + 0.76f * level;
  } else if (color_mode == AUDIO_VISUALIZATION_COLOR_BRIGHTER) {
    brightness = 0.62f + 0.38f * level;
    white_mix = 0.10f;
  }
  *red = (unsigned char)lrintf(fminf(255.0f, *red * brightness + 255.0f * white_mix));
  *green = (unsigned char)lrintf(fminf(255.0f, *green * brightness + 255.0f * white_mix));
  *blue = (unsigned char)lrintf(fminf(255.0f, *blue * brightness + 255.0f * white_mix));
}

References AUDIO_VISUALIZATION_COLOR_BRIGHTER, AUDIO_VISUALIZATION_COLOR_DARKER, and color_mode.

Referenced by audio_visualization_render_fft(), and audio_visualization_render_waveform().

visualization_encode()

char * visualization_encode	(	const char *	cells,
		const unsigned char *	colors,
		bool	column_colors,
		unsigned int	width,
		unsigned int	height,
		bool	use_color,
		bool	flip_x,
		bool	flip_y )

Definition at line 154 of file visualization.c.

                                                                                          {
  int mode = GET_OPTION(render_mode);
  int color_mode = GET_OPTION(color_mode);
  if (color_mode == COLOR_MODE_AUTO)
    color_mode = COLOR_MODE_TRUECOLOR;
  use_color = use_color && color_mode != COLOR_MODE_NONE;
  palette_type_t palette_type = (palette_type_t)GET_OPTION(palette_type);
  const palette_def_t *builtin = get_builtin_palette(palette_type);
  const char *palette =
      palette_type == PALETTE_CUSTOM ? GET_OPTION(palette_custom) : (builtin ? builtin->chars : PALETTE_CHARS_STANDARD);
  if (!palette || !*palette)
    palette = PALETTE_CHARS_STANDARD;
  const char *characters[256];
  size_t lengths[256], count = 0;
  for (const char *p = palette; *p && count < 256;) {
    uint32_t codepoint;
    int length = utf8_decode((const uint8_t *)p, &codepoint);
    if (length <= 0)
      break;
    characters[count] = p;
    lengths[count++] = (size_t)length;
    p += length;
  }
  bool half = mode == RENDER_MODE_HALF_BLOCK;
  unsigned int rows = half ? height / 2 : height;
  size_t capacity = (size_t)width * rows * 64 + rows + 1;
  char *frame = SAFE_MALLOC(capacity, char *);
  if (!frame)
    return NULL;
  size_t used = 0;
  for (unsigned int y = 0; y < rows; y++) {
    for (unsigned int x = 0; x < width; x++) {
      unsigned int sx = flip_x ? width - x - 1 : x;
      unsigned int sy = half ? y * 2 : y;
      unsigned int top = flip_y ? height - sy - 1 : sy;
      size_t cell = (size_t)top * width + sx;
      const unsigned char *color = colors + (column_colors ? sx : cell) * 3;
      char ch = cells[cell];
      if (half) {
        unsigned int bottom = flip_y ? height - sy - 2 : sy + 1;
        size_t lower = (size_t)bottom * width + sx;
        const unsigned char *lower_color = colors + (column_colors ? sx : lower) * 3;
        bool upper_on = ch != ' ', lower_on = cells[lower] != ' ';
        if (use_color) {
          const unsigned char black[3] = {0};
          char *out = visualization_color(frame + used, upper_on ? color : black, false, color_mode);
          out = visualization_color(out, lower_on ? lower_color : black, true, color_mode);
          memcpy(out, "▀\033[0m", sizeof("▀\033[0m") - 1);
          used = (size_t)(out - frame) + sizeof("▀\033[0m") - 1;
        } else {
          const char *glyph = upper_on ? (lower_on ? "█" : "▀") : (lower_on ? "▄" : " ");
          size_t length = strlen(glyph);
          memcpy(frame + used, glyph, length);
          used += length;
        }
      } else if (ch != ' ') {
        char *out = frame + used;
        if (use_color)
          out = visualization_color(out, color, mode == RENDER_MODE_BACKGROUND, color_mode);
        if (mode == RENDER_MODE_BACKGROUND && use_color) {
          *out++ = ' ';
        } else if (count) {
          unsigned int luminance = 2126u * color[0] + 7152u * color[1] + 722u * color[2];
          size_t index = (luminance * (count - 1) + 1275000u) / 2550000u;
          memcpy(out, characters[index], lengths[index]);
          out += lengths[index];
        } else {
          *out++ = ch;
        }
        if (use_color) {
          memcpy(out, "\033[0m", 4);
          out += 4;
        }
        used = (size_t)(out - frame);
      } else {
        frame[used++] = ch;
      }
    }
    frame[used++] = '\n';
  }
  frame[used] = '\0';
  return frame;
}

References cells, palette_def_t::chars, color_mode, COLOR_MODE_AUTO, COLOR_MODE_NONE, COLOR_MODE_TRUECOLOR, colors, get_builtin_palette(), GET_OPTION, height, index, out, PALETTE_CHARS_STANDARD, PALETTE_CUSTOM, SAFE_MALLOC, utf8_decode(), and width.

Referenced by audio_visualization_render_fft(), and audio_visualization_render_waveform().