doubango/tinyMEDIA/include/tinymedia/tmedia_common.h
c732d49e
 /*
 * Copyright (C) 2017, University of the Basque Country (UPV/EHU)
 * Contact for licensing options: <licensing-mcpttclient(at)mcopenplatform(dot)com>
 *
 * The original file was part of Open Source Doubango Framework
 * Copyright (C) 2010-2011 Mamadou Diop.
 * Copyright (C) 2012 Doubango Telecom <http://doubango.org>
 *
 * This file is part of Open Source Doubango Framework.
 *
 * DOUBANGO 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.
 *
 * DOUBANGO 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 DOUBANGO.
 *
 */
 
 
 /**@file tmedia_common.h
  * @brief Common functions and definitions.
  *
  * @author Mamadou Diop <diopmamadou(at)doubango[dot]org>
  *
 
  */
 #ifndef TINYMEDIA_COMMON_H
 #define TINYMEDIA_COMMON_H
 
 #include "tinymedia_config.h"
 
 #include "tsk_plugin.h"
 #include "tsk_object.h"
 
 TMEDIA_BEGIN_DECLS
 
 struct tsdp_message_s;
 struct tsdp_header_M_s;
 
 /** List of all supported media types */
 // @tinyWRAP
 typedef enum tmedia_type_e
 {
 	tmedia_none = 0x00,
 	tmedia_ghost = (0x01 << 0),
 	
 	tmedia_audio = (0x01 << 1),
 	tmedia_video = (0x01 << 2),
 	tmedia_chat = (0x01 << 3),
 	tmedia_file = (0x01 << 4),
 	tmedia_t38 = (0x01 << 5),
 	tmedia_t140 = (0x01 << 6),
 	tmedia_bfcp = (0x01 << 7),
 	tmedia_bfcp_audio = (0x01 << 8)/*must*/ | tmedia_bfcp, /* do not add "| audio". Otherwise it will be impossible to start an "video+bfcp-audio" session. */
 	tmedia_bfcp_video = (0x01 << 9)/*must*/ | tmedia_bfcp, /* do not add "| video". Otherwise it will be impossible to start an "audio+bfcp-video" session. */
 
 	tmedia_msrp = (tmedia_chat | tmedia_file),
 	tmedia_audiovideo = (tmedia_audio | tmedia_video),
175b478c
 
 
 	tmedia_floor_control = (0x01 << 27),
c732d49e
 	//MCPTT
 	tmedia_mcptt = (0x01 << 13),
 	tmedia_mcptt_group = (0x01 << 14),
175b478c
 
c732d49e
 	tmedia_audio_ptt_mcptt =  tmedia_mcptt | tmedia_audio,
175b478c
 	tmedia_audio_ptt_mcptt_with_floor_control =  tmedia_mcptt | tmedia_audio | tmedia_floor_control,
c732d49e
 	tmedia_audio_ptt_group_mcptt = tmedia_audio_ptt_mcptt | tmedia_mcptt_group,
175b478c
 	tmedia_audio_ptt_group_mcptt_with_floor_control = tmedia_audio_ptt_mcptt | tmedia_mcptt_group | tmedia_floor_control,
c732d49e
 	tmedia_location=(0x01 << 15),
 	tmedia_mcptt_location=tmedia_mcptt | tmedia_location,
 
175b478c
 	//MCPTT affilation
c732d49e
 	tmedia_affiliation=(0x01 << 16),
 	tmedia_mcptt_affiliation=tmedia_mcptt | tmedia_affiliation,
175b478c
 	//MCPTT MBMS
c732d49e
 	tmedia_mbms=(0x01 << 17),
 	tmedia_mcptt_mbms=tmedia_mcptt | tmedia_mbms,
 	tmedia_mbms_audio = tmedia_audio | tmedia_mbms,
175b478c
 	//MCPTT authentication
 	tmedia_authentication=(0x01 << 18),
 	tmedia_mcptt_authentication=tmedia_mcptt | tmedia_authentication,
 	//CALL EMERGENCY
 	tmedia_emergency= (0x01 << 19),
 	tmedia_alert= (0x01 << 20),
 	tmedia_imminentperil= (0x01 << 21),
 
 
 	
 	tmedia_mcptt_emergence= tmedia_emergency | tmedia_audio_ptt_mcptt,
 	tmedia_mcptt_emergence_with_floor_control= tmedia_emergency | tmedia_audio_ptt_mcptt | tmedia_floor_control,
 	tmedia_mcptt_group_emergence= tmedia_mcptt_emergence | tmedia_mcptt_group,
 	tmedia_mcptt_group_emergence_with_floor_control= tmedia_mcptt_emergence | tmedia_mcptt_group | tmedia_floor_control,
 	tmedia_mcptt_alert= tmedia_alert | tmedia_audio_ptt_mcptt,
 	tmedia_mcptt_alert_with_floor_control= tmedia_alert | tmedia_audio_ptt_mcptt | tmedia_floor_control,
 	tmedia_mcptt_group_alert= tmedia_mcptt_alert | tmedia_mcptt_group,
 	tmedia_mcptt_group_alert_with_floor_control= tmedia_mcptt_alert | tmedia_mcptt_group | tmedia_floor_control,
 	tmedia_mcptt_imminentperil= tmedia_imminentperil | tmedia_audio_ptt_mcptt,
 	tmedia_mcptt_imminentperil_with_floor_control= tmedia_imminentperil | tmedia_audio_ptt_mcptt | tmedia_floor_control,
 	tmedia_mcptt_group_imminentperil= tmedia_mcptt_imminentperil | tmedia_mcptt_group,
 	tmedia_mcptt_group_imminentperil_with_floor_control= tmedia_mcptt_imminentperil | tmedia_mcptt_group | tmedia_floor_control,
 
 
 
 	tmedia_cms= (0x01 << 22),
 	tmedia_mcptt_cms=tmedia_mcptt | tmedia_cms,
 	tmedia_gms= (0x01 << 23),
 	tmedia_mcptt_gms=tmedia_mcptt | tmedia_gms,
 
 
 	tmedia_mcptt_chat = (0x01 << 24),
 	tmedia_audio_ptt_chat_mcptt = tmedia_audio_ptt_mcptt | tmedia_mcptt_chat,
 	tmedia_audio_ptt_chat_group_mcptt = tmedia_audio_ptt_mcptt | tmedia_mcptt_chat | tmedia_mcptt_group,
 	tmedia_audio_ptt_chat_group_mcptt_with_floor_control = tmedia_audio_ptt_mcptt | tmedia_mcptt_chat | tmedia_mcptt_group | tmedia_floor_control,
 	
 
 
 
 
 
c732d49e
 
 	tmedia_all = 0xff
 }
 tmedia_type_t;
 
 // @tinyWRAP
 typedef enum tmedia_mode_e
 {
 	tmedia_mode_none,
 	tmedia_mode_optional,
 	tmedia_mode_mandatory
 }
 tmedia_mode_t;
 
 // @tinyWRAP
 typedef enum tmedia_srtp_mode_e
 {
 	tmedia_srtp_mode_none,
 	tmedia_srtp_mode_optional,
 	tmedia_srtp_mode_mandatory
 }
 tmedia_srtp_mode_t;
 
 // @tinyWRAP
 typedef enum tmedia_srtp_type_e
 {
 	tmedia_srtp_type_none = 0x00,
 	tmedia_srtp_type_sdes = 0x01,
 	tmedia_srtp_type_dtls = 0x02,
 	tmedia_srtp_type_sdes_dtls = (tmedia_srtp_type_sdes | tmedia_srtp_type_dtls),
 	tmedia_srtp_type_key_mgmt_mikey = 0x04
 }
 tmedia_srtp_type_t;
 
 // @tinyWRAP
 typedef enum tmedia_t140_data_type_e
 {
 	tmedia_t140_data_type_utf8,
 	tmedia_t140_data_type_zero_width_no_break_space = 0xefbbbf,
 	tmedia_t140_data_type_backspace = 0x08,
 	tmedia_t140_data_type_esc = 0x1b,
 	tmedia_t140_data_type_cr = 0x0d,
 	tmedia_t140_data_type_lf = 0x0a,
 	tmedia_t140_data_type_cr_lf = 0x0d0a,
 	tmedia_t140_data_type_bell = 0x07,
 	tmedia_t140_data_type_sos = 0x98,
 	tmedia_t140_data_type_string_term = 0x9c,
 	tmedia_t140_data_type_graphic_start = 0x9b,
 	tmedia_t140_data_type_graphic_end = 0x6d,
 	tmedia_t140_data_type_loss_char_char = 0xfffd,
 	tmedia_t140_data_type_loss_utf8 = 0xefbfbd,
 }
 tmedia_t140_data_type_t;
 
 // @tinyWRAP
 typedef enum tmedia_rtcp_event_type_e
 {
 	tmedia_rtcp_event_type_fir, // Full Intra Refresh
 }
 tmedia_rtcp_event_type_t;
 
 // @tinyWRAP
 typedef enum tmedia_profile_e
 {
 	tmedia_profile_default,
 	// Enable all RTCWeb specifications:
 	// ICE, DTLS-SRTP, RTP/AVPF, FEC, RED, SDPCapNeg, RTCP-MUX, imageattr...
 	tmedia_profile_rtcweb
 }
 tmedia_profile_t;
 
 // @tinyWRAP
 typedef enum tmedia_pref_video_size_s
 { /* must be sorted like this */
 	tmedia_pref_video_size_sqcif, // 128 x 98
 	tmedia_pref_video_size_qcif, // 176 x 144
 	tmedia_pref_video_size_qvga, // 320 x 240
 	tmedia_pref_video_size_cif, // 352 x 288
 	tmedia_pref_video_size_hvga, // 480 x 320
 	tmedia_pref_video_size_vga, // 640 x 480
 	tmedia_pref_video_size_4cif, // 704 x 576
 	tmedia_pref_video_size_wvga, // 800 x 480
 	tmedia_pref_video_size_svga, // 800 x 600
 	tmedia_pref_video_size_480p, // 852 x 480
 	tmedia_pref_video_size_xga, // 1024 x 768
 	tmedia_pref_video_size_720p, // 1280 x 720
 	tmedia_pref_video_size_16cif, // 1408 x 1152
 	tmedia_pref_video_size_1080p, // 1920 x 1080
 	tmedia_pref_video_size_2160p, // 3840 x 2160
 }
 tmedia_pref_video_size_t;
 
 typedef enum tmedia_rtcweb_type_e
 {
 	tmedia_rtcweb_type_none,
 	tmedia_rtcweb_type_firefox,
 	tmedia_rtcweb_type_chrome,
 	tmedia_rtcweb_type_ie,
 	tmedia_rtcweb_type_safari,
 	tmedia_rtcweb_type_opera,
 	tmedia_rtcweb_type_ericsson,
 	tmedia_rtcweb_type_doubango
 }
 tmedia_rtcweb_type_t;
 
 typedef enum tmedia_video_encode_result_type_e
 {
 	tmedia_video_encode_result_type_none = 0x00,
 	tmedia_video_encode_result_type_params = (0x01 << 0), // e.g. SPS or PPS, DCT coeff., Quant params....
 	tmedia_video_encode_result_type_intra = (0x01 << 1),
 	tmedia_video_encode_result_type_key = tmedia_video_encode_result_type_intra,
 	tmedia_video_encode_result_type_gold = tmedia_video_encode_result_type_intra,
 	tmedia_video_encode_result_type_predicted = (0x01 << 2),
 	tmedia_video_encode_result_type_bipredicted = (0x01 << 3)
 }
 tmedia_video_encode_result_type_t;
 
 typedef struct tmedia_video_encode_result_xs
 {
 	tmedia_video_encode_result_type_t type;
 	const void* usr_data;
 	struct{
 		const void* ptr;
 		tsk_size_t size;
 	} buffer;
 	uint32_t duration;
 	tsk_bool_t last_chunck;
 	const tsk_object_t* proto_hdr;
 }
 tmedia_video_encode_result_xt;
 
 #define tmedia_video_encode_result_reset(result) \
 	(result)->type = tmedia_video_encode_result_type_none; \
 	(result)->usr_data = tsk_null; \
 	(result)->proto_hdr = tsk_null; \
 	(result)->buffer.ptr = tsk_null; \
 	(result)->buffer.size = 0; \
 	(result)->duration = 0; \
 	(result)->last_chunck = tsk_false; \
 	(result)->proto_hdr = tsk_null; \
 
 typedef enum tmedia_video_decode_result_type_e
 {
 	tmedia_video_decode_result_type_none,
 
 	tmedia_video_decode_result_type_error,
 	tmedia_video_decode_result_type_idr,
 }
 tmedia_video_decode_result_type_t;
 
 typedef struct tmedia_video_decode_result_xs
 {
 	tmedia_video_decode_result_type_t type;
 	const void* usr_data;
 	const tsk_object_t* proto_hdr; // RTP, RTSP....
 }
 tmedia_video_decode_result_xt;
 
 #define tmedia_video_decode_result_reset(result) \
 	(result)->type = tmedia_video_decode_result_type_none; \
 	(result)->usr_data = tsk_null; \
 	(result)->proto_hdr = tsk_null; \
 
 
 // @tinyWRAP
 typedef enum tmedia_chroma_e
 {
 	tmedia_chroma_none=0,
 	tmedia_chroma_rgb24,		// will be stored as bgr24 on x86 (little endians) machines; e.g. WindowsPhone7
 	tmedia_chroma_bgr24,		// used by windows consumer (DirectShow) - 
 	tmedia_chroma_rgb32,       // used by iOS4 consumer (iPhone and iPod touch)
 	tmedia_chroma_rgb565le,	// (used by both android and wince consumers)
 	tmedia_chroma_rgb565be,
 	tmedia_chroma_nv12, // used by iOS4 producer (iPhone and iPod Touch 3GS and 4)
 	tmedia_chroma_nv21, // Yuv420 SP (used by android producer)
 	tmedia_chroma_yuv422p,
 	tmedia_chroma_uyvy422, // used by iOS4 producer (iPhone and iPod Touch 3G) - Microsoft: MFVideoFormat_YUY2
 	tmedia_chroma_yuv420p, // Default
 	tmedia_chroma_mjpeg, // VirtualBox default camera mode (Windows as host and Linux as guest)
 	tmedia_chroma_yuyv422, // YUYV422 (V4L2 preferred format)
 }
 tmedia_chroma_t;
 
 // @tinyWRAP
 // @deprecated
 // keep order (low->unrestricted)
 typedef enum tmedia_bandwidth_level_e
 {
 	tmedia_bl_low,
 	tmedia_bl_medium,
 	tmedia_bl_hight,
 	tmedia_bl_unrestricted
 }
 tmedia_bandwidth_level_t;
 
 typedef enum tmedia_ro_type_e
 {
 	tmedia_ro_type_none = 0x00,
 	tmedia_ro_type_offer = (0x01 << 0),
 	tmedia_ro_type_answer = (0x01 << 1),
 	tmedia_ro_type_provisional = tmedia_ro_type_answer | (0x01 << 2),
 }
 tmedia_ro_type_t;
 
 
 /** List of all supported PoC QoE profiles */
 typedef enum tmedia_poc_qoe_profile_e
 {
 	tmedia_poc_qoe_profile_basic,
 	tmedia_poc_qoe_profile_premium,
 	tmedia_poc_qoe_profile_professional,
 	tmedia_poc_qoe_profile_government_use
 }
 tmedia_poc_qoe_profile_t;
 
 /** strengths */
 typedef enum tmedia_poc_qoe_profile_strength_e
 {
 	tmedia_poc_qoe_profile_strength_none,	
 	tmedia_poc_qoe_profile_strength_mandatory
 }
 tmedia_poc_qoe_profile_strength_t;
 
 
 TINYMEDIA_API tsk_size_t tmedia_plugin_register(struct tsk_plugin_s* plugin, enum tsk_plugin_def_type_e type, enum tsk_plugin_def_media_type_e media);
 TINYMEDIA_API tsk_size_t tmedia_plugin_unregister(struct tsk_plugin_s* plugin, enum tsk_plugin_def_type_e type, enum tsk_plugin_def_media_type_e media);
 TINYMEDIA_API tmedia_type_t tmedia_type_from_sdp(const struct tsdp_message_s* sdp);
 TINYMEDIA_API tmedia_type_t tmedia_type_from_sdp_headerM(const struct tsdp_header_M_s* M);
 TINYMEDIA_API int tmedia_parse_rtpmap(const char* rtpmap, char** name, int32_t* rate, int32_t* channels);
 TINYMEDIA_API int tmedia_video_get_size(tmedia_pref_video_size_t pref_vs, unsigned *width, unsigned *height);
 TINYMEDIA_API int tmedia_video_get_closest_cif_size(tmedia_pref_video_size_t pref_vs, tmedia_pref_video_size_t *cif_vs);
 TINYMEDIA_API int tmedia_video_get_closest_pref_size(unsigned width, unsigned height, tmedia_pref_video_size_t *pref_vs);
 TINYMEDIA_API int tmedia_parse_video_fmtp(const char* fmtp, tmedia_pref_video_size_t pref_vs, unsigned* width, unsigned* height, unsigned* fps);
 TINYMEDIA_API int tmedia_parse_video_imageattr(const char* imageattr, tmedia_pref_video_size_t pref_vs, unsigned* in_width, unsigned* in_height, unsigned* out_width, unsigned* out_height);
 TINYMEDIA_API char* tmedia_get_video_fmtp(tmedia_pref_video_size_t pref_vs);
 TINYMEDIA_API char* tmedia_get_video_imageattr(tmedia_pref_video_size_t pref_vs, unsigned in_width, unsigned in_height, unsigned out_width, unsigned out_height);
 TINYMEDIA_API int tmedia_get_video_quality(tmedia_bandwidth_level_t bl);
 TINYMEDIA_API int32_t tmedia_get_video_bandwidth_kbps(unsigned width, unsigned height, unsigned fps, unsigned motion_rank);
 TINYMEDIA_API int32_t tmedia_get_video_bandwidth_kbps_2(unsigned width, unsigned height, unsigned fps);
 TINYMEDIA_API int32_t tmedia_get_video_bandwidth_kbps_3();
 TINYMEDIA_API char* tmedia_get_poc_qoe_attribute_value(tmedia_poc_qoe_profile_t profile, tmedia_poc_qoe_profile_strength_t strength);
 #define tmedia_get_video_qscale tmedia_get_video_quality
 
 TMEDIA_END_DECLS
 
 #endif /* TINYMEDIA_COMMON_H */