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 bool audio_is_thread_ready(void);
  74 int audio_track_count(void);
  75 long audio_filebufused(void);
  76 void audio_pre_ff_rewind(void);
  77 void audio_skip(int direction);
  78
  79 void audio_set_cuesheet(int enable);
  80 #ifdef HAVE_CROSSFADE
  81 void audio_set_crossfade(int enable);
  82 #endif
  83
  84 enum
  85 {
  86     AUDIO_WANT_PLAYBACK = 0,
  87     AUDIO_WANT_VOICE,
  88 };
  89 bool audio_restore_playback(int type); /* Restores the audio buffer to handle the requested playback */
  90 size_t audio_get_filebuflen(void);
  91 bool audio_buffer_state_trashed(void);
  92
  93 /* Automatic transition? Only valid to call during the track change events,
  94    otherwise the result is undefined. */
  95 bool audio_automatic_skip(void);
  96
  97 /* Define one constant that includes recording related functionality */
  98 #if defined(HAVE_RECORDING) && !defined(SIMULATOR)
  99 #define AUDIO_HAVE_RECORDING
 100 #endif
 101
 102 enum {
 103     Q_NULL = 0,                 /* reserved */
 104
 105     /* -> audio */
 106     Q_AUDIO_PLAY = 1,
 107     Q_AUDIO_STOP,
 108     Q_AUDIO_PAUSE,
 109     Q_AUDIO_SKIP,
 110     Q_AUDIO_PRE_FF_REWIND,
 111     Q_AUDIO_FF_REWIND,
 112     Q_AUDIO_FLUSH,
 113     Q_AUDIO_DIR_SKIP,
 114
 115     /* pcmbuf -> audio */
 116     Q_AUDIO_TRACK_CHANGED,
 117
 118     /* audio -> audio */
 119     Q_AUDIO_FILL_BUFFER,        /* continue buffering next track */
 120
 121     /* buffering -> audio */
 122     Q_AUDIO_BUFFERING,          /* some buffer event */
 123     Q_AUDIO_FINISH_LOAD_TRACK,  /* metadata is buffered */
 124     Q_AUDIO_HANDLE_FINISHED,    /* some other type is buffered */
 125
 126     /* codec -> audio (*) */
 127     Q_AUDIO_CODEC_SEEK_COMPLETE,
 128     Q_AUDIO_CODEC_COMPLETE,
 129
 130     /* audio -> codec */
 131     Q_CODEC_LOAD,
 132     Q_CODEC_RUN,
 133     Q_CODEC_PAUSE,
 134     Q_CODEC_SEEK,
 135     Q_CODEC_STOP,
 136     Q_CODEC_UNLOAD,
 137
 138
 139     /*- miscellanous -*/
 140 #ifdef AUDIO_HAVE_RECORDING
 141     /* -> codec */
 142     Q_AUDIO_LOAD_ENCODER,       /* load an encoder for recording */
 143 #endif
 144     /* -> codec */
 145     Q_CODEC_DO_CALLBACK,
 146
 147
 148     /*- settings -*/
 149
 150 #ifdef HAVE_DISK_STORAGE
 151     /* -> audio */
 152     Q_AUDIO_UPDATE_WATERMARK,   /* buffering watermark needs updating */
 153 #endif
 154     /* -> audio */
 155     Q_AUDIO_REMAKE_AUDIO_BUFFER, /* buffer needs to be reinitialized */
 156 };
 157
 158 /* (*) If you change these, you must check audio_clear_track_notifications
 159        in playback.c for correctness */
 160
 161 #endif /* _PLAYBACK_H */