InputEventMIDI

Inherits: InputEvent < Resource < RefCounted < Object

Input event for MIDI inputs.

Description

InputEventMIDI allows receiving input events from MIDI devices such as a piano. MIDI stands for Musical Instrument Digital Interface.

MIDI signals can be sent over a 5-pin MIDI connector or over USB, if your device supports both be sure to check the settings in the device to see which output it's using.

To receive input events from MIDI devices, you need to call OS.open_midi_inputs. You can check which devices are detected using OS.get_connected_midi_inputs.

func _ready():
    OS.open_midi_inputs()
    print(OS.get_connected_midi_inputs())

func _input(input_event):
    if input_event is InputEventMIDI:
        _print_midi_info(input_event)

func _print_midi_info(midi_event: InputEventMIDI):
    print(midi_event)
    print("Channel " + str(midi_event.channel))
    print("Message " + str(midi_event.message))
    print("Pitch " + str(midi_event.pitch))
    print("Velocity " + str(midi_event.velocity))
    print("Instrument " + str(midi_event.instrument))
    print("Pressure " + str(midi_event.pressure))
    print("Controller number: " + str(midi_event.controller_number))
    print("Controller value: " + str(midi_event.controller_value))

Note that Godot does not currently support MIDI output, so there is no way to emit MIDI signals from Godot. Only MIDI input works.

Tutorials

Properties

int

channel

0

int

controller_number

0

int

controller_value

0

int

instrument

0

MIDIMessage

message

0

int

pitch

0

int

pressure

0

int

velocity

0

Property Descriptions

Default

0

Setter

set_channel(value)

Getter

get_channel()

The MIDI channel of this input event. There are 16 channels, so this value ranges from 0 to 15. MIDI channel 9 is reserved for the use with percussion instruments, the rest of the channels are for non-percussion instruments.


  • int controller_number

Default

0

Setter

set_controller_number(value)

Getter

get_controller_number()

If the message is MIDI_MESSAGE_CONTROL_CHANGE, this indicates the controller number, otherwise this is zero. Controllers include devices such as pedals and levers.


  • int controller_value

Default

0

Setter

set_controller_value(value)

Getter

get_controller_value()

If the message is MIDI_MESSAGE_CONTROL_CHANGE, this indicates the controller value, otherwise this is zero. Controllers include devices such as pedals and levers.


  • int instrument

Default

0

Setter

set_instrument(value)

Getter

get_instrument()

The instrument of this input event. This value ranges from 0 to 127. Refer to the instrument list on the General MIDI wikipedia article to see a list of instruments, except that this value is 0-index, so subtract one from every number on that chart. A standard piano will have an instrument number of 0.


Default

0

Setter

set_message(value)

Getter

get_message()

Returns a value indicating the type of message for this MIDI signal. This is a member of the MIDIMessage enum.

For MIDI messages between 0x80 and 0xEF, only the left half of the bits are returned as this value, as the other part is the channel (ex: 0x94 becomes 0x9). For MIDI messages from 0xF0 to 0xFF, the value is returned as-is.

Notes will return MIDI_MESSAGE_NOTE_ON when activated, but they might not always return MIDI_MESSAGE_NOTE_OFF when deactivated, therefore your code should treat the input as stopped if some period of time has passed.

For more information, see the MIDI message status byte list chart linked above.


Default

0

Setter

set_pitch(value)

Getter

get_pitch()

The pitch index number of this MIDI signal. This value ranges from 0 to 127. On a piano, middle C is 60, and A440 is 69, see the "MIDI note" column of the piano key frequency chart on Wikipedia for more information.


Default

0

Setter

set_pressure(value)

Getter

get_pressure()

The pressure of the MIDI signal. This value ranges from 0 to 127. For many devices, this value is always zero.


Default

0

Setter

set_velocity(value)

Getter

get_velocity()

The velocity of the MIDI signal. This value ranges from 0 to 127. For a piano, this corresponds to how quickly the key was pressed, and is rarely above about 110 in practice.