player.h

   1 /*
   2  * Copyright 2004 Timo Hirvonen
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU General Public License as
   6  * published by the Free Software Foundation; either version 2 of the
   7  * License, or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program; if not, write to the Free Software
  16  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  17  * 02111-1307, USA.
  18  */
  19
  20 #ifndef _PLAYER_H
  21 #define _PLAYER_H
  22
  23 #include "locking.h"
  24 #include "comment.h"
  25 #include "track_info.h"
  26
  27 #include <pthread.h>
  28
  29 enum {
  30         /* no error */
  31         PLAYER_ERROR_SUCCESS,
  32         /* system error (error code in errno) */
  33         PLAYER_ERROR_ERRNO,
  34         /* function not supported */
  35         PLAYER_ERROR_NOT_SUPPORTED
  36 };
  37
  38 enum player_status {
  39         PLAYER_STATUS_STOPPED,
  40         PLAYER_STATUS_PLAYING,
  41         PLAYER_STATUS_PAUSED
  42 };
  43
  44 struct player_callbacks {
  45         int (*get_next)(struct track_info **ti);
  46 };
  47
  48 struct player_info {
  49         pthread_mutex_t mutex;
  50
  51         /* current track */
  52         struct track_info *ti;
  53
  54         /* stream metadata */
  55         char metadata[255 * 16 + 1];
  56
  57         /* status */
  58         enum player_status status;
  59         int pos;
  60
  61         /* volume */
  62         int vol_left;
  63         int vol_right;
  64
  65         int buffer_fill;
  66         int buffer_size;
  67
  68         /* display this if not NULL */
  69         char *error_msg;
  70
  71         unsigned int file_changed : 1;
  72         unsigned int metadata_changed : 1;
  73         unsigned int status_changed : 1;
  74         unsigned int position_changed : 1;
  75         unsigned int buffer_fill_changed : 1;
  76         unsigned int vol_changed : 1;
  77 };
  78
  79 extern struct player_info player_info;
  80 extern int player_cont;
  81
  82 /* defined in output.c */
  83 extern int volume_max;
  84
  85 void player_load_plugins(void);
  86
  87 void player_init(const struct player_callbacks *callbacks);
  88 void player_exit(void);
  89
  90 /* set current file */
  91 void player_set_file(struct track_info *ti);
  92
  93 /* set current file and start playing */
  94 void player_play_file(struct track_info *ti);
  95
  96 void player_play(void);
  97 void player_stop(void);
  98 void player_pause(void);
  99 void player_seek(double offset, int relative);
 100 void player_set_op(const char *name);
 101 char *player_get_op(void);
 102 void player_set_buffer_chunks(unsigned int nr_chunks);
 103 int player_get_buffer_chunks(void);
 104 void player_set_buffer_seconds(unsigned int seconds);
 105 int player_get_fileinfo(const char *filename, int *duration, struct keyval **comments);
 106
 107 int player_get_volume(int *left, int *right);
 108 int player_set_volume(int left, int right);
 109 void player_set_soft_vol(int soft);
 110
 111 int player_set_op_option(unsigned int id, const char *val);
 112 int player_get_op_option(unsigned int id, char **val);
 113 int player_for_each_op_option(void (*callback)(unsigned int id, const char *key));
 114 void player_dump_plugins(void);
 115
 116 #define player_info_lock() cmus_mutex_lock(&player_info.mutex)
 117 #define player_info_unlock() cmus_mutex_unlock(&player_info.mutex)
 118
 119 #endif