1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
/*
* 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_consumer.h
* @brief Base consumer object.
*
* @author Mamadou Diop <diopmamadou(at)doubango[dot]org>
*
*/
#ifndef TINYMEDIA_CONSUMER_H
#define TINYMEDIA_CONSUMER_H
#include "tinymedia_config.h"
#include "tinymedia/tmedia_codec.h"
#include "tinymedia/tmedia_params.h"
#include "tmedia_common.h"
TMEDIA_BEGIN_DECLS
#define TMEDIA_CONSUMER_BITS_PER_SAMPLE_DEFAULT 16
#define TMEDIA_CONSUMER_CHANNELS_DEFAULT 2
#define TMEDIA_CONSUMER_RATE_DEFAULT 8000
/**Max number of plugins (consumer types) we can create */
#if !defined(TMED_CONSUMER_MAX_PLUGINS)
# define TMED_CONSUMER_MAX_PLUGINS 0x0F
#endif
/** cast any pointer to @ref tmedia_consumer_t* object */
#define TMEDIA_CONSUMER(self) ((tmedia_consumer_t*)(self))
/** Default Video chroma */
#if !defined(TMEDIA_CONSUMER_CHROMA_DEFAULT)
# define TMEDIA_CONSUMER_CHROMA_DEFAULT tmedia_chroma_yuv420p
#endif
/** Base object for all Consumers */
typedef struct tmedia_consumer_s {
TSK_DECLARE_OBJECT;
tmedia_type_t type;
const char* desc;
struct {
int fps;
struct {
tmedia_chroma_t chroma;
tsk_size_t width;
tsk_size_t height;
} in;
struct {
tmedia_chroma_t chroma;
tsk_size_t width;
tsk_size_t height;
tsk_bool_t auto_resize; // auto_resize to "in.width, in.height"
} display;
} video;
struct {
uint8_t bits_per_sample;
uint8_t ptime;
uint8_t gain;
struct {
uint8_t channels;
uint32_t rate;
} in;
struct {
uint8_t channels;
uint32_t rate;
} out;
int32_t volume;
} audio;
tsk_bool_t is_started;
tsk_bool_t is_prepared;
uint64_t session_id;
struct {
enum tmedia_codec_id_e codec_id;
// other options to be added
} decoder;
const struct tmedia_consumer_plugin_def_s* plugin;
}
tmedia_consumer_t;
/** Virtual table used to define a consumer plugin */
typedef struct tmedia_consumer_plugin_def_s {
//! object definition used to create an instance of the consumer
const tsk_object_def_t* objdef;
//! the type of the consumer
tmedia_type_t type;
//! full description (usefull for debugging)
const char* desc;
int (*set) (tmedia_consumer_t* , const tmedia_param_t*);
int (* prepare) (tmedia_consumer_t*, const tmedia_codec_t* );
int (* start) (tmedia_consumer_t* );
int (* consume) (tmedia_consumer_t*, const void* buffer, tsk_size_t size, const tsk_object_t* proto_hdr);
int (* pause) (tmedia_consumer_t* );
int (* stop) (tmedia_consumer_t* );
}
tmedia_consumer_plugin_def_t;
#define TMEDIA_DECLARE_CONSUMER tmedia_consumer_t __consumer__
TINYMEDIA_API tmedia_consumer_t* tmedia_consumer_create(tmedia_type_t type, uint64_t session_id);
TINYMEDIA_API int tmedia_consumer_init(tmedia_consumer_t* self);
TINYMEDIA_API int tmedia_consumer_set(tmedia_consumer_t *self, const tmedia_param_t* param);
TINYMEDIA_API int tmedia_consumer_prepare(tmedia_consumer_t *self, const tmedia_codec_t* codec);
TINYMEDIA_API int tmedia_consumer_start(tmedia_consumer_t *self);
TINYMEDIA_API int tmedia_consumer_consume(tmedia_consumer_t* self, const void* buffer, tsk_size_t size, const tsk_object_t* proto_hdr);
TINYMEDIA_API int tmedia_consumer_pause(tmedia_consumer_t *self);
TINYMEDIA_API int tmedia_consumer_stop(tmedia_consumer_t *self);
TINYMEDIA_API int tmedia_consumer_deinit(tmedia_consumer_t* self);
TINYMEDIA_API int tmedia_consumer_plugin_register(const tmedia_consumer_plugin_def_t* plugin);
TINYMEDIA_API int tmedia_consumer_plugin_unregister(const tmedia_consumer_plugin_def_t* plugin);
TINYMEDIA_API int tmedia_consumer_plugin_unregister_by_type(tmedia_type_t type);
TMEDIA_END_DECLS
#endif /* TINYMEDIA_CONSUMER_H */
|
