WildMidi_Open(3)

💖 WildMidi_Open — like, the manual page for it 💖

okay bestie, welcome to the WildMidi Programmer's Manual, section 3 — this one's all about WildMidi_Open(3) and honestly it's the door you knock on before anything fun happens. 🚪✨

✨ NAME ✨

WildMidi_Open — open a midi file for processing 🎵

📚 LIBRARY 📚

libWildMidi 🫶

🌸 SYNOPSIS 🌸

#include <wildmidi_lib.h>

midi *WildMidi_Open (const char *midifile)

🦋 DESCRIPTION 🦋

So basically, you hand it a MIDI file — the one midifile points at — and it opens that thing up for processing. Periodt. 💅

And no, it's not picky about every format, but it does need the file to be one of these four, no cap:

• HMP
• HMI
• MIDI
• XMIDI

That's the whole vibe check. If it's one of those, you're in. 🌈

💀 RETURN VALUE 💀

• On error? You get NULL back, and it sends a message to stderr — so like, watch your terminal, bestie, it's telling you something. 😭
• Otherwise you get a handle for the midi file that just got opened. 👑

And that handle is the main character here, fr fr — most functions in libWildMidi use it to figure out which midi file you're talking about. So don't lose it. 🎀

👀 SEE ALSO 👀

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

like, go read them too, they're all part of the same friend group 🫂

👑 AUTHOR 👑

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

absolute icons, we stan 💜

📜 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. slay, choose your own adventure ✨

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. (not me being legally required to yell that 😭)

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

🫶 that's the whole page, bestie. go open some midi files, you got this. 🎶

okay and for the little sign-off moment: this beauty came out of WildMIDI and it's dated 10 March 2016 — yeah, WildMidi_Open(3), 10 March 2016, that's her birthday 🎂✨ bye ily 💖