switcher.c File Reference

#include <assert.h>
#include <errno.h>
#include <inttypes.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "audio/types.h"
#include "debug.h"
#include "lib_common.h"
#include "module.h"
#include "utils/color_out.h"
#include "utils/macros.h"
#include "utils/text.h"
#include "video.h"
#include "video_capture.h"

Include dependency graph for switcher.c:

Go to the source code of this file.

Classes
struct	vidcap_switcher_state

Macros
#define	MOD_NAME   "[switcher] "

Functions
static int	parse_fmt (struct vidcap_switcher_state *s, char *cfg)
	REGISTER_MODULE (switcher, &vidcap_switcher_info, LIBRARY_CLASS_VIDEO_CAPTURE, VIDEO_CAPTURE_ABI_VERSION)
static void	show_help (void)
static void	vidcap_switcher_done (void *state)
static struct video_frame *	vidcap_switcher_grab (void *state, struct audio_frame **audio)
static int	vidcap_switcher_init (struct vidcap_params *params, void **state)
static void	vidcap_switcher_probe (struct device_info **available_cards, int *count, void(**deleter)(void *))
static void	vidcap_switcher_register_keyboard_ctl (struct vidcap_switcher_state *s)

Variables
static const struct video_capture_info	vidcap_switcher_info

Detailed Description

Author

Martin Pulec pulec.nosp@m.@ces.nosp@m.net.c.nosp@m.z

Definition in file switcher.c.

Macro Definition Documentation

MOD_NAME

#define MOD_NAME   "[switcher] "

Definition at line 56 of file switcher.c.

Referenced by parse_fmt(), and vidcap_switcher_grab().

Function Documentation

parse_fmt()

static int parse_fmt ( struct vidcap_switcher_state * s, char * cfg )

static

Definition at line 136 of file switcher.c.

{
        assert(cfg != NULL);
        char *save_ptr = NULL;
        char *item = NULL;
        while ((item = strtok_r(cfg, ":", &save_ptr))) {
                if (strcmp(item, "help") == 0) {
                        show_help();
                        return VIDCAP_INIT_NOERR;
                }
                if (strcmp(item, "excl_init") == 0) {
                        s->excl_init = true;
                } else if (strcmp(item, "fallback") == 0) {
                        s->fallback = true;
                } else if (strncasecmp(item, "select=", strlen("select=")) ==
                           0) {
                        char *val_s  = item + strlen("select=");
                        char *endptr = NULL;
                        errno    = 0;
                        long val = strtol(val_s, &endptr, 0);
                        if (errno != 0 || *val_s == '\0' || *endptr != '\0' ||
                            val < 0 || (uintmax_t) val > UINT_MAX) {
                                log_msg(LOG_LEVEL_ERROR,
                                        MOD_NAME "Wrong value: %s\n", val_s);
                                return VIDCAP_INIT_FAIL;
                        }
                        s->selected_device = val;
                } else {
                        MSG(ERROR, "Unknown initialization option: %s\n", item);
                        show_help();
                        return VIDCAP_INIT_FAIL;
                }
                cfg = NULL;
        }
        if (s->excl_init && s->fallback) {
                MSG(ERROR, "Options \"excl_init\" and \"fallback\" are "
                           "mutualy incompatible!\n");
                return VIDCAP_INIT_FAIL;
        }
 
        return 0;
}

References vidcap_switcher_state::excl_init, vidcap_switcher_state::fallback, LOG_LEVEL_ERROR, log_msg(), MOD_NAME, MSG, vidcap_switcher_state::selected_device, show_help(), val, VIDCAP_INIT_FAIL, and VIDCAP_INIT_NOERR.

Referenced by vidcap_switcher_init().

Here is the call graph for this function:

REGISTER_MODULE()

REGISTER_MODULE	(	switcher	,
		&	vidcap_switcher_info,
		LIBRARY_CLASS_VIDEO_CAPTURE	,
		VIDEO_CAPTURE_ABI_VERSION	)

show_help()

static void show_help ( void )

static

Definition at line 62 of file switcher.c.

