src/pulse/sample.c

   1 /***
   2   This file is part of PulseAudio.
   3
   4   Copyright 2004-2006 Lennart Poettering
   5   Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
   6
   7   PulseAudio is free software; you can redistribute it and/or modify
   8   it under the terms of the GNU Lesser General Public License as published
   9   by the Free Software Foundation; either version 2 of the License,
  10   or (at your option) any later version.
  11
  12   PulseAudio is distributed in the hope that it will be useful, but
  13   WITHOUT ANY WARRANTY; without even the implied warranty of
  14   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15   General Public License for more details.
  16
  17   You should have received a copy of the GNU Lesser General Public License
  18   along with PulseAudio; if not, write to the Free Software
  19   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  20   USA.
  21 ***/
  22
  23 #ifdef HAVE_CONFIG_H
  24 #include <config.h>
  25 #endif
  26
  27 #include <stdio.h>
  28 #include <math.h>
  29 #include <string.h>
  30
  31 #include <pulse/timeval.h>
  32 #include <pulse/i18n.h>
  33
  34 #include <pulsecore/core-util.h>
  35 #include <pulsecore/macro.h>
  36
  37 #include "sample.h"
  38
  39 size_t pa_sample_size(const pa_sample_spec *spec) {
  40
  41     static const size_t table[] = {
  42         [PA_SAMPLE_U8] = 1,
  43         [PA_SAMPLE_ULAW] = 1,
  44         [PA_SAMPLE_ALAW] = 1,
  45         [PA_SAMPLE_S16LE] = 2,
  46         [PA_SAMPLE_S16BE] = 2,
  47         [PA_SAMPLE_FLOAT32LE] = 4,
  48         [PA_SAMPLE_FLOAT32BE] = 4,
  49         [PA_SAMPLE_S32LE] = 4,
  50         [PA_SAMPLE_S32BE] = 4,
  51     };
  52
  53     pa_assert(spec);
  54     pa_assert(spec->format >= 0);
  55     pa_assert(spec->format < PA_SAMPLE_MAX);
  56
  57     return table[spec->format];
  58 }
  59
  60 size_t pa_frame_size(const pa_sample_spec *spec) {
  61     pa_assert(spec);
  62
  63     return pa_sample_size(spec) * spec->channels;
  64 }
  65
  66 size_t pa_bytes_per_second(const pa_sample_spec *spec) {
  67     pa_assert(spec);
  68     return spec->rate*pa_frame_size(spec);
  69 }
  70
  71 pa_usec_t pa_bytes_to_usec(uint64_t length, const pa_sample_spec *spec) {
  72     pa_assert(spec);
  73
  74     return (((pa_usec_t) (length / pa_frame_size(spec)) * PA_USEC_PER_SEC) / spec->rate);
  75 }
  76
  77 size_t pa_usec_to_bytes(pa_usec_t t, const pa_sample_spec *spec) {
  78     pa_assert(spec);
  79
  80     return (size_t) (((t * spec->rate) / PA_USEC_PER_SEC)) * pa_frame_size(spec);
  81 }
  82
  83 int pa_sample_spec_valid(const pa_sample_spec *spec) {
  84     pa_assert(spec);
  85
  86     if (spec->rate <= 0 ||
  87         spec->rate > PA_RATE_MAX ||
  88         spec->channels <= 0 ||
  89         spec->channels > PA_CHANNELS_MAX ||
  90         spec->format >= PA_SAMPLE_MAX ||
  91         spec->format < 0)
  92         return 0;
  93
  94     return 1;
  95 }
  96
  97 int pa_sample_spec_equal(const pa_sample_spec*a, const pa_sample_spec*b) {
  98     pa_assert(a);
  99     pa_assert(b);
 100
 101     return
 102         (a->format == b->format) &&
 103         (a->rate == b->rate) &&
 104         (a->channels == b->channels);
 105 }
 106
 107 const char *pa_sample_format_to_string(pa_sample_format_t f) {
 108     static const char* const table[]= {
 109         [PA_SAMPLE_U8] = "u8",
 110         [PA_SAMPLE_ALAW] = "aLaw",
 111         [PA_SAMPLE_ULAW] = "uLaw",
 112         [PA_SAMPLE_S16LE] = "s16le",
 113         [PA_SAMPLE_S16BE] = "s16be",
 114         [PA_SAMPLE_FLOAT32LE] = "float32le",
 115         [PA_SAMPLE_FLOAT32BE] = "float32be",
 116         [PA_SAMPLE_S32LE] = "s32le",
 117         [PA_SAMPLE_S32BE] = "s32be",
 118     };
 119
 120     if (f < 0 || f >= PA_SAMPLE_MAX)
 121         return NULL;
 122
 123     return table[f];
 124 }
 125
 126 char *pa_sample_spec_snprint(char *s, size_t l, const pa_sample_spec *spec) {
 127     pa_assert(s);
 128     pa_assert(l);
 129     pa_assert(spec);
 130
 131     pa_init_i18n();
 132
 133     if (!pa_sample_spec_valid(spec))
 134         pa_snprintf(s, l, _("Invalid"));
 135     else
 136         pa_snprintf(s, l, "%s %uch %uHz", pa_sample_format_to_string(spec->format), spec->channels, spec->rate);
 137
 138     return s;
 139 }
 140
 141 char* pa_bytes_snprint(char *s, size_t l, unsigned v) {
 142     pa_assert(s);
 143
 144     if (v >= ((unsigned) 1024)*1024*1024)
 145         pa_snprintf(s, l, "%0.1f GiB", ((double) v)/1024/1024/1024);
 146     else if (v >= ((unsigned) 1024)*1024)
 147         pa_snprintf(s, l, "%0.1f MiB", ((double) v)/1024/1024);
 148     else if (v >= (unsigned) 1024)
 149         pa_snprintf(s, l, "%0.1f KiB", ((double) v)/1024);
 150     else
 151         pa_snprintf(s, l, "%u B", (unsigned) v);
 152
 153     return s;
 154 }
 155
 156 pa_sample_format_t pa_parse_sample_format(const char *format) {
 157     pa_assert(format);
 158
 159     if (strcasecmp(format, "s16le") == 0)
 160         return PA_SAMPLE_S16LE;
 161     else if (strcasecmp(format, "s16be") == 0)
 162         return PA_SAMPLE_S16BE;
 163     else if (strcasecmp(format, "s16ne") == 0 || strcasecmp(format, "s16") == 0 || strcasecmp(format, "16") == 0)
 164         return PA_SAMPLE_S16NE;
 165     else if (strcasecmp(format, "s16re") == 0)
 166         return PA_SAMPLE_S16RE;
 167     else if (strcasecmp(format, "u8") == 0 || strcasecmp(format, "8") == 0)
 168         return PA_SAMPLE_U8;
 169     else if (strcasecmp(format, "float32") == 0 || strcasecmp(format, "float32ne") == 0 || strcasecmp(format, "float") == 0)
 170         return PA_SAMPLE_FLOAT32NE;
 171     else if (strcasecmp(format, "float32re") == 0)
 172         return PA_SAMPLE_FLOAT32RE;
 173     else if (strcasecmp(format, "float32le") == 0)
 174         return PA_SAMPLE_FLOAT32LE;
 175     else if (strcasecmp(format, "float32be") == 0)
 176         return PA_SAMPLE_FLOAT32BE;
 177     else if (strcasecmp(format, "ulaw") == 0 || strcasecmp(format, "mulaw") == 0)
 178         return PA_SAMPLE_ULAW;
 179     else if (strcasecmp(format, "alaw") == 0)
 180         return PA_SAMPLE_ALAW;
 181     else if (strcasecmp(format, "s32le") == 0)
 182         return PA_SAMPLE_S32LE;
 183     else if (strcasecmp(format, "s32be") == 0)
 184         return PA_SAMPLE_S32BE;
 185     else if (strcasecmp(format, "s32ne") == 0 || strcasecmp(format, "s32") == 0 || strcasecmp(format, "32") == 0)
 186         return PA_SAMPLE_S32NE;
 187     else if (strcasecmp(format, "s32re") == 0)
 188         return PA_SAMPLE_S32RE;
 189
 190     return -1;
 191 }