/*-*- Mode: C; c-basic-offset: 8 -*-*/

#ifndef foocanberrareadsoundfilehfoo

#define foocanberrareadsoundfilehfoo

/***

  This file is part of libcanberra.

  Copyright 2008 Lennart Poettering

  libcanberra 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.

  libcanberra 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 libcanberra. If not, see

  <http://www.gnu.org/licenses/>.

***/

#include <sys/types.h>

#include <inttypes.h>

typedef enum ca_sample_type {

        CA_SAMPLE_S16NE,

        CA_SAMPLE_S16RE,

        CA_SAMPLE_U8

} ca_sample_type_t;

typedef enum ca_channel_position {

        CA_CHANNEL_MONO,

        CA_CHANNEL_FRONT_LEFT,

        CA_CHANNEL_FRONT_RIGHT,

        CA_CHANNEL_FRONT_CENTER,

        CA_CHANNEL_REAR_LEFT,

        CA_CHANNEL_REAR_RIGHT,

        CA_CHANNEL_REAR_CENTER,

        CA_CHANNEL_LFE,

        CA_CHANNEL_FRONT_LEFT_OF_CENTER,

        CA_CHANNEL_FRONT_RIGHT_OF_CENTER,

        CA_CHANNEL_SIDE_LEFT,

        CA_CHANNEL_SIDE_RIGHT,

        CA_CHANNEL_TOP_CENTER,

        CA_CHANNEL_TOP_FRONT_LEFT,

        CA_CHANNEL_TOP_FRONT_RIGHT,

        CA_CHANNEL_TOP_FRONT_CENTER,

        CA_CHANNEL_TOP_REAR_LEFT,

        CA_CHANNEL_TOP_REAR_RIGHT,

        CA_CHANNEL_TOP_REAR_CENTER,

        _CA_CHANNEL_POSITION_MAX

} ca_channel_position_t;

typedef struct ca_sound_file ca_sound_file;

int ca_sound_file_open(ca_sound_file **f, const char *fn);

void ca_sound_file_close(ca_sound_file *f);

unsigned ca_sound_file_get_nchannels(ca_sound_file *f);

unsigned ca_sound_file_get_rate(ca_sound_file *f);

ca_sample_type_t ca_sound_file_get_sample_type(ca_sound_file *f);

const ca_channel_position_t* ca_sound_file_get_channel_map(ca_sound_file *f);

off_t ca_sound_file_get_size(ca_sound_file *f);

int ca_sound_file_read_int16(ca_sound_file *f, int16_t *d, size_t *n);

int ca_sound_file_read_uint8(ca_sound_file *f, uint8_t *d, size_t *n);

int ca_sound_file_read_arbitrary(ca_sound_file *f, void *d, size_t *n);

size_t ca_sound_file_frame_size(ca_sound_file *f);

#endif