{
        char desc[] =
            TBOLD("switcher") " capture allow switching between given "
                              "video devices optionally with audio "
                              "(see below or wiki for usage).\n\n"
                              "Switching can be done by using keys 1-N or "
                              "via a control socket.\n\n";
        color_printf("%s", wrap_paragraph(desc));
 
        color_printf("Usage:\n");
        color_printf("\t" TBOLD(TRED("-t switcher")) "[opts] " TBOLD(
            "-t <dev1> -t "
            "<dev2> [-t ...]") "\n\n");
 
        color_printf("options:\n");
        color_printf("\t" TBOLD(
            "<devN>") " - a configuration of device to be switched\n");
        color_printf("\t" TBOLD(
            "select=<N>") " - specifies initially selected device idx\n");
        color_printf("\t" TBOLD(
            "excl_init") " - devices will be initialized after switching to "
                         "and\n\t\tdeinitialized after switching to another\n");
        color_printf("\t" TBOLD(
            "fallback") " - in case that capture doesn't return a frame (in "
                        "time),\n\t\tcapture from next available "
                        "device(s)\n\n");
 
        color_printf(TBOLD("Audio") " and other " TBOLD(
            "positional") " options should precede its respective device.\n");
        color_printf("Eg. in:\n" TBOLD(
            "   uv -t switcher -s embedded -F flip -t testcard -s "
            "analog -t decklink") "\n");
        color_printf("flip & embedded aplies to testcard, analog to decklink.\n");
        color_printf(
            "See "
            "also: <" TUNDERLINE("https://github.com/CESNET/UltraGrid/wiki/"
                                 "Video-Switcher#audio") ">\n\n");
}

References color_printf(), desc, TBOLD, TRED, TUNDERLINE, and wrap_paragraph().

Referenced by parse_fmt().

Here is the call graph for this function:

vidcap_switcher_done()

static void vidcap_switcher_done ( void * state )

static

Definition at line 258 of file switcher.c.

{
        struct vidcap_switcher_state *s = (struct vidcap_switcher_state *) state;
        if (s == NULL) {
                return;
        }
 
        if (s->devices != NULL) {
                for (unsigned int i = 0U; i < s->devices_cnt; ++i) {
                        if (s->devices[i] != NULL) {
                                vidcap_done(s->devices[i]);
                        }
                }
        }
        module_done(&s->mod);
        free(s->devices);
        free(s->device_names);
        free(s);
}

References vidcap_switcher_state::device_names, vidcap_switcher_state::devices, vidcap_switcher_state::devices_cnt, vidcap_switcher_state::mod, module_done(), state, and vidcap_done().

Referenced by vidcap_switcher_init().

Here is the call graph for this function:

vidcap_switcher_grab()

static struct video_frame * vidcap_switcher_grab ( void * state, struct audio_frame ** audio )

static

Definition at line 279 of file switcher.c.

