include/vlc_streaming.h

   1 /*****************************************************************************
   2  * vlc_streaming.h: Methods and descriptions for Streaming profiles
   3  *****************************************************************************
   4  * Copyright (C) 2002-2005 the VideoLAN team
   5  * $Id: stream_output.h 14151 2006-02-04 00:08:50Z zorglub $
   6  *
   7  * Authors: Clément Stenac <zorglub@videolan.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 #if !defined( __LIBVLC__ )
  25   #error You are not libvlc or one of its plugins. You cannot include this file
  26 #endif
  27
  28 #ifndef _VLC_STREAMING_H_
  29 #define _VLC_STREAMING_H_
  30
  31 #include <vlc/vlc.h>
  32
  33 /***********************************************************************
  34  * Predefined lists of streaming data
  35  ***********************************************************************/
  36
  37 #ifdef WIN32
  38 #define VCODECS_NUMBER 13
  39 #else
  40 #define VCODECS_NUMBER 12
  41 #endif
  42
  43 #define ACODECS_NUMBER 9
  44
  45 /// Keep this up to date !
  46 #define MUXERS_NUMBER 10
  47 enum
  48 {
  49     MUX_PS, MUX_TS, MUX_MPEG, MUX_OGG, MUX_RAW,
  50     MUX_ASF, MUX_AVI, MUX_MP4, MUX_MOV, MUX_WAV,
  51 };
  52
  53 enum { ACCESS_HTTP, ACCESS_UDP, ACCESS_MMS, ACCESS_RTP, ACCESS_FILE };
  54
  55 struct codec_desc_t {
  56     char *psz_display;
  57     char *psz_codec;
  58     char *psz_descr;
  59     int muxers[MUXERS_NUMBER];
  60 };
  61 //extern const struct codec vcodecs_array[];
  62 //extern const struct codec acodecs_array[];
  63
  64 struct method_desc_t {
  65     char *psz_access;
  66     char *psz_method;
  67     char *psz_descr;
  68     char *psz_address;
  69     int   muxers[MUXERS_NUMBER];
  70 };
  71 //xtern const struct method methods_array[];
  72
  73 struct mux_desc_t {
  74     int   id;
  75     char *psz_mux;
  76     char *psz_encap;
  77     char *psz_descr;
  78 };
  79 //extern const struct mux_desc_t muxers_array[];
  80
  81
  82 /* Standard bitrates arrays */
  83 //static const char * vbitrates_array[] =
  84 //{ "3072", "2048", "1024", "768", "512", "384", "256", "192", "128", "96",
  85 //  "64" };
  86
  87 //static const char *abitrates_array[] =
  88 //{ "512", "256", "192", "128", "96", "64", "32", "16" } ;
  89 //
  90
  91
  92 /***********************************************************************
  93  * Streaming profiles
  94  ***********************************************************************/
  95
  96 /****************** Parameters handling *********************/
  97 struct sout_param_t
  98 {
  99     int i_type;
 100     int i_element;
 101     char *psz_id;
 102     char *psz_string;
 103     vlc_value_t value;
 104 };
 105
 106 struct sout_pcat_t
 107 {
 108     char *psz_name;
 109     int i_params;
 110     sout_param_t **pp_params;
 111 };
 112
 113 void streaming_ParameterApply( sout_param_t *p_param, char **ppsz_dest,
 114                            int *pi_dest, float *pf_dest, vlc_bool_t *pb_dest );
 115
 116
 117 /******** Module types definitions and parametrable elements ***************/
 118
 119 /* Transcode */
 120 enum { I_VB, I_AB, I_CHANNELS, F_SCALE, B_SOVERLAY, PSZ_VC, PSZ_AC, PSZ_SC,
 121        PSZ_VE, PSZ_AE };
 122 struct sout_transcode_t
 123 {
 124     int i_vb, i_ab, i_channels;
 125     float f_scale;
 126     vlc_bool_t b_soverlay;
 127     char *psz_vcodec;
 128     char *psz_acodec, *psz_scodec, *psz_venc, *psz_aenc;
 129     char *psz_additional;
 130
 131     int i_params; sout_param_t **pp_params;
 132 };
 133 void streaming_TranscodeParametersApply( sout_transcode_t *p_module );
 134
 135 /* Standard */
 136 enum { PSZ_MUX, PSZ_ACCESS, PSZ_URL, PSZ_NAME, PSZ_GROUP };
 137 struct sout_std_t
 138 {
 139     char *psz_mux, *psz_access;
 140     char *psz_url, *psz_name, *psz_group;
 141     int i_params; sout_param_t **pp_params;
 142 };
 143 void streaming_StdParametersApply( sout_std_t *p_module );
 144
 145 /* Display */
 146 struct sout_display_t
 147 {
 148 };
 149
 150 /* Duplicate */
 151 struct sout_duplicate_t
 152 {
 153     int i_children, i_conditions;
 154     sout_chain_t **pp_children;
 155     char **ppsz_conditions;
 156 };
 157
 158 /******* Generic profile structures and manipulation functions ********/
 159 typedef union
 160 {
 161     sout_transcode_t *p_transcode;
 162     sout_std_t       *p_std;
 163     sout_duplicate_t *p_duplicate;
 164     sout_display_t   *p_display;
 165 } sout_module_type_t;
 166
 167 struct sout_module_t
 168 {
 169     int i_type;
 170     sout_module_type_t typed;
 171     sout_module_t *p_parent;
 172 };
 173
 174 enum { SOUT_MOD_TRANSCODE, SOUT_MOD_STD, SOUT_MOD_RTP, SOUT_MOD_DUPLICATE,
 175        SOUT_MOD_DISPLAY };
 176
 177 struct sout_chain_t
 178 {
 179     int i_modules;
 180     sout_module_t **pp_modules;
 181
 182     int i_options;
 183     char **ppsz_options;
 184
 185     int i_pcats;
 186     sout_pcat_t **pp_pcats;
 187 };
 188
 189 static inline sout_chain_t *streaming_ChainNew(void)
 190 {
 191     DECMALLOC_NULL( p_chain, sout_chain_t );
 192     memset( p_chain, 0, sizeof( sout_chain_t ) );
 193     p_chain->i_options = 0;
 194     return p_chain;
 195 }
 196
 197 struct streaming_profile_t
 198 {
 199     char *psz_title;
 200     char *psz_description;
 201     sout_chain_t *p_chain;
 202 };
 203
 204 /**************** GUI interaction *****************/
 205 struct sout_gui_descr_t
 206 {
 207     /* Access */
 208     vlc_bool_t b_local, b_file, b_http, b_mms, b_rtp, b_udp, b_dump;
 209     char *psz_file, *psz_http, *psz_mms, *psz_rtp, *psz_udp;
 210     int i_http, i_mms, i_rtp, i_udp;
 211
 212     /* Mux */
 213     char *psz_mux;
 214
 215     /* Transcode */
 216     vlc_bool_t b_soverlay;
 217     char *psz_vcodec, *psz_acodec, *psz_scodec;
 218     int i_vb, i_ab, i_channels;
 219     float f_scale;
 220
 221     /* Misc */
 222     vlc_bool_t b_sap, b_all_es;
 223     char *psz_group, *psz_name;
 224     int i_ttl;
 225 };
 226
 227 VLC_EXPORT(void, streaming_GuiDescToChain,(vlc_object_t*, sout_chain_t*, sout_gui_descr_t*));
 228 VLC_EXPORT(char*, streaming_ChainToPsz,(sout_chain_t*));
 229
 230 /***************** Profile parsing ***********************/
 231
 232 struct profile_parser_t
 233 {
 234     char *psz_profile;
 235     streaming_profile_t *p_profile;
 236 };
 237
 238 #endif