168 lines
5.0 KiB
C
168 lines
5.0 KiB
C
/*
|
|
$Id: paranoia.h,v 1.8 2005/01/29 20:54:20 rocky Exp $
|
|
|
|
Copyright (C) 2004, 2005 Rocky Bernstein <rocky@panix.com>
|
|
Copyright (C) 1998 Monty xiphmont@mit.edu
|
|
|
|
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.
|
|
|
|
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*/
|
|
|
|
/** \file paranoia.h
|
|
*
|
|
* \brief The top-level header for libcdda_paranoia: a device- and OS-
|
|
* independent library for reading CD-DA with error tolerance and
|
|
* repair. Applications include this for paranoia access.
|
|
*/
|
|
|
|
#ifndef _CDIO_PARANOIA_H_
|
|
#define _CDIO_PARANOIA_H_
|
|
|
|
#include <cdio/cdio.h>
|
|
|
|
/*! Paranoia likes to work with 16-bit numbers rather than
|
|
(possibly byte-swapped) bytes. So there are this many
|
|
16-bit numbers block (frame, or sector) read.
|
|
*/
|
|
#define CD_FRAMEWORDS (CDIO_CD_FRAMESIZE_RAW/2)
|
|
|
|
/**! Flags used in paranoia_modeset. */
|
|
|
|
#define PARANOIA_MODE_FULL 0xff
|
|
#define PARANOIA_MODE_DISABLE 0
|
|
|
|
#define PARANOIA_MODE_VERIFY 1
|
|
#define PARANOIA_MODE_FRAGMENT 2
|
|
#define PARANOIA_MODE_OVERLAP 4
|
|
#define PARANOIA_MODE_SCRATCH 8
|
|
#define PARANOIA_MODE_REPAIR 16
|
|
#define PARANOIA_MODE_NEVERSKIP 32
|
|
|
|
/** cdrom_paranoia is an opaque structure which is used in all of the
|
|
library operations.
|
|
*/
|
|
typedef struct cdrom_paranoia_s cdrom_paranoia_t;
|
|
typedef struct cdrom_drive_s cdrom_drive_t;
|
|
|
|
/** For compatibility. cdrom_drive_t is depricated, use cdrom_drive_t instead. */
|
|
#define cdrom_drive cdrom_drive_t
|
|
|
|
|
|
typedef enum {
|
|
PARANOIA_CB_READ,
|
|
PARANOIA_CB_VERIFY,
|
|
PARANOIA_CB_FIXUP_EDGE,
|
|
PARANOIA_CB_FIXUP_ATOM,
|
|
PARANOIA_CB_SCRATCH,
|
|
PARANOIA_CB_REPAIR,
|
|
PARANOIA_CB_SKIP,
|
|
PARANOIA_CB_DRIFT,
|
|
PARANOIA_CB_BACKOFF,
|
|
PARANOIA_CB_OVERLAP,
|
|
PARANOIA_CB_FIXUP_DROPPED,
|
|
PARANOIA_CB_FIXUP_DUPED,
|
|
PARANOIA_CB_READERR
|
|
} paranoia_cb_mode_t;
|
|
|
|
extern const char *paranoia_cb_mode2str[];
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*!
|
|
Get and initialize a new cdrom_paranoia object from cdrom_drive.
|
|
Run this before calling any of the other paranoia routines below.
|
|
|
|
@return new cdrom_paranoia object Call paranoia_free() when you are
|
|
done with it
|
|
*/
|
|
extern cdrom_paranoia_t *cdio_paranoia_init(cdrom_drive_t *d);
|
|
|
|
/*!
|
|
Free any resources associated with obj.
|
|
|
|
@see paranoia_init.
|
|
*/
|
|
extern void cdio_paranoia_free(cdrom_paranoia_t *p);
|
|
|
|
/*!
|
|
Set the kind of repair you want to on for reading.
|
|
The modes are listed above
|
|
*/
|
|
extern void cdio_paranoia_modeset(cdrom_paranoia_t *p, int mode);
|
|
|
|
/*!
|
|
reposition reading offset.
|
|
|
|
@param p paranoia type
|
|
@param seek byte offset to seek to
|
|
@param whence like corresponding parameter in libc's lseek, e.g.
|
|
SEEK_SET or SEEK_END.
|
|
*/
|
|
extern lsn_t cdio_paranoia_seek(cdrom_paranoia_t *p, off_t seek, int whence);
|
|
|
|
/*! @return the audio data read CDIO_CD_FRAMESIZE_RAW bytes. This data
|
|
is not freed by the caller, but will persist only until the next
|
|
call.
|
|
*/
|
|
extern int16_t *cdio_paranoia_read(cdrom_paranoia_t *p,
|
|
void(*callback)(long int, paranoia_cb_mode_t));
|
|
|
|
/*! The same as cdio_paranoia_read but the number of retries is set.
|
|
@param p paranoia object.
|
|
|
|
|
|
@param callback callback routine which gets called with the status
|
|
on each read.
|
|
|
|
@param maxretries number of times to try re-reading a block before
|
|
failing.
|
|
|
|
@return the block of CDIO_FRAMEIZE_RAW bytes (or
|
|
CDIO_FRAMESIZE_RAW / 2 16-bit integers). Unless byte-swapping has
|
|
been turned off the 16-bit integers Endian independent order.
|
|
|
|
@see cdio_paranoia_read.
|
|
|
|
*/
|
|
extern int16_t *cdio_paranoia_read_limited(cdrom_paranoia_t *p,
|
|
void(*callback)(long int,
|
|
paranoia_cb_mode_t),
|
|
int maxretries);
|
|
|
|
|
|
extern void cdio_paranoia_overlapset(cdrom_paranoia_t *p,long overlap);
|
|
|
|
extern void cdio_paranoia_set_range(cdrom_paranoia_t *p, long int start,
|
|
long int end);
|
|
|
|
#ifndef DO_NOT_WANT_PARANOIA_COMPATIBILITY
|
|
/** For compatibility with good ol' paranoia */
|
|
#define paranoia_init cdio_paranoia_init
|
|
#define paranoia_free cdio_paranoia_free
|
|
#define paranoia_modeset cdio_paranoia_modeset
|
|
#define paranoia_seek cdio_paranoia_seek
|
|
#define paranoia_read cdio_paranoia_read
|
|
#define paranoia_read_limited cdio_paranoia_read_limited
|
|
#define paranoia_overlapset cdio_paranoia_overlapset
|
|
#define paranoia_set_range cdio_paranoia_read_overlapset
|
|
#endif /*DO_NOT_WANT_PARANOIA_COMPATIBILITY*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /*_CDIO_PARANOIA_H_*/
|