{
        struct vidcap_switcher_state *s = (struct vidcap_switcher_state *) state;
        struct audio_frame *audio_frame = NULL;
        struct video_frame *frame = NULL;
 
        struct message *msg;
        while ((msg = check_message(&s->mod))) {
                struct msg_universal *msg_univ = (struct msg_universal *) msg;
                char *endptr = NULL;
                errno = 0;
                long val = strtol(msg_univ->text, &endptr, 0);
                if (errno != 0 || val < 0 || (uintmax_t) val > UINT_MAX || msg_univ->text[0] == '\0' || *endptr != '\0') {
                        log_msg(LOG_LEVEL_ERROR, "[switcher] Cannot switch to device %s. Wrong value.\n", msg_univ->text);
                        free_message(msg, new_response(RESPONSE_BAD_REQUEST, NULL));
                        continue;
                }
                unsigned int new_selected_device = val;
                struct response *r;
 
                if (new_selected_device < s->devices_cnt){
                        MSG(NOTICE,
                            "Switched from device %d to device %d (%s).\n",
                            s->selected_device + 1, new_selected_device + 1,
                            s->device_names[new_selected_device]);
                        if (s->excl_init) {
                                vidcap_done(s->devices[s->selected_device]);
                                s->devices[s->selected_device] = NULL;
                                int ret = initialize_video_capture(&s->mod,
                                                vidcap_params_get_nth((struct vidcap_params *) s->params, new_selected_device + 1),
                                                &s->devices[new_selected_device]);
                                assert(ret == 0);
                        }
 
                        s->selected_device = new_selected_device;
                        r = new_response(RESPONSE_OK, NULL);
                } else {
                        log_msg(LOG_LEVEL_ERROR, "[switcher] Cannot switch to device %u. Device out of bounds (total devices %u).\n",
                                        new_selected_device + 1, s->devices_cnt);
                        r = new_response(RESPONSE_BAD_REQUEST, NULL);
                }
                free_message(msg, r);
        }
 
        frame = vidcap_grab(s->devices[s->selected_device], &audio_frame);
        *audio = audio_frame;
 
        if (frame || !s->fallback) {
                return frame;
        }
        // if frame was not returned but we have a fallback behavior, try also other devices
        for (unsigned int i = (s->selected_device + 1U) % s->devices_cnt;
                        i != s->selected_device;
                        i = (s->selected_device + 1U) % s->devices_cnt) {
                frame = vidcap_grab(s->devices[i], &audio_frame);
                *audio = audio_frame;
                if (frame != NULL) {
                        log_msg(LOG_LEVEL_INFO,
                                MOD_NAME
                                "Frame timed out, using fallback device #%d\n",
                                i);
                        break;
                }
        }
        return frame;
}

References audio, check_message(), vidcap_switcher_state::device_names, vidcap_switcher_state::devices, vidcap_switcher_state::devices_cnt, vidcap_switcher_state::excl_init, vidcap_switcher_state::fallback, frame, free_message(), initialize_video_capture(), LOG_LEVEL_ERROR, LOG_LEVEL_INFO, log_msg(), vidcap_switcher_state::mod, MOD_NAME, MSG, msg, new_response(), vidcap_switcher_state::params, RESPONSE_BAD_REQUEST, RESPONSE_OK, vidcap_switcher_state::selected_device, state, msg_universal::text, val, vidcap_done(), vidcap_grab(), and vidcap_params_get_nth().

Here is the call graph for this function:

vidcap_switcher_init()

static int vidcap_switcher_init ( struct vidcap_params * params, void ** state )

static

Definition at line 180 of file switcher.c.

{
        verbose_msg("vidcap_switcher_init\n");
 
        struct vidcap_switcher_state *s = calloc(1, sizeof *s);
        if (s == NULL) {
                MSG(ERROR, "Unable to allocate switcher capture state\n");
                return VIDCAP_INIT_FAIL;
        }
 
        const char *cfg_c = vidcap_params_get_fmt(params);
        if (cfg_c && strcmp(cfg_c, "") != 0) {
                char     *cfg = strdup(cfg_c);
                const int rc  = parse_fmt(s, cfg);
                free(cfg);
                if (rc != 0) {
                        free(s);
                        return rc;
                }
        }
 
        module_init_default(&s->mod);
        s->mod.cls = MODULE_CLASS_DATA;
        module_register(&s->mod, vidcap_params_get_parent(params));
        s->devices_cnt = 0;
        struct vidcap_params *tmp = params;
        while((tmp = vidcap_params_get_next(tmp))) {
                if (vidcap_params_get_driver(tmp) == NULL) {
                        break;
                }
                s->devices_cnt++;
        }
 
        if (s->selected_device >= s->devices_cnt) {
                MSG(ERROR, "Error: device #%d not available!\n",
                    s->selected_device);
                goto error;
        }
 
        s->devices = calloc(s->devices_cnt, sizeof(struct vidcap *));
        s->device_names = calloc(s->devices_cnt, sizeof s->device_names[0]);
        tmp = params;
        for (unsigned int i = 0; i < s->devices_cnt; ++i) {
                tmp = vidcap_params_get_next(tmp);
 
                if (vidcap_params_get_flags(tmp) == 0 && vidcap_params_get_flags(params) != 0) {
                        vidcap_params_set_flags(tmp, vidcap_params_get_flags(params));
                }
 
                if (!s->excl_init || i == s->selected_device) {
                        int ret = initialize_video_capture(&s->mod, tmp, &s->devices[i]);
                        if(ret != 0) {
                                MSG(ERROR,
                                    "Unable to initialize device %d (%s:%s).\n",
                                    i, vidcap_params_get_driver(tmp),
                                    vidcap_params_get_fmt(tmp));
                                goto error;
                        }
                }
                snprintf(s->device_names[i], sizeof s->device_names[i],
                         "%s%s%s", vidcap_params_get_driver(tmp),
                         strlen(vidcap_params_get_fmt(tmp)) > 0 ? ":" : "",
                         vidcap_params_get_fmt(tmp));
        }
 
        s->params = params;
 
        vidcap_switcher_register_keyboard_ctl(s);
 
        *state = s;
        return VIDCAP_INIT_OK;
 
error:
        vidcap_switcher_done(s);
        return VIDCAP_INIT_FAIL;
}

