/*
mediastreamer2 library - modular sound and video processing and streaming
Copyright (C) 2015  Belledonne Communications SARL

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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
*/

#ifndef MSVIDEOPRESETS_H
#define MSVIDEOPRESETS_H

#include <mediastreamer2/mscommon.h>
#include <mediastreamer2/msfilter.h>
#include <mediastreamer2/msfactory.h>
#include <mediastreamer2/msvideo.h>

/**
 * @file msvideopresets.h
 * @brief mediastreamer2 msvideopresets.h include file
 *
 * This file provide the API needed to manage video presets.
 *
 */

/**
 * @ingroup mediastreamer2_api
 * @{
 */

/**
 * Structure for video presets manager object.
 */
typedef struct _MSVideoPresetsManager MSVideoPresetsManager;

/**
 * Structure for video preset configuration object.
 */
typedef struct _MSVideoPresetConfiguration MSVideoPresetConfiguration;


#ifdef __cplusplus
extern "C"{
#endif

/**
 * Create a video presets manager object.
 * @param[in] The MSFactory to add the new video presets manager to.
 * @return The new MSVideoPresetsManager object.
 */
MS2_PUBLIC MSVideoPresetsManager * ms_video_presets_manager_new(MSFactory *factory);

/**
 * Destroy the video presets manager object.
 * @param[in] manager The MSVideoPresetsManager to destroy.
 */
MS2_PUBLIC void ms_video_presets_manager_destroy(MSVideoPresetsManager *manager);

/**
 * Register a video preset configuration.
 * @param[in] manager The MSVideoPresetsManager object.
 * @param[in] name The name of the video preset to register.
 * @param[in] tags A comma-separated list of tags describing the video preset.
 * @param[in] config The MSVideoConfiguration that is to be registered in the specified preset with the specified tags.
 */
MS2_PUBLIC void ms_video_presets_manager_register_preset_configuration(MSVideoPresetsManager *manager,
	const char *name, const char *tags, MSVideoConfiguration *config);

/**
 * Search for a video preset configuration.
 * @param[in] manager The MSVideoPresetsManager object.
 * @param[in] name The name of the video preset to search for.
 * @param[in] codecs_tags A list of tags describing the codec that will be used to select the video configuration to return.
 * @return The MSVideoConfiguration corresponding to the video preset being searched for and matching the codec_tags and
 * the platform tags.
 */
MS2_PUBLIC MSVideoPresetConfiguration * ms_video_presets_manager_find_preset_configuration(MSVideoPresetsManager *manager,
	const char *name, MSList *codec_tags);

/**
 * Get the video configuration corresponding to a video preset configuration.
 * @param[in] vpc MSVideoPresetConfiguration object obtained with ms_video_presets_manager_find_preset_configuration()
 * @return The MSVideoConfiguration corresponding to the video preset configuration.
 */
MS2_PUBLIC MSVideoConfiguration * ms_video_preset_configuration_get_video_configuration(MSVideoPresetConfiguration *vpc);

/**
 * Get the tags corresponding to a video preset configuration.
 * @param[in] vpc MSVideoPresetConfiguration object obtained with ms_video_presets_manager_find_preset_configuration()
 * @return A comma-separated list of tags describing the video preset configuration.
 */
MS2_PUBLIC char * ms_video_preset_configuration_get_tags_as_string(MSVideoPresetConfiguration *vpc);

#ifdef __cplusplus
}
#endif

/** @} */

#endif
