You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
k3b/libk3b/tools/k3bcdparanoialib.h

162 lines
3.9 KiB

/*
*
* $Id: k3bcdparanoialib.h 619556 2007-01-03 17:38:12Z trueg $
* Copyright (C) 2003 Sebastian Trueg <trueg@k3b.org>
*
* This file is part of the K3b project.
* Copyright (C) 1998-2007 Sebastian Trueg <trueg@k3b.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.
* See the file "COPYING" for the exact licensing terms.
*/
#ifndef K3B_CDPARANOIA_LIB_H
#define K3B_CDPARANOIA_LIB_H
// from cdda_interface.h
#define CD_FRAMESIZE_RAW 2352
#include <tqstring.h>
#include <sys/types.h>
#include "k3b_export.h"
namespace K3bDevice {
class Device;
class Toc;
}
/**
* K3bCdparanoiaLib is a convenience wrapper around libcdda_interface
* and libcdda_paranoia.
*
* It uses four paranoia levels 0-3 which can be set via setParanoiaMode
* and are used the same way as in cdrdao:
* \li 0: No checking, data is copied directly from the drive.
* \li 1: Perform overlapped reading to avoid jitter.
* \li 2: Like 1 but with additional checks of the read audio data.
* \li 3: Like 2 but with additional scratch detection and repair.
*
* K3bCdparanoiaLib is based on a shared data approach which makes sure
* that each device can only be opened once. This is necessary since
* libcdda_interface opens the device exclusively on most distributions.
*
* However, it is perfectly possible to have two instances of K3bCdparanoiaLib
* accessing the same device at the same time. K3bCdparanoiaLib will take care
* of the syncing and seeking issues automatically.
*
* K3bCdparanoiaLib is thread-safe.
*
* Usage:
* <pre>
* K3bCdparanoiaLib lib;
* lib.initParanoia( mydevice );
* lib.initReading( tracknumber );
* while( char* data = lib.read() )
* dosomethingcoolwithdata( data );
* </pre>
*/
class LIBK3B_EXPORT K3bCdparanoiaLib
{
public:
~K3bCdparanoiaLib();
/** default: 1 */
void setParanoiaMode( int );
void setNeverSkip( bool b );
/** default: 5 */
void setMaxRetries( int );
/**
* This will read the Toc and initialize some stuff.
* It will also call paranoiaInit( const TQString& )
*/
bool initParanoia( K3bDevice::Device* dev );
/**
* Use for faster initialization without reading the toc
*/
bool initParanoia( K3bDevice::Device* dev, const K3bDevice::Toc& );
void close();
/**
* Call this after initParanoia to set the data to rip.
*
* Rip all audio tracks.
*/
bool initReading();
/**
* Call this after initParanoia to set the data to rip.
*/
bool initReading( unsigned int track );
/**
* Call this after initParanoia to set the data to rip.
*/
bool initReading( long startSector, long endSector );
/**
* Read data.
* \param statusCode If not 0 will be set.
* \param track the tracknumer the data belongs to
*
* This method takes care of swapping the byte-order depending on the
* machine type.
*
* \return The read sector data or 0 if all data within the specified range
* has been read or an error has occured.
*/
char* read( int* statusCode = 0, unsigned int* track = 0, bool littleEndian = true );
/**
* This only is valid after a call to read()
*/
int status() const;
enum tqStatus {
S_OK,
S_ERROR
// to be extended with Jitter and stuff...
};
/**
* Only valid after a call to initParanoia()
*/
const K3bDevice::Toc& toc() const;
long rippedDataLength() const;
/**
* returns 0 if the cdparanoialib could not
* be found on the system.
* Otherwise you have to take care of
* deleting.
*/
static K3bCdparanoiaLib* create();
private:
void cleanup();
K3bCdparanoiaLib();
bool load();
class Private;
Private* d;
static void* s_libInterface;
static void* s_libParanoia;
static int s_counter;
};
#endif