/* libquvi

 * Copyright (C) 2012  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_choose_best.c */

#include "config.h"

#include <glib.h>

#include "quvi.h"

/* -- */

#include "_quvi_s.h"

#include "_quvi_media_s.h"

/** @brief Selects the @ref m_stream that was determined to be of the "best quality"

@note

  - Only useful when there are >1 media streams available, otherwise the

    function falls back to the first available @ref m_stream (the

    default)

  - The @ref m_script determines the best quality @ref m_stream

@sa @ref parse_media

@ingroup mediaprop

*/

void quvi_media_stream_choose_best(quvi_media_t handle)

{

  _quvi_media_stream_t qms;

  _quvi_media_t qm;

  qm = (_quvi_media_t) handle;

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

  g_return_if_fail(handle != NULL);

  quvi_media_stream_reset(qm);

  while (quvi_media_stream_next(qm) == QUVI_TRUE)

    {

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

      g_assert(qms != NULL);

      if (qms->flags.best == TRUE)

        break;

    }

  /*

   * If nothing was flagged as such, let it fall through.

   * Use whatever is the first.

   */

}

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