|
|
|
|
@ -2716,7 +2716,7 @@ int burn_msgs_set_severities(char *queue_severity,
|
|
|
|
|
"DEBUG", "ALL".
|
|
|
|
|
To call with minimum_severity "NEVER" will discard the
|
|
|
|
|
whole queue.
|
|
|
|
|
@param error_code Will become a unique error code as liste in
|
|
|
|
|
@param error_code Will become a unique error code as listed in
|
|
|
|
|
libburn/libdax_msgs.h
|
|
|
|
|
@param msg_text Must provide at least BURN_MSGS_MESSAGE_LEN bytes.
|
|
|
|
|
@param os_errno Will become the eventual errno related to the message
|
|
|
|
|
@ -2980,6 +2980,110 @@ int burn_drive_get_drive_role(struct burn_drive *d);
|
|
|
|
|
int burn_drive_equals_adr(struct burn_drive *d1, char *adr2, int drive_role2);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
Audio track data extraction facility.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/* Maximum size for address paths and fmt_info strings */
|
|
|
|
|
#define LIBDAX_AUDIOXTR_STRLEN 4096
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** Extractor object encapsulating intermediate states of extraction.
|
|
|
|
|
The clients of libdax_audioxtr shall only allocate pointers to this
|
|
|
|
|
struct and get a storage object via libdax_audioxtr_new().
|
|
|
|
|
Appropriate initial value for the pointer is NULL.
|
|
|
|
|
*/
|
|
|
|
|
struct libdax_audioxtr;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** Open an audio file, check wether suitable, create extractor object.
|
|
|
|
|
@param xtr Opaque handle to extractor. Gets attached extractor object.
|
|
|
|
|
@param path Address of the audio file to extract. "-" is stdin (but might
|
|
|
|
|
be not suitable for all futurely supported formats).
|
|
|
|
|
@param flag Bitfield for control purposes (unused yet, submit 0)
|
|
|
|
|
@return >0 success
|
|
|
|
|
0 unsuitable format
|
|
|
|
|
-1 severe error
|
|
|
|
|
-2 path not found
|
|
|
|
|
@since 0.2.4
|
|
|
|
|
*/
|
|
|
|
|
int libdax_audioxtr_new(struct libdax_audioxtr **xtr, char *path, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** Obtain identification parameters of opened audio source.
|
|
|
|
|
@param xtr Opaque handle to extractor
|
|
|
|
|
@param fmt Gets pointed to the audio file format id text: ".wav" , ".au"
|
|
|
|
|
@param fmt_info Gets pointed to a format info text telling parameters
|
|
|
|
|
@param num_channels e.g. 1=mono, 2=stereo, etc
|
|
|
|
|
@param sample_rate e.g. 11025, 44100
|
|
|
|
|
@param bits_per_sample e.g. 8= 8 bits per sample, 16= 16 bits ...
|
|
|
|
|
@param msb_first Byte order of samples: 0=Intel 1=Motorola
|
|
|
|
|
@param flag Bitfield for control purposes (unused yet, submit 0)
|
|
|
|
|
@return >0 success, <=0 failure
|
|
|
|
|
@since 0.2.4
|
|
|
|
|
*/
|
|
|
|
|
int libdax_audioxtr_get_id(struct libdax_audioxtr *xtr,
|
|
|
|
|
char **fmt, char **fmt_info,
|
|
|
|
|
int *num_channels, int *sample_rate,
|
|
|
|
|
int *bits_per_sample, int *msb_first, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** Obtain a prediction about the extracted size based on internal information
|
|
|
|
|
of the formatted file.
|
|
|
|
|
@param xtr Opaque handle to extractor
|
|
|
|
|
@param size Gets filled with the predicted size
|
|
|
|
|
@param flag Bitfield for control purposes (unused yet, submit 0)
|
|
|
|
|
@return 1 prediction was possible , 0 no prediction could be made
|
|
|
|
|
@since 0.2.4
|
|
|
|
|
*/
|
|
|
|
|
int libdax_audioxtr_get_size(struct libdax_audioxtr *o, off_t *size, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** Obtain next buffer full of extracted data in desired format (only raw audio
|
|
|
|
|
for now).
|
|
|
|
|
@param xtr Opaque handle to extractor
|
|
|
|
|
@param buffer Gets filled with extracted data
|
|
|
|
|
@param buffer_size Maximum number of bytes to be filled into buffer
|
|
|
|
|
@param flag Bitfield for control purposes
|
|
|
|
|
bit0= do not stop at predicted end of data
|
|
|
|
|
@return >0 number of valid buffer bytes,
|
|
|
|
|
0 End of file
|
|
|
|
|
-1 operating system reports error
|
|
|
|
|
-2 usage error by application
|
|
|
|
|
@since 0.2.4
|
|
|
|
|
*/
|
|
|
|
|
int libdax_audioxtr_read(struct libdax_audioxtr *xtr,
|
|
|
|
|
char buffer[], int buffer_size, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** Try to obtain a file descriptor which will deliver extracted data
|
|
|
|
|
to normal calls of read(2). This may fail because the format is
|
|
|
|
|
unsuitable for that, but ".wav" is ok. If this call succeeds the xtr
|
|
|
|
|
object will have forgotten its file descriptor and libdax_audioxtr_read()
|
|
|
|
|
will return a usage error. One may use *fd after libdax_audioxtr_destroy()
|
|
|
|
|
and will have to close it via close(2) when done with it.
|
|
|
|
|
@param xtr Opaque handle to extractor
|
|
|
|
|
@param fd Eventually returns the file descriptor number
|
|
|
|
|
@param flag Bitfield for control purposes
|
|
|
|
|
bit0= do not dup(2) and close(2) but hand out original fd
|
|
|
|
|
@return 1 success, 0 cannot hand out fd , -1 severe error
|
|
|
|
|
@since 0.2.4
|
|
|
|
|
*/
|
|
|
|
|
int libdax_audioxtr_detach_fd(struct libdax_audioxtr *o, int *fd, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** Clean up after extraction and destroy extractor object.
|
|
|
|
|
@param xtr Opaque handle to extractor, *xtr is allowed to be NULL,
|
|
|
|
|
*xtr is set to NULL by this function
|
|
|
|
|
@param flag Bitfield for control purposes (unused yet, submit 0)
|
|
|
|
|
@return 1 = destroyed object, 0 = was already destroyed
|
|
|
|
|
@since 0.2.4
|
|
|
|
|
*/
|
|
|
|
|
int libdax_audioxtr_destroy(struct libdax_audioxtr **xtr, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef DOXYGEN
|
|
|
|
|
|
|
|
|
|
BURN_END_DECLS
|
|
|
|
|
|
