BASS.NET API for the Un4seen BASS Audio Library

BassMidiBASS_MIDI_FontFlags Method

BASS.NET API for the Un4seen BASS Audio Library
Modifies and retrieves a soundfont's flags.

Namespace:  Un4seen.Bass.AddOn.Midi
Assembly:  Bass.Net (in Bass.Net.dll) Version: 2.4.17.5
Syntax

[DllImportAttribute("bassmidi", CharSet = CharSet.Unicode)]
public static int BASS_MIDI_FontFlags(
	int handle,
	BASSFlag flags,
	BASSFlag mask
)

Parameters

handle
Type: SystemInt32
The soundfont handle.
flags
Type: Un4seen.BassBASSFlag
A combination of these flags:
BASS_MIDI_FONT_LINATTMODUse a linear attack phase in SF2 modulation (pitch/filter) envelopes. Otherwise a convex curve is used. The attack phase is always linear in SFZ envelopes.
BASS_MIDI_FONT_LINDECVOLUse linear decay and release phases in volume envelopes. Otherwise a concave curve is used. The attack phase is always linear.
BASS_MIDI_FONT_MINFXTreat the reverb/chorus levels in the soundfont as minimums. The higher of them and the MIDI levels (CC91/93) will be used instead of the sum of both.
BASS_MIDI_FONT_MMAPThe file is mapped into memory. This cannot be modified.
BASS_MIDI_FONT_NOFXIgnore the reverb/chorus levels in the soundfont and only use the MIDI levels (CC91/93).
BASS_MIDI_FONT_NOLIMITSDo not limit SF2 generator values to emulate Creative/SoundBlaster hardware. This cannot be modified.
BASS_MIDI_FONT_NORAMPINNever ramp-in the start of a sample in the soundfont. Otherwise a sample will be ramped-in if its data does not begin with a 0 (further away results in a longer ramp). This is only relevant when the volume envelope has no attack phase.
BASS_MIDI_FONT_XGDRUMSUse bank 127 in the soundfont for XG drum kits. When an XG drum kit is needed, bank 127 in soundfonts that have this flag set will be checked first, before falling back to bank 128 (the standard SF2 drum kit bank) if it is not available there.
mask
Type: Un4seen.BassBASSFlag
The flags (as above) to modify. Flags that are not included in this are left as they are, so it can be set to 0 in order to just retrieve the current flags

Return Value

Type: Int32
If successful, is returned, else is returned. Use BASS_ErrorGetCode to get the error code.
Remarks

A soundfont will need to be freed (including any duplicates) and reloaded to modify the BASS_MIDI_FONT_NOLIMITS flag because most of the Creative/SoundBlaster hardware limits are applied when loading a soundfont.

ERROR CODEDescription
BASS_ERROR_HANDLEhandle is not valid.

See Also

Reference