NAME

       WildMidi_GetInfo - get information on a midi

LIBRARY

       libWildMidi

SYNOPSIS

       #include <wildmidi_lib.h>

       struct _WM_Info *WildMidi_GetInfo (midi *handle);

DESCRIPTION

       Obtains  information  allowing  you  to  determine song position, current options, and any
       copyright information.

       handle The  identifier  obtained  from  opening  a  midi  file  with  WildMidi_Open(3)  or
              WildMidi_OpenBuffer(3)

RETURN VALUE

       On error returns NULL with an error message displayed to stderr.

       Otherwise returns a pointer to a struct containing the information.

       struct _WM_Info {
          char *copyright;
          uint32_t current_sample;
          uint32_t approx_total_samples;
          uint32_t total_midi_time;
          uint16_t mixer_options;
          uint32_t total_midi_time;
       };

       copyright
              A  pointer  to  a  \0  terminated string containing any copyright MIDI events found
              while processing the MIDI file handle refers to. If more than one  copyright  event
              was found then each one is separated by \n

       If copyright is NULL then no copyright MIDI events were found.

       current_sample
              This  is  the  number of stereo samples libWildMidi has processed for the MIDI file
              referred to by handle. You can use this value to determine the current playing time
              by  dividing  this  value  by  the  rate  given when libWildMidi was initialized by
              WildMidi_Init(3).

       approx_total_samples
              This is the total number of stereo samples libWildMidi expects to process. This can
              be  used  to obtain the total playing time by dividing this value by the rate given
              when  libWildMidi  was  initialized  by  WildMidi_Init(3).  Also  when  you  divide
              current_sample  by  this  value  and  multiplying  by  100, you have the percentage
              currently processed.

       total_midi_time
              This is the total time of MIDI events in 1/1000's of  a  second.  It  differs  from
              approx_total_samples in that it only states the total time within the MIDI file and
              does not take into account the  extra  bit  of  time  to  finish  playing  sampling
              smoothly.

       mixer_options

              WM_MO_LOG_VOLUME
                     Using curved volume settings instead of linear ones.

              WM_MO_ENHANCED_RESAMPLING
                     The enhanced resampler is active

              WM_MO_REVERB
                     Reverb is being added to the final output.

SEE ALSO

       WildMidi_GetVersion(3),   WildMidi_Init(3),   WildMidi_MasterVolume(3),  WildMidi_Open(3),
       WildMidi_OpenBuffer(3),           WildMidi_SetOption(3),            WildMidi_GetOutput(3),
       WildMidi_GetMidiOutput(3),  WildMidi_FastSeek(3), WildMidi_Close(3), WildMidi_Shutdown(3),
       wildmidi.cfg(5)

AUTHOR

       Chris Ison <chrisisonwildcode@gmail.com> Bret Curtis <psi29a@gmail.com>

COPYRIGHT

       Copyright (C) WildMidi Developers 2001-2016

       This file is part of WildMIDI.

       WildMIDI is free software: you can redistribute and/or modify the player under  the  terms
       of the GNU General Public License and you can redistribute and/or modify the library under
       the terms of the GNU Lesser General Public License  as  published  by  the  Free  Software
       Foundation, either version 3 of the licenses, or(at your option) any later version.

       WildMIDI  is  distributed  in  the  hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.
       See  the  GNU  General  Public  License and the GNU Lesser General Public License for more
       details.

       You should have received a copy of the GNU General  Public  License  and  the  GNU  Lesser
       General Public License along with WildMIDI. If not, see <http://www.gnu.org/licenses/>.

       This  manpage  is licensed under the Creative Commons Attribution-Share Alike 3.0 Unported
       License. To view a copy of  this  license,  visit  http://creativecommons.org/licenses/by-
       sa/3.0/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco,
       California, 94105, USA.

                                          10 March 2016                       WildMidi_GetInfo(3)