herrie/src/gui_internal.h

   1 /*
   2  * Copyright (c) 2006-2011 Ed Schouten <ed@80386.nl>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  */
  26 /**
  27  * @file gui_internal.h
  28  * @brief Internal textual user interface routines.
  29  */
  30
  31 #include CURSES_HEADER
  32
  33 struct vfsref;
  34 struct vfsmatch;
  35
  36 /**
  37  * @brief Determine whether our terminal is black or white or color.
  38  */
  39 extern int gui_draw_colors;
  40 /**
  41  * @brief Height percentage of the playlist.
  42  */
  43 extern int gui_draw_ratio;
  44 /**
  45  * @brief Refresh the curses GUI after a terminal resize.
  46  */
  47 void gui_draw_resize(void);
  48 /**
  49  * @brief Write all altered data back to the physical terminal.
  50  */
  51 void gui_draw_done(void);
  52 /**
  53  * @brief The mutex that locks the GUI down.
  54  */
  55 extern GMutex *gui_mtx;
  56
  57 /**
  58  * @brief Acquire a lock on the GUI.
  59  */
  60 static inline void
  61 gui_lock(void)
  62 {
  63         g_mutex_lock(gui_mtx);
  64 }
  65
  66 /**
  67  * @brief Release a lock on the GUI.
  68  */
  69 static inline void
  70 gui_unlock(void)
  71 {
  72         g_mutex_unlock(gui_mtx);
  73 }
  74
  75 /* Display size ratios */
  76 /**
  77  * @brief Height of playlist window.
  78  */
  79 #define GUI_SIZE_PLAYQ_HEIGHT           (((LINES * gui_draw_ratio) / 100) - 1)
  80 /**
  81  * @brief Offset of the window containing the filebrowser's directory
  82  *        name.
  83  */
  84 #define GUI_SIZE_BROWSER_DIRNAME_TOP    (GUI_SIZE_PLAYQ_HEIGHT + 1)
  85 /**
  86  * @brief Offset of the filebrowser window.
  87  */
  88 #define GUI_SIZE_BROWSER_TOP            (GUI_SIZE_BROWSER_DIRNAME_TOP + 1)
  89 /**
  90  * @brief Height of the filebrowser window.
  91  */
  92 #define GUI_SIZE_BROWSER_HEIGHT         (LINES - GUI_SIZE_BROWSER_TOP - 1)
  93 /**
  94  * @brief Offset of the message bar window.
  95  */
  96 #define GUI_SIZE_MSGBAR_TOP             (LINES - 1)
  97
  98 /**
  99  * @brief Curses colour code used to draw bars (status, dirname).
 100  */
 101 #define GUI_COLOR_BAR                   2
 102 /**
 103  * @brief Curses colour code used to draw blocks (playlist, browser).
 104  */
 105 #define GUI_COLOR_BLOCK                 3
 106 /**
 107  * @brief Curses colour code used to draw focused selections.
 108  */
 109 #define GUI_COLOR_SELECT                4
 110 /**
 111  * @brief Curses colour code used to draw unfocused selections.
 112  */
 113 #define GUI_COLOR_DESELECT              5
 114 /**
 115  * @brief Curses colour code used to draw marked items (song currenty
 116  *        played).
 117  */
 118 #define GUI_COLOR_MARKED                6
 119
 120 /**
 121  * @brief Display a standard Yes/No question at the bottom of the screen
 122  *        and return the user response.
 123  */
 124 int gui_input_askyesno(const char *question);
 125 /**
 126  * @brief Display a string input question at the bottom of the screen
 127  *        and return the user response.
 128  */
 129 char *gui_input_askstring(const char *question, const char *defstr,
 130     int (*validator)(const char *str, char c));
 131
 132 /*
 133  *  gui_msgbar
 134  */
 135 /**
 136  * @brief Create a bar at the bottom of the terminal displaying
 137  *        messages and questions.
 138  */
 139 void gui_msgbar_init(void);
 140 /**
 141  * @brief Destroy the message bar at the bottom of the screen.
 142  */
 143 void gui_msgbar_destroy(void);
 144 /**
 145  * @brief Set the proper size of the message bar after a terminal
 146  *        resize.
 147  */
 148 void gui_msgbar_resize(void);
 149 /**
 150  * @brief Redraw the message bar after its contents have been altered.
 151  */
 152 void gui_msgbar_refresh(void);
 153 /**
 154  * @brief Flush the text in the message bar.
 155  */
 156 void gui_msgbar_flush(void);
 157 /**
 158  * @brief Show a message in the message bar that will only be
 159  *        overwritten by other messages with this priority. This
 160  *        routine will also unhide the cursor and show it right after
 161  *        the message.
 162  */
 163 void gui_msgbar_ask(const char *msg);
 164
 165 /*
 166  * gui_playq
 167  */
 168 /**
 169  * @brief Initialize the playlist window.
 170  */
 171 void gui_playq_init(void);
 172 /**
 173  * @brief Destroy the playlist window.
 174  */
 175 void gui_playq_destroy(void);
 176 /**
 177  * @brief Redraw the playlist window, because of a terminal resize.
 178  */
 179 void gui_playq_resize(void);
 180
 181 /**
 182  * @brief Move the cursor of the playlist one item up.
 183  */
 184 void gui_playq_cursor_up(void);
 185 /**
 186  * @brief Move the cursor of the playlist one item down.
 187  */
 188 void gui_playq_cursor_down(void);
 189 /**
 190  * @brief Move the cursor and the viewport of the playlist one page up.
 191  */
 192 void gui_playq_cursor_pageup(void);
 193 /**
 194  * @brief Move the cursor and the viewport of the playlist one page down.
 195  */
 196 void gui_playq_cursor_pagedown(void);
 197 /**
 198  * @brief Move the cursor and the viewport of the playlist to the top of
 199  *        the playlist.
 200  */
 201 void gui_playq_cursor_head(void);
 202 /**
 203  * @brief Move the cursor and the viewport of the playlist to the bottom
 204  *        of the playlist.
 205  */
 206 void gui_playq_cursor_tail(void);
 207 /**
 208  * @brief Remove the currently selected song from the playlist.
 209  */
 210 void gui_playq_song_remove(void);
 211 /**
 212  * @brief Remove all songs from the playlist after presenting the user
 213  *        with a question.
 214  */
 215 void gui_playq_song_remove_all(void);
 216 /**
 217  * @brief Randomize all songs in the playlist after presenting the user
 218  *        with a question.
 219  */
 220 void gui_playq_song_randomize(void);
 221
 222 /**
 223  * @brief Add a song before the selected item in the playlist.
 224  */
 225 void gui_playq_song_add_before(struct vfsref *ve);
 226 /**
 227  * @brief Add a song after the selected item in the playlist.
 228  */
 229 void gui_playq_song_add_after(struct vfsref *ve);
 230 /**
 231  * @brief Move the currently selected song one up.
 232  */
 233 void gui_playq_song_move_up(void);
 234 /**
 235  * @brief Move the currently selected song one down.
 236  */
 237 void gui_playq_song_move_down(void);
 238 /**
 239  * @brief Move the currently selected song to the top of the playlist.
 240  */
 241 void gui_playq_song_move_head(void);
 242 /**
 243  * @brief Move the currently selected song to the bottom of the
 244  *        playlist.
 245  */
 246 void gui_playq_song_move_tail(void);
 247 /**
 248  * @brief Start playback on the currently selected song.
 249  */
 250 void gui_playq_song_select(void);
 251 /**
 252  * @brief Search for the next item matching gui_input_cursearch in the
 253  *        playlist.
 254  */
 255 int gui_playq_searchnext(const struct vfsmatch *vm);
 256 /**
 257  * @brief Focus or unfocus the playlist.
 258  */
 259 void gui_playq_setfocus(int focus);
 260 /**
 261  * @brief Write the full pathname of the selected item in the message
 262  *        bar.
 263  */
 264 void gui_playq_fullpath(void);
 265 #ifdef BUILD_VOLUME
 266 /**
 267  * @brief Increment the volume and display the new value.
 268  */
 269 void gui_playq_volume_up(void);
 270 /**
 271  * @brief Decrement the volume and display the new value.
 272  */
 273 void gui_playq_volume_down(void);
 274 #endif /* BUILD_VOLUME */
 275 /**
 276  * @brief Go to the directory containing the selected item.
 277  */
 278 void gui_playq_gotofolder(void);
 279 /**
 280  * @brief Go to the current user's home directory.
 281  */
 282 void gui_browser_gotohome(void);
 283 /**
 284  * @brief Go to the parent directory of the VFS reference and select the
 285  *        item which shares the same filename.
 286  */
 287 void gui_browser_gotofile(struct vfsref *vr);
 288
 289 /*
 290  * gui_browser
 291  */
 292 /**
 293  * @brief Initialize the filebrowser window.
 294  */
 295 void gui_browser_init(void);
 296 /**
 297  * @brief Destroy the filebrowser window.
 298  */
 299 void gui_browser_destroy(void);
 300 /**
 301  * @brief Redraw the filebrowser, because of a terminal resize.
 302  */
 303 void gui_browser_resize(void);
 304
 305 /**
 306  * @brief Move the cursor of the filebrowser one position up.
 307  */
 308 void gui_browser_cursor_up(void);
 309 /**
 310  * @brief Move the cursor of the filebrowser one position down.
 311  */
 312 void gui_browser_cursor_down(void);
 313 /**
 314  * @brief Move the cursor and the viewport of the filebrowser one page
 315  *        up.
 316  */
 317 void gui_browser_cursor_pageup(void);
 318 /**
 319  * @brief Move the cursor and the viewport of the filebrowser one page
 320  *        down.
 321  */
 322 void gui_browser_cursor_pagedown(void);
 323 /**
 324  * @brief Move the cursor and the viewport of the filebrowser to the top
 325  *        of the current directory.
 326  */
 327 void gui_browser_cursor_head(void);
 328 /**
 329  * @brief Move the cursor and the viewport of the filebrowser to the
 330  *        bottom of the current directory.
 331  */
 332 void gui_browser_cursor_tail(void);
 333 /**
 334  * @brief Change the current working directory of the filebrowser to the
 335  *        parent directory.
 336  */
 337 void gui_browser_dir_parent(void);
 338 /**
 339  * @brief Change the current working directory of the filebrowser to the
 340  *        currently selected item.
 341  */
 342 void gui_browser_dir_enter(void);
 343 /**
 344  * @brief Add the current selection to the tail of the playlist.
 345  */
 346 void gui_browser_playq_add_tail(void);
 347 /**
 348  * @brief Add the current selection to the head of the playlist.
 349  */
 350 void gui_browser_playq_add_head(void);
 351 /**
 352  * @brief Add the current selection after the selected item in the
 353  *        playlist.
 354  */
 355 void gui_browser_playq_add_after(void);
 356 /**
 357  * @brief Add the current selection before the selected item in the
 358  *        playlist.
 359  */
 360 void gui_browser_playq_add_before(void);
 361 /**
 362  * @brief Search for the next item matching gui_input_cursearch in the
 363  *        file browser.
 364  */
 365 int gui_browser_searchnext(const struct vfsmatch *vm);
 366 /**
 367  * @brief Change to a directory, filled in by the user.
 368  */
 369 void gui_browser_chdir(void);
 370 /**
 371  * @brief Focus or unfocus the filebrowser.
 372  */
 373 void gui_browser_setfocus(int focus);
 374 /**
 375  * @brief Write the playlist to a file.
 376  */
 377 void gui_browser_write_playlist(void);
 378 /**
 379  * @brief Write the full pathname of the selected item in the message
 380  *        bar.
 381  */
 382 void gui_browser_fullpath(void);
 383 /**
 384  * @brief Apply a recursive search filter on the current directory.
 385  */
 386 int gui_browser_locate(const struct vfsmatch *vm);
 387 /**
 388  * @brief Go to the directory containing the selected item.
 389  */
 390 void gui_browser_gotofolder(void);