WildMidi_SongSeek(3)

✨ WildMidi_SongSeek(3) — the "next song bestie" page ✨

okay so this is a page from the WildMidi Programmer's Manual, and it's all about WildMidi_SongSeek(3) 💖 pull up a chair, we're skipping tracks.

🌸 NAME 🌸

WildMidi_SongSeek — move to the next song. that's it. that's the whole job. 💅

🎀 LIBRARY 🎀

libWildMidi — she lives here 🦋

✨ SYNOPSIS ✨

#include <wildmidi_lib.h>

int WildMidi_SongSeek (midi *handle, int8_t *nextsong);

💖 DESCRIPTION 💖

so the way this works is: it stops and flushes whatever midi is currently playing, and then it starts playing the next song, the previous song, or the same song again — whichever one you picked — from inside a type-2 midi. lowkey iconic behaviour tbh. 🔥

• handle — the identifier you got from opening a midi file with WildMidi_Open(3) or WildMidi_OpenBuffer(3). yes, that handle. the one you already have. 🫶
• nextsong — which way you're going, bestie:
  • -1 → go to the previous song
  • 0 → go back to the beginning of the current song
  • 1 → go to the next song

⚠️ okay important: for type-0 or type-1 midis, only 0 is accepted. don't try to be cute with -1 or 1 there, she will not accept it. 🙈

👑 SEE ALSO 👑

your little reading list, mwah 💜

• 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_GetInfo(3)
• WildMidi_Close(3)
• WildMidi_Shutdown(3)
• wildmidi.cfg(5)

🌈 AUTHOR 🌈

the actual legends behind all this:

• 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.

and that's the whole page, bestie 🫶 this was WildMidi_SongSeek(3) from the WildMidi Programmer's Manual, dated 10 March 2016. slay, go seek some songs. 💅✨🎀