doubango/branches/2.0/doubango/tinyMEDIA/include/tinymedia/tmedia_common.h

264 lines
8.0 KiB
C

/*
* Copyright (C) 2010-2011 Mamadou Diop.
*
* Contact: Mamadou Diop <diopmamadou(at)doubango[dot]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_object.h"
TMEDIA_BEGIN_DECLS
struct tsdp_message_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_msrp = (tmedia_chat | tmedia_file),
tmedia_audiovideo = (tmedia_audio | tmedia_video),
tmedia_all = 0xff
}
tmedia_type_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_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_svga, // 800 x 600
tmedia_pref_video_size_480p, // 852 x 480
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)
tmedia_chroma_yuv420p, // Default
}
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;
TINYMEDIA_API tmedia_type_t tmedia_type_from_sdp(const struct tsdp_message_s* sdp);
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_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();
#define tmedia_get_video_qscale tmedia_get_video_quality
TMEDIA_END_DECLS
#endif /* TINYMEDIA_COMMON_H */