mirror of
https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git
synced 2025-11-05 13:29:57 -05:00
304449002c
2) Add support to synchronize multiple playback streams 3) add two tests for 1) and 2) 4) s/PA_ERROR/PA_ERR/ 5) s/PA_ERROR_OK/PA_OK/ 6) update simple API to deal properly with new peek/drop recording API 7) add beginnings of proper validity checking on API calls in client libs (needs to be extended) 8) report playback buffer overflows/underflows to the client 9) move client side recording mcalign stuff into the memblockq 10) create typedefs for a bunch of API callback prototypes 11) simplify handling of HUP poll() events Yes, i know, it's usually better to commit a lot of small patches instead of a single big one. In this case however, this would have contradicted the other rule: never commit broken or incomplete stuff. *** This stuff needs a lot of additional testing! *** git-svn-id: file:///home/lennart/svn/public/pulseaudio/trunk@511 fefdeb5f-60dc-0310-8127-8f9354f1896f
80 lines
2.4 KiB
C
80 lines
2.4 KiB
C
#ifndef foomcalignhfoo
|
|
#define foomcalignhfoo
|
|
|
|
/* $Id$ */
|
|
|
|
/***
|
|
This file is part of polypaudio.
|
|
|
|
polypaudio is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License as
|
|
published by the Free Software Foundation; either version 2.1 of the
|
|
License, or (at your option) any later version.
|
|
|
|
polypaudio is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with polypaudio; if not, write to the Free Software
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
|
|
USA.
|
|
***/
|
|
|
|
#include <polypcore/memblock.h>
|
|
#include <polypcore/memchunk.h>
|
|
|
|
/* An alignment object, used for aligning memchunks to multiples of
|
|
* the frame size. */
|
|
|
|
/* Method of operation: the user creates a new mcalign object by
|
|
* calling pa_mcalign_new() with the appropriate aligning
|
|
* granularity. After that he may call pa_mcalign_push() for an input
|
|
* memchunk. After exactly one memchunk the user has to call
|
|
* pa_mcalign_pop() until it returns -1. If pa_mcalign_pop() returns
|
|
* 0, the memchunk *c is valid and aligned to the granularity. Some
|
|
* pseudocode illustrating this:
|
|
*
|
|
* pa_mcalign *a = pa_mcalign_new(4, NULL);
|
|
*
|
|
* for (;;) {
|
|
* pa_memchunk input;
|
|
*
|
|
* ... fill input ...
|
|
*
|
|
* pa_mcalign_push(m, &input);
|
|
* pa_memblock_unref(input.memblock);
|
|
*
|
|
* for (;;) {
|
|
* pa_memchunk output;
|
|
*
|
|
* if (pa_mcalign_pop(m, &output) < 0)
|
|
* break;
|
|
*
|
|
* ... consume output ...
|
|
*
|
|
* pa_memblock_unref(output.memblock);
|
|
* }
|
|
* }
|
|
*
|
|
* pa_memchunk_free(a);
|
|
* */
|
|
|
|
typedef struct pa_mcalign pa_mcalign;
|
|
|
|
pa_mcalign *pa_mcalign_new(size_t base, pa_memblock_stat *s);
|
|
void pa_mcalign_free(pa_mcalign *m);
|
|
|
|
/* Push a new memchunk into the aligner. The caller of this routine
|
|
* has to free the memchunk by himself. */
|
|
void pa_mcalign_push(pa_mcalign *m, const pa_memchunk *c);
|
|
|
|
/* Pop a new memchunk from the aligner. Returns 0 when sucessful,
|
|
* nonzero otherwise. */
|
|
int pa_mcalign_pop(pa_mcalign *m, pa_memchunk *c);
|
|
|
|
/* If we pass l bytes in now, how many bytes would we get out? */
|
|
size_t pa_mcalign_csize(pa_mcalign *m, size_t l);
|
|
|
|
#endif
|