log.h
上传用户:tjmskj2
上传日期:2020-08-17
资源大小:577k
文件大小:3k
源码类别:

midi

开发平台:

C/C++

  1. /* FluidSynth - A Software Synthesizer
  2.  *
  3.  * Copyright (C) 2003  Peter Hanappe and others.
  4.  *
  5.  * This library is free software; you can redistribute it and/or
  6.  * modify it under the terms of the GNU Library General Public License
  7.  * as published by the Free Software Foundation; either version 2 of
  8.  * the License, or (at your option) any later version.
  9.  *
  10.  * This library is distributed in the hope that it will be useful, but
  11.  * WITHOUT ANY WARRANTY; without even the implied warranty of
  12.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13.  * Library General Public License for more details.
  14.  *  
  15.  * You should have received a copy of the GNU Library General Public
  16.  * License along with this library; if not, write to the Free
  17.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  18.  * 02111-1307, USA
  19.  */
  20. #ifndef _FLUIDSYNTH_LOG_H
  21. #define _FLUIDSYNTH_LOG_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /**
  26.  * @file log.h
  27.  * @brief Logging interface
  28.  *
  29.  * The default logging function of the fluidsynth prints its messages
  30.  * to the stderr. The synthesizer uses five level of messages: #FLUID_PANIC,
  31.  * #FLUID_ERR, #FLUID_WARN, #FLUID_INFO, and #FLUID_DBG.
  32.  *
  33.  * A client application can install a new log function to handle the
  34.  * messages differently. In the following example, the application
  35.  * sets a callback function to display #FLUID_PANIC messages in a dialog,
  36.  * and ignores all other messages by setting the log function to
  37.  * NULL:
  38.  *
  39.  * @code
  40.  *   fluid_set_log_function(FLUID_PANIC, show_dialog, (void*) root_window);
  41.  *   fluid_set_log_function(FLUID_ERR, NULL, NULL);
  42.  *   fluid_set_log_function(FLUID_WARN, NULL, NULL);
  43.  *   fluid_set_log_function(FLUID_DBG, NULL, NULL);
  44.  * @endcode
  45.  */
  46. /**
  47.  * FluidSynth log levels.
  48.  */
  49. enum fluid_log_level { 
  50.   FLUID_PANIC,   /**< The synth can't function correctly any more */
  51.   FLUID_ERR,     /**< Serious error occurred */
  52.   FLUID_WARN,    /**< Warning */
  53.   FLUID_INFO,    /**< Verbose informational messages */
  54.   FLUID_DBG,     /**< Debugging messages */
  55.   LAST_LOG_LEVEL
  56. };
  57. /**
  58.  * Log function handler callback type used by fluid_set_log_function().
  59.  * @param level Log level (#fluid_log_level)
  60.  * @param message Log message text
  61.  * @param data User data pointer supplied to fluid_set_log_function().
  62.  */
  63. typedef void (*fluid_log_function_t)(int level, char* message, void* data);
  64. FLUIDSYNTH_API 
  65. fluid_log_function_t fluid_set_log_function(int level, fluid_log_function_t fun, void* data);
  66. FLUIDSYNTH_API void fluid_default_log_function(int level, char* message, void* data);
  67. FLUIDSYNTH_API int fluid_log(int level, const char *fmt, ...);
  68. #ifdef __cplusplus
  69. }
  70. #endif
  71. #endif /* _FLUIDSYNTH_LOG_H */