apps/misc.h

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (C) 2002 by Daniel Stenberg
  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 #ifndef MISC_H
  22 #define MISC_H
  23
  24 #include <stdbool.h>
  25 #include <inttypes.h>
  26 #include "config.h"
  27 #include "system.h"
  28
  29 /* Format a large-range value for output, using the appropriate unit so that
  30  * the displayed value is in the range 1 <= display < 1000 (1024 for "binary"
  31  * units) if possible, and 3 significant digits are shown. If a buffer is
  32  * given, the result is snprintf()'d into that buffer, otherwise the result is
  33  * voiced.*/
  34 char *output_dyn_value(char *buf, int buf_size, int value,
  35                       const unsigned char **units, bool bin_scale);
  36
  37 /* Format time into buf.
  38  *
  39  * buf      - buffer to format to.
  40  * buf_size - size of buffer.
  41  * t        - time to format, in milliseconds.
  42  */
  43 void format_time(char* buf, int buf_size, long t);
  44
  45 /* Ask the user if they really want to erase the current dynamic playlist
  46  * returns true if the playlist should be replaced */
  47 bool warn_on_pl_erase(void);
  48
  49 /* Read (up to) a line of text from fd into buffer and return number of bytes
  50  * read (which may be larger than the number of bytes stored in buffer). If
  51  * an error occurs, -1 is returned (and buffer contains whatever could be
  52  * read). A line is terminated by a LF char. Neither LF nor CR chars are
  53  * stored in buffer.
  54  */
  55 int read_line(int fd, char* buffer, int buffer_size);
  56 int fast_readline(int fd, char *buf, int buf_size, void *parameters,
  57                   int (*callback)(int n, const char *buf, void *parameters));
  58
  59 bool settings_parseline(char* line, char** name, char** value);
  60 long default_event_handler_ex(long event, void (*callback)(void *), void *parameter);
  61 long default_event_handler(long event);
  62 bool list_stop_handler(void);
  63 void car_adapter_mode_init(void);
  64 extern int show_logo(void);
  65
  66 #if CONFIG_CODEC == SWCODEC
  67 /* Return current ReplayGain mode a file should have (REPLAYGAIN_TRACK or
  68  * REPLAYGAIN_ALBUM) if ReplayGain processing is enabled, or -1 if no
  69  * information present.
  70  */
  71 int get_replaygain_mode(bool have_track_gain, bool have_album_gain);
  72 #endif
  73
  74 int open_utf8(const char* pathname, int flags);
  75
  76 #ifdef BOOTFILE
  77 #if !defined(USB_NONE) && !defined(USB_HANDLED_BY_OF)
  78 void check_bootfile(bool do_rolo);
  79 #endif
  80 #endif
  81
  82 /* check range, set volume and save settings */
  83 void setvol(void);
  84
  85 #ifdef HAVE_LCD_COLOR
  86 int hex_to_rgb(const char* hex, int* color);
  87 #endif
  88
  89 char* strrsplt(char* str, int c);
  90 char* skip_whitespace(char* const str);
  91 bool file_exists(const char *file);
  92 bool dir_exists(const char *path);
  93
  94 /*
  95  * removes the extension of filename (if it doesn't start with a .)
  96  * puts the result in buffer
  97  */
  98 char *strip_extension(char* buffer, int buffer_size, const char *filename);
  99
 100 /* A simplified scanf */
 101 /*
 102  * Checks whether the value at position 'position' was really read
 103  * during a call to 'parse_list'
 104  *   - position: 0-based number of the value
 105  *   - valid_vals: value after the call to 'parse_list'
 106  */
 107 #define LIST_VALUE_PARSED(setvals, position) ((setvals) & BIT_N(position))
 108 const char* parse_list(const char *fmt, uint32_t *set_vals,
 109                        const char sep, const char* str, ...);
 110
 111 #endif /* MISC_H */