RD_Export 7 October 2015 Rivendell C Library Manual rd_export Rivendell Export Audio C Library Function Todd Baker bakert@rfa.org Rivendell C Library Author #include <rivwebcapi/rd_export.h> int RD_Export const char hostname[] const char username[] const char passwd[] const char ticket[] const unsigned cartnumber const unsigned cutnumber const int format const int channels const int sample_rate const int bit_rate const int quality const int start_point const int end_point const int normalization_level const int enable_metadata const char filename[] const char user_agent[] Description RD_Export is the function to use to export PCM/MPEG data from the audio store. RD_Export function call fields FIELD NAME FIELD TYPE MEANING REMARKS hostname Character Array Name Of Rivendell DB Host Mandatory username Character Array Rivendell User Name Mandatory When NO Ticket Provided passwd Character Array Rivendell User Password Mandatory When NO Ticket Provided ticket Character Array Rivendell Authentification Ticket Mandatory When NO User/Password Pair Provided. cartnumber unsigned integer Cart Number Mandatory cutnumber unsigned integer Cut Number Mandatory format integer Format Mandatory channels integer Number of Channels Mandatory sample_rate integer Sample Rate Mandatory bit_rate integer Bit Rate Mandatory quality integer Quality Mandatory start_point integer Start Point Mandatory end_point integer End Point Mandatory normalization_level integer Normalization Level Mandatory enable_metadata integer Flag for whether to enable Meta Data Mandatory filename character array File Name For Audio Mandatory user_agent Character Array User Agent Value put into HTTP request Optional (default is Rivendell-C-API/x.x.x)
RETURN VALUE On success, zero is returned. If a server error occurs a -1 is returned. If a client error occurs a specific error number is returned. ERRORS 400 Invalid Input Parameter(s). 403 User Authentification Error. 404 No Source Audio Present. 404 Unauthorized or No Such Cart / Cut. 415 Invalid Settings. 500 Conversion Error. nnn Unknown Error Occurred.