modules/stream_out/smem.c

   1 /*****************************************************************************
   2  * smem.c: stream output to memory buffer module
   3  *****************************************************************************
   4  * Copyright (C) 2009 VLC authors and VideoLAN
   5  * $Id$
   6  *
   7  * Authors: Christophe Courtaut <christophe.courtaut@gmail.com>
   8  *
   9  * This program is free software; you can redistribute it and/or modify it
  10  * under the terms of the GNU Lesser General Public License as published by
  11  * the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public License
  20  * along with this program; if not, write to the Free Software Foundation,
  21  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 /*****************************************************************************
  25  * How to use it
  26  *****************************************************************************
  27  *
  28  * You should use this module in combination with the transcode module, to get
  29  * raw datas from it. This module does not make any conversion at all, so you
  30  * need to use the transcode module for this purpose.
  31  *
  32  * For example, you can use smem as it :
  33  * --sout="#transcode{vcodec=RV24,acodec=s16l}:smem{smem-options}"
  34  *
  35  * Into each lock function (audio and video), you will have all the information
  36  * you need to allocate a buffer, so that this module will copy data in it.
  37  *
  38  * the video-data and audio-data pointers will be passed to lock/unlock function
  39  *
  40  ******************************************************************************/
  41
  42 /*****************************************************************************
  43  * Preamble
  44  *****************************************************************************/
  45
  46 #ifdef HAVE_CONFIG_H
  47 # include "config.h"
  48 #endif
  49
  50 #include <vlc_common.h>
  51 #include <vlc_plugin.h>
  52 #include <vlc_sout.h>
  53 #include <vlc_block.h>
  54 #include <vlc_codec.h>
  55 #include <vlc_aout.h>
  56
  57 /*****************************************************************************
  58  * Module descriptor
  59  *****************************************************************************/
  60
  61 #define T_VIDEO_PRERENDER_CALLBACK N_( "Video prerender callback" )
  62 #define LT_VIDEO_PRERENDER_CALLBACK N_( "Address of the video prerender callback function. " \
  63                                 "This function will set the buffer where render will be done." )
  64
  65 #define T_AUDIO_PRERENDER_CALLBACK N_( "Audio prerender callback" )
  66 #define LT_AUDIO_PRERENDER_CALLBACK N_( "Address of the audio prerender callback function. " \
  67                                         "This function will set the buffer where render will be done." )
  68
  69 #define T_VIDEO_POSTRENDER_CALLBACK N_( "Video postrender callback" )
  70 #define LT_VIDEO_POSTRENDER_CALLBACK N_( "Address of the video postrender callback function. " \
  71                                         "This function will be called when the render is into the buffer." )
  72
  73 #define T_AUDIO_POSTRENDER_CALLBACK N_( "Audio postrender callback" )
  74 #define LT_AUDIO_POSTRENDER_CALLBACK N_( "Address of the audio postrender callback function. " \
  75                                         "This function will be called when the render is into the buffer." )
  76
  77 #define T_VIDEO_DATA N_( "Video Callback data" )
  78 #define LT_VIDEO_DATA N_( "Data for the video callback function." )
  79
  80 #define T_AUDIO_DATA N_( "Audio callback data" )
  81 #define LT_AUDIO_DATA N_( "Data for the audio callback function." )
  82
  83 #define T_TIME_SYNC N_( "Time Synchronized output" )
  84 #define LT_TIME_SYNC N_( "Time Synchronisation option for output. " \
  85                         "If true, stream will render as usual, else " \
  86                         "it will be rendered as fast as possible.")
  87
  88 static int  Open ( vlc_object_t * );
  89 static void Close( vlc_object_t * );
  90
  91 #define SOUT_CFG_PREFIX "sout-smem-"
  92 #define SOUT_PREFIX_VIDEO SOUT_CFG_PREFIX"video-"
  93 #define SOUT_PREFIX_AUDIO SOUT_CFG_PREFIX"audio-"
  94
  95 vlc_module_begin ()
  96     set_shortname( N_("Smem"))
  97     set_description( N_("Stream output to memory buffer") )
  98     set_capability( "sout stream", 0 )
  99     add_shortcut( "smem" )
 100     set_category( CAT_SOUT )
 101     set_subcategory( SUBCAT_SOUT_STREAM )
 102     add_string( SOUT_PREFIX_VIDEO "prerender-callback", "0", T_VIDEO_PRERENDER_CALLBACK, LT_VIDEO_PRERENDER_CALLBACK, true )
 103         change_volatile()
 104     add_string( SOUT_PREFIX_AUDIO "prerender-callback", "0", T_AUDIO_PRERENDER_CALLBACK, LT_AUDIO_PRERENDER_CALLBACK, true )
 105         change_volatile()
 106     add_string( SOUT_PREFIX_VIDEO "postrender-callback", "0", T_VIDEO_POSTRENDER_CALLBACK, LT_VIDEO_POSTRENDER_CALLBACK, true )
 107         change_volatile()
 108     add_string( SOUT_PREFIX_AUDIO "postrender-callback", "0", T_AUDIO_POSTRENDER_CALLBACK, LT_AUDIO_POSTRENDER_CALLBACK, true )
 109         change_volatile()
 110     add_string( SOUT_PREFIX_VIDEO "data", "0", T_VIDEO_DATA, LT_VIDEO_DATA, true )
 111         change_volatile()
 112     add_string( SOUT_PREFIX_AUDIO "data", "0", T_AUDIO_DATA, LT_VIDEO_DATA, true )
 113         change_volatile()
 114     add_bool( SOUT_CFG_PREFIX "time-sync", true, T_TIME_SYNC, LT_TIME_SYNC, true )
 115         change_private()
 116     set_callbacks( Open, Close )
 117 vlc_module_end ()
 118
 119
 120 /*****************************************************************************
 121  * Exported prototypes
 122  *****************************************************************************/
 123 static const char *const ppsz_sout_options[] = {
 124     "video-prerender-callback", "audio-prerender-callback",
 125     "video-postrender-callback", "audio-postrender-callback", "video-data", "audio-data", "time-sync", NULL
 126 };
 127
 128 static sout_stream_id_sys_t *Add( sout_stream_t *, const es_format_t * );
 129 static void              Del ( sout_stream_t *, sout_stream_id_sys_t * );
 130 static int               Send( sout_stream_t *, sout_stream_id_sys_t *, block_t* );
 131
 132 static sout_stream_id_sys_t *AddVideo( sout_stream_t *p_stream,
 133                                        const es_format_t *p_fmt );
 134 static sout_stream_id_sys_t *AddAudio( sout_stream_t *p_stream,
 135                                        const es_format_t *p_fmt );
 136
 137 static int SendVideo( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 138                       block_t *p_buffer );
 139 static int SendAudio( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 140                       block_t *p_buffer );
 141
 142 struct sout_stream_id_sys_t
 143 {
 144     es_format_t* format;
 145     void *p_data;
 146 };
 147
 148 struct sout_stream_sys_t
 149 {
 150     vlc_mutex_t *p_lock;
 151     void ( *pf_video_prerender_callback ) ( void* p_video_data, uint8_t** pp_pixel_buffer, size_t size );
 152     void ( *pf_audio_prerender_callback ) ( void* p_audio_data, uint8_t** pp_pcm_buffer, size_t size );
 153     void ( *pf_video_postrender_callback ) ( void* p_video_data, uint8_t* p_pixel_buffer, int width, int height, int pixel_pitch, size_t size, mtime_t pts );
 154     void ( *pf_audio_postrender_callback ) ( void* p_audio_data, uint8_t* p_pcm_buffer, unsigned int channels, unsigned int rate, unsigned int nb_samples, unsigned int bits_per_sample, size_t size, mtime_t pts );
 155     bool time_sync;
 156 };
 157
 158 /*****************************************************************************
 159  * Open:
 160  *****************************************************************************/
 161 static int Open( vlc_object_t *p_this )
 162 {
 163     char* psz_tmp;
 164     sout_stream_t *p_stream = (sout_stream_t*)p_this;
 165     sout_stream_sys_t *p_sys;
 166
 167     p_sys = calloc( 1, sizeof( sout_stream_sys_t ) );
 168     if( !p_sys )
 169         return VLC_ENOMEM;
 170     p_stream->p_sys = p_sys;
 171
 172     config_ChainParse( p_stream, SOUT_CFG_PREFIX, ppsz_sout_options,
 173                        p_stream->p_cfg );
 174
 175     p_sys->time_sync = var_GetBool( p_stream, SOUT_CFG_PREFIX "time-sync" );
 176
 177     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_VIDEO "prerender-callback" );
 178     p_sys->pf_video_prerender_callback = (void (*) (void *, uint8_t**, size_t))(intptr_t)atoll( psz_tmp );
 179     free( psz_tmp );
 180
 181     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_AUDIO "prerender-callback" );
 182     p_sys->pf_audio_prerender_callback = (void (*) (void* , uint8_t**, size_t))(intptr_t)atoll( psz_tmp );
 183     free( psz_tmp );
 184
 185     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_VIDEO "postrender-callback" );
 186     p_sys->pf_video_postrender_callback = (void (*) (void*, uint8_t*, int, int, int, size_t, mtime_t))(intptr_t)atoll( psz_tmp );
 187     free( psz_tmp );
 188
 189     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_AUDIO "postrender-callback" );
 190     p_sys->pf_audio_postrender_callback = (void (*) (void*, uint8_t*, unsigned int, unsigned int, unsigned int, unsigned int, size_t, mtime_t))(intptr_t)atoll( psz_tmp );
 191     free( psz_tmp );
 192
 193     /* Setting stream out module callbacks */
 194     p_stream->pf_add    = Add;
 195     p_stream->pf_del    = Del;
 196     p_stream->pf_send   = Send;
 197     p_stream->pace_nocontrol = p_sys->time_sync;
 198
 199     return VLC_SUCCESS;
 200 }
 201
 202 /*****************************************************************************
 203  * Close:
 204  *****************************************************************************/
 205 static void Close( vlc_object_t * p_this )
 206 {
 207     sout_stream_t *p_stream = (sout_stream_t*)p_this;
 208     free( p_stream->p_sys );
 209 }
 210
 211 static sout_stream_id_sys_t *Add( sout_stream_t *p_stream,
 212                                   const es_format_t *p_fmt )
 213 {
 214     sout_stream_id_sys_t *id = NULL;
 215
 216     if ( p_fmt->i_cat == VIDEO_ES )
 217         id = AddVideo( p_stream, p_fmt );
 218     else if ( p_fmt->i_cat == AUDIO_ES )
 219         id = AddAudio( p_stream, p_fmt );
 220     return id;
 221 }
 222
 223 static sout_stream_id_sys_t *AddVideo( sout_stream_t *p_stream,
 224                                        const es_format_t *p_fmt )
 225 {
 226     char* psz_tmp;
 227     sout_stream_id_sys_t    *id;
 228     int i_bits_per_pixel;
 229
 230     switch( p_fmt->i_codec )
 231     {
 232         case VLC_CODEC_RGB32:
 233         case VLC_CODEC_RGBA:
 234         case VLC_CODEC_ARGB:
 235             i_bits_per_pixel = 32;
 236             break;
 237         case VLC_CODEC_I444:
 238         case VLC_CODEC_RGB24:
 239             i_bits_per_pixel = 24;
 240             break;
 241         case VLC_CODEC_RGB16:
 242         case VLC_CODEC_RGB15:
 243         case VLC_CODEC_RGB8:
 244         case VLC_CODEC_I422:
 245             i_bits_per_pixel = 16;
 246             break;
 247         case VLC_CODEC_YV12:
 248         case VLC_CODEC_I420:
 249             i_bits_per_pixel = 12;
 250             break;
 251         case VLC_CODEC_RGBP:
 252             i_bits_per_pixel = 8;
 253             break;
 254         default:
 255             i_bits_per_pixel = 0;
 256             msg_Dbg( p_stream, "non raw video format detected (%4.4s), buffers will contain compressed video", (char *)&p_fmt->i_codec );
 257             break;
 258     }
 259
 260     id = calloc( 1, sizeof( sout_stream_id_sys_t ) );
 261     if( !id )
 262         return NULL;
 263
 264     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_VIDEO "data" );
 265     id->p_data = (void *)( intptr_t )atoll( psz_tmp );
 266     free( psz_tmp );
 267
 268     id->format = p_fmt;
 269     id->format->video.i_bits_per_pixel = i_bits_per_pixel;
 270     return id;
 271 }
 272
 273 static sout_stream_id_sys_t *AddAudio( sout_stream_t *p_stream,
 274                                        const es_format_t *p_fmt )
 275 {
 276     char* psz_tmp;
 277     sout_stream_id_sys_t* id;
 278     int i_bits_per_sample = aout_BitsPerSample( p_fmt->i_codec );
 279
 280     if( !i_bits_per_sample )
 281     {
 282         msg_Err( p_stream, "Smem does only support raw audio format" );
 283         return NULL;
 284     }
 285
 286     id = calloc( 1, sizeof( sout_stream_id_sys_t ) );
 287     if( !id )
 288         return NULL;
 289
 290     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_AUDIO "data" );
 291     id->p_data = (void *)( intptr_t )atoll( psz_tmp );
 292     free( psz_tmp );
 293
 294     id->format = p_fmt;
 295     id->format->audio.i_bitspersample = i_bits_per_sample;
 296     return id;
 297 }
 298
 299 static void Del( sout_stream_t *p_stream, sout_stream_id_sys_t *id )
 300 {
 301     VLC_UNUSED( p_stream );
 302     free( id );
 303 }
 304
 305 static int Send( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 306                  block_t *p_buffer )
 307 {
 308     if ( id->format->i_cat == VIDEO_ES )
 309         return SendVideo( p_stream, id, p_buffer );
 310     else if ( id->format->i_cat == AUDIO_ES )
 311         return SendAudio( p_stream, id, p_buffer );
 312     return VLC_SUCCESS;
 313 }
 314
 315 static int SendVideo( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 316                       block_t *p_buffer )
 317 {
 318     sout_stream_sys_t *p_sys = p_stream->p_sys;
 319     size_t i_size = p_buffer->i_buffer;
 320     uint8_t* p_pixels = NULL;
 321
 322     /* Calling the prerender callback to get user buffer */
 323     p_sys->pf_video_prerender_callback( id->p_data, &p_pixels, i_size );
 324
 325     if (!p_pixels)
 326     {
 327         msg_Err( p_stream, "No buffer given!" );
 328         block_ChainRelease( p_buffer );
 329         return VLC_EGENERIC;
 330     }
 331
 332     /* Copying data into user buffer */
 333     memcpy( p_pixels, p_buffer->p_buffer, i_size );
 334     /* Calling the postrender callback to tell the user his buffer is ready */
 335     p_sys->pf_video_postrender_callback( id->p_data, p_pixels,
 336                                          id->format->video.i_width, id->format->video.i_height,
 337                                          id->format->video.i_bits_per_pixel, i_size, p_buffer->i_pts );
 338     block_ChainRelease( p_buffer );
 339     return VLC_SUCCESS;
 340 }
 341
 342 static int SendAudio( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 343                       block_t *p_buffer )
 344 {
 345     sout_stream_sys_t *p_sys = p_stream->p_sys;
 346     int i_size;
 347     uint8_t* p_pcm_buffer = NULL;
 348     int i_samples = 0;
 349
 350     i_size = p_buffer->i_buffer;
 351     if (id->format->audio.i_channels <= 0)
 352     {
 353         msg_Warn( p_stream, "No buffer given!" );
 354         block_ChainRelease( p_buffer );
 355         return VLC_EGENERIC;
 356     }
 357
 358     i_samples = i_size / ( ( id->format->audio.i_bitspersample / 8 ) * id->format->audio.i_channels );
 359     /* Calling the prerender callback to get user buffer */
 360     p_sys->pf_audio_prerender_callback( id->p_data, &p_pcm_buffer, i_size );
 361     if (!p_pcm_buffer)
 362     {
 363         msg_Err( p_stream, "No buffer given!" );
 364         block_ChainRelease( p_buffer );
 365         return VLC_EGENERIC;
 366     }
 367
 368     /* Copying data into user buffer */
 369     memcpy( p_pcm_buffer, p_buffer->p_buffer, i_size );
 370     /* Calling the postrender callback to tell the user his buffer is ready */
 371     p_sys->pf_audio_postrender_callback( id->p_data, p_pcm_buffer,
 372                                          id->format->audio.i_channels, id->format->audio.i_rate, i_samples,
 373                                          id->format->audio.i_bitspersample, i_size, p_buffer->i_pts );
 374     block_ChainRelease( p_buffer );
 375     return VLC_SUCCESS;
 376 }
 377