src/api/media_stream_choose_best.c

   1 /* libquvi
   2  * Copyright (C) 2012  Toni Gundogdu <legatvs@gmail.com>
   3  *
   4  * This file is part of libquvi <http://quvi.sourceforge.net/>.
   5  *
   6  * This library is free software: you can redistribute it and/or
   7  * modify it under the terms of the GNU Affero General Public
   8  * License as published by the Free Software Foundation, either
   9  * version 3 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU Affero General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Affero General
  17  * Public License along with this library.  If not, see
  18  * <http://www.gnu.org/licenses/>.
  19  */
  20
  21 /** @file media_stream_choose_best.c */
  22
  23 #include "config.h"
  24
  25 #include <glib.h>
  26
  27 #include "quvi.h"
  28 /* -- */
  29 #include "_quvi_s.h"
  30 #include "_quvi_media_s.h"
  31
  32 /** @brief Selects the @ref m_stream that was determined to be of the "best quality"
  33 @note
  34   - Only useful when there are >1 media streams available, otherwise the
  35     function falls back to the first available @ref m_stream (the
  36     default)
  37   - The @ref m_script determines the best quality @ref m_stream
  38 @sa @ref parse_media
  39 @ingroup mediaprop
  40 */
  41 void quvi_media_stream_choose_best(quvi_media_t handle)
  42 {
  43   _quvi_media_stream_t qms;
  44   _quvi_media_t qm;
  45
  46   qm = (_quvi_media_t) handle;
  47
  48   /* If G_DISABLE_CHECKS is defined then the check is not performed. */
  49   g_return_if_fail(handle != NULL);
  50
  51   quvi_media_stream_reset(qm);
  52
  53   while (quvi_media_stream_next(qm) == QUVI_TRUE)
  54     {
  55       qms = (_quvi_media_stream_t) qm->curr.stream->data;
  56       g_assert(qms != NULL);
  57
  58       if (qms->flags.best == TRUE)
  59         break;
  60     }
  61
  62   /*
  63    * If nothing was flagged as such, let it fall through.
  64    * Use whatever is the first.
  65    */
  66 }
  67
  68 /* vim: set ts=2 sw=2 tw=72 expandtab: */