mirror of
https://code.videolan.org/videolan/vlc
synced 2024-09-04 09:11:33 +02:00
![Laurent Aimar](/assets/img/avatar_default.png)
It will allows to control the moment at which the meta are updated to fix the delay introduced by timeshift and buffering. It will also simplify the way meta data are read by demuxers.
153 lines
5.2 KiB
C
153 lines
5.2 KiB
C
/*****************************************************************************
|
|
* vlc_es_out.h: es_out (demuxer output) descriptor, queries and methods
|
|
*****************************************************************************
|
|
* Copyright (C) 1999-2004 the VideoLAN team
|
|
* $Id$
|
|
*
|
|
* Authors: Laurent Aimar <fenrir@via.ecp.fr>
|
|
*
|
|
* This program 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 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
|
*****************************************************************************/
|
|
|
|
#ifndef VLC_ES_OUT_H
|
|
#define VLC_ES_OUT_H 1
|
|
|
|
/**
|
|
* \file
|
|
* This file defines functions and structures for handling es_out in stream output
|
|
*/
|
|
|
|
/**
|
|
* \defgroup es out Es Out
|
|
* @{
|
|
*/
|
|
|
|
enum es_out_query_e
|
|
{
|
|
/* set ES selected for the es category (audio/video/spu) */
|
|
ES_OUT_SET_ES, /* arg1= es_out_id_t* */
|
|
ES_OUT_RESTART_ES, /* arg1= es_out_id_t* */
|
|
|
|
/* set 'default' tag on ES (copied across from container) */
|
|
ES_OUT_SET_ES_DEFAULT, /* arg1= es_out_id_t* */
|
|
|
|
/* force selection/unselection of the ES (bypass current mode) */
|
|
ES_OUT_SET_ES_STATE,/* arg1= es_out_id_t* arg2=bool */
|
|
ES_OUT_GET_ES_STATE,/* arg1= es_out_id_t* arg2=bool* */
|
|
|
|
/* */
|
|
ES_OUT_SET_GROUP, /* arg1= int */
|
|
|
|
/* PCR handling, DTS/PTS will be automatically computed using thoses PCR
|
|
* XXX: SET_PCR(_GROUP) are in charge of the pace control. They will wait
|
|
* to slow down the demuxer so that it reads at the right speed.
|
|
* XXX: if you want PREROLL just call ES_OUT_SET_NEXT_DISPLAY_TIME and send
|
|
* as you would normally do.
|
|
*/
|
|
ES_OUT_SET_PCR, /* arg1=int64_t i_pcr(microsecond!) (using default group 0)*/
|
|
ES_OUT_SET_GROUP_PCR, /* arg1= int i_group, arg2=int64_t i_pcr(microsecond!)*/
|
|
ES_OUT_RESET_PCR, /* no arg */
|
|
|
|
/* Try not to use this one as it is a bit hacky */
|
|
ES_OUT_SET_ES_FMT, /* arg1= es_out_id_t* arg2=es_format_t* */
|
|
|
|
/* Allow preroll of data (data with dts/pts < i_pts for all ES will be decoded but not displayed */
|
|
ES_OUT_SET_NEXT_DISPLAY_TIME, /* arg1=int64_t i_pts(microsecond) */
|
|
/* Set meta data for group (dynamic) (The vlc_meta_t is not modified nor released) */
|
|
ES_OUT_SET_GROUP_META, /* arg1=int i_group arg2=const vlc_meta_t */
|
|
/* Set epg for group (dynamic) (The vlc_epg_t is not modified nor released) */
|
|
ES_OUT_SET_GROUP_EPG, /* arg1=int i_group arg2=const vlc_epg_t */
|
|
/* */
|
|
ES_OUT_DEL_GROUP, /* arg1=int i_group */
|
|
|
|
/* Set scrambled state for one es */
|
|
ES_OUT_SET_ES_SCRAMBLED_STATE, /* arg1=int i_group arg2=es_out_id_t* */
|
|
|
|
/* Stop any buffering being done, and ask if es_out has no more data to
|
|
* play.
|
|
* It will not block and so MUST be used carrefully. The only good reason
|
|
* is for interactive playback (like for DVD menu).
|
|
* XXX You SHALL call ES_OUT_RESET_PCR before any other es_out_Control/Send calls. */
|
|
ES_OUT_GET_EMPTY, /* arg1=bool* res=cannot fail */
|
|
|
|
/* Set global meta data (The vlc_meta_t is not modified nor released) */
|
|
ES_OUT_SET_META, /* arg1=const vlc_meta_t * */
|
|
|
|
/* First value usable for private control */
|
|
ES_OUT_PRIVATE_START = 0x10000,
|
|
};
|
|
|
|
struct es_out_t
|
|
{
|
|
es_out_id_t *(*pf_add) ( es_out_t *, const es_format_t * );
|
|
int (*pf_send) ( es_out_t *, es_out_id_t *, block_t * );
|
|
void (*pf_del) ( es_out_t *, es_out_id_t * );
|
|
int (*pf_control)( es_out_t *, int i_query, va_list );
|
|
void (*pf_destroy)( es_out_t * );
|
|
|
|
bool b_sout;
|
|
|
|
es_out_sys_t *p_sys;
|
|
};
|
|
|
|
LIBVLC_USED
|
|
static inline es_out_id_t * es_out_Add( es_out_t *out, const es_format_t *fmt )
|
|
{
|
|
return out->pf_add( out, fmt );
|
|
}
|
|
|
|
static inline void es_out_Del( es_out_t *out, es_out_id_t *id )
|
|
{
|
|
out->pf_del( out, id );
|
|
}
|
|
|
|
static inline int es_out_Send( es_out_t *out, es_out_id_t *id,
|
|
block_t *p_block )
|
|
{
|
|
return out->pf_send( out, id, p_block );
|
|
}
|
|
|
|
static inline int es_out_vaControl( es_out_t *out, int i_query, va_list args )
|
|
{
|
|
return out->pf_control( out, i_query, args );
|
|
}
|
|
|
|
static inline int es_out_Control( es_out_t *out, int i_query, ... )
|
|
{
|
|
va_list args;
|
|
int i_result;
|
|
|
|
va_start( args, i_query );
|
|
i_result = es_out_vaControl( out, i_query, args );
|
|
va_end( args );
|
|
return i_result;
|
|
}
|
|
|
|
static inline void es_out_Delete( es_out_t *p_out )
|
|
{
|
|
p_out->pf_destroy( p_out );
|
|
}
|
|
|
|
static inline int es_out_ControlSetMeta( es_out_t *out, const vlc_meta_t *p_meta )
|
|
{
|
|
return es_out_Control( out, ES_OUT_SET_META, p_meta );
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif
|