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 *, es_format_t * );
 129 static int               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, es_format_t *p_fmt );
 133 static sout_stream_id_sys_t *AddAudio( sout_stream_t *p_stream, es_format_t *p_fmt );
 134
 135 static int SendVideo( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 136                       block_t *p_buffer );
 137 static int SendAudio( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 138                       block_t *p_buffer );
 139
 140 struct sout_stream_id_sys_t
 141 {
 142     es_format_t* format;
 143     void *p_data;
 144 };
 145
 146 struct sout_stream_sys_t
 147 {
 148     vlc_mutex_t *p_lock;
 149     void ( *pf_video_prerender_callback ) ( void* p_video_data, uint8_t** pp_pixel_buffer, size_t size );
 150     void ( *pf_audio_prerender_callback ) ( void* p_audio_data, uint8_t** pp_pcm_buffer, size_t size );
 151     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 );
 152     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 );
 153     bool time_sync;
 154 };
 155
 156 /*****************************************************************************
 157  * Open:
 158  *****************************************************************************/
 159 static int Open( vlc_object_t *p_this )
 160 {
 161     char* psz_tmp;
 162     sout_stream_t *p_stream = (sout_stream_t*)p_this;
 163     sout_stream_sys_t *p_sys;
 164
 165     p_sys = calloc( 1, sizeof( sout_stream_sys_t ) );
 166     if( !p_sys )
 167         return VLC_ENOMEM;
 168     p_stream->p_sys = p_sys;
 169
 170     config_ChainParse( p_stream, SOUT_CFG_PREFIX, ppsz_sout_options,
 171                        p_stream->p_cfg );
 172
 173     p_sys->time_sync = var_GetBool( p_stream, SOUT_CFG_PREFIX "time-sync" );
 174
 175     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_VIDEO "prerender-callback" );
 176     p_sys->pf_video_prerender_callback = (void (*) (void *, uint8_t**, size_t))(intptr_t)atoll( psz_tmp );
 177     free( psz_tmp );
 178
 179     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_AUDIO "prerender-callback" );
 180     p_sys->pf_audio_prerender_callback = (void (*) (void* , uint8_t**, size_t))(intptr_t)atoll( psz_tmp );
 181     free( psz_tmp );
 182
 183     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_VIDEO "postrender-callback" );
 184     p_sys->pf_video_postrender_callback = (void (*) (void*, uint8_t*, int, int, int, size_t, mtime_t))(intptr_t)atoll( psz_tmp );
 185     free( psz_tmp );
 186
 187     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_AUDIO "postrender-callback" );
 188     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 );
 189     free( psz_tmp );
 190
 191     /* Setting stream out module callbacks */
 192     p_stream->pf_add    = Add;
 193     p_stream->pf_del    = Del;
 194     p_stream->pf_send   = Send;
 195     p_stream->pace_nocontrol = p_sys->time_sync;
 196
 197     return VLC_SUCCESS;
 198 }
 199
 200 /*****************************************************************************
 201  * Close:
 202  *****************************************************************************/
 203 static void Close( vlc_object_t * p_this )
 204 {
 205     sout_stream_t *p_stream = (sout_stream_t*)p_this;
 206     free( p_stream->p_sys );
 207 }
 208
 209 static sout_stream_id_sys_t *Add( sout_stream_t *p_stream, es_format_t *p_fmt )
 210 {
 211     sout_stream_id_sys_t *id = NULL;
 212
 213     if ( p_fmt->i_cat == VIDEO_ES )
 214         id = AddVideo( p_stream, p_fmt );
 215     else if ( p_fmt->i_cat == AUDIO_ES )
 216         id = AddAudio( p_stream, p_fmt );
 217     return id;
 218 }
 219
 220 static sout_stream_id_sys_t *AddVideo( sout_stream_t *p_stream, es_format_t *p_fmt )
 221 {
 222     char* psz_tmp;
 223     sout_stream_id_sys_t    *id;
 224     int i_bits_per_pixel;
 225
 226     switch( p_fmt->i_codec )
 227     {
 228         case VLC_CODEC_RGB32:
 229         case VLC_CODEC_RGBA:
 230         case VLC_CODEC_ARGB:
 231             i_bits_per_pixel = 32;
 232             break;
 233         case VLC_CODEC_I444:
 234         case VLC_CODEC_RGB24:
 235             i_bits_per_pixel = 24;
 236             break;
 237         case VLC_CODEC_RGB16:
 238         case VLC_CODEC_RGB15:
 239         case VLC_CODEC_RGB8:
 240         case VLC_CODEC_I422:
 241             i_bits_per_pixel = 16;
 242             break;
 243         case VLC_CODEC_YV12:
 244         case VLC_CODEC_I420:
 245             i_bits_per_pixel = 12;
 246             break;
 247         case VLC_CODEC_RGBP:
 248             i_bits_per_pixel = 8;
 249             break;
 250         default:
 251             i_bits_per_pixel = 0;
 252             msg_Dbg( p_stream, "non raw video format detected (%4.4s), buffers will contain compressed video", (char *)&p_fmt->i_codec );
 253             break;
 254     }
 255
 256     id = calloc( 1, sizeof( sout_stream_id_sys_t ) );
 257     if( !id )
 258         return NULL;
 259
 260     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_VIDEO "data" );
 261     id->p_data = (void *)( intptr_t )atoll( psz_tmp );
 262     free( psz_tmp );
 263
 264     id->format = p_fmt;
 265     id->format->video.i_bits_per_pixel = i_bits_per_pixel;
 266     return id;
 267 }
 268
 269 static sout_stream_id_sys_t *AddAudio( sout_stream_t *p_stream, es_format_t *p_fmt )
 270 {
 271     char* psz_tmp;
 272     sout_stream_id_sys_t* id;
 273     int i_bits_per_sample = aout_BitsPerSample( p_fmt->i_codec );
 274
 275     if( !i_bits_per_sample )
 276     {
 277         msg_Err( p_stream, "Smem does only support raw audio format" );
 278         return NULL;
 279     }
 280
 281     id = calloc( 1, sizeof( sout_stream_id_sys_t ) );
 282     if( !id )
 283         return NULL;
 284
 285     psz_tmp = var_GetString( p_stream, SOUT_PREFIX_AUDIO "data" );
 286     id->p_data = (void *)( intptr_t )atoll( psz_tmp );
 287     free( psz_tmp );
 288
 289     id->format = p_fmt;
 290     id->format->audio.i_bitspersample = i_bits_per_sample;
 291     return id;
 292 }
 293
 294 static int Del( sout_stream_t *p_stream, sout_stream_id_sys_t *id )
 295 {
 296     VLC_UNUSED( p_stream );
 297     free( id );
 298     return VLC_SUCCESS;
 299 }
 300
 301 static int Send( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 302                  block_t *p_buffer )
 303 {
 304     if ( id->format->i_cat == VIDEO_ES )
 305         return SendVideo( p_stream, id, p_buffer );
 306     else if ( id->format->i_cat == AUDIO_ES )
 307         return SendAudio( p_stream, id, p_buffer );
 308     return VLC_SUCCESS;
 309 }
 310
 311 static int SendVideo( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 312                       block_t *p_buffer )
 313 {
 314     sout_stream_sys_t *p_sys = p_stream->p_sys;
 315     int i_line, i_line_size, i_pixel_pitch;
 316     size_t i_size;
 317     uint8_t* p_pixels = NULL;
 318
 319     if( id->format->video.i_bits_per_pixel > 0 )
 320     {
 321         i_line = id->format->video.i_height;
 322         i_pixel_pitch = id->format->video.i_bits_per_pixel / 8;
 323         i_line_size = i_pixel_pitch * id->format->video.i_width;
 324         i_size = i_line * i_line_size;
 325     }
 326     else
 327     {
 328         i_size = p_buffer->i_buffer;
 329     }
 330     /* Calling the prerender callback to get user buffer */
 331     p_sys->pf_video_prerender_callback( id->p_data, &p_pixels, i_size );
 332
 333     if (!p_pixels)
 334     {
 335         msg_Err( p_stream, "No buffer given!" );
 336         block_ChainRelease( p_buffer );
 337         return VLC_EGENERIC;
 338     }
 339
 340     /* Copying data into user buffer */
 341     if( id->format->video.i_bits_per_pixel > 0 )
 342     {
 343         uint8_t *p_in = p_buffer->p_buffer;
 344         uint8_t *p_out = p_pixels;
 345
 346         for ( int line = 0; line < i_line; line++ )
 347         {
 348             memcpy( p_out, p_in, i_line_size );
 349             p_out += i_line_size;
 350             p_in += i_line_size;
 351         }
 352     }
 353     else
 354     {
 355         memcpy( p_pixels, p_buffer->p_buffer, i_size );
 356     }
 357     /* Calling the postrender callback to tell the user his buffer is ready */
 358     p_sys->pf_video_postrender_callback( id->p_data, p_pixels,
 359                                          id->format->video.i_width, id->format->video.i_height,
 360                                          id->format->video.i_bits_per_pixel, i_size, p_buffer->i_pts );
 361     block_ChainRelease( p_buffer );
 362     return VLC_SUCCESS;
 363 }
 364
 365 static int SendAudio( sout_stream_t *p_stream, sout_stream_id_sys_t *id,
 366                       block_t *p_buffer )
 367 {
 368     sout_stream_sys_t *p_sys = p_stream->p_sys;
 369     int i_size;
 370     uint8_t* p_pcm_buffer = NULL;
 371     int i_samples = 0;
 372
 373     i_size = p_buffer->i_buffer;
 374     if (id->format->audio.i_channels <= 0)
 375     {
 376         msg_Warn( p_stream, "No buffer given!" );
 377         block_ChainRelease( p_buffer );
 378         return VLC_EGENERIC;
 379     }
 380
 381     i_samples = i_size / ( ( id->format->audio.i_bitspersample / 8 ) * id->format->audio.i_channels );
 382     /* Calling the prerender callback to get user buffer */
 383     p_sys->pf_audio_prerender_callback( id->p_data, &p_pcm_buffer, i_size );
 384     if (!p_pcm_buffer)
 385     {
 386         msg_Err( p_stream, "No buffer given!" );
 387         block_ChainRelease( p_buffer );
 388         return VLC_EGENERIC;
 389     }
 390
 391     /* Copying data into user buffer */
 392     memcpy( p_pcm_buffer, p_buffer->p_buffer, i_size );
 393     /* Calling the postrender callback to tell the user his buffer is ready */
 394     p_sys->pf_audio_postrender_callback( id->p_data, p_pcm_buffer,
 395                                          id->format->audio.i_channels, id->format->audio.i_rate, i_samples,
 396                                          id->format->audio.i_bitspersample, i_size, p_buffer->i_pts );
 397     block_ChainRelease( p_buffer );
 398     return VLC_SUCCESS;
 399 }
 400