Description
Decode MIDI pitch-bend data bytes to signed centered -8192..8191 integer displacement; not a semitone range conversion.
MIDI 1.0 channel messages use a status byte identifying a message type and a channel, followed by one or two seven-bit data bytes. This family uses channel indexes 0–15 and raw program values 0–127. Raw message bytes do not include musical timing, instrument state or a MIDI file container.1
Decode MIDI pitch-bend data bytes to signed centered -8192..8191 integer displacement; not a semitone range conversion.
When to use this tool
Use this tool to decode MIDI pitch-bend data bytes to signed centered -8192..8191 integer displacement; not a semitone range conversion.
How to use the tool and how it works
- Enter lsb, msb using the field definitions below.
- Run the operation. Correct input errors before interpreting an output.
- Read result.centered. Use the ordering, boundary rules and absence conditions described below.
Combine the seven-bit pair as lsb + 128 × msb and subtract 8192.2
| Input field | Meaning and units | Accepted input |
|---|---|---|
| lsb | Least-significant seven-bit component, integer 0–127. | A finite safe integer within the operation’s stated bounds. |
| msb | Most-significant seven-bit component, integer 0–127. | A finite safe integer within the operation’s stated bounds. |
| Output field | Interpretation |
|---|---|
| result | Object containing the named fields below. |
| result.centered | Pitch-bend offset −8192 through 8191, where zero is center. |
{
"input": {
"lsb": 0,
"msb": 64
},
"output": {
"result": {
"centered": 0
}
}
}Limitations and assumptions
- The centered range is −8192 through 8191; conversion to musical pitch depends on a separately configured bend range.
- Message data bytes must be integers 0–127 and channel statuses 128–239. Channels are zero-based; this family does not implement MIDI 2.0 UMP, audio synthesis or a complete timed MIDI file.
- Every declared top-level input field is required and unexpected fields are rejected. Ordinary strings are limited to 8,192 UTF-16 code units and lists to 128 entries, with tighter operation-specific bounds where stated. JSON text has bounded nesting and node counts.
- Numeric outputs must be finite and no larger in absolute magnitude than the safe-integer limit; operations returning exact large integers use decimal text. Positions are zero-based and spans end exclusively unless the operation explicitly states a different convention.
Alternative or Complementary methods
Separate channel-message encoding from timing, running status and device interpretation. Use a MIDI sequencer or full file/stream parser when those additional layers matter.
References
-
Summary of MIDI 1.0 Messages — The MIDI Association
-
Tool behavior and example: MIDI Pitch Bend Centered Integer — tool.io
Similar or alternative tools
- MIDI Pitch Bend Centered Byte Pair
Encode a signed centered MIDI pitch-bend integer to least/most-significant seven-bit data bytes; no bend-range assumption.
- MIDI Channel Message Byte Count
Return required MIDI 1.0 channel-message byte counts from an explicit status, excluding running-status omission and system messages.