/* libquvi

 * Copyright (C) 2012-2013  Toni Gundogdu <legatvs@gmail.com>

 *

 * This file is part of libquvi <http://quvi.sourceforge.net/>.

 *

 * This library is free software: you can redistribute it and/or

 * modify it under the terms of the GNU Affero General Public

 * License as published by the Free Software Foundation, either

 * version 3 of the License, or (at your option) any later version.

 *

 * This library 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 Affero General Public License for more details.

 *

 * You should have received a copy of the GNU Affero General

 * Public License along with this library.  If not, see

 * <http://www.gnu.org/licenses/>.

 */

/** @file media_stream_select.c */

#include "config.h"

#include <glib/gi18n-lib.h>

#include <glib.h>

#include "quvi.h"

/* -- */

#include "_quvi_s.h"

#include "_quvi_media_s.h"

/* -- */

#include "misc/re.h"

static QuviError _select(_quvi_media_t qm, const gchar *id)

{

  _quvi_media_stream_t qms;

  gboolean found_flag;

  QuviError rc;

  gchar **r;

  gint i;

  quvi_media_stream_reset(qm);

  r = g_strsplit(id, ",", 0);

  found_flag = FALSE;

  rc = QUVI_OK;

  for (i=0; (r[i] != NULL && found_flag == FALSE); ++i)

    {

      if (g_strcmp0(r[i], "croak") ==0)

        {

          rc = QUVI_ERROR_KEYWORD_CROAK;

          break;

        }

      else if (g_strcmp0(r[i], "best") == 0)

        {

          quvi_media_stream_choose_best(qm);

          break;

        }

      else

        {

          while (quvi_media_stream_next(qm) == QUVI_TRUE)

            {

              /* TODO: Use quvi_media_get? */

              qms = (_quvi_media_stream_t) qm->curr.stream->data;

              found_flag = m_match(qms->id->str, r[i]);

              if (found_flag == TRUE)

                break;

            }

          if (found_flag == FALSE) /* Use the first stream as a fallback. */

            quvi_media_stream_reset(qm);

        }

    }

  g_strfreev(r);

  return (rc);

}

/** @brief Select a @ref m_stream matching a @ref m_stream_id

Matches the @ref m_stream_id (pattern) to the available media stream

IDs and selects the stream. This function returns immediately

if a matching ID was found.  The ID value may be a comma-separated value

(e.g. "foo,bar,baz"). The ID may also contain the keywords 'croak' and

'best' (see the notes below).

@note

  - ID value is used as regular expression pattern

  - ID may contain the reserved keyword 'best'

    - Defining this in the ID is identical to calling

      @ref quvi_media_stream_choose_best, refer to it for details

  - ID may contain the reserved keyword 'croak'

    - This will cause the function to exit immediately when it is reached

    - The result may be checked with @ref quvi_ok

      - The code may be retrieved using @ref quvi_get

      - The error message may be retrieved using @ref quvi_errmsg

  - If nothing matched (and the 'croak' keyword was specified) the

    function will return the first (default) available language

  - Always confirm the result with @ref quvi_ok

@sa @ref parse_media

@ingroup mediaprop

*/

void quvi_media_stream_select(quvi_media_t handle, const char *id)

{

  _quvi_media_t qm;

  _quvi_t q;

  /* If G_DISABLE_CHECKS is defined then the check is not performed. */

  g_return_if_fail(handle != NULL);

  qm = (_quvi_media_t) handle;

  q = qm->handle.quvi;

  q->status.rc = _select(qm, id);

}

/* vim: set ts=2 sw=2 tw=72 expandtab: */