2009-01-07 23:56:30 +01:00
|
|
|
/*
|
2011-01-29 10:13:54 +01:00
|
|
|
* Copyright (C) 2003-2011 The Music Player Daemon Project
|
2009-01-07 23:56:30 +01:00
|
|
|
* http://www.musicpd.org
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program 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 General Public License for more details.
|
2009-03-13 18:43:16 +01:00
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License along
|
|
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
2009-01-07 23:56:30 +01:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef PCM_BUFFER_H
|
|
|
|
#define PCM_BUFFER_H
|
|
|
|
|
2011-12-13 19:47:52 +01:00
|
|
|
#include "check.h"
|
|
|
|
|
2009-01-07 23:56:30 +01:00
|
|
|
#include <glib.h>
|
|
|
|
|
2011-11-27 20:05:57 +01:00
|
|
|
#include <assert.h>
|
|
|
|
|
2009-01-07 23:56:30 +01:00
|
|
|
/**
|
|
|
|
* Manager for a temporary buffer which grows as needed. We could
|
|
|
|
* allocate a new buffer every time pcm_convert() is called, but that
|
|
|
|
* would put too much stress on the allocator.
|
|
|
|
*/
|
|
|
|
struct pcm_buffer {
|
2010-06-30 08:21:48 +02:00
|
|
|
void *buffer;
|
2009-01-07 23:56:30 +01:00
|
|
|
|
|
|
|
size_t size;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Initialize the buffer, but don't allocate anything yet.
|
|
|
|
*/
|
|
|
|
static inline void
|
|
|
|
pcm_buffer_init(struct pcm_buffer *buffer)
|
|
|
|
{
|
2011-11-27 20:05:57 +01:00
|
|
|
assert(buffer != NULL);
|
|
|
|
|
2009-01-07 23:56:30 +01:00
|
|
|
buffer->buffer = NULL;
|
|
|
|
buffer->size = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Free resources. This function may be called more than once.
|
|
|
|
*/
|
|
|
|
static inline void
|
|
|
|
pcm_buffer_deinit(struct pcm_buffer *buffer)
|
|
|
|
{
|
2011-11-27 20:05:57 +01:00
|
|
|
assert(buffer != NULL);
|
|
|
|
|
2009-01-07 23:56:30 +01:00
|
|
|
g_free(buffer->buffer);
|
|
|
|
|
|
|
|
buffer->buffer = NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the buffer, and guarantee a minimum size. This buffer becomes
|
|
|
|
* invalid with the next pcm_buffer_get() call.
|
2012-02-13 18:05:42 +01:00
|
|
|
*
|
|
|
|
* This function will never return NULL, even if size is zero, because
|
|
|
|
* the PCM library uses the NULL return value to signal "error". An
|
|
|
|
* empty destination buffer is not always an error.
|
2009-01-07 23:56:30 +01:00
|
|
|
*/
|
2011-10-10 08:17:39 +02:00
|
|
|
G_GNUC_MALLOC
|
|
|
|
void *
|
|
|
|
pcm_buffer_get(struct pcm_buffer *buffer, size_t size);
|
2009-01-07 23:56:30 +01:00
|
|
|
|
|
|
|
#endif
|