370 lines
12 KiB
C
370 lines
12 KiB
C
/*****************************************************************************
|
|
* vlc_vlm.h: VLM core structures
|
|
*****************************************************************************
|
|
* Copyright (C) 2000, 2001 VLC authors and VideoLAN
|
|
* $Id: 11111da6edb9fbecaa750af4c2851a5f0c338f0b $
|
|
*
|
|
* Authors: Simon Latapie <garf@videolan.org>
|
|
* Laurent Aimar <fenrir@videolan.org>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser 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_VLM_H
|
|
#define VLC_VLM_H 1
|
|
|
|
/**
|
|
* \file
|
|
* This file defines VLM core functions and structures in vlc
|
|
*/
|
|
|
|
#include <vlc_input.h>
|
|
|
|
/**
|
|
* \defgroup server VLM
|
|
* VLM is the server core in vlc that allows streaming of multiple media streams
|
|
* at the same time. It provides broadcast, schedule and video on demand features
|
|
* for streaming using several streaming and network protocols.
|
|
* @{
|
|
*/
|
|
|
|
/** VLM media */
|
|
typedef struct
|
|
{
|
|
int64_t id; /*< numeric id for vlm_media_t item */
|
|
bool b_enabled; /*< vlm_media_t is enabled */
|
|
|
|
char *psz_name; /*< descriptive name of vlm_media_t item */
|
|
|
|
int i_input; /*< number of input options */
|
|
char **ppsz_input; /*< array of input options */
|
|
|
|
int i_option; /*< number of output options */
|
|
char **ppsz_option; /*< array of output options */
|
|
|
|
char *psz_output; /*< */
|
|
|
|
bool b_vod; /*< vlm_media_t is of type VOD */
|
|
struct
|
|
{
|
|
bool b_loop; /*< this vlc_media_t broadcast item should loop */
|
|
} broadcast; /*< Broadcast specific information */
|
|
struct
|
|
{
|
|
char *psz_mux; /*< name of muxer to use */
|
|
} vod; /*< VOD specific information */
|
|
|
|
} vlm_media_t;
|
|
|
|
/** VLM media instance */
|
|
typedef struct
|
|
{
|
|
char *psz_name; /*< vlm media instance descriptive name */
|
|
|
|
int64_t i_time; /*< vlm media instance vlm media current time */
|
|
int64_t i_length; /*< vlm media instance vlm media item length */
|
|
double d_position; /*< vlm media instance position in stream */
|
|
bool b_paused; /*< vlm media instance is paused */
|
|
int i_rate; // normal is INPUT_RATE_DEFAULT
|
|
} vlm_media_instance_t;
|
|
|
|
#if 0
|
|
typedef struct
|
|
{
|
|
|
|
} vlm_schedule_t
|
|
#endif
|
|
|
|
/** VLM events
|
|
* You can catch vlm event by adding a callback on the variable "intf-event"
|
|
* of the VLM object.
|
|
* This variable is an address that will hold a vlm_event_t* value.
|
|
*/
|
|
enum vlm_event_type_e
|
|
{
|
|
/* */
|
|
VLM_EVENT_MEDIA_ADDED = 0x100,
|
|
VLM_EVENT_MEDIA_REMOVED,
|
|
VLM_EVENT_MEDIA_CHANGED,
|
|
|
|
/* */
|
|
VLM_EVENT_MEDIA_INSTANCE_STARTED = 0x200,
|
|
VLM_EVENT_MEDIA_INSTANCE_STOPPED,
|
|
VLM_EVENT_MEDIA_INSTANCE_STATE,
|
|
};
|
|
|
|
typedef struct
|
|
{
|
|
int i_type; /* a vlm_event_type_e value */
|
|
int64_t id; /* Media ID */
|
|
const char *psz_name; /* Media name */
|
|
const char *psz_instance_name; /* Instance name or NULL */
|
|
input_state_e input_state; /* Input instance event type */
|
|
} vlm_event_t;
|
|
|
|
/** VLM control query */
|
|
enum vlm_query_e
|
|
{
|
|
/* --- Media control */
|
|
/* Get all medias */
|
|
VLM_GET_MEDIAS, /* arg1=vlm_media_t ***, int *pi_media */
|
|
/* Delete all medias */
|
|
VLM_CLEAR_MEDIAS, /* no arg */
|
|
|
|
/* Add a new media */
|
|
VLM_ADD_MEDIA, /* arg1=vlm_media_t* arg2=int64_t *p_id res=can fail */
|
|
/* Delete an existing media */
|
|
VLM_DEL_MEDIA, /* arg1=int64_t id */
|
|
/* Change properties of an existing media (all fields but id and b_vod) */
|
|
VLM_CHANGE_MEDIA, /* arg1=vlm_media_t* res=can fail */
|
|
/* Get 1 media by it's ID */
|
|
VLM_GET_MEDIA, /* arg1=int64_t id arg2=vlm_media_t ** */
|
|
/* Get media ID from its name */
|
|
VLM_GET_MEDIA_ID, /* arg1=const char *psz_name arg2=int64_t* */
|
|
|
|
/* Media instance control XXX VOD control are for internal use only */
|
|
/* Get all media instances */
|
|
VLM_GET_MEDIA_INSTANCES, /* arg1=int64_t id arg2=vlm_media_instance_t *** arg3=int *pi_instance */
|
|
/* Delete all media instances */
|
|
VLM_CLEAR_MEDIA_INSTANCES, /* arg1=int64_t id */
|
|
/* Control broadcast instance */
|
|
VLM_START_MEDIA_BROADCAST_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name, int i_input_index res=can fail */
|
|
/* Control VOD instance */
|
|
VLM_START_MEDIA_VOD_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name, int i_input_index char *psz_vod_output res=can fail */
|
|
/* Stop an instance */
|
|
VLM_STOP_MEDIA_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name res=can fail */
|
|
/* Pause an instance */
|
|
VLM_PAUSE_MEDIA_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name res=can fail */
|
|
/* Get instance position time (in microsecond) */
|
|
VLM_GET_MEDIA_INSTANCE_TIME, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=int64_t * */
|
|
/* Set instance position time (in microsecond) */
|
|
VLM_SET_MEDIA_INSTANCE_TIME, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=int64_t */
|
|
/* Get instance position ([0.0 .. 1.0]) */
|
|
VLM_GET_MEDIA_INSTANCE_POSITION, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=double * */
|
|
/* Set instance position ([0.0 .. 1.0]) */
|
|
VLM_SET_MEDIA_INSTANCE_POSITION, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=double */
|
|
|
|
/* Schedule control */
|
|
VLM_CLEAR_SCHEDULES, /* no arg */
|
|
/* TODO: missing schedule control */
|
|
|
|
/* */
|
|
};
|
|
|
|
|
|
/* VLM specific - structures and functions */
|
|
|
|
/* ok, here is the structure of a vlm_message:
|
|
The parent node is ( name_of_the_command , NULL ), or
|
|
( name_of_the_command , message_error ) on error.
|
|
If a node has children, it should not have a value (=NULL).*/
|
|
struct vlm_message_t
|
|
{
|
|
char *psz_name; /*< message name */
|
|
char *psz_value; /*< message value */
|
|
|
|
int i_child; /*< number of child messages */
|
|
vlm_message_t **child; /*< array of vlm_message_t */
|
|
};
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
VLC_API vlm_t * vlm_New( vlc_object_t * );
|
|
#define vlm_New( a ) vlm_New( VLC_OBJECT(a) )
|
|
VLC_API void vlm_Delete( vlm_t * );
|
|
VLC_API int vlm_ExecuteCommand( vlm_t *, const char *, vlm_message_t ** );
|
|
VLC_API int vlm_Control( vlm_t *p_vlm, int i_query, ... );
|
|
|
|
VLC_API vlm_message_t * vlm_MessageSimpleNew( const char * );
|
|
VLC_API vlm_message_t * vlm_MessageNew( const char *, const char *, ... ) VLC_FORMAT( 2, 3 );
|
|
VLC_API vlm_message_t * vlm_MessageAdd( vlm_message_t *, vlm_message_t * );
|
|
VLC_API void vlm_MessageDelete( vlm_message_t * );
|
|
|
|
/* media helpers */
|
|
|
|
/**
|
|
* Initialize a vlm_media_t instance
|
|
* \param p_media vlm_media_t instance to initialize
|
|
*/
|
|
static inline void vlm_media_Init( vlm_media_t *p_media )
|
|
{
|
|
memset( p_media, 0, sizeof(vlm_media_t) );
|
|
p_media->id = 0; // invalid id
|
|
p_media->psz_name = NULL;
|
|
TAB_INIT( p_media->i_input, p_media->ppsz_input );
|
|
TAB_INIT( p_media->i_option, p_media->ppsz_option );
|
|
p_media->psz_output = NULL;
|
|
p_media->b_vod = false;
|
|
|
|
p_media->vod.psz_mux = NULL;
|
|
p_media->broadcast.b_loop = false;
|
|
}
|
|
|
|
/**
|
|
* Copy a vlm_media_t instance into another vlm_media_t instance
|
|
* \param p_dst vlm_media_t instance to copy to
|
|
* \param p_src vlm_media_t instance to copy from
|
|
*/
|
|
static inline void
|
|
#ifndef __cplusplus
|
|
vlm_media_Copy( vlm_media_t *restrict p_dst, const vlm_media_t *restrict p_src )
|
|
#else
|
|
vlm_media_Copy( vlm_media_t *p_dst, const vlm_media_t *p_src )
|
|
#endif
|
|
{
|
|
int i;
|
|
|
|
memset( p_dst, 0, sizeof(vlm_media_t) );
|
|
p_dst->id = p_src->id;
|
|
p_dst->b_enabled = p_src->b_enabled;
|
|
if( p_src->psz_name )
|
|
p_dst->psz_name = strdup( p_src->psz_name );
|
|
|
|
for( i = 0; i < p_src->i_input; i++ )
|
|
TAB_APPEND_CAST( (char**), p_dst->i_input, p_dst->ppsz_input, strdup(p_src->ppsz_input[i]) );
|
|
for( i = 0; i < p_src->i_option; i++ )
|
|
TAB_APPEND_CAST( (char**), p_dst->i_option, p_dst->ppsz_option, strdup(p_src->ppsz_option[i]) );
|
|
|
|
if( p_src->psz_output )
|
|
p_dst->psz_output = strdup( p_src->psz_output );
|
|
|
|
p_dst->b_vod = p_src->b_vod;
|
|
if( p_src->b_vod )
|
|
{
|
|
if( p_src->vod.psz_mux )
|
|
p_dst->vod.psz_mux = strdup( p_src->vod.psz_mux );
|
|
}
|
|
else
|
|
{
|
|
p_dst->broadcast.b_loop = p_src->broadcast.b_loop;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Cleanup and release memory associated with this vlm_media_t instance.
|
|
* You still need to release p_media itself with vlm_media_Delete().
|
|
* \param p_media vlm_media_t to cleanup
|
|
*/
|
|
static inline void vlm_media_Clean( vlm_media_t *p_media )
|
|
{
|
|
int i;
|
|
free( p_media->psz_name );
|
|
|
|
for( i = 0; i < p_media->i_input; i++ )
|
|
free( p_media->ppsz_input[i]);
|
|
TAB_CLEAN(p_media->i_input, p_media->ppsz_input );
|
|
|
|
for( i = 0; i < p_media->i_option; i++ )
|
|
free( p_media->ppsz_option[i]);
|
|
TAB_CLEAN(p_media->i_option, p_media->ppsz_option );
|
|
|
|
free( p_media->psz_output );
|
|
if( p_media->b_vod )
|
|
free( p_media->vod.psz_mux );
|
|
}
|
|
|
|
/**
|
|
* Allocate a new vlm_media_t instance
|
|
* \return vlm_media_t instance
|
|
*/
|
|
static inline vlm_media_t *vlm_media_New(void)
|
|
{
|
|
vlm_media_t *p_media = (vlm_media_t *)malloc( sizeof(vlm_media_t) );
|
|
if( p_media )
|
|
vlm_media_Init( p_media );
|
|
return p_media;
|
|
}
|
|
|
|
/**
|
|
* Delete a vlm_media_t instance
|
|
* \param p_media vlm_media_t instance to delete
|
|
*/
|
|
static inline void vlm_media_Delete( vlm_media_t *p_media )
|
|
{
|
|
vlm_media_Clean( p_media );
|
|
free( p_media );
|
|
}
|
|
|
|
/**
|
|
* Copy a vlm_media_t instance
|
|
* \param p_src vlm_media_t instance to copy
|
|
* \return vlm_media_t duplicate of p_src
|
|
*/
|
|
static inline vlm_media_t *vlm_media_Duplicate( vlm_media_t *p_src )
|
|
{
|
|
vlm_media_t *p_dst = vlm_media_New();
|
|
if( p_dst )
|
|
vlm_media_Copy( p_dst, p_src );
|
|
return p_dst;
|
|
}
|
|
|
|
/* media instance helpers */
|
|
/**
|
|
* Initialize vlm_media_instance_t
|
|
* \param p_instance vlm_media_instance_t to initialize
|
|
*/
|
|
static inline void vlm_media_instance_Init( vlm_media_instance_t *p_instance )
|
|
{
|
|
memset( p_instance, 0, sizeof(vlm_media_instance_t) );
|
|
p_instance->psz_name = NULL;
|
|
p_instance->i_time = 0;
|
|
p_instance->i_length = 0;
|
|
p_instance->d_position = 0.0;
|
|
p_instance->b_paused = false;
|
|
p_instance->i_rate = INPUT_RATE_DEFAULT;
|
|
}
|
|
|
|
/**
|
|
* Cleanup vlm_media_instance_t
|
|
* \param p_instance vlm_media_instance_t to cleanup
|
|
*/
|
|
static inline void vlm_media_instance_Clean( vlm_media_instance_t *p_instance )
|
|
{
|
|
free( p_instance->psz_name );
|
|
}
|
|
|
|
/**
|
|
* Allocate a new vlm_media_instance_t
|
|
* \return a new vlm_media_instance_t
|
|
*/
|
|
static inline vlm_media_instance_t *vlm_media_instance_New(void)
|
|
{
|
|
vlm_media_instance_t *p_instance = (vlm_media_instance_t *) malloc( sizeof(vlm_media_instance_t) );
|
|
if( p_instance )
|
|
vlm_media_instance_Init( p_instance );
|
|
return p_instance;
|
|
}
|
|
|
|
/**
|
|
* Delete a vlm_media_instance_t
|
|
* \param p_instance vlm_media_instance_t to delete
|
|
*/
|
|
static inline void vlm_media_instance_Delete( vlm_media_instance_t *p_instance )
|
|
{
|
|
vlm_media_instance_Clean( p_instance );
|
|
free( p_instance );
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/**@}*/
|
|
|
|
#endif
|