$MIDISOUNDFONT: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
(Add note about $MIDISOUNDFONT metacommand deprecation.)
No edit summary
Line 18: Line 18:
* The use of this metacommand allows [[_SNDOPEN]] to open MIDI files.
* The use of this metacommand allows [[_SNDOPEN]] to open MIDI files.
* The selected soundfont is what is used to play all MIDI files.
* The selected soundfont is what is used to play all MIDI files.
* '''$MIDISOUNDFONT''' metacommand was deprecated in '''QB64-PE v3.14.0'''. Use [[_MIDISOUNDBANK]] instead.




Line 32: Line 31:
</gallery>
</gallery>
<!-- additional availability notes go below here -->
<!-- additional availability notes go below here -->
* '''$MIDISOUNDFONT''' was {{Text|deprecated|red}} in '''QB64-PE v3.14.0'''. Use [[_MIDISOUNDBANK]] instead.





Revision as of 13:52, 23 July 2024

The $MIDISOUNDFONT metacommand enables MIDI support for _SNDOPEN.

MIDI functionality is current unstable, and requires $UNSTABLE:MIDI to be able to use.


Syntax

$MIDISOUNDFONT: {DEFAULT|"Filename"}


Parameters

  • DEFAULT indicates that the soundfont provided by QB64-PE should be used to play MIDI files.
    • The provided soundfont is about 1MB in size.
  • Filename can be used to provide your own soundfont for playing MIDI files.
    • The specified soundfont file is compiled into your program and is not required at runtime.


Description

  • The use of this metacommand allows _SNDOPEN to open MIDI files.
  • The selected soundfont is what is used to play all MIDI files.


Availability

  • $MIDISOUNDFONT was deprecated in QB64-PE v3.14.0. Use _MIDISOUNDBANK instead.


Examples

$UNSTABLE:MIDI

' This line is only allowed when $UNSTABLE:MIDI is used
$MIDISOUNDFONT: Default

_SNDPLAYFILE "example.mid"
$UNSTABLE:MIDI

' Using a custom soundfont rather than the default
$MIDISOUNDFONT: "soundfont.sf2"

_SNDPLAYFILE "example.mid"


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link