/*
|
* Copyright (c) 2010-2019 Belledonne Communications SARL.
|
*
|
* This file is part of oRTP.
|
*
|
* 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 3 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, see <http://www.gnu.org/licenses/>.
|
*/
|
|
/**
|
* \file rtpprofile.h
|
* \brief Using and creating standart and custom RTP profiles
|
*
|
**/
|
|
#ifndef RTPPROFILE_H
|
#define RTPPROFILE_H
|
#include <ortp/port.h>
|
|
#ifdef __cplusplus
|
extern "C"{
|
#endif
|
|
#define RTP_PROFILE_MAX_PAYLOADS 128
|
|
/**
|
* The RTP profile is a table RTP_PROFILE_MAX_PAYLOADS entries to make the matching
|
* between RTP payload type number and the PayloadType that defines the type of
|
* media.
|
**/
|
struct _RtpProfile
|
{
|
char *name;
|
PayloadType *payload[RTP_PROFILE_MAX_PAYLOADS];
|
};
|
|
|
typedef struct _RtpProfile RtpProfile;
|
|
ORTP_VAR_PUBLIC RtpProfile av_profile;
|
|
#define rtp_profile_get_name(profile) (const char*)((profile)->name)
|
|
ORTP_PUBLIC void rtp_profile_set_payload(RtpProfile *prof, int idx, PayloadType *pt);
|
|
/**
|
* Set payload type number \a index unassigned in the profile.
|
*
|
*@param profile an RTP profile
|
*@param index the payload type number
|
**/
|
#define rtp_profile_clear_payload(profile,index) \
|
rtp_profile_set_payload(profile,index,NULL)
|
|
/* I prefer have this function inlined because it is very often called in the code */
|
/**
|
*
|
* Gets the payload description of the payload type \a index in the profile.
|
*
|
*@param prof an RTP profile (a #_RtpProfile object)
|
*@param idx the payload type number
|
*@return the payload description (a PayloadType object)
|
**/
|
static ORTP_INLINE PayloadType * rtp_profile_get_payload(const RtpProfile *prof, int idx){
|
if (idx<0 || idx>=RTP_PROFILE_MAX_PAYLOADS) {
|
return NULL;
|
}
|
return prof->payload[idx];
|
}
|
ORTP_PUBLIC void rtp_profile_clear_all(RtpProfile *prof);
|
ORTP_PUBLIC void rtp_profile_set_name(RtpProfile *prof, const char *name);
|
ORTP_PUBLIC PayloadType * rtp_profile_get_payload_from_mime(RtpProfile *profile,const char *mime);
|
ORTP_PUBLIC PayloadType * rtp_profile_get_payload_from_rtpmap(RtpProfile *profile, const char *rtpmap);
|
ORTP_PUBLIC int rtp_profile_get_payload_number_from_mime(RtpProfile *profile, const char *mime);
|
ORTP_PUBLIC int rtp_profile_get_payload_number_from_mime_and_flag(RtpProfile *profile, const char *mime, int flag);
|
ORTP_PUBLIC int rtp_profile_get_payload_number_from_rtpmap(RtpProfile *profile, const char *rtpmap);
|
ORTP_PUBLIC int rtp_profile_find_payload_number(RtpProfile *prof,const char *mime,int rate, int channels);
|
ORTP_PUBLIC PayloadType * rtp_profile_find_payload(RtpProfile *prof,const char *mime,int rate, int channels);
|
ORTP_PUBLIC int rtp_profile_move_payload(RtpProfile *prof,int oldpos,int newpos);
|
|
ORTP_PUBLIC RtpProfile * rtp_profile_new(const char *name);
|
/* clone a profile, payload are not cloned */
|
ORTP_PUBLIC RtpProfile * rtp_profile_clone(RtpProfile *prof);
|
|
|
/*clone a profile and its payloads (ie payload type are newly allocated, not reusing payload types of the reference profile) */
|
ORTP_PUBLIC RtpProfile * rtp_profile_clone_full(RtpProfile *prof);
|
/* frees the profile and all its PayloadTypes*/
|
ORTP_PUBLIC void rtp_profile_destroy(RtpProfile *prof);
|
|
#ifdef __cplusplus
|
}
|
#endif
|
|
#endif
|