References module::cls, vidcap_switcher_state::device_names, vidcap_switcher_state::devices, vidcap_switcher_state::devices_cnt, vidcap_switcher_state::excl_init, initialize_video_capture(), vidcap_switcher_state::mod, MODULE_CLASS_DATA, module_init_default(), module_register(), MSG, params, vidcap_switcher_state::params, parse_fmt(), vidcap_switcher_state::selected_device, state, verbose_msg, VIDCAP_INIT_FAIL, VIDCAP_INIT_OK, vidcap_params_get_driver(), vidcap_params_get_flags(), vidcap_params_get_fmt(), vidcap_params_get_next(), vidcap_params_get_parent(), vidcap_params_set_flags(), vidcap_switcher_done(), and vidcap_switcher_register_keyboard_ctl().

Here is the call graph for this function:

vidcap_switcher_probe()

static void vidcap_switcher_probe ( struct device_info ** available_cards, int * count, void(** deleter )(void *) )

static

Definition at line 116 of file switcher.c.

{
        *deleter = free;
        *available_cards = NULL;
        *count = 0;
}

References count, and deleter.

vidcap_switcher_register_keyboard_ctl()

static void vidcap_switcher_register_keyboard_ctl ( struct vidcap_switcher_state * s )

static

Definition at line 123 of file switcher.c.

                                                                                   {
        for (unsigned int i = 0U; i < MIN(s->devices_cnt, 10); ++i) {
                struct msg_universal *m = (struct msg_universal *) new_message(sizeof(struct msg_universal));
                snprintf(m->text, sizeof m->text, "map %d capture.data %d#switch to video input %d", i + 1, i, i + 1);
                struct response *r = send_message_sync(get_root_module(&s->mod), "keycontrol", (struct message *) m, 100,  SEND_MESSAGE_FLAG_QUIET | SEND_MESSAGE_FLAG_NO_STORE);
                if (response_get_status(r) != RESPONSE_OK) {
                        log_msg(LOG_LEVEL_ERROR, "Cannot register keyboard control for video switcher (error %d)!\n", response_get_status(r));
                }
                free_response(r);
        }
}

References vidcap_switcher_state::devices_cnt, free_response(), get_root_module(), LOG_LEVEL_ERROR, log_msg(), msg_universal::m, MIN, vidcap_switcher_state::mod, new_message(), response_get_status(), RESPONSE_OK, SEND_MESSAGE_FLAG_NO_STORE, SEND_MESSAGE_FLAG_QUIET, and send_message_sync().

Referenced by vidcap_switcher_init().

Here is the call graph for this function:

Variable Documentation

vidcap_switcher_info

const struct video_capture_info vidcap_switcher_info

static

Initial value:

= {
        vidcap_switcher_probe,
        vidcap_switcher_init,
        vidcap_switcher_done,
        vidcap_switcher_grab,
        MOD_NAME,
}

Definition at line 346 of file switcher.c.

                                                              {
        vidcap_switcher_probe,
        vidcap_switcher_init,
        vidcap_switcher_done,
        vidcap_switcher_grab,
        MOD_NAME,
};