$UNSTABLE: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
(Added documentation of new $MIDISOUNDFONT metacommand)
m (Revert accidental changes to this page)
Tag: Manual revert
Line 1: Line 1:
The [[$MIDISOUNDFONT]] metacommand enables MIDI support for [[_SNDOPEN]].
The [[$UNSTABLE]] metacommand is used to enable the use of features that have not yet been made a permanent part of the language. Features hidden behind this metacommand may have breaking changes or removed between releases.
 
MIDI functionality is current unstable, and requires [[$UNSTABLE]]:MIDI to be able to use.




{{PageSyntax}}
{{PageSyntax}}
:[[$MIDISOUNDFONT]]: {DEFAULT|"{{Parameter|Filename}}"}
:[[$UNSTABLE]]: {MIDI}




{{Parameters}}
{{Parameters}}
* DEFAULT indicates that the soundfont provided by QB64-PE should be used to play MIDI files.
* The current unstable features are as follows:
** The provided soundfont is about 1MB in size.
** '''MIDI''' allows usage of the [[$MIDISOUNDFONT]] metacommand
* {{Parameter|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.




{{PageDescription}}
{{PageDescription}}
* The use of this metacommand allows [[_SNDOPEN]] to open MIDI files.
* [[$UNSTABLE]] exists as a way to allow usage of new language features before they are finalized as part of the language.
* The selected soundfont is what is used to play all MIDI files.
* Any languages features hidden behind [[$UNSTABLE]] may be changed in breaking ways in the next version of QB64-PE.
* Language features that become a permanent part of the language will no longer require [[$UNSTABLE]] to be used.
* More than one [[$UNSTABLE]] can be used in a program.




Line 33: Line 31:
{{cl|_SNDPLAYFILE}} "example.mid"
{{cl|_SNDPLAYFILE}} "example.mid"
{{CodeEnd}}
{{CodeEnd}}
{{CodeStart}}
{{Cl|$UNSTABLE}}:MIDI
' Using a custom soundfont rather than the default
{{cl|$MIDISOUNDFONT}}: "soundfont.sf2"


{{cl|_SNDPLAYFILE}} "example.mid"
{{CodeEnd}}


{{PageSeeAlso}}
{{PageSeeAlso}}
* [[$UNSTABLE]]
* [[$MIDISOUNDFONT]]
* [[_SNDOPEN]]




{{PageNavigation}}
{{PageNavigation}}

Revision as of 14:54, 11 September 2022

The $UNSTABLE metacommand is used to enable the use of features that have not yet been made a permanent part of the language. Features hidden behind this metacommand may have breaking changes or removed between releases.


Syntax

$UNSTABLE: {MIDI}


Template:Parameters

  • The current unstable features are as follows:


Description

  • $UNSTABLE exists as a way to allow usage of new language features before they are finalized as part of the language.
  • Any languages features hidden behind $UNSTABLE may be changed in breaking ways in the next version of QB64-PE.
  • Language features that become a permanent part of the language will no longer require $UNSTABLE to be used.
  • More than one $UNSTABLE can be used in a program.


Availability

  • QB64-PE v3.2 and up (QB64 Phoenix Edition)


Examples

$UNSTABLE:MIDI

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

_SNDPLAYFILE "example.mid"


See also


Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
Retrieved from "https://qb64phoenix.com/qb64wiki/index.php?title=$UNSTABLE&oldid=3851"