apps/playback.h

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (C) 2005 Miika Pekkarinen
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  18  * KIND, either express or implied.
  19  *
  20  ****************************************************************************/
  21
  22 #ifndef _PLAYBACK_H
  23 #define _PLAYBACK_H
  24
  25 #include <stdbool.h>
  26 #include <stdlib.h>
  27 #include "config.h"
  28
  29 #if CONFIG_CODEC == SWCODEC
  30 /* Including the code for fast previews is entirely optional since it
  31    does add two more mp3entry's - for certain targets it may be less
  32    beneficial such as flash-only storage */
  33 #if MEMORYSIZE > 2
  34 #define AUDIO_FAST_SKIP_PREVIEW
  35 #endif
  36
  37 #endif /* CONFIG_CODEC == SWCODEC */
  38
  39 #ifdef HAVE_ALBUMART
  40
  41 #include "bmp.h"
  42 #include "metadata.h"
  43 /*
  44  * Returns the handle id of the buffered albumart for the given slot id
  45  **/
  46 int playback_current_aa_hid(int slot);
  47
  48 /*
  49  * Hands out an albumart slot for buffering albumart using the size
  50  * int the passed dim struct, it copies the data of dim in order to
  51  * be safe to be reused for other code
  52  *
  53  * The slot may be reused if other code calls this with the same dimensions
  54  * in dim, so if you change dim release and claim a new slot
  55  *
  56  * Save to call from other threads */
  57 int playback_claim_aa_slot(struct dim *dim);
  58
  59 /*
  60  * Releases the albumart slot with given id
  61  *
  62  * Save to call from other threads */
  63 void playback_release_aa_slot(int slot);
  64
  65 struct bufopen_bitmap_data {
  66     struct dim *dim;
  67     struct mp3_albumart *embedded_albumart;
  68 };
  69
  70 #endif
  71
  72 /* Functions */
  73 int audio_track_count(void);
  74 long audio_filebufused(void);
  75 void audio_pre_ff_rewind(void);
  76 void audio_skip(int direction);
  77
  78 void audio_set_cuesheet(int enable);
  79 #ifdef HAVE_CROSSFADE
  80 void audio_set_crossfade(int enable);
  81 #endif
  82
  83 enum
  84 {
  85     AUDIO_WANT_PLAYBACK = 0,
  86     AUDIO_WANT_VOICE,
  87 };
  88 bool audio_restore_playback(int type); /* Restores the audio buffer to handle the requested playback */
  89 size_t audio_get_filebuflen(void);
  90
  91 /* Automatic transition? Only valid to call during the track change events,
  92    otherwise the result is undefined. */
  93 bool audio_automatic_skip(void);
  94
  95 /* Define one constant that includes recording related functionality */
  96 #if defined(HAVE_RECORDING) && !defined(SIMULATOR)
  97 #define AUDIO_HAVE_RECORDING
  98 #endif
  99
 100 enum {
 101     Q_NULL = 0,                 /* reserved */
 102
 103     /* -> audio */
 104     Q_AUDIO_PLAY = 1,
 105     Q_AUDIO_STOP,
 106     Q_AUDIO_PAUSE,
 107     Q_AUDIO_SKIP,
 108     Q_AUDIO_PRE_FF_REWIND,
 109     Q_AUDIO_FF_REWIND,
 110     Q_AUDIO_FLUSH,
 111     Q_AUDIO_DIR_SKIP,
 112
 113     /* pcmbuf -> audio */
 114     Q_AUDIO_TRACK_CHANGED,
 115
 116     /* audio -> audio */
 117     Q_AUDIO_FILL_BUFFER,        /* continue buffering next track */
 118
 119     /* buffering -> audio */
 120     Q_AUDIO_BUFFERING,          /* some buffer event */
 121     Q_AUDIO_FINISH_LOAD_TRACK,  /* metadata is buffered */
 122     Q_AUDIO_HANDLE_FINISHED,    /* some other type is buffered */
 123
 124     /* codec -> audio (*) */
 125     Q_AUDIO_CODEC_SEEK_COMPLETE,
 126     Q_AUDIO_CODEC_COMPLETE,
 127
 128     /* audio -> codec */
 129     Q_CODEC_LOAD,
 130     Q_CODEC_RUN,
 131     Q_CODEC_PAUSE,
 132     Q_CODEC_SEEK,
 133     Q_CODEC_STOP,
 134     Q_CODEC_UNLOAD,
 135
 136
 137     /*- miscellanous -*/
 138 #ifdef AUDIO_HAVE_RECORDING
 139     /* -> codec */
 140     Q_AUDIO_LOAD_ENCODER,       /* load an encoder for recording */
 141 #endif
 142     /* -> codec */
 143     Q_CODEC_DO_CALLBACK,
 144
 145
 146     /*- settings -*/
 147
 148 #ifdef HAVE_DISK_STORAGE
 149     /* -> audio */
 150     Q_AUDIO_UPDATE_WATERMARK,   /* buffering watermark needs updating */
 151 #endif
 152     /* -> audio */
 153     Q_AUDIO_REMAKE_AUDIO_BUFFER, /* buffer needs to be reinitialized */
 154 };
 155
 156 /* (*) If you change these, you must check audio_clear_track_notifications
 157        in playback.c for correctness */
 158
 159 #endif /* _PLAYBACK_H */